Appendix A

Appendix A

Text Formatting Codes for Bargraphs/Joysticks

Text formatting codes for bargraphs provide a mechanism to allow a portion of a bargraphs text to be dynamically provided information about the current status of the level (multistate and traditional). These codes would be entered into the text field along with any other text.

The following is a code list used for bargraphs:

Bargraph Text Code Inputs

Code

Bargraph

Multi-State Bargraph

 

 

 

$P

Display the current percentage of the

Display the current percentage of the

 

bargraph (derived from the Adjusted

bargraph (derived from the Adjusted

 

Level Value as it falls between the

Level Value as it falls between the

 

Range Values)

Range Values)

 

 

 

$V

Raw Level Value

Raw Level Value

 

 

 

$L

Range Low Value

Range Low Value

 

 

 

$H

Range High Value

Range High Value

 

 

 

$S

N/A

Current State

 

 

 

$A

Adjusted Level Value (Range Low Value

Adjusted Level Value (Range Low Value

 

subtracted from the Raw Level Value)

subtracted from the Raw Level Value)

 

 

 

$R

Low Range subtracted from the High

Low Range subtracted from the High

 

Range

Range

 

 

 

$$

Dollar sign

Dollar sign

 

 

 

Buy changing the text on a button (via a VT command) you can modify the codes on a button. When one of the Text Formatting Codes is encountered by the firmware it is replaced with the correct value. These values are derived from the following operations:

Formatting Code Operations

Code

Operation

 

 

$P

(Current Value - Range Low Value / Range High Value - Range Low Value) x 100

 

 

$V

Current Level Value

 

 

$L

Range Low Value

 

 

$H

Range High Value

 

 

$S

Current State (if regular bargraph then resolves to nothing)

 

 

$A

Current Value - Range Low Value

 

 

$R

Range High Value - Range Low Value

 

 

Given a current raw level value of 532, a range low value of 500 and a high range value of 600 the following text formatting codes would yield the following strings as shown in the table below:

Example

Format

Display

 

 

$P%

32%

 

 

$A out of $R

32 out of 100

 

 

$A of 0 - $R

32 of 0 - 100

 

 

$V of $L - $H

532 of 500 - 600

 

 

7" Modero Widescreen Touch Panels

191

 

 

Page 201
Image 201
AMX CV7 Text Formatting Codes for Bargraphs/Joysticks, Bargraph Text Code Inputs, Formatting Code Operations, Example