#include <EllipseShape.h>

Inheritance diagram for EllipseShape:

Public Types
enum	EllipseType { Arc = 0 , Pie = 1 , Chord = 2 }
	the possible ellipse types More...

Public Types inherited from KoTosContainer
enum	ResizeBehavior { TextFollowsSize , FollowTextSize , IndependentSizes , TextFollowsPreferredTextRect }
	different kinds of resizing behavior to determine how to treat text overflow More...

Public Types inherited from KoShape
enum	ChangeType { PositionChanged , RotationChanged , ScaleChanged , ShearChanged , SizeChanged , GenericMatrixChange , KeepAspectRatioChange , ParentChanged , Deleted , StrokeChanged , BackgroundChanged , ShadowChanged , BorderChanged , ParameterChanged , ContentChanged , TextRunAroundChanged , ChildChanged , ConnectionPointChanged , ClipPathChanged , ClipMaskChanged , TransparencyChanged }
	Used by shapeChanged() to select which change was made. More...

enum	ChildZOrderPolicy { ChildZDefault , ChildZParentChild = ChildZDefault , ChildZPassThrough }
	Used by compareShapeZIndex() to order shapes. More...

enum	PaintOrder { Fill , Stroke , Markers }

enum	RunThroughLevel { Background , Foreground }

enum	TextRunAroundContour { ContourBox , ContourFull , ContourOutside }
	The behavior text should do when intersecting this shape. More...

enum	TextRunAroundSide { BiggestRunAroundSide , LeftRunAroundSide , RightRunAroundSide , EnoughRunAroundSide , BothRunAroundSide , NoRunAround , RunThrough }
	The behavior text should do when intersecting this shape. More...

Public Member Functions
KoShape *	cloneShape () const override
	creates a deep copy of the shape or shape's subtree

	EllipseShape ()

qreal	endAngle () const
	Returns the actual ellipse end angle in degree.

bool	loadSvg (const QDomElement &element, SvgLoadingContext &context) override
	reimplemented from SvgShape

QPointF	normalize () override
	Normalizes the path data.

QString	pathShapeId () const override
	reimplemented

bool	saveSvg (SvgSavingContext &context) override
	reimplemented from SvgShape

void	setEndAngle (qreal angle)

void	setSize (const QSizeF &newSize) override
	Resize the shape.

void	setStartAngle (qreal angle)

void	setType (EllipseType type)

qreal	startAngle () const
	Returns the actual ellipse start angle in degree.

EllipseType	type () const
	Returns the actual ellipse type.

	~EllipseShape () override

Public Member Functions inherited from KoParameterShape
int	handleCount () const
	return the number of handles set on the shape

int	handleIdAt (const QRectF &rect) const
	Get the id of the handle within the given rect.

QPointF	handlePosition (int handleId) const
	Get the handle position.

bool	isParametricShape () const
	Check if object is a parametric shape.

	KoParameterShape ()

void	moveHandle (int handleId, const QPointF &point, Qt::KeyboardModifiers modifiers=Qt::NoModifier)
	Move handle to point.

QPointF	normalize () override
	Normalizes the path data.

void	paintHandle (KisHandlePainterHelper &handlesHelper, int handleId)
	Paint the given handles.

void	paintHandles (KisHandlePainterHelper &handlesHelper)
	Paint the handles.

	Private ()

	Private (const KoParameterShape::Private &rhs)

void	setParametricShape (bool parametric)
	Set if the shape can be modified using parameters.

void	setSize (const QSizeF &size) override
	reimplemented from KoShape

	~KoParameterShape () override

virtual	~Private ()=default

Public Member Functions inherited from KoPathShape
bool	addSubpath (KoSubpath *subpath, int subpathIndex)
	Adds a subpath at the given index to the path.

KoPathPoint *	arcTo (qreal rx, qreal ry, qreal startAngle, qreal sweepAngle)
	Add an arc.

bool	autoFillMarkers () const

QRectF	boundingRect () const override
	reimplemented

bool	breakAfter (const KoPathPointIndex &pointIndex)
	Breaks the path after the point index.

void	clear ()
	Removes all subpaths and their points from the path.

KoShape *	cloneShape () const override
	creates a deep copy of the shape or shape's subtree

void	close ()
	Closes the current subpath.

void	closeMerge ()
	Closes the current subpath.

KoPathPointIndex	closeSubpath (const KoPathPointIndex &pointIndex)
	Close a open subpath.

int	combine (KoPathShape *path)
	Combines two path shapes by appending the data of the specified path.

KoPathPoint *	curveTo (const QPointF &c, const QPointF &p)
	Adds a new quadratic Bezier curve segment.

KoPathPoint *	curveTo (const QPointF &c1, const QPointF &c2, const QPointF &p)
	Adds a new cubic Bezier curve segment.

Qt::FillRule	fillRule () const
	Returns the fill rule for the path object.

bool	hasMarkers () const

bool	hitTest (const QPointF &position) const override
	reimplemented

bool	insertPoint (KoPathPoint *point, const KoPathPointIndex &pointIndex)
	Inserts a new point into the given subpath at the specified position.

bool	isClosedSubpath (int subpathIndex) const
	Checks if a subpath is closed.

bool	join (int subpathIndex)
	Joins the given subpath with the following one.

	KoPathShape ()
	constructor

KoPathPoint *	lineTo (const QPointF &p)
	Adds a new line segment.

void	loadNodeTypes (const QString &nodeTypes)
	Loads node types.

KoMarker *	marker (KoFlake::MarkerPosition pos) const

bool	moveSubpath (int oldSubpathIndex, int newSubpathIndex)
	Moves the position of a subpath within a path.

KoPathPoint *	moveTo (const QPointF &p)
	Starts a new Subpath.

