MultiPart image class. More...

#include <cvb/driver/multi_part_image.hpp>

Inherits StreamImage, and enable_shared_from_this< MultiPartImage >.

Public Member Functions
int	NumParts () const noexcept
	Number of parts in the multi part image.

CompositeVariant	GetPartAt (int index) const
	Access to a multi part image element specified by its index.

Public Member Functions inherited from StreamImage
virtual double	RawTimestamp () const noexcept
	Gets the raw timestamp as reported by the driver.

Public Member Functions inherited from Image
	Image (Size2D< int > size, int numPlanes=1, DataType dataType=DataType::Int8BppUnsigned())
	Constructs an uninitialized image with the given parameters.

	Image (int width, int height, int numPlanes=1, DataType dataType=DataType::Int8BppUnsigned())
	Constructs an uninitialized image with the given parameters.

	Image (const String &fileName)
	Loads an image with the given file name.

void *	Handle () const noexcept
	Classic API image handle.

int	PlanesCount () const noexcept
	Get the number of planes for this image.

bool	PlaneDataTypesIdentical () const noexcept
	Check if all planes have the same data type.

ImagePlane	Plane (int plane) const
	Indexed access to the individual plane information.

std::vector< ImagePlane >	Planes () const noexcept
	Access all planes for this image.

std::vector< double >	GetPixel (Point2D< int > position) const
	Gets the pixel values for all planes at a give position.

int	Height () const noexcept
	Height of the image in pixels.

int	Width () const noexcept
	Width of the image in pixels.

Cvb::ColorModel	ColorModel () const noexcept
	Color model realized by this image.

void	Save (const String &fileName) const
	Write the current content of the image into a file.

void	Save (const String &fileName, double quality) const
	Write the current content of the image into a file.

std::unique_ptr< Image >	Map (Rect< int > rect) const
	Creates a mapped image of the region of this image.

std::unique_ptr< Image >	Map (Rect< int > sourceRect, Size2D< int > targetSize) const
	Creates a mapped image of the region of that image scaled to the size.

std::unique_ptr< Image >	Map (RotationMap rotation) const
	Creates a mapped image of this whole image rotated by the given RotationMap.

std::unique_ptr< Image >	Clone () const
	Creates a new image object, that is a copy of the current instance.

void	Copy (Image &targetImage, Rect< int > sourceRect, Point2D< int > targetPosition) const
	Copies the image data from the source rectangle of this image to the target position inside the target image.

void	Copy (Image &targetImage) const
	Copies the image data from this image to the target image.

Size2D< int >	Size () const noexcept
	Size of the image in pixels.

Rect< int >	Bounds () const noexcept
	Bounding rectangle of the image in pixels.

void	RaisePixelContentChanged () const
	Inform clients listening to the pixel content changed event, that the image data has been completely updated (full area).

void	RaisePixelContentChanged (Rect< int > rect) const
	Inform clients listening to the pixel content changed event, that the image data has been updated in the given rectangle.

EventCookie	RegisterEventPixelContentChanged (std::function< void(const Image &, Rect< int >)> handler)
	Register a listener to the pixel content changed event.

void	UnregisterEventPixelContentChanged (EventCookie eventCookie) noexcept
	Manually unregister a listener from the pixel content changed event.

Point2D< double >	ImageToPixelCoordinates (Point2D< double > point) const noexcept
	Convert a point from image to pixel coordinates.

Area2D	ImageToPixelCoordinates (Area2D area) const noexcept
	Convert an Area2D from image to pixel coordinates.

Point2D< double >	PixelToImageCoordinates (Point2D< double > point) const noexcept
	Convert a point from pixel to image coordinates.

Area2D	PixelToImageCoordinates (Area2D area) const noexcept
	Convert an Area2D from pixel to image coordinates.

AffineMatrix2D	CoordinateSystem () const noexcept
	Get the coordinate system of the image.

void	SetCoordinateSystem (AffineMatrix2D affineMatrix) noexcept
	Set the coordinate system of the image.

Static Public Member Functions
static MultiPartImagePtr	FromComposite (CompositePtr object)
	Creates an image object from a composite.

Static Public Member Functions inherited from Image
static std::unique_ptr< Image >	Load (const String &fileName)
	Loads an image with the given file name.

static std::unique_ptr< Image >	Create (Size2D< int > size, int numPlanes=1, DataType dataType=DataType::Int8BppUnsigned())
	Creates an uninitialized image with the given parameters.

static std::unique_ptr< Image >	Create (int width, int height, int numPlanes=1, DataType dataType=DataType::Int8BppUnsigned())
	Creates an uninitialized image with the given parameters.

