Manage an 8-bit channel image. More...

#include <image.h>

Public Member Functions
	IMAGE (unsigned int aXsize, unsigned int aYsize)
	Construct a IMAGE based on image size. More...

	IMAGE (const IMAGE &aSrcImage)
	Construct a IMAGE based from an existing image. More...

	~IMAGE ()

void	Setpixel (int aX, int aY, unsigned char aValue)
	Set a value in a pixel position, position is clamped in accordance with the current clamp settings. More...

unsigned char	Getpixel (int aX, int aY) const
	Get the pixel value from pixel position, position is clamped in accord with the current clamp settings. More...

void	Hline (int aXStart, int aXEnd, int aY, unsigned char aValue)
	Draw a horizontal line. More...

void	CircleFilled (int aCx, int aCy, int aRadius, unsigned char aValue)

void	CopyFull (const IMAGE aImgA, const IMAGE aImgB, IMAGE_OP aOperation)
	Perform a copy operation based on aOperation type. More...

void	Invert ()
	Invert the values of this image <- (255 - this) More...

void	EfxFilter (IMAGE *aInImg, IMAGE_FILTER aFilterType)
	Apply a filter to the input image and store it in the image class. More...

void	EfxFilter_SkipCenter (IMAGE *aInImg, IMAGE_FILTER aFilterType, unsigned int aRadius)
	Apply a filter to the input image and store it in the image class. More...

void	SaveAsPNG (const wxString &aFileName) const
	Save image buffer to a PNG file into the working folder. More...

void	SetPixelsFromNormalizedFloat (const float *aNormalizedFloatArray)
	Set the current channel from a float normalized (0.0 - 1.0) buffer. More...

unsigned char *	GetBuffer () const
	Get the image buffer pointer. More...

unsigned int	GetWidth () const

unsigned int	GetHeight () const

Private Member Functions
bool	wrapCoords (int aXo, int aYo) const
	Calculate the coordinates points in accord with the current clamping settings. More...

void	plot8CircleLines (int aCx, int aCy, int aX, int aY, unsigned char aValue)

Private Attributes
unsigned char *	m_pixels
	buffer to store the image 8bit-channel More...

unsigned int	m_width
	width of the image More...

unsigned int	m_height
	height of the image More...

unsigned int	m_wxh
	width * height precalc value More...

IMAGE_WRAP	m_wraping
	current wrapping type More...

Detailed Description

Manage an 8-bit channel image.

Definition at line 89 of file image.h.

Constructor & Destructor Documentation

◆ IMAGE() [1/2]

IMAGE::IMAGE	(	unsigned int	aXsize,
		unsigned int	aYsize
	)

Construct a IMAGE based on image size.

Parameters

aXsize	x size
aYsize	y size

Definition at line 45 of file image.cpp.

{
 m_wxh = aXsize * aYsize;
 m_pixels = new unsigned char[m_wxh];
 memset( m_pixels, 0, m_wxh );
 m_width = aXsize;
 m_height = aYsize;
 m_wraping = IMAGE_WRAP::CLAMP;
}

References CLAMP, m_height, m_pixels, m_width, m_wraping, and m_wxh.

◆ IMAGE() [2/2]

IMAGE::IMAGE ( const IMAGE & aSrcImage )

Construct a IMAGE based from an existing image.

It will make a copy the aSrcImage.

Parameters

aSrcImage

Definition at line 56 of file image.cpp.

{
 m_wxh = aSrcImage.GetWidth() * aSrcImage.GetHeight();
 m_pixels = new unsigned char[m_wxh];
 memcpy( m_pixels, aSrcImage.GetBuffer(), m_wxh );
 m_width = aSrcImage.GetWidth();
 m_height = aSrcImage.GetHeight();
 m_wraping = IMAGE_WRAP::CLAMP;
}

References CLAMP, GetBuffer(), GetHeight(), GetWidth(), m_height, m_pixels, m_width, m_wraping, and m_wxh.

◆ ~IMAGE()

IMAGE::~IMAGE ( )

Definition at line 67 of file image.cpp.

{
 delete[] m_pixels;
}

References m_pixels.

Member Function Documentation

◆ CircleFilled()

void IMAGE::CircleFilled	(	int	aCx,
		int	aCy,
		int	aRadius,
		unsigned char	aValue
	)

Definition at line 173 of file image.cpp.

