eVision.Easy3D.E3DTransformMatrix Class Reference

Represents a 3D transformation [4x4] matrix. More...

Public Member Functions
None	__init__ (self)
	Creates an eVision.Easy3D.E3DTransformMatrix object.
None	__init__ (self, eVision.Easy3D.E3DTransformMatrix other)
	Creates an eVision.Easy3D.E3DTransformMatrix object.
None	__init__ (self, float m00, float m10, float m20, float m30, float m01, float m11, float m21, float m31, float m02, float m12, float m22, float m32, float m03, float m13, float m23, float m33)
	Creates an eVision.Easy3D.E3DTransformMatrix object.
None	SetValue (self, int column, int row, float value)
	Sets a value in the eVision.Easy3D.E3DTransformMatrix object.
float	GetValue (self, int column, int row)
	Gets a value from the eVision.Easy3D.E3DTransformMatrix object.
None	GetOrthoBasis (self, eVision.Easy3D.E3DPoint e1, eVision.Easy3D.E3DPoint e2, eVision.Easy3D.E3DPoint e3, eVision.Easy3D.E3DPoint t)
	Gets the orthogonal basis represented by this transformation or throws an exception if it is not a rigid transformation.
bool	IsRigid (self)
	Checks that the transformation is a rigid transformation (keep the distances and angles).
None	Load (self, str path)
	Loads the eVision.Easy3D.E3DTransformMatrix object.
None	Load (self, eVision.ESerializer|None serializer)
	Loads the eVision.Easy3D.E3DTransformMatrix object.
None	Save (self, str path)
	Saves the eVision.Easy3D.E3DTransformMatrix object.
None	Save (self, eVision.ESerializer|None serializer)
	Saves the eVision.Easy3D.E3DTransformMatrix object.
eVision.Easy3D.E3DTransformMatrix	Transpose (self)
	Returns the transposed eVision.Easy3D.E3DTransformMatrix.
eVision.Easy3D.E3DTransformMatrix	Inverse (self)
	Returns the inverted eVision.Easy3D.E3DTransformMatrix.
eVision.Easy3D.E3DPoint	EulerAngles (self)
	Gets the Euler angles for the rotation represented by this transformation.
eVision.Easy3D.EAzimuthElevationAngles	AzimuthElevationAngles (self)
	Gets the azimuth and elevation angles for the Z axis of the coordinate system represented by the transformation matrix.

Static Public Member Functions
eVision.Easy3D.E3DTransformMatrix	CreateIdentityMatrix ()
	Creates an identity (neutral) eVision.Easy3D.E3DTransformMatrix.
eVision.Easy3D.E3DTransformMatrix	CreateRotationXMatrix (float angle)
	Creates a rotation eVision.Easy3D.E3DTransformMatrix around the X axis matrix.
eVision.Easy3D.E3DTransformMatrix	CreateRotationYMatrix (float angle)
	Creates a rotation eVision.Easy3D.E3DTransformMatrix around the Y axis matrix.
eVision.Easy3D.E3DTransformMatrix	CreateRotationZMatrix (float angle)
	Creates a rotation eVision.Easy3D.E3DTransformMatrix around the Z axis matrix.
eVision.Easy3D.E3DTransformMatrix	CreateRotationMatrix (eVision.Easy3D.E3DPoint axis, float angle)
	Creates a rotation eVision.Easy3D.E3DTransformMatrix around the given axis for the given angle.
eVision.Easy3D.E3DTransformMatrix	CreateTranslationMatrix (float dX, float dY, float dZ)
	Creates a translation eVision.Easy3D.E3DTransformMatrix.
eVision.Easy3D.E3DTransformMatrix	CreateIsotropicScalingMatrix (float scale)
	Creates an isotropic scaling eVision.Easy3D.E3DTransformMatrix.
eVision.Easy3D.E3DTransformMatrix	CreateAnisotropicScalingMatrix (float scaleX, float scaleY, float scaleZ)
	Creates an anisotropic scaling eVision.Easy3D.E3DTransformMatrix.
eVision.Easy3D.E3DTransformMatrix	CreatePerspectiveProjectionMatrix (float distance, float width, float height)
	Creates a perspective projection eVision.Easy3D.E3DTransformMatrix.
eVision.Easy3D.E3DTransformMatrix	CreateOrthographicProjectionMatrix (float width, float height)
	Creates an orthographic projection eVision.Easy3D.E3DTransformMatrix.
eVision.Easy3D.E3DTransformMatrix	CreateOrthoBasis (eVision.Easy3D.E3DPoint e1, eVision.Easy3D.E3DPoint e2, eVision.Easy3D.E3DPoint e3, eVision.Easy3D.E3DPoint t)
	Creates a orthonormal eVision.Easy3D.E3DTransformMatrix basis (corresponds to a rigid transformation).

