PixelUtil Class Reference

Provides supporting functions for PixelFormat enum. More...

#include <gz/rendering/PixelFormat.hh>

Static Public Member Functions
static unsigned int	BytesPerChannel (PixelFormat _format)
	Get number of bytes per channel for given format. If an invalid format is given, 0 will be returned.
static unsigned int	BytesPerPixel (PixelFormat _format)
	Get number of bytes per pixel for given format. If an invalid format is given, 0 will be returned. This is simply the product of GetChannelCount and GetBytesPerChannel.
static unsigned int	ChannelCount (PixelFormat _format)
	Get number of channels for given format. If an invalid format is given, 0 will be returned.
static PixelFormat	Enum (const std::string &_name)
	Get enum value by human-readable name. The given string should match watch is returned by GetName. If an invalid name is given, PF_UNKNOWN will be returned.
static bool	IsValid (PixelFormat _format)
	Determine if given format is valid PixelFormat enum.
static unsigned int	MemorySize (PixelFormat _format, unsigned int _width, unsigned int _height)
	Get total memory size in bytes for an image with the given format and dimensions. If an invalid format is given, 0 will be returned. This is simply the product of GetBytesPerPixel, _width, and, _height.
static std::string	Name (PixelFormat _format)
	Get human-readable name for pixel format value.
static PixelFormat	Sanitize (PixelFormat _format)
	Sanitize given format. If the given value is invalid, PF_UNKNOWN will be returned, otherwise input will be returned unchanged.

Detailed Description

Provides supporting functions for PixelFormat enum.

Member Function Documentation

BytesPerChannel()

static unsigned int BytesPerChannel ( PixelFormat  _format )

static

Get number of bytes per channel for given format. If an invalid format is given, 0 will be returned.

Parameters

[in]

_format

Image pixel format

Returns

The number of bytes per channel

BytesPerPixel()

static unsigned int BytesPerPixel ( PixelFormat  _format )

static

Get number of bytes per pixel for given format. If an invalid format is given, 0 will be returned. This is simply the product of GetChannelCount and GetBytesPerChannel.

Returns

The number of bytes per pixel

ChannelCount()

static unsigned int ChannelCount ( PixelFormat  _format )

static

Get number of channels for given format. If an invalid format is given, 0 will be returned.

Parameters

[in]

_format

Image pixel format

Returns

The channel count

Enum()

static PixelFormat Enum ( const std::string &  _name )

static

Get enum value by human-readable name. The given string should match watch is returned by GetName. If an invalid name is given, PF_UNKNOWN will be returned.

Parameters

[in]

_name

Name of the pixel format to be retrieved

Returns

The specified PixelFormat enum value

IsValid()

static bool IsValid ( PixelFormat  _format )

static

Determine if given format is valid PixelFormat enum.

Parameters

[in]

_format

Enum value to be evaluated

MemorySize()

static unsigned int MemorySize ( PixelFormat  _format, unsigned int  _width, unsigned int  _height  )

static

Get total memory size in bytes for an image with the given format and dimensions. If an invalid format is given, 0 will be returned. This is simply the product of GetBytesPerPixel, _width, and, _height.

Parameters

[in]	_format	Image pixel format
[in]	_width	Image width in pixels
[in]	_height	Image height in pixels

Returns

The number of bytes per pixel

Referenced by BaseCamera< T >::ImageMemorySize().

Name()

static std::string Name ( PixelFormat  _format )

static

Get human-readable name for pixel format value.

Parameters

[in]

_format

Image pixel format

Returns

The format name

Sanitize()

static PixelFormat Sanitize ( PixelFormat  _format )

static

Sanitize given format. If the given value is invalid, PF_UNKNOWN will be returned, otherwise input will be returned unchanged.

Parameters

[in]

_format

Image pixel format to be sanitized

Returns

The sanitized pixel format

Referenced by BaseRenderTarget< T >::SetFormat().

---

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

• PixelFormat.hh