#include <mlTSubImage.h>

Inheritance diagram for ml::TSubImage< DATATYPE >:

Public Types
typedef DATATYPE	ComponentType
	A typedef to 'export' the type of voxels components.
typedef TSubImageCursor< DATATYPE >	Cursor
	A read/write cursor.
typedef ConstTSubImageCursor< DATATYPE >	ConstCursor
	A read-only cursor.

Public Member Functions
Constructors
	TSubImage (const SubImageBox &box, MLDataType dataType, void *data)
	TSubImage ()
	TSubImage (const SubImage &subImage)
	TSubImage (const TSubImage< DATATYPE > &typedSubImage)
	~TSubImage () override=default
	Virtual destructor to suppress compiler warnings.
TSubImage &	operator= (const TSubImage< DATATYPE > &typedSubImage)
Properties of TSubImage
const DATATYPE *	getData () const
	Returns the memory address of the image region. Overloads methods from SubImage.
DATATYPE *	getData ()
Calculation of memory addresses of image voxels
const DATATYPE *	getSubImagePointer (const ImageVector &position) const
DATATYPE *	getSubImagePointer (const ImageVector &position)

const DATATYPE *	getSubImagePointer (MLint x, MLint y, MLint z) const
DATATYPE *	getSubImagePointer (MLint x, MLint y, MLint z)

const DATATYPE *	getImagePointer (const ImageVector &position) const
DATATYPE *	getImagePointer (const ImageVector &position)

const DATATYPE *	getImagePointer (MLint x, MLint y, MLint z) const
DATATYPE *	getImagePointer (MLint x, MLint y, MLint z)
Calculate coordinates from pointers into image data(from memory positions)
ImageVector	convertPointerToSubImagePosition (DATATYPE *pointer) const
void	convertPointerToSubImagePosition (DATATYPE pointer, MLint x, MLint y, MLint z) const
ImageVector	convertPointerToImagePosition (DATATYPE *pointer) const
void	convertPointerToImagePosition (DATATYPE pointer, MLint x, MLint y, MLint z) const
Set/Get voxel data
const DATATYPE &	operator[] (const ImageVector &position) const
DATATYPE &	operator[] (const ImageVector &position)
void	setSubImageValue (const ImageVector &position, DATATYPE value)
DATATYPE	getSubImageValue (const ImageVector &position) const
void	setSubImageValue (MLint x, MLint y, DATATYPE value)
DATATYPE	getSubImageValue (MLint x, MLint y) const
void	setSubImageValue (MLint x, MLint y, MLint z, DATATYPE value)
DATATYPE	getSubImageValue (MLint x, MLint y, MLint z) const
void	setImageValue (const ImageVector &position, DATATYPE value)
DATATYPE	getImageValue (const ImageVector &position) const
void	setImageValue (MLint x, MLint y, DATATYPE value)
DATATYPE	getImageValue (MLint x, MLint y) const
void	setImageValue (MLint x, MLint y, MLint z, DATATYPE value)
DATATYPE	getImageValue (MLint x, MLint y, MLint z) const
Return min/max values of subimage
MLint	calculateMinMax (DATATYPE &minValue, DATATYPE &maxValue, const SubImageBox *const validBox=nullptr) const
Copying voxel from one subimage to another
template<typename FROM_DATATYPE>
void	copySubImageReorderColorPlanesToInterleaved (const TSubImage< FROM_DATATYPE > &typedFromImage, const ScaleShiftData &scaleShiftData)
template<typename FROM_DATATYPE>
void	copySubImageTyped (const TSubImage< FROM_DATATYPE > &typedFromImg, const ScaleShiftData &scaleShiftData)
SUBIMAGE FILLING
void	fill (DATATYPE value)
	Sets all voxel values in subimage to `value`.
void	fillBordersWithValue (const SubImageBox &box, DATATYPE fillValue)
void	fillInvalidRegionWithValue (DATATYPE value)
void	fillInvalidRegionWithBorderValues ()
Public Member Functions inherited from ml::SubImage
const SubImageBox &	getBox () const
	Returns the box describing the origin/extent of the subimage.
void	setSourceImageExtent (const ImageVector &extent)
ImageVector	getSourceImageExtent () const
SubImageBox	getValidRegion () const
MLint	getNumVoxels () const
MLint	getSizeInBytes () const
ImageVector	getStride () const
MLint	getOffset (const ImageVector &voxelPosition) const
	Returns the array index offset from the origin (0,0,0,0,0,0) to the `voxelPosition`.
void	setDataType (MLDataType dataType)
MLDataType	getDataType () const
	Returns the type of image data.
const MLTypeInfos *	getDataTypeInfos () const
	Returns MLTypeInfos for image data type.
MLEXPORT ImageProperties	toImageProperties () const
MLEXPORT void	setFromImageProperties (const ImageProperties &imageProperties)
void	toStream (std::ostream &ostr) const
	SubImage ()
	Constructor: Creates a subimage with no data.
	SubImage (const SubImage &si)
	SubImage (const SubImageBox &box, MLDataType datatype, void *data=nullptr)
	SubImage (const SubImage &si, const ImageVector &offset)