{
 int x = aRadius;
 int y = 0;
 int xChange = 1 - 2 * aRadius;
 int yChange = 0;
 int radiusError = 0;
 
 while( x >= y )
 {
 plot8CircleLines( aCx, aCy, x, y, aValue );
 y++;
 radiusError += yChange;
 yChange += 2;
 
 if( ( 2 * radiusError + xChange ) > 0 )
 {
 x--;
 radiusError += xChange;
 xChange += 2;
 }
 }
}

References plot8CircleLines().

Referenced by RENDER_3D_OPENGL::initializeOpenGL().

◆ CopyFull()

void IMAGE::CopyFull	(	const IMAGE *	aImgA,
		const IMAGE *	aImgB,
		IMAGE_OP	aOperation
	)

Perform a copy operation based on aOperation type.

The available image operations.

IMAGE_OP::RAW this <- aImgA
IMAGE_OP::ADD this <- CLAMP(aImgA + aImgB)
IMAGE_OP::SUB this <- CLAMP(aImgA - aImgB)
IMAGE_OP::DIF this <- abs(aImgA - aImgB)
IMAGE_OP::MUL this <- aImgA * aImgB
IMAGE_OP::AND this <- aImgA & aImgB
IMAGE_OP::OR this <- aImgA | aImgB
IMAGE_OP::XOR this <- aImgA ^ aImgB
IMAGE_OP::BLEND50 this <- (aImgA + aImgB) / 2
IMAGE_OP::MIN this <- (aImgA < aImgB) ? aImgA : aImgB
IMAGE_OP::MAX this <- (aImgA > aImgB) ? aImgA : aImgB

Parameters

aImgA	an image input.
aImgB	an image input.
aOperation	operation to perform

Definition at line 205 of file image.cpp.

{
 int aV, bV;
 
 if( aOperation == IMAGE_OP::RAW )
 {
 if( aImgA == nullptr )
 return;
 }
 else
 {
 if( ( aImgA == nullptr ) || ( aImgB == nullptr ) )
 return;
 }
 
 switch( aOperation )
 {
 case IMAGE_OP::RAW:
 memcpy( m_pixels, aImgA->m_pixels, m_wxh );
 break;
 
 case IMAGE_OP::ADD:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 aV = aImgA->m_pixels[it];
 bV = aImgB->m_pixels[it];
 
 aV = (aV + bV);
 aV = (aV > 255)?255:aV;
 
 m_pixels[it] = aV;
 }
 break;
 
 case IMAGE_OP::SUB:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 aV = aImgA->m_pixels[it];
 bV = aImgB->m_pixels[it];
 
 aV = (aV - bV);
 aV = (aV < 0)?0:aV;
 
 m_pixels[it] = aV;
 }
 break;
 
 case IMAGE_OP::DIF:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 aV = aImgA->m_pixels[it];
 bV = aImgB->m_pixels[it];
 
 m_pixels[it] = abs( aV - bV );
 }
 break;
 
 case IMAGE_OP::MUL:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 aV = aImgA->m_pixels[it];
 bV = aImgB->m_pixels[it];
 
 m_pixels[it] =
 (unsigned char) ( ( ( (float) aV / 255.0f ) * ( (float) bV / 255.0f ) ) * 255 );
 }
 break;
 
 case IMAGE_OP::AND:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 m_pixels[it] = aImgA->m_pixels[it] & aImgB->m_pixels[it];
 }
 break;
 
 case IMAGE_OP::OR:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 m_pixels[it] = aImgA->m_pixels[it] | aImgB->m_pixels[it];
 }
 break;
 
 case IMAGE_OP::XOR:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 m_pixels[it] = aImgA->m_pixels[it] ^ aImgB->m_pixels[it];
 }
 break;
 
 case IMAGE_OP::BLEND50:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 aV = aImgA->m_pixels[it];
 bV = aImgB->m_pixels[it];
 
 m_pixels[it] = (aV + bV) / 2;
 }
 break;
 
 case IMAGE_OP::MIN:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 aV = aImgA->m_pixels[it];
 bV = aImgB->m_pixels[it];
 
 m_pixels[it] = (aV < bV)?aV:bV;
 }
 break;
 
 case IMAGE_OP::MAX:
 for( unsigned int it = 0;it < m_wxh; it++ )
 {
 aV = aImgA->m_pixels[it];
 bV = aImgB->m_pixels[it];
 
 m_pixels[it] = (aV > bV)?aV:bV;
 }
 break;
 
 default:
 break;
 }
}

References std::abs(), ADD, AND, BLEND50, DIF, m_pixels, m_wxh, MAX, MIN, MUL, OR, RAW, SUB, and XOR.

◆ EfxFilter()

