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