virtual	~SubImage ()=default
	Virtual destructor to suppress compiler warnings.
SubImage &	operator= (const SubImage &si)
void	setBox (const SubImageBox &subImageBox)
void	setBox (const ImageVector &imageExtent)
void	translate (const ImageVector &offset)
	Translates the box of the subimage by adding the vector `offset`.
const ImageVector &	getOrigin () const
	Returns the origin of the subimage, which is identical to getBox().v1.
void	setOrigin (const ImageVector &newOrigin)
ImageVector	getExtent () const
	Returns the extent of the subimage, which is identical to getBox().getExtent().
void	setExtent (MLint x, MLint y, MLint z=1, MLint c=1, MLint t=1, MLint u=1)
void	setExtent (const ImageVector &newExtent)
	Sets the extent of the subimage to `newExtent`. This also changes the strides.
SubImageBox	getBoxFromExtent () const
	Returns the size of image as box with origin 0.
SubImageBox	getBoxFromImageExtent () const
ImageVector	getImageExtent () const
void	setImageExtent (const ImageVector &newExtent)
void *	getSubImagePointer (const ImageVector &voxelPosition) const
void *	getSubImagePointer (MLint x, MLint y, MLint z) const
void *	getImagePointer (const ImageVector &voxelPosition) const
void *	getImagePointer (MLint x, MLint y, MLint z) const
MLEXPORT void	copySubImage (const SubImage &fromImage, const ScaleShiftData &scaleShiftData)
MLEXPORT void	copySubImage (const SubImage &fromImage)
bool	isValidSubImagePosition (const ImageVector &voxelPosition) const
bool	isValidSubImagePosition (MLint x, MLint y, MLint z) const
bool	isValidImagePosition (const ImageVector &voxelPosition) const
bool	isValidImagePosition (MLint x, MLint y, MLint z) const
MLEXPORT void	allocate (MLMemoryErrorHandling handleFailure)
MLEXPORT void	allocateAsMemoryBlockHandle (MLMemoryErrorHandling handleFailure=ML_RETURN_NULL)
	Allocates data using the ML memory manager. For failure handing, see SubImage::allocate().
MLEXPORT void	free ()
MLEXPORT bool	isOneValued () const
MLEXPORT MLint	calculateMinMax (MLdouble &minValue, MLdouble &maxValue, const SubImageBox *const validBox=nullptr) const
MLEXPORT void	compare (const SubImage &subImage2, bool regionsMatch, bool dataTypesMatch, bool thisBoxIsPartOfRegion2, bool region2IsPartOfThisBox, bool overlapHasSameValues, ImageVector firstMismatchPos) const
MLEXPORT void	fill (MLdouble value)
	Fills the subimage with a `value` that is cast to the data type of the subimage.
MLEXPORT void	fillWithTypeData (const MLTypeData *value)
MLEXPORT void	fillBordersWithScalarValue (const SubImageBox &box, MLdouble fillValue)
MLEXPORT void	fillBordersWithTypeData (const SubImageBox &box, const MLTypeData *fillValue)
MLEXPORT void	fillBordersWithInputValues (const SubImageBox &box, const SubImage &inputSubImage)
MLEXPORT void	fillBordersWithBorderValues (const SubImageBox &box)
void	fillInvalidRegionWithScalarValue (MLdouble value)
void	fillInvalidRegionWithTypeData (const MLTypeData *value)
void	fillInvalidRegionWithBorderValues ()
MLEXPORT bool	isValid () const
void *	getData () const
	Returns the memory address of the memory managed by the subimage.
MLEXPORT void	setData (void *data)
MLEXPORT void	setDataFromMemoryBlockHandle (const MLMemoryBlockHandle &data)
const MLMemoryBlockHandle &	getMemoryBlockHandle () const

Additional Inherited Members
static MLEXPORT MLint	coordToIndex (MLint x, MLint y, MLint z, MLint c, MLint t, MLint u, const ImageVector &size)
static MLEXPORT MLint	coordToIndex (const ImageVector &voxelPosition, const ImageVector &size)
static MLEXPORT ImageVector	indexToCoord (MLint index, const ImageVector &extent)
Protected Member Functions inherited from ml::SubImage
void	_calcFillAreaParams (const SubImageBox &box, const SubImageBox &maxValidInputRegion, ImageVector &boxV1, ImageVector &boxV2, ImageVector &outputTSubImageV1, ImageVector &outputTSubImageV2, MLint &fullLineLenX, MLint &fullLineLenXB, MLint &leftLineStartX, MLint &leftLineLenX, MLint &leftLineLenXB, MLint &rightLineStartX, MLint &rightLineLenX, MLint &rightLineLenXB)
void	_copySubImageGeneric (const SubImage &fromImage, const ScaleShiftData &scaleShiftData)
	Generic, non-optimized version of copySubImage.
