Interface to the face object. More...

Inheritance diagram for GeomAPI_Face:

Public Types
enum	ShapeType { COMPOUND , COMPSOLID , SOLID , SHELL , FACE , WIRE , EDGE , VERTEX , SHAPE }
	Shape type enum. More...

enum	Orientation { FORWARD , REVERSED , INTERNAL , EXTERNAL }
	Shape orientation. More...

Public Member Functions
GEOMAPI_EXPORT	GeomAPI_Face ()
	Creation of empty (null) shape. More...

GEOMAPI_EXPORT	GeomAPI_Face (const std::shared_ptr< GeomAPI_Shape > &theShape)
	Creation of face by the face-shape. More...

virtual GEOMAPI_EXPORT bool	isEqual (const std::shared_ptr< GeomAPI_Shape > theFace) const
	Returns true if the current face is geometrically equal to the given face. More...

virtual GEOMAPI_EXPORT bool	isSameGeometry (const std::shared_ptr< GeomAPI_Shape > theShape) const
	Returns `true` if faces have same underlying surface. More...

GEOMAPI_EXPORT bool	isCylindrical () const
	Returns true if the face is a cylindrical face. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Pln >	getPlane () const
	Returns the base plane of the face (if it is planar) with location in the center of the face. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Sphere >	getSphere () const
	Returns sphere if the face is based on the spherical surface. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Cylinder >	getCylinder () const
	Returns cylinder if the face is based on the cylindrical surface. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Cone >	getCone () const
	Returns cone if the face is based on the conical surface. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Torus >	getTorus () const
	Returns torus if the face is based on the toroidal surface. More...

virtual GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Pnt >	middlePoint () const
	Returns inner point in the face. More...

virtual GEOMAPI_EXPORT bool	optimalBounds (double &theUMin, double &theUMax, double &theVMin, double &theVMax) const
	Returns bounding box in UV-space. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Shape >	emptyCopied () const

GEOMAPI_EXPORT bool	isNull () const
	Returns true if the underlied shape is null. More...

virtual GEOMAPI_EXPORT bool	isSame (const std::shared_ptr< GeomAPI_Shape > theShape) const
	Returns whether the shapes are same. More...

virtual GEOMAPI_EXPORT bool	isVertex () const
	Returns whether the shape is a vertex. More...

virtual GEOMAPI_EXPORT bool	isEdge () const
	Returns whether the shape is an edge. More...

virtual GEOMAPI_EXPORT bool	isWire () const
	Returns whether the shape is a wire. More...

virtual GEOMAPI_EXPORT bool	isFace () const
	Returns whether the shape is a face. More...

virtual GEOMAPI_EXPORT bool	isShell () const
	Returns whether the shape is a shell. More...

virtual GEOMAPI_EXPORT bool	isCompound () const
	Returns whether the shape is a compound. More...

virtual GEOMAPI_EXPORT bool	isCompoundOfSolids () const
	Returns whether the shape is a compound of solids. More...

virtual GEOMAPI_EXPORT bool	isCollectionOfSolids () const
	Returns true, if the shape contains only solids, compsolids and compounds of solids and compsolids of any nesting depth. More...

virtual GEOMAPI_EXPORT bool	isConnectedTopology () const
	Returns whether the shape is a compound where all elements are topologically connected. More...

virtual GEOMAPI_EXPORT bool	isSolid () const
	Returns whether the shape is a solid. More...

virtual GEOMAPI_EXPORT bool	isCompSolid () const
	Returns whether the shape is a compsolid. More...

virtual GEOMAPI_EXPORT bool	isPlanar () const
	Returns whether the shape is planar. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Vertex >	vertex () const
	Returns vertex or empty shape. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Edge >	edge () const
	Returns edge or empty shape. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Wire >	wire () const
	Returns wire or empty shape. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Face >	face () const
	Returns face or empty shape. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Shell >	shell () const
	Returns shell or empty shape. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Solid >	solid () const
	Returns solid or empty shape. More...

GEOMAPI_EXPORT std::list< std::shared_ptr< GeomAPI_Shape > >	subShapes (const ShapeType theSubShapeType, const bool theOnlyUnique=false) const
	Returns list of sub-shapes of the given type. More...

virtual GEOMAPI_EXPORT ShapeType	shapeType () const
	Returns the shape type. More...

virtual GEOMAPI_EXPORT std::string	shapeTypeStr () const

virtual GEOMAPI_EXPORT Orientation	orientation () const

virtual GEOMAPI_EXPORT void	setOrientation (const Orientation theOrientation)
	Sets the shape orientation. More...

virtual GEOMAPI_EXPORT void	reverse ()
	Reverse shape. More...

virtual GEOMAPI_EXPORT bool	isSubShape (const std::shared_ptr< GeomAPI_Shape > theShape, const bool theCheckOrientation=true) const

