1 /**************************************************************************/ 2 /* */ 3 /* Copyright (c) Microsoft Corporation. All rights reserved. */ 4 /* */ 5 /* This software is licensed under the Microsoft Software License */ 6 /* Terms for Microsoft Azure RTOS. Full text of the license can be */ 7 /* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */ 8 /* and in the root directory of this software. */ 9 /* */ 10 /**************************************************************************/ 11 12 13 /**************************************************************************/ 14 /**************************************************************************/ 15 /** */ 16 /** GUIX Component */ 17 /** */ 18 /** Sprite Management (Sprite) */ 19 /** */ 20 /**************************************************************************/ 21 22 #define GX_SOURCE_CODE 23 24 25 /* Include necessary system files. */ 26 27 #include "gx_api.h" 28 #include "gx_system.h" 29 #include "gx_display.h" 30 #include "gx_context.h" 31 #include "gx_canvas.h" 32 #include "gx_widget.h" 33 #include "gx_sprite.h" 34 35 36 /**************************************************************************/ 37 /* */ 38 /* FUNCTION RELEASE */ 39 /* */ 40 /* _gx_sprite_start PORTABLE C */ 41 /* 6.1 */ 42 /* AUTHOR */ 43 /* */ 44 /* Kenneth Maxwell, Microsoft Corporation */ 45 /* */ 46 /* DESCRIPTION */ 47 /* */ 48 /* This service starts the sprite widget from a given frame number. */ 49 /* */ 50 /* INPUT */ 51 /* */ 52 /* sprite Pointer to sprite widget */ 53 /* control block */ 54 /* frame_number The frame number to start */ 55 /* with */ 56 /* */ 57 /* OUTPUT */ 58 /* */ 59 /* status Completion status */ 60 /* */ 61 /* CALLS */ 62 /* */ 63 /* _gx_system_timer_stop Stop an active GUIX timer */ 64 /* _gx_system_timer_start Start a GUIX timer */ 65 /* _gx_system_dirty_mark Mark the widget as dirty */ 66 /* */ 67 /* CALLED BY */ 68 /* */ 69 /* Application Code */ 70 /* */ 71 /* RELEASE HISTORY */ 72 /* */ 73 /* DATE NAME DESCRIPTION */ 74 /* */ 75 /* 05-19-2020 Kenneth Maxwell Initial Version 6.0 */ 76 /* 09-30-2020 Kenneth Maxwell Modified comment(s), */ 77 /* resulting in version 6.1 */ 78 /* */ 79 /**************************************************************************/ _gx_sprite_start(GX_SPRITE * sprite,USHORT frame_number)80UINT _gx_sprite_start(GX_SPRITE *sprite, USHORT frame_number) 81 { 82 GX_WIDGET *widget = (GX_WIDGET *)sprite; 83 GX_SPRITE_FRAME *frame; 84 UINT delayval; 85 86 if (sprite -> gx_sprite_run_state == GX_SPRITE_RUNNING) 87 { 88 _gx_system_timer_stop(widget, GX_SPRITE_TIMER); 89 sprite -> gx_sprite_run_state = GX_SPRITE_IDLE; 90 } 91 92 if (sprite -> gx_sprite_frame_list && 93 (widget -> gx_widget_status & GX_STATUS_VISIBLE)) 94 { 95 if (frame_number < sprite -> gx_sprite_frame_count) 96 { 97 sprite -> gx_sprite_current_frame = frame_number; 98 99 frame = &sprite -> gx_sprite_frame_list[sprite -> gx_sprite_current_frame]; 100 if (frame -> gx_sprite_frame_delay > 0) 101 { 102 delayval = frame -> gx_sprite_frame_delay; 103 } 104 else 105 { 106 delayval = 1; 107 } 108 _gx_system_timer_start(widget, GX_SPRITE_TIMER, delayval, 0); 109 sprite -> gx_sprite_run_state = GX_SPRITE_RUNNING; 110 _gx_system_dirty_mark(widget); 111 return(GX_SUCCESS); 112 } 113 } 114 return(GX_FAILURE); 115 } 116 117
