Function Features: Difference between revisions

From Smart LCD
Line 23: Line 23:


== Display Elements and Functions Relation ==
== Display Elements and Functions Relation ==
[[File:SGT-linking.png|640x640px]]
[[File:SGT-linking.png|984x984px]]


== Elements ==
== Elements ==

Revision as of 13:09, 14 February 2025

Basic Concept

PAGE
Each display interface is a PAGE.
It could contain / link with all the predefined content.
(e.g. background image, page elements, etc. )
Page Elements
29 type page elements could be use on screen
9 action type elements, 6 Character (Alpha Numeric) type elements,
6 image type elements, 8 graphics type elements
Most of them are linked with VP variable to generate dynamic display content.
Image Recourses
Image Recourses include background images (IMG_BKG), icon images (IMG_ICO) and animation images (IMG_ANI).
They could link by PAGE or Elements to be show on screen.
VP Variables
VP Variables is a RAM area to hold functional variable values.
They could be accessed by host via serial port command, value operations or on screen Keyboard etc.
Call Functions
Call Functions are functions (e.g. keyboard, values operations, etc) that could be trigged by a Page start, Touch Key or Virtual Touch Key.

Display Elements and Functions Relation

Elements

Action Type Elements

 Touch Key (TPK)
Touch Key Element could place inside a page. It will be triggered by user touching on its assigned area
- Touch Key assigned area provides visual touch response (e.g. inverse color or show a icon, etc)
- It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc)
- Its call functions could provide various kinds of actions (e.g. keyboards, value operations, page jump, etc.)
 Virtual Key (VPK)
Virtual Key is a non-display element. 
It could be defined in a PAGE and trigged by a condition like "content of a VP equal to constant value"
- Virtual Key assigned area will NOT provide visual response
- Its call functions could provide various kinds of actions (e.g. keyboards, value operations, page jump, etc.)
- After being triggered, the monitored VP will be cleared as 0
(note: only the PAGE with VPK showing on screen could be trigged)
 Swap Page (SWP_PG)
Swap Page Element is a full screen element.. It allow the user to jump to another PAGE 
- Sweep should start on screen area without any other touch element
- It can jump to two different PAGE depends on the horizontal sweep direction (left-to-right or right-to-left)
- It will also report to the host machine about its Target Page_ID
Touch Key with Repeat (TPK_RPT)
Touch Key with Repeat is an element (similar as TPK) which provide long-press input.
- It assigned area provides visual touch response (e.g. inverse color or show a icon, etc)
- It only provide VP:=VP+value function
- It provide additional on long-press functionality which can provide repeated the VP:=VP+value function (assign negative value can provide minus function)
- It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc)
 Touch Switch (TPK_SW)
Touch Switch is an element is that provide bit operation
- Touch Switch assigned area provides visual touch response (e.g. show a icon, etc)
- It will toggle the selected bit of a VP (after the touch 0-to-1 or 0-to-1)
- It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc)
Slider (SDR)
Slider is an element that provide sliding value input
- Slider touch area can be defined as Horizontal or Vertical slide with Absolute or Relative mode options
- It does not provide visual response (it may overlay with B16, B32, etc as corresponding visual effect)
- It can give an input value between the Content Min/Max value in ratio with sweep
- It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc)
 Slider 2 (SDR2)
Slider 2 is a full screen element (similar as SDR) which can act with two point touch operation
- Two point touch should start on screen area without any other touch element.
- It can be defined as Horizontal or Vertical slide with Gain options
- It does not provide visual response (it may overlay with B16, B32, etc as corresponding visual effect)
- It can give an input value between the Content Min/Max value in ratio with sweep
- It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc)
 Touch Ring (RNG)
Touch Ring is an round shape element is that provide circular sliding input
- Touch Ring touch area can be refined with the Radius and Angle setting
- It does not provide visual response (it may overlay with R16, R32, etc as corresponding visual effect)
- It can give an input value between the Content Min/Max value in ratio with the assigned Sweep Angle
- It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc)
 Touch Ring 2 (RNG2)
Touch Ring 2 is a full screen element (similar as RNG) which can act with two point touch operation
- Two point touch should start on screen area without any other touch element.
- It does not provide visual response (it may overlay with R16, R32, etc as corresponding visual effect)
- It can give an input value between the Content Min/Max value with respect to the two point rotation angle.
- It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc)

Character (Alpha Numeric) Type Elements

 Static String (STS)
Static String Element shows text string defined by its properties directly
 String Element (STR)
String Element is for displaying VP_STR content 
- Display the VP_STR content in PAGE with alignment and formatting
- String Element will be updated correspondingly in real-time, if the VP_STR content changed
 Scrolling String (STR_SCR)
Scrolling String Elements is for displaying VP_STR content (similar as STR) which can provide scrolling effect
- Display the VP_STR content in PAGE with alignment and formatting
- Scrolling direction could be config as horizontal or vertical with speed options
- String Element will be updated correspondingly in real-time, if the VP_STR content changed
 Number Element (N16, N32, N64)
Number Element is for displaying VP_N16, VP_N32, VP_N64 content 
- Display the VP_N16, VP_N32 and  VP_N64 content in PAGE with alignment and formatting
- Number Element will be updated correspondingly in real-time, if the VP_N16, VP_N32 and  VP_N64 content changed
 Timer Display (TMR)
Timer Display Element links to a timer addressed inside VP_N32
- It Display the timer value with alignment and formatting
 Real Time Clock (RTC)
Real Time Clock Element shows the Smart LCM internal clock with formatting.

Image Type Elements

 Static Icon (ICO)
Static Icon Element links to an IMG_ICO and shows it on screen
 Animation Element (ANI)
Animation Element links to an IMG_ANI and shows it on the screen 
It is animation speed could be defined
 Bit Icon (IDX_BIT)
Bit Icon Element links with one bit value of VP_N16 or VP_N32
which could point to an IMG_ICON and display accordingly with its value
 Indexed Icon (IDX)
Indexed Icon Element links with VP_N16 or VP_N32 which could point to an IMG_ICON and display accordingly
If the value in side the VP is outside the defined max/min rang, it will display nothing
 Decimal Icon (I16, I32)
Decimal Icon Element links with VP_N16 and display as decimal formatted icons
It should linked with 12 icons for full operation 
(where the indexed picture sequence is 0~9, dot, minus)
 Tachometer (TCM)
Tachometer Element link with VP_N16 or VP_N32 which show as a meter display accordingly
If the value in side the VP is outside the defined max/min rang, it will display nothing