Action Elements

From Smart LCD

Touch Key (TPK) Properties

General
Show the basic information of the element
X and Y is the location of element on screen, reference point is element top-left corner
Width and Height are in pixels
top-left corner of the screen = 0,0
Visual Effect
On Press Down options are  None / Inverse Color(*4) / Show Icon(*5) / Show Cropped BgImg(*6)
Icon/BgImage base on the above option, select a Background Image or an Icon for the visual effect
SGT can show a box of a Background Image corresponding to the Touch Key area.
Target
Target Page is for page jump function after touch
Call
Call Keyboard is for call up a keyboard after touch
Call Operation is for simple calculation after touch
Call Key is for building PIP_Keyboard
Content
VP Address is for calculation or Keyboard input result
Compile As can force VP variable work different than default (Auto); 
VP_N16 (two successive VP_N16) work as VP_N32;
VP_N32 (first two byte of VP_N32) work as VP_N16;
VP_N64 (first two byte of VP_N64) work as VP_N16; 
VP_N64 (first four byte of VP_N64) work as VP_N32
Data type should be signed by default (*1)
Return
Return Value for select type of notification to host during touch.
It can notify the Host via Touch Key ID Response code (0x78) (*3): none / Up PGID + TPKID / PGID + TPKID / PGID + TPKID
none  no notification (by default);
Up PGID + TPKID, send on TPK release;
Down PGID + TPKID, send on TPK touch Down;
Up PGID + TPKID, send on TPK touch and release
Properties Control (advance feature)
Enable VP is none by default (element operate normally)
Select a VP for real time element control.
VP value will set to 1 as enable at power-on. It can be disabled (hidden) by a zero value
Note
*1. Please also see "TPK, VPK Call Functions" section for Call Features
*2. TPK support touch and move, action on release. It could change to "Touch-Key lock on touch" in "Project Setting".
*3. Please also see "Command" section for details

*4. TPK Visual Effect - Inverse Color

PAGE with Backgroud Image

Display Result (when touching TPK)

*5. TPK Visual Effect - Inverse Color

PAGE with Backgroudn Image

Backgroud Image for Visual Effect

Display Result (when touching TPK)

*.6 TPK Visual Effect - Show Icon

PAGE with Backgroudn Image

Icon for Visual Effect

Display Result (when touching TPK)

Virtual Key (VPK) Properties

General
Show the basic information of the element
X and Y is the location of element on screen, reference point is element top-left corner
Width and Height are in pixels
top-left corner of the screen = 0,0
This element’s X, Y, Width, Height are not related to its functionality.
Condition
Monitor-VP is a VP to trigger this Virtual Key
Monitor-Value is the Value for trigging this element
Target
Target Page is for page jump function after touch
Call
Call Keyboard is for call up a keyboard after touch
Call Operation is for simple calculation after touch
Call Key is for building PIP_Keyboard
Content
VP Address is for calculation or Keyboard input result
Compile As can force VP variable work different than default (Auto)
VP_N16 (two successive VP_N16) work as VP_N32
VP_N32 (first two byte of VP_N32) work as VP_N16
VP_N64 (first two byte of VP_N64) work as VP_N16
VP_N64 (first four byte of VP_N64) work as VP_N32
Data type should be signed by default (*1)
Properties Control (advance feature)
Enable VP is none by default (element operate normally)
Select a VP for real time element control. 
VP value will set to 1 as enable at power-on. It can be disabled (hidden) by a zero value
Note:
*1. Please also see "TPK, VPK Call Functions" section for Call Features
*2. Floating point value could only operate with N32 (or Compile As N32) and PIP Number Keyboard

Swap Page (SWP_PG)

General
Show the basic information of the element
X and Y is the location of element on screen, reference point is element top-left corner
Width and Height are in pixels
top-left corner of the screen = 0,0
This element’s X, Y, Width, Height are not related to its functionality.
Style
Sweep Threshold defines the sweeping distance which start the feature
Smaller value makes it more easy to be trigger
Bigger value makes it slower response to the action
(Sweep should start on screen area without any other touch element)
Target
Left Side Page is the target page that pull-out form left side while the touch sweeping form left to right
Right Side Page is the target page that pull-out form right side while the touch sweeping form right to left
Return
Return Value for select type of notification to host during touch
It can notify the Host via Touch Key ID Response code (0x32)
none, no notification (by default) (see "Command" section for details)
Target PGID, send on sweep release 
Properties Control (advance feature)
Enable VP is none by default (element operate normally)
Select a VP for real time element control. 
VP value will set to 1 as enable at power-on. It can be disabled (hidden) by a zero value