fixes example project: [template][bare-metal][an552]

Author: GorgonMeducer

examples/[template][bare-metal][an552]/project/mdk/RTE/Acceleration/Eyeball.c

@@ -1,5 +1,5 @@
 
-/* Generated on Fri Nov 14 18:56:32 2025 from -i */
+/* Generated on Wed Dec 17 11:10:06 2025 from -i */
 /* Re-sized : True */
 /* Rotated : 0.0 deg */
 
@@ -6736,6 +6736,9 @@ const arm_2d_tile_t c_tileLeftEyeMask2 = {
     .nAddress = ((intptr_t)c_bmpLeftEyeCCCA8888) + 3,
 };
 
+
+
+
 extern const arm_2d_tile_t c_tileLeftEyeMask;
 
 ARM_SECTION("arm2d.tile.c_tileLeftEyeMask")
@@ -6750,7 +6753,7 @@ const arm_2d_tile_t c_tileLeftEyeMask = {
         .bIsRoot = true,
         .bHasEnforcedColour = true,
         .tColourInfo = {
-            .chScheme = ARM_2D_COLOUR_8BIT,
+            .chScheme = ARM_2D_COLOUR_MASK_A8,
         },
     },
     .pchBuffer = (uint8_t *)c_bmpLeftEyeAlpha,

examples/[template][bare-metal][an552]/project/mdk/RTE/Acceleration/LeftEye.c

