Function Features: Difference between revisions
From Smart LCD
| (32 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
== Elements == | == Elements == | ||
=== Action | === Action Elements === | ||
[[File:TPK.png|64x64px]] ''' | [[File:TPK.png|64x64px]] '''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) | - 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.) | ||
[[File:VPK.png|64x64px]] ''' | [[File:VPK.png|64x64px]] '''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" | 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 | - 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.) | - 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 | - After being triggered, the monitored VP will be reset as 0 | ||
(note: only | (note: VPK is active only when its parent Page is shown on screen) | ||
'''[[File:SWP-PG.png|64x64px]] | '''[[File:SWP-PG.png|64x64px]] 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 | - It will also report to the host machine about its Target Page_ID | ||
'''[[File:TPK-RPT.png|64x64px]] | '''[[File:TPK-RPT.png|64x64px]] 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 | - 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) | - It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc) | ||
'''[[File:TPK-SW.png|64x64px]] | '''[[File:TPK-SW.png|64x64px]] 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) | - 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) | - It will also report to the host machine about its ID (Page_ID / Key_ID, operated VP_address and value, etc) | ||
'''[[File:SDR.png|64x64px]]Slider (SDR)''' | '''[[File:SDR.png|64x64px]]Slider (SDR)''' | ||
Slider is an element that | 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 | - Slider touch area can be defined as Horizontal or Vertical slide with Absolute or Relative mode options | ||
- It does not provide visual response | - It does not provide visual response | ||
- It | - It saves input value to linked VP, proportional to user slid position. | ||
- It will also report to the host machine about | - It will also report to the host machine about IDs (Page_ID / Key_ID, operated VP_address and value, etc) | ||
'''[[File:SDR2.png|64x64px]] | '''[[File:SDR2.png|64x64px]] Slider_2 (SDR2)''' | ||
Slider_2 is a full screen element (similar as SDR) operated by two points touch | |||
- Two | - 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 can be defined as Horizontal or Vertical slide with Gain options | ||
- It does not provide visual response | - It does not provide visual response | ||
- It | - It saves an input value between Min/Max corresponding to slid distant | ||
- It will also report to the host machine about | - It will also report to the host machine about IDs (Page_ID / Key_ID, operated VP_address and value, etc) | ||
'''[[File:RNG.png|64x64px]] | '''[[File:RNG.png|64x64px]] Ring (RNG)''' | ||
Ring is identical to Slider element, but with dial action | |||
'''[[File:RNG2.png|64x64px]] | '''[[File:RNG2.png|64x64px]] 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 (Alpha Numeric) | === 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)''' | ||
String Element is for displaying VP_STR content | String Element is for displaying VP_STR content | ||
- Display the VP_STR content in PAGE with alignment and formatting | - Display the VP_STR content in PAGE with alignment and formatting | ||
- String Element | - String Element shows linked VP's content in real-time | ||
'''[[File:STR SCR.png|64x64px]] Scrolling String (STR_SCR)''' | '''[[File:STR SCR.png|64x64px]] Scrolling String (STR_SCR)''' | ||
Scrolling String | 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 | - Display the VP_STR content in PAGE with alignment and formatting | ||
- Scrolling direction could be config as horizontal or vertical with speed options | - Scrolling direction could be config as horizontal or vertical with speed options | ||
- String | - Scrolling String displays linked VP's value in real-time | ||
'''[[File:Num.png|64x64px]] Number Element (N16, N32, N64)''' | '''[[File:Num.png|64x64px]] Number Element (N16, N32, N64)''' | ||
Number Element is for displaying | Number Element is for displaying numeric value in different data types, 16bit, 32bit or 64bit | ||
- Display the | - Display the content in PAGE with alignment and formatting | ||
- Number Element | - Number Element shows linked VP's numeric value | ||
'''[[File:TMR.png|64x64px]] Timer Display (TMR)''' | '''[[File:TMR.png|64x64px]] Timer Display (TMR)''' | ||
| Line 116: | Line 83: | ||
'''[[File:RTC.png|64x64px]] Real Time Clock (RTC)''' | '''[[File:RTC.png|64x64px]] Real Time Clock (RTC)''' | ||
Real Time Clock Element shows the Smart LCM internal clock with formatting. | Real Time Clock Element shows the Smart LCM internal clock with formatting. | ||
note: Elements overlapped in the PAGE might affect the display result | |||
=== Image | === Image Elements === | ||
'''[[File:ICO.png|64x64px]] Static Icon (ICO)''' | '''[[File:ICO.png|64x64px]] Static Icon (ICO)''' | ||
Static Icon Element links to an IMG_ICO and shows it on screen | Static Icon Element links to an IMG_ICO and shows it on screen | ||
| Line 123: | 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 | ||
| Line 138: | Line 105: | ||
(where the indexed picture sequence is 0~9, dot, minus) | (where the indexed picture sequence is 0~9, dot, minus) | ||
note: Elements overlapped in the PAGE might affect the display result | |||
If the value in side the VP is outside the defined max/min rang, it will display | === Graphics Elements === | ||
[[File:HND.png|64x64px]] '''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 | |||
'''[[File:TCM.png|64x64px]] 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 | |||
[[File:R16.png|64x64px]] '''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 | |||
[[File:B16.png|64x64px]] '''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 | |||
[[File:G16.png|64x64px]] '''Graph Element (G16)''' | |||
Graph Element display graphical plot of the VP_G16 content | |||
It provide real time update of the VP_G16 value | |||
[[File:BP1.png|64x64px]] '''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 | |||
[[File:CLK-R.png|64x64px]] '''Round Clock (CLK_R)''' | |||
Round Clock Element shows the Smart LCM internal real time clock's time | |||
[[File:QRC.png|64x64px]] '''QR Code Element (QRC)''' | |||
QR Code Element generates a QR code with a linked VP_STR | |||
[[File:DPD.png|64x64px]] '''Draw Pad (DPD)''' | |||
Draw Pad Element defines a screen area, to which external command can trigger predefined drawing actions | |||
note: Elements overlapped in the PAGE might affect the display result | |||
== Resources == | |||
=== PAGE and IMAGE Resources === | |||
'''[[File:PAGE.png|48x48px]] Page (PAGE)''' | |||
Page is the basic unit of display | |||
It hold elements and background Image(background color) predefined in Editor | |||
'''[[File:PAGE.png|48x48px]] 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) | |||
'''[[File:BKG IMG.png|48x48px]]Background Images (IMG_BKG)''' | |||
Background Image is a place to group imported images together | |||
'''[[File:ICO IMG.png|48x48px]] Icons (IMG_ICO)''' | |||
Icons is one of the Picture Recourses (similar to Background Images) to group imported icons in one place | |||
'''[[File:ANI IMG.png|48x48px]] Animations (IMG_ANI)''' | |||
Animations is one of the Picture Resources, holding series of images for animation creation | |||
note: PAGEs and IMAGEs are store inside Smart LCD Flash memory. | |||
=== VP Resources === | |||
'''[[File:VP STR.png|48x48px]] String Variable (VP_STR)''' | |||
String Variable is a 128bit memory space for holding string (note: content must end with "\0') | |||
'''[[File:VP N16.png|48x48px]] 16bit Integer Variable (VP_N16)''' | |||
range: -32767~32767 | |||
A 16bit memory space for saving integer | |||
'''[[File:VP N32.png|48x48px]] 32bit Integer Variable (VP_N32)''' | |||
range: -2147483647 ~ 2147483647 | |||
A 32bit memory space for holding integer | |||
'''[[File:VP N64.png|48x48px]] 64bit Integer Variable (VP_N64)''' | |||
range: -9223372036854775807 ~ 9223372036854775806 | |||
(-9223372036854775808 (0x8000 0000 0000 0000) is reserved value) | |||
(9223372036854775807 (0x7FFF FFFF FFFF FFFF) is reserved value) | |||
A 64bit memory space for holding integer | |||
'''[[File:VP G16.png|48x48px]] 16bit Graph Variable (VP_G16)''' | |||
An array of 16bit binary values for plotting Graph Element | |||
Range: -32767 ~32767 (-32768d (0xFFFF) is reserved value) | |||
'''[[File:VP BP1.png|48x48px]] Bitmap Variable (VP_BP1)''' | |||
groups of picture data in 1bpp | |||
The memory space could be allocated in Editor, and linked/display by element BP1 | |||
'''[[File:VP REG.png|48x48px]] 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 | |||
'''[[File:VP TMR.png|48x48px]] Timer Variable (VP_TMR)''' | |||
Timer counter inside VP_N32 | |||
note: VP variable are inside the Smart LCD RAM | |||
Latest revision as of 15:27, 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 real time clock's time
QR Code Element (QRC)
QR Code Element generates a QR code with a linked VP_STR
Draw Pad (DPD)
Draw Pad Element defines a screen area, to which external command can trigger predefined drawing actions
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 hold 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 Images (IMG_BKG)
Background Image is a place to group imported images together
Icons (IMG_ICO)
Icons is one of the Picture Recourses (similar to Background Images) to group imported icons in one place
Animations (IMG_ANI)
Animations is one of the Picture Resources, holding series of images for animation creation
note: PAGEs and IMAGEs are store inside Smart LCD Flash memory.
VP Resources
String Variable (VP_STR)
String Variable is a 128bit memory space for holding string (note: content must end with "\0')
16bit Integer Variable (VP_N16)
range: -32767~32767
A 16bit memory space for saving integer
32bit Integer Variable (VP_N32)
range: -2147483647 ~ 2147483647
A 32bit memory space for holding integer
64bit Integer Variable (VP_N64)
range: -9223372036854775807 ~ 9223372036854775806
(-9223372036854775808 (0x8000 0000 0000 0000) is reserved value)
(9223372036854775807 (0x7FFF FFFF FFFF FFFF) is reserved value)
A 64bit memory space for holding integer
16bit Graph Variable (VP_G16)
An array of 16bit binary values for plotting Graph Element
Range: -32767 ~32767 (-32768d (0xFFFF) is reserved value)
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