Action Elements: Difference between revisions

From Smart LCD
← Older editNewer edit →
VisualWikitext
Line 2: Line 2:
[[File:Properties Touch Key.png|right]]
[[File:Properties Touch Key.png|right]]
[[File:TPK.png|128x128px]]
[[File:TPK.png|128x128px]]
'''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


'''General'''
'''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.


* Show the basic information of the element
'''Target'''
* X and Y is the location of element on screen, reference point is element top-left corner
Target Page is for page jump function after touch
* Width and Height are in pixels
* - top-left corner of the screen = 0,0


'''Visual Effect'''
'''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


* On Press Down options are None / Inverse Color(*4) / Show Icon(*5) / Show Cropped BgImg(*6)
  '''Content'''
* 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.
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)


'''Target'''
'''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


* Target Page is for page jump function after touch
  '''Properties Control (advance feature)'''
 
Enable VP is none by default (element operate normally)
'''Call'''
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
* 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'''
 
<nowiki>*</nowiki>1. Please also see "TPK, VPK Call Functions" section for Call Features
 
<nowiki>*</nowiki>2. TPK support touch and move, action on release. It could change to "Touch-Key lock on touch" in "Project Setting".
 
<nowiki>*</nowiki>3. Please also see "Command" section for details


'''Note'''
<nowiki>*</nowiki>1. Please also see "TPK, VPK Call Functions" section for Call Features
<nowiki>*</nowiki>2. TPK support touch and move, action on release. It could change to "Touch-Key lock on touch" in "Project Setting".
<nowiki>*</nowiki>3. Please also see "Command" section for details
<nowiki>*</nowiki>4. TPK Visual Effect - Inverse Color
<nowiki>*</nowiki>4. TPK Visual Effect - Inverse Color
{|
{|
Line 84: Line 85:
[[File:Properties Virtual Key.png|right]]
[[File:Properties Virtual Key.png|right]]
[[File:VPK.png|128x128px]]
[[File:VPK.png|128x128px]]
'''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.


'''General'''
'''Condition'''
 
Monitor-VP is a VP to trigger this Virtual Key
* Show the basic information of the element
Monitor-Value is the Value for trigging this element
* X and Y is the location of element on screen (top-left corner of the screen = 0,0) element top-left corner is the reference point
* Width and Height are in pixels
* 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
'''Target'''
* Call Operation is for simple calculation after touch
Target Page is for page jump function after touch
* Call Key is for building PIP_Keyboard


'''Content'''
'''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


* VP Address is for calculation or Keyboard input result
'''Content'''
* 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
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)


* 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:
<nowiki>*</nowiki>1. Please also see "TPK, VPK Call Functions" section for Call Features
<nowiki>*</nowiki>2. Floating point value could only operate with N32 (or Compile As N32) and PIP Number Keyboard


'''Properties Control (advance feature)'''
== Swap Page (SWP_PG) ==
[[File:Properties Swap Page.png|right]]
[[File:SWP-PG.png|128x128px]]
'''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.


* 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
'''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)


Note:
'''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


<nowiki>*</nowiki>1. Please also see "TPK, VPK Call Functions" section for Call Features
'''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


<nowiki>*</nowiki>2. Floating point value could only operate with N32 (or Compile As N32) and PIP Number Keyboard
'''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

Revision as of 17:56, 10 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/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
Retrieved from "https://topway.app/sld_doc/en/index.php?title=Action_Elements&oldid=448"