IDS peak ICV v1.4.0
Loading...
Searching...
No Matches
UndistortedImage Class Referencesealed
Inheritance diagram for UndistortedImage:

Public Member Functions

 UndistortedImage (Image image, IntrinsicParameters intrinsicParameters)
 Wraps an already undistorted image with its corresponding intrinsic camera parameters.
 
void Dispose ()
 Releases the resources used by the Image class.
 
void ResetRegion ()
 Resets the region on the image to the complete image.
 
Image Copy ()
 
Image ConvertPixelFormat (PixelFormat pixelFormat)
 Converts the image to a different pixel format.
 
Image ConvertPixelFormatWithFactor (PixelFormat pixelFormat, double factor)
 Converts an image into another pixel format with a factor multiplied to every pixel.
 
Image Subtract (Image subtrahend)
 Subtracts the specified subtrahend image pixel-wise from the current image and returns the resulting image.
 
List< Image > Deinterleave ()
 Splits an image with an interleaved pixel format into individual images. The function separates e.g. multiple exposures embedded in the combined HDR raw image and provides them as independent images, each with the correctly associated exposure information.
 

Static Public Member Functions

static Image operator- (Image minuend, Image subtrahend)
 Performs pixel-wise subtraction of two images.
 

Properties

IntrinsicParameters IntrinsicParameters [get]
 
PixelFormat PixelFormat [get]
 Gets the pixel format from the image.
 
Size Size [get]
 Gets the image size in pixels from the image.
 
uint Width [get]
 Gets the image width in pixels from the image.
 
uint Height [get]
 Gets the image height in pixels from the image.
 
IntPtr Data [get]
 Gets the image buffer from the image.
 
long SizeInBytes [get]
 Gets the size of the image data in bytes.
 
Metadata Metadata [get, set]
 Gets or sets the metadata of the image.
 
Region Region [get, set]
 Gets or sets a region of interest (ROI) for the specified image handle, which defines a sub-area of the image where operations or analyses are focused. Any points in the region that fall outside the bounds of the image are automatically discarded (clipped).
 
static IEqualityComparer< Image > Comparer = new ImageEqualityComparer() [get]
 Gets a default equality comparer for comparing Image data values.
 

Detailed Description

Represents an image that has undergone undistortion.

The UndistortedImage class is derived from Image and encapsulates the result of an undistortion process. It includes updated intrinsic parameters computed during the undistortion. These parameters are essential for further processing such as point cloud generation.

Since
IDSImaging.Peak.ICV 1.3

Constructor & Destructor Documentation

◆ UndistortedImage()

UndistortedImage ( Image image,
IntrinsicParameters intrinsicParameters )
inline

Wraps an already undistorted image with its corresponding intrinsic camera parameters.

Since
IDSImaging.Peak.ICV 1.3

Member Function Documentation

◆ ConvertPixelFormat()

Image ConvertPixelFormat ( PixelFormat pixelFormat)
inlineinherited

Converts the image to a different pixel format.

If the input image has the same pixel format as the specified pixel format parameter, the image will be copied.

Restrictions:

  • Conversion to Bayer formats is only supported from a bayer format with the same pattern, e.g. from BayerRG10p to BayerRG10 or BayerRG8.
  • Conversion to packed formats is not supported.
  • Conversions from RGB or BGR formats to RGBa or BGRa formats is not supported.
  • RGBa and BGRa formats support only conversions into different bit depths of the same channel layout or to Mono formats.
  • Confidence and Coord3D formats can only be converted to other bit depths of the same format type.
Parameters
pixelFormatThe target pixel format.
Returns
A new Image with the target pixel format.

For a full list of supported conversions see Supported Pixel Format Conversions.

Since
IDSImaging.Peak.ICV 1.3

◆ ConvertPixelFormatWithFactor()

Image ConvertPixelFormatWithFactor ( PixelFormat pixelFormat,
double factor )
inlineinherited

Converts an image into another pixel format with a factor multiplied to every pixel.

If the input image has the same pixel format as the specified pixel format parameter, the image will be copied.

Supported conversions:

From PixelFormat.Coord3D_C8 or PixelFormat.Coord3D_C16 to PixelFormat.Coord3D_C32f

Parameters
pixelFormatThe target pixel format.
factorThe multiplication factor.
Returns
A new image with the target pixel format.
Since
IDSImaging.Peak.ICV 1.3

◆ Copy()

Image Copy ( )
inlineinherited
Returns
A deep copy of the image, including its region and metadata.
Since
IDSImaging.Peak.ICV 1.3

◆ Deinterleave()

List< Image > Deinterleave ( )
inlineinherited

Splits an image with an interleaved pixel format into individual images. The function separates e.g. multiple exposures embedded in the combined HDR raw image and provides them as independent images, each with the correctly associated exposure information.

