Laplacian Pyramid Generator

Creates a Laplacian pyramid from the input image. More...

Functions
VPIStatus	vpiSubmitLaplacianPyramidGenerator (VPIStream stream, uint64_t backend, VPIImage input, VPIPyramid output, VPIPyramid gaussianPyr, VPIBorderExtension border)
	Computes the Laplacian pyramid from the input image. More...

Detailed Description

Creates a Laplacian pyramid from the input image.

Refer to Laplacian Pyramid Generator for more details and usage examples.

Function Documentation

vpiSubmitLaplacianPyramidGenerator()

VPIStatus vpiSubmitLaplacianPyramidGenerator	(	VPIStream	stream,
		uint64_t	backend,
		VPIImage	input,
		VPIPyramid	output,
		VPIPyramid	gaussianPyr,
		VPIBorderExtension	border
	)

#include <vpi/algo/LaplacianPyramid.h>

Computes the Laplacian pyramid from the input image.

Note

The coarsest level of the Laplacian pyramid is equivalent in concept to that of the Gaussian pyramid. However, in cases where the Laplacian pyramid output format has less positive dynamic range than the input format, i.e. input format is VPI_IMAGE_FORMAT_U8 and output format is VPI_IMAGE_FORMAT_S8 or U16 and S16, the pixel values of the output in the coarsest level are divided by 2 in order to avoid overflow.

Parameters

[in]	stream	The stream where the operation will be queued in. Must not be NULL. Stream must have enabled the backends that will execute the algorithm.
[in]	backend	VPI backend that will execute the algorithm. Valid values: VPI_BACKEND_CPU VPI_BACKEND_CUDA
[in]	input	Input image. Must not be NULL. Image must have enabled the backends that will execute the algorithm. Supported formats are: VPI_IMAGE_FORMAT_U8 VPI_IMAGE_FORMAT_U16 VPI_IMAGE_FORMAT_F32 VPI_IMAGE_FORMAT_Y8 VPI_IMAGE_FORMAT_Y8_ER VPI_IMAGE_FORMAT_Y16 VPI_IMAGE_FORMAT_Y16_ER
[out]	output	Where the resulting Laplacian pyramid will be written to. It must have been created with the desired scale and number of levels. Must not be NULL. Dimensions of first level must be the same as input. Pyramid must have enabled the backends that will execute the algorithm. Supported formats: VPI_IMAGE_FORMAT_S8 (only for 8-bit inputs) VPI_IMAGE_FORMAT_S16 (only for integer inputs) VPI_IMAGE_FORMAT_F32
[out]	gaussianPyr	Defines where the intermediate Gaussian pyramid will be written to. Pass NULL if not needed. Must have same format as input. Must have same scale, number of levels and dimensions as output. Pyramid must have enabled the backends that will execute the algorithm.
[in]	border	Border extension to be used when sampling pixels outside the image border. Valid values: Border CPU CUDA PVA VPI_BORDER_ZERO * * * VPI_BORDER_CLAMP * * * VPI_BORDER_REFLECT * VPI_BORDER_MIRROR *

Return values

VPI_ERROR_INVALID_ARGUMENT	stream is NULL.
VPI_ERROR_INVALID_ARGUMENT	input or output are NULL.
VPI_ERROR_INVALID_ARGUMENT	gaussianPyr and output must have the same scale, number of levels and dimensions.
VPI_ERROR_INVALID_IMAGE_FORMAT	input and gaussianPyr must have the same format.
VPI_ERROR_INVALID_IMAGE_FORMAT	output format not compatible with input format.
VPI_ERROR_INVALID_IMAGE_FORMAT	Unsupported input image format.
VPI_ERROR_INVALID_OPERATION	The needed backends aren't enabled in stream, input, output or gaussianPyr.
VPI_ERROR_NOT_IMPLEMENTED	Laplacian Pyramid algorithm is not supported by given backend.
VPI_SUCCESS	Operation executed successfully.