Handles the different ending decorations for line-like items. More...

#include <qcustomplot.h>

Public Types
enum	EndingStyle { esNone , esFlatArrow , esSpikeArrow , esLineArrow , esDisc , esSquare , esDiamond , esBar , esHalfBar , esSkewedBar , esNone , esFlatArrow , esSpikeArrow , esLineArrow , esDisc , esSquare , esDiamond , esBar , esHalfBar , esSkewedBar }

enum	EndingStyle { esNone , esFlatArrow , esSpikeArrow , esLineArrow , esDisc , esSquare , esDiamond , esBar , esHalfBar , esSkewedBar , esNone , esFlatArrow , esSpikeArrow , esLineArrow , esDisc , esSquare , esDiamond , esBar , esHalfBar , esSkewedBar }

Public Member Functions
	QCPLineEnding ()

	QCPLineEnding (EndingStyle style, double width=8, double length=10, bool inverted=false)

EndingStyle	style () const

double	width () const

double	length () const

bool	inverted () const

void	setStyle (EndingStyle style)

void	setWidth (double width)

void	setLength (double length)

void	setInverted (bool inverted)

double	boundingDistance () const

double	realLength () const

void	draw (QCPPainter *painter, const QCPVector2D &pos, const QCPVector2D &dir) const

void	draw (QCPPainter *painter, const QCPVector2D &pos, double angle) const

	QCPLineEnding ()

	QCPLineEnding (EndingStyle style, double width=8, double length=10, bool inverted=false)

EndingStyle	style () const

double	width () const

double	length () const

bool	inverted () const

void	setStyle (EndingStyle style)

void	setWidth (double width)

void	setLength (double length)

void	setInverted (bool inverted)

double	boundingDistance () const

double	realLength () const

void	draw (QCPPainter *painter, const QVector2D &pos, const QVector2D &dir) const

void	draw (QCPPainter *painter, const QVector2D &pos, double angle) const

Protected Attributes
EndingStyle	mStyle

double	mWidth

double	mLength

bool	mInverted

Detailed Description

Handles the different ending decorations for line-like items.

The various ending styles currently supported

For every ending a line-like item has, an instance of this class exists. For example, QCPItemLine has two endings which can be set with QCPItemLine::setHead and QCPItemLine::setTail.

The styles themselves are defined via the enum QCPLineEnding::EndingStyle. Most decorations can be modified regarding width and length, see setWidth and setLength. The direction of the ending decoration (e.g. direction an arrow is pointing) is controlled by the line-like item. For example, when both endings of a QCPItemLine are set to be arrows, they will point to opposite directions, e.g. "outward". This can be changed by setInverted, which would make the respective arrow point inward.

Note that due to the overloaded QCPLineEnding constructor, you may directly specify a QCPLineEnding::EndingStyle where actually a QCPLineEnding is expected, e.g.

qcplineending-sethead

Definition at line 1738 of file qcustomplot.h.

Member Enumeration Documentation

◆ EndingStyle [1/2]

enum QCPLineEnding::EndingStyle

Defines the type of ending decoration for line-like items, e.g. an arrow.

The width and length of these decorations can be controlled with the functions setWidth and setLength. Some decorations like esDisc, esSquare, esDiamond and esBar only support a width, the length property is ignored.

See also: QCPItemLine::setHead, QCPItemLine::setTail, QCPItemCurve::setHead, QCPItemCurve::setTail, QCPAxis::setLowerEnding, QCPAxis::setUpperEnding

Enumerator
esNone	No ending decoration.
esFlatArrow	A filled arrow head with a straight/flat back (a triangle)
esSpikeArrow	A filled arrow head with an indented back.
esLineArrow	A non-filled arrow head with open back.
esDisc	A filled circle.
esSquare	A filled square.
esDiamond	A filled diamond (45 degrees rotated square) A filled diamond (45° rotated square)
esBar	A bar perpendicular to the line.
esHalfBar	A bar perpendicular to the line, pointing out to only one side (to which side can be changed with setInverted)
esSkewedBar	A bar that is skewed (skew controllable via setLength)
esNone	No ending decoration.
esFlatArrow	A filled arrow head with a straight/flat back (a triangle)
esSpikeArrow	A filled arrow head with an indented back.
esLineArrow	A non-filled arrow head with open back.
esDisc	A filled circle.
esSquare	A filled square.
esDiamond	A filled diamond (45 degrees rotated square) A filled diamond (45° rotated square)
esBar	A bar perpendicular to the line.
esHalfBar	A bar perpendicular to the line, pointing out to only one side (to which side can be changed with setInverted)
esSkewedBar	A bar that is skewed (skew controllable via setLength)

Definition at line 1754 of file qcustomplot.h.

◆ EndingStyle [2/2]

enum QCPLineEnding::EndingStyle

Defines the type of ending decoration for line-like items, e.g. an arrow.

The width and length of these decorations can be controlled with the functions setWidth and setLength. Some decorations like esDisc, esSquare, esDiamond and esBar only support a width, the length property is ignored.

See also: QCPItemLine::setHead, QCPItemLine::setTail, QCPItemCurve::setHead, QCPItemCurve::setTail, QCPAxis::setLowerEnding, QCPAxis::setUpperEnding

Enumerator
esNone	No ending decoration.
esFlatArrow	A filled arrow head with a straight/flat back (a triangle)
esSpikeArrow	A filled arrow head with an indented back.
esLineArrow	A non-filled arrow head with open back.
esDisc	A filled circle.
esSquare	A filled square.
esDiamond	A filled diamond (45 degrees rotated square) A filled diamond (45° rotated square)
esBar	A bar perpendicular to the line.
esHalfBar	A bar perpendicular to the line, pointing out to only one side (to which side can be changed with setInverted)
esSkewedBar	A bar that is skewed (skew controllable via setLength)
esNone	No ending decoration.
esFlatArrow	A filled arrow head with a straight/flat back (a triangle)
esSpikeArrow	A filled arrow head with an indented back.
esLineArrow	A non-filled arrow head with open back.
esDisc	A filled circle.
esSquare	A filled square.
esDiamond	A filled diamond (45 degrees rotated square) A filled diamond (45° rotated square)
esBar	A bar perpendicular to the line.
esHalfBar	A bar perpendicular to the line, pointing out to only one side (to which side can be changed with setInverted)
esSkewedBar	A bar that is skewed (skew controllable via setLength)

Definition at line 1089 of file qcustomplot.h.

Constructor & Destructor Documentation

◆ QCPLineEnding() [1/4]

QCPLineEnding::QCPLineEnding ( )

Creates a QCPLineEnding instance with default values (style esNone).

Definition at line 5114 of file qcustomplot.cpp.

◆ QCPLineEnding() [2/4]

QCPLineEnding::QCPLineEnding	(	QCPLineEnding::EndingStyle	style,
		double	width = `8`,
		double	length = `10`,
		bool	inverted = `false`
	)

Creates a QCPLineEnding instance with the specified values.

Definition at line 5120 of file qcustomplot.cpp.

◆ QCPLineEnding() [3/4]

QCPLineEnding::QCPLineEnding ( )

◆ QCPLineEnding() [4/4]

QCPLineEnding::QCPLineEnding	(	EndingStyle	style,
		double	width = `8`,
		double	length = `10`,
		bool	inverted = `false`
	)

Member Function Documentation

◆ boundingDistance() [1/2]

double QCPLineEnding::boundingDistance ( ) const

Definition at line 5171 of file qcustomplot.cpp.

References esBar, esDiamond, esDisc, esFlatArrow, esHalfBar, esLineArrow, esNone, esSkewedBar, esSpikeArrow, esSquare, mLength, mStyle, and mWidth.

Referenced by QCPItemLine::draw().

◆ boundingDistance() [2/2]

double QCPLineEnding::boundingDistance ( ) const

◆ draw() [1/4]

void QCPLineEnding::draw	(	QCPPainter *	painter,
		const QCPVector2D &	pos,
		const QCPVector2D &	dir
	)		const

Definition at line 5235 of file qcustomplot.cpp.

References QCPPainter::drawLine(), esBar, esDiamond, esDisc, esFlatArrow, esHalfBar, esLineArrow, esNone, esSkewedBar, esSpikeArrow, esSquare, QCPVector2D::isNull(), mInverted, mLength, QCPPainter::modes(), mStyle, mWidth, QCPVector2D::normalized(), QCPVector2D::perpendicular(), QCPPainter::pmNonCosmetic, points, QCPPainter::setPen(), and QCPVector2D::toPointF().

Referenced by QCPItemLine::draw(), QCPItemCurve::draw(), and draw().

◆ draw() [2/4]

void QCPLineEnding::draw	(	QCPPainter *	painter,
		const QCPVector2D &	pos,
		double	angle
	)		const

Definition at line 5366 of file qcustomplot.cpp.

References draw().

◆ draw() [3/4]

void QCPLineEnding::draw	(	QCPPainter *	painter,
		const QVector2D &	pos,
		const QVector2D &	dir
	)		const

Definition at line 3496 of file qcustomplot.cpp.

References QCPPainter::drawLine(), esBar, esDiamond, esDisc, esFlatArrow, esHalfBar, esLineArrow, esNone, esSkewedBar, esSpikeArrow, esSquare, float, mInverted, mLength, QCPPainter::modes(), mStyle, mWidth, QCPPainter::pmNonCosmetic, points, and QCPPainter::setPen().

◆ draw() [4/4]

void QCPLineEnding::draw	(	QCPPainter *	painter,
		const QVector2D &	pos,
		double	angle
	)		const

Definition at line 3628 of file qcustomplot.cpp.

References draw().

◆ inverted() [1/2]

bool QCPLineEnding::inverted ( ) const

inline

Definition at line 1791 of file qcustomplot.h.

Referenced by setInverted().

◆ inverted() [2/2]

bool QCPLineEnding::inverted ( ) const

inline

Definition at line 1125 of file qcustomplot.h.

◆ length() [1/2]

double QCPLineEnding::length ( ) const

inline

Definition at line 1790 of file qcustomplot.h.

Referenced by setLength().

◆ length() [2/2]

double QCPLineEnding::length ( ) const

inline

Definition at line 1124 of file qcustomplot.h.

◆ realLength() [1/2]

double QCPLineEnding::realLength ( ) const

Starting from the origin of this line ending (which is style specific), returns the length covered by the line ending symbol, in backward direction.

For example, the esSpikeArrow has a shorter real length than a esFlatArrow, even if both have the same setLength value, because the spike arrow has an inward curved back, which reduces the length along its center axis (the drawing origin for arrows is at the tip).

This function is used for precise, style specific placement of line endings, for example in QCPAxes.

Definition at line 5207 of file qcustomplot.cpp.

References esBar, esDiamond, esDisc, esFlatArrow, esHalfBar, esLineArrow, esNone, esSkewedBar, esSpikeArrow, esSquare, mLength, mStyle, and mWidth.

◆ realLength() [2/2]

double QCPLineEnding::realLength ( ) const

◆ setInverted() [1/2]

void QCPLineEnding::setInverted ( bool inverted )

Sets whether the ending decoration shall be inverted. For example, an arrow decoration will point inward when inverted is set to true.

Note that also the width direction is inverted. For symmetrical ending styles like arrows or discs, this doesn't make a difference. However, asymmetric styles like esHalfBar are affected by it, which can be used to control to which side the half bar points to.

Definition at line 5159 of file qcustomplot.cpp.

References inverted(), and mInverted.

◆ setInverted() [2/2]

void QCPLineEnding::setInverted ( bool inverted )

◆ setLength() [1/2]

void QCPLineEnding::setLength ( double length )

Sets the length of the ending decoration, if the style supports it. On arrows, for example, the length defines the size in pointing direction.

See also: setWidth

Definition at line 5148 of file qcustomplot.cpp.

References length(), and mLength.

◆ setLength() [2/2]

void QCPLineEnding::setLength ( double length )

◆ setStyle() [1/2]

void QCPLineEnding::setStyle ( QCPLineEnding::EndingStyle style )

Sets the style of the ending decoration.

Definition at line 5129 of file qcustomplot.cpp.

References mStyle, and style().

◆ setStyle() [2/2]

void QCPLineEnding::setStyle ( EndingStyle style )

◆ setWidth() [1/2]

void QCPLineEnding::setWidth ( double width )

Sets the width of the ending decoration, if the style supports it. On arrows, for example, the width defines the size perpendicular to the arrow's pointing direction.

See also: setLength

Definition at line 5140 of file qcustomplot.cpp.

References mWidth, and width().

◆ setWidth() [2/2]

void QCPLineEnding::setWidth ( double width )

◆ style() [1/2]

EndingStyle QCPLineEnding::style ( ) const

inline

Definition at line 1788 of file qcustomplot.h.

Referenced by QCPItemLine::draw(), QCPItemCurve::draw(), and setStyle().

◆ style() [2/2]

EndingStyle QCPLineEnding::style ( ) const

inline

Definition at line 1122 of file qcustomplot.h.

◆ width() [1/2]

double QCPLineEnding::width ( ) const

inline

Definition at line 1789 of file qcustomplot.h.

Referenced by setWidth().

◆ width() [2/2]

double QCPLineEnding::width ( ) const

inline

Definition at line 1123 of file qcustomplot.h.

Member Data Documentation

◆ mInverted

bool QCPLineEnding::mInverted

protected

Definition at line 1811 of file qcustomplot.h.

Referenced by draw(), and setInverted().

◆ mLength

double QCPLineEnding::mLength

protected

Definition at line 1810 of file qcustomplot.h.

Referenced by boundingDistance(), draw(), realLength(), and setLength().

◆ mStyle

EndingStyle QCPLineEnding::mStyle

protected

Definition at line 1809 of file qcustomplot.h.

Referenced by boundingDistance(), draw(), realLength(), and setStyle().

◆ mWidth

double QCPLineEnding::mWidth

protected

Definition at line 1810 of file qcustomplot.h.

Referenced by boundingDistance(), draw(), realLength(), and setWidth().

The documentation for this class was generated from the following files:

/root/ACloudViewer/app/extern/QCustomPlot/qcustomplot.h
/root/ACloudViewer/app/extern/QCustomPlot/qcustomplot.cpp

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ EndingStyle [1/2]

◆ EndingStyle [2/2]

Constructor & Destructor Documentation

◆ QCPLineEnding() [1/4]

◆ QCPLineEnding() [2/4]

◆ QCPLineEnding() [3/4]

◆ QCPLineEnding() [4/4]

Member Function Documentation

◆ boundingDistance() [1/2]

◆ boundingDistance() [2/2]

◆ draw() [1/4]

◆ draw() [2/4]

◆ draw() [3/4]

◆ draw() [4/4]

◆ inverted() [1/2]

◆ inverted() [2/2]

◆ length() [1/2]

◆ length() [2/2]

◆ realLength() [1/2]

◆ realLength() [2/2]

◆ setInverted() [1/2]

◆ setInverted() [2/2]

◆ setLength() [1/2]

◆ setLength() [2/2]

◆ setStyle() [1/2]

◆ setStyle() [2/2]

◆ setWidth() [1/2]

◆ setWidth() [2/2]

◆ style() [1/2]

◆ style() [2/2]

◆ width() [1/2]

◆ width() [2/2]

Member Data Documentation

◆ mInverted

◆ mLength

◆ mStyle

◆ mWidth