Part::Geometry Class Reference

#include <Geometry.h>

Public Member Functions
Geometry *	clone (void) const
	returns a cloned object. More...
virtual Geometry *	copy (void) const =0
	returns a copy of this object having a new randomly generated tag. More...
void	deleteExtension (Base::Type type)
void	deleteExtension (std::string name)
const std::weak_ptr< GeometryExtension >	getExtension (Base::Type type) const
const std::weak_ptr< GeometryExtension >	getExtension (std::string name) const
const std::vector< std::weak_ptr< GeometryExtension > >	getExtensions () const
virtual unsigned int	getMemSize (void) const
	This method is used to get the size of objects It is not meant to have the exact size, it is more or less an estimation which runs fast! Is it two bytes or a GB? More...
boost::uuids::uuid	getTag () const
	returns the tag of the geometry object More...
virtual const	Handle (Geom_Geometry) &handle() const =0
bool	hasExtension (Base::Type type) const
bool	hasExtension (std::string name) const
virtual void	Restore (Base::XMLReader &)
	This method is used to restore properties from an XML document. More...
virtual void	Save (Base::Writer &) const
	This method is used to save properties to an XML document. More...
void	setExtension (std::unique_ptr< GeometryExtension > &&geo)
virtual TopoDS_Shape	toShape () const =0
virtual	~Geometry ()
Public Member Functions inherited from Base::Persistence
void	dumpToStream (std::ostream &stream, int compression)
virtual Base::Type	getTypeId (void) const
virtual void	RestoreDocFile (Reader &)
	This method is used to restore large amounts of data from a file In this method you simply stream in your SaveDocFile() saved data. More...
void	restoreFromStream (std::istream &stream)
virtual void	SaveDocFile (Writer &) const
	This method is used to save large amounts of data to a binary file. More...
Public Member Functions inherited from Base::BaseClass
	BaseClass ()
	Construction. More...
virtual PyObject *	getPyObject (void)
	This method returns the Python wrapper for a C++ object. More...
bool	isDerivedFrom (const Type type) const
virtual void	setPyObject (PyObject *)
virtual	~BaseClass ()
	Destruction. More...

Public Attributes
bool	Construction
	construction geometry (means no impact on a later built topo) Note: In the Sketcher and only for the specific case of a point, it has a special meaning: a construction point has fixed coordinates for the solver (it has fixed parameters) More...

Protected Member Functions
void	assignTag (const Part::Geometry *)
	copies the tag from the geometry passed as a parameter to this object More...
void	createNewTag ()
	create a new tag for the geometry object More...
	Geometry ()

Protected Attributes
std::vector< std::shared_ptr< GeometryExtension > >	extensions
boost::uuids::uuid	tag

Additional Inherited Members
Static Public Member Functions inherited from Base::Persistence
static void *	create (void)
static std::string	encodeAttribute (const std::string &)
	Encodes an attribute upon saving. More...
static Base::Type	getClassTypeId (void)
static void	init (void)
Static Public Member Functions inherited from Base::BaseClass
static void *	create (void)
static Type	getClassTypeId (void)
static void	init (void)
Static Protected Member Functions inherited from Base::BaseClass
static void	initSubclass (Base::Type &toInit, const char *ClassName, const char *ParentName, Type::instantiationMethod method=nullptr)

Constructor & Destructor Documentation

~Geometry()

Geometry::~Geometry ( )

virtual

Geometry()

Geometry::Geometry ( )

protected

Member Function Documentation

assignTag()

void Geometry::assignTag ( const Part::Geometry *  geo )

protected

copies the tag from the geometry passed as a parameter to this object

References Base::Persistence::getTypeId(), and tag.

clone()

Geometry * Geometry::clone

(

void

)

const

returns a cloned object.

