#include <ipeobject.h>

Inherited by ipe::Group, ipe::Image, ipe::Path, ipe::Reference, and ipe::Text.

Public Types
enum	Type { EGroup , EPath , EText , EImage , EReference }

Public Member Functions
virtual	~Object ()=0

virtual void	accept (Visitor &visitor) const =0

virtual Object *	clone () const =0

virtual Group *	asGroup ()

virtual const Group *	asGroup () const

virtual Text *	asText ()

virtual Path *	asPath ()

virtual Image *	asImage ()

virtual Reference *	asReference ()

virtual Type	type () const =0

virtual TPinned	pinned () const

void	setPinned (TPinned pin)

TTransformations	transformations () const

void	setTransformations (TTransformations trans)

virtual void	setMatrix (const Matrix &matrix)

const Matrix &	matrix () const

virtual bool	setAttribute (Property prop, Attribute value)

virtual Attribute	getAttribute (Property prop) const noexcept

void	setCustom (Attribute value)

Attribute	getCustom () const noexcept

virtual void	saveAsXml (Stream &stream, String layer) const =0

virtual void	draw (Painter &painter) const =0

virtual void	drawSimple (Painter &painter) const =0

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

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

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

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

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

virtual void	checkStyle (const Cascade *sheet, AttributeSeq &seq) const

Protected Member Functions
	Object ()

	Object (const AllAttributes &attr)

	Object (const Object &rhs)

	Object (const XmlAttributes &attr)

void	saveAttributesAsXml (Stream &stream, String layer) const

Matrix	effectiveMatrix (const Matrix &m, const Vector &pos=Vector::ZERO) const noexcept

Static Protected Member Functions
static void	checkSymbol (Kind kind, Attribute attr, const Cascade *sheet, AttributeSeq &seq)

Protected Attributes
Matrix	iMatrix

Attribute	iCustom

TPinned	iPinned: 8

TTransformations	iTransformations: 8

Detailed Description

Base class for all Ipe objects, composite or leaf.

All objects are derived from this class. It provides functionality common to all objects, and carries the standard attributes.

All Object's provide a constant time copy constructor (and a virtual Object::clone() method). Objects of non-constant size realize this by separating the implementation and using reference counting. In particular, copying a composite object does not create new copies of the components.

Object has only three attributes: the transformation matrix, the pinning status, and the allowed transformations.

If an object is pinned, it cannot be moved at all (or only in the non-pinned direction) from the Ipe user interface.

Restricting the allowed transformations works somewhat differently: It doesn't stop transformations being applied to the object, but they only effect the position of the reference point (the origin of the object coordinate system), and (if transformations() == ETransformationsRigidMotions) the orientation of the object coordinate system.

Member Enumeration Documentation

◆ Type

enum ipe::Object::Type

Enumerator
EGroup
EPath
EText
EImage
EReference

Constructor & Destructor Documentation

◆ ~Object()

Object::~Object ( )

pure virtual

Pure virtual destructor.

◆ Object() [1/4]

Object::Object ( )

explicitprotected

Create object with identity matrix, no pinning, all transformations.

References ipe::ENoPin, ipe::ETransformationsAffine, iCustom, iPinned, iTransformations, and ipe::Attribute::UNDEFINED().

◆ Object() [2/4]

Object::Object ( const AllAttributes & attr )

explicitprotected

Create object by taking pinning/transforming from attr and setting identity matrix.

References iCustom, ipe::AllAttributes::iPinned, iPinned, ipe::AllAttributes::iTransformations, iTransformations, and ipe::Attribute::UNDEFINED().

◆ Object() [3/4]

Object::Object ( const Object & rhs )

protected

Copy constructor.

References iCustom, iMatrix, iPinned, and iTransformations.

◆ Object() [4/4]

Object::Object ( const XmlAttributes & attr )

explicitprotected

Construct from XML stream.

References ipe::EFixedPin, ipe::EHorizontalPin, ipe::String::empty(), ipe::ENoPin, ipe::ETransformationsAffine, ipe::ETransformationsRigidMotions, ipe::ETransformationsTranslations, ipe::EVerticalPin, ipe::XmlAttributes::has(), iCustom, iMatrix, iPinned, iTransformations, and ipe::Attribute::UNDEFINED().

