A structure that describes the scale, rotation and translation transformation in 3D space. More...

#include <kanzi/core/math/srt_value_3d.hpp>

Inheritance diagram for kanzi::SRTValue3D:

Public Member Functions
KZ_NO_DISCARD Quaternion	getRotation () const
	Returns the rotation as a quaternion.

KZ_NO_DISCARD Vector3	getScale () const
	Returns the scale.

KZ_NO_DISCARD float	getScaleX () const
	Returns the scale along the x-axis.

KZ_NO_DISCARD float	getScaleY () const
	Returns the scale along the y-axis.

KZ_NO_DISCARD float	getScaleZ () const
	Returns the scale along the z-axis.

KZ_NO_DISCARD Vector3	getTranslation () const
	Returns the translation.

KZ_NO_DISCARD float	getTranslationX () const
	Returns the translation along the x-axis.

KZ_NO_DISCARD float	getTranslationY () const
	Returns the translation along the y-axis.

KZ_NO_DISCARD float	getTranslationZ () const
	Returns the translation along the z-axis.

void	rotate (Quaternion rotation)
	Applies a rotation to the current rotation.

KZ_NO_DISCARD SRTValue3D	rotated (Quaternion rotation) const
	Rotates the SRT object.

void	scale (Vector3 factor)
	Multiplies the current scale with the provided scaling factor.

KZ_NO_DISCARD SRTValue3D	scaled (Vector3 scale) const
	Scales the SRT object.

void	setRotation (Quaternion value)
	Sets the rotation.

void	setRotation (Vector3 eulerAnglesInRadians)
	Sets the rotation.

void	setScale (Vector3 value)
	Sets the scale.

void	setScaleX (float value)
	Sets the scale along the x-axis.

void	setScaleY (float value)
	Sets the scale along the y-axis.

void	setScaleZ (float value)
	Sets the scale along the z-axis.

void	setTranslation (Vector3 value)
	Sets the translation.

void	setTranslationX (float value)
	Sets the translation along the x-axis.

void	setTranslationY (float value)
	Sets the translation along the y-axis.

void	setTranslationZ (float value)
	Sets the translation along the z-axis.

	SRTValue3D ()
	Default constructor.

	SRTValue3D (Vector3 scale, Quaternion rotation, Vector3 translation)
	Constructor with the supplied scale, rotation as a quaternion, and translation.

	SRTValue3D (Vector3 scale, Vector3 eulerAnglesInRadians, Vector3 translation)
	Constructor with the supplied scale, rotation angle, and translation.

KZ_NO_DISCARD Matrix4x4	toMatrix () const
	Converts the SRT representation to Matrix4x4 transform.

void	translate (Vector3 translation)
	Adds the provided translation to the current translation.

KZ_NO_DISCARD SRTValue3D	translated (Vector3 translation) const
	Translates the SRT object.

Static Public Member Functions
static KZ_NO_DISCARD optional< SRTValue3D >	create (const Matrix4x4 &matrix)
	Attempts to create an SRT object from a given transformation 4x4 matrix.

static KZ_NO_DISCARD SRTValue3D	createScale (Vector3 scale)
	Creates a scale SRT.

static KZ_NO_DISCARD SRTValue3D	createTranslation (Vector3 translation)
	Creates a translation SRT.

static KZ_NO_DISCARD SRTValue3D	createUniformScale (float scale)
	Creates a uniform scale SRT.

Friends
KZ_NO_DISCARD friend bool	operator!= (const SRTValue3D &left, const SRTValue3D &right)
	Inequality operator.

KZ_NO_DISCARD friend bool	operator== (const SRTValue3D &left, const SRTValue3D &right)
	Equality operator.

Detailed Description

A structure that describes the scale, rotation and translation transformation in 3D space.

Rotation is stored as quaternion, with the angle in radians.

Constructor & Destructor Documentation

◆ SRTValue3D() [1/3]

kanzi::SRTValue3D::SRTValue3D ( )

inlineexplicit

Default constructor.

◆ SRTValue3D() [2/3]

kanzi::SRTValue3D::SRTValue3D	(	Vector3	scale,
		Vector3	eulerAnglesInRadians,
		Vector3	translation )

inlineexplicit

