FreeCAD C++
Public Member Functions | Static Public Member Functions | Public Attributes | Static Protected Member Functions | List of all members
PartDesign::Feature Class Reference

#include <Mod/PartDesign/App/Feature.h>

Detailed Description

PartDesign feature Base class of all PartDesign features. This kind of features only produce solids or fail.

Public Member Functions

Body * getFeatureBody ()
 Returns the body the feature is in, or none.
 
virtual Part::FeaturegetBaseObject (bool silent=false) const
 
virtual const TopoDS_Shape & getBaseShape () const
 Returns the BaseFeature property's shape (if any)
 
const Part::TopoShape getBaseTopoShape () const
 Returns the BaseFeature property's TopoShape (if any)
 
- Public Member Functions inherited from Part::Feature
 Feature (void)
 Constructor.
 
- Public Member Functions inherited from App::GeoFeature
 GeoFeature (void)
 Constructor.
 
virtual void transformPlacement (const Base::Placement &transform)
 transformPlacement applies transform to placement of this shape. Override this function to propagate the change of placement to base features, for example. By the time of writing this comment, the function was only called by alignment task (Edit->Alignment) More...
 
Base::Placement globalPlacement () const
 Calculates the placement in the global reference coordinate system. More...
 
- Public Member Functions inherited from App::DocumentObject
 DocumentObject (void)
 Constructor.
 
const char * getNameInDocument (void) const
 returns the name which is set in the document for this object (not the name property!)
 
App::DocumentgetDocument (void) const
 gets the document in which this Object is handled
 
bool testIfLinkDAGCompatible (DocumentObject *linkTo) const
 testIfLinkIsDAG tests a link that is about to be created for circular references. More...
 
bool recomputeFeature ()
 Recompute only this feature.
 
const char * getStatusString (void) const
 get the status Message
 
virtual void onLostLinkToObject (DocumentObject *)
 
void touch (void)
 set this document object touched (cause recomputation on dependent features) More...
 
bool isTouched (void) const
 test if this document object is touched
 
void enforceRecompute ()
 Enforce this document object to be recomputed.
 
bool mustRecompute (void) const
 Test if this document object must be recomputed.
 
void purgeTouched (void)
 reset this document object touched
 
bool isError (void) const
 set this feature to error
 
void purgeError (void)
 remove the error from the object
 
bool isRecomputing () const
 returns true if this objects is currently recomputing
 
bool isRestoring () const
 returns true if this objects is currently restoring from file
 
bool isRemoving () const
 returns true if this objects is currently removed from the document
 
unsigned long getStatus () const
 return the status bits
 
std::vector< App::DocumentObject * > getOutList (void) const
 returns a list of objects this object is pointing to by Links More...
 
std::vector< App::DocumentObject * > getOutListOfProperty (App::Property *) const
 returns a list of objects linked by the property
 
std::vector< App::DocumentObject * > getOutListRecursive (void) const
 returns a list of objects this object is pointing to by Links and all further descended
 
std::vector< std::list< App::DocumentObject * > > getPathsByOutList (App::DocumentObject *to) const
 get all possible paths from this to another object following the OutList
 
std::vector< App::DocumentObject * > getInList (void) const
 get all objects link to this object
 
std::vector< App::DocumentObject * > getInListRecursive (void) const
 get all objects link directly or indirectly to this object
 
DocumentObjectGroup * getGroup () const
 get group if object is part of a group, otherwise 0 is returned
 
bool isInInListRecursive (DocumentObject *objToTest) const
 test if this object is in the InList and recursive further down
 
bool isInInList (DocumentObject *objToTest) const
 test if this object is directly (non recursive) in the InList
 
bool isInOutListRecursive (DocumentObject *objToTest) const
 test if the given object is in the OutList and recursive further down
 
bool isInOutList (DocumentObject *objToTest) const
 test if this object is directly (non recursive) in the OutList
 
void _removeBackLink (DocumentObject *)
 internal, used by PropertyLink to maintain DAG back links
 
void _addBackLink (DocumentObject *)
 internal, used by PropertyLink to maintain DAG back links
 
- Public Member Functions inherited from App::TransactionalObject
 TransactionalObject (void)
 Constructor.
 
