QCAD
Open Source 2D CAD
RPolyline Class Reference

Low-level mathematical representation of an open polyline or closed polyline (= polygon). More...

#include <RPolyline.h>

Inheritance diagram for RPolyline:
RShape RExplodable RLeaderData RPolylineData RSolidData RFaceData RTraceData

Public Member Functions

bool appendShape (const RShape &shape, bool prepend=false)
 
bool appendShapeAuto (const RShape &shape)
 Appends the given shape to this polyline. More...
 
void appendVertex (const RVector &vertex, double bulge=0.0, double w1=0.0, double w2=0.0)
 
void appendVertex (double x, double y, double bulge=0.0, double w1=0.0, double w2=0.0)
 
bool autoClose (double tolerance=RS::PointTolerance)
 
void clear ()
 
virtual RPolylineclone () const
 
bool contains (const RVector &point, bool borderIsInside=false, double tolerance=RS::PointTolerance) const
 Checks if the given point is inside this closed polygon. More...
 
bool containsShape (const RShape &shape) const
 Checks if the given shape is completely inside this closed polygon. More...
 
RPolyline convertArcToLineSegments (int segments) const
 
RPolyline convertArcToLineSegmentsLength (double segmentLength) const
 
bool convertToClosed ()
 
bool convertToOpen ()
 
int countSegments () const
 
int countVertices () const
 
virtual double getAngleAt (double distance, RS::From from=RS::FromStart) const
 
double getArea () const
 
double getBaseAngle () const
 
virtual QList< bool > getBoolProperties () const
 
virtual RBox getBoundingBox () const
 
double getBulgeAt (int i) const
 
QList< double > getBulges () const
 
virtual QList< RVectorgetCenterPoints () const
 
int getClosestSegment (const RVector &point) const
 
int getClosestVertex (const RVector &point) const
 
QList< RVectorgetConcaveVertices () const
 
QList< RVectorgetConvexVertices (bool convex=true) const
 
virtual double getDirection1 () const
 
virtual double getDirection2 () const
 
virtual double getDistanceFromStart (const RVector &p) const
 
virtual QList< double > getDistancesFromStart (const RVector &p) const
 
virtual double getDistanceTo (const RVector &point, bool limited=true, double strictRange=RMAXDOUBLE) const
 
virtual QList< double > getDoubleProperties () const
 
virtual RVector getEndPoint () const
 
virtual QList< RVectorgetEndPoints () const
 
double getEndWidthAt (int i) const
 
QList< double > getEndWidths () const
 
virtual QList< QSharedPointer< RShape > > getExploded (int segments=RDEFAULT_MIN1) const
 
QSharedPointer< RShapegetFirstSegment () const
 
double getHeight () const
 
QSharedPointer< RShapegetLastSegment () const
 
RVector getLastVertex () const
 
QList< QPair< RPolyline, RPolyline > > getLeftRightOutline () const
 
virtual double getLength () const
 
double getLengthTo (const RVector &p, bool limited=true) const
 
virtual RVector getMiddlePoint () const
 
virtual QList< RVectorgetMiddlePoints () const
 
RS::Orientation getOrientation (bool implicitelyClosed=false) const
 
QList< RPolylinegetOutline () const
 
virtual RVector getPointAtPercent (double p) const
 
virtual QList< RVectorgetPointCloud (double segmentLength) const
 
RVector getPointInside () const
 
virtual QList< RVectorgetPointsWithDistanceToEnd (double distance, int from=RS::FromAny) const
 
RPolyline getPolygonHull (double angle, double tolerance, bool inner=false) const
 
virtual RPolyline getReversed () const
 
QSharedPointer< RShapegetSegmentAt (int i) const
 
int getSegmentAtDist (double dist)
 
double getSegmentsLength (int fromIndex, int toIndex) const
 
QList< RVectorgetSelfIntersectionPoints () const
 
virtual RShape::Type getShapeType () const
 
virtual RS::Side getSideOfPoint (const RVector &point) const
 
virtual RVector getStartPoint () const
 
double getStartWidthAt (int i) const
 
QList< double > getStartWidths () const
 
virtual QSharedPointer< RShapegetTransformed (const QTransform &transform) const
 
virtual RS::Ending getTrimEnd (const RVector &trimPoint, const RVector &clickPoint)
 
virtual QList< RVectorgetVectorProperties () const
 
virtual RVector getVectorTo (const RVector &point, bool limited=true, double strictRange=RMAXDOUBLE) const
 
double getVertexAngle (int i, RS::Orientation orientation=RS::UnknownOrientation) const
 
QList< double > getVertexAngles () const
 
RVector getVertexAt (int i) const
 
int getVertexIndex (const RVector &v, double tolerance=RS::PointTolerance) const
 
QList< RVectorgetVertices () const
 
double getWidth () const
 
bool hasArcSegments () const
 
bool hasWidths () const
 
void insertVertex (int index, const RVector &vertex, double bulgeBefore=0.0, double bulgeAfter=0.0)
 
void insertVertexAt (const RVector &point)
 Inserts a vertex at the point on the polyline closest to the given position. More...
 
RVector insertVertexAtDistance (double dist)
 
bool isArcSegmentAt (int i) const
 
