User manual

Toolbox 32 User Manual 1.47d www.cse-semaphore.com/mykingfisher
Page
179
Freeform Variable Definitions
Variables are defined in the text file after the heading %VARIABLES using the following format:
%VARIABLES
1 #R2.1 %b “OFF” “ON ”
Additional text settings
Display format: many options are available
as detailed below.
Display format must start with a %
Address or tagname: Any valid data address
starting with a # (eg. #R1, #YDIAG.1) or the
TagName of a variable in the Variables List of
the selected RTU site in an open project.
Variable number: the variable number (1 to
999) used on the text page as %1 to % 999
Display Formats
%[-/+/#][n/0n][.0/.n]type
.0 For e, E, f types no
decimal point is printed.
.n n digits or n decimal
places are printed.
For e, E, f, g, G types, the
last digit printed is rounded.
Default (when unspecified):
uses .1 for d, i, o, u, x, X
types and uses .6 for e, E, f
types. Displays all significant
digits for g, G types.
n At least n characters are printed.
The value is padded with blanks.
0n At least n characters are
printed. The value is padded with
leading zeros.
- Left justified
+ Value starts with a + or -
# If type is o, value begins with a 0. If type
is x or X, value starts with 0x. If type is e, E
or f, value will have a decimal point. If type
is g or G, value will have a decimal point
and trailing zeros will not be removed.
Default (when not specified): If negative,
value starts with -
d Signed decimal integer
i Signed decimal integer
o Unsigned octal integer
u Unsigned decimal integer
x Unsigned hexadecimal integer using lower-case
letters a-f
X Unsigned hexadecimal integer using capital
letters A-F
f Floating point signed value of the form
[-]dddd.dddd
e Floating point signed value of the form
[-]d.dddd or e[+/-]ddd
E Same as e, but with capital E for exponent
g Floating point signed value in either the f or e
form based on given value and precision
G Same as g, but with E for exponent if e format is
used
b Bit string. Displays the first string if the bit is
False or displays the second string if the bit is True.
Strings must be separated by tabs or spaces.
a Animated string. If the value of the variable is 0,
the first string is printed. If the value is 1 the second
string is printed, etc. If the value exceeds the
number of given strings the last string is printed.
Strings must be separated by tabs or spaces.
s Scaled value. Displays a signed scaled value
assuming the raw range of the variable is 32767.
The signed engineering limits corresponding to a
raw input of 0 and 32767 respectively must be
specified as additional strings separated by tabs or
spaces.
Note: bracketed [ ] parameters are optional. n=1 to 15.