Image creation module for displaying purposes. More...

#include <ImageBuilder.h>

Collaboration diagram for evo::ImageBuilder:

Public Member Functions
	ImageBuilder (bool alignStride=true, short decimalPlaces=1)
	Standard constructor. More...

	~ImageBuilder ()
	Destructor.

void	setData (unsigned int width, unsigned int height, const unsigned short *data)
	Set new data. More...

unsigned int	getWidth () const
	Get image width. More...

unsigned int	getHeight () const
	Get image height. More...

float	getTemperatureAt (int index) const
	Get temperature from last acquired image at specified image index. More...

float	getTemperatureAt (int u, int v) const
	Get temperature from last acquired image at specified image coordinates. More...

float	getMeanTemperature (unsigned int u1, unsigned int v1, unsigned int u2, unsigned int v2)
	Get mean temperature of rectangular measuring field. More...

void	getMinMaxRegion (unsigned int radius, ExtremalRegion minRegion, ExtremalRegion maxRegion)
	Get region of minimum/maximum temperature with given radius. More...

void	setManualTemperatureRange (float min, float max)
	Set temperature range for manual scaling method. More...

float	getIsothermalMin () const
	Get minimum temperature used to scale image. More...

float	getIsothermalMax () const
	Get maximum temperature used to scale image. More...

void	setPaletteScalingMethod (EnumOptrisPaletteScalingMethod method)
	Scaling method of color conversion. More...

EnumOptrisPaletteScalingMethod	getPaletteScalingMethod () const
	Accessor for activated color conversion mode. More...

unsigned int	getStride (void) const
	If memory alignment is needed, this class provides a stride parameter configured with setSize(...). More...

void	setPalette (EnumOptrisColoringPalette palette)
	Set palette for color conversion. More...

EnumOptrisColoringPalette	getPalette () const
	Get palette for color conversion return coloring palette.

void	getPaletteTable (paletteTable &table) const
	Get palette table for color conversion. More...

void	fillPaletteLookup (unsigned int lut[65536])
	Fill lookup table for false color conversion. More...

void	convertTemperatureToPaletteImage (unsigned char *dst, bool ignoreStride=false)
	Image conversion to rgb (bgr on windows) More...

void	convertTemperatureToPaletteImage (unsigned int lut[65536], unsigned char *dst)
	Image conversion to rgb with lookup table. More...

void	getPaletteBar (unsigned int w, unsigned int h, unsigned char *&img) const

void	calcHistogram (unsigned int *hist, unsigned int histsize, int tMin, int tMax) const
	calculate histogram More...

void	drawCrosshair (unsigned char *img, unsigned int x, unsigned int y, unsigned char rgb[3]=NULL) const
	Draw crosshair to the center of image. More...

void	yuv422torgb24 (const unsigned char src, unsigned char dst, unsigned int w, unsigned int h) const
	Convert YUV422 image to RGB format (8-Bit per channel) More...

void	convert2PPM (unsigned char &ppm, unsigned int size, unsigned char *buffer, unsigned int width, unsigned int height) const
	Convert palette image to ppm format. More...

int	serializePPM (const char filename, unsigned char buffer, unsigned int width, unsigned int height) const
	Serialize data to PPM-format. More...

int	readPPM3 (const char filename, unsigned char buffer, unsigned int width, unsigned int *height)
	Read PPM (P3) format. More...

Detailed Description

Image creation module for displaying purposes.

Author: Stefan May (Evocortex GmbH), Matthias Wiedemann (Optris GmbH)

Examples: /platform/windows/examples/directshow/irExternalProbe.cpp, /platform/windows/examples/directshow/irimagerShow.cpp, examples/linux/externalProbe/IRExternalProbe.cpp, examples/linux/opengl/irimagerShow.cpp, and examples/linux/opengl/irimagerTwinShow.cpp.

Constructor & Destructor Documentation

◆ ImageBuilder()

evo::ImageBuilder::ImageBuilder	(	bool	alignStride = `true`,
		short	decimalPlaces = `1`
	)

Standard constructor.

Parameters

[in]	alignStride	Align to image stride
[in]	decimalPlaces	Decimal places of image data

Member Function Documentation

◆ calcHistogram()