bool isClosed () const
 
bool isConcave () const
 
virtual bool isDirected () const
 
bool isEmpty () const
 
bool isFlat () const
 
bool isGeometricallyClosed (double tolerance=RS::PointTolerance) const
 
virtual bool isInterpolated () const
 Reimplement and return true if this shape relies on interpolation for geometrical operations such as finding intersection points. More...
 
virtual bool mirror (const RLine &axis)
 
RPolyline modifyPolylineCorner (const RShape &trimmedShape1, RS::Ending ending1, int segmentIndex1, const RShape &trimmedShape2, RS::Ending ending2, int segmentIndex2, const RShape *cornerShape=NULL) const
 Modifies (bevels, rounds, trims) the corner of this polyline between segmentIndex1 and segmentIndex2 at the given segment endings. More...
 
QList< RPolylinemorph (const RPolyline &target, int steps, RS::Easing easing=RS::Linear, bool zLinear=true, double customFactor=RNANDOUBLE) const
 
virtual bool move (const RVector &offset)
 
void moveEndPoint (const RVector &pos)
 
void moveSegmentAt (int i, const RVector &offset)
 
void moveStartPoint (const RVector &pos)
 
void moveVertexAt (int i, const RVector &offset)
 
void normalize (double tolerance=RS::PointTolerance)
 Removes duplicate vertices. More...
 
bool prependShape (const RShape &shape)
 
void prependVertex (const RVector &vertex, double bulge=0.0, double w1=0.0, double w2=0.0)
 
bool relocateStartPoint (const RVector &p)
 Relocates the start point of this closed polyline to the given point. More...
 
bool relocateStartPoint (double dist)
 
void removeFirstVertex ()
 
void removeLastVertex ()
 
void removeVertex (int index)
 
void removeVerticesAfter (int index)
 
void removeVerticesBefore (int index)
 
virtual bool reverse ()
 
virtual bool rotate (double rotation, const RVector &center=RDEFAULT_RVECTOR)
 
RPolyline roundAllCorners (double radius) const
 
 RPolyline ()
 Creates a polyline object without points. More...
 
 RPolyline (const QList< QSharedPointer< RShape > > &segments)
 Creates a polyline from segments (lines or arcs). More...
 
 RPolyline (const QList< RVector > &vertices, bool closed)
 Creates a polyline object with the given points. More...
 
virtual bool scale (const RVector &scaleFactors, const RVector &center=RDEFAULT_RVECTOR)
 
virtual bool scale (double scaleFactor, const RVector &center=RDEFAULT_RVECTOR)
 
void setBulgeAt (int i, double b)
 
void setBulges (const QList< double > &b)
 
void setClosed (bool on)
 Marks the poyline as logically (explicitly) closed. More...
 
void setEndWidthAt (int i, double w)
 
void setEndWidths (const QList< double > &ew)
 
void setGlobalWidth (double w)
 
bool setHeight (double v)
 
void setMinimumWidth (double w)
 
bool setOrientation (RS::Orientation orientation)
 
void setStartWidthAt (int i, double w)
 
void setStartWidths (const QList< double > &sw)
 
void setVertexAt (int i, const RVector &v)
 
void setVertices (const QList< RVector > &vertices)
 
bool setWidth (double v)
 
virtual void setZ (double z)
 
bool simplify (double tolerance=RS::PointTolerance)
 Simplify by attempting to skip nodes within given tolerance. More...
 
QList< RPolylinesplitAtDiscontinuities (double tolerance) const
 
QList< RPolylinesplitAtSegmentTypeChange () const
 Splits the polyline into polylines with exclusively line or arc segments. More...
 
virtual bool stretch (const RPolyline &area, const RVector &offset)
 
void stripWidths ()
 
bool toLogicallyClosed (double tolerance=RS::PointTolerance)
 Converts this geometrically closed polyline (start == end) to a locically closed polyline. More...
 
bool toLogicallyOpen ()
 Converts this logically closed polyline to a locically open, geometrically closed polyline. More...
 
RPainterPath toPainterPath (bool addOriginalShapes=false) const
 
virtual bool trimEndPoint (const RVector &trimPoint, const RVector &clickPoint=RVector::invalid, bool extend=false)
 
virtual bool trimEndPoint (double trimDist)
 
virtual bool trimStartPoint (const RVector &trimPoint, const RVector &clickPoint=RVector::invalid, bool extend=false)
 
virtual bool trimStartPoint (double trimDist)
 
QList< RVectorverifyTangency (double toleranceMin=RS::AngleTolerance, double toleranceMax=M_PI_4)
 Verifies the tangency of this polyline. More...
 
virtual ~RPolyline ()
 
- Public Member Functions inherited from RShape
void dump () const
 
virtual bool equals (const RShape &other, double tolerance=RS::PointTolerance) const
 
virtual QList< RVectorfilterOnShape (const QList< RVector > &pointList, bool limited=true, double tolerance=RDEFAULT_TOLERANCE_1E_MIN4) const
 
virtual bool flipHorizontal ()
 
virtual bool flipVertical ()
 
virtual double getAngleAtPercent (double p) const
 
virtual double getAngleAtPoint (const RVector &pos) const
 
