\( N \times N \) diagonal scaling matrix. More...

#include <AffineTransform.hpp>

Inheritance diagram for CDPL::Math::ScalingMatrix< T >:

Public Types
typedef T	ValueType
	The scalar value type. More...

typedef const T	Reference
	Reference type (always a `const` reference — elements are computed). More...

typedef const T	ConstReference
	Constant reference type to an element. More...

typedef std::size_t	SizeType
	The unsigned size type. More...

typedef std::ptrdiff_t	DifferenceType
	The signed difference type. More...

typedef MatrixReference< SelfType >	ClosureType
	Closure type used when this matrix appears inside another expression. More...

typedef const MatrixReference< const SelfType >	ConstClosureType
	Constant closure type used when this matrix appears inside another expression. More...

typedef Matrix< T, std::vector< T > >	MatrixTemporaryType
	Concrete temporary matrix type used by expression-template machinery. More...

typedef Vector< T, std::vector< T > >	VectorTemporaryType
	Concrete temporary vector type used when assembling vectors from this matrix. More...

Public Types inherited from CDPL::Math::MatrixContainer< ScalingMatrix< T > >
typedef ScalingMatrix< T >	ContainerType
	The derived matrix container type. More...

Public Types inherited from CDPL::Math::MatrixExpression< E >
typedef E	ExpressionType
	The derived matrix expression type. More...

Public Types inherited from CDPL::Math::Expression< E >
typedef E	ExpressionType
	The derived expression type (made available to expression-template machinery). More...

Public Member Functions
	ScalingMatrix (SizeType n, const ValueType &sx=ValueType(1), const ValueType &sy=ValueType(1), const ValueType &sz=ValueType(1))
	Constructs an \( N \times N \) scaling matrix with the supplied per-axis scale factors. More...

	ScalingMatrix (const ScalingMatrix &m)
	Constructs a copy of the scaling matrix m. More...

void	set (const ValueType &sx=ValueType(1), const ValueType &sy=ValueType(1), const ValueType &sz=ValueType(1))
	Sets the per-axis scale factors. More...

ConstReference	operator() (SizeType i, SizeType j) const
	Returns the scaling-matrix entry at (i, j). More...

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

SizeType	getSize1 () const
	Returns the dimension N (the row count). More...

SizeType	getSize2 () const
	Returns the dimension N (the column count). More...

SizeType	getMaxSize1 () const
	Returns the maximum representable row count. More...

SizeType	getMaxSize2 () const
	Returns the maximum representable column count. More...

ScalingMatrix &	operator= (const ScalingMatrix &m)
	Copy-assigns the dimension and the per-axis scale factors from m. More...

void	swap (ScalingMatrix &m)
	Swaps the dimension and the per-axis scale factors with m. More...

void	resize (SizeType n)
	Resizes the matrix dimension to n (the scale factors are left unchanged). More...

Public Member Functions inherited from CDPL::Math::MatrixContainer< ScalingMatrix< T > >
const ContainerType &	operator() () const
	Returns a `const` reference to the derived matrix container. More...

ContainerType &	operator() ()
	Returns a reference to the derived matrix container. More...

Public Member Functions inherited from CDPL::Math::MatrixExpression< E >
const ExpressionType &	operator() () const
	Returns a `const` reference to the derived matrix expression. More...

ExpressionType &	operator() ()
	Returns a reference to the derived matrix expression. More...

Friends
void	swap (ScalingMatrix &m1, ScalingMatrix &m2)
	ADL-enabled free-function form of swap(). More...

Additional Inherited Members
Protected Member Functions inherited from CDPL::Math::MatrixContainer< ScalingMatrix< T > >
	MatrixContainer ()

	~MatrixContainer ()

Protected Member Functions inherited from CDPL::Math::MatrixExpression< E >
	MatrixExpression ()

	~MatrixExpression ()

Protected Member Functions inherited from CDPL::Math::Expression< E >
	Expression ()

	~Expression ()

Detailed Description

template<typename T>
class CDPL::Math::ScalingMatrix< T >

\( N \times N \) diagonal scaling matrix.

The diagonal entries hold the per-axis scale factors; all off-diagonal entries are 0. The size \( N \) is configurable so the matrix can be combined with homogeneous coordinates.

Template Parameters

T	The scalar value type.

Member Typedef Documentation

◆ ValueType

template<typename T >

typedef T CDPL::Math::ScalingMatrix< T >::ValueType

The scalar value type.

◆ Reference

template<typename T >

typedef const T CDPL::Math::ScalingMatrix< T >::Reference

Reference type (always a const reference — elements are computed).

◆ ConstReference

template<typename T >

typedef const T CDPL::Math::ScalingMatrix< T >::ConstReference

Constant reference type to an element.

◆ SizeType

template<typename T >

typedef std::size_t CDPL::Math::ScalingMatrix< T >::SizeType

The unsigned size type.

◆ DifferenceType

template<typename T >

typedef std::ptrdiff_t CDPL::Math::ScalingMatrix< T >::DifferenceType

The signed difference type.

◆ ClosureType

template<typename T >

typedef MatrixReference<SelfType> CDPL::Math::ScalingMatrix< T >::ClosureType

Closure type used when this matrix appears inside another expression.

◆ ConstClosureType

template<typename T >

typedef const MatrixReference<const SelfType> CDPL::Math::ScalingMatrix< T >::ConstClosureType

