Translation matrix holding floating-point values of type float. More...

Inheritance diagram for CDPL.Math.FTranslationMatrix:

Public Member Functions
None	__init__ (FTranslationMatrix m)
	Constructs a copy of the translation matrix m. More...

None	__init__ (int n, float tx=0.0, float ty=0.0, float tz=0.0)
	Constructs an N×N translation matrix with the supplied per-axis translation components. More...

None	set (float tx=0.0, float ty=0.0, float tz=0.0)
	Sets the per-axis translation components. More...

int	getObjectID ()
	Returns the numeric identifier (ID) of the wrapped C++ class instance. More...

int	getSize1 ()
	Returns the dimension N (the row count). More...

int	getSize2 ()
	Returns the dimension N (the column count). More...

bool	isEmpty ()
	Tells whether the matrix is empty (size zero). More...

float	getElement (int i, int j)
	Returns the translation matrix element at (i, j). More...

object	toArray ()
	Converts the `FTranslationMatrix` instance into a corresponding `numpy.ndarray` object. More...

FTranslationMatrix	assign (FTranslationMatrix m)
	Copy-assigns the dimension and the translation components from m. More...

None	swap (FTranslationMatrix m)
	Swaps the dimension and the translation components with m. More...

float	__call__ (int i, int j)
	Returns the translation matrix element at (i, j). More...

float	__getitem__ (tuple ij)
	Returns the translation matrix element at (i, j). More...

int	__len__ ()
	Returns the number of rows. More...

bool	__eq__ (FTranslationMatrix m)
	Returns the result of the comparison operation `self == m`. More...

bool	__eq__ (ConstFMatrixExpression e)
	Returns the result of the comparison operation `self == e`. More...

bool	__ne__ (FTranslationMatrix m)
	Returns the result of the comparison operation `self != m`. More...

bool	__ne__ (ConstFMatrixExpression e)
	Returns the result of the comparison operation `self != e`. More...

str	__str__ ()
	Returns a string representation of the `FTranslationMatrix` instance. More...

FTranslationMatrix	__pos__ ()
	Returns self. More...

ConstFMatrixExpression	__neg__ ()
	Returns the result of the operation `self * -1`. More...

ConstFMatrixExpression	__add__ (ConstFMatrixExpression e)
	Returns the result of the addition operation `self + e`. More...

ConstFMatrixExpression	__sub__ (ConstFMatrixExpression e)
	Returns the result of the subtraction operation `self - e`. More...

ConstFMatrixExpression	__mul__ (float t)
	Returns the result of the multiplication operation `self * t`. More...

ConstFMatrixExpression	__mul__ (ConstFMatrixExpression e)
	Returns the result of the multiplication operation `self * e`. More...

ConstFVectorExpression	__mul__ (ConstFVectorExpression e)
	Returns the result of the multiplication operation `self * e`. More...

ConstFMatrixExpression	__div__ (float t)
	Returns the result of the division operation `self // t`. More...

ConstFMatrixExpression	__truediv__ (float t)
	Returns the result of the true division operation `self / t`. More...

ConstFMatrixExpression	__rmul__ (float t)
	Returns the result of the multiplication operation `t * self`. More...

Properties
	objectID = property(getObjectID)

	size1 = property(getSize1)

	size2 = property(getSize2)

Detailed Description

Translation matrix holding floating-point values of type float.

Constructor & Destructor Documentation

◆ init() [1/2]

None CDPL.Math.FTranslationMatrix.__init__ ( FTranslationMatrix m )

Constructs a copy of the translation matrix m.

Parameters

m	The translation matrix to copy.

◆ init() [2/2]

None CDPL.Math.FTranslationMatrix.__init__	(	int	n,
		float	tx = `0.0`,
		float	ty = `0.0`,
		float	tz = `0.0`
	)

Constructs an N×N translation matrix with the supplied per-axis translation components.

Parameters

n	The matrix dimension N.
tx	The x-axis translation.
ty	The y-axis translation.
tz	The z-axis translation.

Member Function Documentation

◆ set()

None CDPL.Math.FTranslationMatrix.set	(	float	tx = `0.0`,
		float	ty = `0.0`,
		float	tz = `0.0`
	)