virtual QList< RVectorgetArcReferencePoints () const
 
virtual RVector getClosestPointOnShape (const RVector &p, bool limited=true, double strictRange=RMAXDOUBLE) const
 
QList< RVectorgetIntersectionPoints (const RShape &other, bool limited=true, bool same=false, bool force=false) const
 
virtual QList< int > getIntProperties () const
 
virtual double getMaxDistanceTo (const QList< RVector > &points, bool limited=true, double strictRange=RMAXDOUBLE) const
 
virtual QList< QSharedPointer< RShape > > getOffsetShapes (double distance, int number, RS::Side side, const RVector &position=RVector::invalid)
 
virtual RVector getPointOnShape () const
 
virtual RVector getPointWithDistanceToEnd (double distance) const
 
virtual RVector getPointWithDistanceToStart (double distance) const
 
virtual RVector getVectorFromEndpointTo (const RVector &point) const
 
virtual bool intersectsWith (const RShape &other, bool limited=true) const
 
virtual bool isOnShape (const RVector &point, bool limited=true, double tolerance=RDEFAULT_TOLERANCE_1E_MIN4) const
 
 RShape ()
 
virtual QList< QSharedPointer< RShape > > splitAt (const QList< RVector > &points) const
 
virtual bool stretch (const RBox &area, const RVector &offset)
 
virtual void to2D ()
 Flattens this shape to the X/Y plane. More...
 
virtual ~RShape ()
 
- Public Member Functions inherited from RExplodable
virtual ~RExplodable ()
 

Static Public Member Functions

static RPolylineProxygetPolylineProxy ()
 
static bool hasProxy ()
 
static bool isStraight (double bulge)
 
static void setPolylineProxy (RPolylineProxy *p)
 
- Static Public Member Functions inherited from RShape
static const RExplodablecastToExplodable (const RShape *shape)
 
static QSharedPointer< RShapeellipseToArcCircleEllipse (const REllipse &ellipse)
 
static int getErrorCode ()
 
static QList< RVectorgetIntersectionPoints (const RShape &shape1, const RShape &shape2, bool limited=true, bool same=false, bool force=false)
 