A cloned object has the same tag (see getTag) as the original object. if you want a copy not having the same tag, you can use copy() instead. If you want a clone with another geometry handle, it is possible to clone an object and then assign another handle or to create an object via constructor and use assignTag to assign the tag of the other geometry. If you do not desire to have the same tag, then a copy can be performed by using a constructor (which will generate another tag) and then, if necessary (e.g. if the constructor did not take a handle as a parameter), set a new handle.

References copy(), extensions, and tag.

Referenced by ArchPanel.CommandPanelSheet::Activated(), Sketcher::Sketch::addArc(), Sketcher::Sketch::addArcOfEllipse(), Sketcher::Sketch::addArcOfHyperbola(), Sketcher::Sketch::addArcOfParabola(), Sketcher::Sketch::addCircle(), Sketcher::Sketch::addEllipse(), Sketcher::Sketch::addLineSegment(), Part::GeometryPy::clone(), Part::GeomBezierCurve::getPyObject(), Part::GeomBSplineCurve::getPyObject(), Part::GeomCircle::getPyObject(), Part::GeomArcOfCircle::getPyObject(), Part::GeomEllipse::getPyObject(), Part::GeomArcOfEllipse::getPyObject(), Part::GeomHyperbola::getPyObject(), Part::GeomArcOfHyperbola::getPyObject(), Part::GeomParabola::getPyObject(), Part::GeomArcOfParabola::getPyObject(), Part::GeomLineSegment::getPyObject(), Part::GeomOffsetCurve::getPyObject(), Part::GeomBezierSurface::getPyObject(), Part::GeomBSplineSurface::getPyObject(), Part::GeomCylinder::getPyObject(), Part::GeomCone::getPyObject(), Part::GeomSphere::getPyObject(), Part::GeomToroid::getPyObject(), Part::GeomPlane::getPyObject(), Part::GeomOffsetSurface::getPyObject(), Part::GeomPlateSurface::getPyObject(), Part::GeomSurfaceOfRevolution::getPyObject(), Part::GeomSurfaceOfExtrusion::getPyObject(), Mod.PartDesign.WizardShaft.SegmentFunction.SegmentFunction::integrated(), Sketcher::SketchObject::modifyBSplineKnotMultiplicity(), and Part::PropertyGeometryList::setValue().

copy()

virtual Geometry* Part::Geometry::copy ( void  ) const

pure virtual

returns a copy of this object having a new randomly generated tag.

If you also want to copy the tag, you may use clone() instead. For creation of geometry with other handles, with or without the same tag, you may use the constructors and the sethandle functions. The tag of a geometry can be copied to another geometry using the assignTag function.

Implemented in Part::GeomArcOfConic, Part::GeomConic, Part::GeomSurfaceOfExtrusion, Part::GeomSurfaceOfRevolution, Part::GeomTrimmedSurface, Part::GeomPlateSurface, Part::GeomOffsetSurface, Part::GeomPlane, Part::GeomToroid, Part::GeomSphere, Part::GeomCone, Part::GeomCylinder, Part::GeomBSplineSurface, Part::GeomBezierSurface, Part::GeomOffsetCurve, Part::GeomLineSegment, Part::GeomLine, Part::GeomArcOfParabola, Part::GeomParabola, Part::GeomArcOfHyperbola, Part::GeomHyperbola, Part::GeomArcOfEllipse, Part::GeomEllipse, Part::GeomArcOfCircle, Part::GeomCircle, Part::GeomTrimmedCurve, Part::GeomBSplineCurve, Part::GeomBezierCurve, and Part::GeomPoint.

Referenced by Sketcher::SketchObject::addCopy(), Sketcher::SketchObject::addGeometry(), Sketcher::SketchObject::addSymmetric(), Sketcher::SketchObject::carbonCopy(), clone(), and Part::GeometryPy::copy().

createNewTag()

void Geometry::createNewTag ( )

protected

create a new tag for the geometry object

References tag.

deleteExtension() [1/2]

void Geometry::deleteExtension

(

Base::Type

type

)

References extensions.

Referenced by Part::GeometryPy::deleteExtensionOfName(), and Part::GeometryPy::deleteExtensionOfType().