const MLTypeInfos *	_getDataTypeInfos (MLDataType dt) const
	Returns MLTypeInfos for used datatypes, indicates error if the type `dt` is not registered.
Protected Attributes inherited from ml::SubImage
SubImageBox	_box
	The box of the subimage.
ImageVector	_sourceImageExtent
	The extent of the source image, which is used for getValidRegion().
void *	_data
	Memory chunk managed by this subimage.
MLMemoryBlockHandle	_memoryBlock
	Memory block used by this subimage.
ImageVector	_stride
MLDataType	_dataType
	Data type of the image.

Detailed Description

template<typename DATATYPE>
class ml::TSubImage< DATATYPE >

This template class manages/represents a rectangular 6D image region in memory that is organized linearly. It inherits the functionality of SubImage and adds data type specific access functions to that class. Apart from the direct data access methods, there are the TSubImage::Cursor and TSubImage::ConstCursor classes that allow working on the typed data with cursor positioning/movements.

A const TSubImage can be used to only allow const access to the underlying image data.

Thread-safety: This class is reentrant.

This template class owns

All functionality from SubImage
Methods query and set of (sub)image properties that are inherited from the class ImageProperties (via SubImage)
A typed pointer to the memory chunk. The data type is given by the template parameter DATATYPE
Access functions/methods for image data. Examples are
DATATYPE value;

ImageVector p(......); // Define coordinate

value = getImgVal(p); // Get voxel value from image

setImgVal(p,value); // Set value of voxel p in image

ml::ImageVector
TImageVector< MLint > ImageVector
Defines the standard ImageVector type that is used by the ML for indexing and coordinates.
Definition mlImageVector.h:285

Notes: In the overloaded Module::calculateOutputSubImage, the Host passes untyped subimages (see SubImage). The image processing module usually needs to build typed wrappers around these untyped SubImages to have an easy access to them. This class represents typed input tiles and output pages for image processing algorithms. Algorithms that have different typed input images can build easily template code to access the image data correctly. The methods to access image voxels are designed for image manipulation to be used by algorithm developers.

Definition at line 109 of file mlTSubImage.h.

Member Typedef Documentation

◆ ComponentType

template<typename DATATYPE>

typedef DATATYPE ml::TSubImage< DATATYPE >::ComponentType

A typedef to 'export' the type of voxels components.

Definition at line 115 of file mlTSubImage.h.

◆ ConstCursor

template<typename DATATYPE>

typedef ConstTSubImageCursor<DATATYPE> ml::TSubImage< DATATYPE >::ConstCursor

A read-only cursor.

Definition at line 120 of file mlTSubImage.h.

◆ Cursor

template<typename DATATYPE>

typedef TSubImageCursor<DATATYPE> ml::TSubImage< DATATYPE >::Cursor

A read/write cursor.

Definition at line 118 of file mlTSubImage.h.

Constructor & Destructor Documentation

◆ TSubImage() [1/4]

template<typename DATATYPE>

ml::TSubImage< DATATYPE >::TSubImage	(	const SubImageBox &	box,
		MLDataType	dataType,
		void *	data )

inline

Constructor for an image region with location/extent box with data type dataType (must fit to DATATYPE!) and the memory address data that holds the image region. Note: The specification of dataType would usually not be necessary because it could be derived from DATATYPE. However, one or two modules use differing DATATYPE and dataType for special purposes. Moreover, the derivation of dataType from template parameter DATATYPE is a bit cumbersome, so we leave this constructor as it is. Note that this may be changed in future. Differing template datatypes and passed dataType enums will be handled as fatal error if real data is set.

Definition at line 137 of file mlTSubImage.h.

References ml::TypeTraits< T >::matches(), ML_BAD_DATA_TYPE, ML_PRINT_FATAL_ERROR, and ml::SubImage::SubImage().

Referenced by copySubImageReorderColorPlanesToInterleaved(), copySubImageTyped(), operator=(), TSubImage(), ml::TSubImageWithCursor< DATATYPE >::TSubImageWithCursor(), ml::TSubImageWithCursor< DATATYPE >::TSubImageWithCursor(), ml::TSubImageWithCursor< DATATYPE >::TSubImageWithCursor(), and ml::TSubImageWithCursor< DATATYPE >::TSubImageWithCursor().

◆ TSubImage() [2/4]

template<typename DATATYPE>

ml::TSubImage< DATATYPE >::TSubImage ( )

inline

Default constructor to build a typed subimage (with an empty box) from scratch. Initial values will be an empty SubImageBox as box, the ML data type is derived from the template type, and data is initialized to NULL. See also the documentation of TSubImage(const SubImageBox& box, MLDataType dataType, void* data).

Definition at line 152 of file mlTSubImage.h.

References ml::TypeTraits< T >::dataType, ML_BAD_DATA_TYPE, ML_INVALID_DATA_TYPE, ML_PRINT_FATAL_ERROR, and ml::SubImage::setDataType().

