Improves performances and fixes bugs

.github/workflows/build.yaml

@@ -2,9 +2,9 @@ name: Build documentation and pack
 on:
   workflow_dispatch:
   push:
-    branches: [ main, developing ]
+    branches: [ main, develop ]
   pull_request:
-    branches: [ main, developing ]
+    branches: [ main, develop ]
   release:
     types: [published]
 jobs:

ARM.Arm-2D.pdsc

@@ -268,7 +268,7 @@
   -->
 
     <components>
-        <component Cclass="Acceleration" Cgroup="Arm-2D" Csub="Core" Cversion="1.2.6" condition="CMSIS-DSP">
+        <component Cclass="Acceleration" Cgroup="Arm-2D" Csub="Core" Cversion="1.3.0-dev" condition="CMSIS-DSP">
           <description>A 2D image processing library for Cortex-M processors</description>
           <files>
             <file category="include"     name="Library/Include/" />
@@ -316,7 +316,7 @@
 
         </component>
 
-        <component Cclass="Acceleration" Cgroup="Arm-2D" Csub="Alpha-Blending" Cversion="1.2.6" condition="Arm-2D-CORE">
+        <component Cclass="Acceleration" Cgroup="Arm-2D" Csub="Alpha-Blending" Cversion="1.3.0-dev" condition="Arm-2D-CORE">
           <description>Alpha-blending related APIs for Arm-2D</description>
           <files>
             <file category="sourceC"     name="Library/Source/arm_2d_alpha_blending.c" />
@@ -328,7 +328,7 @@
           </RTE_Components_h>
         </component>
 
-        <component Cclass="Acceleration" Cgroup="Arm-2D" Csub="Transform" Cversion="1.2.6" condition="Arm-2D-CORE">
+        <component Cclass="Acceleration" Cgroup="Arm-2D" Csub="Transform" Cversion="1.3.0-dev" condition="Arm-2D-CORE">
           <description>Transform (rotation and zooming)</description>
           <files>
             <file category="sourceC"     name="Library/Source/arm_2d_transform.c"           condition="CMSIS-DSP"/>
@@ -340,7 +340,7 @@
           </RTE_Components_h>
         </component>
 
-        <component Cclass="Acceleration" Cgroup="Arm-2D" Csub="Filter" Cversion="1.2.6" condition="Arm-2D-CORE">
+        <component Cclass="Acceleration" Cgroup="Arm-2D" Csub="Filter" Cversion="1.3.0-dev" condition="Arm-2D-CORE">
           <description>Filters (Blur etc)</description>
           <files>
             <file category="sourceC"     name="Library/Source/arm_2d_filter.c"/>
@@ -352,7 +352,7 @@
           </RTE_Components_h>
         </component>
 
-        <component Cclass="Acceleration" Cgroup="Arm-2D Helper" Csub="PFB" Cversion="3.2.9" condition="Arm-2D-CORE">
+        <component Cclass="Acceleration" Cgroup="Arm-2D Helper" Csub="PFB" Cversion="3.3.0" condition="Arm-2D-CORE">
           <description>Helper services for LCD adaptor(s), e.g. Generic Partial Framebuffer, Scene Player etc.</description>
           <files>
             <file category="include"     name="Helper/Include/" />
@@ -454,11 +454,11 @@
           </RTE_Components_h>
         </component>
 
-        <component Cclass="Acceleration" Cgroup="Arm-2D Helper" Csub="Display Adapter" Cversion="4.4.3" condition="Arm-2D-Displayer-Adapter" maxInstances="8">
+        <component Cclass="Acceleration" Cgroup="Arm-2D Helper" Csub="Display Adapter" Cversion="4.4.4" condition="Arm-2D-Displayer-Adapter" maxInstances="8">
           <description>The Display Adapter.</description>
           <files>
-            <file category="sourceC"     name="Helper/template/arm_2d_disp_adapter.c" attr="config" version="4.4.3" />
-            <file category="header"      name="Helper/template/arm_2d_disp_adapter.h" attr="config" version="4.4.3" />
+            <file category="sourceC"     name="Helper/template/arm_2d_disp_adapter.c" attr="config" version="4.4.4" />
+            <file category="header"      name="Helper/template/arm_2d_disp_adapter.h" attr="config" version="4.4.4" />
           </files>
           <RTE_Components_h>
     #define RTE_Acceleration_Arm_2D_Helper_Disp_Adapter%Instance%
