Virtual Pixel Access Table. More...

#include <cvb/vpat.hpp>

Classes
class	Column
	A single column. More...

class	Entry
	One entry of the VPAT. More...

class	Row
	A single row. More...

Public Member Functions
	Vpat () noexcept=default

	Vpat (std::uint8_t base, Entry vpat, int width)
	Construct Vpat from raw values. More...

	Vpat (const Vpat &other) noexcept=default
	Default copy ctor. More...

Vpat &	operator= (const Vpat &other) noexcept=default
	Default copy operator. More...

Vpat	NewMoved (const Cvb::Rect< int > newAoi) const noexcept
	Creates a new, moved linear access object. More...

std::uint8_t *	BasePtr () const noexcept
	VPAT base pointer. More...

Entry *	VpatPtr () const noexcept
	Pointer to the native VPAT structure. More...

Point2D< int >	Origin () const noexcept
	Gets the origin of the Vpat() for this access trait. More...

CVB_FORCE_INLINE int	Width () const noexcept
	Gets the pixel width of the underlying plane. More...

bool	Valid () const noexcept
	Gets whether this vpat access object is valid. More...

	operator bool () const noexcept
	Gets whether this vpat access object is valid. More...

CVB_FORCE_INLINE const void *	operator() (int x, int y) const noexcept
	Coordinate pixel access operator. More...

CVB_FORCE_INLINE void *	operator() (int x, int y) noexcept
	Coordinate pixel access operator. More...

CVB_FORCE_INLINE const void *	operator[] (int idx) const noexcept
	Index pixel access operator. More...

CVB_FORCE_INLINE void *	operator[] (int idx) noexcept
	Index pixel access operator. More...

Row	RowAt (int y) const noexcept
	Gets the Vpat::Row at y. More...

Column	ColumnAt (int x) const noexcept
	Gets the Vpat::Column at x. More...

Public Member Functions inherited from ValueAccessBase< Vpat >
const Type &	Value (int x, int y) const noexcept
	Gets a pixel value at a given position. More...

Type &	Value (int x, int y) noexcept
	Gets a settable pixel value at a given position. More...

const Type &	Value (Point2D< int > position) const noexcept
	Gets a pixel value at a given position. More...

Type &	Value (Point2D< int > position) noexcept
	Gets a settable pixel value at a given position. More...

Detailed Description

Virtual Pixel Access Table.

Constructor & Destructor Documentation

◆ Vpat() [1/3]

Vpat ( )

defaultnoexcept

Default ctor of invalid vpat access data.

Postcondition: Valid() == false

◆ Vpat() [2/3]

Vpat	(	std::uint8_t *	base,
		Entry *	vpat,
		int	width
	)

inline

Construct Vpat from raw values.

Postcondition: Valid() == base != nullptr && vpat != nullptr && width > 0

Parameters

[in]	base	Base memory pointer.
[in]	vpat	Vpat pointer.
[in]	width	The width of the plane.

◆ Vpat() [3/3]

Vpat ( const Vpat & other )

defaultnoexcept

Default copy ctor.

Postcondition: Valid() == other.Valid()

Parameters

[in] other Object to copy.

Member Function Documentation

◆ BasePtr()

std::uint8_t * BasePtr ( ) const

inlinenoexcept

VPAT base pointer.

Returns: The base pointer

Exceptions

Does	not throw any exception.

The base pointer is not necessarily a pointer to the first pixel in the image or the first pixel in the last line of the image, but merely a base pointer for calculating the address of a pixel using the x- and y-offset tables.

◆ ColumnAt()

Column ColumnAt ( int x ) const

inlinenoexcept

Gets the Vpat::Column at x.

Precondition: x must be between 0 and less than the allowed width.

Parameters

[in] x Pixel column.

Returns: Column object at line x.

◆ NewMoved()

Vpat NewMoved ( const Cvb::Rect< int > newAoi ) const

inlinenoexcept

Creates a new, moved linear access object.

Precondition: Valid() == true

Parameters

[in] newAoi Offset and new size in pixels to move this access to.

Returns: New LinearAccess object that is moved by (x, y).

◆ operator bool()

operator bool ( ) const

inlineexplicitnoexcept

Gets whether this vpat access object is valid.

Returns: true if Base() and Vpat() are not nullptr and the origin is valid.

◆ operator()() [1/2]

CVB_FORCE_INLINE const void * operator()	(	int	x,
		int	y
	)		const

inlinenoexcept

Coordinate pixel access operator.

Precondition: Valid() == true

Parameters

[in]	x	X coordinate coefficient in pixels.
[in]	y	Y coordinate coefficient in pixels.

Returns: Const pointer to pixel value.

◆ operator()() [2/2]

CVB_FORCE_INLINE void * operator()	(	int	x,
		int	y
	)

inlinenoexcept

Coordinate pixel access operator.

Precondition: Valid() == true

Parameters

[in]	x	X coordinate coefficient in pixels.
[in]	y	Y coordinate coefficient in pixels.

Returns: Mutable pointer to pixel value.

◆ operator=()

Vpat & operator= ( const Vpat & other )

defaultnoexcept

Default copy operator.

Postcondition: Valid() == other.Valid()

Parameters

[in] other Object to copy.

Returns: Reference to this object.

◆ operator[]() [1/2]

CVB_FORCE_INLINE const void * operator[] ( int idx ) const

inlinenoexcept

Index pixel access operator.

Precondition: Valid() == true

Parameters

[in] idx Pixel index.

Returns: Const pointer to pixel value.

◆ operator[]() [2/2]

CVB_FORCE_INLINE void * operator[] ( int idx )

inlinenoexcept

Index pixel access operator.

Precondition: Valid() == true

Parameters

[in] idx Pixel index.

Returns: Mutable pointer to pixel value.

◆ Origin()

Point2D< int > Origin ( ) const

inlinenoexcept

Gets the origin of the Vpat() for this access trait.

This is necessary for sub-blocks to work.

Returns: The origin point of this access trait.

◆ RowAt()

Row RowAt ( int y ) const

inlinenoexcept

Gets the Vpat::Row at y.

Precondition: y must be between 0 and less than the allowed height.

Parameters

[in] y Pixel row.

Returns: Row object at line y.

◆ Valid()

bool Valid ( ) const

inlinenoexcept

Gets whether this vpat access object is valid.

Returns: true if Base() and Vpat() are not nullptr and the origin is valid.

◆ VpatPtr()

Entry * VpatPtr ( ) const

inlinenoexcept

Pointer to the native VPAT structure.

Returns: VPAT pointer pointing to the first entry.

Exceptions

Does	not throw any exception.

See also: Entry

◆ Width()

CVB_FORCE_INLINE int Width ( ) const

inlinenoexcept

Gets the pixel width of the underlying plane.

Returns: Pixel width of the working plane.

Classes

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Vpat() [1/3]

◆ Vpat() [2/3]

◆ Vpat() [3/3]

Member Function Documentation

◆ BasePtr()

◆ ColumnAt()

◆ NewMoved()

◆ operator bool()

◆ operator()() [1/2]

◆ operator()() [2/2]

◆ operator=()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ Origin()

◆ RowAt()

◆ Valid()

◆ VpatPtr()

◆ Width()