deleteExtension() [2/2]

void Geometry::deleteExtension

(

std::string

name

)

References extensions.

getExtension() [1/2]

const std::weak_ptr< GeometryExtension > Geometry::getExtension

(

Base::Type

type

)

const

References extensions.

getExtension() [2/2]

const std::weak_ptr< GeometryExtension > Geometry::getExtension

(

std::string

name

)

const

References extensions.

getExtensions()

const std::vector< std::weak_ptr< GeometryExtension > > Geometry::getExtensions

(

)

const

References extensions.

Referenced by Part::GeometryPy::getExtensions().

getMemSize()

unsigned int Geometry::getMemSize ( void  ) const

virtual

This method is used to get the size of objects It is not meant to have the exact size, it is more or less an estimation which runs fast! Is it two bytes or a GB?

Implements Base::Persistence.

Reimplemented in Part::GeomArcOfConic, Part::GeomConic, Part::GeomSurfaceOfExtrusion, Part::GeomSurfaceOfRevolution, Part::GeomTrimmedSurface, Part::GeomPlateSurface, Part::GeomOffsetSurface, Part::GeomPlane, Part::GeomToroid, Part::GeomSphere, Part::GeomCone, Part::GeomCylinder, Part::GeomBSplineSurface, Part::GeomBezierSurface, Part::GeomOffsetCurve, Part::GeomLineSegment, Part::GeomLine, Part::GeomArcOfParabola, Part::GeomParabola, Part::GeomArcOfHyperbola, Part::GeomHyperbola, Part::GeomArcOfEllipse, Part::GeomEllipse, Part::GeomArcOfCircle, Part::GeomCircle, Part::GeomTrimmedCurve, Part::GeomBSplineCurve, Part::GeomBezierCurve, and Part::GeomPoint.

getTag()

boost::uuids::uuid Geometry::getTag

(

)

const

returns the tag of the geometry object

References tag.

Handle()

virtual const Part::Geometry::Handle ( Geom_Geometry  ) const &

pure virtual

Implemented in Part::GeomArcOfConic, Part::GeomConic, Part::GeomSurfaceOfExtrusion, Part::GeomSurfaceOfRevolution, Part::GeomTrimmedSurface, Part::GeomPlateSurface, Part::GeomOffsetSurface, Part::GeomPlane, Part::GeomToroid, Part::GeomSphere, Part::GeomCone, Part::GeomCylinder, Part::GeomBSplineSurface, Part::GeomBezierSurface, Part::GeomOffsetCurve, Part::GeomLineSegment, Part::GeomLine, Part::GeomArcOfParabola, Part::GeomParabola, Part::GeomArcOfHyperbola, Part::GeomHyperbola, Part::GeomArcOfEllipse, Part::GeomEllipse, Part::GeomArcOfCircle, Part::GeomCircle, Part::GeomTrimmedCurve, Part::GeomBSplineCurve, Part::GeomBezierCurve, and Part::GeomPoint.

Referenced by Part::GeomCurve::closestParameter(), Part::GeomCurve::closestParameterToBasisCurve(), Part::GeomSurface::curvature(), Part::GeomCurve::curvatureAt(), Part::GeomSurface::curvatureDirections(), Part::GeomCurve::firstDerivativeAtParameter(), Part::GeomBoundedCurve::getEndPoint(), Part::GeomCurve::getFirstParameter(), Part::GeomCurve::getLastParameter(), Part::GeomBoundedCurve::getStartPoint(), Part::GeomCurve::intersect(), Part::GeomSurface::isUmbillic(), Part::GeomCurve::length(), Part::GeomSurface::normal(), Part::GeomCurve::normalAt(), Part::GeomCurve::pointAtParameter(), Part::GeomCurve::reverse(), Part::GeomCurve::secondDerivativeAtParameter(), Part::GeomCurve::tangent(), Part::GeomSurface::tangentU(), Part::GeomSurface::tangentV(), Part::GeomCurve::toBSpline(), Part::GeomCurve::toShape(), and Part::GeomSurface::toShape().