@@ -492,7 +492,7 @@
           </RTE_Components_h>
         </component>
 
-        <component Cclass="Acceleration" Cgroup="Arm-2D Extras" Csub="Loaders" Cversion="5.6.11" condition="Arm-2D-Loaders">
+        <component Cclass="Acceleration" Cgroup="Arm-2D Extras" Csub="Loaders" Cversion="5.6.13" condition="Arm-2D-Loaders">
           <description>A helper service for loading various resource, e.g. loading baseline jpg files using TJpgDec, ZJpgDec, loading Lossless Compressed images (*.QOI) and loading font files using FreeType etc.</description>
           <files>
             <file category="include"     name="examples/common/loader/" />
@@ -556,7 +556,7 @@
           </Pre_Include_Global_h>
         </component>
 
-        <component Cclass="Acceleration" Cgroup="Arm-2D Extras" Csub="Controls" Cversion="2.16.2" condition="Arm-2D-Controls">
+        <component Cclass="Acceleration" Cgroup="Arm-2D Extras" Csub="Controls" Cversion="2.16.3" condition="Arm-2D-Controls">
           <description>A set of example controls, e.g. round-corner-box, spinning-wheels etc</description>
           <files>
             <!-- example control source files -->
@@ -1220,11 +1220,11 @@
           </RTE_Components_h>
         </component>
 
-        <component Cclass="Acceleration" Cgroup="Arm-2D Render Test" Csub="Large LMSK" Cversion="1.4.1" condition="Arm-2D-Render-Test">
+        <component Cclass="Acceleration" Cgroup="Arm-2D Render Test" Csub="Large LMSK" Cversion="1.5.2" condition="Arm-2D-Render-Test">
           <description>A demo for the tile filling rendering test.</description>
           <files>
-            <file category="sourceC"     name="examples/render_tests/arm_2d_scene_large_lmsk.c"     attr="config" version="1.4.1" />
-            <file category="header"      name="examples/render_tests/arm_2d_scene_large_lmsk.h"     attr="config" version="1.4.1" />
+            <file category="sourceC"     name="examples/render_tests/arm_2d_scene_large_lmsk.c"     attr="config" version="1.5.2" />
+            <file category="header"      name="examples/render_tests/arm_2d_scene_large_lmsk.h"     attr="config" version="1.5.2" />
 
             <file category="sourceC"     name="examples/render_tests/bad_apple.c"                   attr="config" version="1.1.0" />
           </files>

CMakeLists.txt

@@ -1,14 +1,16 @@
 cmake_minimum_required(VERSION 3.14)
 project(ARM2D)
 
-option(ARM2D_HOST "Build for host" OFF)
-option(ARM2D_HELPER "Build with helper support" OFF)
+option(ARM2D_HOST "Build for host (simulation mode)" OFF)
+option(ARM2D_HELPER "Build with helper services (PFB, Scene, List, etc.)" OFF)
 option(ARM2D_CMSIS_RTOS2 "Build with CMSIS-RTOS2 helper support" OFF)
 option(ARM2D_RT_THREAD "Build with RT-Thread helper support" OFF)
-option(ARM2D_LCD_PRINTF "Build with LCD printf support" OFF)
-option(ARM2D_CONTROLS "Build with controls" OFF)
+option(ARM2D_LCD_PRINTF "Build with LCD printf and font support" OFF)
+option(ARM2D_LOADERS "Build with image/font loaders (TJpgDec, QOI, FreeType, LMSK, zhRGB565)" OFF)
+option(ARM2D_CONTROLS "Build with UI controls library" OFF)
 option(ARM2D_BENCHMARK_GENERIC "Build with generic benchmark support" OFF)
-option(ARM2D_BENCHMARK_WATCHPANEL "Build with watchpanel benchmark support" OFF)
+option(ARM2D_BENCHMARK_WATCHPANEL "Build with watch-panel benchmark support" OFF)
+
 set(CMSISCORE "" CACHE STRING "Path to CMSIS Core")
 
 add_library(ARM2D STATIC)
@@ -26,10 +28,9 @@ else()
     target_include_directories(ARM2D PUBLIC ${CMSISCORE}/Include)
     target_compile_options(ARM2D PRIVATE -Wno-nonnull-compare -Wno-unused-value)
     target_compile_options(ARM2D PUBLIC -fms-extensions)
-
 endif()
 