◆ TSubImage() [3/4]

template<typename DATATYPE>

ml::TSubImage< DATATYPE >::TSubImage ( const SubImage & subImage )

inline

Constructor to build a typed subimage from an untyped subImage. See also the documentation of TSubImage(const SubImageBox& box, MLDataType dataType, void* data). Note: this does not take over the MemoryBlockHandle of the given subImage for performance reasons. You need to explicitly set the handle on the TSubImage if you want the TSubImage to reference-count the data.

Definition at line 169 of file mlTSubImage.h.

References ml::SubImage::getBox(), ml::SubImage::getData(), ml::SubImage::getDataType(), ml::SubImage::getSourceImageExtent(), ml::TypeTraits< T >::matches(), ML_BAD_DATA_TYPE, ML_PRINT_FATAL_ERROR, ml::SubImage::setBox(), ml::SubImage::setData(), ml::SubImage::setDataType(), ml::SubImage::setSourceImageExtent(), and ml::SubImage::SubImage().

◆ TSubImage() [4/4]

template<typename DATATYPE>

ml::TSubImage< DATATYPE >::TSubImage ( const TSubImage< DATATYPE > & typedSubImage )

inline

Copy constructor to get an identical copy. Note that only the pointer to the data is copied, and not the data itself.

Definition at line 194 of file mlTSubImage.h.

References ml::SubImage::SubImage(), and TSubImage().

◆ ~TSubImage()

template<typename DATATYPE>

ml::TSubImage< DATATYPE >::~TSubImage ( )

inlineoverridedefault

Virtual destructor to suppress compiler warnings.

Member Function Documentation

◆ calculateMinMax()

template<typename DATATYPE>

MLint ml::TSubImage< DATATYPE >::calculateMinMax	(	DATATYPE &	minValue,
		DATATYPE &	maxValue,
		const SubImageBox *const	validBox = nullptr ) const

inline

Scans subimage and determines the minimum and maximum values of the region that is part of subimage box and of validBox. If no validBox is passed (default), all voxels are checked. The return value is the number of scanned voxels. If subimage is empty, minValue and maxValue are set to 0 and the return value is 0. Warning: If used in calculateOutputSubImage, take in consideration that the page may also contain invalid data that is not part of the image. Pass image box as validBox to be sure to access only valid regions.

Definition at line 420 of file mlTSubImage.h.

References ml::SubImage::_data, ml::TVector6DBase< CompIntType >::c, ml::SubImage::getBox(), getImagePointer(), getImageValue(), ml::TSubImageBox< intT >::getNumVoxels(), ml::TSubImageBox< MLint >::intersect(), ML_CHECK_THROW, ml::TImageVector< CompIntType >::set(), ml::TVector6DBase< CompIntType >::t, ml::TVector6DBase< CompIntType >::u, ml::TSubImageBox< intT >::v1, ml::TSubImageBox< intT >::v2, ml::TVector6DBase< CompIntType >::x, ml::TVector6DBase< CompIntType >::y, and ml::TVector6DBase< CompIntType >::z.

◆ convertPointerToImagePosition() [1/2]

template<typename DATATYPE>

ImageVector ml::TSubImage< DATATYPE >::convertPointerToImagePosition ( DATATYPE * pointer ) const

inline

Returns the 6D voxel coordinates corresponding to the memory address pointer. The returned coordinates are relative to the origin of the complete image region. That is, the position p=getBox.v1() is considered the origin of the image region/subimage.

Definition at line 311 of file mlTSubImage.h.

References ml::SubImage::_box, and convertPointerToSubImagePosition().

◆ convertPointerToImagePosition() [2/2]

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::convertPointerToImagePosition	(	DATATYPE *	pointer,
		MLint *	x,
		MLint *	y,
		MLint *	z ) const

inline

Returns the 3D voxel coordinates corresponding to the memory address pointer. The returned coordinates are relative to the origin of the complete image region. That is, the position p=getBox.v1() is considered the origin of the image region/subimage. It is legal to pass x, y, and/or z as NULL pointers; their values are only set if pointer is non-NULL.

Definition at line 320 of file mlTSubImage.h.

References ml::SubImage::_box, and convertPointerToSubImagePosition().

◆ convertPointerToSubImagePosition() [1/2]

template<typename DATATYPE>

ImageVector ml::TSubImage< DATATYPE >::convertPointerToSubImagePosition ( DATATYPE * pointer ) const

inline

Returns the 6D voxel coordinates corresponding to the memory address pointer. The returned coordinates are relative to the origin of the subimage region. That is, the position (0,0,0,0,0,0) is considered the origin of the subimage.

Definition at line 274 of file mlTSubImage.h.

References ml::SubImage::_data, and ml::SubImage::getStride().

Referenced by convertPointerToImagePosition(), and convertPointerToImagePosition().