Sets the per-axis translation components.

Parameters

tx	The x-axis translation.
ty	The y-axis translation.
tz	The z-axis translation.

◆ getObjectID()

int CDPL.Math.FTranslationMatrix.getObjectID ( )

Returns the numeric identifier (ID) of the wrapped C++ class instance.

Different Python FTranslationMatrix instances may reference the same underlying C++ class instance. The commonly used Python expression a is not b thus cannot tell reliably whether the two FTranslationMatrix instances a and b reference different C++ objects. The numeric identifier returned by this method allows to correctly implement such an identity test via the simple expression a.getObjectID() != b.getObjectID().

Returns: The numeric ID of the internally referenced C++ class instance.

◆ getSize1()

int CDPL.Math.FTranslationMatrix.getSize1 ( )

Returns the dimension N (the row count).

Returns: N.

◆ getSize2()

int CDPL.Math.FTranslationMatrix.getSize2 ( )

Returns the dimension N (the column count).

Returns: N.

◆ isEmpty()

bool CDPL.Math.FTranslationMatrix.isEmpty ( )

Tells whether the matrix is empty (size zero).

Returns: True if N is zero, and False otherwise.

◆ getElement()

float CDPL.Math.FTranslationMatrix.getElement	(	int	i,
		int	j
	)

Returns the translation matrix element at (i, j).

Parameters

i	The zero-based row index.
j	The zero-based column index.

Returns: 1 on the diagonal, the corresponding translation component in the last column (rows 0-2) and 0 elsewhere.

Exceptions

Base.IndexError if either index is out of range.

◆ toArray()

object CDPL.Math.FTranslationMatrix.toArray ( )

Converts the FTranslationMatrix instance into a corresponding numpy.ndarray object.

Returns: The generated numpy.ndarray object.

See also: [NUMPY]

◆ assign()

FTranslationMatrix CDPL.Math.FTranslationMatrix.assign ( FTranslationMatrix m )

Copy-assigns the dimension and the translation components from m.

Parameters

m	The source translation matrix.

Returns: self.

◆ swap()

None CDPL.Math.FTranslationMatrix.swap ( FTranslationMatrix m )

Swaps the dimension and the translation components with m.

Parameters

m	The translation matrix to swap with.

◆ call()

float CDPL.Math.FTranslationMatrix.__call__	(	int	i,
		int	j
	)

Returns the translation matrix element at (i, j).

Parameters

i	The zero-based row index.
j	The zero-based column index.

Returns: 1 on the diagonal, the corresponding translation component in the last column (rows 0-2) and 0 elsewhere.

Exceptions

Base.IndexError if either index is out of range.

◆ getitem()

float CDPL.Math.FTranslationMatrix.__getitem__ ( tuple ij )

Returns the translation matrix element at (i, j).

Parameters

i	The zero-based row index.
j	The zero-based column index.

Returns: 1 on the diagonal, the corresponding translation component in the last column (rows 0-2) and 0 elsewhere.

Exceptions

Base.IndexError if either index is out of range.

◆ len()

int CDPL.Math.FTranslationMatrix.__len__ ( )

Returns the number of rows.

Returns: The number of rows.

◆ eq() [1/2]

bool CDPL.Math.FTranslationMatrix.__eq__ ( FTranslationMatrix m )

Returns the result of the comparison operation self == m.

Parameters

m	The `FTranslationMatrix` instance to be compared with.

Returns: The result of the comparison operation.

◆ eq() [2/2]

bool CDPL.Math.FTranslationMatrix.__eq__ ( ConstFMatrixExpression e )

Returns the result of the comparison operation self == e.

Parameters

e	The `ConstFMatrixExpression` instance to be compared with.

Returns: The result of the comparison operation.

◆ ne() [1/2]

bool CDPL.Math.FTranslationMatrix.__ne__ ( FTranslationMatrix m )

Returns the result of the comparison operation self != m.

Parameters

m	The `FTranslationMatrix` instance to be compared with.

Returns: The result of the comparison operation.

◆ ne() [2/2]

bool CDPL.Math.FTranslationMatrix.__ne__ ( ConstFMatrixExpression e )

Returns the result of the comparison operation self != e.

Parameters

