IDS peak comfortC  v1.1.0
Host Features

Modules

 Pixel format
 
 Gain
 
 Gamma
 
 Color correction
 
 Auto brightness control
 
 Auto white balance control
 
 Hotpixel Correction
 
 Mirror
 

Functions

peak_status peak_IPL_ProcessFrame (peak_camera_handle hCam, peak_frame_handle hFrame, peak_frame_handle *hResultFrame)
 Process a frame with the host image processing pipeline and store the result in a new frame. More...
 
peak_status peak_IPL_ProcessFrameInplace (peak_camera_handle hCam, peak_frame_handle hFrame)
 Process a frame with the host image processing pipeline and replace the original frame. More...
 

Detailed Description

Image processing functions, executed on the host system.

Function Documentation

◆ peak_IPL_ProcessFrame()

peak_status peak_IPL_ProcessFrame ( peak_camera_handle  hCam,
peak_frame_handle  hFrame,
peak_frame_handle *  hResultFrame 
)

Process a frame with the host image processing pipeline and store the result in a new frame.

Processes a frame with the host image processing pipeline and stores the result in a new frame. The host image processing pipeline can be configured with functions in the Host Features group.

The new frames create by this function are stored in the hResultFrame parameter. These frames must be released via peak_Frame_Release.

Parameters
[in]hCamThe camera handle.
[in]hFrameHandle to the input frame.
[out]hResultFrameHandle to the processed output frame.
Returns
PEAK_STATUS_SUCCESS Operation was successful; no error occurred.
PEAK_STATUS_INVALID_CONFIGURATION The image processing pipeline was misconfigured and can't apply the required operations on the input image. Check the last error for more information.
PEAK_STATUS_INVALID_PARAMETER hResultFrame is an invalid pointer.
PEAK_STATUS_INVALID_HANDLE hFrame and/or hCam are invalid handles.
PEAK_STATUS_NOT_INITIALIZED The library is not initialized.
PEAK_STATUS_ERROR An unexpected internal error occurred.

◆ peak_IPL_ProcessFrameInplace()

peak_status peak_IPL_ProcessFrameInplace ( peak_camera_handle  hCam,
peak_frame_handle  hFrame 
)

Process a frame with the host image processing pipeline and replace the original frame.

Processes a frame with the host image processing pipeline and replaces the original frame. The host image processing pipeline can be configured with functions in the Host Features group.

Note
Since debayered images require more memory than the corresponding Bayer image, it's not possible to convert from Bayer formats to RGB(a)/BGR(a) with this in-place function.

The hFrame must still be released via peak_Frame_Release.

Parameters
[in]hCamThe camera handle.
[in]hFrameHandle to the input frame.
Returns
PEAK_STATUS_SUCCESS Operation was successful; no error occurred.
PEAK_STATUS_INVALID_CONFIGURATION The image processing pipeline was misconfigured and can't apply the required operations on the input image. Check the last error for more information.
PEAK_STATUS_BUFFER_TOO_SMALL The image processing pipeline is configured for debayering, which can't be done in-place.
PEAK_STATUS_INVALID_HANDLE hFrame and/or hCam are invalid handles.
PEAK_STATUS_NOT_INITIALIZED The library is not initialized.
PEAK_STATUS_ERROR An unexpected internal error occurred.