Function Features

From Smart LCD
Revision as of 11:27, 14 February 2025 by Usr255 (talk | contribs)

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