Remap

Remaps the input image, effectively warping it using a user-provided mapping. More...

Functions
VPIStatus	vpiCreateRemap (uint32_t backends, const VPIWarpMap *warpMap, VPIPayload *payload)
	Create a payload for Remap algorithm. More...
VPIStatus	vpiSubmitRemap (VPIStream stream, uint32_t backend, VPIPayload payload, VPIImage input, VPIImage output, VPIInterpolationType interp, VPIBorderExtension border, uint32_t flags)
	Submits the Remap operation to the stream associated with the payload. More...

Detailed Description

Remaps the input image, effectively warping it using a user-provided mapping.

Function Documentation

vpiCreateRemap()

VPIStatus vpiCreateRemap	(	uint32_t	backends,
		const VPIWarpMap *	warpMap,
		VPIPayload *	payload
	)

#include <vpi/algo/Remap.h>

Create a payload for Remap algorithm.

This function allocates all resources needed by the Remap algorithm and ties the returned payload to the given stream.

Parameters

[in]	backends	VPI backends that are eligible to execute the algorithm. Currently only one backend is accepted.
[in]	warpMap	Mapping of output into input. It must define a grid with the same size as output image.
[out]	payload	Pointer to a payload handle with the create payload.

Returns

VPI_SUCCESS if payload was created successfully, or some other VPIStatus value in case of error.

vpiSubmitRemap()

VPIStatus vpiSubmitRemap	(	VPIStream	stream,
		uint32_t	backend,
		VPIPayload	payload,
		VPIImage	input,
		VPIImage	output,
		VPIInterpolationType	interp,
		VPIBorderExtension	border,
		uint32_t	flags
	)

#include <vpi/algo/Remap.h>

Submits the Remap operation to the stream associated with the payload.

Parameters

[in]	stream	The stream where the operation will be queued in.
[in]	backend	Backend that will execute the algorithm. Must be one of the backends specified during payload creation. If 0, VPI will select one of the eligible backends from the payload that accepts the given parameters, usually the fastest one.
[in]	payload	Payload created by vpiCreateRemap.
[in]	input	Image to be remapped. In a lens distortion correction context, this would correspond to the distorted image. Valid image types: VPI_IMAGE_FORMAT_NV12
[out]	output	Stores the remapped image. In a lens distortion correction context, this would correspond to the corrected (distortion-free) image. Must have the same type as input.
[in]	interp	Interpolation method to be used. Valid values: VPI_INTERP_NEAREST VPI_INTERP_LINEAR VPI_INTERP_CATMULL_ROM
[in]	border	What value to pick if remapped coordinated falls outside input image. Valid values: VPI_BORDER_ZERO, -ref VPI_BORDER_CLAMP and -ref VPI_BORDER_MIRROR.
[in]	flags	Control flags. 0: default, negation of all other flags. VPI_PRECISE : precise, but potentially slower implementation.

Returns

VPI_SUCCESS if algorithm was submitted successfully, or some other VPIStatus value in case of error.