Character Elements: Difference between revisions

From Smart LCD
Line 138: Line 138:
  <u>Scroll Cycle VP</u> is none by default (using the above value)
  <u>Scroll Cycle VP</u> 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)
  Select a VP for real time scroll move cycle time control (0=reserved, 1=fastest, 10=default, 1000=slowest)
  '''Preview'''
  '''Preview'''
  <u>Preview Value</u> is only for displaying text in SGTools environment
  <u>Preview Value</u> is only for displaying text in SGTools environment
Line 168: Line 169:
  <u>VP Resource</u> is the type of VP hold the content (VP_N16 by default)
  <u>VP Resource</u> is the type of VP hold the content (VP_N16 by default)
  <u>VP Address</u> is the VP that hold the value
  <u>VP Address</u> is the VP that hold the value
'''Advance'''


- Compile As can force VP variable work different than default (Auto)
'''Advance'''
<u>Compile As</u> 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
<u>Data Type</u> 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)


VP_N16 (two successive VP_N16) work as VP_N32
'''Properties Control (advance feature)'''
<u>Enable VP</u> 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
<u>Font VP</u> 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
<u>Foreground color VP</u> 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
<u>Backgound color VP</u> 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
<u>Transparent VP</u> 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
<u>Decimal Digits VP</u> 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


VP_N32 (first two byte of VP_N32) work as VP_N16
'''Preview'''
 
<u>Preview Value</u> is only for displaying text in SGTools environment
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 as signed by default 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 enabled by a non-zero value or disable by a zero
 
 
'''Preview'''
 
- Character is for simulation in Graphics Editor environment

Revision as of 15:45, 16 May 2025

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 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)
Content
Static Test 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
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