-
+# Core feature flags required for basic Arm-2D operations
 target_compile_options(ARM2D PUBLIC
                        -DRTE_Acceleration_Arm_2D
                        -DRTE_Acceleration_Arm_2D_Alpha_Blending
@@ -43,11 +44,12 @@ if (CMAKE_C_COMPILER_ID STREQUAL "GNU")
     target_compile_options(ARM2D PRIVATE -Wno-maybe-uninitialized)
 endif()
 
+# Core library source files
 target_sources(ARM2D PRIVATE 
     Library/Source/arm_2d.c
-	Library/Source/arm_2d_async.c
-	Library/Source/arm_2d_draw.c
-	Library/Source/arm_2d_conversion.c
+    Library/Source/arm_2d_async.c
+    Library/Source/arm_2d_draw.c
+    Library/Source/arm_2d_conversion.c
     Library/Source/arm_2d_helium.c
     Library/Source/arm_2d_alpha_blending.c
     Library/Source/arm_2d_transform.c
@@ -57,8 +59,7 @@ target_sources(ARM2D PRIVATE
 
 if (ARM2D_HELPER)
 	target_include_directories(ARM2D PUBLIC 
-                                Helper/Include/
-                                Helper/built_in/)
+                                Helper/Include/)
 
 	target_sources(ARM2D PRIVATE 
 		    Helper/Source/arm_2d_helper.c
@@ -68,14 +69,19 @@ if (ARM2D_HELPER)
             Helper/Source/arm_2d_helper_shape.c
             Helper/Source/arm_2d_helper_control.c
 
-            Helper/Source/arm_2d_asset_white_dot_small.c
+            # Built-in assets
+            Helper/Source/arm_2d_asset_white_dot.c
             Helper/Source/arm_2d_asset_cmsis_logo.c
             Helper/Source/arm_2d_asset_circle_small.c
 
-            Helper/built_in/arm_2d_helper_built_in.c
-            Helper/built_in/busy_wheel.c
-            Helper/built_in/console_box.c
-
+            # Built-in controls
+            Helper/Source/arm_2d_helper_built_in.c
+            Helper/Source/busy_wheel.c
+            Helper/Source/console_box.c
+
+            # Example opcodes (part of Helper/PFB component in PDSC)
+            examples/common/opcodes/arm_2d_user_opcode_draw_circle.c
+            examples/common/opcodes/arm_2d_user_opcode_draw_line.c
             )
     target_compile_options(ARM2D PUBLIC
             -DRTE_Acceleration_Arm_2D_Helper_PFB
@@ -101,15 +107,18 @@ if (ARM2D_LCD_PRINTF)
 
 	target_sources(ARM2D PRIVATE 
             Helper/Source/arm_2d_helper_font.c
-            Helper/Source/GLCD_Fonts.c
+            Helper/Source/arm_2d_asset_glcd_fonts.c
             )
     target_compile_options(ARM2D PUBLIC
-            -DRTE_Acceleration_Arm_2D_Extra_LCD_printf__
+            -DRTE_Acceleration_Arm_2D_Extra_LCD_printf
             )
 endif()
 
-if (ARM2D_TJPGD_LOADER)
-	target_include_directories(ARM2D PUBLIC examples/common/loader/tjpgd_loader)
+if (ARM2D_LOADERS)
+	target_include_directories(ARM2D PUBLIC 
+            examples/common/loader/
+            examples/common/loader/freetype_loader/freetype/include/
+            )
 
 	target_sources(ARM2D PRIVATE 
             examples/common/opcodes/arm_2d_user_opcode_draw_circle.c
@@ -122,6 +131,15 @@ if (ARM2D_TJPGD_LOADER)
             examples/common/loader/qoi_loader/qoi_loader.c
             examples/common/loader/qoi_loader/qoi_decoder/arm_qoi_decoder.c
 
+            # Added missing LMSK loader
+            examples/common/loader/lmsk_loader/lmsk_loader.c
+            examples/common/loader/lmsk_loader/lmsk/decoder/arm_lmsk_decoder.c
+
+            # Added missing zhRGB565 loader
+            examples/common/loader/zhrgb565_loader/zhrgb565_loader.c
+            examples/common/loader/zhrgb565_loader/zhrgb565/zhRGB565_Decoder/zhRGB565_Decoder.c
+
+            # FreeType font loader
             examples/common/loader/freetype_loader/freetype_loader.c
             examples/common/loader/freetype_loader/freetype/src/base/ftsystem.c
             examples/common/loader/freetype_loader/freetype/src/base/ftinit.c
@@ -137,11 +155,13 @@ if (ARM2D_TJPGD_LOADER)
             examples/common/loader/freetype_loader/freetype/src/psaux/psaux.c
             )
     target_compile_options(ARM2D PUBLIC
+            -DRTE_Acceleration_Arm_2D_Extra_Loader
             -DRTE_Acceleration_Arm_2D_Extra_TJpgDec_Loader
             -DRTE_Acceleration_Arm_2D_Extra_ZJpgDec_Loader
             -DRTE_Acceleration_Arm_2D_Extra_JPEG_Loader
-            -DRTE_Acceleration_Arm_2D_Extra_Loader
             -DRTE_Acceleration_Arm_2D_Extra_QOI_Loader
+            -DRTE_Acceleration_Arm_2D_Extra_LMSK_Loader
+            -DRTE_Acceleration_Arm_2D_Extra_zhRGB565_Loader
             -DRTE_Acceleration_Arm_2D_Extra_FreeType_Loader
             )
 endif()
@@ -177,6 +197,7 @@ if (ARM2D_CONTROLS)
             examples/common/controls/ring_indication.c
             examples/common/controls/waveform_view.c
 
+            # Control assets (removed duplicates of alarm_clock fonts)
             examples/common/asset/arm_2d_asset_WhiteDotSmall.c
             examples/common/asset/arm_2d_asset_WhiteDotMiddle.c
             examples/common/asset/arm_2d_asset_WhiteDotBig.c
@@ -222,8 +243,6 @@ if (ARM2D_CONTROLS)
             examples/common/asset/arm_2d_asset_HallowOutCircleMask.c
             examples/common/asset/arm_2d_asset_Fire8x4.c
             examples/common/asset/arm_2d_asset_DigitsFont.c
-            examples/common/asset/arm_2d_asset_alarm_clock_font32.c
-            examples/common/asset/arm_2d_asset_alarm_clock_font64.c
             examples/common/asset/arm_2d_asset_liberalsans_regular_ascii_font14.c
             examples/common/asset/arm_2d_asset_liberalsans_regular_ascii_font32.c
             examples/common/asset/arm_2d_asset_liberalsans_regular_ascii_font64.c
@@ -262,7 +281,6 @@ if (ARM2D_CONTROLS)
             examples/common/asset/arm_2d_asset_icon_smartmeter.c 
             examples/common/asset/arm_2d_asset_icon_visual_sensor.c 
             examples/common/asset/arm_2d_asset_icon_wearables.c
-
           )
     target_compile_options(ARM2D PUBLIC
           -DRTE_Acceleration_Arm_2D_Extra_Controls
@@ -271,9 +289,10 @@ endif()
 
 if (ARM2D_BENCHMARK_GENERIC)
 	target_include_directories(ARM2D PUBLIC examples/common/benchmark/)
-	target_sources(ARM2D PRIVATE examples/common/benchmark/benchmark_generic.c
+	target_sources(ARM2D PRIVATE 
+            examples/common/benchmark/benchmark_generic.c
             examples/common/benchmark/arm_2d_scene_benchmark_generic.c
-			examples/common/benchmark/arm_2d_scene_benchmark_generic_cover.c
+            examples/common/benchmark/arm_2d_scene_benchmark_generic_cover.c
           )
     target_compile_options(ARM2D PUBLIC
           -DRTE_Acceleration_Arm_2D_Extra_Benchmark
@@ -283,14 +302,15 @@ endif()
 
 if (ARM2D_BENCHMARK_WATCHPANEL)
 	target_include_directories(ARM2D PUBLIC examples/common/benchmark/)
-	target_sources(ARM2D PRIVATE examples/common/benchmark/benchmark_watch_panel.c
+	target_sources(ARM2D PRIVATE 
+            examples/common/benchmark/benchmark_watch_panel.c
             examples/common/benchmark/arm_2d_scene_benchmark_watch_panel.c
-			examples/common/benchmark/arm_2d_scene_benchmark_watch_panel_cover.c
+            examples/common/benchmark/arm_2d_scene_benchmark_watch_panel_cover.c
           )
     target_compile_options(ARM2D PUBLIC
           -DRTE_Acceleration_Arm_2D_Extra_Benchmark
           -DRTE_Acceleration_Arm_2D_Extra_Benchmark_Watch_Panel
           )
 endif()
 
-target_include_directories(ARM2D PUBLIC Library/Include/)
+target_include_directories(ARM2D PUBLIC Library/Include/)

Helper/Include/arm_2d_helper.h

@@ -252,12 +252,12 @@
     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;
@@ -328,6 +328,12 @@
 ARM_NONNULL(1)
 int64_t __arm_2d_helper_time_elapsed(int64_t *plTimestamp);
 
+/*!
+ * \brief get the system frequency
+ */
+extern
+uint32_t arm_2d_helper_get_system_frequency(void);
+
 /*!
  * \brief set an alarm with given period and check the status
  * 

Helper/Include/arm_2d_helper_list.h

@@ -21,8 +21,8 @@
  * Title:        #include "arm_2d_helper_list.h"
  * Description:  Public header file for list core related services
  *
- * $Date:        21 Oct 2025
- * $Revision:    V.2.4.2
+ * $Date:        24 June 2026
+ * $Revision:    V.2.4.3
  *
  * Target Processor:  Cortex-M cores
  * -------------------------------------------------------------------- */
@@ -201,7 +201,7 @@ typedef struct __arm_2d_list_work_area_t {
  * \param[in] iOffset the offset in the list core
  * \return __arm_2d_list_core_target_area_t* the working area for a target list core item
  */
-typedef const struct arm_2d_i_list_region_calculator_t {
+struct __arm_2d_i_list_region_calculator_t {
     __arm_2d_list_work_area_t *(*fnCalculator)(
                                     __arm_2d_list_core_t *ptThis,
                                     __arm_2d_list_item_iterator *fnIterator,
@@ -210,7 +210,8 @@ typedef const struct arm_2d_i_list_region_calculator_t {
     int16_t (*fnSelectionCompensation)(__arm_2d_list_core_t *ptThis,
                                        arm_2d_list_item_t *ptItem);
     arm_2d_list_dir_t tDirection;
-} arm_2d_i_list_region_calculator_t;
+};
+typedef const struct __arm_2d_i_list_region_calculator_t arm_2d_i_list_region_calculator_t;
 
 /*!
  *  \brief list core configuration structure

Helper/Include/arm_2d_helper_scene.h

@@ -21,8 +21,8 @@
  * Title:        #include "arm_2d_helper_scene.h"
  * Description:  Public header file for the scene service
  *
- * $Date:        09. September 2025
- * $Revision:    V.2.0.0
+ * $Date:        24 June 2026
+ * $Revision:    V.2.1.0
  *
  * Target Processor:  Cortex-M cores
  * -------------------------------------------------------------------- */
@@ -233,13 +233,14 @@ typedef struct arm_2d_scene_player_t arm_2d_scene_player_t;
 /*!
  * \brief scene switching mode descriptor
  */
-typedef const struct {
+struct __arm_2d_scene_switch_mode_t {
     uint8_t                         chEffects;                                  //!< switching effects
     arm_2d_helper_draw_handler_t    *fnSwitchDrawer;                            //!< switching algorithm
 
     void (*fnOnRequestChangeSwitchingStatus)(arm_2d_scene_player_t *ptThis);    //!< on request change-switch-status event handler
     void (*fnOnSwitchComplete)              (arm_2d_scene_player_t *ptThis);    //!< on request switch complete event handler
-} arm_2d_scene_switch_mode_t;
+};
+typedef const struct __arm_2d_scene_switch_mode_t arm_2d_scene_switch_mode_t;
 
 /*!
  * \brief a class for describing scenes which are the combination of a

Helper/Source/arm_2d_helper.c

@@ -168,7 +168,7 @@ void arm_2d_helper_init(void)
 
 /* NOTE: for non-arm architecture, you have to implement those functions.
  */
-#if __IS_SUPPORTED_ARM_ARCH__
+#if __IS_SUPPORTED_ARM_ARCH_M__
 __WEAK 
 int64_t arm_2d_helper_get_system_timestamp(void)
 {
@@ -206,6 +206,16 @@ int64_t arm_2d_helper_convert_ms_to_ticks(int64_t lMS)
     return lResult ? lResult : 1;
 }
 
+__WEAK
+uint32_t arm_2d_helper_get_system_frequency(void)
+{
+#if __IS_SUPPORTED_ARM_ARCH_M__
+    extern uint32_t SystemCoreClock;
+    return SystemCoreClock;
+#else
+    return 0;
+#endif
+}
 
 ARM_NONNULL(2)
 bool __arm_2d_helper_is_time_out(int64_t lPeriod, int64_t *plTimestamp)