VPI - Vision Programming Interface

3.0 Release

Filter an image with a 2D binary kernel composed with the dilate morphological operation. More...

Functions

VPIStatus vpiSubmitDilate (VPIStream stream, uint64_t backend, VPIImage input, VPIImage output, const int8_t *kernelData, int32_t kernelWidth, int32_t kernelHeight, VPIBorderExtension border)
 Runs a 2D dilate over an image. More...
 

Detailed Description

Filter an image with a 2D binary kernel composed with the dilate morphological operation.

Refer to Dilate for more details and usage examples regarding Dilate.

Function Documentation

◆ vpiSubmitDilate()

VPIStatus vpiSubmitDilate ( VPIStream  stream,
uint64_t  backend,
VPIImage  input,
VPIImage  output,
const int8_t *  kernelData,
int32_t  kernelWidth,
int32_t  kernelHeight,
VPIBorderExtension  border 
)

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

Runs a 2D dilate over an image.

Parameters
[in]streamThe stream handle where the operation will be queued in.
  • Must not be NULL.
  • Stream must have enabled the backends that will execute the algorithm.
[in]backendBackend that will execute the algorithm.
[in]inputInput image to be dilated with the kernel.
[out]outputOutput image where the result is written to.
  • Must not be NULL.
  • Its image format and dimensions must be the same as input.
  • Image must have enabled the backends that will execute the algorithm.
[in]kernelWidth,kernelHeightKernel dimensions.
  • Must be between 1x1 and 11x11, and can be non-square.
[in]kernelDataDilate kernel binary mask, i.e. structuring element or neighborhood definition, in row-major layout. The kernel elements are copied to an internal buffer. The buffers passed can be deallocated after the call. Use NULL for full neighborhood, all elements considered to be 1.
  • If not NULL, it must point to a buffer with kernelWidth * kernelHeight elements.
[in]borderHow to handle pixels outside image boundaries.
Return values
VPI_ERROR_INVALID_ARGUMENTstream is NULL.
VPI_ERROR_INVALID_ARGUMENTinput or output are NULL.
VPI_ERROR_INVALID_ARGUMENTkernelWidth or kernelHeight outside valid range.
VPI_ERROR_INVALID_ARGUMENTinput and output images must have same dimensions and format.
VPI_ERROR_INVALID_ARGUMENTborder not supported.
VPI_ERROR_INVALID_IMAGE_FORMATinput format not supported.
VPI_ERROR_NOT_IMPLEMENTEDDilate algorithm is not supported by given backend.
VPI_ERROR_INVALID_OPERATIONThe needed backends aren't enabled in stream, input or output.
VPI_SUCCESSOperation executed successfully.