Supported pixel formats
  • Mono10g40IDS_I_A_B
  • BayerRG10g40IDS_I_A_B
  • BayerBG10g40IDS_I_A_B
  • BayerGR10g40IDS_I_A_B
  • BayerGB10g40IDS_I_A_B
  • Mono12g24IDS_I_A_B
  • BayerRG12g24IDS_I_A_B
  • BayerBG12g24IDS_I_A_B
  • BayerGR12g24IDS_I_A_B
  • BayerGB12g24IDS_I_A_B
  • Mono8_I_A_B
  • BayerRG8_I_A_B
  • BayerBG8_I_A_B
  • BayerGR8_I_A_B
  • BayerGB8_I_A_B
  • Mono10_I_A_B
  • BayerRG10_I_A_B
  • BayerBG10_I_A_B
  • BayerGR10_I_A_B
  • BayerGB10_I_A_B
  • Mono12_I_A_B
  • BayerRG12_I_A_B
  • BayerBG12_I_A_B
  • BayerGR12_I_A_B
  • BayerGB12_I_A_B
  • Mono10p_I_A_B
  • BayerRG10p_I_A_B
  • BayerBG10p_I_A_B
  • BayerGR10p_I_A_B
  • BayerGB10p_I_A_B
  • Mono12p_I_A_B
  • BayerRG12p_I_A_B
  • BayerBG12p_I_A_B
  • BayerGR12p_I_A_B
  • BayerGB12p_I_A_B
  • Mono8_I_AB_CD
  • Mono10_I_AB_CD
  • Mono12_I_AB_CD
  • Mono10p_I_AB_CD
  • Mono12p_I_AB_CD
  • Mono10g40IDS_I_AB_CD
  • Mono12g24IDS_I_AB_CD

See the Pixel and Pixel Format Specifications for a detailed description of the pixel formats.

Returns
A list of images, where each element represents one of the interleaved images.
Since
IDSImaging.Peak.ICV 1.3

◆ Dispose()

void Dispose ( )
inlineinherited

Releases the resources used by the Image class.

Since
IDSImaging.Peak.ICV 1.3

◆ operator-()

static Image operator- ( Image minuend,
Image subtrahend )
inlinestaticinherited

Performs pixel-wise subtraction of two images.

This operator performs a pixel-wise subtraction of subtrahend from minuend . Both images must have the same pixel format and dimensions.

Parameters
minuendThe image from which the subtrahend is subtracted.
subtrahendThe image to subtract from the minuend .
Returns
A new Image object representing the result of the subtraction.
Exceptions
IcvMismatchExceptionThe images have different dimensions or pixel formats.
Since
IDSImaging.Peak.ICV 1.3

◆ ResetRegion()

void ResetRegion ( )
inlineinherited

Resets the region on the image to the complete image.

Since
IDSImaging.Peak.ICV 1.3

◆ Subtract()

Image Subtract ( Image subtrahend)
inlineinherited

Subtracts the specified subtrahend image pixel-wise from the current image and returns the resulting image.

This function performs a pixelwise subtraction of the given subtrahend image from the current image. The resulting image is returned as a new Image object. The operation requires that both images have the same pixel format and dimensions.

Parameters
subtrahendThe image to subtract from the current image.
Returns
The resulting image after pixel-wise subtraction.
Exceptions
IcvMismatchExceptionThrown if the images have different dimensions or pixel formats.
Since
IDSImaging.Peak.ICV 1.3

Property Documentation

◆ Comparer

IEqualityComparer<Image> Comparer = new ImageEqualityComparer()
staticgetinherited

Gets a default equality comparer for comparing Image data values.

Since
IDSImaging.Peak.ICV 1.3

◆ Data

IntPtr Data
getinherited

Gets the image buffer from the image.

Since
IDSImaging.Peak.ICV 1.3

◆ Height

uint Height
getinherited

Gets the image height in pixels from the image.

Since
IDSImaging.Peak.ICV 1.3

◆ IntrinsicParameters

◆ Metadata

Metadata Metadata
getsetinherited

Gets or sets the metadata of the image.

Since
IDSImaging.Peak.ICV 1.3

◆ PixelFormat

PixelFormat PixelFormat
getinherited

Gets the pixel format from the image.

Since
IDSImaging.Peak.ICV 1.3

◆ Region

Region Region
getsetinherited

Gets or sets a region of interest (ROI) for the specified image handle, which defines a sub-area of the image where operations or analyses are focused. Any points in the region that fall outside the bounds of the image are automatically discarded (clipped).

Since
IDSImaging.Peak.ICV 1.3

◆ Size

Size Size
getinherited

Gets the image size in pixels from the image.

Since
IDSImaging.Peak.ICV 1.3

◆ SizeInBytes

long SizeInBytes
getinherited

Gets the size of the image data in bytes.

Since
IDSImaging.Peak.ICV 1.3

◆ Width

uint Width
getinherited

Gets the image width in pixels from the image.

Since
IDSImaging.Peak.ICV 1.3