Converts images from one PixelFormat to another. More...

#include <peak_ipl/algorithm/peak_ipl_image_converter.hpp>

Public Member Functions
	ImageConverter ()

	~ImageConverter ()

	ImageConverter (const ImageConverter &other)=delete

ImageConverter &	operator= (const ImageConverter &other)=delete

	ImageConverter (ImageConverter &&other) noexcept

ImageConverter &	operator= (ImageConverter &&other) noexcept

	ImageConverter (const peak::ipl::PixelFormat &inputPixelFormat, const peak::ipl::PixelFormat &outputPixelFormat, size_t width, size_t height, size_t imageCount=5)
	Convenience constructor to directly pre-allocate an internal buffer pool. This calls PreAllocateConversion internally. More...

void	PreAllocateConversion (const peak::ipl::PixelFormat &inputPixelFormat, const peak::ipl::PixelFormat &outputPixelFormat, size_t width, size_t height, size_t imageCount=5)
	Pre-allocate buffer pools needed for the specified conversion. More...

peak::ipl::ConversionMode	ConversionMode () const
	Returns the current conversion mode. More...

void	SetConversionMode (peak::ipl::ConversionMode conversionMode)
	Set conversion mode. More...

std::vector< peak::ipl::PixelFormatName >	SupportedOutputPixelFormatNames (const peak::ipl::PixelFormat &inputPixelFormat) const
	Returns the supported output pixel formats for a given input pixel format. More...

Image	Convert (const Image &inputImage, const peak::ipl::PixelFormat &outputPixelFormat) const
	Converts the input image converted to the given pixel format. More...

Image	Convert (const Image &inputImage, const peak::ipl::PixelFormat &outputPixelFormat, uint8_t *outputImageBuffer, size_t outputImageBufferSize) const
	Saves the data of the current image converted to the given pixel format into a destination buffer and creates an image from that buffer. More...

Detailed Description

Converts images from one PixelFormat to another.

Note: In order to speed up processing, instances of this class maintain internal memory pools, which allows reuse of memory instead of allocating new memory on each conversion.
The memory is freed when the instance is destroyed. There is one pool for every needed byte count, therefore a new pool will be allocated if an image with a new size or format needs to be processed.
One may choose to create a new instance of this class when changing image settings in order to free old pools. If a new pool or buffer is needed they will get allocated automatically during the conversion, which results in the first conversion taking more time.
This can be prevented by using the function PreAllocateConversion before the conversion. Buffers can be reused once a converted image gets freed.

Constructor & Destructor Documentation

◆ ImageConverter() [1/4]

peak::ipl::ImageConverter::ImageConverter ( )

inline

◆ ~ImageConverter()

peak::ipl::ImageConverter::~ImageConverter ( )

inline

◆ ImageConverter() [2/4]

peak::ipl::ImageConverter::ImageConverter ( const ImageConverter & other )

delete

◆ ImageConverter() [3/4]

peak::ipl::ImageConverter::ImageConverter ( ImageConverter && other )

inlinenoexcept

◆ ImageConverter() [4/4]

peak::ipl::ImageConverter::ImageConverter	(	const peak::ipl::PixelFormat &	inputPixelFormat,
		const peak::ipl::PixelFormat &	outputPixelFormat,
		size_t	width,
		size_t	height,
		size_t	imageCount = `5`
	)

inline

Convenience constructor to directly pre-allocate an internal buffer pool. This calls PreAllocateConversion internally.

Parameters

[in]	inputPixelFormat	The pixelformat of the source image
[in]	outputPixelFormat	The pixelformat of the converted image
[in]	width	Width of the source image
[in]	height	Height of the source image
[in]	imageCount	Maximum amount of converted images held at one time

Exceptions

Exception An internal error has occurred.

Since: 1.4

Member Function Documentation

◆ ConversionMode()

peak::ipl::ConversionMode peak::ipl::ImageConverter::ConversionMode ( ) const

inline

Returns the current conversion mode.

Returns: The current conversion mode

Exceptions

Exception An internal error has occurred.

Since: 1.0

◆ Convert() [1/2]

Image peak::ipl::ImageConverter::Convert	(	const Image &	inputImage,
		const peak::ipl::PixelFormat &	outputPixelFormat
	)		const

inline

Converts the input image converted to the given pixel format.

Parameters

[in]	inputImage	The input image.
[in]	outputPixelFormat	The output pixel format.

Returns: A new created image containing the data of the input image converted to the given pixel format

Exceptions

Exception An internal error has occurred.

Since: 1.0

◆ Convert() [2/2]

Image peak::ipl::ImageConverter::Convert	(	const Image &	inputImage,
		const peak::ipl::PixelFormat &	outputPixelFormat,
		uint8_t *	outputImageBuffer,
		size_t	outputImageBufferSize
	)		const

inline

Saves the data of the current image converted to the given pixel format into a destination buffer and creates an image from that buffer.

Parameters

[in]	inputImage	The input image.
[in]	outputPixelFormat	The output pixel format.
[out]	outputImageBuffer	Pointer to destination buffer.
[in]	outputImageBufferSize	Size of destination buffer.

Returns: Converted image

Exceptions

BufferTooSmallException	The provided buffer is too small for the output image.
Exception	An internal error has occurred.

Since: 1.1

◆ operator=() [1/2]

ImageConverter& peak::ipl::ImageConverter::operator= ( const ImageConverter & other )

delete

◆ operator=() [2/2]

ImageConverter & peak::ipl::ImageConverter::operator= ( ImageConverter && other )

inlinenoexcept

◆ PreAllocateConversion()

void peak::ipl::ImageConverter::PreAllocateConversion	(	const peak::ipl::PixelFormat &	inputPixelFormat,
		const peak::ipl::PixelFormat &	outputPixelFormat,
		size_t	width,
		size_t	height,
		size_t	imageCount = `5`
	)

inline

Pre-allocate buffer pools needed for the specified conversion.

Parameters

[in]	inputPixelFormat	The pixelformat of the source image
[in]	outputPixelFormat	The pixelformat of the converted image
[in]	width	Width of the source image
[in]	height	Height of the source image
[in]	imageCount	Maximum amount of converted images held at one time

Exceptions

Exception An internal error has occurred.

Since: 1.4

◆ SetConversionMode()

void peak::ipl::ImageConverter::SetConversionMode ( peak::ipl::ConversionMode conversionMode )

inline

Set conversion mode.

Parameters

[in] conversionMode The conversion mode to set.

Exceptions

Exception An internal error has occurred.

Since: 1.0

◆ SupportedOutputPixelFormatNames()

std::vector< PixelFormatName > peak::ipl::ImageConverter::SupportedOutputPixelFormatNames ( const peak::ipl::PixelFormat & inputPixelFormat ) const

inline

Returns the supported output pixel formats for a given input pixel format.

Parameters

[in] inputPixelFormat The input pixel format.

Returns: A vector of supported pixel formats for the given input pixel format

Exceptions

Exception An internal error has occurred.

Since: 1.0

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

peak_ipl/algorithm/peak_ipl_image_converter.hpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ImageConverter() [1/4]

◆ ~ImageConverter()

◆ ImageConverter() [2/4]

◆ ImageConverter() [3/4]

◆ ImageConverter() [4/4]

Member Function Documentation

◆ ConversionMode()

◆ Convert() [1/2]

◆ Convert() [2/2]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ PreAllocateConversion()

◆ SetConversionMode()

◆ SupportedOutputPixelFormatNames()