Function Features: Difference between revisions

From Smart LCD
← Older edit
VisualWikitext
Usr230 (talk | contribs)
24 edits
Usr230 (talk | contribs)
24 edits
 
(3 intermediate revisions by the same user not shown)
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 by its properties directly
  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  
  Its animation speed could be defined
  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 links with one bit value of VP_N16 or VP_N32
  Bit Icon Element displays icon or cropped background based on bit value in linked VP
which could point to an IMG_ICON and display accordingly with its value


  '''[[File:IDX.png|64x64px]] Indexed Icon (IDX)'''
  '''[[File:IDX.png|64x64px]] Indexed Icon (IDX)'''
  Indexed Icon Element links with VP_N16 or VP_N32 which could point to an IMG_ICON and display accordingly
  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 137: Line 136:


  [[File:CLK-R.png|64x64px]] '''Round Clock (CLK_R)'''
  [[File:CLK-R.png|64x64px]] '''Round Clock (CLK_R)'''
  Round Clock Element shows the Smart LCM internal clock with hands.
  Round Clock Element shows the Smart LCM internal real time clock's time
It can also generate the meter face with marking as well.


  [[File:QRC.png|64x64px]] '''QR Code Element (QRC)'''
  [[File:QRC.png|64x64px]] '''QR Code Element (QRC)'''
Line 144: Line 142:


  [[File:DPD.png|64x64px]] '''Draw Pad (DPD)'''
  [[File:DPD.png|64x64px]] '''Draw Pad (DPD)'''
  Draw Pad Element is an element that execute a drawing function that store inside VP_N16
  Draw Pad Element defines a screen area, to which external command can trigger predefined drawing actions
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
note: Elements overlapped in the PAGE might affect the display result


Line 153: Line 150:
  '''[[File:PAGE.png|48x48px]] Page (PAGE)'''
  '''[[File:PAGE.png|48x48px]] Page (PAGE)'''
  Page is the basic unit of display
  Page is the basic unit of display
  It links to elements and background Image(background color) predefined in Editor
  It hold elements and background Image(background color) predefined in Editor


  '''[[File:PAGE.png|48x48px]] Template Page (PAGE)'''
  '''[[File:PAGE.png|48x48px]] Template Page (PAGE)'''
Line 160: Line 157:
  (e.g. place a TPK to jump to home page in a Template, then all pages can have that key for home function)
  (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 Image (IMG_BKG)'''
  '''[[File:BKG IMG.png|48x48px]]Background Images (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.
  Background Image is a place to group imported images together


  '''[[File:ICO IMG.png|48x48px]] Icon (IMG_ICO)'''
  '''[[File:ICO IMG.png|48x48px]] Icons (IMG_ICO)'''
  Icon is one of the Picture Recourses
  Icons is one of the Picture Recourses (similar to Background Images) to group imported icons in one place
Icon files could be imported in to the Editor and linked by various elements (e.g. TPK ,IDX ,I32/16 ,B16 , ICO, etc)


  '''[[File:ANI IMG.png|48x48px]] Animation (IMG_ANI)'''
  '''[[File:ANI IMG.png|48x48px]] Animations (IMG_ANI)'''
  Animation is one of the Picture Resources
  Animations is one of the Picture Resources, holding series of images for animation creation
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.
note: PAGEs and  IMAGEs are store inside Smart LCD Flash memory.


=== VP Resources ===
=== VP Resources ===
  '''[[File:VP STR.png|48x48px]] String Variable (VP_STR)'''
  '''[[File:VP STR.png|48x48px]] String Variable (VP_STR)'''
  String Variable with 128bit length for character strange storage  (note: content must end with "\0')
  String Variable is a 128bit memory space for holding string  (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.


  '''[[File:VP N16.png|48x48px]] 16bit Integer Variable (VP_N16)'''
  '''[[File:VP N16.png|48x48px]] 16bit Integer Variable (VP_N16)'''
  range: -32767~32767
  range: -32767~32767
  The memory space could be allocated in Editor, and linked and display by elements like N16, IDX, I16, VPK, etc.
  A 16bit memory space for saving integer


  '''[[File:VP N32.png|48x48px]] 32bit Integer Variable (VP_N32)'''
  '''[[File:VP N32.png|48x48px]] 32bit Integer Variable (VP_N32)'''
  range: -2147483647 ~ 2147483647
  range: -2147483647 ~ 2147483647
  The memory space could be allocated in Editor, and linked and display by elements like N32, I32, etc.
  A 32bit memory space for holding integer


  '''[[File:VP N64.png|48x48px]] 64bit Integer Variable (VP_N64)'''
  '''[[File:VP N64.png|48x48px]] 64bit Integer Variable (VP_N64)'''
Line 189: Line 183:
  (-9223372036854775808 (0x8000 0000 0000 0000) is reserved value)
  (-9223372036854775808 (0x8000 0000 0000 0000) is reserved value)
  (9223372036854775807 (0x7FFF FFFF FFFF FFFF) 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.
  A 64bit memory space for holding integer


  '''[[File:VP G16.png|48x48px]] 16bit Graph Variable (VP_G16)'''
  '''[[File:VP G16.png|48x48px]] 16bit Graph Variable (VP_G16)'''
  groups of 16bit integer values for graphical-curve display data storage
  An array of 16bit binary values for plotting Graph Element
  Range:  -32767 ~32767 (-32768d (0xFFFF) is reserved value)
  Range:  -32767 ~32767 (-32768d (0xFFFF) is reserved value)
The memory space could be allocated in Editor, and linked/display by elements G16, etc


  '''[[File:VP BP1.png|48x48px]] Bitmap Variable (VP_BP1)'''
  '''[[File:VP BP1.png|48x48px]] Bitmap Variable (VP_BP1)'''

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

Retrieved from "https://topway.app/sld_doc/en/index.php?title=Function_Features&oldid=782"