Constructor with the supplied scale, rotation angle, and translation.

Parameters

scale	The scale.
eulerAnglesInRadians	The rotation in Euler angles (radians).
translation	The translation.

◆ SRTValue3D() [3/3]

kanzi::SRTValue3D::SRTValue3D	(	Vector3	scale,
		Quaternion	rotation,
		Vector3	translation )

inlineexplicit

Constructor with the supplied scale, rotation as a quaternion, and translation.

Parameters

scale	The scale.
rotation	The rotation.
translation	The translation.

Member Function Documentation

◆ getScale()

KZ_NO_DISCARD Vector3 kanzi::SRTValue3D::getScale ( ) const

inline

Returns the scale.

Returns: The scale.

◆ setScale()

void kanzi::SRTValue3D::setScale ( Vector3 value )

inline

Sets the scale.

Parameters

value The scale.

◆ getScaleX()

KZ_NO_DISCARD float kanzi::SRTValue3D::getScaleX ( ) const

inline

Returns the scale along the x-axis.

Returns: The x component of the scale.

◆ setScaleX()

void kanzi::SRTValue3D::setScaleX ( float value )

inline

Sets the scale along the x-axis.

Parameters

value The x component of the scale.

◆ getScaleY()

KZ_NO_DISCARD float kanzi::SRTValue3D::getScaleY ( ) const

inline

Returns the scale along the y-axis.

Returns: The y component of the scale.

◆ setScaleY()

void kanzi::SRTValue3D::setScaleY ( float value )

inline

Sets the scale along the y-axis.

Parameters

value The y component of the scale.

◆ getScaleZ()

KZ_NO_DISCARD float kanzi::SRTValue3D::getScaleZ ( ) const

inline

Returns the scale along the z-axis.

Returns: The z component of the scale.

◆ setScaleZ()

void kanzi::SRTValue3D::setScaleZ ( float value )

inline

Sets the scale along the z-axis.

Parameters

value The z component of the scale.

◆ scale()

void kanzi::SRTValue3D::scale ( Vector3 factor )

inline

Multiplies the current scale with the provided scaling factor.

Parameters

factor The scaling factor.

◆ getRotation()

KZ_NO_DISCARD Quaternion kanzi::SRTValue3D::getRotation ( ) const

inline

Returns the rotation as a quaternion.

Returns: The rotation.

◆ setRotation() [1/2]

void kanzi::SRTValue3D::setRotation ( Quaternion value )

inline

Sets the rotation.

Parameters

value Rotation as a quaternion.

◆ setRotation() [2/2]

void kanzi::SRTValue3D::setRotation ( Vector3 eulerAnglesInRadians )

inline

Sets the rotation.

Parameters

eulerAnglesInRadians Rotation angle as Euler angle in radians.

◆ getTranslation()

KZ_NO_DISCARD Vector3 kanzi::SRTValue3D::getTranslation ( ) const

inline

Returns the translation.

Returns: The translation.

◆ setTranslation()

void kanzi::SRTValue3D::setTranslation ( Vector3 value )

inline

Sets the translation.

Parameters

value The translation.

◆ translate()

void kanzi::SRTValue3D::translate ( Vector3 translation )

inline

Adds the provided translation to the current translation.

Parameters

translation The translation term.

◆ getTranslationX()

KZ_NO_DISCARD float kanzi::SRTValue3D::getTranslationX ( ) const

inline

Returns the translation along the x-axis.

Returns: The x component of the translation.

◆ setTranslationX()

void kanzi::SRTValue3D::setTranslationX ( float value )

inline

Sets the translation along the x-axis.

Parameters

value The x component of the translation.

◆ getTranslationY()

KZ_NO_DISCARD float kanzi::SRTValue3D::getTranslationY ( ) const

inline

Returns the translation along the y-axis.

Returns: The y component of the translation.

◆ setTranslationY()

void kanzi::SRTValue3D::setTranslationY ( float value )

inline

Sets the translation along the y-axis.

Parameters

value The y component of the translation.

◆ getTranslationZ()

KZ_NO_DISCARD float kanzi::SRTValue3D::getTranslationZ ( ) const

inline

Returns the translation along the z-axis.

Returns: The z component of the translation.

