Head

GCC Code Coverage Report

Directory:	./		Exec	Total	Coverage
File:	gx_system_thread_entry.c	Lines:	31	31	100.0 %
Date:	2024-12-05 08:52:37	Branches:	15	15	100.0 %


/***************************************************************************
 * Copyright (c) 2024 Microsoft Corporation
 *
 * This program and the accompanying materials are made available under the
 * terms of the MIT License which is available at
 * https://opensource.org/licenses/MIT.
 *
 * SPDX-License-Identifier: MIT
 **************************************************************************/


/**************************************************************************/
/**************************************************************************/
/**                                                                       */
/** GUIX Component                                                        */
/**                                                                       */
/**   System Management (System)                                          */
/**                                                                       */
/**************************************************************************/

#define GX_SOURCE_CODE


/* Include necessary system files.  */

#include "gx_api.h"
#include "gx_system.h"

#if !defined(GX_THREAD_SLEEPING)
#define GX_THREAD_SLEEPING
#endif

#if !defined(GX_THREAD_AWAKE)
#define GX_THREAD_AWAKE
#endif

/**************************************************************************/
/*                                                                        */
/*  FUNCTION                                               RELEASE        */
/*                                                                        */
/*    _gx_system_thread_entry                             PORTABLE C      */
/*                                                           6.1          */
/*  AUTHOR                                                                */
/*                                                                        */
/*    Kenneth Maxwell, Microsoft Corporation                              */
/*                                                                        */
/*  DESCRIPTION                                                           */
/*                                                                        */
/*    This is the main processing thread for GUIX. All events and drawing */
/*    are done from the context of this thread.                           */
/*                                                                        */
/*  INPUT                                                                 */
/*                                                                        */
/*    id                                    Thread ID                     */
/*                                                                        */
/*  OUTPUT                                                                */
/*                                                                        */
/*    None                                                                */
/*                                                                        */
/*  CALLS                                                                 */
/*                                                                        */
/*    tx_mutex_get                          Get protection mutex          */
/*    tx_mutex_put                          Release protection mutex      */
/*    tx_queue_receive                      Receive GUIX events from queue*/
/*    _gx_system_dirty_mark                 Mark a widget as dirty        */
/*    _gx_system_error_process              Process system errors         */
/*    _gx_system_event_dispatch             Dispatch GUIX events          */
/*    _gx_system_canvas_refresh             Refresh the canvas            */
/*    _gx_system_timer_update               Update active system timers   */
/*                                                                        */
/*  CALLED BY                                                             */
/*                                                                        */
/*    ThreadX                                                             */
/*                                                                        */
/*  RELEASE HISTORY                                                       */
/*                                                                        */
/*    DATE              NAME                      DESCRIPTION             */
/*                                                                        */
/*  05-19-2020     Kenneth Maxwell          Initial Version 6.0           */
/*  09-30-2020     Kenneth Maxwell          Modified comment(s),          */
/*                                            resulting in version 6.1    */
/*                                                                        */
/**************************************************************************/
VOID  _gx_system_thread_entry(ULONG id)
{

UINT status = GX_FAILURE;

#ifdef GX_THREADX_BINDING
ULONG    event_memory[GX_EVENT_ULONGS];
#else
GX_EVENT event_memory;
#endif

GX_EVENT  *event_ptr;
GX_WIDGET *widget;

    GX_PARAMETER_NOT_USED(id);

    /* Loop to process GUIX events.  */
    while (1)
    {
#ifdef GX_THREADX_BINDING
        /* Pickup event from event queue.  */
        status =  tx_queue_receive(&_gx_system_event_queue, &event_memory[0], TX_NO_WAIT);

        /* Was there an event?  */
        if (status == TX_QUEUE_EMPTY)
        {
            /* No event to process, so re-draw dirty widgets */
            _gx_system_canvas_refresh();

            /* Now block this thread until an event is received.  */
            GX_THREAD_SLEEPING
            status = tx_queue_receive(&_gx_system_event_queue, &event_memory[0], TX_WAIT_FOREVER);
            if (status == TX_SUCCESS)
            {
                status = GX_SUCCESS;
            }
        }
#else
        /* here for generic RTOS binding */
        status = GX_EVENT_POP(&event_memory, GX_FALSE);
        if (status == GX_FAILURE)
        {
            _gx_system_canvas_refresh();
            GX_THREAD_SLEEPING
            status = GX_EVENT_POP(&event_memory, GX_TRUE);
        }
#endif

        /* Check for a successful status.  */
        if (status == GX_SUCCESS)
        {
            GX_THREAD_AWAKE
            /* Setup a pointer to the event.  */
            event_ptr =  (GX_EVENT *)(&event_memory);

            switch (event_ptr -> gx_event_type)
            {
            /* Determine if a redraw event is present.  */
            case GX_EVENT_REDRAW:
                /* Yes, a redraw event is present, detect and process the dirty area(s).  */
                widget = (GX_WIDGET *)_gx_system_root_window_created_list;
                while (widget)
                {
                    _gx_system_dirty_mark(widget);
                    widget = widget -> gx_widget_next;
                }
                break;

            case GX_EVENT_TERMINATE:
                return;

            case GX_EVENT_TIMER:
                if (event_ptr ->gx_event_target == GX_NULL)
                {
                    /* the event is from gx_system_timer_expiration */
                    _gx_system_timer_update(event_ptr -> gx_event_payload.gx_event_ulongdata);
                }
                else
                {
                    _gx_system_event_dispatch(event_ptr);
                }
                break;

            case 0:
                /* the event has been purged */
                break;

            default:
                /* Dispatch the event to GUIX proper window/widget.  */
                _gx_system_event_dispatch(event_ptr);
                break;
            }
        }
        else
        {
            /* Error receiving event - call system error handler.  */
            _gx_system_error_process(GX_SYSTEM_EVENT_RECEIVE_ERROR);

            /* Return to exit the system thread.  */
            return;
        }
    }
}



