Patch 2

.gitignore

@@ -64,3 +64,4 @@ tools/inputstring.txt
 *.otf
 tools/asset
 examples/\[template\]\[csolution\]/arm2d.cbuild-set.yml
+examples/common/loader/lmsk_loader/lmsk/encoder/Test.lmsk

.vscode/c_cpp_properties.json

@@ -17,16 +17,19 @@
                 "examples/common/opcodes",
                 "examples/common/loader",
                 "examples/common/loader/generic_loader",
+                "examples/common/loader/zhrgb565_loader",
                 "examples/common/loader/tjpgd_loader",
                 "examples/common/loader/zjpgd_loader",
                 "examples/common/loader/freetype_loader",
                 "examples/common/loader/freetype_loader/freetype/include",
                 "examples/common/loader/qoi_loader",
                 "examples/common/loader/qoi_loader/qoi_decoder",
+                "examples/common/loader/lmsk_loader",
                 "examples/demos",
                 "examples/demos/monochrome",
                 "examples/demos/mask_generation",
                 "examples/demos/Physac/src",
+                "examples/render_tests",
                 "examples/common/scenes/fitness",
                 "examples/common/scenes/meter",
                 "examples/common/scenes/watch",
@@ -71,16 +74,19 @@
                 "examples/common/controls/qrcode_box",
                 "examples/common/opcodes",
                 "examples/common/loader",
+                "examples/common/loader/zhrgb565_loader",
                 "examples/common/loader/generic_loader",
                 "examples/common/loader/tjpgd_loader",
                 "examples/common/loader/zjpgd_loader",
                 "examples/common/loader/freetype_loader",
                 "examples/common/loader/qoi_loader",
                 "examples/common/loader/qoi_loader/qoi_decoder",
+                "examples/common/loader/lmsk_loader",
                 "examples/demos",
                 "examples/demos/monochrome",
                 "examples/demos/mask_generation",
                 "examples/demos/Physac/src",
+                "examples/render_tests",
                 "examples/common/scenes/fitness",
                 "examples/common/scenes/meter",
                 "examples/common/scenes/watch",

CMakeLists.txt

@@ -177,12 +177,14 @@ if (ARM2D_CONTROLS)
             examples/common/controls/ring_indication.c
             examples/common/controls/waveform_view.c
 
+            examples/common/asset/arm_2d_asset_WhiteDotSmall.c
             examples/common/asset/arm_2d_asset_WhiteDotMiddle.c
             examples/common/asset/arm_2d_asset_WhiteDotBig.c
             examples/common/asset/arm_2d_asset_SpinWheel.c
             examples/common/asset/arm_2d_asset_blue_slashes.c
             examples/common/asset/arm_2d_asset_wave.c
             examples/common/asset/arm_2d_asset_GreenCircle.c
+            examples/common/asset/arm_2d_asset_QuaterArc.c
             examples/common/asset/arm_2d_asset_QuaterArcSmall.c
             examples/common/asset/arm_2d_asset_QuaterArcMiddle.c
             examples/common/asset/arm_2d_asset_QuaterArcBig.c
@@ -234,6 +236,7 @@ if (ARM2D_CONTROLS)
             examples/common/asset/arm_2d_asset_wedge_pattern.c
             examples/common/asset/arm_2d_asset_GlassBall40.c
             examples/common/asset/arm_2d_asset_doge.c
+            examples/common/asset/arm_2d_asset_doge_dance.c
             examples/common/asset/arm_2d_asset_doge_small.c
             examples/common/asset/arm_2d_asset_white_noise.c
             examples/common/asset/arm_2d_asset_TinyCross.c
@@ -245,6 +248,7 @@ if (ARM2D_CONTROLS)
             examples/common/asset/arm_2d_asset_MeterPanel.c
             examples/common/asset/arm_2d_asset_QuarterSector.c
             examples/common/asset/arm_2d_asset_ThreeQuarterRing.c
+            examples/common/asset/arm_2d_asset_SolidSquare.c
 
             examples/common/asset/arm_2d_asset_icon_automobile.c
             examples/common/asset/arm_2d_asset_icon_compute.c 

Helper/Include/arm_2d_helper.h

@@ -21,8 +21,8 @@
  * Title:        #include "arm_2d_helper.h"
  * Description:  Public header file for the all helper services
  *
- * $Date:        29. Dec 2025
- * $Revision:    V.2.5.1
+ * $Date:        13. Feb 2026
+ * $Revision:    V.2.5.5
  *
  * Target Processor:  Cortex-M cores
  * -------------------------------------------------------------------- */