void IMAGE::EfxFilter	(	IMAGE *	aInImg,
		IMAGE_FILTER	aFilterType
	)

Apply a filter to the input image and store it in the image class.

Parameters

aInImg	input image
aFilterType	filter type to apply

Todo:: : This function can be optimized slipping it between the edges and do it without use the getpixel function. Optimization can be done to m_pixels[ix + iy * m_width] but keep in mind the parallel process of the algorithm

Todo:: This needs to write to a separate buffer.

Definition at line 474 of file image.cpp.

{
 S_FILTER filter = FILTERS[static_cast<int>( aFilterType )];
 
 aInImg->m_wraping = IMAGE_WRAP::CLAMP;
 m_wraping = IMAGE_WRAP::CLAMP;
 
 std::atomic<size_t> nextRow( 0 );
 std::atomic<size_t> threadsFinished( 0 );
 
 size_t parallelThreadCount = std::max<size_t>( std::thread::hardware_concurrency(), 2 );
 
 for( size_t ii = 0; ii < parallelThreadCount; ++ii )
 {
 std::thread t = std::thread( [&]()
 {
 for( size_t iy = nextRow.fetch_add( 1 ); iy < m_height; iy = nextRow.fetch_add( 1 ) )
 {
 for( size_t ix = 0; ix < m_width; ix++ )
 {
 int v = 0;
 
 for( size_t sy = 0; sy < 5; sy++ )
 {
 for( size_t sx = 0; sx < 5; sx++ )
 {
 int factor = filter.kernel[sx][sy];
 unsigned char pixelv = aInImg->Getpixel( ix + sx - 2, iy + sy - 2 );
 
 v += pixelv * factor;
 }
 }
 
 v /= filter.div;
 v += filter.offset;
 CLAMP(v, 0, 255);
 
 m_pixels[ix + iy * m_width] = v;
 }
 }
 
 threadsFinished++;
 } );
 
 t.detach();
 }
 
 while( threadsFinished < parallelThreadCount )
 std::this_thread::sleep_for( std::chrono::milliseconds( 10 ) );
}

References CLAMP, filter, FILTERS, m_height, and m_wraping.

◆ EfxFilter_SkipCenter()

void IMAGE::EfxFilter_SkipCenter	(	IMAGE *	aInImg,
		IMAGE_FILTER	aFilterType,
		unsigned int	aRadius
	)

Apply a filter to the input image and store it in the image class.

skip the circle center defined by radius

Parameters

aInImg	input image
aFilterType	filter type to apply
aRadius	center circle that the effect will not be applied

Definition at line 527 of file image.cpp.

{
 if( ( !aInImg ) || ( m_width != aInImg->m_width ) || ( m_height != aInImg->m_height ) )
 return;
 
 S_FILTER filter = FILTERS[static_cast<int>( aFilterType )];
 
 aInImg->m_wraping = IMAGE_WRAP::ZERO;
 
 const unsigned int radiusSquared = aRadius * aRadius;
 
 const unsigned int xCenter = m_width / 2;
 const unsigned int yCenter = m_height / 2;
 
 for( size_t iy = 0; iy < m_height; iy++ )
 {
 int yc = iy - yCenter;
 
 unsigned int ycsq = yc * yc;
 
 for( size_t ix = 0; ix < m_width; ix++ )
 {
 int xc = ix - xCenter;
 
 unsigned int xcsq = xc * xc;
 
 if( ( xcsq + ycsq ) < radiusSquared )
 {
 const unsigned int offset = ix + iy * m_width;
 
 m_pixels[offset] = aInImg->m_pixels[offset];
 
 continue;
 }
 
 int v = 0;
 
 for( size_t sy = 0; sy < 5; sy++ )
 {
 for( size_t sx = 0; sx < 5; sx++ )
 {
 int factor = filter.kernel[sx][sy];
 unsigned char pixelv = aInImg->Getpixel( ix + sx - 2, iy + sy - 2 );
 
 v += pixelv * factor;
 }
 }
 
 v /= filter.div;
 v += filter.offset;
 CLAMP(v, 0, 255);
 
 m_pixels[ix + iy * m_width] = v;
 }
 }
}

References CLAMP, filter, FILTERS, Getpixel(), m_height, m_pixels, m_width, m_wraping, and ZERO.

Referenced by RENDER_3D_OPENGL::initializeOpenGL().

◆ GetBuffer()

unsigned char * IMAGE::GetBuffer ( ) const

Get the image buffer pointer.

Returns: unsigned char* the pointer of the buffer 8bit channel.