void evo::ImageBuilder::calcHistogram	(	unsigned int *	hist,
		unsigned int	histsize,
		int	tMin,
		int	tMax
	)		const

calculate histogram

Parameters

[out]	hist	histogram
[in]	histsize	number of quantization steps
[in]	tMin	minimum temperature
[in]	tMax	maximum temperature

◆ convert2PPM()

void evo::ImageBuilder::convert2PPM	(	unsigned char *&	ppm,
		unsigned int *	size,
		unsigned char *	buffer,
		unsigned int	width,
		unsigned int	height
	)		const

Convert palette image to ppm format.

Parameters

[out]	ppm	pointer to data container (is instantiated internally!). Delete pointer after use.
[out]	size	size of allocated data container
[in]	buffer	buffer with palette image data
[in]	width	width of palette image
[in]	height	height of palette image

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ convertTemperatureToPaletteImage() [1/2]

void evo::ImageBuilder::convertTemperatureToPaletteImage	(	unsigned char *	dst,
		bool	ignoreStride = `false`
	)

Image conversion to rgb (bgr on windows)

Parameters

[out]	dst	Destination image
[in]	by	default columns are multiple of 4, i.e., stride is added

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ convertTemperatureToPaletteImage() [2/2]

void evo::ImageBuilder::convertTemperatureToPaletteImage	(	unsigned int	lut[65536],
		unsigned char *	dst
	)

Image conversion to rgb with lookup table.

This method is efficient, but works only with fixed temperature ranges (manual mode).

Parameters

[in]	lut	lookup table
[out]	dst	Destination image

◆ drawCrosshair()

void evo::ImageBuilder::drawCrosshair	(	unsigned char *	img,
		unsigned int	x,
		unsigned int	y,
		unsigned char	rgb[3] = `NULL`
	)		const

Draw crosshair to the center of image.

Parameters

	[in/out]	img image in RGB or RGBA format
[in]	x	x-position in image
[in]	y	y-position in image
[in]	rgb	RGB drawing color

◆ fillPaletteLookup()

void evo::ImageBuilder::fillPaletteLookup ( unsigned int lut[65536] )

Fill lookup table for false color conversion.

Parameters

[out] lut lookup table

◆ getHeight()

unsigned int evo::ImageBuilder::getHeight ( ) const

Get image height.

Returns: image height

◆ getIsothermalMax()

float evo::ImageBuilder::getIsothermalMax ( ) const

Get maximum temperature used to scale image.

Returns: Temperature in °C

◆ getIsothermalMin()

float evo::ImageBuilder::getIsothermalMin ( ) const

Get minimum temperature used to scale image.

Returns: Temperature in °C

◆ getMeanTemperature()

float evo::ImageBuilder::getMeanTemperature	(	unsigned int	u1,
		unsigned int	v1,
		unsigned int	u2,
		unsigned int	v2
	)

Get mean temperature of rectangular measuring field.

Parameters

[in]	u1	u-component of image coordinate, i. e. column of 1st point
[in]	v1	v-component of image coordinate, i. e. row of 1st point
[in]	u2	u-component of image coordinate, i. e. column of 2nd point
[in]	v2	v-component of image coordinate, i. e. row of 2nd point

Returns: mean temperature

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ getMinMaxRegion()

void evo::ImageBuilder::getMinMaxRegion	(	unsigned int	radius,
		ExtremalRegion *	minRegion,
		ExtremalRegion *	maxRegion
	)

Get region of minimum/maximum temperature with given radius.

Parameters

[in]	radius	Radius of region
[out]	minRegion	Region of minimum mean temperature
[out]	maxRegion	Region of maximum mean temperature

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ getPaletteBar()

void evo::ImageBuilder::getPaletteBar	(	unsigned int	w,
		unsigned int	h,
		unsigned char *&	img
	)		const

Parameters

[in]	w	width of palette bar
[in]	h	height of palette bar
[out]	img	palette bar image. Methode allocates a array with size of 3wh. Free pointer with delete[].

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ getPaletteScalingMethod()

EnumOptrisPaletteScalingMethod evo::ImageBuilder::getPaletteScalingMethod ( ) const

Accessor for activated color conversion mode.

Returns: Scaling method