@@ -62,13 +62,13 @@ extern "C" {
 // <i> Note that enabling this feature will add the support for a special colour type: ARM_2D_CHANNEL_8in32
 // <i> This feature is disabled by default to save code size
 #ifndef __ARM_2D_CFG_SUPPORT_COLOUR_CHANNEL_ACCESS__
-#   define __ARM_2D_CFG_SUPPORT_COLOUR_CHANNEL_ACCESS__             1
+#   define __ARM_2D_CFG_SUPPORT_COLOUR_CHANNEL_ACCESS__             0
 #endif
 
 // <q>Enable ccca8888(ARGB8888) implicit conversion 
 // <i> This feature is disabled by default to save code size
 #ifndef __ARM_2D_CFG_SUPPORT_CCCA8888_IMPLICIT_CONVERSION__
-#   define __ARM_2D_CFG_SUPPORT_CCCA8888_IMPLICIT_CONVERSION__      1
+#   define __ARM_2D_CFG_SUPPORT_CCCA8888_IMPLICIT_CONVERSION__      0
 #endif
 
 // <q>Improve the Quality of IIR Blur
@@ -175,21 +175,20 @@ extern "C" {
 
 // <q> When opacity is 255, call the non-opacity version of API implicitily
 // <i> This option is used to improve the performance and reduce the application complexity in API selection. Disable this feature allows linker to remove unused APIs further.
-// <i> This option is enabled by default
+// <i> This option is disabled by default
 #ifndef __ARM_2D_CFG_CALL_NON_OPACITY_VERSION_IMPLICITILY_FOR_255__
-#   define __ARM_2D_CFG_CALL_NON_OPACITY_VERSION_IMPLICITILY_FOR_255__         1
+#   define __ARM_2D_CFG_CALL_NON_OPACITY_VERSION_IMPLICITILY_FOR_255__      0
 #endif
 
-// <q> Optimize the scaler version of transform operations for pointer-like resources
+// <q> Optimize the transform operations for pointer-like resources
 // <i> This feature is enabled by default. There is no guarantee that the performance will increase or decrease. It is all depends your applications. In most of the case, enabling it helps.
-// <i> This feature has no meaning when the anti-alias transform is disabled or the helium acceleration is available.
+// <i> This feature has no meaning when the anti-alias transform is disabled.
 #ifndef __ARM_2D_CFG_OPTIMIZE_FOR_POINTER_LIKE_SHAPES_IN_TRANSFORM__
 #   define __ARM_2D_CFG_OPTIMIZE_FOR_POINTER_LIKE_SHAPES_IN_TRANSFORM__     1
 #endif
 
-// <q> Optimize the scaler version of transform operations for hollow out masks
+// <q> Optimize the transform operations for hollow out masks
 // <i> This feature is disabled by default. There is no guarantee that the performance will increase or decrease. It is all depends your applications. If your application uses a lot of hollow out masks, it might help.
-// <i> This feature has no meaning when the anti-alias transform is disabled or the helium acceleration is available.
 #ifndef __ARM_2D_CFG_OPTIMIZE_FOR_HOLLOW_OUT_MASK_IN_TRANSFORM__
 #   define __ARM_2D_CFG_OPTIMIZE_FOR_HOLLOW_OUT_MASK_IN_TRANSFORM__         0
 #endif
@@ -198,7 +197,7 @@ extern "C" {
 // <i> Ignore the user application code when a PFB is output of the areas that generated with the layout assistant. Enabling this feature can improve the user application performance. This feature is disabled by default. It is recommended when you trys to optimize the application performance.
 // <i> If you see some visual elements are imcomplete, you can choose those layout assistants with "_open" as posfix in corresonding area. For example, arm_2d_align_centre() can be changed to arm_2d_align_centre_open().
 #ifndef __ARM_2D_CFG_OPTIMIZE_FOR_PFB_IN_LAYOUT_ASSISTANT__
-#   define __ARM_2D_CFG_OPTIMIZE_FOR_PFB_IN_LAYOUT_ASSISTANT__              1
+#   define __ARM_2D_CFG_OPTIMIZE_FOR_PFB_IN_LAYOUT_ASSISTANT__              0
 #endif
 
 // <q> Force to disable Anti-Alias in Fill-colour-with-transformed-mask-and-opacity.

examples/[template][bare-metal][an552]/project/mdk/RTE/Acceleration/arm_2d_cfg.h

@@ -715,8 +715,6 @@ static void __user_scene_player_init(void)
     extern arm_2d_helper_2d_copy_handler_t __disp_adapter0_request_2d_copy;
     extern arm_2d_helper_dma_copy_handler_t __disp_adapter0_request_dma_copy;
 
-    
-        arm_2d_helper_3fb_cfg_t tCFG = {
         arm_2d_helper_3fb_cfg_t tCFG = {
             .tScreenSize = {
 #if     __DISP0_CFG_ROTATE_SCREEN__ == 1\
@@ -1061,10 +1059,54 @@ void __disp_adapter0_vres_asset_2dcopy( uintptr_t pObj,
     }
 }
 
+__WEAK
+bool __disp_adapter0_vres_asset_hint_on_load(uintptr_t pObj, 
+                                            arm_2d_vres_t *ptVRES, 
+                                            arm_2d_region_t *ptRegion)
+{
+    ARM_2D_UNUSED(pObj);
+    ARM_2D_UNUSED(ptVRES);
+    ARM_2D_UNUSED(ptRegion);
+
+    /*
+     * NOTE: When return true, it means user provides buffer and stores
+     *       the buffer address in ptVRES->tTile.nAddress. Once you have
+     *       return true, you take the responsiblity to manage the buffer,
+     *       and please make sure you return true in 
+     *       __disp_adapter0_vres_asset_hint_depose also.
+     *       
+     */
+    return false;
+}
+
+__WEAK
+bool __disp_adapter0_vres_asset_hint_depose(uintptr_t pObj, 
+                                            arm_2d_vres_t *ptVRES,
+                                            intptr_t pBuffer)
+{
+    ARM_2D_UNUSED(pObj);
+    ARM_2D_UNUSED(ptVRES);
+    ARM_2D_UNUSED(pBuffer);
+
+    /*
+     * NOTE: When return true, it means user provides buffer and stores
+     *       the buffer address in ptVRES->tTile.nAddress. 
+     * 
+     * NOTE: It is YOUR responsibility to manage the buffer (e.g. release) 
+     *       and the display adapter service will NOT release the buffer
+     *       for you. 
+     */
+    return false;
+}
+
+
 intptr_t __disp_adapter0_vres_asset_loader (uintptr_t pObj, 
                                             arm_2d_vres_t *ptVRES, 
                                             arm_2d_region_t *ptRegion)
 {
+    bool bUserAllocated = 
+    __disp_adapter0_vres_asset_hint_on_load(pObj, ptVRES, ptRegion);
+
     COLOUR_INT *pBuffer = NULL;
     size_t nPixelSize = sizeof(COLOUR_INT);
     size_t tBufferSize;
@@ -1088,7 +1130,8 @@ intptr_t __disp_adapter0_vres_asset_loader (uintptr_t pObj,
 
     /* background load mode */
     do {
-        if (ptVRES->tTile.tInfo.u3ExtensionID != ARM_2D_TILE_EXTENSION_VRES) {
+        if (ptVRES->tTile.tInfo.u3ExtensionID != ARM_2D_TILE_EXTENSION_VRES     /* NOT copy only */
+        &&  !bUserAllocated) {                                                  /* NO user provided buffer*/
             break;
         }
 
@@ -1114,7 +1157,6 @@ intptr_t __disp_adapter0_vres_asset_loader (uintptr_t pObj,
     /* default condition */
     tBufferSize = ptRegion->tSize.iHeight * nBytesPerLine;
 
-    
 #if __DISP0_CFG_USE_HEAP_FOR_VIRTUAL_RESOURCE_HELPER__
     pBuffer = __disp_adapter0_aligned_malloc(tBufferSize, nPixelSize);
     assert(NULL != pBuffer);
@@ -1133,6 +1175,7 @@ intptr_t __disp_adapter0_vres_asset_loader (uintptr_t pObj,
     }
     pBuffer = (COLOUR_INT *)((uintptr_t)ptPFB + sizeof(arm_2d_pfb_t));
 #endif
+
     /* load content into the buffer */
     if (nBitsPerPixel < 8) {
         /* A1, A2 and A4 support */
@@ -1180,6 +1223,10 @@ void __disp_adapter0_vres_buffer_deposer (
                                             arm_2d_vres_t *ptVRES, 
                                             intptr_t pBuffer )
 {
+    if (__disp_adapter0_vres_asset_hint_depose(pTarget, ptVRES, pBuffer)) {
+        return ;
+    }
+
 #if __DISP0_CFG_USE_HEAP_FOR_VIRTUAL_RESOURCE_HELPER__
     ARM_2D_UNUSED(pTarget);
     ARM_2D_UNUSED(ptVRES);

examples/[template][bare-metal][an552]/project/mdk/RTE/Acceleration/arm_2d_disp_adapter_0.c

@@ -102,7 +102,7 @@ extern "C" {
 // <o>Height of the PFB block
 // <i> The height of your PFB block size used in disp0
 #ifndef __DISP0_CFG_PFB_BLOCK_HEIGHT__
-#   define __DISP0_CFG_PFB_BLOCK_HEIGHT__                          240
+#   define __DISP0_CFG_PFB_BLOCK_HEIGHT__                          24
 #endif
 
 // <o>Width Alignment of generated PFBs