template<class RANGE>
static TypedRange< std::unique_ptr< Image >, ImagePtr, RANGE >::type	FromImages (MappingOption mapping, const RANGE &images)
	Create an image that is the result of concatenating a series of input images.

template<class... IMAGES>
static VarArgRange< std::unique_ptr< Image >, constImage &, IMAGES... >::type	FromImages (MappingOption mapping, const IMAGES &...images)
	Create an image that is the result of concatenating a series of input images.

template<class RANGE>
static TypedRange< std::unique_ptr< Image >, ImagePlane, RANGE >::type	FromPlanes (MappingOption mapping, const RANGE &planes)
	Create an image that is the result of concatenating a series of input planes.

template<class... PLANES>
static VarArgRange< std::unique_ptr< Image >, ImagePlane &&, PLANES... >::type	FromPlanes (MappingOption mapping, PLANES &&...planes)
	Create an image that is the result of concatenating a series of input planes.

static std::unique_ptr< Image >	FromHandle (HandleGuard< Image > &&guard)
	Creates an image from a classic API handle.

template<class T, class... ARGS>
static std::unique_ptr< T >	FromHandle (HandleGuard< Image > &&guard, ARGS &&...args)
	Creates an image from a classic API handle (typed).

static std::unique_ptr< Image >	FromPixelFormat (const Cvb::Size2D< int > &size, Cvb::PfncFormat format)
	Creates an image from a specified pixel format.

static std::unique_ptr< Image >	FromPixelFormat (int width, int height, Cvb::PfncFormat format)
	Creates an image from a specified pixel format.

Additional Inherited Members
Related Symbols inherited from Image
std::unique_ptr< Image >	AffineTransform (const Image &image, AffineMatrix2D affineMatrix, Area2D area)
	Creates an affine transformation (homogeneous matrix transformation) of an area of the given image.

std::unique_ptr< Image >	AffineTransform (const Image &image, AffineMatrix2D affineMatrix)
	Creates an affine transformation (homogeneous matrix transformation) of the whole image.

std::unique_ptr< Image >	LinearTransform (const Image &image, Matrix2D matrix)
	Creates a linear transformation (matrix transformation).

std::unique_ptr< Image >	MapTo8Bit (const Image &image, PlaneNormalization planeNormalization=PlaneNormalization::Identical)
	Take an input image and scale the pixel values to fit into the 8 bit value range.

std::unique_ptr< Image >	NormalizeMinMax (const Image &image, double targetMin, double targetMax)
	Normalize an input image using min/max normalization (the gray values of the image will be stretched or compressed to fit the input target minimum and maximum values).

std::unique_ptr< Image >	NormalizeMeanVariance (const Image &image, double targetMean, double targetVariance)
	Normalize an input image using mean/variance normalization (the gray values of the image will be stretched modified to generate a histogram as close as possible to the input target mean and variance values).

std::unique_ptr< Image >	PolarTransform (const Image &image, Point2D< double > center, double innerRadius, double outerRadius, Angle startAngle, Angle totalAngle)
	Create a polar transformation (i.e. unwrap a ring structure from inside source image into a rectangular image).

std::unique_ptr< Image >	PolarTransform (const Image &image, Point2D< double > center, double innerRadius, double outerRadius)
	Create a polar transformation (i.e. unwrap a ring structure from inside source image into a rectangular image).

std::unique_ptr< Image >	InversePolarTransform (const Image &image, Angle startAngle, double innerRadius)

void	InversePolarTransformToDst (const Image &imageSrc, Point2D< double > center, Angle startAngle, double innerRadius, Image &imageDst)
	Create an inverse polar transformed image (i.e. transform an unwrapped image back into a ring structure).

Detailed Description

MultiPart image class.

Member Function Documentation

◆ FromComposite()

static MultiPartImagePtr FromComposite ( CompositePtr object )

inlinestatic

Creates an image object from a composite.

Parameters

[in] object A composite to share.

Returns: A n image ptr object that shares resources with the composite.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ GetPartAt()

CompositeVariant GetPartAt ( int index ) const

inline

Access to a multi part image element specified by its index.

Parameters

[in] index Part index of the multi part element to access.

Returns: A composite variant.

Exceptions

Any	exception derived from std::exception including CvbException.

◆ NumParts()

int NumParts ( ) const

inlinenoexcept

Number of parts in the multi part image.

Returns: Number of parts.

Exceptions

Does	not throw any exception.

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ FromComposite()

◆ GetPartAt()

◆ NumParts()