VPI - Vision Programming Interface

3.0 Release

Gaussian Pyramid Generator

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

Functions

VPIStatus vpiSubmitGaussianPyramidGenerator (VPIStream stream, uint64_t backend, VPIImage input, VPIPyramid output, VPIBorderExtension border)
 Computes the Gaussian pyramid from the input image. More...
 

Detailed Description

Creates a Gaussian pyramid from the input image.

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

Function Documentation

◆ vpiSubmitGaussianPyramidGenerator()

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

#include </opt/nvidia/vpi3/include/vpi/algo/GaussianPyramid.h>

Computes the Gaussian pyramid from the input image.

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 that corresponds to the finer level of the pyramid. Processing is more efficient if input is wrapping the first level of the output pyramid.
[out]outputWhere the resulting gaussian pyramid will be written to. It must have been created with the desired scale and number of levels.
  • Must not be NULL.
  • Must have scale == 0.5.
  • Must have been created with the desired scale and number of levels.
  • First level dimensions must match input image's.
  • Pyramid format must match input's.
  • Pyramid must have enabled the backends that will execute the algorithm.
  • On PVA backend, every pyramid level's dimension must be at least 16x16 big and have at most 10 levels.
[in]borderBorder extension.
Return values
VPI_ERROR_INVALID_ARGUMENTstream is NULL.
VPI_ERROR_INVALID_ARGUMENTinput or output are NULL.
VPI_ERROR_INVALID_ARGUMENToutput pyramid's scale or dimensions outside valid range.
VPI_ERROR_INVALID_ARGUMENTinput image and output pyramid's first level dimensions do not match.
VPI_ERROR_INVALID_ARGUMENTborder not supported.
VPI_ERROR_INVALID_ARGUMENTbackend is invalid or unknown.
VPI_ERROR_INVALID_ARGUMENTinput and output formats do not match.
VPI_ERROR_INVALID_IMAGE_FORMATinput and output formats aren't not supported.
VPI_ERROR_NOT_IMPLEMENTEDGaussian Pyramid Generator algorithm is not supported by given backend.
VPI_ERROR_INVALID_OPERATIONBackend hardware not available.
VPI_ERROR_INVALID_OPERATIONThe needed backends aren't enabled in stream, input or output.
VPI_SUCCESSOperation executed successfully.