svg
└─── Layer1
      ├─── cdpTop               (element group)
      │     ├─── < Path >       (transparent rect/path)
      │     └─── < Group >      (graphics)
      ├─── cdpNeedleCenterCW    (transparent rect/path)
      ├─── cdpNeedleMin         (transparent rect/path)
      ├─── cdpNeedleMax         (transparent rect/path)
      ├─── cdpNeedleGraphics    (element group)
      │     ├─── cdpRectOutline (transparent rect/path)
      │     ├─── cdpRectCenter  (transparent rect/path)
      │     └─── < Group >      (graphics)
      ├─── cdpTextValue         (element group)
      │     ├─── < Path >       (transparent rect/path)
      │     └─── < Text >       (text)
      ├─── cdpTextPrefix        (element group)
      │     ├─── < Path >       (transparent rect/path)
      │     └─── < Text >       (text)
      ├─── cdpTextSuffix        (element group)
      │     ├─── < Path >       (transparent rect/path)
      │     └─── < Text >       (text)
      ├─── cdpTicksNumber       (text)
      ├─── cdpTicksColor        (text)
      ├─── cdpTicksMinorNo3T    (transparent rect/path)
      ├─── cdpTicksMajorNo9T    (transparent rect/path)
      ├─── cdpTicksOffset       (transparent rect/path)
      ├─── cdpTicksNumOffset    (transparent rect/path)
      ├─── cdpTicksNumRect      (transparent rect/path)
      ├─── cdpTicksMajorSize    (transparent rect/path)
      ├─── cdpTicksMinorSize    (transparent rect/path)
      ├─── cdpFillColor         (text)
      ├─── cdpFillOffset        (transparent rect/path)
      ├─── cdpFillWidth         (transparent rect/path)
      └─── cdpBackground        (element group or rect/path)
            ├─── < Path >       (transparent rect/path)
            └─── < Group >      (graphics)

svg
└─── Styles
      ├─── cdpTopStyleX         (element group)
      │     ├─── < Path >       (transparent rect/path)
      │     └─── < Group >      (graphics)
      ├─── cdpMiddleStyleX      (element group)
      │     ├─── < Path >       (transparent rect/path)
      │     └─── < Group >      (graphics)
      ├─── cdpNeedle1StyleX     (element group)
      │     ├─── < Path >       (transparent rect/path)
      │     └─── < Group >      (graphics)
      ├─── cdpTextValueStyleX   (text)
      ├─── cdpTextPrefixStyleX  (text)
      ├─── cdpTextSuffixStyleX  (text)
      ├─── cdpTextScaleStyleX   (text)
      └─── cdpBackgroundStyleX  (element group or rect/path)
            ├─── < Path >       (transparent rect/path)
            └─── < Group >      (graphics)

Property Documentation

ErrorColor : QColor

This property holds the color for error indicator.

Access functions:

NormalColor : QColor

This property holds the color for normal indicator.

Access functions:

WarningColor : QColor

This property holds the color for warning indicator.

Access functions:

WarningHighColor : QColor

This property holds the color for warning high indicator.

Access functions:

alarmSectorLimit : bool

This property holds whether or not to limit the alarm sectors to the meter min/max values.

Access functions:

alarmShow : bool

This property holds whether or not to show the alarm indicators.

Access functions:

aspectRatio : AspectRatio

This property holds the aspect ratio of the widget.

Access functions:

cdpOfflineValue : const double

This property holds the value to show when communication is offline and cdpOfflineValueEnabled is set to true.

The property has no effect when cdpOfflineValueEnabled is set to false.

See also cdpOfflineValueEnabled.

cdpOfflineValueEnabled : const bool

This property holds whether or not to show cdpOfflineValue when communication is offline.

Setting the property to false will make the widget keep/show the last value when communication is down.

See also cdpOfflineValue.

cdpRouting : QString

This property holds when wanting to display a cdp object in the widget, this property specifies its full name.

Access functions:

cdpScaling : const double

This property holds the factor to multiply the incoming signal/property value.

cdpStyleRouting : QString

Set the routing of the CDP object that are to change the widget svg style. Note that when cdpStyleProperty is empty we assume the object to be a CDPSignal (similar to adding 'Value' in cdpStyleProperty).

Access functions:

fill : bool

This property holds whether to enable or disable the fill sector.

When the property is not edited, meaning that the property name does not show in bold text in the property pane, the fill sector is enabled automatically based on the SVG file that styles the widget. In other words, it shows whether the SVG is configured to show fill by default.

