General Data

return

Main Item

Description

Value Type

Properties

Comment

User defined text

text

Text Format

Normal Text
Your own free plain text
Binary
Enter one or more ASCII character codes, comma or space separated, in the range between 1 and 127.
For example '2' for a binary STX character, '3' for a binary ETX character, or '13, 10' for CR+LF.
See table ASCII Codes for an overview of all possible characters.
New Line
Same as Binary but already formatted as '13, 10' (meaning CR+LF) and without a possible Field Delimiter.
A Field Delimiter may be present when your layout purpose is for Export or ASCII Logging.

Background

Item Background is only supported by the Generic Display

Use this item to show a picture in the background of your display (your company logo, for example) or to divide the display with one or more horizontal or vertical straight lines.

Two background types are supported:

Image

A background image can be any of the commonly used image formats: JPG, BMP or PNG for example.
Transparent PNG images are also supported: i.e. that the selected display background color will stay visible.

In the view you can 'highlight' the image by hovering the mouse cursor above the upper-left corner:
- You can then drag the image with your mouse button down to another location in the display.
- You can resize the image by using a combination of Ctrl + Mouse Wheel.
- You can double click on the image upper-left corner to invoke a dialog for changing quickly the brightness and/or contrast.
- You can invoke right-mouse popup menu and select option"'Layout.." to change any other image property.

Line

A background line will draw a straight line from the selected location all the way to the right side or to the bottom of the display.

A line can be horizontal, vertical or a cross line

You can drag the start of the line with your mouse cursor pointing at the start of the line.
When the line is a cross, you should point the mouse cursor at the cross.

You can increase or decrease the line thickness by using a combination of Ctrl+Mouse Wheel at the upper/left corner of the line.
When the line is a cross, you should point the mouse cursor at the cross

drawing

Image Properties

Filename:
Use the browse button to select your image file. The default folder to look for will be the current project's Graphics folder.

Size:
Set the percentage value of the original image size. Valid range will be 1 - 1000%, default value is 50%.
Enter 100% to show the original image in its original size with aspect ratio.
There are three special values which you may enter: 0, -1 and -2.

0: [Full Stretch]
The image will be fully stretched to fill up the display from the current upper/left corner location, without keeping the aspect ratio.
-1: [Horizontal Stretch]
The image will be stretched from the current upper/left corner location to the right side of the display, keeping the aspect ratio.
-2: [Vertical Stretch]
The image will be stretched from the current upper/left corner location to the bottom of the display, keeping the aspect ratio.

Brightness/Contrast:

Enter a comma (or space) separated value for both brightness and contrast

Brightness range: 0% (dark) - 100% (light). 50% (default) means normal image
Contrast range: 0% (low) - 100% (heavy). 50% (default) means normal contrast

Line Properties

Line Type

Horizontal
Vertical
Cross

Line Width
This will define the thickness of the line. Default value is 3.

Counter

This is just a number that increments with every trigger update.
Might be useful, for example, if you want to export a 'row number' in your ASCII export file.

One remark:

You can not assign a start value, it will always be 1 at the very first update. Note that you may use the Operator and/or Translation properties to modify the value.

int

Time

In general, this is the current computer system time, by default in UTC.
More specific, it depends on the update mode of the display/driver/log file/export:

Time based
When on-line, it's the current computer time, and in case PPS is used, it will be the PPS time.
When replaying, it is the time of the last position filter calculation.
Fix based
The time of the last fix event
System based
The time of the last update for the selected system
Event based (Driver and Log File only)
The time of the event
Node based (Export only)
The time of the selected node result update

time

See Time Format
Time Offset

[Local Time]
This entry also supports 'exotic' time zones, i.e. zones with decimal hours (e.g. Kathmandu +5.45hr).
List with hard coded time zone offsets in entire hours
I.e. that some 'exotic' time zones are not supported, but for this you may use the [User Defined] option. Offset 0 hr is the default, and represents UTC time.
[User Defined]
This will be UTC time plus/minus a user defined offset in seconds. E.g. enter 18.0 to output GPS time instead of UTC (18s per 1-1-2017).

Date

Same as Time
A date item is actually the same as a time item, only the default 'Time Format'-Property differs.
You may format a date item the same as a time item.

time

See Time Format

PPS Status

An integer value between 0 and 11.
You may define a translation table in order to translate the number codes into readable text.
Value will be empty in case there is no PPS system defined in your setup.

int

A default translation table will be added automatically.
0 OK
   PPS is working okay.
1 Unknown
2 Counter not running
3 Counter frequencies vary
4 Wait for pulses
    Pulses are not coming in.
   Check your PPS Adapter at your COMport.
   The red led must flash every second regularly.
5 No matching timetag found
6 No matching timetag found
7 Time between pulses is wrong
8 Missing pulse
9 No timetags received
   Messages with timetags are not coming in.
10 No pulses received
11 Wrong timetag interval

Of course you can modify/delete these predefined entries.

Recording Status

An integer value between 0 and 5.
You may define a translation table in order to translate the number codes into readable text.

int

A default translation table will be added automatically:
0 means On-line, Idle state
   Controller view is colored white
1 means On-line, Recording
   Controller view is colored red
2 means On-line, Paused
   Controller view is colored yellow
3 means Replay, Idle / Stopped
   Controller view is colored white
4 means Replay, Replaying
   Controller view is colored green
5 means Replay, Paused
   Controller view is colored yellow

Of course you can modify/delete these predefined entries.

Qinsy User Name

This will be the current Qinsy operator's user name as defined in the Console Settings:

Item value will be empty when User name support is disabled in the Console Settings

text

Template Db

Name of the on-line used template database.

text

Show Full Path

No (default)
Yes
The full path will be the original path during time of recording

Storage Db

Filename of the current raw database. Path is by default not included.

When showing in Generic Display during replay, this is of course the database name that is being replayed.

text

Show Full Path

No (default)
Yes

DTM File

Filename of the currently selected DTM file. Path is by default not included.
Value remains empty if storage to DTM is disabled.
(Item not available for export.)

text

Show Full Path

No (default)
Yes*

Sounding Grid

Filename of the currently selected sounding grid file. Path is by default not included.
Value remains empty if storage to a sounding grid is disabled.
(Item not available for export.)

text

Show Full Path

No (default)
Yes*

Sequence Number

The Sequence or Prefix number as defined in the Session Setup under Storage Database Filename. Lowest value is 1.

int

Job Number

This will be the current Job Number as defined in the Console Setting:

Note that the job number can also be changed inside the Controller in the Session Setup Storage page (but only when working online).

text