e	The `ConstFMatrixExpression` instance to be compared with.

Returns: The result of the comparison operation.

◆ str()

str CDPL.Math.FTranslationMatrix.__str__ ( )

Returns a string representation of the FTranslationMatrix instance.

Returns: The generated string representation.

◆ pos()

FTranslationMatrix CDPL.Math.FTranslationMatrix.__pos__ ( )

Returns self.

Returns: self.

◆ neg()

ConstFMatrixExpression CDPL.Math.FTranslationMatrix.__neg__ ( )

Returns the result of the operation self * -1.

Returns: A ConstFMatrixExpression instance holding the result of the element negation.

◆ add()

ConstFMatrixExpression CDPL.Math.FTranslationMatrix.__add__ ( ConstFMatrixExpression e )

Returns the result of the addition operation self + e.

Parameters

e	Specifies the second addend.

Returns: A ConstFMatrixExpression instance holding the result of the addition.

◆ sub()

ConstFMatrixExpression CDPL.Math.FTranslationMatrix.__sub__ ( ConstFMatrixExpression e )

Returns the result of the subtraction operation self - e.

Parameters

e	Specifies the subtrahend.

Returns: A FTranslationMatrix instance holding the result of the subtraction.

◆ mul() [1/3]

ConstFMatrixExpression CDPL.Math.FTranslationMatrix.__mul__ ( float t )

Returns the result of the multiplication operation self * t.

Parameters

t	Specifies the multiplier.

Returns: A ConstFMatrixExpression instance holding the result of the multiplication.

◆ mul() [2/3]

ConstFMatrixExpression CDPL.Math.FTranslationMatrix.__mul__ ( ConstFMatrixExpression e )

Returns the result of the multiplication operation self * e.

Parameters

e	Specifies the multiplier.

Returns: A ConstFMatrixExpression instance holding the result of the multiplication.

◆ mul() [3/3]

ConstFVectorExpression CDPL.Math.FTranslationMatrix.__mul__ ( ConstFVectorExpression e )

Returns the result of the multiplication operation self * e.

Parameters

e	Specifies the multiplier.

Returns: A ConstFVectorExpression instance holding the result of the multiplication.

◆ div()

ConstFMatrixExpression CDPL.Math.FTranslationMatrix.__div__ ( float t )

Returns the result of the division operation self // t.

Parameters

t	Specifies the divisor.

Returns: A ConstFMatrixExpression instance holding the result of the division.

◆ truediv()

ConstFMatrixExpression CDPL.Math.FTranslationMatrix.__truediv__ ( float t )

Returns the result of the true division operation self / t.

Parameters

t	Specifies the divisor.

Returns: A ConstFMatrixExpression instance holding the result of the division.

◆ rmul()

ConstFMatrixExpression CDPL.Math.FTranslationMatrix.__rmul__ ( float t )

Returns the result of the multiplication operation t * self.

Parameters

t	Specifies the multiplicand.

Returns: A ConstFMatrixExpression instance holding the result of the multiplication.

Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ __init__() [1/2]

◆ __init__() [2/2]

Member Function Documentation

◆ set()

◆ getObjectID()

◆ getSize1()

◆ getSize2()

◆ isEmpty()

◆ getElement()

◆ toArray()

◆ assign()

◆ swap()

◆ __call__()

◆ __getitem__()

◆ __len__()

◆ __eq__() [1/2]

◆ __eq__() [2/2]

◆ __ne__() [1/2]

◆ __ne__() [2/2]

◆ __str__()

◆ __pos__()

◆ __neg__()

◆ __add__()

◆ __sub__()

◆ __mul__() [1/3]

◆ __mul__() [2/3]

◆ __mul__() [3/3]

◆ __div__()

◆ __truediv__()

◆ __rmul__()

◆ init() [1/2]

◆ init() [2/2]

◆ call()

◆ getitem()

◆ len()

◆ eq() [1/2]

◆ eq() [2/2]

◆ ne() [1/2]

◆ ne() [2/2]

◆ str()

◆ pos()

◆ neg()

◆ add()

◆ sub()

◆ mul() [1/3]

◆ mul() [2/3]

◆ mul() [3/3]

◆ div()

◆ truediv()

◆ rmul()