Detailed Description

Represents a 3D transformation [4x4] matrix.

Remarks:

License(s): Easy3D

Constructor & Destructor Documentation

__init__() [1/3]

None eVision.Easy3D.E3DTransformMatrix.__init__

(

self

)

Creates an eVision.Easy3D.E3DTransformMatrix object.

Remarks:

The matrix is initialized with the given values.

By default, the matrix is initialized as an identity (neutral) matrix.

The value indices are m(column, row).

__init__() [2/3]

None eVision.Easy3D.E3DTransformMatrix.__init__	(		self,
		eVision.Easy3D.E3DTransformMatrix	other )

Creates an eVision.Easy3D.E3DTransformMatrix object.

Remarks:

The matrix is initialized with the given values.

By default, the matrix is initialized as an identity (neutral) matrix.

The value indices are m(column, row).

Parameters

other

Another eVision.Easy3D.E3DTransformMatrix used for the initialization.

__init__() [3/3]

None eVision.Easy3D.E3DTransformMatrix.__init__	(		self,
		float	m00,
		float	m10,
		float	m20,
		float	m30,
		float	m01,
		float	m11,
		float	m21,
		float	m31,
		float	m02,
		float	m12,
		float	m22,
		float	m32,
		float	m03,
		float	m13,
		float	m23,
		float	m33 )

Creates an eVision.Easy3D.E3DTransformMatrix object.

Remarks:

The matrix is initialized with the given values.

By default, the matrix is initialized as an identity (neutral) matrix.

The value indices are m(column, row).

Parameters

m00	Matrix value line 0 column 0.
m10	Matrix value line 0 column 1.
m20	Matrix value line 0 column 2.
m30	Matrix value line 0 column 3.
m01	Matrix value line 1 column 0.
m11	Matrix value line 1 column 1.
m21	Matrix value line 1 column 2.
m31	Matrix value line 1 column 3.
m02	Matrix value line 2 column 0.
m12	Matrix value line 2 column 1.
m22	Matrix value line 2 column 2.
m32	Matrix value line 2 column 3.
m03	Matrix value line 3 column 0.
m13	Matrix value line 3 column 1.
m23	Matrix value line 3 column 2.
m33	Matrix value line 3 column 3.

Member Function Documentation

AzimuthElevationAngles()

eVision.Easy3D.EAzimuthElevationAngles eVision.Easy3D.E3DTransformMatrix.AzimuthElevationAngles

(

self

)

Gets the azimuth and elevation angles for the Z axis of the coordinate system represented by the transformation matrix.

Azimuth angle is oriented trigonometrically around the z axis. The x axis corresponds to an azimuth of 0 degrees. Elevation angle represents the height of the normal w.r.t. the z = 0 plane.

The eVision.Easy3D.E3DTransformMatrix must be rigid (translation and rotation only).

Remarks:

CreateAnisotropicScalingMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateAnisotropicScalingMatrix ( float scaleX, float scaleY, float scaleZ )

static

Creates an anisotropic scaling eVision.Easy3D.E3DTransformMatrix.

Parameters

scaleX	Scaling factor along the X axis.
scaleY	Scaling factor along the Y axis.
scaleZ	Scaling factor along the Z axis.

CreateIdentityMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateIdentityMatrix ( )

static

Creates an identity (neutral) eVision.Easy3D.E3DTransformMatrix.

CreateIsotropicScalingMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateIsotropicScalingMatrix ( float scale )

static

Creates an isotropic scaling eVision.Easy3D.E3DTransformMatrix.

Parameters

scale

Scaling factor.

CreateOrthoBasis()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateOrthoBasis ( eVision.Easy3D.E3DPoint e1, eVision.Easy3D.E3DPoint e2, eVision.Easy3D.E3DPoint e3, eVision.Easy3D.E3DPoint t )

static

Creates a orthonormal eVision.Easy3D.E3DTransformMatrix basis (corresponds to a rigid transformation).

The vector e1, e2, e3 should form a right-handed orthogonal basis.

Parameters

e1	Vector 1.
e2	Vector 2.
e3	Vector 3.
t	Translation.

CreateOrthographicProjectionMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateOrthographicProjectionMatrix ( float width, float height )

static

Creates an orthographic projection eVision.Easy3D.E3DTransformMatrix.

Parameters

width	Width of the viewport.
height	Height of the viewport.

CreatePerspectiveProjectionMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreatePerspectiveProjectionMatrix ( float distance, float width, float height )

static

