Character Elements

Static String (STS)

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

Style
Font select font face
Font Size for TTF only
Font Color is the font face color
Background Color only available when Transparent is false
Transparent whether the Static String has background color.

Format
Align options are Left / Right / Center
Char Spacing options are Default / Shrink / AUTO(for font config 2 with DBCS)

Content
Static Text is the text content to be display 

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
Font VP is none by default (using the above selected font)
Select a VP for real time font ID change
VP value will copy the above ID at power-on.
Foreground color VP is none by default (using the above selected color)
Select a VP for real time foreground color adjustment
VP value will copy the above selected color at power-on.
Backgound color VP is none by default (using the above selected color)
Select a VP for real time background color adjustment
VP value will copy the above selected color at power-on.
Transparent VP is none by default (using the above option)
Select a VP for real time transparent background control
VP value will copy the above transparent config at power-on.
It can be enable by a non-zero value or disable by a zero

String Element (STR)

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

Style
Font select font face
Font Size for TTF only
Font Color is the font face color
Background Color only available with Transparent disable
Transparent true for disable the Background Color box to be show
Mask could be any char to "represent" as the char (Keep empty for normal operation)
Scroll is false by default
true to convert itself as Scrolling String element (see STR_SCR for details)

Format
Align options are Left / Right / Center / Multi-line Left / Multi-line Right / Multi-line Center
(Multi-line new line code = 0x0A)
Char Spacing options are Default / Shrink / AUTO(for font config 2 with DBCS)

Content
VP Resource is the type of VP hold the text content (VP_STR by default)
VP Address is the VP that hold the string content (all the string should be end with \0 (0x00))
Length is no. of Char going to display

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
Font VP is none by default (using the above selected font)
Select a VP for real time font ID change
VP value will copy the above ID at power-on
Foreground color VP is none by default (using the above selected color)
Select a VP for real time foreground color adjustment
VP value will copy the above selected color at power-on
Backgound color VP is none by default (using the above selected color)
Select a VP for real time background color adjustment
VP value will copy the above selected color at power-on
Transparent VP is none by default (using the above option)
Select a VP for real time transparent background control
VP value will copy the above transparent config at power-on
It can be enable by a non-zero value or disable by a zero

Preview
 Preview Value is only for displaying text in SGTools environment

Scrolling String (STR_SCR)

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

Style
Font select font face
Font Size for TTF only
Font Color is the font face color
Background Color only available with Transparent disable
Transparent true for disable the Background Color box to be show
Mask could be any char to "represent" as the char (Keep empty for normal operation)
Scroll is true by default
false to convert itself to String element (see STR for details)
Scroll Direction can be Horizontal or Vertical
Scroll Pixels defined the text each move (0=no scroll, negative value for reverse scroll)

Format
Align options are Left / Right / Center
Char Spacing options are Default / Shrink / AUTO(for font config 2 with DBCS)

Content
VP Resource is the type of VP hold the text content (VP_STR by default)
VP Address is the VP that hold the string content (all the string should be end with \0 (0x00))
Length is no. of Char going to display

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
Font VP is none by default (using the above selected font)
Select a VP for real time font ID change
VP value will copy the above ID at power-on
Foreground color VP is none by default (using the above selected color)
Select a VP for real time foreground color adjustment
VP value will copy the above selected color at power-on
Backgound color VP is none by default (using the above selected color)
Select a VP for real time background color adjustment
VP value will copy the above selected color at power-on
Transparent VP is none by default (using the above option)
Select a VP for real time transparent background control
VP value will copy the above transparent config at power-on
It can be enable by a non-zero value or disable by a zero
Scroll Cycle VP is none by default (using the above value)
Select a VP for real time scroll move cycle time control (0=reserved, 1=fastest, 10=default, 1000=slowest)

Preview
Preview Value is only for displaying text in SGTools environment

Number Element (NUM)

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

Style
Font select font face
Font Size for TTF only
Font Color is the font face color
Background Color only available with Transparent disable
Transparent true for disable the Background Color box to be show
Mask could be any char to "represent" as the char (Keep empty for normal operation)

Format
Align options are Left / Right / Center
Char Spacing options are Default / Shrink / AUTO(for font config 2 with DBCS)
Integer Digits is the no. of digit on left side of the dot (default Auto) (*1)(*2)
Decimal Digits is the no of digit on right side of the dot (*1)(*2)
Display Format option: Decimal / Hexadecimal

