Function Features: Difference between revisions
From Smart LCD
| Line 59: | Line 59: | ||
=== Character Elements (Alpha Numeric Elements) === | === Character Elements (Alpha Numeric Elements) === | ||
'''[[File:STS.png|64x64px]] Static String (STS)''' | '''[[File:STS.png|64x64px]] Static String (STS)''' | ||
Static String Element shows text string defined | Static String Element shows text string defined in its properties | ||
'''[[File:STR.png|64x64px]] String Element (STR)''' | '''[[File:STR.png|64x64px]] String Element (STR)''' | ||
| Line 91: | Line 91: | ||
'''[[File:ANI.png|64x64px]] Animation Element (ANI)''' | '''[[File:ANI.png|64x64px]] Animation Element (ANI)''' | ||
Animation Element links to an IMG_ANI and shows it on the screen | Animation Element links to an IMG_ANI and shows it on the screen | ||
Refresh speed is defined in Play Speed | |||
'''[[File:IDX BIT.png|64x64px]] Bit Icon (IDX_BIT)''' | '''[[File:IDX BIT.png|64x64px]] Bit Icon (IDX_BIT)''' | ||
Bit Icon Element | Bit Icon Element displays icon or cropped background based on bit value in linked VP | ||
'''[[File:IDX.png|64x64px]] Indexed Icon (IDX)''' | '''[[File:IDX.png|64x64px]] Indexed Icon (IDX)''' | ||
Indexed Icon Element | Indexed Icon Element displays icon/image based on value in linked VP | ||
If the value in side the VP is outside the defined max/min rang, it will display nothing | If the value in side the VP is outside the defined max/min rang, it will display nothing | ||
Revision as of 14:40, 18 June 2025
Elements
Action Elements
Touch_Key (TPK)
Touch_Key Element is used on a page. User touching on its assigned area will trigger an event.
- Touch Key assigned area provides visual touch response (e.g. inverse color or show a icon, etc).
- The event will in turn report its ID (Page_ID / Key_ID, operated VP_address and value, etc) to the host machine.
- The event kicks off call functions to provide various kinds of actions (e.g. keyboards, value operations, page jump, etc.)
Virtual_Key (VPK)
Virtual_Key is a non-display element, like an event.
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 reset as 0
(note: VPK is active only when its parent Page is shown on screen)
Swap_Page (SWP_PG)
Swap_Page Element is a full screen element. It allows user to jump to another PAGE
- Swipe action should start on screen area without any other touch element
- The action leads to two different PAGEs depends on the horizontal swiping direction (left-to-right or right-to-left)
- It will also report to the host machine about its Target Page_ID
TPK_Repeat (TPK_RPT)
TPK_Repeat is an element (similar as TPK) which captures long-press input.
- Its assigned area provides visual touch response (e.g. inverse color or show a icon, etc)
- It only provides VP:=VP+value function
- Long-press will repeat the VP:=VP+value function (using negative value can provide subtract function)
- It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc)
TPK_Switch (TPK_SW)
TPK_Switch is an element that provides bit operation
- Touch Switch assigned area provides visual touch response (e.g. show a icon, etc)
- Touching the element will toggle its linked VP's bit value (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 provides 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 saves input value to linked VP, proportional to user slid position.
- It will also report to the host machine about IDs (Page_ID / Key_ID, operated VP_address and value, etc)
Slider_2 (SDR2)
Slider_2 is a full screen element (similar as SDR) operated by two points touch
- Two points 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 saves an input value between Min/Max corresponding to slid distant
- It will also report to the host machine about IDs (Page_ID / Key_ID, operated VP_address and value, etc)
Ring (RNG)
Ring is identical to Slider element, but with dial action
Ring_2 (RNG2)
Ring_2 is a full screen element same as Slider_2, with 2 touch points spin
note: Elements overlapped in the PAGE might affect the display result
Character Elements (Alpha Numeric Elements)
Static String (STS)
Static String Element shows text string defined in its properties
String Element (STR)
String Element is for displaying VP_STR content
- Display the VP_STR content in PAGE with alignment and formatting
- String Element shows linked VP's content in real-time
Scrolling String (STR_SCR)
Scrolling String Element 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
- Scrolling String displays linked VP's value in real-time
Number Element (N16, N32, N64)
Number Element is for displaying numeric value in different data types, 16bit, 32bit or 64bit
- Display the content in PAGE with alignment and formatting
- Number Element shows linked VP's numeric value
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.
note: Elements overlapped in the PAGE might affect the display result
Image 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
Refresh speed is defined in Play Speed
Bit Icon (IDX_BIT)
Bit Icon Element displays icon or cropped background based on bit value in linked VP
Indexed Icon (IDX)
Indexed Icon Element displays icon/image based on value in linked VP
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)
note: Elements overlapped in the PAGE might affect the display result
Graphics Elements
Tachometer - Hand Mode (HND)
Hand Element link with VP_N16 or VP_N32 which show as a meter display accordingly.
It can also generate the meter face with marking as well.
If the value in side the VP is outside the defined max/min rang, it will show the max or min pointing accordingly
Tachometer - Icon Mode (TCM)
Tachometer Element link with VP_N16 or VP_N32 which show a rotating icon or show a angular section of an icon as a meter accordingly
Tachometer - Donut Mode (R16, R32)
Donut Element links with VP_N16 or VP_N32 and display a ring based on its value.
The ring angle is a percentage of the defined max/min value with the VP value.
An ICON pointer could also be link with it as an option
Progress Bar (B16, B32)
Progress Bar Element links with VP_N16 and display a bar based on its value.
The bar length is a percentage of the defined max/min value with the VP_N16 value.
An ICON pointer could also be link with it as an option
Graph Element (G16)
Graph Element display graphical plot of the VP_G16 content
It provide real time update of the VP_G16 value
Bitmap Element (BP1)
Bitmap Element display a mono picture content which store inside VP_BP1
it show picture in 1bpp and provide LUT for mapping 0 and 1 to different defined color
It can real time update with the VP_BP1 value
Round Clock (CLK_R)
Round Clock Element shows the Smart LCM internal clock with hands.
It can also generate the meter face with marking as well.
QR Code Element (QRC)
QR Code Element generates a QR code with a linked VP_STR
Draw Pad (DPD)
Draw Pad Element is an element that execute a drawing function that store inside VP_N16
which point by its properties VP_address. Once the command value updated, the drawing will be updated in real time. ICON can also be shown by command.
note: Elements overlapped in the PAGE might affect the display result
Resources
PAGE and IMAGE Resources
Page (PAGE)
Page is the basic unit of display
It links to elements and background Image(background color) predefined in Editor
Template Page (PAGE)
Template Page is a overlay for pages
Elements in the Template Page can overlay over a range of pages specified
(e.g. place a TPK to jump to home page in a Template, then all pages can have that key for home function)
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
note: PAGEs and IMAGEs are store inside Smart LCD Flash memory.
VP Resources
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
note: VP variable are inside the Smart LCD RAM