◆ convertPointerToSubImagePosition() [2/2]

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::convertPointerToSubImagePosition	(	DATATYPE *	pointer,
		MLint *	x,
		MLint *	y,
		MLint *	z ) const

inline

Returns the 3D voxel coordinates corresponding to the memory address pointer. The returned coordinates are relative to the origin of the subimage region. That is, the position (0,0,0,0,0,0) is considered the origin of the subimage. It is legal to pass x, y, and/or z as NULL pointers; their values are only set if pointer is non-NULL.

Definition at line 282 of file mlTSubImage.h.

References ml::SubImage::_data, ml::SubImage::getImageExtent(), ml::SubImage::getStride(), ML_CHECK_THROW, ml::TVector6DBase< CompIntType >::x, ml::TVector6DBase< CompIntType >::y, and ml::TVector6DBase< CompIntType >::z.

◆ copySubImageReorderColorPlanesToInterleaved()

template<typename DATATYPE>

template<typename FROM_DATATYPE>

void ml::TSubImage< DATATYPE >::copySubImageReorderColorPlanesToInterleaved	(	const TSubImage< FROM_DATATYPE > &	typedFromImage,
		const ScaleShiftData &	scaleShiftData )

inline

Implements special case for void copySubImageTyped(const TSubImage<FROM_DATATYPE> &typedFromImg, const ScaleShiftData& scaleShiftData) where color planes shall be interleaved instead of in planes.

Definition at line 498 of file mlTSubImage.h.

References ml::SubImage::_box, ml::SubImage::_data, _ML_CHECK_SUBIMAGE_DATA_POINTERS, _ML_TSUBIMG_SUBDOT6, ml::TVector6DBase< CompIntType >::c, ml::SubImage::getBox(), getData(), ml::SubImage::getExtent(), getImagePointer(), ml::TScaleShiftData< DT >::getScale(), ml::TScaleShiftData< DT >::getShift(), ml::TSubImageBox< MLint >::intersect(), ml::TSubImageBox< intT >::isEmpty(), MLValuesAreEqual(), ml::TVector6DBase< CompIntType >::t, TSubImage(), ml::TVector6DBase< CompIntType >::u, ml::TSubImageBox< intT >::v1, ml::TSubImageBox< intT >::v2, ml::TVector6DBase< CompIntType >::x, ml::TVector6DBase< CompIntType >::y, and ml::TVector6DBase< CompIntType >::z.

Referenced by copySubImageTyped().

◆ copySubImageTyped()

template<typename DATATYPE>

template<typename FROM_DATATYPE>

void ml::TSubImage< DATATYPE >::copySubImageTyped	(	const TSubImage< FROM_DATATYPE > &	typedFromImg,
		const ScaleShiftData &	scaleShiftData )

inline

Copies image data from the subimage fromImg into the overlapping region of this subimage. Gray values are transformed linearly according to the settings in scaleShiftData (see ScaleShiftData). Notes:

The copied data always has the data type of this subimage. It is cast if necessary.
By transforming voxel values linearly before copying them, it is possible to avoid information loss due to type casting.
The default case of scaleShiftData defines scaleShiftData.getScale()==1 and scaleShiftData.getShift()==0. This way, a voxel value transformation does not change anything and copying is implemented as a special case that is therefore faster.

Definition at line 590 of file mlTSubImage.h.

References _ML_CHECK_SUBIMAGE_DATA_POINTERS, ml::TVector6DBase< CompIntType >::c, ml::SubImage::copySubImage(), copySubImageReorderColorPlanesToInterleaved(), ml::SubImage::getBox(), getData(), ml::SubImage::getDataType(), getImagePointer(), ml::SubImage::getNumVoxels(), ml::TScaleShiftData< DT >::getReorderMode(), ml::TScaleShiftData< DT >::getScale(), ml::TScaleShiftData< DT >::getShift(), ml::SubImage::getStride(), ml::TSubImageBox< MLint >::intersect(), ml::TSubImageBox< intT >::isEmpty(), ML_CHECK_THROW, MLIsScalarTypePtr(), MLSizeOf(), MLValuesAreEqual(), ml::TScaleShiftData< MLdouble >::ReorderColorPlanesToInterleaved, ml::TVector6DBase< CompIntType >::t, TSubImage(), ml::TVector6DBase< CompIntType >::u, ml::TSubImageBox< intT >::v1, ml::TSubImageBox< intT >::v2, ml::TVector6DBase< CompIntType >::x, ml::TVector6DBase< CompIntType >::y, and ml::TVector6DBase< CompIntType >::z.

◆ fill()

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::fill ( DATATYPE value )

inline

Sets all voxel values in subimage to value.

Definition at line 777 of file mlTSubImage.h.

References ml::SubImage::_data, ml::SubImage::getNumVoxels(), and ML_CHECK_THROW.

◆ fillBordersWithValue()

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::fillBordersWithValue	(	const SubImageBox &	box,
		DATATYPE	fillValue )

inline

