RArcData

Class in Entity Module
Header: #include <src/entity/RArcData.h>
Inherits: REntityData, RArc

Description

Stores and manages all data that defines the geometry and appearance of an arc entity.

Scriptable: This class is available in script environments.

Copyable: Objects are cleaned up automatically by the garbage collector of the script engine.

Public Functions

	RArcData()
	RArcData(const RArc &arc)
	RArcData(const RVector &center, double radius, double startAngle, double endAngle, bool reversed=false)
RPolyline	approximateWithLines(double segmentLength)
virtual RShape *	castToShape()
virtual bool	flipHorizontal()
virtual bool	flipVertical()
double	getAngleLength(bool allowForZeroLength=false) const
RArc	getArc()
virtual QList< RVector >	getArcReferencePoints(const RBox &queryBox=RDEFAULT_RBOX) const
virtual RBox	getBoundingBox(bool ignoreEmpty=false) const
double	getBulge() const
RVector	getCenter() const
virtual QList< RVector >	getCenterPoints(const RBox &queryBox=RDEFAULT_RBOX, QList< RObject::Id > *subEntityIds=NULL) const
virtual double	getDirection1() const
virtual double	getDirection2() const
virtual double	getDistanceTo(const RVector &point, bool limited=true, double range=0.0, bool draft=false, double strictRange=RMAXDOUBLE) const
double	getEndAngle() const
virtual QList< RVector >	getEndPoints(const RBox &queryBox=RDEFAULT_RBOX, QList< RObject::Id > *subEntityIds=NULL) const
virtual QList< RVector >	getIntersectionPoints(const REntityData &other, bool limited=true, bool same=false, const RBox &queryBox=RDEFAULT_RBOX, bool ignoreComplex=true, QList< QPair< RObject::Id, RObject::Id > > *entityIds=NULL) const
virtual QList< RVector >	getIntersectionPoints(const RShape &shape, bool limited=true, const RBox &queryBox=RDEFAULT_RBOX, bool ignoreComplex=true) const
virtual double	getLength() const
virtual QList< RVector >	getMiddlePoints(const RBox &queryBox=RDEFAULT_RBOX, QList< RObject::Id > *subEntityIds=NULL) const
virtual QList< RVector >	getPointsWithDistanceToEnd(double distance, int from=RS::FromAny, const RBox &queryBox=RDEFAULT_RBOX, QList< RObject::Id > *subEntityIds=NULL) const
double	getRadius() const
virtual QList< RRefPoint >	getReferencePoints(RS::ProjectionRenderingHint hint=RS::RenderTop) const
virtual QList< QSharedPointer< RShape > >	getShapes(const RBox &queryBox=RDEFAULT_RBOX, bool ignoreComplex=false, bool segment=false, QList< RObject::Id > *entityIds=NULL) const
double	getStartAngle() const
virtual RS::Ending	getTrimEnd(const RVector &trimPoint, const RVector &clickPoint)
virtual RS::EntityType	getType() const
virtual RVector	getVectorTo(const RVector &point, bool limited=true, double strictRange=RMAXDOUBLE) const
virtual bool	intersectsWith(const RShape &shape) const
bool	isReversed() const
virtual bool	isValid() const
virtual bool	mirror(const RLine &axis)
virtual bool	mirror(const RVector &axis1, const RVector &axis2)
virtual bool	move(const RVector &offset) Moves this entity by the given offset.
virtual bool	moveReferencePoint(const RVector &referencePoint, const RVector &targetPoint, Qt::KeyboardModifiers modifiers=Qt::NoModifier) Moves the given reference point to the given target point or does nothing if this entity has no reference point as the given location.
virtual bool	reverse() Reverses the arc direction by swapping start/end angles and toggling the reversed flag.
virtual bool	rotate(double rotation, const RVector &center=RDEFAULT_RVECTOR)
virtual bool	scale(const RVector &scaleFactors, const RVector &center=RDEFAULT_RVECTOR)
virtual void	setZ(double z)
virtual bool	stretch(const RPolyline &area, const RVector &offset) Stretches the end points of this entity that are inside area by offset.
virtual void	to2D()
virtual bool	trimEndPoint(const RVector &trimPoint, const RVector &clickPoint=RVector::invalid, bool extend=false) Trims the end of the arc to the angle corresponding to trimPoint.
virtual bool	trimStartPoint(const RVector &trimPoint, const RVector &clickPoint=RVector::invalid, bool extend=false) Trims the start of the arc to the angle corresponding to trimPoint.

Protected Functions

	RArcData(RDocument *document, const RArcData &data)

Friends

class	RArcEntity