Definition at line 73 of file image.cpp.

{
 return m_pixels;
}

References m_pixels.

Referenced by IMAGE(), and OglLoadTexture().

◆ GetHeight()

unsigned int IMAGE::GetHeight ( ) const

inline

Definition at line 214 of file image.h.

214{ return m_height; }

References m_height.

Referenced by IMAGE(), RENDER_3D_OPENGL::initializeOpenGL(), and OglLoadTexture().

◆ Getpixel()

unsigned char IMAGE::Getpixel	(	int	aX,
		int	aY
	)		const

Get the pixel value from pixel position, position is clamped in accord with the current clamp settings.

Parameters

aX	x position
aY	y position

Returns: unsigned char - pixel value

Definition at line 130 of file image.cpp.

{
 if( wrapCoords( &aX, &aY ) )
 return m_pixels[aX + aY * m_width];
 else
 return 0;
}

References m_pixels, m_width, and wrapCoords().

Referenced by EfxFilter_SkipCenter().

◆ GetWidth()

unsigned int IMAGE::GetWidth ( ) const

inline

Definition at line 213 of file image.h.

213{ return m_width; }

References m_width.

Referenced by IMAGE(), RENDER_3D_OPENGL::initializeOpenGL(), and OglLoadTexture().

◆ Hline()

void IMAGE::Hline	(	int	aXStart,
		int	aXEnd,
		int	aY,
		unsigned char	aValue
	)

Draw a horizontal line.

Parameters

aXStart	x start position
aXEnd	x end position
aY	y position
aValue	value to add

Definition at line 139 of file image.cpp.

{
 if( ( aY < 0 ) || ( aY >= (int) m_height ) || ( ( aXStart < 0 ) && ( aXEnd < 0 ) )
 || ( ( aXStart >= (int) m_width ) && ( aXEnd >= (int) m_width ) ) )
 return;
 
 if( aXStart > aXEnd )
 {
 int swap = aXStart;
 
 aXStart = aXEnd;
 aXEnd = swap;
 }
 
 // Clamp line
 if( aXStart < 0 )
 aXStart = 0;
 
 if( aXEnd >= (int)m_width )
 aXEnd = m_width - 1;
 
 unsigned char* pixelPtr = &m_pixels[aXStart + aY * m_width];
 unsigned char* pixelPtrEnd = pixelPtr + (unsigned int) ( ( aXEnd - aXStart ) + 1 );
 
 while( pixelPtr < pixelPtrEnd )
 {
 *pixelPtr = aValue;
 pixelPtr++;
 }
}

References m_height, m_pixels, m_width, and swap.

Referenced by plot8CircleLines().

◆ Invert()

void IMAGE::Invert ( )

Invert the values of this image <- (255 - this)

Definition at line 198 of file image.cpp.

{
 for( unsigned int it = 0; it < m_wxh; it++ )
 m_pixels[it] = 255 - m_pixels[it];
}

References m_pixels, and m_wxh.

◆ plot8CircleLines()

void IMAGE::plot8CircleLines	(	int	aCx,
		int	aCy,
		int	aX,
		int	aY,
		unsigned char	aValue
	)

private

Definition at line 114 of file image.cpp.

{
 Hline( aCx - aX, aCx + aX, aCy + aY, aValue );
 Hline( aCx - aX, aCx + aX, aCy - aY, aValue );
 Hline( aCx - aY, aCx + aY, aCy + aX, aValue );
 Hline( aCx - aY, aCx + aY, aCy - aX, aValue );
}

References Hline().

Referenced by CircleFilled().

◆ SaveAsPNG()

void IMAGE::SaveAsPNG ( const wxString & aFileName ) const

Save image buffer to a PNG file into the working folder.

Each RGB channel will have the 8bit-channel from the image.

Parameters

aFileName file name (without extension)

Definition at line 597 of file image.cpp.

{
 DBG_SaveBuffer( aFileName, m_pixels, m_width, m_height );
}

References DBG_SaveBuffer(), m_height, m_pixels, and m_width.

◆ Setpixel()

void IMAGE::Setpixel	(	int	aX,
		int	aY,
		unsigned char	aValue
	)

Set a value in a pixel position, position is clamped in accordance with the current clamp settings.

Parameters

aX	x position
aY	y position
aValue	value to set the pixel

Definition at line 123 of file image.cpp.

{
 if( wrapCoords( &aX, &aY ) )
 m_pixels[aX + aY * m_width] = aValue;
}

References m_pixels, m_width, and wrapCoords().

