Configurable RGB pixel converter. More...

#include <pixel.hh>

Classes
struct	Channel
	Color channel conversion and scaling helper class. More...

Public Member Functions
	PixelConverter (unsigned length, unsigned ro, unsigned go, unsigned bo, unsigned rw, unsigned gw, unsigned bw, ByteOrder byte_order=ByteOrder::little)

Pixel	toPixel (uint32_t word) const
	Get the Pixel representation of a color word.

Pixel	toPixel (const uint8_t *rfb) const
	Get a Pixel representation by reading a word from memory.

uint32_t	fromPixel (const Pixel &pixel) const
	Convert a Pixel into a color word.

void	fromPixel (uint8_t *rfb, const Pixel &pixel) const
	Convert a pixel into a color word and store the resulting word in memory.

uint32_t	readWord (const uint8_t *p) const
	Read a word of a given length and endianness from memory.

void	writeWord (uint8_t *p, uint32_t word) const
	Write a word of a given length and endianness to memory.

Public Attributes
unsigned	length
	Bytes per pixel when stored in memory (including padding)

unsigned	depth
	Number of bits used to represent one pixel value (excluding padding).

ByteOrder	byte_order
	Byte order when stored to memory.

Channel	ch_r
	Red channel conversion helper.

Channel	ch_g
	Green channel conversion helper.

Channel	ch_b
	Blue channel conversion helper.

Static Public Attributes
static const PixelConverter	rgba8888_le
	Predefined 32-bit RGB (red in least significant bits, 8 bits/channel, little endian) conversion helper.

static const PixelConverter	rgb565_le
	Predefined 16-bit RGB565 (red in least significant bits, little endian) conversion helper.

static const PixelConverter	rgba8888_be
	Predefined 32-bit RGB (red in least significant bits, 8 bits/channel, big endian) conversion helper.

static const PixelConverter	rgb565_be
	Predefined 16-bit RGB565 (red in least significant bits, big endian) conversion helper.

Detailed Description

Configurable RGB pixel converter.

This class converts between external RGB representations and gem5's internal Pixel representation. The class assumes that pixels are stored in a word of configurable length (up to 32 bits). Individual pixels are assumed to be represented by contiguous bit ranges in the word (i.e., it is possible to shift and mask out a contiguous bit range for each pixel).

Definition at line 91 of file pixel.hh.

Constructor & Destructor Documentation

◆ PixelConverter()

gem5::PixelConverter::PixelConverter	(	unsigned	length,
		unsigned	ro,
		unsigned	go,
		unsigned	bo,
		unsigned	rw,
		unsigned	gw,
		unsigned	bw,
		ByteOrder	byte_order = ByteOrder::little )

Definition at line 54 of file pixel.cc.

References length.

Member Function Documentation

◆ fromPixel() [1/2]

uint32_t gem5::PixelConverter::fromPixel ( const Pixel & pixel ) const

inline

Convert a Pixel into a color word.

Definition at line 150 of file pixel.hh.

References gem5::Pixel::blue, ch_b, ch_g, ch_r, gem5::PixelConverter::Channel::fromPixel(), gem5::Pixel::green, and gem5::Pixel::red.

Referenced by gem5::FrameBuffer::copyOut(), fromPixel(), gem5::VncServer::sendFrameBufferUpdate(), and TEST().

◆ fromPixel() [2/2]

void gem5::PixelConverter::fromPixel	(	uint8_t *	rfb,
		const Pixel &	pixel ) const

inline

Convert a pixel into a color word and store the resulting word in memory.

Definition at line 160 of file pixel.hh.

References fromPixel(), and writeWord().

◆ readWord()

uint32_t gem5::PixelConverter::readWord ( const uint8_t * p ) const

Read a word of a given length and endianness from memory.

The number of bytes read from memory is determined by the length of a color word. Note that some of the bytes may be padding.

Parameters

p	Pointer to the first byte in the word.

Returns: Word in host endianness.

Definition at line 76 of file pixel.cc.

References byte_order, gem5::ArmISA::i, length, and gem5::MipsISA::p.

Referenced by toPixel().

◆ toPixel() [1/2]

Pixel gem5::PixelConverter::toPixel ( const uint8_t * rfb ) const

inline

Get a Pixel representation by reading a word from memory.

Definition at line 145 of file pixel.hh.