QString	nodeTypes () const
	Saves the node types.

KoPathPointIndex	openSubpath (const KoPathPointIndex &pointIndex)
	Opens a closed subpath.

QPainterPath	outline () const override
	reimplemented

QRectF	outlineRect () const override
	reimplemented

void	paint (QPainter &painter) const override
	reimplemented

virtual void	paintPoints (KisHandlePainterHelper &handlesHelper)

KoPathPointIndex	pathPointIndex (const KoPathPoint *point) const
	Returns the path point index of a given path point.

QPainterPath	pathStroke (const QPen &pen) const

KoPathPoint *	pointByIndex (const KoPathPointIndex &pointIndex) const
	Returns the path point specified by a path point index.

int	pointCount () const
	Returns the number of points in the path.

QList< KoPathPoint * >	pointsAt (const QRectF &rect, const bool useControlPoints=false) const
	Returns the path points within the given rectangle.

void	recommendPointSelectionChange (const QList< KoPathPointIndex > &newSelection)

KoPathPoint *	removePoint (const KoPathPointIndex &pointIndex)
	Removes a point from the path.

KoSubpath *	removeSubpath (int subpathIndex)
	Removes subpath from the path.

bool	reverseSubpath (int subpathIndex)
	Reverse subpath.

KoPathSegment	segmentByIndex (const KoPathPointIndex &pointIndex) const
	Returns the segment specified by a path point index.

QList< KoPathSegment >	segmentsAt (const QRectF &rect) const
	Returns the list of path segments within the given rectangle.

bool	separate (QList< KoPathShape * > &separatedPaths)
	Creates separate path shapes, one for each existing subpath.

void	setAutoFillMarkers (bool value)

void	setFillRule (Qt::FillRule fillRule)
	Sets the fill rule to be used for painting the background.

void	setMarker (KoMarker *marker, KoFlake::MarkerPosition pos)

void	setSize (const QSizeF &size) override

QSizeF	size () const override
	reimplemented

int	subpathCount () const
	Returns the number of subpaths in the path.

int	subpathPointCount (int subpathIndex) const
	Returns the number of points in a subpath.

QString	toString (const QTransform &matrix=QTransform()) const
	Returns a odf/svg string representation of the path data with the given matrix applied.

	~KoPathShape () override

Public Member Functions inherited from KoTosContainer
KoShape *	createTextShape (KoDocumentResourceManager *documentResources=0)

	KoTosContainer ()

virtual bool	loadText (const QDomElement &element)

void	paintComponent (QPainter &painter) const override
	Paint the component Implement this method to allow the shape to paint itself, just like the KoShape::paint() method does.

ResizeBehavior	resizeBehavior () const

void	setPlainText (const QString &text)

void	setResizeBehavior (ResizeBehavior resizeBehavior)

void	setRunThrough (short int runThrough) override

void	setTextAlignment (Qt::Alignment alignment)

Qt::Alignment	textAlignment () const

	~KoTosContainer () override

Public Member Functions inherited from KoShapeContainer
void	addShape (KoShape *shape)

bool	inheritsTransform (const KoShape *shape) const

bool	isClipped (const KoShape *child) const

	KoShapeContainer (KoShapeContainerModel *model=0)

KoShapeContainerModel *	model () const

void	paint (QPainter &painter) const override
	reimplemented

	Private (const Private &rhs, KoShapeContainer *q)

	Private (KoShapeContainer *q)

void	removeShape (KoShape *shape)

void	setClipped (const KoShape *child, bool clipping)

void	setInheritsTransform (const KoShape *shape, bool inherit)

int	shapeCount () const

ShapeInterface *	shapeInterface ()

QList< KoShape * >	shapes () const

virtual void	update () const

void	update () const override
	reimplemented

	~KoShapeContainer () override

Public Member Functions inherited from KoShape
QRectF	absoluteOutlineRect () const

QPointF	absolutePosition (KoFlake::AnchorPosition anchor=KoFlake::Center) const

QTransform	absoluteTransformation () const

bool	addDependee (KoShape *shape)

QString	additionalAttribute (const QString &name) const

void	addShapeChangeListener (ShapeChangeListener *listener)

KoShapeAnchor *	anchor () const

void	applyAbsoluteTransformation (const QTransform &matrix)

void	applyTransformation (const QTransform &matrix)

virtual QSharedPointer< KoShapeBackground >	background () const

virtual ChildZOrderPolicy	childZOrderPolicy ()

KoClipMask *	clipMask () const
	Returns the currently set clip mask or 0 if there is no clip mask set.

KoClipPath *	clipPath () const
	Returns the currently set clip path or 0 if there is no clip path set.

KoShape *	cloneShapeAndBakeAbsoluteTransform () const
	creates a deep copy of the shape/shapes tree and bakes the absolute transform of `this` into the resulting shape.

void	copySettings (const KoShape *shape)

QList< KoShape * >	dependees () const
	Returns list of shapes depending on this shape.

QPointF	documentToShape (const QPointF &point) const
	Transforms point from document coordinates to shape coordinates.

QRectF	documentToShape (const QRectF &rect) const
	Transform rect from document coordinates to shape coordinates.

KoFilterEffectStack *	filterEffectStack () const

bool	hasAdditionalAttribute (const QString &name) const

bool	hasCommonParent (const KoShape *shape) const

bool	hasDependee (KoShape *shape) const
	Returns if the given shape is dependent on this shape.

virtual bool	hasTransparency () const

QString	hyperLink () const

bool	inheritBackground () const
	inheritBackground shows if the shape inherits background from its parent

bool	inheritPaintOrder () const
	inheritPaintOrder