Generated by: GCOVR (Version 4.1)

Line	Branch	Exec	Source
1			/***************************************************************************
2			* Copyright (c) 2024 Microsoft Corporation
3			*
4			* This program and the accompanying materials are made available under the
5			* terms of the MIT License which is available at
6			* https://opensource.org/licenses/MIT.
7			*
8			* SPDX-License-Identifier: MIT
9			**************************************************************************/
10
11
12			/**************************************************************************/
13			/**************************************************************************/
14			/** */
15			/** GUIX Component */
16			/** */
17			/** System Management (System) */
18			/** */
19			/**************************************************************************/
20
21			#define GX_SOURCE_CODE
22
23
24			/* Include necessary system files. */
25
26			#include "gx_api.h"
27			#include "gx_system.h"
28
29			#if !defined(GX_THREAD_SLEEPING)
30			#define GX_THREAD_SLEEPING
31			#endif
32
33			#if !defined(GX_THREAD_AWAKE)
34			#define GX_THREAD_AWAKE
35			#endif
36
37			/**************************************************************************/
38			/* */
39			/* FUNCTION RELEASE */
40			/* */
41			/* _gx_system_thread_entry PORTABLE C */
42			/* 6.1 */
43			/* AUTHOR */
44			/* */
45			/* Kenneth Maxwell, Microsoft Corporation */
46			/* */
47			/* DESCRIPTION */
48			/* */
49			/* This is the main processing thread for GUIX. All events and drawing */
50			/* are done from the context of this thread. */
51			/* */
52			/* INPUT */
53			/* */
54			/* id Thread ID */
55			/* */
56			/* OUTPUT */
57			/* */
58			/* None */
59			/* */
60			/* CALLS */
61			/* */
62			/* tx_mutex_get Get protection mutex */
63			/* tx_mutex_put Release protection mutex */
64			/* tx_queue_receive Receive GUIX events from queue*/
65			/* _gx_system_dirty_mark Mark a widget as dirty */
66			/* _gx_system_error_process Process system errors */
67			/* _gx_system_event_dispatch Dispatch GUIX events */
68			/* _gx_system_canvas_refresh Refresh the canvas */
69			/* _gx_system_timer_update Update active system timers */
70			/* */
71			/* CALLED BY */
72			/* */
73			/* ThreadX */
74			/* */
75			/* RELEASE HISTORY */
76			/* */
77			/* DATE NAME DESCRIPTION */
78			/* */
79			/* 05-19-2020 Kenneth Maxwell Initial Version 6.0 */
80			/* 09-30-2020 Kenneth Maxwell Modified comment(s), */
81			/* resulting in version 6.1 */
82			/* */
83			/**************************************************************************/
84		727	VOID _gx_system_thread_entry(ULONG id)
85			{
86
87		727	UINT status = GX_FAILURE;
88
89			#ifdef GX_THREADX_BINDING
90			ULONG event_memory[GX_EVENT_ULONGS];
91			#else
92			GX_EVENT event_memory;
93			#endif
94
95			GX_EVENT *event_ptr;
96			GX_WIDGET *widget;
97
98			GX_PARAMETER_NOT_USED(id);
99
100			/* Loop to process GUIX events. */
101			while (1)
102			{
103			#ifdef GX_THREADX_BINDING
104			/* Pickup event from event queue. */
105		159898	status = tx_queue_receive(&_gx_system_event_queue, &event_memory[0], TX_NO_WAIT);
106
107			/* Was there an event? */
108	✓✓	159898	if (status == TX_QUEUE_EMPTY)
109			{
110			/* No event to process, so re-draw dirty widgets */
111		148462	_gx_system_canvas_refresh();
112
113			/* Now block this thread until an event is received. */
114			GX_THREAD_SLEEPING
115		148462	status = tx_queue_receive(&_gx_system_event_queue, &event_memory[0], TX_WAIT_FOREVER);
116	✓✓	147738	if (status == TX_SUCCESS)
117			{
118		147737	status = GX_SUCCESS;
119			}
120			}
121			#else
122			/* here for generic RTOS binding */
123			status = GX_EVENT_POP(&event_memory, GX_FALSE);
124			if (status == GX_FAILURE)
125			{
126			_gx_system_canvas_refresh();
127			GX_THREAD_SLEEPING
128			status = GX_EVENT_POP(&event_memory, GX_TRUE);
129			}
130			#endif
131
132			/* Check for a successful status. */
133	✓✓	159174	if (status == GX_SUCCESS)
134			{
135			GX_THREAD_AWAKE
136			/* Setup a pointer to the event. */
137		159173	event_ptr = (GX_EVENT *)(&event_memory);
138
139	✓✓✓✓ ✓	159173	switch (event_ptr -> gx_event_type)
140			{
141			/* Determine if a redraw event is present. */
142		76018	case GX_EVENT_REDRAW:
143			/* Yes, a redraw event is present, detect and process the dirty area(s). */
144		76018	widget = (GX_WIDGET *)_gx_system_root_window_created_list;
145	✓✓	207740	while (widget)
146			{
147		131722	_gx_system_dirty_mark(widget);
148		131722	widget = widget -> gx_widget_next;
149			}
150		76018	break;
151
152		1	case GX_EVENT_TERMINATE:
153		1	return;
154
155		11273	case GX_EVENT_TIMER:
156	✓✓	11273	if (event_ptr ->gx_event_target == GX_NULL)
157			{
158			/* the event is from gx_system_timer_expiration */
159		8169	_gx_system_timer_update(event_ptr -> gx_event_payload.gx_event_ulongdata);
160			}
161			else
162			{
163		3104	_gx_system_event_dispatch(event_ptr);
164			}
165		11273	break;
166
167		368	case 0:
168			/* the event has been purged */
169		368	break;
170
171		71513	default:
172			/* Dispatch the event to GUIX proper window/widget. */
173		71513	_gx_system_event_dispatch(event_ptr);
174		71512	break;
175			}
176			}
177			else
178			{
179			/* Error receiving event - call system error handler. */
180		1	_gx_system_error_process(GX_SYSTEM_EVENT_RECEIVE_ERROR);
181
182			/* Return to exit the system thread. */
183		1	return;
184			}
185			}
186			}
187