Member Function Documentation

◆ accept()

virtual void ipe::Object::accept ( Visitor & visitor ) const

pure virtual

Calls visitXXX method of the visitor.

Implemented in ipe::Path, ipe::Image, ipe::Text, ipe::Reference, and ipe::Group.

Referenced by ipe::PdfWriter::createPageView(), ipe::Document::findBitmaps(), ipe::PdfWriter::PdfWriter(), ipe::Latex::scanObject(), ipe::BitmapFinder::scanPage(), and ipe::Latex::scanPage().

◆ clone()

virtual Object* ipe::Object::clone ( ) const

pure virtual

Make a copy of this object (constant-time).

Implemented in ipe::Path, ipe::Image, ipe::Text, ipe::Reference, and ipe::Group.

Referenced by ipe::Symbol::operator=(), and ipe::Symbol::Symbol().

◆ asGroup() [1/2]

Group * Object::asGroup ( )

virtual

Return pointer to this object if it is an Group, nullptr otherwise.

Reimplemented in ipe::Group.

Referenced by ipe::PdfWriter::createPageView().

◆ asGroup() [2/2]

const Group * Object::asGroup ( ) const

virtual

Return pointer to this object if it is an Group, nullptr otherwise.

Reimplemented in ipe::Group.

◆ asText()

Text * Object::asText ( )

virtual

Return pointer to this object if it is an Text, nullptr otherwise.

Reimplemented in ipe::Text.

◆ asPath()

Path * Object::asPath ( )

virtual

Return pointer to this object if it is an Path, nullptr otherwise.

Reimplemented in ipe::Path.

◆ asImage()

Image * Object::asImage ( )

virtual

Return pointer to this object if it is an Image , nullptr otherwise.

Reimplemented in ipe::Image.

◆ asReference()

Reference * Object::asReference ( )

virtual

Return pointer to this object if it is an Ref, nullptr otherwise.

Reimplemented in ipe::Reference.

◆ type()

virtual Type ipe::Object::type ( ) const

pure virtual

Implemented in ipe::Path, ipe::Image, ipe::Text, ipe::Reference, and ipe::Group.

◆ pinned()

TPinned Object::pinned ( ) const

virtual

Return pinning mode of the object.

Reimplemented in ipe::Group.

References iPinned.

Referenced by ipe::Group::pinned(), ipe::Group::push_back(), and ipe::TransformTool::TransformTool().

◆ setPinned()

void Object::setPinned ( TPinned pin )

Set pinning mode of the object.

References iPinned.

◆ transformations()

TTransformations ipe::Object::transformations ( ) const

inline

Return allowed transformations of the object.

References iTransformations.

Referenced by ipe::Group::draw(), ipe::Reference::draw(), ipe::Text::draw(), ipe::Image::draw(), ipe::Path::draw(), ipe::Group::drawSimple(), ipe::Text::drawSimple(), ipe::Image::drawSimple(), ipe::Path::drawSimple(), and ipe::Text::setAttribute().

◆ setTransformations()

void Object::setTransformations ( TTransformations trans )

Set allowed transformations of the object.

References iTransformations.

Referenced by ipe::Text::setAttribute().

◆ setMatrix()

void Object::setMatrix ( const Matrix & matrix )

virtual

Set the transformation matrix.

Don't use this on an Object in a Page, because it wouldn't invalidate its bounding box. Call Page::transform instead.

Reimplemented in ipe::Path.

References iMatrix, and matrix().

Referenced by ipe::Page::applyTitleStyle(), ipe::Path::setMatrix(), and ipe::Page::transform().

◆ matrix()

const Matrix& ipe::Object::matrix ( ) const

inline

Return transformation matrix.

References iMatrix.

Referenced by ipe::Reference::addToBBox(), ipe::Reference::distance(), ipe::Group::draw(), ipe::Reference::draw(), ipe::Text::draw(), ipe::Image::draw(), ipe::Path::draw(), ipe::Group::drawSimple(), ipe::Reference::drawSimple(), ipe::Text::drawSimple(), ipe::Image::drawSimple(), ipe::Path::drawSimple(), setMatrix(), ipe::Path::setMatrix(), ipe::Text::snapCtl(), and ipe::Reference::snapVtx().