bool	inheritsTransformFromAny (const QList< KoShape * > ancestorsInQuestion) const
	inheritsTransformFromAny checks if the shape inherits transformation from any of the shapes listed in `ancestorsInQuestion`. The inheritance is checked in recursive way.

bool	inheritStroke () const
	inheritStroke shows if the shape inherits the stroke from its parent

bool	isContentProtected () const

bool	isGeometryProtected () const

bool	isPrintable () const

bool	isSelectable () const

virtual bool	isShapeEditable (bool recursive=true) const
	checks recursively if the shape or one of its parents is not visible or locked

bool	isVisible (bool recursive=true) const

bool	keepAspectRatio () const

	KoShape ()
	Constructor.

qreal	minimumHeight () const

QString	name () const

void	notifyChanged ()

virtual void	paintMarkers (QPainter &painter) const
	paintStroke paints the shape's markers

virtual QVector< PaintOrder >	paintOrder () const
	paintOrder

virtual void	paintStroke (QPainter &painter) const
	paintStroke paints the shape's stroked outline

KoShapeContainer *	parent () const

QPointF	position () const
	Get the position of the shape in pt.

void	removeAdditionalAttribute (const QString &name)

void	removeAdditionalStyleAttribute (const char *name)

void	removeDependee (KoShape *shape)

void	removeShapeChangeListener (ShapeChangeListener *listener)

void	rotate (qreal angle)
	Rotate the shape (relative)

qreal	rotation () const

int	runThrough () const

void	scale (qreal sx, qreal sy)
	Scale the shape using the zero-point which is the top-left corner.

void	setAbsolutePosition (const QPointF &newPosition, KoFlake::AnchorPosition anchor=KoFlake::Center)

void	setAdditionalAttribute (const QString &name, const QString &value)

void	setAdditionalStyleAttribute (const char *name, const QString &value)

void	setAnchor (KoShapeAnchor *anchor)

virtual void	setBackground (QSharedPointer< KoShapeBackground > background)

void	setClipMask (KoClipMask *clipMask)
	Sets a new clip mask, removing the old one. The mask is owned by the shape.

void	setClipPath (KoClipPath *clipPath)
	Sets a new clip path, removing the old one.

void	setContentProtected (bool protect)

void	setFilterEffectStack (KoFilterEffectStack *filterEffectStack)
	Sets the new filter effect stack, removing the old one.

void	setGeometryProtected (bool on)

void	setHyperLink (const QString &hyperLink)

void	setInheritBackground (bool value)
	setInheritBackground marks a shape as inheriting the background from the parent shape. NOTE: The currently selected background is destroyed.

void	setInheritPaintOrder (bool value)
	setInheritPaintOrder set inherit paint order.

void	setInheritStroke (bool value)
	setInheritStroke marks a shape as inheriting the stroke from the parent shape. NOTE: The currently selected stroke is destroyed.

void	setKeepAspectRatio (bool keepAspect)

void	setMinimumHeight (qreal height)

void	setName (const QString &name)

virtual void	setPaintOrder (PaintOrder first, PaintOrder second)
	setPaintOrder set the paint order. As there's only three entries in any given paintorder, you only need to have the first and second entry to set it.

void	setParent (KoShapeContainer *parent)

virtual void	setPosition (const QPointF &position)
	Set the position of the shape in pt.

void	setPrintable (bool on)

virtual void	setResolution (qreal xRes, qreal yRes)

void	setSelectable (bool selectable)

void	setShadow (KoShapeShadow *shadow)
	Sets the new shadow, removing the old one.

void	setShapeId (const QString &id)

virtual void	setStroke (KoShapeStrokeModelSP stroke)

void	setTextRunAroundContour (TextRunAroundContour contour)

void	setTextRunAroundDistanceBottom (qreal distance)

void	setTextRunAroundDistanceLeft (qreal distance)

void	setTextRunAroundDistanceRight (qreal distance)

void	setTextRunAroundDistanceTop (qreal distance)

void	setTextRunAroundSide (TextRunAroundSide side, RunThroughLevel runThrough=Background)

void	setTextRunAroundThreshold (qreal threshold)

void	setToolDelegates (const QSet< KoShape * > &delegates)

void	setTransformation (const QTransform &matrix)

void	setTransparency (qreal transparency)

void	setUserData (KoShapeUserData *userData)

void	setVisible (bool on)

void	setZIndex (qint16 zIndex)

KoShapeShadow *	shadow () const
	Returns the currently set shadow or 0 if there is no shadow set.

virtual QPainterPath	shadowOutline () const

QString	shapeId () const

QPointF	shapeToDocument (const QPointF &point) const
	Transforms point from shape coordinates to document coordinates.

QRectF	shapeToDocument (const QRectF &rect) const
	Transforms rect from shape coordinates to document coordinates.

void	shear (qreal sx, qreal sy)
	Shear the shape The shape will be sheared using the zero-point which is the top-left corner.

virtual KoSnapData	snapData () const
	Returns additional snap data the shape wants to have snapping to.

virtual KoShapeStrokeModelSP	stroke () const

KoInsets	strokeInsets () const

TextRunAroundContour	textRunAroundContour () const

qreal	textRunAroundDistanceBottom () const

qreal	textRunAroundDistanceLeft () const

qreal	textRunAroundDistanceRight () const

qreal	textRunAroundDistanceTop () const

TextRunAroundSide	textRunAroundSide () const

qreal	textRunAroundThreshold () const

QSet< KoShape * >	toolDelegates () const

QTransform	transformation () const
	Returns the shapes local transformation matrix.

qreal	transparency (bool recursive=false) const

virtual void	updateAbsolute (const QRectF &rect) const

KoShapeUserData *	userData () const

virtual void	waitUntilReady (bool asynchronous=true) const

