• Skip to main content
  • Skip to header right navigation
  • Skip to site footer
CDP Studio logo

CDP Studio

The no-code and full-code software development tool for distributed control systems and HMI

  • Doc
  • Why CDP
    • Software developers
    • Automation engineers
    • Managers
  • Products
    • Automation Designer
    • HMI Designer
    • Maritime HMIs
  • Services
  • Use cases
  • Pricing
  • Try CDP

CDP Studio Documentation

  • GUI - CDP Widgets
  • CDPBaseMeter3N

CDPBaseMeter3N Class

The Meter 3 Needles widget has three needles in one meter. It can either be used to show values on the same scale or you can separate the needles and have three different scales. More...

Header: #include <CDPBaseMeter3N>
Inherits: CDPBaseMeter2N
Inherited By:

CDPBaseMeter4N

  • List of all members, including inherited members

Properties

  • ErrorColor3 : QColor
  • NormalColor3 : QColor
  • WarningColor3 : QColor
  • WarningHighColor3 : QColor
  • alarmSectorLimit3 : bool
  • alarmShow3 : bool
  • cdpRouting3 : QString
  • cdpScaling3 : double
  • fill3 : bool
  • fillColor3 : QColor
  • fillOffset3 : double
  • fillStartValue3 : double
  • fillWidth3 : double
  • maxValue3 : double
  • minValue3 : double
  • needle3 : bool
  • numFont3 : QFont
  • numOffset3 : int
  • numPostfix3 : QString
  • numPrecision3 : int
  • numPrecisionMethod3 : CDPBaseTickMarks::NumPrecision
  • numShow3 : bool
  • ticksColor3 : QColor
  • ticksMajor3 : int
  • ticksMajorLength3 : int
  • ticksMajorWidth3 : int
  • ticksMinor3 : int
  • ticksMinorLength3 : int
  • ticksMinorWidth3 : int
  • ticksOffset3 : double
  • ticksShow3 : bool
  • unitCircle3 : bool
  • unitCircleShowMin3 : bool
  • value3 : double
  • valueMaxError3 : double
  • valueMaxNormal3 : double
  • valueMaxWarning3 : double
  • valueMaxWarningHigh3 : double
  • valueMinError3 : double
  • valueMinNormal3 : double
  • valueMinWarning3 : double
  • valueMinWarningHigh3 : double
  • 43 properties inherited from CDPBaseMeter2N
  • 52 properties inherited from CDPBaseMeter
  • 6 properties inherited from CDPBaseWidget

Public Functions

CDPBaseMeter3N(QWidget *parent = 0, bool bSetMeterType = false)
bool alarmSectorLimit3()
QColor errorColor3()
QColor fillColor3()
bool fillEnabled3()
double fillOffset3()
double fillStartValue3()
double fillWidth3()
CDPBaseTickMarks::NumPrecision getPrecisionMethod3()
int majorTicks3()
int majorTickLength3()
int majorTickWidth3()
double maxValue3()
double minValue3()
int minorTicks3()
int minorTickLength3()
int minorTickWidth3()
virtual bool needleEnabled3()
QColor normalColor3()
QFont numFont3()
int numOffset3()
QString numPostfix3()
bool numShow3()
int precision3()
QString routing3()
double scalingFactor3()
void setAlarmSectorLimit3(bool enable)
void setErrorColor3(QColor value)
void setFillColor3(const QColor &color)
void setFillEnabled3(bool enable)
void setFillOffset3(double offset)
void setFillStartValue3(double value)
void setFillWidth3(double width)
void setMajorTicks3(int value)
void setMajorTickLength3(int value)
void setMajorTickWidth3(int value)
void setMinorTicks3(int value)
void setMinorTickLength3(int value)
void setMinorTickWidth3(int value)
virtual void setNeedleEnabled3(bool enabled)
void setNormalColor3(QColor value)
void setNumFont3(QFont value)
void setNumOffset3(int value)
void setNumPostfix3(QString postfix)
void setNumShow3(bool show)
void setPrecision3(int value)
void setPrecisionMethod3(CDPBaseTickMarks::NumPrecision value)
void setRouting3(QString routing)
void setScalingFactor3(double value)
void setShowAlarms3(bool show)
void setShowTicks3(bool show)
void setTickColor3(QColor value)
void setTickOffset3(double value)
void setUnitCircle3(bool show)
void setUnitCircleShowMin3(bool show)
void setValue3(double value)
void setWarningColor3(QColor value)
void setWarningHighColor3(QColor value)
bool showAlarms3()
bool showTicks3()
QColor tickColor3()
double tickOffset3()
bool unitCircle3()
bool unitCircleShowMin3()
double value3()
double valueMaxError3()
double valueMaxNormal3()
double valueMaxWarning3()
double valueMaxWarningHigh3()
double valueMinError3()
double valueMinNormal3()
double valueMinWarning3()
double valueMinWarningHigh3()
QColor warningColor3()
QColor warningHighColor3()