◆ setAttribute()

bool Object::setAttribute	(	Property	prop,
		Attribute	value
	)

virtual

Set an attribute on this object.

Returns true if an attribute was actually changed.

Reimplemented in ipe::Path, ipe::Image, ipe::Text, ipe::Reference, and ipe::Group.

References ipe::EPropPinned, ipe::EPropTransformations, iPinned, ipe::Attribute::isEnum(), iTransformations, ipe::Attribute::pinned(), and ipe::Attribute::transformations().

Referenced by ipe::Page::setAttribute(), ipe::Group::setAttribute(), ipe::Reference::setAttribute(), ipe::Text::setAttribute(), ipe::Image::setAttribute(), and ipe::Path::setAttribute().

◆ getAttribute()

Attribute Object::getAttribute ( Property prop ) const

virtualnoexcept

Get setting of an attribute of this object.

If object does not have this attribute, returnes "undefined" attribute.

Reimplemented in ipe::Path, ipe::Image, ipe::Text, ipe::Reference, and ipe::Group.

References ipe::EPropPinned, ipe::EPropTransformations, and ipe::Attribute::UNDEFINED().

Referenced by ipe::Group::getAttribute(), ipe::Reference::getAttribute(), ipe::Text::getAttribute(), ipe::Image::getAttribute(), and ipe::Path::getAttribute().

◆ setCustom()

void Object::setCustom ( Attribute value )

Set the 'custom' attribute (not used by Ipe, for users and ipelets)

References iCustom, and ipe::Attribute::isString().

◆ getCustom()

Attribute Object::getCustom ( ) const

noexcept

Return value of the 'custom' attribute.

References iCustom.

◆ saveAsXml()

virtual void ipe::Object::saveAsXml	(	Stream &	stream,
		String	layer
	)		const

pure virtual

Save the object in XML format.

Implemented in ipe::Path, ipe::Image, ipe::Text, ipe::Reference, and ipe::Group.

◆ draw()

virtual void ipe::Object::draw ( Painter & painter ) const

pure virtual

Draw the object.

Implemented in ipe::Path, ipe::Image, ipe::Text, ipe::Reference, and ipe::Group.

Referenced by ipe::Painter::doDrawSymbol(), ipe::PdfPainter::doDrawSymbol(), ipe::Path::drawArrow(), ipe::CanvasBase::drawObjects(), ipe::PdfWriter::PdfWriter(), ipe::Thumbnail::render(), and ipe::Thumbnail::saveRender().

◆ drawSimple()

virtual void ipe::Object::drawSimple ( Painter & painter ) const

pure virtual

Draw simple version for selecting and transforming.

Implemented in ipe::Path, ipe::Image, ipe::Text, ipe::Reference, and ipe::Group.

Referenced by ipe::PanTool::draw(), ipe::SelectTool::draw(), ipe::TransformTool::draw(), ipe::Reference::drawSimple(), and ipe::CanvasBase::drawTool().

◆ distance()

virtual double ipe::Object::distance	(	const Vector &	v,
		const Matrix &	m,
		double	bound
	)		const

pure virtual

Return distance of transformed object to point v. If larger than bound, can just return bound.

Implemented in ipe::Path, ipe::Image, ipe::Text, ipe::Reference, and ipe::Group.

Referenced by ipe::Page::distance().

◆ addToBBox()

virtual void ipe::Object::addToBBox	(	Rect &	box,
		const Matrix &	m,
		bool	cp
	)		const

pure virtual

Extend box to include the object transformed by m.

For objects in a page, don't call this directly. The Page caches the bounding box of each object, so it is far more efficient to call Page::bbox.

Control points that lie outside the visual object are included if cp is true.

If called with an empty box and cp == false, the result of this function is a tight bounding box for the object, with a little leeway in case the boundary is determined by a spline (it has to be approximated to perform this operation).

Implemented in ipe::Image, ipe::Text, ipe::Path, ipe::Reference, and ipe::Group.

Referenced by ipe::SelectTool::mouseButton().