Geometric transformation on a shape. The transformation to be applied is defined as a gp_GTrsf transformation. It may be: More...

#include <BRepBuilderAPI_GTransform.hxx>

Inheritance diagram for BRepBuilderAPI_GTransform:

[legend]

Public Member Functions
	BRepBuilderAPI_GTransform (const gp_GTrsf &T)
	Constructs a framework for applying the geometric transformation T to a shape. Use the function Perform to define the shape to transform.

	BRepBuilderAPI_GTransform (const TopoDS_Shape &S, const gp_GTrsf &T, const Standard_Boolean Copy=Standard_False)
	Constructs a framework for applying the geometric transformation T to a shape, and applies it to the shape S.

void	Perform (const TopoDS_Shape &S, const Standard_Boolean Copy=Standard_False)
	Applies the geometric transformation defined at the time of construction of this framework to the shape S.

virtual const TopTools_ListOfShape &	Modified (const TopoDS_Shape &S) override
	Returns the list of shapes modified from the shape .

virtual TopoDS_Shape	ModifiedShape (const TopoDS_Shape &S) const override
	Returns the modified shape corresponding to .

Public Member Functions inherited from BRepBuilderAPI_ModifyShape
Public Member Functions inherited from BRepBuilderAPI_MakeShape
virtual void	Build (const Message_ProgressRange &theRange=Message_ProgressRange())
	This is called by Shape(). It does nothing but may be redefined.

virtual const TopoDS_Shape &	Shape ()
	Returns a shape built by the shape construction algorithm. Raises exception StdFail_NotDone if the shape was not built.

	operator TopoDS_Shape ()

virtual const TopTools_ListOfShape &	Generated (const TopoDS_Shape &S)
	Returns the list of shapes generated from the shape .

virtual Standard_Boolean	IsDeleted (const TopoDS_Shape &S)
	Returns true if the shape S has been deleted.

Public Member Functions inherited from BRepBuilderAPI_Command
virtual	~BRepBuilderAPI_Command ()

virtual Standard_Boolean	IsDone () const

void	Check () const
	Raises NotDone if done is false.

Additional Inherited Members
Protected Member Functions inherited from BRepBuilderAPI_ModifyShape
	BRepBuilderAPI_ModifyShape ()
	Empty constructor.

	BRepBuilderAPI_ModifyShape (const TopoDS_Shape &S)
	Initializes the modifier with the Shape ~~, and set the field <myInitialShape> to .~~

	BRepBuilderAPI_ModifyShape (const Handle< BRepTools_Modification > &M)
	Set the field <myModification> with <M>.

	BRepBuilderAPI_ModifyShape (const TopoDS_Shape &S, const Handle< BRepTools_Modification > &M)
	Initializes the modifier with the Shape ~~, and set the field <myInitialShape> to ~~, and set the field <myModification> with <M>, the performs the modification.~~~~

void	DoModif (const TopoDS_Shape &S)
	Performs the previously given modification on the shape .

void	DoModif (const Handle< BRepTools_Modification > &M)
	Performs the modification <M> on a previously given shape.

void	DoModif (const TopoDS_Shape &S, const Handle< BRepTools_Modification > &M)
	Performs the modification <M> on the shape .

Protected Member Functions inherited from BRepBuilderAPI_MakeShape
	BRepBuilderAPI_MakeShape ()

Protected Member Functions inherited from BRepBuilderAPI_Command
	BRepBuilderAPI_Command ()
	Set done to False.

void	Done ()
	Set done to true.

void	NotDone ()
	Set done to false.

Protected Attributes inherited from BRepBuilderAPI_ModifyShape
BRepTools_Modifier	myModifier

TopoDS_Shape	myInitialShape

Handle< BRepTools_Modification >	myModification

Protected Attributes inherited from BRepBuilderAPI_MakeShape
TopoDS_Shape	myShape

TopTools_ListOfShape	myGenerated

Detailed Description

Geometric transformation on a shape. The transformation to be applied is defined as a gp_GTrsf transformation. It may be:

a transformation equivalent to a gp_Trsf transformation, the most common case: you should , however, use a BRepAPI_Transform object to perform this kind of transformation; or
an affinity, or
more generally, any type of point transformation which may be defined by a three row, four column matrix of transformation. In the last two cases, the underlying geometry of the following shapes may change:
a curve which supports an edge of the shape, or
a surface which supports a face of the shape; For example, a circle may be transformed into an ellipse when applying an affinity transformation. The transformation is applied to:
all the curves which support edges of the shape, and
all the surfaces which support faces of the shape. A GTransform object provides a framework for:
defining the geometric transformation to be applied,
implementing the transformation algorithm, and
consulting the result.

Constructor & Destructor Documentation

◆ BRepBuilderAPI_GTransform() [1/2]

BRepBuilderAPI_GTransform::BRepBuilderAPI_GTransform ( const gp_GTrsf & T )

Constructs a framework for applying the geometric transformation T to a shape. Use the function Perform to define the shape to transform.

◆ BRepBuilderAPI_GTransform() [2/2]

BRepBuilderAPI_GTransform::BRepBuilderAPI_GTransform	(	const TopoDS_Shape &	S,
		const gp_GTrsf &	T,
		const Standard_Boolean	Copy = Standard_False )

Constructs a framework for applying the geometric transformation T to a shape, and applies it to the shape S.

If the transformation T is direct and isometric (i.e. if the determinant of the vectorial part of T is equal to 1.), and if Copy equals false (default value), the resulting shape is the same as the original but with a new location assigned to it.
In all other cases, the transformation is applied to a duplicate of S. Use the function Shape to access the result. Note: the constructed framework can be reused to apply the same geometric transformation to other shapes: just specify them with the function Perform.

Member Function Documentation

◆ Modified()

virtual const TopTools_ListOfShape & BRepBuilderAPI_GTransform::Modified ( const TopoDS_Shape & S )

overridevirtual

Returns the list of shapes modified from the shape .

Reimplemented from BRepBuilderAPI_ModifyShape.

◆ ModifiedShape()

virtual TopoDS_Shape BRepBuilderAPI_GTransform::ModifiedShape ( const TopoDS_Shape & S ) const

overridevirtual

Returns the modified shape corresponding to .

Reimplemented from BRepBuilderAPI_ModifyShape.

◆ Perform()

void BRepBuilderAPI_GTransform::Perform	(	const TopoDS_Shape &	S,
		const Standard_Boolean	Copy = Standard_False )

Applies the geometric transformation defined at the time of construction of this framework to the shape S.

If the transformation T is direct and isometric (i.e. if the determinant of the vectorial part of T is equal to 1.), and if Copy equals false (default value), the resulting shape is the same as the original but with a new location assigned to it.
In all other cases, the transformation is applied to a duplicate of S. Use the function Shape to access the result. Note: this framework can be reused to apply the same geometric transformation to other shapes: just specify them by calling the function Perform again.

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

BRepBuilderAPI_GTransform.hxx

Public Member Functions

Additional Inherited Members