qint16	zIndex () const

virtual	~KoShape ()
	Destructor.

Public Member Functions inherited from SvgShape
void	saveMetadata (SvgSavingContext &context)

virtual	~SvgShape ()

Protected Member Functions
void	createPoints (int requiredPointCount)

void	moveHandleAction (int handleId, const QPointF &point, Qt::KeyboardModifiers modifiers=Qt::NoModifier) override
	Updates the internal state of a KoParameterShape.

void	updatePath (const QSizeF &size) override
	Update the path of the parameter shape.

Protected Member Functions inherited from KoParameterShape
QList< QPointF >	handles () const

	KoParameterShape (const KoParameterShape &rhs)
	constructor

void	setHandles (const QList< QPointF > &handles)

Protected Member Functions inherited from KoPathShape
int	arcToCurve (qreal rx, qreal ry, qreal startAngle, qreal sweepAngle, const QPointF &offset, QPointF *curvePoints) const
	Add an arc.

	KoPathShape (const KoPathShape &rhs)

void	map (const QTransform &matrix)

void	notifyPointsChanged ()

QTransform	resizeMatrix (const QSizeF &newSize) const

KoSubpathList &	subpaths ()
	XXX: refactor this using setter?

const KoSubpathList &	subpaths () const

Protected Member Functions inherited from KoTosContainer
	KoTosContainer (const KoTosContainer &rhs)

QRectF	preferredTextRect () const

void	setPreferredTextRect (const QRectF &rect)

void	shapeChanged (ChangeType type, KoShape *shape=0) override

KoShape *	textShape () const

Protected Member Functions inherited from KoShapeContainer
	KoShapeContainer (const KoShapeContainer &rhs)

void	setModel (KoShapeContainerModel *model)

void	setModelInit (KoShapeContainerModel *model)

virtual void	shapeCountChanged ()

Protected Member Functions inherited from KoShape
	KoShape (const KoShape &rhs)

QList< ShapeChangeListener * >	listeners () const

void	setSizeImpl (const QSizeF &size) const

void	shapeChangedPriv (KoShape::ChangeType type)

QTransform	transform () const
	return the current matrix that contains the rotation/scale/position of this shape

Private Member Functions
	EllipseShape (const EllipseShape &rhs)

qreal	sweepAngle () const

void	updateAngleHandles ()

void	updateKindHandle ()

Private Attributes
QPointF	m_center

qreal	m_endAngle

qreal	m_kindAngle

QPointF	m_radii

qreal	m_startAngle

EllipseType	m_type

Additional Inherited Members
Static Public Member Functions inherited from KoPathShape
static KoPathShape *	createShapeFromPainterPath (const QPainterPath &path)
	Creates path shape from given QPainterPath.

Static Public Member Functions inherited from KoShape
static QRectF	absoluteOutlineRect (const QList< KoShape * > &shapes)

static QRectF	boundingRect (const QList< KoShape * > &shapes)

static bool	compareShapeZIndex (KoShape s1, KoShape s2)

static KisHandlePainterHelper	createHandlePainterHelperDocument (QPainter painter, KoShape shape, qreal handleRadius, int decorationThickness)

static KisHandlePainterHelper	createHandlePainterHelperView (QPainter painter, KoShape shape, const KoViewConverter &converter, qreal handleRadius=0.0, int decorationThickness=1)

static QVector< PaintOrder >	defaultPaintOrder ()
	default paint order as per SVG specification

static QList< KoShape * >	linearizeSubtree (const QList< KoShape * > &shapes)

static QList< KoShape * >	linearizeSubtreeSorted (const QList< KoShape * > &shapes)

Public Attributes inherited from KoParameterShape
QList< QPointF >	handles
	the handles that the user can grab and change

bool	parametric

Public Attributes inherited from KoShapeContainer
KoShapeContainerModel *	model

KoShapeContainer::ShapeInterface	shapeInterface

Static Public Attributes inherited from KoShape
static const qint16	maxZIndex = std::numeric_limits<qint16>::max()

static const qint16	minZIndex = std::numeric_limits<qint16>::min()

Detailed Description

This class adds support for arc, pie, chord, circle and ellipse shapes. The ellipse/circle radii are defined by the actual size of the ellipse shape which can be changed with the setSize method.

Definition at line 22 of file EllipseShape.h.

Member Enumeration Documentation

◆ EllipseType

enum EllipseShape::EllipseType

the possible ellipse types

Enumerator
Arc	an ellipse arc
Pie	an ellipse pie
Chord	an ellipse chord

Definition at line 26 of file EllipseShape.h.

                     {
        Arc = 0,   
        Pie = 1,   
        Chord = 2  
    };

Constructor & Destructor Documentation

◆ EllipseShape() [1/2]

EllipseShape::EllipseShape ( )

Definition at line 26 of file EllipseShape.cpp.

    : m_startAngle(0)
    , m_endAngle(0)
    , m_kindAngle(M_PI)
    , m_type(Arc)
{
    QList<QPointF> handles;
    handles.push_back(QPointF(100, 50));
    handles.push_back(QPointF(100, 50));
    handles.push_back(QPointF(0, 50));
    setHandles(handles);
    QSizeF size(100, 100);
    m_radii = QPointF(size.width() / 2.0, size.height() / 2.0);
    m_center = QPointF(m_radii.x(), m_radii.y());
    updatePath(size);
}

References KoParameterShape::handles, m_center, m_radii, KoParameterShape::setHandles(), KoPathShape::size(), and updatePath().

◆ ~EllipseShape()

EllipseShape::~EllipseShape ( )

override

Definition at line 54 of file EllipseShape.cpp.

55{

56}

◆ EllipseShape() [2/2]

EllipseShape::EllipseShape ( const EllipseShape & rhs )

