ScreenΒΆ

These elements allow configuration of the measurement screens that will be shown in Oxygen. Each <Screen> element appends a new screen, the first of which will be displayed initially. If no screen is defined in the setup file, a single default one will be configured with a saturation meter to give an overview about all analog measurement channels.

<Screen [template="string"]>
    <Instrument .../>*
</Screen>

template: Specifies the name of an existing screen template to load instruments from.

Each screen contains <Instrument> elements, which are used to either create new instruments or configure those loaded from a template. Channels referenced as children will be added to the instrument in order.

The location of an instrument is specified by coordinates in the range of 0.0 to 1.0 for both axis. The origin (0.0, 0.0) is located at the top left corner of the screen, with values increasing to the right and bottom.

The first syntax creates a new instrument at the specified location:

<Instrument type="string" [x="number|0.0"] [y="number|0.0"] [w="number|0.1"] [h="number|0.1"]>
    <Channel ref="channeltag"/>*
</Instrument>

type: One of the following identifiers:

  • oxy::analog - Analog meter

  • oxy::bar - Bar meter

  • oxy::digital - Digital meter

  • oxy::indicator - Indicator

  • oxy::saturation_meter - Saturation meter

  • oxy::chart_recorder - Chart recorder

  • oxy::recorder - Recorder

  • oxy::scope - Scope

  • oxy::xyplot - XY plot

  • oxy::array - array chart

  • oxy::intensity_diagram - Intensity diagram

  • oxy::spectrogram - Spectrogram

  • oxy::spectrum_analyzer - Spectrum analyzer

  • oxy::image_display - Image

  • oxy::text_display - Text

  • oxy::gpsplot - GPS plot

  • oxy::gpsquality - GPS quality

  • oxy::audioplayer - Audio player

  • oxy::control - Control

  • oxy::output_channel - Outpt channel

  • oxy::power_group - Power

  • oxy::table - Table

  • oxy::video - Video

x, y: Coordinates of the left and upper border of the instrument. The valid range is [0.0, 1.0).

w, h: Width and height of the instrument. The results of the terms x+w and y+h have to be in the range (0.0, 1.0].

The second second version is used to configure an instrument that was loaded from a template:

<Instrument ref="string">
    <Channel ref="channeltag"/>*
</Instrument>
ref: Selects an existing instrument of a template for configuration. The value is a series of zero-based indices separated by a dot, which describe the path across groups to reach the wanted instrument.

Most screens do not use instrument groups, therefore a single index is usually sufficient to address any instrument. The internal structure of more complex screens can be discovered by inspecting the XML content of the template file (.screen).