BRepBuilderAPI_GTransform Class Reference

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:

Public Member Functions
	BRepBuilderAPI_GTransform (const gp_GTrsf &T)
	Constructs a framework for applying the geometric <br> transformation T to a shape. Use the function Perform to define the shape to transform. More...
	BRepBuilderAPI_GTransform (const TopoDS_Shape &S, const gp_GTrsf &T, const Standard_Boolean Copy=Standard_False)
	Constructs a framework for applying the geometric <br> transformation T to a shape, and applies it to the shape S. More...
void	Perform (const TopoDS_Shape &S, const Standard_Boolean Copy=Standard_False)
	Applies the geometric transformation defined at the <br> time of construction of this framework to the shape S. More...
virtual const TopTools_ListOfShape &	Modified (const TopoDS_Shape &S)
	Returns the list of shapes modified from the shape <S>. More...
virtual const TopoDS_Shape &	ModifiedShape (const TopoDS_Shape &S) const
	Returns the modified shape corresponding to <S>. More...
Public Member Functions inherited from BRepBuilderAPI_MakeShape
virtual void	Delete ()
virtual	~BRepBuilderAPI_MakeShape ()
virtual void	Build ()
	This is called by Shape(). It does nothing but may be redefined. More...
const TopoDS_Shape &	Shape () const
	Returns a shape built by the shape construction algorithm. <br> Raises exception StdFail_NotDone if the shape was not built. More...
	operator TopoDS_Shape () const
virtual const TopTools_ListOfShape &	Generated (const TopoDS_Shape &S)
	Returns the list of shapes generated from the shape <S>. More...
virtual Standard_Boolean	IsDeleted (const TopoDS_Shape &S)
	Returns true if the shape S has been deleted. More...
Public Member Functions inherited from BRepBuilderAPI_Command
virtual	~BRepBuilderAPI_Command ()
virtual Standard_Boolean	IsDone () const
void	Check () const
	Raises NotDone if done is false. More...

Additional Inherited Members
Protected Member Functions inherited from BRepBuilderAPI_ModifyShape
	BRepBuilderAPI_ModifyShape ()
	Empty constructor. More...
	BRepBuilderAPI_ModifyShape (const TopoDS_Shape &S)
	Initializes the modifier with the Shape <S>, and set the field <myInitialShape> to <S>. More...
	BRepBuilderAPI_ModifyShape (const Handle< BRepTools_Modification > &M)
	Set the field <myModification> with <M>. More...
	BRepBuilderAPI_ModifyShape (const TopoDS_Shape &S, const Handle< BRepTools_Modification > &M)
	Initializes the modifier with the Shape <S>, and set the field <myInitialShape> to <S>, and set the field <myModification> with <M>, the performs the modification. More...
void	DoModif (const TopoDS_Shape &S)
	Performs the previously given modification on the shape <S>. More...
void	DoModif (const Handle< BRepTools_Modification > &M)
	Performs the modification <M> on a previously given shape. More...
void	DoModif (const TopoDS_Shape &S, const Handle< BRepTools_Modification > &M)
	Performs the modification <M> on the shape <S>. More...
Protected Member Functions inherited from BRepBuilderAPI_MakeShape
	BRepBuilderAPI_MakeShape ()
Protected Member Functions inherited from BRepBuilderAPI_Command
	BRepBuilderAPI_Command ()
	Set done to False. More...
void	Done ()
	Set done to true. More...
void	NotDone ()
	Set done to false. More...
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::BRepBuilderAPI_GTransform

(

const gp_GTrsf &

T

)

 Constructs a framework for applying the geometric <br>

transformation T to a shape. Use the function
Perform to define the shape to transform.

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 <br>

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

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

virtual

Returns the list of shapes modified from the shape
<S>.

Reimplemented from BRepBuilderAPI_ModifyShape.

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

virtual

Returns the modified shape corresponding to <S>.

Reimplemented from BRepBuilderAPI_ModifyShape.

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

 Applies the geometric transformation defined at the <br>

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