static QList< RVectorgetIntersectionPointsAA (const RArc &arc1, const RArc &arc2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsAC (const RArc &arc1, const RCircle &circle2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsAE (const RArc &arc1, const REllipse &ellipse2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsAS (const RArc &arc1, const RSpline &spline2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsAT (const RArc &arc1, const RTriangle &triangle2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsAX (const RArc &arc1, const RExplodable &explodable2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsCC (const RCircle &circle1, const RCircle &circle2)
 
static QList< RVectorgetIntersectionPointsCE (const RCircle &circle1, const REllipse &ellipse2)
 
static QList< RVectorgetIntersectionPointsCS (const RCircle &circle1, const RSpline &spline2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsCX (const RCircle &circle1, const RExplodable &explodable2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsEE (const REllipse &ellipse1, const REllipse &ellipse2)
 Based on "Hughes and Chraibi (2011-2012), Calculating Ellipse Overlap Areas". More...
 
static QList< RVectorgetIntersectionPointsEE (const REllipse &ellipse1, const REllipse &ellipse2, bool limited)
 
static QList< RVectorgetIntersectionPointsES (const REllipse &ellipse1, const RSpline &spline2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsEX (const REllipse &ellipse1, const RExplodable &explodable2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsLA (const RLine &line1, const RArc &arc2, bool limited1, bool limited2)
 
static QList< RVectorgetIntersectionPointsLA (const RLine &line1, const RArc &arc2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsLC (const RLine &line1, const RCircle &circle2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsLE (const RLine &line1, const REllipse &ellipse2, bool limited1, bool limited2)
 
static QList< RVectorgetIntersectionPointsLE (const RLine &line1, const REllipse &ellipse2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsLL (const RLine &line1, const RLine &line2, bool limited1, bool limited2)
 
static QList< RVectorgetIntersectionPointsLL (const RLine &line1, const RLine &line2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsLS (const RLine &line1, const RSpline &spline2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsLT (const RLine &line1, const RTriangle &triangle2, bool limited1, bool limited2)
 
static QList< RVectorgetIntersectionPointsLT (const RLine &line1, const RTriangle &triangle2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsLX (const RLine &line1, const RExplodable &explodable2, bool limited=true)
 
static QList< RVectorgetIntersectionPointsSS (const RSpline &spline1, const RSpline &spline2, bool limited=true, bool same=false)
 
static QList< RVectorgetIntersectionPointsSX (const RSpline &spline1, const RExplodable &explodable2, bool limited)
 
static QList< RVectorgetIntersectionPointsXX (const RExplodable &explodable1, const RExplodable &explodable2, bool limited=true, bool same=false)
 
static QList< QSharedPointer< RShape > > getOffsetArcs (const RShape &shape, double distance, int number, RS::Side side, const RVector &position=RVector::invalid)
 
static QList< QSharedPointer< RShape > > getOffsetLines (const RShape &shape, double distance, int number, RS::Side side, const RVector &position=RVector::invalid)
 
static QList< QSharedPointer< RShape > > getReversedShapeList (const QList< QSharedPointer< RShape > > &shapes)
 
static RShapeProxygetShapeProxy ()
 
static bool hasProxy ()
 
static bool isArcShape (const RShape &s)
 
static bool isCircleShape (const RShape &s)
 
static bool isEllipseShape (const RShape &s)
 
static bool isFullEllipseShape (const RShape &s)
 
static bool isLineShape (const RShape &s)
 
static bool isPointShape (const RShape &s)
 
static bool isPolylineShape (const RShape &s)
 
static bool isRayShape (const RShape &s)
 
static bool isSplineShape (const RShape &s)
 
static bool isTriangleShape (const RShape &s)
 
static bool isXLineShape (const RShape &s)
 
static bool order (QList< QList< QSharedPointer< RShape > > > &boundary)
 Orders the given list of loops into a list of closed loops in which all shapes are connected end to start point. More...
 
static QSharedPointer< RShaperayToLine (QSharedPointer< RShape > shape)
 
static QList< QSharedPointer< RShape > > roundAllCorners (const QList< QSharedPointer< RShape > > &shapes, double radius)
 Round every corner of the list of given (connected) shapes with the given radius. More...
 
static QList< QSharedPointer< RShape > > roundShapes (const QSharedPointer< RShape > shape1, const RVector &clickPos1, const QSharedPointer< RShape > shape2, const RVector &clickPos2, bool trim, bool samePolyline, double radius, const RVector &pos)
 Rounds the given shape1 against shape2. More...
 
static QSharedPointer< RShapescaleArc (const RShape &shape, const RVector &scaleFactors, const RVector &center=RDEFAULT_RVECTOR)
 
static void setShapeProxy (RShapeProxy *p)
 
static QSharedPointer< RShapetransformArc (const RShape &shape, RShapeTransformation &transformation)
 
static QList< QSharedPointer< RShape > > trim (const RShape &trimShape, const RVector &trimClickPos, const RShape &limitingShape, const RVector &limitingClickPos, bool trimBoth, bool samePolyline)
 Trims a shape to another or two shapes to each other. More...
 
static QSharedPointer< RShapexLineToRay (QSharedPointer< RShape > shape)
 

Protected Member Functions

bool isLineSegment (int i) const
 
void print (QDebug dbg) const
 

Protected Attributes

QList< double > bulges
 
bool closed
 
Getter function for this property: isClosed

Setter function for this property: setClosed
More...
 
QList< double > endWidths
 
QList< double > startWidths
 
QList< RVectorvertices
 
Getter function for this property: getVertices

Setter function for this property: setVertices
More...
 

Static Private Attributes

static RPolylineProxypolylineProxy = NULL
 Copyright (c) 2011-2018 by Andrew Mustun. More...
 

Additional Inherited Members

- Public Types inherited from RShape
enum  Type {
  Unknown = -1, Point = 0, Line = 1, Arc = 2,
  Circle = 3, Ellipse = 4, Polyline = 5, Spline = 6,
  Triangle = 7, XLine = 8, Ray = 9
}
 
- Static Protected Attributes inherited from RShape
static int errorCode = 0
 

Detailed Description

Low-level mathematical representation of an open polyline or closed polyline (= polygon).

Scriptable:\nThis class is available in script environments.\n
Shared Pointer Support:\nObjects can be used in QSharedPointer.\n
Copyable:\nObjects are cleaned up automatically by the garbage collector of the script engine.\n
Stream Operator:\nObject has a stream operator to present itself as string, for example when using toString() in a script.\n

Constructor & Destructor Documentation

◆ RPolyline() [1/3]

RPolyline::RPolyline ( )

Creates a polyline object without points.

◆ RPolyline() [2/3]

RPolyline::RPolyline ( const QList< RVector > &  vertices,
bool  closed 
)

Creates a polyline object with the given points.

◆ RPolyline() [3/3]

RPolyline::RPolyline ( const QList< QSharedPointer< RShape > > &  segments)

Creates a polyline from segments (lines or arcs).

◆ ~RPolyline()

RPolyline::~RPolyline ( )
virtual

Member Function Documentation

◆ appendShape()

bool RPolyline::appendShape ( const RShape shape,
bool  prepend = false 
)

◆ appendShapeAuto()

bool RPolyline::appendShapeAuto ( const RShape shape)

Appends the given shape to this polyline.

The shape is reversed if necessary.

◆ appendVertex() [1/2]

void RPolyline::appendVertex ( const RVector vertex,
double  bulge = 0.0,
double  w1 = 0.0,
double  w2 = 0.0 
)

◆ appendVertex() [2/2]

void RPolyline::appendVertex ( double  x,
double  y,
double  bulge = 0.0,
double  w1 = 0.0,
double  w2 = 0.0 
)

◆ autoClose()

bool RPolyline::autoClose ( double  tolerance = RS::PointTolerance)
inline

◆ clear()

void RPolyline::clear ( )

◆ clone()

virtual RPolyline* RPolyline::clone ( ) const
inlinevirtual

Implements RShape.

◆ contains()

bool RPolyline::contains ( const RVector point,
bool  borderIsInside = false,
double  tolerance = RS::PointTolerance 
) const

Checks if the given point is inside this closed polygon.

If this polyline is not closed, false is returned.

See also
setClosed
Parameters
borderIsInsideTrue if a position on the polyline counts as inside.
toleranceTolerance used to check if point is on polyline.

◆ containsShape()

bool RPolyline::containsShape ( const RShape shape) const

Checks if the given shape is completely inside this closed polygon.

If this polyline is not closed, false is returned.

See also
setClosed

If the shape touches the polyline, false is returned.

Parameters
shapeThe shape to check.

◆ convertArcToLineSegments()

RPolyline RPolyline::convertArcToLineSegments ( int  segments) const

◆ convertArcToLineSegmentsLength()

RPolyline RPolyline::convertArcToLineSegmentsLength ( double  segmentLength) const

◆ convertToClosed()

bool RPolyline::convertToClosed ( )

◆ convertToOpen()

bool RPolyline::convertToOpen ( )

◆ countSegments()

int RPolyline::countSegments ( ) const
Returns
Number of segments. The number of segments equals the number of vertices for a closed polyline and one less for an open polyline.

◆ countVertices()

int RPolyline::countVertices ( ) const

◆ getAngleAt()

double RPolyline::getAngleAt ( double  distance,
RS::From  from = RS::FromStart 
) const
virtual
Returns
Angle on the entity at the given distance from the start point.

Reimplemented from RShape.

◆ getArea()

double RPolyline::getArea ( ) const
Returns
Area of (implicitly closed) polyline.

◆ getBaseAngle()

double RPolyline::getBaseAngle ( ) const

◆ getBoolProperties()

QList< bool > RPolyline::getBoolProperties ( ) const
virtual

Reimplemented from RShape.

◆ getBoundingBox()

RBox RPolyline::getBoundingBox ( ) const
virtual
Returns
The bounding box of this shape.

Implements RShape.

◆ getBulgeAt()

double RPolyline::getBulgeAt ( int  i) const

◆ getBulges()

QList< double > RPolyline::getBulges ( ) const

◆ getCenterPoints()

QList< RVector > RPolyline::getCenterPoints ( ) const
virtual
Returns
The center point(s) of this shape.

Implements RShape.

◆ getClosestSegment()

int RPolyline::getClosestSegment ( const RVector point) const

◆ getClosestVertex()

int RPolyline::getClosestVertex ( const RVector point) const

◆ getConcaveVertices()

QList< RVector > RPolyline::getConcaveVertices ( ) const

◆ getConvexVertices()

QList< RVector > RPolyline::getConvexVertices ( bool  convex = true) const

◆ getDirection1()

double RPolyline::getDirection1 ( ) const
virtual

Reimplemented from RShape.

Reimplemented in RPolylineData, and RSolidData.

◆ getDirection2()

double RPolyline::getDirection2 ( ) const
virtual

Reimplemented from RShape.

Reimplemented in RPolylineData, and RSolidData.

◆ getDistanceFromStart()

virtual double RPolyline::getDistanceFromStart ( const RVector p) const
inlinevirtual
Returns
Distance of given point to start point of shape along shape.
Parameters
pPoint (assumed to be on shape).

Reimplemented from RShape.

◆ getDistancesFromStart()

QList< double > RPolyline::getDistancesFromStart ( const RVector p) const
virtual
Returns
All possible distances of given point to start point of shape along shape.
Parameters
pPoint (assumed to be on shape).

Reimplemented from RShape.

◆ getDistanceTo()

double RPolyline::getDistanceTo ( const RVector point,
bool  limited = true,
double  strictRange = RMAXDOUBLE 
) const
virtual
Returns
Shortest distance from this shape to the given point. Based on getVectorTo.

Reimplemented from RShape.

◆ getDoubleProperties()

QList< double > RPolyline::getDoubleProperties ( ) const
virtual

Reimplemented from RShape.

◆ getEndPoint()

RVector RPolyline::getEndPoint ( ) const
virtual

Reimplemented from RShape.

Reimplemented in RPolylineData, RLeaderData, and RSolidData.

◆ getEndPoints()

QList< RVector > RPolyline::getEndPoints ( ) const
virtual
Returns
The end point(s) of this shape.

Implements RShape.

◆ getEndWidthAt()

double RPolyline::getEndWidthAt ( int  i) const

◆ getEndWidths()

QList< double > RPolyline::getEndWidths ( ) const

◆ getExploded()

QList< QSharedPointer< RShape > > RPolyline::getExploded ( int  segments = RDEFAULT_MIN1) const
virtual
Returns
List of RLines and RArcs describing this polyline.

Implements RExplodable.

Reimplemented in RPolylineData, and RLeaderData.

◆ getFirstSegment()

QSharedPointer< RShape > RPolyline::getFirstSegment ( ) const

◆ getHeight()

double RPolyline::getHeight ( ) const

◆ getLastSegment()

QSharedPointer< RShape > RPolyline::getLastSegment ( ) const

◆ getLastVertex()

RVector RPolyline::getLastVertex ( ) const

◆ getLeftRightOutline()

QList< QPair< RPolyline, RPolyline > > RPolyline::getLeftRightOutline ( ) const

◆ getLength()

double RPolyline::getLength ( ) const
virtual
Returns
The total length of this shape if applicable or NaN if not.

Implements RShape.

◆ getLengthTo()

double RPolyline::getLengthTo ( const RVector p,
bool  limited = true 
) const
Returns
Length along polyline from start point to given point p or the closest point to p on the polyline.

◆ getMiddlePoint()

RVector RPolyline::getMiddlePoint ( ) const
virtual

Reimplemented from RShape.

◆ getMiddlePoints()

QList< RVector > RPolyline::getMiddlePoints ( ) const
virtual
Returns
The middle point(s) of this shape.

Implements RShape.

◆ getOrientation()

RS::Orientation RPolyline::getOrientation ( bool  implicitelyClosed = false) const

◆ getOutline()

QList< RPolyline > RPolyline::getOutline ( ) const

◆ getPointAtPercent()

RVector RPolyline::getPointAtPercent ( double  p) const
virtual
Returns
Point at given percentile.

Reimplemented from RShape.

◆ getPointCloud()

QList< RVector > RPolyline::getPointCloud ( double  segmentLength) const
virtual

Implements RShape.

◆ getPointInside()

RVector RPolyline::getPointInside ( ) const
Returns
Any point that is inside this polyline.

◆ getPointsWithDistanceToEnd()

QList< RVector > RPolyline::getPointsWithDistanceToEnd ( double  distance,
int  from = RS::FromAny 
) const
virtual
Returns
All points on this shape with the given distance to an endpoint.

Implements RShape.

◆ getPolygonHull()

RPolyline RPolyline::getPolygonHull ( double  angle,
double  tolerance,
bool  inner = false 
) const

◆ getPolylineProxy()

static RPolylineProxy* RPolyline::getPolylineProxy ( )
inlinestatic
Non-Scriptable:\nThis function is not available in script environments.\n

◆ getReversed()

RPolyline RPolyline::getReversed ( ) const
virtual

◆ getSegmentAt()

QSharedPointer< RShape > RPolyline::getSegmentAt ( int  i) const
Returns
Shape of segment at given position.

◆ getSegmentAtDist()

int RPolyline::getSegmentAtDist ( double  dist)

◆ getSegmentsLength()

double RPolyline::getSegmentsLength ( int  fromIndex,
int  toIndex 
) const
Returns
Length of all segments from first index (fromIndex) to last index (toIndex), excluding toIndex.

◆ getSelfIntersectionPoints()

QList< RVector > RPolyline::getSelfIntersectionPoints ( ) const
virtual

Reimplemented from RShape.

◆ getShapeType()

virtual RShape::Type RPolyline::getShapeType ( ) const
inlinevirtual

Reimplemented from RShape.

◆ getSideOfPoint()

RS::Side RPolyline::getSideOfPoint ( const RVector point) const
virtual

Reimplemented from RShape.

◆ getStartPoint()

RVector RPolyline::getStartPoint ( ) const
virtual

Reimplemented from RShape.

Reimplemented in RPolylineData, RLeaderData, and RSolidData.

◆ getStartWidthAt()

double RPolyline::getStartWidthAt ( int  i) const

◆ getStartWidths()

QList< double > RPolyline::getStartWidths ( ) const

◆ getTransformed()

QSharedPointer< RShape > RPolyline::getTransformed ( const QTransform &  transform) const
virtual

Implements RShape.

◆ getTrimEnd()

RS::Ending RPolyline::getTrimEnd ( const RVector trimPoint,
const RVector clickPoint 
)
virtual
Parameters
trimPointTrim start point or end point to this coordinate.
clickPointPoint that was clicked by user.

Reimplemented from RShape.

Reimplemented in RSolidData.

◆ getVectorProperties()

QList< RVector > RPolyline::getVectorProperties ( ) const
virtual

Reimplemented from RShape.

◆ getVectorTo()

RVector RPolyline::getVectorTo ( const RVector point,
bool  limited = true,
double  strictRange = RMAXDOUBLE 
) const
virtual
Returns
Shortest vector from this shape to the given point.
Parameters
pointthe given point
limitedIf false, the shape is treated as an unlimited shape that extends in a logical way. For example an unlimited line for a line, full circle for an arc or a plane for a triangle.

Implements RShape.

◆ getVertexAngle()

double RPolyline::getVertexAngle ( int  i,
RS::Orientation  orientation = RS::UnknownOrientation 
) const

◆ getVertexAngles()

QList< double > RPolyline::getVertexAngles ( ) const

◆ getVertexAt()

RVector RPolyline::getVertexAt ( int  i) const

◆ getVertexIndex()

int RPolyline::getVertexIndex ( const RVector v,
double  tolerance = RS::PointTolerance 
) const

◆ getVertices()

QList< RVector > RPolyline::getVertices ( ) const

◆ getWidth()

double RPolyline::getWidth ( ) const

◆ hasArcSegments()

bool RPolyline::hasArcSegments ( ) const

◆ hasProxy()

static bool RPolyline::hasProxy ( )
inlinestatic

◆ hasWidths()

bool RPolyline::hasWidths ( ) const

◆ insertVertex()

void RPolyline::insertVertex ( int  index,
const RVector vertex,
double  bulgeBefore = 0.0,
double  bulgeAfter = 0.0 
)

◆ insertVertexAt()

void RPolyline::insertVertexAt ( const RVector point)

Inserts a vertex at the point on the polyline closest to the given position.

◆ insertVertexAtDistance()

RVector RPolyline::insertVertexAtDistance ( double  dist)

◆ isArcSegmentAt()

bool RPolyline::isArcSegmentAt ( int  i) const

◆ isClosed()

bool RPolyline::isClosed ( ) const
Returns
True if this polyline is logically marked as closed.

◆ isConcave()

bool RPolyline::isConcave ( ) const

◆ isDirected()

virtual bool RPolyline::isDirected ( ) const
inlinevirtual

Reimplemented from RShape.

◆ isEmpty()

bool RPolyline::isEmpty ( ) const
inline

◆ isFlat()

bool RPolyline::isFlat ( ) const

◆ isGeometricallyClosed()

bool RPolyline::isGeometricallyClosed ( double  tolerance = RS::PointTolerance) const
Returns
True is this polyline is geometrically closed. If this polyline is logically closed it is implicitly also geometrically closed.

◆ isInterpolated()

virtual bool RPolyline::isInterpolated ( ) const
inlinevirtual

Reimplement and return true if this shape relies on interpolation for geometrical operations such as finding intersection points.

E.g. splines.

Reimplemented from RShape.

◆ isLineSegment()

bool RPolyline::isLineSegment ( int  i) const
protected
Returns
True if the segment at the given position is a line.

◆ isStraight()

bool RPolyline::isStraight ( double  bulge)
static
Returns
True if the given bulge indicates a straight line segment (i.e. is 0.0).

◆ mirror()

bool RPolyline::mirror ( const RLine axis)
virtual

Implements RShape.

◆ modifyPolylineCorner()

RPolyline RPolyline::modifyPolylineCorner ( const RShape trimmedShape1,
RS::Ending  ending1,
int  segmentIndex1,
const RShape trimmedShape2,
RS::Ending  ending2,
int  segmentIndex2,
const RShape cornerShape = NULL 
) const

Modifies (bevels, rounds, trims) the corner of this polyline between segmentIndex1 and segmentIndex2 at the given segment endings.

The given cornerShape (bevel, rounding) is inserted between.

◆ morph()

QList< RPolyline > RPolyline::morph ( const RPolyline target,
int  steps,
RS::Easing  easing = RS::Linear,
bool  zLinear = true,
double  customFactor = RNANDOUBLE 
) const

◆ move()

bool RPolyline::move ( const RVector offset)
virtual

Implements RShape.

◆ moveEndPoint()

void RPolyline::moveEndPoint ( const RVector pos)

◆ moveSegmentAt()

void RPolyline::moveSegmentAt ( int  i,
const RVector offset 
)

◆ moveStartPoint()

void RPolyline::moveStartPoint ( const RVector pos)

◆ moveVertexAt()

void RPolyline::moveVertexAt ( int  i,
const RVector offset 
)

◆ normalize()

void RPolyline::normalize ( double  tolerance = RS::PointTolerance)

Removes duplicate vertices.

◆ prependShape()

bool RPolyline::prependShape ( const RShape shape)

◆ prependVertex()

void RPolyline::prependVertex ( const RVector vertex,
double  bulge = 0.0,
double  w1 = 0.0,
double  w2 = 0.0 
)

◆ print()

void RPolyline::print ( QDebug  dbg) const
protectedvirtual

Reimplemented from RShape.

◆ relocateStartPoint() [1/2]

bool RPolyline::relocateStartPoint ( const RVector p)

Relocates the start point of this closed polyline to the given point.

The visual appearance of the polyline does not change.

◆ relocateStartPoint() [2/2]

bool RPolyline::relocateStartPoint ( double  dist)

◆ removeFirstVertex()

void RPolyline::removeFirstVertex ( )

◆ removeLastVertex()

void RPolyline::removeLastVertex ( )

◆ removeVertex()

void RPolyline::removeVertex ( int  index)

◆ removeVerticesAfter()

void RPolyline::removeVerticesAfter ( int  index)

◆ removeVerticesBefore()

void RPolyline::removeVerticesBefore ( int  index)

◆ reverse()

bool RPolyline::reverse ( )
virtual

Reimplemented from RShape.

Reimplemented in RPolylineData, and RSolidData.

◆ rotate()

bool RPolyline::rotate ( double  rotation,
const RVector center = RDEFAULT_RVECTOR 
)
virtual

Implements RShape.

◆ roundAllCorners()

RPolyline RPolyline::roundAllCorners ( double  radius) const

◆ scale() [1/2]

bool RPolyline::scale ( const RVector scaleFactors,
const RVector center = RDEFAULT_RVECTOR 
)
virtual

Implements RShape.

Reimplemented in RLeaderData.

◆ scale() [2/2]

bool RPolyline::scale ( double  scaleFactor,
const RVector center = RDEFAULT_RVECTOR 
)
virtual

Reimplemented from RShape.

◆ setBulgeAt()

void RPolyline::setBulgeAt ( int  i,
double  b 
)

◆ setBulges()

void RPolyline::setBulges ( const QList< double > &  b)

◆ setClosed()

void RPolyline::setClosed ( bool  on)

Marks the poyline as logically (explicitly) closed.

The first and last node are usually not identical. Logically closed polylines have an additional segment from start to end point.

◆ setEndWidthAt()

void RPolyline::setEndWidthAt ( int  i,
double  w 
)

◆ setEndWidths()

void RPolyline::setEndWidths ( const QList< double > &  ew)

◆ setGlobalWidth()

void RPolyline::setGlobalWidth ( double  w)

◆ setHeight()

bool RPolyline::setHeight ( double  v)

◆ setMinimumWidth()

void RPolyline::setMinimumWidth ( double  w)

◆ setOrientation()

bool RPolyline::setOrientation ( RS::Orientation  orientation)

◆ setPolylineProxy()

static void RPolyline::setPolylineProxy ( RPolylineProxy p)
inlinestatic
Non-Scriptable:\nThis function is not available in script environments.\n

◆ setStartWidthAt()

void RPolyline::setStartWidthAt ( int  i,
double  w 
)

◆ setStartWidths()

void RPolyline::setStartWidths ( const QList< double > &  sw)

◆ setVertexAt()

void RPolyline::setVertexAt ( int  i,
const RVector v 
)

◆ setVertices()

void RPolyline::setVertices ( const QList< RVector > &  vertices)

◆ setWidth()

bool RPolyline::setWidth ( double  v)

◆ setZ()

void RPolyline::setZ ( double  z)
virtual

Implements RShape.

◆ simplify()

bool RPolyline::simplify ( double  tolerance = RS::PointTolerance)

Simplify by attempting to skip nodes within given tolerance.

Returns
True if nodes have been skipped.

◆ splitAtDiscontinuities()

QList< RPolyline > RPolyline::splitAtDiscontinuities ( double  tolerance) const

◆ splitAtSegmentTypeChange()

QList< RPolyline > RPolyline::splitAtSegmentTypeChange ( ) const

Splits the polyline into polylines with exclusively line or arc segments.

◆ stretch()

bool RPolyline::stretch ( const RPolyline area,
const RVector offset 
)
virtual

Reimplemented from RShape.

Reimplemented in RLeaderData.

◆ stripWidths()

void RPolyline::stripWidths ( )

◆ toLogicallyClosed()

bool RPolyline::toLogicallyClosed ( double  tolerance = RS::PointTolerance)

Converts this geometrically closed polyline (start == end) to a locically closed polyline.

Returns
True on success, false if this polyline is already locically closed or is not geometrically closed.

◆ toLogicallyOpen()

bool RPolyline::toLogicallyOpen ( )

Converts this logically closed polyline to a locically open, geometrically closed polyline.

An additional node is inserted to make sure start == end.

Returns
True on success, false if this polyline is not locically closed.

◆ toPainterPath()

RPainterPath RPolyline::toPainterPath ( bool  addOriginalShapes = false) const
Returns
A QPainterPath object that represents this polyline.

◆ trimEndPoint() [1/2]

bool RPolyline::trimEndPoint ( const RVector trimPoint,
const RVector clickPoint = RVector::invalid,
bool  extend = false 
)
virtual
Parameters
trimPointTrim start point or end point to this coordinate.
clickPointPoint that was clicked by user.
extendTrue if the shape is to be extended. Used for polylines to determine that the last segment has to be trimmed even if another segment was clicked.

Reimplemented from RShape.

Reimplemented in RSolidData.

◆ trimEndPoint() [2/2]

bool RPolyline::trimEndPoint ( double  trimDist)
virtual

Reimplemented from RShape.

◆ trimStartPoint() [1/2]

bool RPolyline::trimStartPoint ( const RVector trimPoint,
const RVector clickPoint = RVector::invalid,
bool  extend = false 
)
virtual
Parameters
trimPointTrim start point or end point to this coordinate.
clickPointPoint that was clicked by user.
extendTrue if the shape is to be extended. Used for polylines to determine that the first segment has to be trimmed even if another segment was clicked.

Reimplemented from RShape.

Reimplemented in RSolidData.

◆ trimStartPoint() [2/2]

bool RPolyline::trimStartPoint ( double  trimDist)
virtual

Reimplemented from RShape.

◆ verifyTangency()

QList< RVector > RPolyline::verifyTangency ( double  toleranceMin = RS::AngleTolerance,
double  toleranceMax = M_PI_4 
)

Verifies the tangency of this polyline.

Member Data Documentation

◆ bulges

QList<double> RPolyline::bulges
protected

◆ closed

bool RPolyline::closed
protected


Getter function for this property: isClosed

Setter function for this property: setClosed

◆ endWidths

QList<double> RPolyline::endWidths
protected

◆ polylineProxy

RPolylineProxy * RPolyline::polylineProxy = NULL
staticprivate

Copyright (c) 2011-2018 by Andrew Mustun.

All rights reserved.

This file is part of the QCAD project.

QCAD is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

QCAD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with QCAD.

◆ startWidths

QList<double> RPolyline::startWidths
protected

◆ vertices

QList<RVector> RPolyline::vertices
protected


Getter function for this property: getVertices

Setter function for this property: setVertices


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