From a07faf8907c44458e9f8b013fd107353fb163f28 Mon Sep 17 00:00:00 2001
From: Gabriel Wang <embedded_zhuoran@Hotmail.com>
Date: Fri, 6 Sep 2024 01:30:15 +0100
Subject: [PATCH] update user control template and add on frame complete event
 handler

---
 ARM.Arm-2D.pdsc                                           | 4 ++--
 examples/common/controls/template/user_control_template.c | 7 +++++++
 examples/common/controls/template/user_control_template.h | 4 ++++
 3 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/ARM.Arm-2D.pdsc b/ARM.Arm-2D.pdsc
index 1b02a2250..b083576d6 100644
--- a/ARM.Arm-2D.pdsc
+++ b/ARM.Arm-2D.pdsc
@@ -256,8 +256,8 @@
             <file category="other"       name="ReleaseNote.md" />
             
             <!-- the template for user controls -->
-            <file category="header"      name="examples/common/controls/template/user_control_template.h"   attr="template"  select="User Control Template" version="1.2.2"/>
-            <file category="sourceC"     name="examples/common/controls/template/user_control_template.c"   attr="template"  select="User Control Template" version="1.2.2"/>
+            <file category="header"      name="examples/common/controls/template/user_control_template.h"   attr="template"  select="User Control Template" version="1.2.3"/>
+            <file category="sourceC"     name="examples/common/controls/template/user_control_template.c"   attr="template"  select="User Control Template" version="1.2.3"/>
             
             <!-- the template for scenes -->
             <file category="sourceC"     name="Helper/template/arm_2d_scene_template.c" attr="template"  select="User Scene Template"   version="1.3.3" />
diff --git a/examples/common/controls/template/user_control_template.c b/examples/common/controls/template/user_control_template.c
index 41d9cd5a7..7e595fc55 100644
--- a/examples/common/controls/template/user_control_template.c
+++ b/examples/common/controls/template/user_control_template.c
@@ -100,6 +100,13 @@ void <control_name>_on_frame_start( user_<control_name>_t *ptThis)
     
 }
 
+ARM_NONNULL(1)
+void <control_name>_on_frame_complete( user_<control_name>_t *ptThis)
+{
+    assert(NULL != ptThis);
+    
+}
+
 ARM_NONNULL(1)
 void <control_name>_show( user_<control_name>_t *ptThis,
                             const arm_2d_tile_t *ptTile, 
diff --git a/examples/common/controls/template/user_control_template.h b/examples/common/controls/template/user_control_template.h
index fcd30900f..d64b3f66e 100644
--- a/examples/common/controls/template/user_control_template.h
+++ b/examples/common/controls/template/user_control_template.h
@@ -92,6 +92,10 @@ extern
 ARM_NONNULL(1)
 void <control_name>_on_frame_start( user_<control_name>_t *ptThis);
 
+extern
+ARM_NONNULL(1)
+void <control_name>_on_frame_complete( user_<control_name>_t *ptThis);
+
 extern
 ARM_NONNULL(1)
 void <control_name>_show( user_<control_name>_t *ptThis,