Skip to content

Get

Get is the type that writes a value on the screen as text. A numeric readout, a status message, a label — anything that shows text is built with it.

It is offered on text and tspan objects alone; you cannot write text into a circle or a rectangle.

Opening the form shows three modes at the top right. Which one you pick decides how the value is arrived at.

The Get form in Expressions mode

ModeWhen
ExpressionsYou compute the value by writing code
NumericYou format a numeric value without writing code
TextYou display a text value

In Expressions mode the editor shows System chips above the code: ready-made bindings you can reach from inside the expression — the animation’s name, whether this is the first scan, the screen’s parameters, and the active language.

Most readouts need no code. Numeric mode takes everything from the form, from reading the number to formatting it.

The Get form in Numeric mode

FieldDescription
VariableThe variable to read
Default ValueWhat to show when the value cannot be read
Value BitSelf takes the whole value; choosing a bit index reads only that bit out of the word
Prefix · SuffixText put before and after the value — the usual way to write a unit
FieldDescription
DecimalsHow many decimal places. Left empty, the value is written as received
ThousandsThe thousands separator
Decimal SeparatorThe decimal separator — dot or comma
PreviewHow your format renders on a sample number, as you set it

Preview is a small but useful detail on this form: it shows how the number will look there and then, without saving the format and running the screen.

Three fields decide what is shown when the data cannot be trusted:

FieldWhen it applies
Comm Error MessageThe variable’s connection has stopped bringing data
Stale Data MessageThe value has not been refreshed for the given period
Stale DurationHow long before a value counts as stale

The Conditions section lets you write different text according to the value, without code. Each row is a comparison, a value, and the text to return.

ConditionValueReturn
<10Low
>80High

If no condition matches, the number is written in its normal format.

ACCESS sits at the lower right of the form. Bind the element to an access group and it is not shown to a user outside that group. By default a binding belongs to no group and is visible to everyone.