Content
VP Resource is the type of VP hold the content (VP_N16 by default)
VP Address is the VP that hold the value

Advance
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 options are Signed(default) / Unsigned / Float(for VP_N32)
For the decoding of the RAM content, it could also present unsigned value or floating value, too.
(please make sure the value in the VP variable appropriate for the type)

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
Font VP is none by default (using the above selected font)
Select a VP for real time font ID change
VP value will copy the above ID at power-on
Foreground color VP is none by default (using the above selected color)
Select a VP for real time foreground color adjustment
VP value will copy the above selected color at power-on
Backgound color VP is none by default (using the above selected color)
Select a VP for real time background color adjustment
VP value will copy the above selected color at power-on
Transparent VP is none by default (using the above option)
Select a VP for real time transparent background control
VP value will copy the above transparent config at power-on
It can be enable by a non-zero value or disable by a zero
Decimal Digits VP is none by default (using the above option)
Select a VP for real time Decimal Digits control
VP value will copy the above transparent config at power-on

Preview
Preview Value is only for displaying text in SGTools environment

note

*1. Integer Digits / Decimal Digits Formatting Examples

VP's value (10's)	Integer Digits	Decimal Digits	Display Result	Descriptions
15	Auto	3	0.015	Decimal Digits = 3,    zero prefix is added. Integer Digits = Auto, a minimal 0 is shown
23762	Auto	3	23.762	Decimal Digits = 3,    least 3 digit as decimal value Integer Digits = Auto, unlimited Integer digit
5629	5	1	00562.9	Decimal Digits = 1,     least 1 digit as decimal value Integer Digits = 5,     zero prefix is added
-87913	3	2	-879.13	Decimal Digits = 2,     two decimals Integer Digits = 3,     show all the rest as integer Negative signed value use ”-“ as prefix
-13277	2	2	-99.99	The VP's value over the maximum value that could be display, the max value (within the display format) shown with sign.
1758	3	0	999	The VP's value over the maximum value that could be display, the max value (within the display format) shown.

*2. Float type value might rounded or truncated due to hex-dec conversion

*3. Float type value is suggested to select: Integer Digits=Auto, Decimal Digits=1~9, to prevent over maximum value presentation error

Timer Display (TMR)

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

Style
Font select font face
Font Size for TTF only
Font Color is the font face color
Background Color only available with Transparent disable
Transparent true for disable the Background Color box to be show

Format
Align options are Left / Right / Center
Char Spacing options are Default / Shrink / AUTO(for font config 2 with DBCS)
Time Format options are: HH:mm:ss / mm:ss / ss

Content
Timer select a timer specific inside VP_N32 area

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
Font VP is none by default (using the above selected font)
Select a VP for real time font ID change
VP value will copy the above ID at power-on
Foreground color VP is none by default (using the above selected color)
Select a VP for real time foreground color adjustment
VP value will copy the above selected color at power-on
Backgound color VP is none by default (using the above selected color)
Select a VP for real time background color adjustment
VP value will copy the above selected color at power-on
Transparent VP is none by default (using the above option)
Select a VP for real time transparent background control
VP value will copy the above transparent config at power-on
It can be enable by a non-zero value or disable by a zero

Real Time Clock (RTC)

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

Style
Font select font face
Font Size for TTF only
Font Color is the font face color
Background Color only available with Transparent disable
Transparent true for disable the Background Color box to be show

Format
Char Spacing options are Default / Shrink / AUTO
Date/Time Format options are:
YYYY-MM-dd / YYYY-MM-dd HH:mm:ss / W YYYY-MM-dd / W YYYY-MM-dd HH:mm:ss /
YYYY / MM / DD / HH / mm / ss

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
Font VP is none by default (using the above selected font)
Select a VP for real time font ID change
VP value will copy the above ID at power-on
Foreground color VP is none by default (using the above selected color)
Select a VP for real time foreground color adjustment
VP value will copy the above selected color at power-on
Backgound color VP is none by default (using the above selected color)
Select a VP for real time background color adjustment
VP value will copy the above selected color at power-on
Transparent VP is none by default (using the above option)
Select a VP for real time transparent background control
VP value will copy the above transparent config at power-on
It can be enable by a non-zero value or disable by a zero