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 /** Canvas Management (Canvas) */ 18 /** */ 19 /**************************************************************************/ 20 21 #define GX_SOURCE_CODE 22 23 24 /* Include necessary system files. */ 25 26 #include "gx_api.h" 27 #include "gx_canvas.h" 28 #include "gx_system.h" 29 30 /* Bring in externs for caller checking code. */ 31 GX_CALLER_CHECKING_EXTERNS 32 33 /**************************************************************************/ 34 /* */ 35 /* FUNCTION RELEASE */ 36 /* */ 37 /* _gxe_canvas_pixelmap_draw PORTABLE C */ 38 /* 6.1 */ 39 /* AUTHOR */ 40 /* */ 41 /* Kenneth Maxwell, Microsoft Corporation */ 42 /* */ 43 /* DESCRIPTION */ 44 /* */ 45 /* This function checks errors in the canvas pixelmap draw function. */ 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 /* */ 62 /* _gx_canvas_pixelmap_draw The actual function */ 63 /* */ 64 /* CALLED BY */ 65 /* */ 66 /* Application Code */ 67 /* */ 68 /* RELEASE HISTORY */ 69 /* */ 70 /* DATE NAME DESCRIPTION */ 71 /* */ 72 /* 05-19-2020 Kenneth Maxwell Initial Version 6.0 */ 73 /* 09-30-2020 Kenneth Maxwell Modified comment(s), */ 74 /* resulting in version 6.1 */ 75 /* */ 76 /**************************************************************************/ _gxe_canvas_pixelmap_draw(GX_VALUE x_position,GX_VALUE y_position,GX_PIXELMAP * pixelmap)77UINT _gxe_canvas_pixelmap_draw(GX_VALUE x_position, GX_VALUE y_position, GX_PIXELMAP *pixelmap) 78 { 79 UINT status; 80 81 /* Check for appropriate caller. */ 82 GX_INIT_AND_THREADS_CALLER_CHECKING 83 84 /* Check error for valid pointer. */ 85 if (pixelmap == GX_NULL) 86 { 87 return(GX_PTR_ERROR); 88 } 89 90 if (_gx_system_current_draw_context == GX_NULL) 91 { 92 return GX_INVALID_CONTEXT; 93 } 94 95 /* Call the actual function. */ 96 status = _gx_canvas_pixelmap_draw(x_position, y_position, pixelmap); 97 98 /* Return completion status. */ 99 return(status); 100 } 101 102