hasExtension() [1/2]

bool Geometry::hasExtension

(

Base::Type

type

)

const

References extensions.

hasExtension() [2/2]

bool Geometry::hasExtension

(

std::string

name

)

const

References extensions.

Restore()

void Geometry::Restore ( Base::XMLReader &  )

virtual

This method is used to restore properties from an XML document.

It uses the XMLReader class, which bases on SAX, to read the in Save() written information. Again the Vector as an example:

void PropertyVector::Restore(Base::XMLReader &reader)
{
  // read my Element
  reader.readElement("PropertyVector");
  // get the value of my Attribute
  _cVec.x = reader.getAttributeAsFloat("valueX");
  _cVec.y = reader.getAttributeAsFloat("valueY");
  _cVec.z = reader.getAttributeAsFloat("valueZ");
}

Implements Base::Persistence.

Reimplemented in Part::GeomSurfaceOfExtrusion, Part::GeomSurfaceOfRevolution, Part::GeomTrimmedSurface, Part::GeomPlateSurface, Part::GeomOffsetSurface, Part::GeomPlane, Part::GeomToroid, Part::GeomSphere, Part::GeomCone, Part::GeomCylinder, Part::GeomBSplineSurface, Part::GeomBezierSurface, Part::GeomOffsetCurve, Part::GeomLineSegment, Part::GeomLine, Part::GeomArcOfParabola, Part::GeomParabola, Part::GeomArcOfHyperbola, Part::GeomHyperbola, Part::GeomArcOfEllipse, Part::GeomEllipse, Part::GeomArcOfCircle, Part::GeomCircle, Part::GeomTrimmedCurve, Part::GeomBSplineCurve, Part::GeomBezierCurve, and Part::GeomPoint.

References Construction, extensions, Base::Type::fromName(), Base::XMLReader::getAttribute(), Base::XMLReader::getAttributeAsInteger(), Base::XMLReader::localName(), Base::XMLReader::readElement(), Base::XMLReader::readEndElement(), and Part::GeometryExtension::Restore().

Referenced by Part::PropertyGeometryList::Restore(), Part::GeomPoint::Restore(), Part::GeomBSplineCurve::Restore(), Part::GeomCircle::Restore(), Part::GeomArcOfCircle::Restore(), Part::GeomEllipse::Restore(), Part::GeomArcOfEllipse::Restore(), Part::GeomHyperbola::Restore(), Part::GeomArcOfHyperbola::Restore(), Part::GeomParabola::Restore(), Part::GeomArcOfParabola::Restore(), Part::GeomLine::Restore(), and Part::GeomLineSegment::Restore().

Save()

void Geometry::Save ( Base::Writer &  ) const

virtual

This method is used to save properties to an XML document.

A good example you'll find in PropertyStandard.cpp, e.g. the vector:

void PropertyVector::Save (Writer &writer) const
{
   writer << writer.ind() << "<PropertyVector valueX=\"" <<  _cVec.x <<
                                          "\" valueY=\"" <<  _cVec.y <<
                                          "\" valueZ=\"" <<  _cVec.z <<"\"/>" << endl;
}

The writer.ind() expression writes the indentation, just for pretty printing of the XML. As you see, the writing of the XML document is not done with a DOM implementation because of performance reasons. Therefore the programmer has to take care that a valid XML document is written. This means closing tags and writing UTF-8.

See also

Base::Writer

Implements Base::Persistence.

