VPI - Vision Programming Interface

2.0 Release - Developer Preview

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]streamThe stream where the operation will be queued in.
  • Must not be NULL.
  • Stream must have enabled the backends that will execute the algorithm.
[in]backendVPI backend that will execute the algorithm.
[in]inputInput image.
[out]outputWhere the resulting Laplacian pyramid will be written to. It must have been created with the desired scale and number of levels.
[out]gaussianPyrDefines 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]borderBorder extension to be used when sampling pixels outside the image border.
Return values
VPI_ERROR_INVALID_ARGUMENTstream is NULL.
VPI_ERROR_INVALID_ARGUMENTinput or output are NULL.
VPI_ERROR_INVALID_ARGUMENTgaussianPyr and output must have the same scale, number of levels and dimensions.
VPI_ERROR_INVALID_IMAGE_FORMATinput and gaussianPyr must have the same format.
VPI_ERROR_INVALID_IMAGE_FORMAToutput format not compatible with input format.
VPI_ERROR_INVALID_IMAGE_FORMATUnsupported input image format.
VPI_ERROR_INVALID_OPERATIONThe needed backends aren't enabled in stream, input, output or gaussianPyr.
VPI_ERROR_NOT_IMPLEMENTEDLaplacian Pyramid algorithm is not supported by given backend.
VPI_SUCCESSOperation executed successfully.