Action Elements: Difference between revisions

From Smart LCD
Line 1: Line 1:
== Touch Key (TPK) Properties ==
== Touch_Key (TPK) Properties ==
[[File:Properties Touch Key.png|right]]
[[File:Properties Touch Key.png|right]]
[[File:TPK.png|128x128px]]
[[File:TPK.png|128x128px]]
Line 82: Line 82:
|}
|}


== Virtual Key (VPK) Properties ==
== Virtual_Key (VPK) Properties ==
[[File:Properties Virtual Key.png|right]]
[[File:Properties Virtual Key.png|right]]
[[File:VPK.png|128x128px]]
[[File:VPK.png|128x128px]]
Line 122: Line 122:
  <nowiki>*</nowiki>2. Floating point value could only operate with N32 (or Compile As N32) and PIP Number Keyboard
  <nowiki>*</nowiki>2. Floating point value could only operate with N32 (or Compile As N32) and PIP Number Keyboard


== Swap Page (SWP_PG) ==
== Swap_Page (SWP_PG) ==
[[File:Properties Swap Page.png|right]]
[[File:Properties Swap Page.png|right]]
[[File:SWP-PG.png|128x128px]]
[[File:SWP-PG.png|128x128px]]

Revision as of 13:32, 12 May 2025

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/BgImg 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

TPK_Repeat (TPK_RPT)

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 / Show Icon / Show Copped Image
Icon/BgImage base on the above option select a Background Image or an Icon for the visual effect
Style
Mode is touch action moment
Down Action will trigger the Short Press feature while touch down
Up Action will trigger the Short Press feature while touch up
Long Press Time is the time for Long Press feature to be trigger
Long Press Cycle is the repeat action cycle time for long Press
Long Press Value is operation (VP:=VP+value) value for Long Press
Short Press Value is the operation (VP:=VP+value) value for Short Press
(negative value for minus operation)
Content
VP Resource is the type of VP to be used
VP Address is the VP for the operation
Min Value is the bottom value that will be limited by the operation
Max Value is the top value that will be limited by the operation
Return
Return Value / VP / Status VP for select type of notification to host
(multiple notification can be enable)
Up, PGID+TPKID
Down, PGID+TPKID
Up, VP Address+Value
Down, VP Address+Value
Cycling, VP Address+Value
Up, Vp Address+Status Value
Down, Vp Address+Status Value
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
Status VP is none by default
Select a VP for storing the real time status (0=no touch, 1=touch down, 2= long press)

TPK Switch (TPK_SW)