References readWord(), and toPixel().

◆ toPixel() [2/2]

Pixel gem5::PixelConverter::toPixel ( uint32_t word ) const

inline

Get the Pixel representation of a color word.

Definition at line 138 of file pixel.hh.

References ch_b, ch_g, ch_r, and gem5::PixelConverter::Channel::toPixel().

Referenced by gem5::FrameBuffer::copyIn(), gem5::HDLcd::lineNext(), gem5::HDLcd::pxlNext(), gem5::to_number(), and toPixel().

◆ writeWord()

void gem5::PixelConverter::writeWord	(	uint8_t *	p,
		uint32_t	word ) const

Write a word of a given length and endianness to memory.

Parameters

p	Pointer to the first byte in memory.
word	Word to store (host endianness).

Definition at line 92 of file pixel.cc.

References byte_order, gem5::ArmISA::i, length, and gem5::MipsISA::p.

Referenced by fromPixel().

Member Data Documentation

◆ byte_order

ByteOrder gem5::PixelConverter::byte_order

Byte order when stored to memory.

Definition at line 192 of file pixel.hh.

Referenced by readWord(), gem5::VncServer::VncServer(), and writeWord().

◆ ch_b

Channel gem5::PixelConverter::ch_b

Blue channel conversion helper.

Definition at line 199 of file pixel.hh.

Referenced by fromPixel(), toPixel(), and gem5::VncServer::VncServer().

◆ ch_g

Channel gem5::PixelConverter::ch_g

Green channel conversion helper.

Definition at line 197 of file pixel.hh.

Referenced by fromPixel(), toPixel(), and gem5::VncServer::VncServer().

◆ ch_r

Channel gem5::PixelConverter::ch_r

Red channel conversion helper.

Definition at line 195 of file pixel.hh.

Referenced by fromPixel(), toPixel(), and gem5::VncServer::VncServer().

◆ depth

unsigned gem5::PixelConverter::depth

Number of bits used to represent one pixel value (excluding padding).

This could be less than length * 8 if the pixel value is padded.

Definition at line 190 of file pixel.hh.

Referenced by gem5::VncServer::VncServer().

◆ length

unsigned gem5::PixelConverter::length

Bytes per pixel when stored in memory (including padding)

Definition at line 184 of file pixel.hh.

Referenced by gem5::FrameBuffer::copyIn(), gem5::FrameBuffer::copyOut(), gem5::HDLcd::lineNext(), PixelConverter(), gem5::HDLcd::pxlNext(), readWord(), gem5::VncServer::sendFrameBufferUpdate(), gem5::VncServer::VncServer(), and writeWord().

◆ rgb565_be

const PixelConverter gem5::PixelConverter::rgb565_be

static

Predefined 16-bit RGB565 (red in least significant bits, big endian) conversion helper.

Definition at line 213 of file pixel.hh.

◆ rgb565_le

const PixelConverter gem5::PixelConverter::rgb565_le

static

Predefined 16-bit RGB565 (red in least significant bits, little endian) conversion helper.

Definition at line 206 of file pixel.hh.

Referenced by TEST().

◆ rgba8888_be

const PixelConverter gem5::PixelConverter::rgba8888_be

static

Predefined 32-bit RGB (red in least significant bits, 8 bits/channel, big endian) conversion helper.

Definition at line 210 of file pixel.hh.

Referenced by TEST().

◆ rgba8888_le

const PixelConverter gem5::PixelConverter::rgba8888_le

static

Predefined 32-bit RGB (red in least significant bits, 8 bits/channel, little endian) conversion helper.

Definition at line 203 of file pixel.hh.

Referenced by gem5::operator<<(), TEST(), TEST(), TEST(), and gem5::to_number().

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

base/pixel.hh
base/pixel.cc

Classes

Public Member Functions

Public Attributes

Static Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ PixelConverter()

Member Function Documentation

◆ fromPixel() [1/2]

◆ fromPixel() [2/2]

◆ readWord()

◆ toPixel() [1/2]

◆ toPixel() [2/2]

◆ writeWord()

Member Data Documentation

◆ byte_order

◆ ch_b

◆ ch_g

◆ ch_r

◆ depth

◆ length

◆ rgb565_be

◆ rgb565_le

◆ rgba8888_be

◆ rgba8888_le