private

Definition at line 43 of file EllipseShape.cpp.

    : KoParameterShape(rhs),
      m_startAngle(rhs.m_startAngle),
      m_endAngle(rhs.m_endAngle),
      m_kindAngle(rhs.m_kindAngle),
      m_center(rhs.m_center),
      m_radii(rhs.m_radii),
      m_type(rhs.m_type)
{
}

Member Function Documentation

◆ cloneShape()

KoShape * EllipseShape::cloneShape ( ) const

overridevirtual

creates a deep copy of the shape or shape's subtree

Returns: a cloned shape

Reimplemented from KoShape.

Definition at line 58 of file EllipseShape.cpp.

{
    return new EllipseShape(*this);
}

References EllipseShape().

◆ createPoints()

void EllipseShape::createPoints ( int requiredPointCount )

protected

Definition at line 204 of file EllipseShape.cpp.

{
    if (subpaths().count() != 1) {
        clear();
        subpaths().append(new KoSubpath());
    }
    int currentPointCount = subpaths()[0]->count();
    if (currentPointCount > requiredPointCount) {
        for (int i = 0; i < currentPointCount - requiredPointCount; ++i) {
            delete subpaths()[0]->front();
            subpaths()[0]->pop_front();
        }
    } else if (requiredPointCount > currentPointCount) {
        for (int i = 0; i < requiredPointCount - currentPointCount; ++i) {
            subpaths()[0]->append(new KoPathPoint(this, QPointF()));
        }
    }
 
    notifyPointsChanged();
}

References KoPathShape::clear(), KoPathShape::notifyPointsChanged(), and KoPathShape::subpaths().

◆ endAngle()

qreal EllipseShape::endAngle ( ) const

Returns the actual ellipse end angle in degree.

Definition at line 310 of file EllipseShape.cpp.

{
    return m_endAngle;
}

References m_endAngle.

◆ loadSvg()

bool EllipseShape::loadSvg	(	const QDomElement &	element,
		SvgLoadingContext &	context )

overridevirtual

reimplemented from SvgShape

Reimplemented from SvgShape.

Definition at line 383 of file EllipseShape.cpp.

{
    qreal rx = 0, ry = 0;
    qreal cx = 0;
    qreal cy = 0;
    qreal start = 0;
    qreal end = 0;
    EllipseType type = Arc;
 
    const QString extendedNamespace =
            element.attribute("sodipodi:type") == "arc" ? "sodipodi" :
            element.attribute("krita:type") == "arc" ? "krita" : "";
 
    if (element.tagName() == "ellipse") {
        rx = SvgUtil::parseUnitX(context.currentGC(), context.resolvedProperties(), element.attribute("rx"));
        ry = SvgUtil::parseUnitY(context.currentGC(), context.resolvedProperties(), element.attribute("ry"));
        cx = SvgUtil::parseUnitX(context.currentGC(), context.resolvedProperties(), element.attribute("cx", "0"));
        cy = SvgUtil::parseUnitY(context.currentGC(), context.resolvedProperties(), element.attribute("cy", "0"));
    } else if (element.tagName() == "circle") {
        rx = ry = SvgUtil::parseUnitXY(context.currentGC(), context.resolvedProperties(), element.attribute("r"));
        cx = SvgUtil::parseUnitX(context.currentGC(), context.resolvedProperties(), element.attribute("cx", "0"));
        cy = SvgUtil::parseUnitY(context.currentGC(), context.resolvedProperties(), element.attribute("cy", "0"));
 
    } else if (element.tagName() == "path" && !extendedNamespace.isEmpty()) {
        rx = SvgUtil::parseUnitX(context.currentGC(), context.resolvedProperties(), element.attribute(extendedNamespace + ":rx"));
        ry = SvgUtil::parseUnitY(context.currentGC(), context.resolvedProperties(), element.attribute(extendedNamespace + ":ry"));
        cx = SvgUtil::parseUnitX(context.currentGC(), context.resolvedProperties(), element.attribute(extendedNamespace + ":cx", "0"));
        cy = SvgUtil::parseUnitY(context.currentGC(), context.resolvedProperties(), element.attribute(extendedNamespace + ":cy", "0"));
        start = 2 * M_PI - SvgUtil::parseNumber(element.attribute(extendedNamespace + ":end"));
        end = 2 * M_PI - SvgUtil::parseNumber(element.attribute(extendedNamespace + ":start"));
 
        const QString kritaArcType =
            element.attribute("sodipodi:arc-type", element.attribute("krita:arcType"));
 
        if (kritaArcType.isEmpty()) {
            if (element.attribute("sodipodi:open", "false") == "false") {
                type = Pie;
            }
        } else if (kritaArcType == "pie") {
            type = Pie;
        } else if (kritaArcType == "chord") {
            type = Chord;
        }
    } else {
        return false;
    }
 
    setSize(QSizeF(2 * rx, 2 * ry));
    setPosition(QPointF(cx - rx, cy - ry));
    if (rx == 0.0 || ry == 0.0) {
        setVisible(false);
    }
 
    if (start != 0 || start != end) {
        setStartAngle(kisRadiansToDegrees(start));
        setEndAngle(kisRadiansToDegrees(end));
        setType(type);
    }
 
    return true;
}

References Arc, Chord, SvgLoadingContext::currentGC(), kisRadiansToDegrees(), M_PI, SvgUtil::parseNumber(), SvgUtil::parseUnitX(), SvgUtil::parseUnitXY(), SvgUtil::parseUnitY(), Pie, SvgLoadingContext::resolvedProperties(), setEndAngle(), KoShape::setPosition(), setSize(), setStartAngle(), setType(), KoShape::setVisible(), and type().