Fills all regions with fillValue that are not covered by box. Note that box must be specified in global image coordinates. This way, two subimages with different origins and same sizes are filled differently, depending on their overlap with the box in global image coordinates. The cursor position is left undefined.

Definition at line 794 of file mlTSubImage.h.

References ml::SubImage::fillBordersWithTypeData().

Referenced by fillInvalidRegionWithValue().

◆ fillInvalidRegionWithBorderValues()

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::fillInvalidRegionWithBorderValues ( )

inline

Fills the invalid region (i.e., everything outside of getValidRegion() ) with the values on the borders of the valid region. This is useful for initializing invalid regions of an output/input subimage.

Definition at line 812 of file mlTSubImage.h.

References ml::SubImage::fillBordersWithBorderValues(), and ml::SubImage::getValidRegion().

◆ fillInvalidRegionWithValue()

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::fillInvalidRegionWithValue ( DATATYPE value )

inline

Fills the invalid region (everything outside of getValidRegion()) with the given value. This is useful for initializing invalid regions of an output/input subimage.

Definition at line 803 of file mlTSubImage.h.

References fillBordersWithValue(), and ml::SubImage::getValidRegion().

◆ getData() [1/2]

template<typename DATATYPE>

DATATYPE * ml::TSubImage< DATATYPE >::getData ( )

inline

Definition at line 218 of file mlTSubImage.h.

References ml::SubImage::_data.

◆ getData() [2/2]

template<typename DATATYPE>

const DATATYPE * ml::TSubImage< DATATYPE >::getData ( ) const

inline

Returns the memory address of the image region. Overloads methods from SubImage.

Definition at line 217 of file mlTSubImage.h.

References ml::SubImage::_data.

Referenced by copySubImageReorderColorPlanesToInterleaved(), copySubImageTyped(), and ml::TSubImageCursorBase< DATATYPE >::TSubImageCursorBase().

◆ getImagePointer() [1/4]

template<typename DATATYPE>

DATATYPE * ml::TSubImage< DATATYPE >::getImagePointer ( const ImageVector & position )

inline

Definition at line 254 of file mlTSubImage.h.

References ml::SubImage::_box, ml::SubImage::_data, _ML_TSUBIMG_SUBDOT6, and ml::SubImage::_stride.

◆ getImagePointer() [2/4]

template<typename DATATYPE>

const DATATYPE * ml::TSubImage< DATATYPE >::getImagePointer ( const ImageVector & position ) const

inline

Returns a pointer to voxel data of image voxel at 6D position position relative to the origin of the complete image region. The subimage is a part of the complete image. That is, the position p=getBox.v1() is considered the origin of the image region/subimage.

Definition at line 253 of file mlTSubImage.h.

References ml::SubImage::_box, ml::SubImage::_data, _ML_TSUBIMG_SUBDOT6, and ml::SubImage::_stride.

Referenced by calculateMinMax(), copySubImageReorderColorPlanesToInterleaved(), copySubImageTyped(), getImageValue(), getImageValue(), operator[](), operator[](), setImageValue(), and setImageValue().

◆ getImagePointer() [3/4]

template<typename DATATYPE>

DATATYPE * ml::TSubImage< DATATYPE >::getImagePointer	(	MLint	x,
		MLint	y,
		MLint	z )

inline

Definition at line 262 of file mlTSubImage.h.

References ml::SubImage::_box, ml::SubImage::_data, _ML_TSUBIMG_SUBDOT3, and ml::SubImage::_stride.

◆ getImagePointer() [4/4]

template<typename DATATYPE>

const DATATYPE * ml::TSubImage< DATATYPE >::getImagePointer	(	MLint	x,
		MLint	y,
		MLint	z ) const

inline

Returns a pointer to voxel data of image voxel at 3D position p=(x, y, z) relative to the origin of the complete image region. The subimage is a part of the complete image. That is, the position p=getBox.v1() is considered the origin of the image region/subimage.

Definition at line 261 of file mlTSubImage.h.

References ml::SubImage::_box, ml::SubImage::_data, _ML_TSUBIMG_SUBDOT3, and ml::SubImage::_stride.

◆ getImageValue() [1/3]

template<typename DATATYPE>

DATATYPE ml::TSubImage< DATATYPE >::getImageValue ( const ImageVector & position ) const

inline

Returns the 6D voxel value from the given position. The position is relative to the origin of the complete image region. That is, the position p=getBox.v1() is considered the origin of the image region/subimage.

Definition at line 383 of file mlTSubImage.h.

References getImagePointer().

Referenced by calculateMinMax().

◆ getImageValue() [2/3]

template<typename DATATYPE>

DATATYPE ml::TSubImage< DATATYPE >::getImageValue	(	MLint	x,
		MLint	y ) const

inline

Returns the 2D voxel value from the given position (x, y). The given position is relative to the origin of the complete image region. That is, the position p=getBox.v1() is considered the origin of the image region/subimage.

