The class defines a first order linear transformation. More...

#include <mlScaleShiftData.h>

Public Types
enum	ReorderMode { NoReordering = 0 , ReorderColorPlanesToInterleaved = 1 }
	Mode that indicates whether copySubImage should reorder the color from planes (from x,y,z,c,t,u) to interleaved format (c,x,y,z,c,t,u). More...

Public Member Functions
ReorderMode	getReorderMode () const
	Returns the reorder mode.

void	setReorderMode (ReorderMode mode)
	Sets the reorder mode.

Initialization
	TScaleShiftData ()
	Default constructor, i.e., builds identity transformation.

	TScaleShiftData (const TScaleShiftData< DT > &ssd)
	Copy constructor.

	TScaleShiftData (DT scale, DT shift)
	Constructor: sets `scale` and `shift` to define a transformation so that a scaled value v' is v' = v*scale + shift.

	TScaleShiftData (DT fromMin, DT fromMax, DT toMin, DT toMax)
	Values from interval [`fromMin`, `fromMax`] are transformed linearly into [`toMin`, `toMax`].

Assignment.
TScaleShiftData &	operator= (const TScaleShiftData< DT > &ssd)
	Assignment operator from an existing object to get an identical copy.

Comparison.
bool	operator== (const TScaleShiftData< DT > &ssd) const
	Returns `true` if all members are equal.

bool	operator!= (const TScaleShiftData< DT > &ssd) const
	Returns `true` if any members differ.

Set transformation
void	setScaleOffset (DT scale, DT shift)
	Sets `scale` and `shift:` values are multiplied with `scale` and then `shift` is added.

void	setFromMinMaxToMinMax (DT fromMin, DT fromMax, DT toMin, DT toMax)
	Values from interval [`fromMin`, `fromMax`] are transformed linearly into [`toMin`, `toMax`].

void	setFromMinMaxToMinMax (MLDataType fromType, DT fromMin, DT fromMax, MLDataType toType, DT toMin, DT toMax)
	Values from interval [`fromMin`, `fromMax`] are transformed linearly into [`toMin`, `toMax`].

void	unset ()
	Sets the default, i.e., identity transformation.

Query transformation values.
DT	getScale () const
	Returns the scale constant of the transformation y=scale*x+offset.

DT	getShift () const
	Returns the addition constant of the transformation y=scale*x+shift.

Detailed Description

template<typename DT>
class ml::TScaleShiftData< DT >

The class defines a first order linear transformation.

It is used as a container for the parameters scale and shift of a linear transformation y=scale*x+shift.

Notes:

The transformation parameters are used in the class Host to transform voxels values before copying pages into a result image tile. This way, data loss can be avoided that could occur on a possible type casting if image data is converted to another data type. For example, if float voxel data from interval [0,1] is cast to MLint16, it usually would lose precision information. By scaling it with TScaleShiftData(0, 65535,99), it is copied to another value range.
Since all member functions are inlined, we do not need to export this class, as that would inhibit inline usage.
This class is intended to be instantiated only with scalar floating point types for DT. For other types, no experiences or tests exist, although instantiations with integer types is not forbidden and could be useful in certain contexts.

Definition at line 54 of file mlScaleShiftData.h.

Member Enumeration Documentation

◆ ReorderMode

template<typename DT >

enum ml::TScaleShiftData::ReorderMode

Mode that indicates whether copySubImage should reorder the color from planes (from x,y,z,c,t,u) to interleaved format (c,x,y,z,c,t,u).

Note that a SubImage with interleaved color data will not be fully functional, since it will not have correct internal strides, etc. Typically ReorderMode::ReorderColorPlanesToInterleaved is used to convert color images for usage with OpenGL or other APIs that require RGBRGBRGB... or RGBARGBA... data.

Enumerator
NoReordering	< No reodering is done.
ReorderColorPlanesToInterleaved	< Reorders the color planes to interleaved format.

Definition at line 65 of file mlScaleShiftData.h.

Constructor & Destructor Documentation

◆ TScaleShiftData() [1/4]

template<typename DT >

ml::TScaleShiftData< DT >::TScaleShiftData ( )

inline

Default constructor, i.e., builds identity transformation.

Definition at line 76 of file mlScaleShiftData.h.

◆ TScaleShiftData() [2/4]

template<typename DT >

ml::TScaleShiftData< DT >::TScaleShiftData ( const TScaleShiftData< DT > & ssd )

inline

Copy constructor.

Definition at line 84 of file mlScaleShiftData.h.

◆ TScaleShiftData() [3/4]

template<typename DT >

ml::TScaleShiftData< DT >::TScaleShiftData	(	DT	scale,
		DT	shift )

inline

Constructor: sets scale and shift to define a transformation so that a scaled value v' is v' = v*scale + shift.

Definition at line 93 of file mlScaleShiftData.h.

◆ TScaleShiftData() [4/4]

template<typename DT >

ml::TScaleShiftData< DT >::TScaleShiftData	(	DT	fromMin,
		DT	fromMax,
		DT	toMin,
		DT	toMax )

inline

Values from interval [fromMin, fromMax] are transformed linearly into [toMin, toMax].

If necessary, interval borders are swapped to guarantee that minimum values are smaller or equal than maximum values. In case that fromMin and fromMax are identical, _scale is set to 1 and _shift is set to toMin - fromMin. This way, the only value from that interval is projected to the minimum value of the target interval. ATTENTION: This transformation defines no clipping/clamping. If values outside [fromMin, fromMax] are transformed, they will be transformed to values outside [toMin, toMax].

