Qwt User's Guide  6.2.0
QwtRoundScaleDraw Class Reference

A class for drawing round scales. More...

#include <qwt_round_scale_draw.h>

Inheritance diagram for QwtRoundScaleDraw:

Public Member Functions

 QwtRoundScaleDraw ()
 Constructor. More...
 
virtual ~QwtRoundScaleDraw ()
 Destructor.
 
void setRadius (double radius)
 
double radius () const
 
void moveCenter (double x, double y)
 Move the center of the scale draw, leaving the radius unchanged.
 
void moveCenter (const QPointF &)
 
QPointF center () const
 Get the center of the scale.
 
void setAngleRange (double angle1, double angle2)
 Adjust the baseline circle segment for round scales. More...
 
virtual double extent (const QFont &) const override
 
- Public Member Functions inherited from QwtAbstractScaleDraw
 QwtAbstractScaleDraw ()
 Constructor. More...
 
virtual ~QwtAbstractScaleDraw ()
 Destructor.
 
void setScaleDiv (const QwtScaleDiv &)
 
const QwtScaleDivscaleDiv () const
 
void setTransformation (QwtTransform *)
 
const QwtScaleMapscaleMap () const
 
QwtScaleMapscaleMap ()
 
void enableComponent (ScaleComponent, bool enable=true)
 
bool hasComponent (ScaleComponent) const
 
void setTickLength (QwtScaleDiv::TickType, double length)
 
double tickLength (QwtScaleDiv::TickType) const
 
double maxTickLength () const
 
void setSpacing (double)
 Set the spacing between tick and labels. More...
 
double spacing () const
 Get the spacing. More...
 
void setPenWidthF (qreal width)
 Specify the width of the scale pen. More...
 
qreal penWidthF () const
 
virtual void draw (QPainter *, const QPalette &) const
 Draw the scale. More...
 
virtual QwtText label (double) const
 Convert a value into its representing label. More...
 
void setMinimumExtent (double)
 Set a minimum for the extent. More...
 
double minimumExtent () const
 
void invalidateCache ()
 

Protected Member Functions

virtual void drawTick (QPainter *, double value, double len) const override
 
virtual void drawBackbone (QPainter *) const override
 
virtual void drawLabel (QPainter *, double value) const override
 
- Protected Member Functions inherited from QwtAbstractScaleDraw
const QwtTexttickLabel (const QFont &, double value) const
 Convert a value into its representing label and cache it. More...
 

Additional Inherited Members

- Public Types inherited from QwtAbstractScaleDraw
enum  ScaleComponent { Backbone = 0x01 , Ticks = 0x02 , Labels = 0x04 }
 
typedef QFlags< ScaleComponentScaleComponents
 

Detailed Description

A class for drawing round scales.

QwtRoundScaleDraw can be used to draw round scales. The circle segment can be adjusted by setAngleRange(). The geometry of the scale can be specified with moveCenter() and setRadius().

After a scale division has been specified as a QwtScaleDiv object using QwtAbstractScaleDraw::setScaleDiv(const QwtScaleDiv &s), the scale can be drawn with the QwtAbstractScaleDraw::draw() member.

Definition at line 31 of file qwt_round_scale_draw.h.

Constructor & Destructor Documentation

◆ QwtRoundScaleDraw()

QwtRoundScaleDraw::QwtRoundScaleDraw ( )

Constructor.

The range of the scale is initialized to [0, 100], The center is set to (50, 50) with a radius of 50. The angle range is set to [-135, 135].

Definition at line 44 of file qwt_round_scale_draw.cpp.

Member Function Documentation

◆ drawBackbone()

void QwtRoundScaleDraw::drawBackbone ( QPainter *  painter) const
overrideprotectedvirtual

Draws the baseline of the scale

Parameters
painterPainter
See also
drawTick(), drawLabel()

Implements QwtAbstractScaleDraw.

Definition at line 224 of file qwt_round_scale_draw.cpp.

◆ drawLabel()

void QwtRoundScaleDraw::drawLabel ( QPainter *  painter,
double  value 
) const
overrideprotectedvirtual

Draws the label for a major scale tick

Parameters
painterPainter
valueValue
See also
drawTick(), drawBackbone()

Implements QwtAbstractScaleDraw.

Definition at line 145 of file qwt_round_scale_draw.cpp.

◆ drawTick()

void QwtRoundScaleDraw::drawTick ( QPainter *  painter,
double  value,
double  len 
) const
overrideprotectedvirtual

Draw a tick

Parameters
painterPainter
valueValue of the tick
lenLength of the tick
See also
drawBackbone(), drawLabel()

Implements QwtAbstractScaleDraw.

Definition at line 190 of file qwt_round_scale_draw.cpp.

◆ extent()

double QwtRoundScaleDraw::extent ( const QFont &  font) const
overridevirtual

Calculate the extent of the scale

The extent is the distance between the baseline to the outermost pixel of the scale draw. radius() + extent() is an upper limit for the radius of the bounding circle.

Parameters
fontFont used for painting the labels
Returns
Calculated extent
See also
setMinimumExtent(), minimumExtent()
Warning
The implemented algorithm is not too smart and calculates only an upper limit, that might be a few pixels too large

Implements QwtAbstractScaleDraw.

Definition at line 255 of file qwt_round_scale_draw.cpp.

◆ moveCenter()

void QwtRoundScaleDraw::moveCenter ( const QPointF &  center)

Move the center of the scale draw, leaving the radius unchanged

Parameters
centerNew center
See also
setRadius()

Definition at line 90 of file qwt_round_scale_draw.cpp.

◆ radius()

double QwtRoundScaleDraw::radius ( ) const

Get the radius

Radius is the radius of the backbone without ticks and labels.

Returns
Radius of the scale
See also
setRadius(), extent()

Definition at line 79 of file qwt_round_scale_draw.cpp.

◆ setAngleRange()

void QwtRoundScaleDraw::setAngleRange ( double  angle1,
double  angle2 
)

Adjust the baseline circle segment for round scales.

The baseline will be drawn from min(angle1,angle2) to max(angle1, angle2). The default setting is [ -135, 135 ]. An angle of 0 degrees corresponds to the 12 o'clock position, and positive angles count in a clockwise direction.

Parameters
angle1
angle2boundaries of the angle interval in degrees.
Warning
  • The angle range is limited to [-360, 360] degrees. Angles exceeding this range will be clipped.
  • For angles more or equal than 360 degrees above or below min(angle1, angle2), scale marks will not be drawn.
  • If you need a counterclockwise scale, use QwtScaleDiv::setInterval()

Definition at line 118 of file qwt_round_scale_draw.cpp.

◆ setRadius()

void QwtRoundScaleDraw::setRadius ( double  radius)

Change of radius the scale

Radius is the radius of the backbone without ticks and labels.

Parameters
radiusNew Radius
See also
moveCenter()

Definition at line 66 of file qwt_round_scale_draw.cpp.