GEOMAPI_EXPORT bool	computeSize (double &theXmin, double &theYmin, double &theZmin, double &theXmax, double &theYmax, double &theZmax) const
	Computes boundary dimensions of the shape Returns False if it is not possible. More...

GEOMAPI_EXPORT std::string	getShapeStream (const bool theWithTriangulation=true) const
	Returns the shape as BRep stream. More...

GEOMAPI_EXPORT std::shared_ptr< GeomAPI_Shape >	intersect (const std::shared_ptr< GeomAPI_Shape > theShape) const
	Returns intersection of shapes. More...

GEOMAPI_EXPORT bool	isIntersect (const std::shared_ptr< GeomAPI_Shape > theShape) const
	Returns true if min distance between shapes < tolerance. More...

GEOMAPI_EXPORT void	translate (const std::shared_ptr< GeomAPI_Dir > theDir, const double theOffset)
	Translates the shape along the direction for the given offset. More...

GEOMAPI_EXPORT void	move (const std::shared_ptr< GeomAPI_Trsf > theTransformation)
	Moves the shape with the given transformation matrix. More...

GEOMAPI_EXPORT ShapeType	typeOfCompoundShapes () const
	Returns type of shapes in the compound. More...

GEOMAPI_EXPORT bool	isSelfIntersected (const int theLevelOfCheck=9) const
	Returns true if shape have self-intersections. More...

template<class T >
T *	implPtr ()
	Returns the pointer to the impl. More...

template<class T >
const T *	implPtr () const
	Returns the pointer to the impl. More...

template<class T >
const T &	impl () const
	Returns the reference object of the impl. More...

template<class T >
void	setImpl (T *theImpl)
	Updates the impl (deletes the old one) More...

GEOMAPI_EXPORT bool	empty () const
	Returns true if the impl is empty. More...

Static Public Member Functions
static GEOMAPI_EXPORT ShapeType	shapeTypeByStr (std::string theType)
	Returns the type enumeration by the string-type. More...

Detailed Description

Interface to the face object.

Member Enumeration Documentation

◆ ShapeType

enum GeomAPI_Shape::ShapeType

inherited

Shape type enum.

◆ Orientation

enum GeomAPI_Shape::Orientation

inherited

Shape orientation.

Constructor & Destructor Documentation

◆ GeomAPI_Face() [1/2]

GeomAPI_Face::GeomAPI_Face ( )

Creation of empty (null) shape.

◆ GeomAPI_Face() [2/2]

GeomAPI_Face::GeomAPI_Face ( const std::shared_ptr< GeomAPI_Shape > & theShape )

Creation of face by the face-shape.

Member Function Documentation

◆ isEqual()

bool GeomAPI_Face::isEqual ( const std::shared_ptr< GeomAPI_Shape > theFace ) const

virtual

Returns true if the current face is geometrically equal to the given face.

Reimplemented from GeomAPI_Shape.

◆ isSameGeometry()

bool GeomAPI_Face::isSameGeometry ( const std::shared_ptr< GeomAPI_Shape > theShape ) const

virtual

Returns true if faces have same underlying surface.

Reimplemented from GeomAPI_Shape.

◆ isCylindrical()

bool GeomAPI_Face::isCylindrical ( ) const

Returns true if the face is a cylindrical face.

◆ getPlane()

std::shared_ptr< GeomAPI_Pln > GeomAPI_Face::getPlane ( ) const

Returns the base plane of the face (if it is planar) with location in the center of the face.

◆ getSphere()

std::shared_ptr< GeomAPI_Sphere > GeomAPI_Face::getSphere ( ) const

Returns sphere if the face is based on the spherical surface.

◆ getCylinder()

std::shared_ptr< GeomAPI_Cylinder > GeomAPI_Face::getCylinder ( ) const

Returns cylinder if the face is based on the cylindrical surface.

◆ getCone()

std::shared_ptr< GeomAPI_Cone > GeomAPI_Face::getCone ( ) const

Returns cone if the face is based on the conical surface.

◆ getTorus()

std::shared_ptr< GeomAPI_Torus > GeomAPI_Face::getTorus ( ) const

Returns torus if the face is based on the toroidal surface.

◆ middlePoint()

GeomPointPtr GeomAPI_Face::middlePoint ( ) const

virtual

Returns inner point in the face.

Reimplemented from GeomAPI_Shape.

◆ optimalBounds()

bool GeomAPI_Face::optimalBounds	(	double &	theUMin,
		double &	theUMax,
		double &	theVMin,
		double &	theVMax
	)		const

virtual

Returns bounding box in UV-space.

◆ emptyCopied()

std::shared_ptr< GeomAPI_Shape > GeomAPI_Shape::emptyCopied ( ) const

inherited

