IDS peak AFL v2.0.2
Loading...
Searching...
No Matches
IImageView Class Referenceabstract

Interface for viewing image pixel data from arbitrary sources. More...

#include <peak_common/types/peak_common_iimageview.hpp>

Public Member Functions

virtual const uint8_t * GetData () const =0
 Returns a pointer to the start of the first line that contains valid image data (read-only).
virtual uint8_t * GetData ()=0
 Returns a pointer to the start of the first line that contains valid image data (read-write).
virtual std::size_t GetLineStartOffset () const =0
 Returns the byte offset to the first pixel of a line.
virtual std::size_t GetSizeInBytes () const =0
 Returns the total size of the image data in bytes.
virtual peak::common::PixelFormat GetPixelFormat () const =0
 Returns the pixel format used by the image.
virtual peak::common::PixelFormatInfo GetPixelFormatInfo () const =0
 Returns a helper object describing the pixel format in detail.
virtual Size GetSize () const =0
 Returns the overall size of the image (width × height).
virtual uint32_t GetWidth () const =0
 Returns the width of the image in pixels.
virtual uint32_t GetHeight () const =0
 Returns the height of the image in pixels.
virtual size_t GetBitsPerPixel () const =0
 Returns the number of bits that each pixel occupies.
virtual size_t GetBytesPerLine () const =0
 Returns the number of bytes in a single image row.
virtual std::shared_ptr< peak::common::Metadata > GetMetadata ()=0
 Returns the metadata object which can be used to retrieve or set metadata belonging to the image.
virtual std::shared_ptr< const peak::common::Metadata > GetMetadata () const =0
 Returns the metadata object which can be used to retrieve metadata belonging to the image.

Detailed Description

Interface for viewing image pixel data from arbitrary sources.

This interface defines a standard way to access image properties and raw pixel data, enabling interoperability with different image processing libraries or backends.

Note
The interface does not own the image memory. Lifetime management must be handled externally.
Since
ids_peak_common 1.0

Member Function Documentation

◆ GetBitsPerPixel()

virtual size_t GetBitsPerPixel ( ) const
pure virtual

Returns the number of bits that each pixel occupies.

Returns
Bits per pixel.
Since
ids_peak_common 1.0

◆ GetBytesPerLine()

virtual size_t GetBytesPerLine ( ) const
pure virtual

Returns the number of bytes in a single image row.

Returns
Bytes per line, including any padding.
Since
ids_peak_common 1.0

◆ GetData() [1/2]

virtual const uint8_t * GetData ( ) const
pure virtual

Returns a pointer to the start of the first line that contains valid image data (read-only).

Returns
Pointer to the raw pixel data.
Since
ids_peak_common 1.0

◆ GetData() [2/2]

virtual uint8_t * GetData ( )
pure virtual

Returns a pointer to the start of the first line that contains valid image data (read-write).

Returns
Pointer to the raw pixel data.
Since
ids_peak_common 1.0

◆ GetHeight()

virtual uint32_t GetHeight ( ) const
pure virtual

Returns the height of the image in pixels.

Returns
Number of rows in the image.
Since
ids_peak_common 1.0

◆ GetLineStartOffset()

virtual std::size_t GetLineStartOffset ( ) const
pure virtual

Returns the byte offset to the first pixel of a line.

Returns
Line offset in bytes.
Since
ids_peak_common 1.2

◆ GetMetadata() [1/2]

virtual std::shared_ptr< const peak::common::Metadata > GetMetadata ( ) const
pure virtual

Returns the metadata object which can be used to retrieve metadata belonging to the image.

Returns
Pointer to the metadata object
Since
ids_peak_common 1.0

◆ GetMetadata() [2/2]

virtual std::shared_ptr< peak::common::Metadata > GetMetadata ( )
pure virtual

Returns the metadata object which can be used to retrieve or set metadata belonging to the image.

Returns
Pointer to the metadata object
Since
ids_peak_common 1.0

◆ GetPixelFormat()

virtual peak::common::PixelFormat GetPixelFormat ( ) const
pure virtual

Returns the pixel format used by the image.

Returns
The PixelFormat of the image stored in the buffer.
Since
ids_peak_common 1.0

◆ GetPixelFormatInfo()

virtual peak::common::PixelFormatInfo GetPixelFormatInfo ( ) const
pure virtual

Returns a helper object describing the pixel format in detail.

The PixelFormatInfo class provides methods to inspect the layout, size, channel count, channel order, and other attributes of the format returned by GetPixelFormat().

Returns
An instance of PixelFormatInfo for querying format details.
Since
ids_peak_common 1.0

◆ GetSize()

virtual Size GetSize ( ) const
pure virtual

Returns the overall size of the image (width × height).

Returns
Size object containing width and height in pixels.
Since
ids_peak_common 1.0

◆ GetSizeInBytes()

virtual std::size_t GetSizeInBytes ( ) const
pure virtual

Returns the total size of the image data in bytes.

Returns
Number of bytes occupied by the image in the buffer.
Since
ids_peak_common 1.0

◆ GetWidth()

virtual uint32_t GetWidth ( ) const
pure virtual

Returns the width of the image in pixels.

Returns
Number of pixels per row.
Since
ids_peak_common 1.0

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