Polybench® Reference
Viewer for viewing sample values from one channel (the first channel at the input).

Numerical Display


Use the Numerical Display to make a large display of values on a user screen. The display can show signal values, as well as the signal time, the computer real time and date, and a time range.

Operator ports

Input S[0]: Floating point values

Paired User Interface Object

This operator is loaded simultaneously with a user interface object. The user interface object can be moved to another page, and would normally be displayed in the end-user application. The operator and this user interface object can never be separated. If you delete the operator, the user interface is deleted automatically as well. Note that you cannot delete the user interface, only the operator symbol!


Find more information about changing properties here: link

type: Integer value
The position of the left border of the area that contains the value, in pixels.

type: Integer value
The width in pixels of the area in which the unit name is displayed (at the right side of the display).

type: Integer value
The height of the area that contains the title. Set to 0 if you don't require a title.

type: Known color name
The background color

This property uses the Color Repository. For more information about the use of colors in a project, refer to link

type: Known color name
The foreground color

This property uses the Color Repository. For more information about the use of colors in a project, refer to link

type: Known color name
The color of the content

This property uses the Color Repository. For more information about the use of colors in a project, refer to link

type: See description
The way the value in the display is displayed. E.g.: '.1' for one digit and a decimal point, or 'h:m:s,3' for a time value with three digits and a decimal comma.

The default value for this property is ">;1", which means that one digit is displayed, if the input value is not a natural number; otherwise no digit is displayed. A decimal point or comma is used according to the culture settings of the operating system. See also here: link.

type: See description
Specify a value that you know is an invalid value in the signal. If the input value is equal to this value, then the InvalidValueText is displayed. If InvalidValueText is empty, then InvalidValue is not evaluated.

Invalid values are only evaluated if Mode is either set to InputValues or CounterToTime.

type: See description
Specifies the text that is displayed in case an invalid value is detected at the input. See also the documentation of InvalidValue.

type: See description
The title of the display. Leave this empty to get a channel name as title.

type: Select from the list
Display mode, which specifies what kind of values are shown in the display. Select an item from the list.
Select one of those presets:
Values from the data input are displayed.
The display displays time from a signal at the input. The NumberFormat public should be able to display time.
The display displays the PC real time clock. The NumberFormat public should be able to display time.
The display displays the PC real time clock including date. The NumberFormat public should be able to display time.
The display displays the time range from the Viewer Preparation operator at its input. The NumberFormat public should be able to display time.
Values from the data input are divided by the input sample frequency (Fs) and displayed as time.

type: See description
The type face of all texts.

type: Select from the list
Select a style for the outer border of the display.
Select one of those presets:
The panel or control has no border
The panel or control has a border consisting of a line that is one pixel thick.

type: See description
If this object should be synchronous with other review objects, then they should all have an equal SyncID, that you can think out yourself.

type: Word or phrase
The name of the object in the project. This name must not contain '.' or '$' characters.

Every object has the Caption property. This property is very important, because it is the name by which Polybench recognizes this object.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.

type: See description
Optional documentation of this object.

It is good practice to write in short notes why you have used this object, and why its properties are set the way they are set. If this object is an operator, the Documentation text is displayed below the operator symbol.

Variable Parameters

Find more information about Variable Parameters here: link

type: See description
The value that is currently displayed (read-only)


In the figure below a few display possibilities are shown:

Layout of the Numerical Display

The Numerical Display user interface is divided in four areas, of which the size and position can be modified. The figure below shows the different areas and the properties that you should change to change the size of the areas:

If values don't fit in the value content area

The size of the value content area is a result of the general size of the Numerical Display, minus the left and right areas. In some cases, the values that should be displayed - depending on the size of the text type face - may not fit in that area. Whenever a value cannot be displayed entirely, it will be truncated and '...' will be written behind it, indicating that the value is not complete.

Normally, values should be displayed entirely, so you have to take care that the Numerical Display is large enough to display all possible values. The truncation feature is only there to warn the end user that a value is not complete. If this situation occurs, the designer of the app is strongly encouraged to change its design in a way that the displays are large enough for the values that are displayed.

Please note that because of display resolution and text font settings of the operating system of your end user, the value content may be slightly larger than you intended it to be. This may lead to truncation of the displayed value.

User Interface Object on Printable Pages

The user interface of this component will not be printed on a report if it is put on a Printable Page (see link). The reason for that, is that the object is especially designed for use on screens, and does not have a function on paper.

Behaviour in relation to the data cursor in reviewed data

This object reacts on a change of the central Data Cursor of a group of synchronized objects. This means that if this object has the same SyncID as the object that changes the Data Cursor, then this object will change its state accordingly. For more information see also: link.


Example: Numerical Display Demo
Demonstrates the various display possibilities of the Numerical Display.

Example: Numerical Display Invalid Value Demo
Demonstrates the Invalid Value feature. Press the button to set the invalid-value to the signal. The Numerical Display now displayes .