Reimplemented Public Functions

virtual void setOfflineValue(double value) override
virtual void setOfflineValueEnabled(bool enabled) override
  • 77 public functions inherited from CDPBaseMeter2N
  • 90 public functions inherited from CDPBaseMeter
  • 8 public functions inherited from CDPBaseWidget
  • 17 public functions inherited from CDPBaseCom
  • 4 public functions inherited from CDPBaseControlVisible

Public Slots

void setAlarmSectorCenter3(double value)
void setAlarmSectorError3(double value)
void setAlarmSectorNormal3(double value)
void setAlarmSectorWarning3(double value)
void setAlarmSectorWarningHigh3(double value)
void setMaxValue3(double value)
void setMinValue3(double value)
void setValueMaxError3(double value)
void setValueMaxNormal3(double value)
void setValueMaxWarning3(double value)
void setValueMaxWarningHigh3(double value)
void setValueMinError3(double value)
void setValueMinNormal3(double value)
void setValueMinWarning3(double value)
void setValueMinWarningHigh3(double value)
void setValueNeedle3(double value)
  • 18 public slots inherited from CDPBaseMeter2N
  • 25 public slots inherited from CDPBaseMeter
  • 10 public slots inherited from CDPBaseWidget

Additional Inherited Members

  • 1 signal inherited from CDPBaseWidget
  • 2 static public members inherited from CDPBaseCom
  • 14 protected functions inherited from CDPBaseMeter
  • 4 protected functions inherited from CDPBaseCom
  • 1 protected function inherited from CDPBaseControlVisible

Detailed Description

The Meter 3 Needles widget has three needles in one meter. It can either be used to show values on the same scale or you can separate the needles and have three different scales.

The widget requires a 3rd layer in the svg file that specify the layout of the 3rd needle (MaxValue, MinValue, NeedleCenter and rotation).

The CDPBaseMeter3N widget inherits all the properties from the Meter2N widget, and gets a 3rd set of properties for the 3rd needle. The 3rd set of properties contains all the traits that pertain to the 3rd needle with it's own set of tick marks, alarms and scaling.

Styling by SVG

The svg structure of meters with multiple needles are similar to that of the base meter with only one needle. In addition to 'Layer1' we now add one layer for each needle we want in the meter. The layer for the second needle is named 'Layer2', the third needle is added in 'Layer3' and so on. Note that the cdpTextPrefix and cdpTextSuffix elements can only exist in one layer (can be added in several layers but only one will be used).

svg
  ├─── Layer1
  │     └─── ...
  └─── Layer2
        └─── ...

Property Documentation

ErrorColor3 : QColor

Access functions:

QColor errorColor3()
void setErrorColor3(QColor value)

NormalColor3 : QColor

Access functions:

QColor normalColor3()
void setNormalColor3(QColor value)

WarningColor3 : QColor

Access functions:

QColor warningColor3()
void setWarningColor3(QColor value)

WarningHighColor3 : QColor

Access functions:

QColor warningHighColor3()
void setWarningHighColor3(QColor value)

alarmSectorLimit3 : bool

Access functions:

bool alarmSectorLimit3()
void setAlarmSectorLimit3(bool enable)

alarmShow3 : bool

Access functions:

bool showAlarms3()
void setShowAlarms3(bool show)

cdpRouting3 : QString

Access functions:

QString routing3()
void setRouting3(QString routing)

cdpScaling3 : double

Access functions:

double scalingFactor3()
void setScalingFactor3(double value)

fill3 : bool

Access functions:

bool fillEnabled3()
void setFillEnabled3(bool enable)

fillColor3 : QColor

Access functions:

QColor fillColor3()
void setFillColor3(const QColor &color)

fillOffset3 : double

Access functions:

double fillOffset3()
void setFillOffset3(double offset)

fillStartValue3 : double

Access functions:

double fillStartValue3()
void setFillStartValue3(double value)

fillWidth3 : double

Access functions:

double fillWidth3()
void setFillWidth3(double width)

maxValue3 : double

Access functions:

double maxValue3()
void setMaxValue3(double value)

minValue3 : double

Access functions:

double minValue3()
void setMinValue3(double value)

needle3 : bool

Access functions:

