GCC Code Coverage Report
Directory: ./ Exec Total Coverage
File: gx_canvas_pixelmap_draw.c Lines: 28 28 100.0 %
Date: 2024-12-05 08:52:37 Branches: 18 18 100.0 %

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
/**   Screen Management (Screen)                                          */
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
#include "gx_utility.h"
29
#include "gx_display.h"
30
#include "gx_canvas.h"
31
32
/**************************************************************************/
33
/*                                                                        */
34
/*  FUNCTION                                               RELEASE        */
35
/*                                                                        */
36
/*    _gx_canvas_pixelmap_draw                            PORTABLE C      */
37
/*                                                           6.1          */
38
/*  AUTHOR                                                                */
39
/*                                                                        */
40
/*    Kenneth Maxwell, Microsoft Corporation                              */
41
/*                                                                        */
42
/*  DESCRIPTION                                                           */
43
/*                                                                        */
44
/*    This function prepares to draw the specified pixelmap at the        */
45
/*    requested position.                                                 */
46
/*                                                                        */
47
/*  INPUT                                                                 */
48
/*                                                                        */
49
/*    x_position                            Top-left x-coord to place     */
50
/*                                            pixelmap                    */
51
/*    y_position                            Top-left y-coord to place     */
52
/*                                            pixelmap                    */
53
/*    pixelmap                              Pointer to actual pixelmap    */
54
/*                                            to draw                     */
55
/*                                                                        */
56
/*  OUTPUT                                                                */
57
/*                                                                        */
58
/*    status                                Completion status             */
59
/*                                                                        */
60
/*  CALLS                                                                 */
61
/*    _gx_utility_rectangle_define          Define a rectangle            */
62
/*    _gx_utility_rectangle_overlap_detect  Detect rectangle overlap      */
63
/*    [gx_display_driver_pixelmap_draw]     The display driver pixelmap   */
64
/*                                            draw routine                */
65
/*    [gx_display_driver_jpeg_draw]         The display driver JPEG draw  */
66
/*                                            routine                     */
67
/*    [gx_display_driver_png_draw]          The display driver PNG draw   */
68
/*                                            routine                     */
69
/*                                                                        */
70
/*  CALLED BY                                                             */
71
/*                                                                        */
72
/*    _gx_canvas_pixelmap_blend                                           */
73
/*    _gx_canvas_pixelmap_tile                                            */
74
/*    _gx_checkbox_draw                                                   */
75
/*    _gx_icon_button_draw                                                */
76
/*    _gx_icon_draw                                                       */
77
/*    _gx_pixelmap_button_draw                                            */
78
/*    _gx_pixelmap_prompt_draw                                            */
79
/*    _gx_pixelmap_slider_draw                                            */
80
/*    _gx_radio_button_draw                                               */
81
/*    _gx_scroll_thumb_draw                                               */
82
/*    _gx_scrollbar_draw                                                  */
83
/*    _gx_window_draw                                                     */
84
/*    _gx_scroll_thumb_draw                                               */
85
/*                                                                        */
86
/*  RELEASE HISTORY                                                       */
87
/*                                                                        */
88
/*    DATE              NAME                      DESCRIPTION             */
89
/*                                                                        */
90
/*  05-19-2020     Kenneth Maxwell          Initial Version 6.0           */
91
/*  09-30-2020     Kenneth Maxwell          Modified comment(s),          */
92
/*                                            resulting in version 6.1    */
93
/*                                                                        */
94
/**************************************************************************/
95
1487962
UINT  _gx_canvas_pixelmap_draw(GX_VALUE x_position, GX_VALUE y_position, GX_PIXELMAP *pixelmap)
96
{
97
GX_DRAW_CONTEXT *context;
98
GX_DISPLAY      *display;
99
GX_RECTANGLE     clip_rect;
100
GX_RECTANGLE     bound;
101
GX_VIEW         *view;
102
VOID             (*pmp_function)(GX_DRAW_CONTEXT *, INT, INT, GX_PIXELMAP *);
103
104
    /* pick up the current drawing context */
105
1487962
    context = _gx_system_current_draw_context;
106
107
    /* pick up current display driver */
108
1487962
    display = context -> gx_draw_context_display;
109
110
    /* calculate rectangle that bounds the pixelmap */
111
1487962
    _gx_utility_rectangle_define(&bound, x_position, y_position,
112
1487962
                                 (GX_VALUE)(x_position + pixelmap -> gx_pixelmap_width - 1),
113
1487962
                                 (GX_VALUE)(y_position + pixelmap -> gx_pixelmap_height - 1));
114
115
    /* clip the line bounding box to the dirty rectangle */
116
1487962
    if (!_gx_utility_rectangle_overlap_detect(&bound, &context -> gx_draw_context_dirty, &bound))
117
    {
118
        /* nothing to draw, return */
119
21603
        return GX_SUCCESS;
120
    }
121
122
    /* pickup pointer to correct pixelmap drawing function */
123
1466359
    pmp_function = GX_NULL;
124
125
1466359
    if (pixelmap -> gx_pixelmap_flags & GX_PIXELMAP_RAW_FORMAT)
126
    {
127
#if defined(GX_SOFTWARE_DECODER_SUPPORT)
128

1033
        if ((pixelmap->gx_pixelmap_data[0] == 0xff) && (pixelmap->gx_pixelmap_data[1] == 0xd8))
129
        {
130
            /* JPEG */
131
412
            pmp_function = display -> gx_display_driver_jpeg_draw;
132
        }
133
        else
134
        {
135
621
            if (pixelmap -> gx_pixelmap_data[1] == 'P')
136
            {
137
                /* PNG */
138
618
                pmp_function = display -> gx_display_driver_png_draw;
139
            }
140
        }
141
#endif
142
    }
143
    else
144
    {
145
1465326
        if (pixelmap -> gx_pixelmap_format == GX_COLOR_FORMAT_8BIT_ALPHAMAP)
146
        {
147
60064
            pmp_function = display -> gx_display_driver_alphamap_draw;
148
        }
149
        else
150
        {
151
1405262
            pmp_function = display -> gx_display_driver_pixelmap_draw;
152
        }
153
    }
154
155
1466359
    if (!pmp_function)
156
    {
157
        /* display driver does not support requested action */
158
1681
        return GX_FAILURE;
159
    }
160
161
    /* test to determine if the bounding rectangle overlaps the region we are allowed to draw
162
       into. For each view that overlaps the bounding rectangle, do some drawing.
163
     */
164
1464678
    view = context -> gx_draw_context_view_head;
165
166
2954278
    while (view)
167
    {
168
1489600
        if (!_gx_utility_rectangle_overlap_detect(&view -> gx_view_rectangle, &bound, &clip_rect))
169
        {
170
31212
            view = view -> gx_view_next;
171
31212
            continue;
172
        }
173
174
        /* we have a view into which we can draw the pixelmap, do it */
175
176
        /* first, set the context clip rectangle */
177
1458388
        context -> gx_draw_context_clip = &clip_rect;
178
179
        /* now pass the context and drawing params to driver level function */
180
1458388
        pmp_function(context, x_position, y_position, pixelmap);
181
182
        /* go to the next view */
183
1458388
        view = view -> gx_view_next;
184
    }
185
186
    /* Return successful completion.  */
187
1464678
    return(GX_SUCCESS);
188
}
189