Definition at line 392 of file mlTSubImage.h.

References ml::SubImage::_box, ml::SubImage::_data, _ML_TSUBIMG_SUBDOT2, and ml::SubImage::_stride.

◆ getImageValue() [3/3]

template<typename DATATYPE>

DATATYPE ml::TSubImage< DATATYPE >::getImageValue	(	MLint	x,
		MLint	y,
		MLint	z ) const

inline

Returns the 3D voxel value from given position (x, y, z). The given position is relative to the origin of the complete image region. That is, the position p=getBox.v1() is considered the origin of the image region/subimage.

Definition at line 401 of file mlTSubImage.h.

References getImagePointer().

◆ getSubImagePointer() [1/4]

template<typename DATATYPE>

DATATYPE * ml::TSubImage< DATATYPE >::getSubImagePointer ( const ImageVector & position )

inline

Definition at line 234 of file mlTSubImage.h.

References ml::SubImage::_data, ml::SubImage::_stride, and ml::TVector< TVector6DBase< MLint > >::dot().

◆ getSubImagePointer() [2/4]

template<typename DATATYPE>

const DATATYPE * ml::TSubImage< DATATYPE >::getSubImagePointer ( const ImageVector & position ) const

inline

Returns a pointer to voxel data of image voxel at the 6D position relative to the origin of the subimage region. That is, the position (0,0,0,0,0,0) is considered the origin of the subimage.

Definition at line 233 of file mlTSubImage.h.

References ml::SubImage::_data, ml::SubImage::_stride, and ml::TVector< TVector6DBase< MLint > >::dot().

◆ getSubImagePointer() [3/4]

template<typename DATATYPE>

DATATYPE * ml::TSubImage< DATATYPE >::getSubImagePointer	(	MLint	x,
		MLint	y,
		MLint	z )

inline

Definition at line 246 of file mlTSubImage.h.

References ml::SubImage::_data, and ml::SubImage::_stride.

◆ getSubImagePointer() [4/4]

template<typename DATATYPE>

const DATATYPE * ml::TSubImage< DATATYPE >::getSubImagePointer	(	MLint	x,
		MLint	y,
		MLint	z ) const

inline

Returns a pointer to voxel data of image voxel at 3D position p=(x, y, z) relative to the origin of the subimage region. That is, the position (0,0,0,0,0,0) is considered the origin of the subimage and higher coordinates c, t, and u are taken as 0 values.

Definition at line 245 of file mlTSubImage.h.

References ml::SubImage::_data, and ml::SubImage::_stride.

◆ getSubImageValue() [1/3]

template<typename DATATYPE>

DATATYPE ml::TSubImage< DATATYPE >::getSubImageValue ( const ImageVector & position ) const

inline

Returns voxel value at the given position where position is relative to the origin of the subimage region. That is, the position (0,0,0,0,0,0) is considered the origin of the subimage.

Definition at line 356 of file mlTSubImage.h.

References ml::SubImage::_data, ml::SubImage::_stride, and ml::TVector< TVector6DBase< MLint > >::dot().

◆ getSubImageValue() [2/3]

template<typename DATATYPE>

DATATYPE ml::TSubImage< DATATYPE >::getSubImageValue	(	MLint	x,
		MLint	y ) const

inline

Returns the voxel value at position (x, y) where the position is relative to the origin of the subimage region. That is, the position (0,0) is considered the origin of the subimage.

Definition at line 365 of file mlTSubImage.h.

References ml::SubImage::_data, and ml::SubImage::_stride.

◆ getSubImageValue() [3/3]

template<typename DATATYPE>

DATATYPE ml::TSubImage< DATATYPE >::getSubImageValue	(	MLint	x,
		MLint	y,
		MLint	z ) const

inline

Returns the voxel value at the given position (x, y, z) where the position is relative to the origin of the subimage region. That is, the position (0,0,0) is considered the origin of the subimage.

Definition at line 374 of file mlTSubImage.h.

References ml::SubImage::_data, and ml::SubImage::_stride.

◆ operator=()

template<typename DATATYPE>

TSubImage & ml::TSubImage< DATATYPE >::operator= ( const TSubImage< DATATYPE > & typedSubImage )

inline

Assignment operator to get an identical copy. Note that only the pointer to the data is copied, and not the data itself.

Definition at line 204 of file mlTSubImage.h.

References ml::SubImage::operator=(), and TSubImage().

Referenced by ml::TSubImageWithCursor< DATATYPE >::operator=().

◆ operator[]() [1/2]

template<typename DATATYPE>

DATATYPE & ml::TSubImage< DATATYPE >::operator[] ( const ImageVector & position )

inline

Reference access to voxel value at the given position. The caller must guarantee that position is inside valid subimage region. The position (0,0,0,0,0,0) is considered the origin of the image, getBox.v1() is considered the origin of the valid subimage area. Note that this operator access always calculates all six coordinate components.

Definition at line 346 of file mlTSubImage.h.