◆ moveHandleAction()

void EllipseShape::moveHandleAction	(	int	handleId,
		const QPointF &	point,
		Qt::KeyboardModifiers	modifiers = Qt::NoModifier )

overrideprotectedvirtual

Updates the internal state of a KoParameterShape.

This method is called from moveHandle.

Parameters

handleId	of the handle
point	to move the handle to in shape coordinates
modifiers	used during move to point

Implements KoParameterShape.

Definition at line 80 of file EllipseShape.cpp.

{
    Q_UNUSED(modifiers);
    QPointF p(point);
 
    QPointF diff(m_center - point);
    diff.setX(-diff.x());
    qreal angle = 0;
    if (diff.x() == 0) {
        angle = (diff.y() < 0 ? 270 : 90) * M_PI / 180.0;
    } else {
        diff.setY(diff.y() * m_radii.x() / m_radii.y());
        angle = atan(diff.y() / diff.x());
        if (angle < 0) {
            angle += M_PI;
        }
 
        if (diff.y() < 0) {
            angle += M_PI;
        }
    }
 
    QList<QPointF> handles = this->handles();
    switch (handleId) {
    case 0:
        p = QPointF(m_center + QPointF(cos(angle) * m_radii.x(), -sin(angle) * m_radii.y()));
        m_startAngle = kisRadiansToDegrees(angle);
        handles[handleId] = p;
        break;
    case 1:
        p = QPointF(m_center + QPointF(cos(angle) * m_radii.x(), -sin(angle) * m_radii.y()));
        m_endAngle = kisRadiansToDegrees(angle);
        handles[handleId] = p;
        break;
    case 2: {
        QList<QPointF> kindHandlePositions;
        kindHandlePositions.push_back(QPointF(m_center + QPointF(cos(m_kindAngle) * m_radii.x(), -sin(m_kindAngle) * m_radii.y())));
        kindHandlePositions.push_back(m_center);
        kindHandlePositions.push_back((handles[0] + handles[1]) / 2.0);
 
        QPointF diff = m_center * 2.0;
        int handlePos = 0;
        for (int i = 0; i < kindHandlePositions.size(); ++i) {
            QPointF pointDiff(p - kindHandlePositions[i]);
            if (i == 0 || qAbs(pointDiff.x()) + qAbs(pointDiff.y()) < qAbs(diff.x()) + qAbs(diff.y())) {
                diff = pointDiff;
                handlePos = i;
            }
        }
        handles[handleId] = kindHandlePositions[handlePos];
        m_type = EllipseType(handlePos);
    }
    break;
    }
    setHandles(handles);
 
    if (handleId != 2) {
        updateKindHandle();
    }
}

References KoParameterShape::handles, kisRadiansToDegrees(), m_center, m_endAngle, m_kindAngle, M_PI, m_radii, m_startAngle, m_type, p, KoParameterShape::setHandles(), and updateKindHandle().

◆ normalize()

QPointF EllipseShape::normalize ( )

overridevirtual

Normalizes the path data.

The path points are transformed so that the top-left corner of the bounding rect is at (0,0). This should be called after adding points to the path or changing positions of path points.

Returns: the offset by which the points are moved in shape coordinates.

Reimplemented from KoPathShape.

Definition at line 71 of file EllipseShape.cpp.

{
    QPointF offset(KoParameterShape::normalize());
    QTransform matrix;
    matrix.translate(-offset.x(), -offset.y());
    m_center = matrix.map(m_center);
    return offset;
}

References m_center, and KoParameterShape::normalize().

◆ pathShapeId()

QString EllipseShape::pathShapeId ( ) const

overridevirtual

reimplemented

Reimplemented from KoPathShape.

Definition at line 315 of file EllipseShape.cpp.

{
    return EllipseShapeId;
}

References EllipseShapeId.

◆ saveSvg()

bool EllipseShape::saveSvg ( SvgSavingContext & context )

overridevirtual

reimplemented from SvgShape

Reimplemented from SvgShape.

Definition at line 320 of file EllipseShape.cpp.

{
    // let basic path saiving code handle our saving
    if (!isParametricShape()) return false;
 
    if (type() == EllipseShape::Arc && startAngle() == endAngle()) {
        const QSizeF size = this->size();
        const bool isCircle = size.width() == size.height();
        context.shapeWriter().startElement(isCircle ? "circle" : "ellipse");
        context.shapeWriter().addAttribute("id", context.getID(this));
        SvgUtil::writeTransformAttributeLazy("transform", transformation(), context.shapeWriter());
        SvgStyleWriter::saveMetadata(this, context);
 
        if (isCircle) {
            context.shapeWriter().addAttribute("r", 0.5 * size.width());
        } else {
            context.shapeWriter().addAttribute("rx", 0.5 * size.width());
            context.shapeWriter().addAttribute("ry", 0.5 * size.height());
        }
        context.shapeWriter().addAttribute("cx", 0.5 * size.width());
        context.shapeWriter().addAttribute("cy", 0.5 * size.height());
 
        SvgStyleWriter::saveSvgStyle(this, context);
 
        context.shapeWriter().endElement();
    } else {
        context.shapeWriter().startElement("path");
        context.shapeWriter().addAttribute("id", context.getID(this));
        SvgUtil::writeTransformAttributeLazy("transform", transformation(), context.shapeWriter());
 
        context.shapeWriter().addAttribute("sodipodi:type", "arc");
 
        context.shapeWriter().addAttribute("sodipodi:rx", m_radii.x());
        context.shapeWriter().addAttribute("sodipodi:ry", m_radii.y());
 
        context.shapeWriter().addAttribute("sodipodi:cx", m_center.x());
        context.shapeWriter().addAttribute("sodipodi:cy", m_center.y());
 
        context.shapeWriter().addAttribute("sodipodi:start", 2 * M_PI - kisDegreesToRadians(endAngle()));
        context.shapeWriter().addAttribute("sodipodi:end", 2 * M_PI - kisDegreesToRadians(startAngle()));
 
        switch (type()) {
        case Pie:
            // noop
            break;
        case Chord:
            context.shapeWriter().addAttribute("sodipodi:arc-type", "chord");
            break;
        case Arc:
            context.shapeWriter().addAttribute("sodipodi:open", "true");
            break;
        }
 
        context.shapeWriter().addAttribute("d", this->toString(context.userSpaceTransform()));
 
        SvgStyleWriter::saveSvgStyle(this, context);
 
        context.shapeWriter().endElement();
    }
 
    return true;
}

