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
DEFINE_STANDARD_ALLOC	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)
	Returns the list of shapes modified from the shape <S>.
virtual const TopoDS_Shape &	ModifiedShape (const TopoDS_Shape &S) const
	Returns the modified shape corresponding to <S>.

---

Detailed Description

• 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

DEFINE_STANDARD_ALLOC BRepBuilderAPI_GTransform::BRepBuilderAPI_GTransform

(

const gp_GTrsf &

T

)

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

• 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]

Reimplemented from BRepBuilderAPI_ModifyShape.

virtual const TopoDS_Shape& BRepBuilderAPI_GTransform::ModifiedShape

(

const TopoDS_Shape &

S

)

const [virtual]

Reimplemented from BRepBuilderAPI_ModifyShape.

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

• 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