virtual bool needleEnabled3()
virtual void setNeedleEnabled3(bool enabled)

numFont3 : QFont

Access functions:

QFont numFont3()
void setNumFont3(QFont value)

numOffset3 : int

Access functions:

int numOffset3()
void setNumOffset3(int value)

numPostfix3 : QString

Access functions:

QString numPostfix3()
void setNumPostfix3(QString postfix)

numPrecision3 : int

Access functions:

int precision3()
void setPrecision3(int value)

numPrecisionMethod3 : CDPBaseTickMarks::NumPrecision

Access functions:

CDPBaseTickMarks::NumPrecision getPrecisionMethod3()
void setPrecisionMethod3(CDPBaseTickMarks::NumPrecision value)

numShow3 : bool

Access functions:

bool numShow3()
void setNumShow3(bool show)

ticksColor3 : QColor

Access functions:

QColor tickColor3()
void setTickColor3(QColor value)

ticksMajor3 : int

Access functions:

int majorTicks3()
void setMajorTicks3(int value)

ticksMajorLength3 : int

Access functions:

int majorTickLength3()
void setMajorTickLength3(int value)

ticksMajorWidth3 : int

Access functions:

int majorTickWidth3()
void setMajorTickWidth3(int value)

ticksMinor3 : int

Access functions:

int minorTicks3()
void setMinorTicks3(int value)

ticksMinorLength3 : int

Access functions:

int minorTickLength3()
void setMinorTickLength3(int value)

ticksMinorWidth3 : int

Access functions:

int minorTickWidth3()
void setMinorTickWidth3(int value)

ticksOffset3 : double

Access functions:

double tickOffset3()
void setTickOffset3(double value)

ticksShow3 : bool

Access functions:

bool showTicks3()
void setShowTicks3(bool show)

unitCircle3 : bool

Access functions:

bool unitCircle3()
void setUnitCircle3(bool show)

unitCircleShowMin3 : bool

Access functions:

bool unitCircleShowMin3()
void setUnitCircleShowMin3(bool show)

value3 : double

Access functions:

double value3()
void setValue3(double value)

valueMaxError3 : double

Access functions:

double valueMaxError3()
void setValueMaxError3(double value)

valueMaxNormal3 : double

Access functions:

double valueMaxNormal3()
void setValueMaxNormal3(double value)

valueMaxWarning3 : double

Access functions:

double valueMaxWarning3()
void setValueMaxWarning3(double value)

valueMaxWarningHigh3 : double

Access functions:

double valueMaxWarningHigh3()
void setValueMaxWarningHigh3(double value)

valueMinError3 : double

Access functions:

double valueMinError3()
void setValueMinError3(double value)

valueMinNormal3 : double

Access functions:

double valueMinNormal3()
void setValueMinNormal3(double value)

valueMinWarning3 : double

Access functions:

double valueMinWarning3()
void setValueMinWarning3(double value)

valueMinWarningHigh3 : double

Access functions:

double valueMinWarningHigh3()
void setValueMinWarningHigh3(double value)

Member Function Documentation

CDPBaseMeter3N::CDPBaseMeter3N(QWidget *parent = 0, bool bSetMeterType = false)

Default constructs an instance of CDPBaseMeter3N.

[slot] void CDPBaseMeter3N::setAlarmSectorCenter3(double value)

[slot] void CDPBaseMeter3N::setAlarmSectorError3(double value)

[slot] void CDPBaseMeter3N::setAlarmSectorNormal3(double value)

[slot] void CDPBaseMeter3N::setAlarmSectorWarning3(double value)

[slot] void CDPBaseMeter3N::setAlarmSectorWarningHigh3(double value)

[override virtual] void CDPBaseMeter3N::setOfflineValue(double value)

[override virtual] void CDPBaseMeter3N::setOfflineValueEnabled(bool enabled)

[slot] void CDPBaseMeter3N::setValueNeedle3(double value)

The content of this document is confidential information not to be published without the consent of CDP Technologies AS.

CDP Technologies AS, www.cdpstudio.com

Get started with CDP Studio today

Let us help you take your great ideas and turn them into the products your customer will love.

Try CDP Studio for free
Why CDP Studio?

CDP Technologies AS
Hundsværgata 8,
P.O. Box 144
6001 Ålesund, Norway

Tel: +47 990 80 900
E-mail: info@cdptech.com

Company

About CDP

Contact us

Services

Partners

Blog

Developers

Get started

User manuals

Support

Document download

Release notes

My account

Follow CDP

  • LinkedIn
  • YouTube
  • GitHub

© Copyright 2025 CDP Technologies. Privacy and cookie policy.

Return to top