Returns: a new Shape with the same Orientation and Location and a new TShape with the same geometry and no sub-shapes.

◆ isNull()

bool GeomAPI_Shape::isNull ( ) const

inherited

Returns true if the underlied shape is null.

◆ isSame()

bool GeomAPI_Shape::isSame ( const std::shared_ptr< GeomAPI_Shape > theShape ) const

virtualinherited

Returns whether the shapes are same.

◆ isVertex()

bool GeomAPI_Shape::isVertex ( ) const

virtualinherited

Returns whether the shape is a vertex.

Reimplemented in GeomAPI_PlanarEdges.

◆ isEdge()

bool GeomAPI_Shape::isEdge ( ) const

virtualinherited

Returns whether the shape is an edge.

Reimplemented in GeomAPI_PlanarEdges.

◆ isWire()

bool GeomAPI_Shape::isWire ( ) const

virtualinherited

Returns whether the shape is a wire.

◆ isFace()

bool GeomAPI_Shape::isFace ( ) const

virtualinherited

Returns whether the shape is a face.

◆ isShell()

bool GeomAPI_Shape::isShell ( ) const

virtualinherited

Returns whether the shape is a shell.

◆ isCompound()

bool GeomAPI_Shape::isCompound ( ) const

virtualinherited

Returns whether the shape is a compound.

◆ isCompoundOfSolids()

bool GeomAPI_Shape::isCompoundOfSolids ( ) const

virtualinherited

Returns whether the shape is a compound of solids.

◆ isCollectionOfSolids()

bool GeomAPI_Shape::isCollectionOfSolids ( ) const

virtualinherited

Returns true, if the shape contains only solids, compsolids and compounds of solids and compsolids of any nesting depth.

◆ isConnectedTopology()

bool GeomAPI_Shape::isConnectedTopology ( ) const

virtualinherited

Returns whether the shape is a compound where all elements are topologically connected.

◆ isSolid()

bool GeomAPI_Shape::isSolid ( ) const

virtualinherited

Returns whether the shape is a solid.

◆ isCompSolid()

bool GeomAPI_Shape::isCompSolid ( ) const

virtualinherited

Returns whether the shape is a compsolid.

◆ isPlanar()

bool GeomAPI_Shape::isPlanar ( ) const

virtualinherited

Returns whether the shape is planar.

Reimplemented in GeomAPI_PlanarEdges.

◆ vertex()

std::shared_ptr< GeomAPI_Vertex > GeomAPI_Shape::vertex ( ) const

inherited

Returns vertex or empty shape.

◆ edge()

std::shared_ptr< GeomAPI_Edge > GeomAPI_Shape::edge ( ) const

inherited

Returns edge or empty shape.

◆ wire()

std::shared_ptr< GeomAPI_Wire > GeomAPI_Shape::wire ( ) const

inherited

Returns wire or empty shape.

◆ face()

std::shared_ptr< GeomAPI_Face > GeomAPI_Shape::face ( ) const

inherited

Returns face or empty shape.

◆ shell()

std::shared_ptr< GeomAPI_Shell > GeomAPI_Shape::shell ( ) const

inherited

Returns shell or empty shape.

◆ solid()

std::shared_ptr< GeomAPI_Solid > GeomAPI_Shape::solid ( ) const

inherited

Returns solid or empty shape.

◆ subShapes()

std::list< std::shared_ptr< GeomAPI_Shape > > GeomAPI_Shape::subShapes	(	const ShapeType	theSubShapeType,
		const bool	theOnlyUnique = `false`
	)		const

inherited

Returns list of sub-shapes of the given type.

Parameters

theSubShapeType	type of sub-shapes to search.
theOnlyUnique	set it to `true` to omit subsequent inclusions of the same sub-shape. By default it is `false`.

◆ shapeType()

GeomAPI_Shape::ShapeType GeomAPI_Shape::shapeType ( ) const

virtualinherited

Returns the shape type.

◆ shapeTypeByStr()

GeomAPI_Shape::ShapeType GeomAPI_Shape::shapeTypeByStr ( std::string theType )

staticinherited

Returns the type enumeration by the string-type.

◆ shapeTypeStr()

std::string GeomAPI_Shape::shapeTypeStr ( ) const

virtualinherited

Returns: the shape type as string.

◆ orientation()

GeomAPI_Shape::Orientation GeomAPI_Shape::orientation ( ) const

virtualinherited

Returns: the shape orientation.

◆ setOrientation()

void GeomAPI_Shape::setOrientation ( const Orientation theOrientation )

virtualinherited

Sets the shape orientation.

◆ reverse()

void GeomAPI_Shape::reverse ( )

virtualinherited

Reverse shape.

◆ isSubShape()

bool GeomAPI_Shape::isSubShape	(	const std::shared_ptr< GeomAPI_Shape >	theShape,
		const bool	theCheckOrientation = `true`
	)		const