References Arc, Chord, endAngle(), SvgSavingContext::getID(), KoParameterShape::isParametricShape(), kisDegreesToRadians(), m_center, M_PI, m_radii, Pie, SvgStyleWriter::saveMetadata(), SvgStyleWriter::saveSvgStyle(), SvgSavingContext::shapeWriter, KoPathShape::size(), startAngle(), KoPathShape::toString(), KoShape::transformation(), type(), SvgSavingContext::userSpaceTransform(), and SvgUtil::writeTransformAttributeLazy().

◆ setEndAngle()

void EllipseShape::setEndAngle ( qreal angle )

Sets the end angle of the ellipse.

Parameters

angle the new end angle in degree

Definition at line 302 of file EllipseShape.cpp.

{
    m_endAngle = angle;
    updateKindHandle();
    updateAngleHandles();
    updatePath(size());
}

References m_endAngle, KoPathShape::size(), updateAngleHandles(), updateKindHandle(), and updatePath().

◆ setSize()

void EllipseShape::setSize ( const QSizeF & size )

overridevirtual

Resize the shape.

Parameters

size the new size of the shape. This is different from scaling as scaling is a so called secondary operation which is comparable to zooming in instead of changing the size of the basic shape. Easiest example of this difference is that using this method will not distort the size of pattern-fills and strokes.

Reimplemented from KoShape.

Definition at line 63 of file EllipseShape.cpp.

{
    QTransform matrix(resizeMatrix(newSize));
    m_center = matrix.map(m_center);
    m_radii = matrix.map(m_radii);
    KoParameterShape::setSize(newSize);
}

References m_center, m_radii, KoPathShape::resizeMatrix(), and KoParameterShape::setSize().

◆ setStartAngle()

void EllipseShape::setStartAngle ( qreal angle )

Sets the start angle of the ellipse.

Parameters

angle the new start angle in degree

Definition at line 289 of file EllipseShape.cpp.

{
    m_startAngle = angle;
    updateKindHandle();
    updateAngleHandles();
    updatePath(size());
}

References m_startAngle, KoPathShape::size(), updateAngleHandles(), updateKindHandle(), and updatePath().

◆ setType()

void EllipseShape::setType ( EllipseType type )

Sets the type of the ellipse.

Parameters

type	the new ellipse type

Definition at line 277 of file EllipseShape.cpp.

{
    m_type = type;
    updateKindHandle();
    updatePath(size());
}

References m_type, KoPathShape::size(), type(), updateKindHandle(), and updatePath().

◆ startAngle()

qreal EllipseShape::startAngle ( ) const

Returns the actual ellipse start angle in degree.

Definition at line 297 of file EllipseShape.cpp.

{
    return m_startAngle;
}

References m_startAngle.

◆ sweepAngle()

qreal EllipseShape::sweepAngle ( ) const

private

Definition at line 259 of file EllipseShape.cpp.

{
    const qreal a1 = normalizeAngle(kisDegreesToRadians(m_startAngle));
    const qreal a2 = normalizeAngle(kisDegreesToRadians(m_endAngle));
 
    qreal sAngle = a2 - a1;
 
    if (a1 > a2) {
        sAngle = 2 * M_PI + sAngle;
    }
 
    if (qAbs(a1 - a2) < 0.05 / M_PI) {
        sAngle = 2 * M_PI;
    }
 
    return kisRadiansToDegrees(sAngle);
}

References kisDegreesToRadians(), kisRadiansToDegrees(), m_endAngle, M_PI, m_startAngle, and normalizeAngle().

◆ type()

EllipseShape::EllipseType EllipseShape::type ( ) const

Returns the actual ellipse type.

Definition at line 284 of file EllipseShape.cpp.

{
    return m_type;
}

References m_type.

◆ updateAngleHandles()

void EllipseShape::updateAngleHandles ( )

private

Definition at line 249 of file EllipseShape.cpp.

{
    qreal startRadian = kisDegreesToRadians(normalizeAngleDegrees(m_startAngle));
    qreal endRadian = kisDegreesToRadians(normalizeAngleDegrees(m_endAngle));
    QList<QPointF> handles = this->handles();
    handles[0] = m_center + QPointF(cos(startRadian) * m_radii.x(), -sin(startRadian) * m_radii.y());
    handles[1] = m_center + QPointF(cos(endRadian) * m_radii.x(), -sin(endRadian) * m_radii.y());
    setHandles(handles);
}

References KoParameterShape::handles, kisDegreesToRadians(), m_center, m_endAngle, m_radii, m_startAngle, normalizeAngleDegrees(), and KoParameterShape::setHandles().

◆ updateKindHandle()

void EllipseShape::updateKindHandle ( )

private

Definition at line 225 of file EllipseShape.cpp.