Constant closure type used when this matrix appears inside another expression.

◆ MatrixTemporaryType

template<typename T >

typedef Matrix<T, std::vector<T> > CDPL::Math::ScalingMatrix< T >::MatrixTemporaryType

Concrete temporary matrix type used by expression-template machinery.

◆ VectorTemporaryType

template<typename T >

typedef Vector<T, std::vector<T> > CDPL::Math::ScalingMatrix< T >::VectorTemporaryType

Concrete temporary vector type used when assembling vectors from this matrix.

Constructor & Destructor Documentation

◆ ScalingMatrix() [1/2]

template<typename T >

CDPL::Math::ScalingMatrix< T >::ScalingMatrix	(	SizeType	n,
		const ValueType &	sx = `ValueType(1)`,
		const ValueType &	sy = `ValueType(1)`,
		const ValueType &	sz = `ValueType(1)`
	)

inlineexplicit

Constructs an \( N \times N \) scaling matrix with the supplied per-axis scale factors.

Parameters

n	The matrix dimension N.
sx	The x-axis scale factor (default: 1).
sy	The y-axis scale factor (default: 1).
sz	The z-axis scale factor (default: 1).

◆ ScalingMatrix() [2/2]

template<typename T >

CDPL::Math::ScalingMatrix< T >::ScalingMatrix ( const ScalingMatrix< T > & m )

inline

Constructs a copy of the scaling matrix m.

Parameters

m	The scaling matrix to copy.

Member Function Documentation

◆ set()

template<typename T >

void CDPL::Math::ScalingMatrix< T >::set	(	const ValueType &	sx = `ValueType(1)`,
		const ValueType &	sy = `ValueType(1)`,
		const ValueType &	sz = `ValueType(1)`
	)

inline

Sets the per-axis scale factors.

Parameters

sx	The x-axis scale factor (default: 1).
sy	The y-axis scale factor (default: 1).
sz	The z-axis scale factor (default: 1).

◆ operator()()

template<typename T >

ConstReference CDPL::Math::ScalingMatrix< T >::operator()	(	SizeType	i,
		SizeType	j
	)		const

inline

Returns the scaling-matrix entry at (i, j).

Parameters

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

Returns: The scale factor on the diagonal at positions 0, 1, 2 (1 elsewhere on the diagonal; 0 off the diagonal).

Exceptions

Base::IndexError if either index is out of range.

◆ isEmpty()

template<typename T >

bool CDPL::Math::ScalingMatrix< T >::isEmpty ( ) const

inline

Tells whether the matrix is empty (size zero).

Returns: true if N is zero, and false otherwise.

◆ getSize1()

template<typename T >

SizeType CDPL::Math::ScalingMatrix< T >::getSize1 ( ) const

inline

Returns the dimension N (the row count).

Returns: N.

◆ getSize2()

template<typename T >

SizeType CDPL::Math::ScalingMatrix< T >::getSize2 ( ) const

inline

Returns the dimension N (the column count).

Returns: N.

◆ getMaxSize1()

template<typename T >

SizeType CDPL::Math::ScalingMatrix< T >::getMaxSize1 ( ) const

inline

Returns the maximum representable row count.

Returns: The maximum row count.

◆ getMaxSize2()

template<typename T >

SizeType CDPL::Math::ScalingMatrix< T >::getMaxSize2 ( ) const

inline

Returns the maximum representable column count.

Returns: The maximum column count.

◆ operator=()

template<typename T >

ScalingMatrix& CDPL::Math::ScalingMatrix< T >::operator= ( const ScalingMatrix< T > & m )

inline

Copy-assigns the dimension and the per-axis scale factors from m.

Parameters

m	The source scaling matrix.

Returns: A reference to itself.

◆ swap()

template<typename T >

void CDPL::Math::ScalingMatrix< T >::swap ( ScalingMatrix< T > & m )

inline

Swaps the dimension and the per-axis scale factors with m.

Parameters

m	The scaling matrix to swap with.

◆ resize()

template<typename T >

void CDPL::Math::ScalingMatrix< T >::resize ( SizeType n )

inline

Resizes the matrix dimension to n (the scale factors are left unchanged).

Parameters

n	The new dimension.

Friends And Related Function Documentation

◆ swap

template<typename T >

void swap	(	ScalingMatrix< T > &	m1,
		ScalingMatrix< T > &	m2
	)

friend

ADL-enabled free-function form of swap().

Parameters

m1	The first scaling matrix.
m2	The second scaling matrix.

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

AffineTransform.hpp

Public Types

Public Member Functions

Friends

Additional Inherited Members

Detailed Description

template<typename T> class CDPL::Math::ScalingMatrix< T >

Member Typedef Documentation

◆ ValueType

◆ Reference

◆ ConstReference

◆ SizeType

◆ DifferenceType

◆ ClosureType

◆ ConstClosureType

◆ MatrixTemporaryType

◆ VectorTemporaryType

Constructor & Destructor Documentation

◆ ScalingMatrix() [1/2]

◆ ScalingMatrix() [2/2]

Member Function Documentation

◆ set()

◆ operator()()

◆ isEmpty()

◆ getSize1()

◆ getSize2()

◆ getMaxSize1()

◆ getMaxSize2()

◆ operator=()

◆ swap()

◆ resize()

Friends And Related Function Documentation

◆ swap

template<typename T>
class CDPL::Math::ScalingMatrix< T >