Member Documentation

RArcData

RArcData::RArcData()

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.

RArcData

RArcData::RArcData(const RArc &arc)

RArcData

RArcData::RArcData(const RVector &center, double radius, double startAngle, double endAngle, bool reversed=false)

approximateWithLines

RPolyline RArcData::approximateWithLines(double segmentLength)

inline

castToShape

virtual RShape * RArcData::castToShape()

virtual inline

Reimplemented from castToShape.

flipHorizontal

virtual bool RArcData::flipHorizontal()

virtual inline

Reimplemented from flipHorizontal.

flipVertical

virtual bool RArcData::flipVertical()

virtual inline

Reimplemented from flipVertical.

getAngleLength

double RArcData::getAngleLength(bool allowForZeroLength=false) const

inline const

getArc

RArc RArcData::getArc()

inline

getArcReferencePoints

virtual QList< RVector > RArcData::getArcReferencePoints(const RBox &queryBox=RDEFAULT_RBOX) const

virtual inline const

Returns: Vector of reference points of this entity. Used for snap to reference points.

Reimplemented from getArcReferencePoints.

getBoundingBox

virtual RBox RArcData::getBoundingBox(bool ignoreEmpty=false) const

virtual inline const

Returns: The bounding box that contains this entity.

Reimplemented from getBoundingBox.

getBulge

double RArcData::getBulge() const

inline const

getCenter

RVector RArcData::getCenter() const

inline const

getCenterPoints

virtual QList< RVector > RArcData::getCenterPoints(const RBox &queryBox=RDEFAULT_RBOX, QList< RObject::Id > *subEntityIds=NULL) const

virtual inline const

Returns: Vector of center points of this entity. Used for snap to center points.

Reimplemented from getCenterPoints.

getDirection1

virtual double RArcData::getDirection1() const

virtual inline const

Returns: Tangent direction at the start point (in rad): perpendicular to the radius, pointing in the direction of travel.

Reimplemented from getDirection1.

getDirection2

virtual double RArcData::getDirection2() const

virtual inline const

Returns: Tangent direction at the end point (in rad), pointing away from the arc.

Reimplemented from getDirection2.

getDistanceTo

virtual double RArcData::getDistanceTo(const RVector &point, bool limited=true, double range=0.0, bool draft=false, double strictRange=RMAXDOUBLE) const

virtual inline const

Returns: The shortest distance from this entity to the given point.

Parameters:

• limited: Limit lines, arcs at end points, otherwise the orthogonal distance to the unlimited line / circle is returned.
• range: This is returned for solid filled entities (solid filled or dense hatches, text entities) if the point is on the entity and the distance would be zero.
• draft: Calculate based on draft mode representation of the entity.
• strictRange: If limited, this is the maximum range from either end point of the entity. Zero to only return distances that are strictly orthogonal to the entity.

Reimplemented from getDistanceTo.

getEndAngle

double RArcData::getEndAngle() const

inline const

getEndPoints

virtual QList< RVector > RArcData::getEndPoints(const RBox &queryBox=RDEFAULT_RBOX, QList< RObject::Id > *subEntityIds=NULL) const

virtual inline const

Returns: Vector of end points of this entity. Used for snap to end points.

Reimplemented from getEndPoints.

getIntersectionPoints

virtual QList< RVector > RArcData::getIntersectionPoints(const REntityData &other, bool limited=true, bool same=false, const RBox &queryBox=RDEFAULT_RBOX, bool ignoreComplex=true, QList< QPair< RObject::Id, RObject::Id > > *entityIds=NULL) const

virtual inline const

Returns: Points on entity which are intersection points with the given other entity. If same is true, the two datas originate from the same entity.

Reimplemented from getIntersectionPoints.

getIntersectionPoints

virtual QList< RVector > RArcData::getIntersectionPoints(const RShape &shape, bool limited=true, const RBox &queryBox=RDEFAULT_RBOX, bool ignoreComplex=true) const

virtual inline const

Returns: Points on entity which are intersection points with the given shape.

Reimplemented from getIntersectionPoints.

getLength

virtual double RArcData::getLength() const

virtual inline const

Returns: Arc length (angle length * radius).

Reimplemented from getLength.

getMiddlePoints

virtual QList< RVector > RArcData::getMiddlePoints(const RBox &queryBox=RDEFAULT_RBOX, QList< RObject::Id > *subEntityIds=NULL) const

virtual inline const

Returns: Vector of middle points of this entity. Used for snap to middle points.

Reimplemented from getMiddlePoints.

getPointsWithDistanceToEnd