@@ -229,7 +229,7 @@
                     __frame_count,                                              \
                     __period)                                                   \
     {                                                                           \
-        .use_as__arm_2d_tile_t =                                                \
+        .tTile =                                                                \
             impl_child_tile((__sprites_tile), 0, 0, (__width), (__height)),     \
         .hwColumn = (__column),                                                 \
         .hwFrameNum = (__frame_count),                                          \
@@ -242,19 +242,22 @@
  * \brief a helper class to represent a GIF-like resource
  */
 typedef struct arm_2d_helper_film_t {
-    implement(arm_2d_tile_t);                                                   /*!< derived from arm_2d_tile_t */
+    union {
+        arm_2d_tile_t tTile;
+        implement(arm_2d_tile_t);                                               /*!< derived from arm_2d_tile_t */
+    };
     uint16_t hwColumn;                                                          /*!< number of frames per row in a sprite tile */
     uint16_t hwFrameNum;                                                        /*!< the total number of frames */
     uint16_t hwPeriodPerFrame;                                                  /*!< the period per frame (optional, used as a reference) */
     uint16_t hwFrameIndex;                                                      /*!< the frame index used at runtime */
 } arm_2d_helper_film_t;
 
 struct __arm_2d_fifo_reader_pointer {
     uint16_t hwPointer;
     uint16_t hwDataAvailable;
 };
 
 typedef struct arm_2d_byte_fifo_t {
 ARM_PROTECTED (
     uint8_t *pchBuffer;
     uint16_t hwSize;
@@ -293,11 +296,11 @@
 /*! 
  * \brief convert millisecond into ticks of the reference timer 
  *
- * \param[in] wMS the target time in millisecond
+ * \param[in] lMS the target time in millisecond
  * \return int64_t the ticks
  */
 extern
-int64_t arm_2d_helper_convert_ms_to_ticks(uint32_t wMS);
+int64_t arm_2d_helper_convert_ms_to_ticks(int64_t lMS);
 
 /*!
  * \brief get the reference clock frequency
@@ -509,6 +512,23 @@
 ARM_NONNULL(1)
 void arm_2d_helper_film_set_frame(arm_2d_helper_film_t *ptThis, int32_t nIndex);
 
+/*!
+ * \brief get the current frame index number
+ * \param[in] ptThis the target film
+ * \return uint_fast16_t the current index
+ */
+extern
+ARM_NONNULL(1)
+uint_fast16_t arm_2d_helper_film_get_frame_index(arm_2d_helper_film_t *ptThis);
+
+/*!
+ * \brief get the frame count
+ * \param[in] ptThis the target film
+ * \return uint_fast16_t the frame count
+ */
+extern
+ARM_NONNULL(1)
+uint_fast16_t arm_2d_helper_film_get_frame_count(arm_2d_helper_film_t *ptThis);
 /*----------------------------------------------------------------------------*
  * FIFO Helper Service                                                        *
  *----------------------------------------------------------------------------*/
@@ -546,6 +566,17 @@
 ARM_NONNULL(1)
 bool arm_2d_byte_fifo_enqueue(arm_2d_byte_fifo_t *ptThis, uint8_t chChar);
 
+/*!
+ * \brief remove a byte from the queue tail
+ * \param[in] ptThis the target FIFO control block
+ * \param[in] pchChar a buffer to store the byte, NULL means drop a byte
+ * \retval false the FIFO is EMPTY
+ * \retval true operation is successful
+ */
+extern
+ARM_NONNULL(1)
+bool arm_2d_byte_fifo_vomit(arm_2d_byte_fifo_t *ptThis, uint8_t *pchChar);
+
 /*!
  * \brief enter a byte to the FIFO, if the FIFO is full, drop one from the FIFO
  * \param[in] ptThis the target FIFO control block

Helper/Include/arm_2d_helper_pfb.h

@@ -21,8 +21,8 @@
  * Title:        #include "arm_2d_helper_pfb.h"
  * Description:  Public header file for the PFB helper service 
  *
- * $Date:        19. Dec 2025
- * $Revision:    V.2.4.5
+ * $Date:        10. Feb 2026
+ * $Revision:    V.2.4.7
  *
  * Target Processor:  Cortex-M cores
  * -------------------------------------------------------------------- */
@@ -1239,7 +1239,7 @@ void arm_2d_helper_pfb_resume_low_level_flush(arm_2d_helper_pfb_t *ptThis);
 extern
 ARM_NONNULL(1)
 bool arm_2d_helper_pfb_full_frame_refresh_mode( arm_2d_helper_pfb_t *ptThis, 
-                                            bool bEnabled);
+                                                bool bEnabled);
 
 /*!
  * \brief Enable or disable anti-noise-scanning mode

Helper/Include/console_box.h

@@ -69,6 +69,11 @@ typedef struct console_box_cfg_t {
     arm_2d_region_list_item_t **ppDirtyRegionList;
 } console_box_cfg_t;
 
+typedef struct console_position_t {
+    uint16_t hwRow;
+    uint16_t hwColumn;
+} console_position_t;
+
 /*!
  * \brief a user class for user defined control
  */
@@ -89,8 +94,9 @@ ARM_PRIVATE(
         uint16_t hwMaxRow;
         uint16_t hwLastRow;
         uint16_t hwLastColumn;
-        uint16_t hwCurrentRow;
-        uint16_t hwCurrentColumn;
+        console_position_t tCurrent;
+        //uint16_t hwCurrentRow;
+        //uint16_t hwCurrentColumn;
         uint16_t hwDirtyRegionRow;
         int16_t  iDirtyRegionPreviousRowWidth;
         uint16_t hwScrollUpCount;
@@ -143,6 +149,10 @@ extern
 ARM_NONNULL(1)
 bool console_box_on_frame_start(console_box_t *ptThis);
 
+ARM_NONNULL(1)
+console_position_t 
+console_box_get_current_position(console_box_t *ptThis);
+
 extern
 ARM_NONNULL(1,2)
 int console_box_printf(console_box_t *ptThis, const char *format, ...);