virtualinherited

Returns: true if passed shape is a sub-shape of this shape.

Parameters

theShape	shape to search.
theCheckOrientation	if false, returns true even if orientation of shape differs

◆ computeSize()

bool GeomAPI_Shape::computeSize	(	double &	theXmin,
		double &	theYmin,
		double &	theZmin,
		double &	theXmax,
		double &	theYmax,
		double &	theZmax
	)		const

inherited

Computes boundary dimensions of the shape Returns False if it is not possible.

◆ getShapeStream()

std::string GeomAPI_Shape::getShapeStream ( const bool theWithTriangulation = true ) const

inherited

Returns the shape as BRep stream.

◆ intersect()

GeomShapePtr GeomAPI_Shape::intersect ( const std::shared_ptr< GeomAPI_Shape > theShape ) const

inherited

Returns intersection of shapes.

◆ isIntersect()

bool GeomAPI_Shape::isIntersect ( const std::shared_ptr< GeomAPI_Shape > theShape ) const

inherited

Returns true if min distance between shapes < tolerance.

◆ translate()

void GeomAPI_Shape::translate	(	const std::shared_ptr< GeomAPI_Dir >	theDir,
		const double	theOffset
	)

inherited

Translates the shape along the direction for the given offset.

◆ move()

void GeomAPI_Shape::move ( const std::shared_ptr< GeomAPI_Trsf > theTransformation )

inherited

Moves the shape with the given transformation matrix.

◆ typeOfCompoundShapes()

GeomAPI_Shape::ShapeType GeomAPI_Shape::typeOfCompoundShapes ( ) const

inherited

Returns type of shapes in the compound.

◆ isSelfIntersected()

bool GeomAPI_Shape::isSelfIntersected ( const int theLevelOfCheck = 9 ) const

inherited

Returns true if shape have self-intersections.

Parameters

[in] theLevelOfCheck defines which interferences will be checked:
0 - only V/V;
1 - V/V and V/E;
2 - V/V, V/E and E/E;
3 - V/V, V/E, E/E and V/F;
4 - V/V, V/E, E/E, V/F and E/F;
5 - V/V, V/E, E/E, V/F, E/F and F/F;
6 - V/V, V/E, E/E, V/F, E/F, F/F and V/S;
7 - V/V, V/E, E/E, V/F, E/F, F/F, V/S and E/S;
8 - V/V, V/E, E/E, V/F, E/F, F/F, V/S, E/S and F/S;
9 - V/V, V/E, E/E, V/F, E/F, F/F, V/S, E/S, F/S and S/S - all interferences (Default value)

◆ implPtr() [1/2]

template<class T >

T* GeomAPI_Interface::implPtr ( )

inlineinherited

Returns the pointer to the impl.

◆ implPtr() [2/2]

template<class T >

const T* GeomAPI_Interface::implPtr ( ) const

inlineinherited

Returns the pointer to the impl.

◆ impl()

template<class T >

const T& GeomAPI_Interface::impl ( ) const

inlineinherited

Returns the reference object of the impl.

◆ setImpl()

template<class T >

void GeomAPI_Interface::setImpl ( T * theImpl )

inlineinherited

Updates the impl (deletes the old one)

◆ empty()

bool GeomAPI_Interface::empty ( ) const

inherited

Returns true if the impl is empty.

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ ShapeType

◆ Orientation

Constructor & Destructor Documentation

◆ GeomAPI_Face() [1/2]

◆ GeomAPI_Face() [2/2]

Member Function Documentation

◆ isEqual()

◆ isSameGeometry()

◆ isCylindrical()

◆ getPlane()

◆ getSphere()

◆ getCylinder()

◆ getCone()

◆ getTorus()

◆ middlePoint()

◆ optimalBounds()

◆ emptyCopied()

◆ isNull()

◆ isSame()

◆ isVertex()

◆ isEdge()

◆ isWire()

◆ isFace()

◆ isShell()

◆ isCompound()

◆ isCompoundOfSolids()

◆ isCollectionOfSolids()

◆ isConnectedTopology()

◆ isSolid()

◆ isCompSolid()

◆ isPlanar()

◆ vertex()

◆ edge()

◆ wire()

◆ face()

◆ shell()

◆ solid()

◆ subShapes()

◆ shapeType()

◆ shapeTypeByStr()

◆ shapeTypeStr()

◆ orientation()

◆ setOrientation()

◆ reverse()

◆ isSubShape()

◆ computeSize()

◆ getShapeStream()

◆ intersect()

◆ isIntersect()

◆ translate()

◆ move()

◆ typeOfCompoundShapes()

◆ isSelfIntersected()

◆ implPtr() [1/2]

◆ implPtr() [2/2]

◆ impl()

◆ setImpl()

◆ empty()