Reimplemented in Part::GeomSurfaceOfExtrusion, Part::GeomSurfaceOfRevolution, Part::GeomTrimmedSurface, Part::GeomPlateSurface, Part::GeomOffsetSurface, Part::GeomPlane, Part::GeomToroid, Part::GeomSphere, Part::GeomCone, Part::GeomCylinder, Part::GeomBSplineSurface, Part::GeomBezierSurface, Part::GeomOffsetCurve, Part::GeomLineSegment, Part::GeomLine, Part::GeomArcOfParabola, Part::GeomParabola, Part::GeomArcOfHyperbola, Part::GeomHyperbola, Part::GeomArcOfEllipse, Part::GeomEllipse, Part::GeomArcOfCircle, Part::GeomCircle, Part::GeomTrimmedCurve, Part::GeomBSplineCurve, Part::GeomBezierCurve, and Part::GeomPoint.

References Construction, Base::Writer::decInd(), extensions, Base::Writer::incInd(), Base::Writer::ind(), and Base::Writer::Stream().

Referenced by Part::GeomPoint::Save(), Part::GeomBSplineCurve::Save(), Part::GeomCircle::Save(), Part::GeomArcOfCircle::Save(), Part::GeomEllipse::Save(), Part::GeomArcOfEllipse::Save(), Part::GeomHyperbola::Save(), Part::GeomArcOfHyperbola::Save(), Part::GeomParabola::Save(), Part::GeomArcOfParabola::Save(), Part::GeomLine::Save(), and Part::GeomLineSegment::Save().

setExtension()

void Geometry::setExtension

(

std::unique_ptr< GeometryExtension > &&

geo

)

References extensions.

Referenced by Part::GeometryPy::setExtension().

toShape()

virtual TopoDS_Shape Part::Geometry::toShape ( ) const

pure virtual

Implemented in Part::GeomSurface, Part::GeomCurve, and Part::GeomPoint.

Referenced by Part::getPyShapes().

Member Data Documentation

Construction

bool Part::Geometry::Construction

construction geometry (means no impact on a later built topo) Note: In the Sketcher and only for the specific case of a point, it has a special meaning: a construction point has fixed coordinates for the solver (it has fixed parameters)

Referenced by Sketcher::SketchObject::addCopy(), Sketcher::SketchObject::addGeometry(), Sketcher::SketchObject::carbonCopy(), Part::GeomPoint::copy(), Part::GeomCircle::copy(), Part::GeomEllipse::copy(), Part::GeomHyperbola::copy(), Part::GeomParabola::copy(), Part::GeomLine::copy(), Part::GeomOffsetCurve::copy(), Part::GeomBezierSurface::copy(), Sketcher::SketchObject::exposeInternalGeometry(), SketcherGui::isConstructionPoint(), Sketcher::SketchObject::rebuildExternalGeometry(), DrawSketchHandlerFillet::releaseButton(), Restore(), Save(), Part::GeometryPy::setConstruction(), Sketcher::SketchObject::setConstruction(), Sketcher::SketchObject::SketchObject(), Sketcher::SketchObject::toggleConstruction(), Sketcher::SketchObject::toggleDriving(), and SketcherGui::ViewProviderSketch::updateColor().

extensions

std::vector<std::shared_ptr<GeometryExtension> > Part::Geometry::extensions

protected

Referenced by clone(), deleteExtension(), getExtension(), getExtensions(), hasExtension(), Restore(), Save(), setExtension(), PathScripts.PathPocketShapeGui.TaskPanelExtensionPage::setFields(), and PathScripts.PathPocketShapeGui.TaskPanelExtensionPage::updateProxyExtensions().

tag

boost::uuids::uuid Part::Geometry::tag

protected

Referenced by PathScripts.PathDressupHoldingTags.MapWireToTag::add(), assignTag(), PathScripts.PathDressupHoldingTags.MapWireToTag::cleanupEdges(), clone(), PathScripts.PathDressupHoldingTags.MapWireToTag::commandsForEdges(), createNewTag(), Dice3DS.dom3ds.ChunkBase::document_html(), Dice3DS.dom3ds.ChunkBase::dump_header(), getTag(), and PathScripts.PathDressupHoldingTags.MapWireToTag::shell().

---

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

• src/Mod/Part/App/Geometry.h
• src/Mod/Part/App/Geometry.cpp