Creates a perspective projection eVision.Easy3D.E3DTransformMatrix.

Parameters

distance	Distance of the viewport to the origin.
width	Width of the viewport.
height	Height of the viewport.

CreateRotationMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateRotationMatrix ( eVision.Easy3D.E3DPoint axis, float angle )

static

Creates a rotation eVision.Easy3D.E3DTransformMatrix around the given axis for the given angle.

Parameters

axis	Rotation axis.
angle	Rotation angle.

CreateRotationXMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateRotationXMatrix ( float angle )

static

Creates a rotation eVision.Easy3D.E3DTransformMatrix around the X axis matrix.

Parameters

angle

Rotation angle.

CreateRotationYMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateRotationYMatrix ( float angle )

static

Creates a rotation eVision.Easy3D.E3DTransformMatrix around the Y axis matrix.

Parameters

angle

Rotation angle.

CreateRotationZMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateRotationZMatrix ( float angle )

static

Creates a rotation eVision.Easy3D.E3DTransformMatrix around the Z axis matrix.

Parameters

angle

Rotation angle.

CreateTranslationMatrix()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.CreateTranslationMatrix ( float dX, float dY, float dZ )

static

Creates a translation eVision.Easy3D.E3DTransformMatrix.

Parameters

dX	Translation along the X axis.
dY	Translation along the Y axis.
dZ	Translation along the Z axis.

EulerAngles()

eVision.Easy3D.E3DPoint eVision.Easy3D.E3DTransformMatrix.EulerAngles

(

self

)

Gets the Euler angles for the rotation represented by this transformation.

The returned value is a 3D point with Euler angles around X, Y and Z axis. The eVision.Easy3D.E3DTransformMatrix must be rigid (translation and rotation only).

GetOrthoBasis()

None eVision.Easy3D.E3DTransformMatrix.GetOrthoBasis	(		self,
		eVision.Easy3D.E3DPoint	e1,
		eVision.Easy3D.E3DPoint	e2,
		eVision.Easy3D.E3DPoint	e3,
		eVision.Easy3D.E3DPoint	t )

Gets the orthogonal basis represented by this transformation or throws an exception if it is not a rigid transformation.

Parameters

e1	Vector 1.
e2	Vector 2.
e3	Vector 3.
t	Translation.

GetValue()

float eVision.Easy3D.E3DTransformMatrix.GetValue	(		self,
		int	column,
		int	row )

Gets a value from the eVision.Easy3D.E3DTransformMatrix object.

Parameters

column	Column of the value to get, from 0 to 3.
row	Row of the value to get, from 0 to 3.

Inverse()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.Inverse

(

self

)

Returns the inverted eVision.Easy3D.E3DTransformMatrix.

An exception will be thrown if the determinant of the matrix is 0.

IsRigid()

bool eVision.Easy3D.E3DTransformMatrix.IsRigid

(

self

)

Checks that the transformation is a rigid transformation (keep the distances and angles).

Load() [1/2]

None eVision.Easy3D.E3DTransformMatrix.Load	(		self,
		eVision.ESerializer | None	serializer )

Loads the eVision.Easy3D.E3DTransformMatrix object.

The given eVision.ESerializer must have been created for reading.

Parameters

serializer

The serializer.

Load() [2/2]

None eVision.Easy3D.E3DTransformMatrix.Load	(		self,
		str	path )

Loads the eVision.Easy3D.E3DTransformMatrix object.

The given eVision.ESerializer must have been created for reading.

Parameters

path	The file path.

Save() [1/2]

None eVision.Easy3D.E3DTransformMatrix.Save	(		self,
		eVision.ESerializer | None	serializer )

Saves the eVision.Easy3D.E3DTransformMatrix object.

The given eVision.ESerializer must have been created for writing.

Parameters

serializer

The eVision.ESerializer object that is written to.

Save() [2/2]

None eVision.Easy3D.E3DTransformMatrix.Save	(		self,
		str	path )

Saves the eVision.Easy3D.E3DTransformMatrix object.

The given eVision.ESerializer must have been created for writing.

Parameters

path	The file path.

SetValue()

None eVision.Easy3D.E3DTransformMatrix.SetValue	(		self,
		int	column,
		int	row,
		float	value )

Sets a value in the eVision.Easy3D.E3DTransformMatrix object.

Parameters

column	Column of the value to set, from 0 to 3.
row	Row of the value to set, from 0 to 3.
value	Value to set.

Transpose()

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.E3DTransformMatrix.Transpose

(

self

)

Returns the transposed eVision.Easy3D.E3DTransformMatrix.

If the matrix is orthogonal (rotation only transformation), the transposed matrix is the inverse transformation.