◆ setTranslationZ()

void kanzi::SRTValue3D::setTranslationZ ( float value )

inline

Sets the translation along the z-axis.

Parameters

value The z component of the translation.

◆ rotate()

void kanzi::SRTValue3D::rotate ( Quaternion rotation )

Applies a rotation to the current rotation.

Parameters

rotation Rotation quaternion.

◆ toMatrix()

KZ_NO_DISCARD Matrix4x4 kanzi::SRTValue3D::toMatrix ( ) const

Converts the SRT representation to Matrix4x4 transform.

Returns: A matrix representation of the SRT object.

◆ create()

static KZ_NO_DISCARD optional< SRTValue3D > kanzi::SRTValue3D::create ( const Matrix4x4 & matrix )

static

Attempts to create an SRT object from a given transformation 4x4 matrix.

Note that you can decompose a matrix into SRT only if its column vectors are orthogonal to each other.

Parameters

matrix The transformation 4x4 matrix.

Returns: If the matrix is decomposable, returns an SRTValue3D object, otherwise nullopt.

◆ createScale()

static KZ_NO_DISCARD SRTValue3D kanzi::SRTValue3D::createScale ( Vector3 scale )

inlinestatic

Creates a scale SRT.

Parameters

scale The scale.

Returns: An SRT object with scale.

◆ createUniformScale()

static KZ_NO_DISCARD SRTValue3D kanzi::SRTValue3D::createUniformScale ( float scale )

inlinestatic

Creates a uniform scale SRT.

Parameters

scale The scale.

Returns: An SRT object with scale.

◆ createTranslation()

static KZ_NO_DISCARD SRTValue3D kanzi::SRTValue3D::createTranslation ( Vector3 translation )

inlinestatic

Creates a translation SRT.

Parameters

translation The translation.

Returns: An SRT object with translation.

◆ translated()

KZ_NO_DISCARD SRTValue3D kanzi::SRTValue3D::translated ( Vector3 translation ) const

inline

Translates the SRT object.

Parameters

translation The translation term.

Returns: A new SRT object with the translation applied.

◆ scaled()

KZ_NO_DISCARD SRTValue3D kanzi::SRTValue3D::scaled ( Vector3 scale ) const

inline

Scales the SRT object.

Parameters

scale The scaling factor.

Returns: A new SRT object with the scale applied.

◆ rotated()

KZ_NO_DISCARD SRTValue3D kanzi::SRTValue3D::rotated ( Quaternion rotation ) const

inline

Rotates the SRT object.

Parameters

rotation The rotation.

Returns: A new SRT object with the rotation applied.

Friends And Related Symbol Documentation

◆ operator==

KZ_NO_DISCARD friend bool operator==	(	const SRTValue3D &	left,
		const SRTValue3D &	right )

friend

Equality operator.

Parameters

left	The left operand.
right	The right operand.

Returns: If the left and right operand are equal, true, otherwise false.

◆ operator!=

KZ_NO_DISCARD friend bool operator!=	(	const SRTValue3D &	left,
		const SRTValue3D &	right )

friend

Inequality operator.

Parameters

left	The left operand.
right	The right operand.

Returns: If the left and right operand are not equal, true, otherwise false.

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

kanzi/core/math/srt_value_3d.hpp

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ SRTValue3D() [1/3]

◆ SRTValue3D() [2/3]

◆ SRTValue3D() [3/3]

Member Function Documentation

◆ getScale()

◆ setScale()

◆ getScaleX()

◆ setScaleX()

◆ getScaleY()

◆ setScaleY()

◆ getScaleZ()

◆ setScaleZ()

◆ scale()

◆ getRotation()

◆ setRotation() [1/2]

◆ setRotation() [2/2]

◆ getTranslation()

◆ setTranslation()

◆ translate()

◆ getTranslationX()

◆ setTranslationX()

◆ getTranslationY()

◆ setTranslationY()

◆ getTranslationZ()

◆ setTranslationZ()

◆ rotate()

◆ toMatrix()

◆ create()

◆ createScale()

◆ createUniformScale()

◆ createTranslation()

◆ translated()

◆ scaled()

◆ rotated()

Friends And Related Symbol Documentation

◆ operator==

◆ operator!=