Setting this property to false, ensures that fill is disabled even though it might be supported by the SVG. This could increase performance on systems with limited resources (as the widget won't need to repaint the fill sector each paint event).

The only reason to set the property true, is in a scenario where the fill should always show. This is useful if you want to set fill sector on a SVG that does not support it by default, and maintain the fill sector when switching between two such themes. Note that having it true while switching between non fill and default fill themes will make the fill color of the latter show for both themes.

Access functions:

See also fillOffset, fillWidth, and fillColor.

fillColor : QColor

This property holds the color to fill the sector from min to current value.

Setting the property to any color will enable fill, while pressing the reset button next to the property will disable it.

Note that switching theme will override any manual color configuration. To make a fill color stick when switching theme, this have to be added to the SVG file as described in the meter styling guide.

Access functions:

See also fillOffset and fillWidth.

fillOffset : double

This property holds the offset from needle tip to the edge of the fill sector.

When fillOffset is not set, CDPBaseMeter::ticksOffset will be used instead.

Set CDPBaseMeter::svgUpdateAll to false to make properties like offset stick when switching themes. When false, only properties that affect colors will get updated from the SVG.

Access functions:

See also fillColor and fillWidth.

fillStartValue : double

This property holds the value of the fill starting point.

The property defaults to minimum value when it has not been edited (showing in regular font in the property pane)

Access functions:

fillWidth : double

This property holds the tickness/width of the fill sector.

When fillWidth is not set, CDPBaseMeter::ticksMinorLength will be used instead.

Set CDPBaseMeter::svgUpdateAll to false to make properties like fill width stick when switching themes. When false, only properties that affect colors will get updated from the SVG.

Access functions:

See also fillColor and fillOffset.

maxValue : double

This property holds the value at the end of the meter.

Access functions:

meterType : MeterType

This property holds meter type, have to be set to “Custom” to be able to select custom .SVG file.

Access functions:

minValue : double

This property holds value at the start of the meter.

Access functions:

needle : bool

Access functions:

needleStyle : int

Access functions:

numFont : QFont

This property holds the font type for the numbers.

Access functions:

numOffset : int

This property holds the distance from the numbers to the meter edge.

Access functions:

numPostfix : QString

This property holds the postfix for the numbers on the meter.

Access functions:

numPrecision : int

This property holds the number of decimals to show.

Access functions:

numPrecisionMethod : CDPBaseTickMarks::NumPrecision

This property holds the precision method to use on numbers.

[AutoLimited] automatically limits the numbers of decimals to that in numPrecision property. Hides decimals if none is present.

[AutoNoLimit] Do not use the numPrecision property. Hides decimals if none is present..

[Fixed] Always show the number of decimals specified by numPrecision property.

Access functions:

numShow : bool

This property holds whether or not to show numbers.

Access functions:

svgFile : QString

This property holds the path to the svg file that styles the widget.

The path can be either to a resource or a file on disk.

Note: Resources can be overridden by files on disk with identical names.

Access functions:

svgUpdateAll : bool

This property holds whether to update all properties from svg or only the most important ones.

When this property is false, setting a new svg file will only affect number and tick colors, not properties like number of ticks, tick length and so on.

Access functions:

See also ticksMajor, ticksMajorLength, and ticksColor.

textPrefix : QString

This property holds the main text for the meter.

Access functions:

textSuffix : QString

This property holds the unit text for the meter.

Access functions:

ticksColor : QColor

This property holds the color for the ticks.

Access functions:

ticksMajor : int

This property holds how many major ticks you want.

Access functions:

ticksMajorLength : int

This property holds the length of the major ticks.

Access functions:

ticksMajorWidth : int

This property holds the width of the major ticks.

Access functions:

ticksMinor : int

This property holds how many minor ticks you want.

Access functions:

ticksMinorLength : int

This property holds the length of the minor ticks.

Access functions:

ticksMinorWidth : int

This property holds the width of the minor ticks.

Access functions:

ticksOffset : double

This property holds the offset between each tick.

Access functions:

ticksShow : bool

This property holds whether to show or hide the ticks.

Access functions:

unitCircle : bool

This property holds whether the meter is supposed to cover a full circle.

Set this property to make values like 355 equal -5 (if the range crosses zero).

Access functions:

unitCircleShowMin : bool

This property holds whether or not to show min value in a full circle where min and max is the same point.

Access functions:

value : double

This property holds the default value of the meter.

Access functions:

valueMaxError : double

This property holds the max value of the error indicator.

Access functions:

valueMaxNormal : double

This property holds the max value of the normal indicator.

Access functions:

valueMaxWarning : double

This property holds the max value of the warning indicator.

Access functions:

valueMaxWarningHigh : double

This property holds the max value of the warning high indicator.

Access functions:

valueMinError : double

This property holds the min value of the error indicator.

Access functions:

valueMinNormal : double

This property holds the min value of the normal indicator.

Access functions:

valueMinWarning : double

This property holds the min value of the warning indicator.

Access functions:

valueMinWarningHigh : double

This property holds the min value of the warning high indicator.

Access functions: