#include <ipeshape.h>

Public Types
enum	Type { EArc , ESegment , ESpline , EOldSpline , ECardinalSpline , ESpiroSpline }

Public Member Functions
Type	type () const

int	countCP () const

Vector	cp (int i) const

Vector	last () const

Matrix	matrix () const

float	tension () const

Arc	arc () const

void	beziers (std::vector< Bezier > &bez) const

void	draw (Painter &painter) const

void	addToBBox (Rect &box, const Matrix &m, bool cp) const

double	distance (const Vector &v, const Matrix &m, double bound) const

void	snapVtx (const Vector &mouse, const Matrix &m, Vector &pos, double &bound, bool cp) const

void	snapBnd (const Vector &mouse, const Matrix &m, Vector &pos, double &bound) const

Friends
class	Curve

Detailed Description

A segment on an SubPath.

A segment is either an elliptic arc, a straight segment, or a spline curve, depending on its type(). This is a lightweight object, created on the fly by Curve::segment(). There is no public constructor, so the only way to create such an object is through that method.

The type() is one of the following:

ESegment: the segment has two control points, and represents a line segment.
ESpline: a B-spline curve with n control points. The first and last control point's knot value is repeated three times, so the curve begins and ends in these points. A spline with 4 control points is a single Bezier curve with those control points. A spline with 3 control points is defined to be a quadratic Bezier curve with those control points.
ECardinalSpline: a cardinal spline curve with n control points. The curve passes through the control points in the given order. The tension is currently fixed at 0.5.
ESpiroSpline: a clothoid spline curve with n control points, computed using Raph Levien's spiro code (through libspiro).
EOldSpline: an incorrectly defined B-spline, used by Ipe for many years. Supported for compatibility.
EArc: an elliptic arc, with begin and end point. The supporting ellipse is defined by the matrix(), it is the image under the affine transformation matrix() of the unit circle. matrix() is such that its inverse transforms both start and end position to points (nearly) on the unit circle. The arc is the image of the positively (counter-clockwise) directed arc from the pre-image of the start position to the pre-image of the end position. Whether this is a positively or negatively oriented arc in user space depends on the matrix.

Member Enumeration Documentation

◆ Type

enum ipe::CurveSegment::Type

Enumerator
EArc
ESegment
ESpline
EOldSpline
ECardinalSpline
ESpiroSpline

Member Function Documentation

◆ type()

CurveSegment::Type ipe::CurveSegment::type ( ) const

inline

Type of segment.

Referenced by addToBBox(), arc(), beziers(), distance(), draw(), ipe::Shape::isSegment(), snapBnd(), snapVtx(), and tension().

◆ countCP()

int ipe::CurveSegment::countCP ( ) const

inline

Number of control points.

Referenced by addToBBox(), beziers(), and snapVtx().

◆ cp()

Vector ipe::CurveSegment::cp ( int i ) const

inline

Return control point.

Referenced by addToBBox(), arc(), beziers(), distance(), draw(), snapBnd(), and snapVtx().

◆ last()

Vector ipe::CurveSegment::last ( ) const

inline

Return last control point.

◆ matrix()

Matrix ipe::CurveSegment::matrix ( ) const

inline

Matrix (if Type() == EArc).

Referenced by addToBBox(), arc(), ipe::Path::draw(), and snapVtx().

◆ tension()

float CurveSegment::tension ( ) const

Tension (if Type() == ECardinalSpline)

Panics if segment is not a cardinal spline.

References ECardinalSpline, and type().

Referenced by beziers().

◆ arc()

Arc CurveSegment::arc ( ) const

Return segment as Arc.

Panics if segment is not an arc.

References cp(), EArc, matrix(), and type().

Referenced by addToBBox(), distance(), draw(), and snapBnd().

◆ beziers()

void CurveSegment::beziers ( std::vector< Bezier > & bez ) const

Convert spline curve to a sequence of Bezier splines.

References ipe::Bezier::cardinalSpline(), countCP(), cp(), ECardinalSpline, EOldSpline, ESpiroSpline, ESpline, ipe::Bezier::oldSpline(), ipe::Bezier::spline(), tension(), and type().

Referenced by addToBBox(), distance(), draw(), and snapBnd().

◆ draw()

void CurveSegment::draw ( Painter & painter ) const

Draw the segment.

Current position of the painter is already on first control point.

References arc(), beziers(), cp(), ipe::Painter::curveTo(), ipe::Painter::drawArc(), EArc, ECardinalSpline, EOldSpline, ESegment, ESpiroSpline, ESpline, ipe::Painter::lineTo(), and type().

Referenced by ipe::Curve::draw().

◆ addToBBox()

void CurveSegment::addToBBox	(	Rect &	box,
		const Matrix &	m,
		bool	cpf
	)		const

Add segment to bounding box.

Does not assume that first control point has already been added.

If cpf is true, then control points of splines, Bezier curves, and the center of arcs are included in the bbox (so that snapping can find them). Otherwise, a tight bounding box for the geometric object itself is computed.

References ipe::Rect::addPoint(), ipe::Rect::addRect(), arc(), beziers(), countCP(), cp(), EArc, ECardinalSpline, EOldSpline, ESegment, ESpiroSpline, ESpline, matrix(), and type().