Definition at line 107 of file mlScaleShiftData.h.

References mlrange_cast().

Member Function Documentation

◆ getReorderMode()

template<typename DT >

ReorderMode ml::TScaleShiftData< DT >::getReorderMode ( ) const

inline

Returns the reorder mode.

Definition at line 304 of file mlScaleShiftData.h.

◆ getScale()

template<typename DT >

DT ml::TScaleShiftData< DT >::getScale ( ) const

inline

Returns the scale constant of the transformation y=scale*x+offset.

Definition at line 297 of file mlScaleShiftData.h.

◆ getShift()

template<typename DT >

DT ml::TScaleShiftData< DT >::getShift ( ) const

inline

Returns the addition constant of the transformation y=scale*x+shift.

Definition at line 300 of file mlScaleShiftData.h.

◆ operator!=()

template<typename DT >

bool ml::TScaleShiftData< DT >::operator!= ( const TScaleShiftData< DT > & ssd ) const

inline

Returns true if any members differ.

Definition at line 145 of file mlScaleShiftData.h.

References mlrange_cast().

◆ operator=()

template<typename DT >

TScaleShiftData & ml::TScaleShiftData< DT >::operator= ( const TScaleShiftData< DT > & ssd )

inline

Assignment operator from an existing object to get an identical copy.

Definition at line 121 of file mlScaleShiftData.h.

References mlrange_cast().

◆ operator==()

template<typename DT >

bool ml::TScaleShiftData< DT >::operator== ( const TScaleShiftData< DT > & ssd ) const

inline

Returns true if all members are equal.

Definition at line 138 of file mlScaleShiftData.h.

References mlrange_cast(), and MLValuesAreEqualWOM().

◆ setFromMinMaxToMinMax() [1/2]

template<typename DT >

void ml::TScaleShiftData< DT >::setFromMinMaxToMinMax	(	DT	fromMin,
		DT	fromMax,
		DT	toMin,
		DT	toMax )

inline

Values from interval [fromMin, fromMax] are transformed linearly into [toMin, toMax].

If necessary, then interval borders are swapped to guarantee that minimum values are smaller or equal than maximum values. In case that fromMin and fromMax are identical, _scale is set to 1 and _shift is set to toMin - fromMin. This way, the only value from that interval is projected to the minimum value of the target interval. ATTENTION: This transformation defines no clipping/clamping. If values outside [fromMin, fromMax] are transformed they will be transformed to values outside [toMin, toMax].

Definition at line 175 of file mlScaleShiftData.h.

References mlrange_cast().

◆ setFromMinMaxToMinMax() [2/2]

template<typename DT >

void ml::TScaleShiftData< DT >::setFromMinMaxToMinMax	(	MLDataType	fromType,
		DT	fromMin,
		DT	fromMax,
		MLDataType	toType,
		DT	toMin,
		DT	toMax )

inline

Values from interval [fromMin, fromMax] are transformed linearly into [toMin, toMax].

If necessary, then interval borders are swapped to guarantee that minimum values are smaller or equal than maximum values.

This method handles float/integer data type combinations differently:

Float -> Integer

Adds 0.99 to the integer toMax, since that is almost the same as adding 1.0 and avoids having to clamp the result to the integer maximum value. (as described in 'Zen of Graphics Programming, Michael Abrash').

Integer -> Integer

Adds 1 to the fromMax and toMax ranges, which is the same as shifting for power-of-two differences in range, if input range is greater than output range. Otherwise, leaves as is, so that fromMax maps to toMax.

Integer -> Float

Use range as given. Rationale: use fromMax integer value, and not fromMax+1, so that the maximum integer value will get the maximum float value (as in OpenGL, where the maximum integer value is mapped to 1.0)

Float -> Float

Use range as given.

In case that fromMin and fromMax are identical, _scale is set to 1 and _shift is set to toMin - fromMin. This way, the only value from that interval is projected to the minimum value of the target interval. ATTENTION: This transformation defines no clipping/clamping. If values outside [fromMin, fromMax] are transformed, they will be transformed to values outside [toMin, toMax].

Definition at line 231 of file mlScaleShiftData.h.

References MLIsIntType(), and mlrange_cast().

◆ setReorderMode()

template<typename DT >

void ml::TScaleShiftData< DT >::setReorderMode ( ReorderMode mode )

inline

Sets the reorder mode.

Definition at line 307 of file mlScaleShiftData.h.

◆ setScaleOffset()

template<typename DT >

void ml::TScaleShiftData< DT >::setScaleOffset	(	DT	scale,
		DT	shift )

inline

Sets scale and shift: values are multiplied with scale and then shift is added.

Definition at line 159 of file mlScaleShiftData.h.

◆ unset()

template<typename DT >

void ml::TScaleShiftData< DT >::unset ( )

inline

Sets the default, i.e., identity transformation.

Definition at line 282 of file mlScaleShiftData.h.

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

MeVis/Foundation/Sources/ML/include/mlScaleShiftData.h

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ ReorderMode

Constructor & Destructor Documentation

◆ TScaleShiftData() [1/4]

◆ TScaleShiftData() [2/4]

◆ TScaleShiftData() [3/4]

◆ TScaleShiftData() [4/4]

Member Function Documentation

◆ getReorderMode()

◆ getScale()

◆ getShift()

◆ operator!=()

◆ operator=()

◆ operator==()

◆ setFromMinMaxToMinMax() [1/2]

◆ setFromMinMaxToMinMax() [2/2]

◆ setReorderMode()

◆ setScaleOffset()

◆ unset()