◆ SetPixelsFromNormalizedFloat()

void IMAGE::SetPixelsFromNormalizedFloat ( const float * aNormalizedFloatArray )

Set the current channel from a float normalized (0.0 - 1.0) buffer.

this <- CLAMP(NormalizedFloat * 255)

Parameters

aNormalizedFloatArray a float array with the same size of the image

Definition at line 585 of file image.cpp.

{
 for( unsigned int i = 0; i < m_wxh; i++ )
 {
 int v = aNormalizedFloatArray[i] * 255;
 
 CLAMP( v, 0, 255 );
 m_pixels[i] = v;
 }
}

References CLAMP, m_pixels, and m_wxh.

◆ wrapCoords()

bool IMAGE::wrapCoords	(	int *	aXo,
		int *	aYo
	)		const

private

Calculate the coordinates points in accord with the current clamping settings.

Parameters

aXo	X coordinate to be converted (output).
aXo	Y coordinate to be converted (output).

Returns: bool - true if the coordinates are inside the image, false otherwise.

Definition at line 79 of file image.cpp.

{
 int x = *aXo;
 int y = *aYo;
 
 switch( m_wraping )
 {
 case IMAGE_WRAP::CLAMP:
 x = ( x < 0 ) ? 0 : x;
 x = ( x >= (int) ( m_width - 1 ) ) ? ( m_width - 1 ) : x;
 y = ( y < 0 ) ? 0 : y;
 y = ( y >= (int) ( m_height - 1 ) ) ? ( m_height - 1 ) : y;
 break;
 
 case IMAGE_WRAP::WRAP:
 x = ( x < 0 ) ? ( ( m_width - 1 ) + x ) : x;
 x = ( x >= (int) ( m_width - 1 ) ) ? ( x - m_width ) : x;
 y = ( y < 0 ) ? ( ( m_height - 1 ) + y ) : y;
 y = ( y >= (int) ( m_height - 1 ) ) ? ( y - m_height ) : y;
 break;
 
 default:
 break;
 }
 
 if( ( x < 0 ) || ( x >= (int) m_width ) || ( y < 0 ) || ( y >= (int) m_height ) )
 return false;
 
 *aXo = x;
 *aYo = y;
 
 return true;
}

References CLAMP, m_height, m_width, m_wraping, and WRAP.

Referenced by Getpixel(), and Setpixel().

Member Data Documentation

◆ m_height

unsigned int IMAGE::m_height

private

height of the image

Definition at line 230 of file image.h.

Referenced by EfxFilter(), EfxFilter_SkipCenter(), GetHeight(), Hline(), IMAGE(), SaveAsPNG(), and wrapCoords().

◆ m_pixels

unsigned char* IMAGE::m_pixels

private

buffer to store the image 8bit-channel

Definition at line 228 of file image.h.

Referenced by CopyFull(), EfxFilter_SkipCenter(), GetBuffer(), Getpixel(), Hline(), IMAGE(), Invert(), SaveAsPNG(), Setpixel(), SetPixelsFromNormalizedFloat(), and ~IMAGE().

◆ m_width

unsigned int IMAGE::m_width

private

width of the image

Definition at line 229 of file image.h.

Referenced by EfxFilter_SkipCenter(), Getpixel(), GetWidth(), Hline(), IMAGE(), SaveAsPNG(), Setpixel(), and wrapCoords().

◆ m_wraping

IMAGE_WRAP IMAGE::m_wraping

private

current wrapping type

Definition at line 232 of file image.h.

Referenced by EfxFilter(), EfxFilter_SkipCenter(), IMAGE(), and wrapCoords().

◆ m_wxh

unsigned int IMAGE::m_wxh

private

width * height precalc value

Definition at line 231 of file image.h.

Referenced by CopyFull(), IMAGE(), Invert(), and SetPixelsFromNormalizedFloat().

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

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ IMAGE() [1/2]

◆ IMAGE() [2/2]

◆ ~IMAGE()

Member Function Documentation

◆ CircleFilled()

◆ CopyFull()

◆ EfxFilter()

◆ EfxFilter_SkipCenter()

◆ GetBuffer()

◆ GetHeight()

◆ Getpixel()

◆ GetWidth()

◆ Hline()

◆ Invert()

◆ plot8CircleLines()

◆ SaveAsPNG()

◆ Setpixel()

◆ SetPixelsFromNormalizedFloat()

◆ wrapCoords()

Member Data Documentation

◆ m_height

◆ m_pixels

◆ m_width

◆ m_wraping

◆ m_wxh