RWMesh_CoordinateSystemConverter Class Reference

Coordinate system converter defining the following tools: More...

#include <RWMesh_CoordinateSystemConverter.hxx>

Public Member Functions
	RWMesh_CoordinateSystemConverter ()
	Empty constructor.
Standard_Boolean	IsEmpty () const
	Return TRUE if there is no transformation (target and current coordinates systems are same).
Standard_Real	InputLengthUnit () const
	Return source length units, defined as scale factor to m (meters). -1.0 by default, which means that NO conversion will be applied (regardless output length unit).
void	SetInputLengthUnit (Standard_Real theInputScale)
	Set source length units as scale factor to m (meters).
Standard_Real	OutputLengthUnit () const
	Return destination length units, defined as scale factor to m (meters). -1.0 by default, which means that NO conversion will be applied (regardless input length unit).
void	SetOutputLengthUnit (Standard_Real theOutputScale)
	Set destination length units as scale factor to m (meters).
Standard_Boolean	HasInputCoordinateSystem () const
	Return TRUE if source coordinate system has been set; FALSE by default.
const gp_Ax3 &	InputCoordinateSystem () const
	Source coordinate system; UNDEFINED by default.
void	SetInputCoordinateSystem (const gp_Ax3 &theSysFrom)
	Set source coordinate system.
void	SetInputCoordinateSystem (RWMesh_CoordinateSystem theSysFrom)
	Set source coordinate system.
Standard_Boolean	HasOutputCoordinateSystem () const
	Return TRUE if destination coordinate system has been set; FALSE by default.
const gp_Ax3 &	OutputCoordinateSystem () const
	Destination coordinate system; UNDEFINED by default.
void	SetOutputCoordinateSystem (const gp_Ax3 &theSysTo)
	Set destination coordinate system.
void	SetOutputCoordinateSystem (RWMesh_CoordinateSystem theSysTo)
	Set destination coordinate system.
void	Init (const gp_Ax3 &theInputSystem, Standard_Real theInputLengthUnit, const gp_Ax3 &theOutputSystem, Standard_Real theOutputLengthUnit)
	Initialize transformation.
void	TransformTransformation (gp_Trsf &theTrsf) const
	Transform transformation.
void	TransformPosition (gp_XYZ &thePos) const
	Transform position.
void	TransformNormal (Graphic3d_Vec3 &theNorm) const
	Transform normal (e.g. exclude translation/scale part of transformation).

Static Public Member Functions
static gp_Ax3	StandardCoordinateSystem (RWMesh_CoordinateSystem theSys)
	Return a standard coordinate system definition.

Detailed Description

Coordinate system converter defining the following tools:

• Initialization for commonly used coordinate systems Z-up and Y-up.
• Perform length unit conversion (scaling).
• Conversion of three basic elements: a) mesh node Positions, b) mesh node Normals, c) model nodes Transformations (locations).

RWMesh_CoordinateSystem enumeration is used for convenient conversion between two commonly used coordinate systems, to make sure that imported model is oriented up. But gp_Ax3 can be used instead for defining a conversion between arbitrary systems (e.g. including non-zero origin).

The converter requires defining explicitly both input and output systems, so that if either input or output is undefined, then conversion will be skipped. Length units conversion and coordinate system conversion are decomposed, so that application might specify no length units conversion but Y-up to Z-up coordinate system conversion.

Class defines dedicated methods for parameters of input and output systems. This allows passing tool through several initialization steps, so that a reader can initialize input length units (only if file format defines such information), while application specifies output length units, and conversion will be done only when both defined.

Constructor & Destructor Documentation

RWMesh_CoordinateSystemConverter()

RWMesh_CoordinateSystemConverter::RWMesh_CoordinateSystemConverter

(

)

Empty constructor.

Member Function Documentation

HasInputCoordinateSystem()

Standard_Boolean RWMesh_CoordinateSystemConverter::HasInputCoordinateSystem ( ) const

inline

Return TRUE if source coordinate system has been set; FALSE by default.

HasOutputCoordinateSystem()

Standard_Boolean RWMesh_CoordinateSystemConverter::HasOutputCoordinateSystem ( ) const

inline

Return TRUE if destination coordinate system has been set; FALSE by default.

Init()

void RWMesh_CoordinateSystemConverter::Init	(	const gp_Ax3 &	theInputSystem,
		Standard_Real	theInputLengthUnit,
		const gp_Ax3 &	theOutputSystem,
		Standard_Real	theOutputLengthUnit
	)

Initialize transformation.

InputCoordinateSystem()

const gp_Ax3 & RWMesh_CoordinateSystemConverter::InputCoordinateSystem ( ) const

inline

Source coordinate system; UNDEFINED by default.

InputLengthUnit()

Standard_Real RWMesh_CoordinateSystemConverter::InputLengthUnit ( ) const

inline

Return source length units, defined as scale factor to m (meters). -1.0 by default, which means that NO conversion will be applied (regardless output length unit).

IsEmpty()

Standard_Boolean RWMesh_CoordinateSystemConverter::IsEmpty ( ) const

inline

Return TRUE if there is no transformation (target and current coordinates systems are same).

OutputCoordinateSystem()

const gp_Ax3 & RWMesh_CoordinateSystemConverter::OutputCoordinateSystem ( ) const

inline

Destination coordinate system; UNDEFINED by default.

OutputLengthUnit()

Standard_Real RWMesh_CoordinateSystemConverter::OutputLengthUnit ( ) const

inline

Return destination length units, defined as scale factor to m (meters). -1.0 by default, which means that NO conversion will be applied (regardless input length unit).

SetInputCoordinateSystem() [1/2]

void RWMesh_CoordinateSystemConverter::SetInputCoordinateSystem ( const gp_Ax3 &  theSysFrom )

inline

Set source coordinate system.

SetInputCoordinateSystem() [2/2]

void RWMesh_CoordinateSystemConverter::SetInputCoordinateSystem ( RWMesh_CoordinateSystem  theSysFrom )

inline

Set source coordinate system.

SetInputLengthUnit()

void RWMesh_CoordinateSystemConverter::SetInputLengthUnit ( Standard_Real  theInputScale )

inline

Set source length units as scale factor to m (meters).

SetOutputCoordinateSystem() [1/2]

void RWMesh_CoordinateSystemConverter::SetOutputCoordinateSystem ( const gp_Ax3 &  theSysTo )

inline

Set destination coordinate system.

SetOutputCoordinateSystem() [2/2]

void RWMesh_CoordinateSystemConverter::SetOutputCoordinateSystem ( RWMesh_CoordinateSystem  theSysTo )

inline

Set destination coordinate system.

SetOutputLengthUnit()

void RWMesh_CoordinateSystemConverter::SetOutputLengthUnit ( Standard_Real  theOutputScale )

inline

Set destination length units as scale factor to m (meters).

StandardCoordinateSystem()

static gp_Ax3 RWMesh_CoordinateSystemConverter::StandardCoordinateSystem ( RWMesh_CoordinateSystem  theSys )

inlinestatic

Return a standard coordinate system definition.

TransformNormal()

void RWMesh_CoordinateSystemConverter::TransformNormal ( Graphic3d_Vec3 &  theNorm ) const

inline

Transform normal (e.g. exclude translation/scale part of transformation).

TransformPosition()

void RWMesh_CoordinateSystemConverter::TransformPosition ( gp_XYZ &  thePos ) const

inline

Transform position.

TransformTransformation()

void RWMesh_CoordinateSystemConverter::TransformTransformation ( gp_Trsf &  theTrsf ) const

inline

Transform transformation.

---

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

• RWMesh_CoordinateSystemConverter.hxx