◆ getPaletteTable()

void evo::ImageBuilder::getPaletteTable ( paletteTable & table ) const

Get palette table for color conversion.

Returns: coloring palette table as rgb triple

◆ getStride()

unsigned int evo::ImageBuilder::getStride ( void ) const

If memory alignment is needed, this class provides a stride parameter configured with setSize(...).

Memory will be aligned such that the image width is a multiple of 4

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ getTemperatureAt() [1/2]

float evo::ImageBuilder::getTemperatureAt ( int index ) const

Get temperature from last acquired image at specified image index.

Parameters

[in] index Image index (must be within [0; getWidth()*getHeight()]) return temperature in degree Celsius

◆ getTemperatureAt() [2/2]

float evo::ImageBuilder::getTemperatureAt	(	int	u,
		int	v
	)		const

Get temperature from last acquired image at specified image coordinates.

Parameters

[in]	u	Image column (must be within [0; getWidth()])
[in]	v	Image row (must be within [0; getHeight()]) return temperature in degree Celsius

◆ getWidth()

unsigned int evo::ImageBuilder::getWidth ( ) const

Get image width.

Returns: image width

◆ readPPM3()

int evo::ImageBuilder::readPPM3	(	const char *	filename,
		unsigned char **	buffer,
		unsigned int *	width,
		unsigned int *	height
	)

Read PPM (P3) format.

Parameters

[in]	filename	filename
[in]	buffer	RGB image buffer (instantiated in method)
[in]	width	width of read image
[in]	height	height of read image

◆ serializePPM()

int evo::ImageBuilder::serializePPM	(	const char *	filename,
		unsigned char *	buffer,
		unsigned int	width,
		unsigned int	height
	)		const

Serialize data to PPM-format.

Parameters

[in]	filename	filename
[in]	buffer	RGB image data
[in]	width	width of image
[in]	height	height of image

Returns: success

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ setData()

void evo::ImageBuilder::setData	(	unsigned int	width,
		unsigned int	height,
		const unsigned short *	data
	)

Set new data.

Parameters

[in]	width	image width
[in]	height	image height
[in]	data	image data

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ setManualTemperatureRange()

void evo::ImageBuilder::setManualTemperatureRange	(	float	min,
		float	max
	)

Set temperature range for manual scaling method.

Parameters

[in]	min	Lower limit in °C
[in]	max	Upper limit in °C

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ setPalette()

void evo::ImageBuilder::setPalette ( EnumOptrisColoringPalette palette )

Set palette for color conversion.

Parameters

[in] palette coloring palette

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ setPaletteScalingMethod()

void evo::ImageBuilder::setPaletteScalingMethod ( EnumOptrisPaletteScalingMethod method )

Scaling method of color conversion.

Parameters

[in] method Scaling method

Examples: examples/linux/opengl/irimagerShow.cpp.

◆ yuv422torgb24()

void evo::ImageBuilder::yuv422torgb24	(	const unsigned char *	src,
		unsigned char *	dst,
		unsigned int	w,
		unsigned int	h
	)		const

Convert YUV422 image to RGB format (8-Bit per channel)

Parameters

[in]	src	source image
[out]	dst	destination image
[in]	w	image width
[in]	h	image height

Examples: examples/linux/opengl/irimagerShow.cpp.

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

ImageBuilder.h

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ImageBuilder()

Member Function Documentation

◆ calcHistogram()

◆ convert2PPM()

◆ convertTemperatureToPaletteImage() [1/2]

◆ convertTemperatureToPaletteImage() [2/2]

◆ drawCrosshair()

◆ fillPaletteLookup()

◆ getHeight()

◆ getIsothermalMax()

◆ getIsothermalMin()

◆ getMeanTemperature()

◆ getMinMaxRegion()

◆ getPaletteBar()

◆ getPaletteScalingMethod()

◆ getPaletteTable()

◆ getStride()

◆ getTemperatureAt() [1/2]

◆ getTemperatureAt() [2/2]

◆ getWidth()

◆ readPPM3()

◆ serializePPM()

◆ setData()

◆ setManualTemperatureRange()

◆ setPalette()

◆ setPaletteScalingMethod()

◆ yuv422torgb24()