References getImagePointer().

◆ operator[]() [2/2]

template<typename DATATYPE>

const DATATYPE & ml::TSubImage< DATATYPE >::operator[] ( const ImageVector & position ) const

inline

Constant reference access to voxel value at the given position. The caller must guarantee that position is inside valid subimage region. The position (0,0,0,0,0,0) is considered the origin of the image, getBox.v1() is considered the origin of the valid subimage area. Note that this operator access always calculates all six coordinate components.

Definition at line 340 of file mlTSubImage.h.

References getImagePointer().

◆ setImageValue() [1/3]

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::setImageValue	(	const ImageVector &	position,
		DATATYPE	value )

inline

Sets the 6D voxel at the given position to the given value. The position is relative to the origin of the complete image region. That is, the position p=getBox.v1() is considered the origin of the image region/subimage.

Definition at line 379 of file mlTSubImage.h.

References getImagePointer().

◆ setImageValue() [2/3]

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::setImageValue	(	MLint	x,
		MLint	y,
		DATATYPE	value )

inline

Sets the 2D voxel at the given position (x, y) to the the given value. The given position is relative to the origin of the complete image region. That is, the position p=getBox.v1() is considered the origin of the image region/subimage.

Definition at line 388 of file mlTSubImage.h.

References ml::SubImage::_box, ml::SubImage::_data, _ML_TSUBIMG_SUBDOT2, and ml::SubImage::_stride.

◆ setImageValue() [3/3]

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::setImageValue	(	MLint	x,
		MLint	y,
		MLint	z,
		DATATYPE	value )

inline

Sets the 3D voxel at the given position (x, y, z) to the given value. The given position is relative to the origin of the complete image region. That is, the position p=getBox.v1() is considered the origin of the image region/subimage.

Definition at line 397 of file mlTSubImage.h.

References getImagePointer().

◆ setSubImageValue() [1/3]

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::setSubImageValue	(	const ImageVector &	position,
		DATATYPE	value )

inline

Sets the voxel value at the given position to the given value where position is relative to the origin of the subimage region. That is, the position (0,0,0,0,0,0) is considered the origin of the subimage.

Definition at line 351 of file mlTSubImage.h.

References ml::SubImage::_data, ml::SubImage::_stride, and ml::TVector< TVector6DBase< MLint > >::dot().

◆ setSubImageValue() [2/3]

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::setSubImageValue	(	MLint	x,
		MLint	y,
		DATATYPE	value )

inline

Sets the voxel value at the given position(x, y) to the given value where the position is relative to the origin of the subimage region. That is, the position (0,0) is considered the origin of the subimage.

Definition at line 361 of file mlTSubImage.h.

References ml::SubImage::_data, and ml::SubImage::_stride.

◆ setSubImageValue() [3/3]

template<typename DATATYPE>

void ml::TSubImage< DATATYPE >::setSubImageValue	(	MLint	x,
		MLint	y,
		MLint	z,
		DATATYPE	value )

inline

Sets the voxel value at the given position (x, y, z) to the given value where the position is relative to the origin of the subimage region. That is, the position (0,0,0) is considered the origin of the subimage.

Definition at line 370 of file mlTSubImage.h.

References ml::SubImage::_data, and ml::SubImage::_stride.

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

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

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ ComponentType

◆ ConstCursor

◆ Cursor

Constructor & Destructor Documentation

◆ TSubImage() [1/4]

◆ TSubImage() [2/4]

◆ TSubImage() [3/4]

◆ TSubImage() [4/4]

◆ ~TSubImage()

Member Function Documentation

◆ calculateMinMax()

◆ convertPointerToImagePosition() [1/2]

◆ convertPointerToImagePosition() [2/2]

◆ convertPointerToSubImagePosition() [1/2]

◆ convertPointerToSubImagePosition() [2/2]

◆ copySubImageReorderColorPlanesToInterleaved()

◆ copySubImageTyped()

◆ fill()

◆ fillBordersWithValue()

◆ fillInvalidRegionWithBorderValues()

◆ fillInvalidRegionWithValue()

◆ getData() [1/2]

◆ getData() [2/2]

◆ getImagePointer() [1/4]

◆ getImagePointer() [2/4]

◆ getImagePointer() [3/4]

◆ getImagePointer() [4/4]

◆ getImageValue() [1/3]

◆ getImageValue() [2/3]

◆ getImageValue() [3/3]

◆ getSubImagePointer() [1/4]

◆ getSubImagePointer() [2/4]

◆ getSubImagePointer() [3/4]

◆ getSubImagePointer() [4/4]

◆ getSubImageValue() [1/3]

◆ getSubImageValue() [2/3]

◆ getSubImageValue() [3/3]

◆ operator=()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ setImageValue() [1/3]

◆ setImageValue() [2/3]

◆ setImageValue() [3/3]

◆ setSubImageValue() [1/3]

◆ setSubImageValue() [2/3]

◆ setSubImageValue() [3/3]