{
    qreal angle = 0.5 * (m_startAngle + m_endAngle);
    if (m_startAngle > m_endAngle) {
        angle += 180.0;
    }
 
    m_kindAngle = normalizeAngle(kisDegreesToRadians(angle));
 
    QList<QPointF> handles = this->handles();
    switch (m_type) {
    case Arc:
        handles[2] = m_center + QPointF(cos(m_kindAngle) * m_radii.x(), -sin(m_kindAngle) * m_radii.y());
        break;
    case Pie:
        handles[2] = m_center;
        break;
    case Chord:
        handles[2] = (handles[0] + handles[1]) / 2.0;
        break;
    }
    setHandles(handles);
}

References Arc, Chord, KoParameterShape::handles, kisDegreesToRadians(), m_center, m_endAngle, m_kindAngle, m_radii, m_startAngle, m_type, normalizeAngle(), Pie, and KoParameterShape::setHandles().

◆ updatePath()

void EllipseShape::updatePath ( const QSizeF & size )

overrideprotectedvirtual

Update the path of the parameter shape.

Parameters

size	of the shape

Implements KoParameterShape.

Definition at line 141 of file EllipseShape.cpp.

{
    Q_UNUSED(size);
    QPointF startpoint(handles()[0]);
 
    QPointF curvePoints[12];
    const qreal distance = sweepAngle();
 
    const bool sameAngles = distance > 359.9;
    int pointCnt = arcToCurve(m_radii.x(), m_radii.y(), m_startAngle, distance, startpoint, curvePoints);
    KIS_SAFE_ASSERT_RECOVER_RETURN(pointCnt);
 
    int curvePointCount = 1 + pointCnt / 3;
    int requiredPointCount = curvePointCount;
    if (m_type == Pie) {
        requiredPointCount++;
    } else if (m_type == Arc && sameAngles) {
        curvePointCount--;
        requiredPointCount--;
    }
 
    createPoints(requiredPointCount);
 
    KoSubpath &points = *subpaths()[0];
 
    int curveIndex = 0;
    points[0]->setPoint(startpoint);
    points[0]->removeControlPoint1();
    points[0]->setProperty(KoPathPoint::StartSubpath);
    for (int i = 1; i < curvePointCount; ++i) {
        points[i - 1]->setControlPoint2(curvePoints[curveIndex++]);
        points[i]->setControlPoint1(curvePoints[curveIndex++]);
        points[i]->setPoint(curvePoints[curveIndex++]);
        points[i]->removeControlPoint2();
    }
 
    if (m_type == Pie) {
        points[requiredPointCount - 1]->setPoint(m_center);
        points[requiredPointCount - 1]->removeControlPoint1();
        points[requiredPointCount - 1]->removeControlPoint2();
    } else if (m_type == Arc && sameAngles) {
        points[curvePointCount - 1]->setControlPoint2(curvePoints[curveIndex]);
        points[0]->setControlPoint1(curvePoints[++curveIndex]);
    }
 
    for (int i = 0; i < requiredPointCount; ++i) {
        points[i]->unsetProperty(KoPathPoint::StopSubpath);
        points[i]->unsetProperty(KoPathPoint::CloseSubpath);
    }
    subpaths()[0]->last()->setProperty(KoPathPoint::StopSubpath);
    if (m_type == Arc && !sameAngles) {
        subpaths()[0]->first()->unsetProperty(KoPathPoint::CloseSubpath);
        subpaths()[0]->last()->unsetProperty(KoPathPoint::CloseSubpath);
    } else {
        subpaths()[0]->first()->setProperty(KoPathPoint::CloseSubpath);
        subpaths()[0]->last()->setProperty(KoPathPoint::CloseSubpath);
    }
 
    notifyPointsChanged();
 
    normalize();
}

References Arc, KoPathShape::arcToCurve(), KoPathPoint::CloseSubpath, createPoints(), distance(), KoParameterShape::handles, KIS_SAFE_ASSERT_RECOVER_RETURN, m_center, m_radii, m_startAngle, m_type, normalize(), KoPathShape::notifyPointsChanged(), Pie, KoPathShape::size(), KoPathPoint::StartSubpath, KoPathPoint::StopSubpath, KoPathShape::subpaths(), and sweepAngle().

Member Data Documentation

◆ m_center

QPointF EllipseShape::m_center

private

Definition at line 97 of file EllipseShape.h.

◆ m_endAngle

qreal EllipseShape::m_endAngle

private

Definition at line 93 of file EllipseShape.h.

◆ m_kindAngle

qreal EllipseShape::m_kindAngle

private

Definition at line 95 of file EllipseShape.h.

◆ m_radii

QPointF EllipseShape::m_radii

private

Definition at line 99 of file EllipseShape.h.

◆ m_startAngle

qreal EllipseShape::m_startAngle

private

Definition at line 91 of file EllipseShape.h.

◆ m_type

EllipseType EllipseShape::m_type

private

Definition at line 101 of file EllipseShape.h.

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

plugins/flake/pathshapes/ellipse/EllipseShape.h
plugins/flake/pathshapes/ellipse/EllipseShape.cpp

Public Types

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ EllipseType

Constructor & Destructor Documentation

◆ EllipseShape() [1/2]

◆ ~EllipseShape()

◆ EllipseShape() [2/2]

Member Function Documentation

◆ cloneShape()

◆ createPoints()

◆ endAngle()

◆ loadSvg()

◆ moveHandleAction()

◆ normalize()

◆ pathShapeId()

◆ saveSvg()

◆ setEndAngle()

◆ setSize()

◆ setStartAngle()

◆ setType()

◆ startAngle()

◆ sweepAngle()

◆ type()

◆ updateAngleHandles()

◆ updateKindHandle()

◆ updatePath()

Member Data Documentation

◆ m_center

◆ m_endAngle

◆ m_kindAngle

◆ m_radii

◆ m_startAngle

◆ m_type