- Public Member Functions inherited from App::ExtensionContainer
virtual PropertygetPropertyByName (const char *name) const override
 find a property by its name
 
virtual const char * getPropertyName (const Property *prop) const override
 get the name of a property
 
virtual void getPropertyMap (std::map< std::string, Property * > &Map) const override
 get all properties of the class (including properties of the parent)
 
virtual void getPropertyList (std::vector< Property * > &List) const override
 get all properties of the class (including properties of the parent)
 
virtual short getPropertyType (const Property *prop) const override
 get the Type of a Property
 
virtual short getPropertyType (const char *name) const override
 get the Type of a named Property
 
virtual const char * getPropertyGroup (const Property *prop) const override
 get the Group of a Property
 
virtual const char * getPropertyGroup (const char *name) const override
 get the Group of a named Property
 
virtual const char * getPropertyDocumentation (const Property *prop) const override
 get the Group of a Property
 
virtual const char * getPropertyDocumentation (const char *name) const override
 get the Group of a named Property
 
- Public Member Functions inherited from App::PropertyContainer
 PropertyContainer ()
 
virtual ~PropertyContainer ()
 
void setPropertyStatus (unsigned char bit, bool value)
 set the Status bit of all properties at once
 
bool isReadOnly (const Property *prop) const
 check if the property is read-only
 
bool isReadOnly (const char *name) const
 check if the named property is read-only
 
bool isHidden (const Property *prop) const
 check if the property is hidden
 
bool isHidden (const char *name) const
 check if the named property is hidden
 
- Public Member Functions inherited from Base::Persistence
virtual void SaveDocFile (Writer &) const
 
virtual void RestoreDocFile (Reader &)
 
- Public Member Functions inherited from Base::BaseClass
 BaseClass ()
 Construction.
 
virtual ~BaseClass ()
 Destruction.
 

Static Public Member Functions

static bool isDatum (const App::DocumentObject *feature)
 Check whether the given feature is a datum feature.
 
- Static Public Member Functions inherited from Base::Persistence
static std::string encodeAttribute (const std::string &)
 Encodes an attribute upon saving.
 

Public Attributes

App::PropertyLink BaseFeature
 Base feature which this feature will be fused into or cut out of.
 

Static Protected Member Functions

static TopoDS_Shape getSolid (const TopoDS_Shape &)
 
static const gp_Pnt getPointFromFace (const TopoDS_Face &f)
 Grab any point from the given face.
 
static gp_Pln makePlnFromPlane (const App::DocumentObject *obj)
 Make a shape from a base plane (convenience method)
 

Additional Inherited Members

- Protected Member Functions inherited from Part::Feature
virtual App::DocumentObjectExecReturnrecompute (void)
 recompute only this object
 
virtual App::DocumentObjectExecReturnexecute (void)
 recalculate the feature
 
ShapeHistory buildHistory (BRepBuilderAPI_MakeShape &, TopAbs_ShapeEnum type, const TopoDS_Shape &newS, const TopoDS_Shape &oldS)
 
- Protected Member Functions inherited from App::DocumentObject
virtual void onBeforeChange (const Property *prop)
 get called before the value is changed
 
virtual void onDocumentRestored ()
 get called after a document has been fully restored
 
virtual void onSettingDocument ()
 get called after setting the document
 
virtual void setupObject ()
 get called after a brand new object was created
 
virtual void unsetupObject ()
 get called when object is going to be removed from the document
 
- Protected Attributes inherited from App::DocumentObject
std::bitset< 32 > StatusBits
 
Py::Object PythonObject
 python object of this class and all descendent
 
App::Document_pDoc
 pointer to the document this object belongs to
 
std::string oldLabel
 Old label; used for renaming expressions.
 

Member Function Documentation

◆ getBaseObject()

virtual Part::Feature* PartDesign::Feature::getBaseObject ( bool  silent = false) const
virtual

Returns the BaseFeature property's object (if any)

Parameters
silentif couldn't determine the base feature and silent == true, silently return a nullptr, otherwise throw Base::Exception. Default is false.

Reimplemented in PartDesign::Transformed.

◆ getSolid()

static TopoDS_Shape PartDesign::Feature::getSolid ( const TopoDS_Shape &  )
staticprotected

Get a solid of the given shape. If no solid is found an exception is raised.