virtual QList< RVector > RArcData::getPointsWithDistanceToEnd(double distance, int from=RS::FromAny, const RBox &queryBox=RDEFAULT_RBOX, QList< RObject::Id > *subEntityIds=NULL) const

virtual inline const

Returns: Points on entity with given distance to either endpoint. Used for snap to points with distance on entity.

Reimplemented from getPointsWithDistanceToEnd.

getRadius

double RArcData::getRadius() const

inline const

getReferencePoints

virtual QList< RRefPoint > RArcData::getReferencePoints(RS::ProjectionRenderingHint hint=RS::RenderTop) const

virtual const

Returns: Vector of reference points of this entity. Reference points can usually be moved around by the user to change the geometry of the entity.

Reimplemented from getReferencePoints.

getShapes

virtual QList< QSharedPointer< RShape > > RArcData::getShapes(const RBox &queryBox=RDEFAULT_RBOX, bool ignoreComplex=false, bool segment=false, QList< RObject::Id > *entityIds=NULL) const

virtual inline const

Returns: Shapes that represent the geometry of this entity.

Parameters:

• queryBox: Limit returned shapes to query box
• ignoreComplex: Ignore complex shapes and explode those into simple shapes
• segment: Split up splines into spline segments

Reimplemented from getShapes.

getStartAngle

double RArcData::getStartAngle() const

inline const

getTrimEnd

virtual RS::Ending RArcData::getTrimEnd(const RVector &trimPoint, const RVector &clickPoint)

virtual inline

Returns: Which end of the arc is closer to clickPoint relative to trimPoint. Used to decide which end to trim when the user clicks near a trim point.

Reimplemented from getTrimEnd.

getType

virtual RS::EntityType RArcData::getType() const

virtual inline const

Reimplemented from getType.

getVectorTo

virtual RVector RArcData::getVectorTo(const RVector &point, bool limited=true, double strictRange=RMAXDOUBLE) const

virtual inline const

Returns: The distance vector from this entity to the given point.

Parameters:

• point: the point to which the distance was measured
• limited: If true, an invalid vector is returned if the closest point on the entity is outside of the entity (e.g. in the extension line of a line or outside the start / end angle of an arc).

Reimplemented from getVectorTo.

intersectsWith

virtual bool RArcData::intersectsWith(const RShape &shape) const

virtual inline const

Returns: True if this entity intersects with the given shape, false otherwise.

Reimplemented from intersectsWith.

isReversed

bool RArcData::isReversed() const

inline const

isValid

virtual bool RArcData::isValid() const

virtual inline const

Reimplemented from isValid.

mirror

virtual bool RArcData::mirror(const RLine &axis)

virtual inline

Reimplemented from mirror.

mirror

virtual bool RArcData::mirror(const RVector &axis1, const RVector &axis2)

virtual inline

Reimplemented from mirror.

move

virtual bool RArcData::move(const RVector &offset)

virtual inline

Moves this entity by the given offset.

Reimplemented from move.

moveReferencePoint

virtual bool RArcData::moveReferencePoint(const RVector &referencePoint, const RVector &targetPoint, Qt::KeyboardModifiers modifiers=Qt::NoModifier)

virtual

Moves the given reference point to the given target point or does nothing if this entity has no reference point as the given location.

Returns: True if a reference point has been moved successfully, false otherwise.

Reimplemented from moveReferencePoint.

reverse

virtual bool RArcData::reverse()

virtual inline

Reverses the arc direction by swapping start/end angles and toggling the reversed flag.

Reimplemented from reverse.

rotate

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

virtual inline

Reimplemented from rotate.

scale

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

virtual inline

Reimplemented from scale.

setZ

virtual void RArcData::setZ(double z)

virtual inline

Reimplemented from setZ.

stretch

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

virtual inline

Stretches the end points of this entity that are inside area by offset.

Reimplemented from stretch.

to2D

virtual void RArcData::to2D()

virtual inline

Reimplemented from to2D.

trimEndPoint

virtual bool RArcData::trimEndPoint(const RVector &trimPoint, const RVector &clickPoint=RVector::invalid, bool extend=false)

virtual inline

Trims the end of the arc to the angle corresponding to trimPoint.

Reimplemented from trimEndPoint.

trimStartPoint

virtual bool RArcData::trimStartPoint(const RVector &trimPoint, const RVector &clickPoint=RVector::invalid, bool extend=false)

virtual inline

Trims the start of the arc to the angle corresponding to trimPoint.

Reimplemented from trimStartPoint.

RArcData

RArcData::RArcData(RDocument *document, const RArcData &data)

protected

RArcEntity

friend class RArcEntity

private