Function Features

Basic Items

PAGE
Each display interface is a PAGE.
It could contain / link with all the predefined content.
(e.g. background image, page elements, etc. )

Element
29 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
Image 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 Variable
VP Variable 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

Resources

PAGE and IMAGE Resources

PAGEs and  IMAGEs are store inside Smart LCD Flash memory.

 Page (PAGE)
Page is the basic unit of display
It links to elements and background Image(background color) predefined in Editor

Background Image (IMG_BKG)
Background Image is one of the Picture Resources. Picture files could be imported into Editor as Background Image. It could also be used (automated crop) as TPK  touch down effect image.

 Icon (IMG_ICO)
Icon is one of the Picture Recourses
Icon files could be imported in to the Editor and linked by various elements (e.g. TPK ,IDX ,I32/16 ,B16 , ICO, etc)

 Animation (IMG_ANI)
Animation is one of the Picture Resources
It is a series of images file which imported into the Editor and linked by ANI element to play

VP Resources

VP variable are inside the Smart LCD RAM

 String Variable (VP_STR)
String Variable with 128bit length for character strange storage  (note: content must end with "\0')
The memory space could be allocated in Editor, and link and display by elements like STR, QR code, etc.

 16bit Integer Variable (VP_N16)
range: -32767~32767
The memory space could be allocated in Editor, and linked and display by elements like N16, IDX, I16, VPK, etc.

 32bit Integer Variable (VP_N32)
range: -2147483647 ~ 2147483647
The memory space could be allocated in Editor, and linked and display by elements like N32, I32, etc.

 64bit Integer Variable (VP_N64)
range: -9223372036854775807 ~  9223372036854775806
(-9223372036854775808 (0x8000 0000 0000 0000) is reserved value)
(9223372036854775807 (0x7FFF FFFF FFFF FFFF) is reserved value)
The memory space could be allocated in Editor, and linked and display by elements like N64, etc.

 16bit Graph Variable (VP_G16)
groups of 16bit integer values for graphical-curve display data storage
Range:  -32767 ~32767 (-32768d (0xFFFF) is reserved value)
The memory space could be allocated in Editor, and linked/display by elements G16, etc

 Bitmap Variable (VP_BP1)
groups of picture data in 1bpp
The memory space could be allocated in Editor, and linked/display by element BP1 

 Register Variable (VP_REG)
Special Register Variable for some of the system configuration
Timer Control, RTC Control, Buzzer Control, Backlight Control, Screen Saver Control, Code Page Control, Country Code Control

 Timer Variable (VP_TMR)
Timer counter inside VP_N32