Color Names Features Extractor

Extracts the Color Names features of the input image. More...

Functions
VPIStatus	vpiCreateExtractColorNameFeatures (uint32_t backends, VPIImageFormat outType, VPIPayload *payload)
	Creates the payload for the Color Names algorithm. More...
VPIStatus	vpiSubmitExtractColorNameFeatures (VPIStream stream, uint32_t backend, VPIPayload payload, VPIImage input, VPIImage *output, int32_t numOutputs)
	Submits the Color Names algorithm to the stream associated with the payload. More...

Detailed Description

Extracts the Color Names features of the input image.

Function Documentation

vpiCreateExtractColorNameFeatures()

VPIStatus vpiCreateExtractColorNameFeatures	(	uint32_t	backends,
		VPIImageFormat	outType,
		VPIPayload *	payload
	)

#include <vpi/experimental/ColorNames.h>

Creates the payload for the Color Names algorithm.

Parameters

[in]	backends	VPI backends that are eligible to execute the algorithm. Currently only one backend is accepted.
[in]	outType	Type of the output images. It must be one of: VPI_IMAGE_FORMAT_S8 VPI_IMAGE_FORMAT_U8 VPI_IMAGE_FORMAT_S16 VPI_IMAGE_FORMAT_U16

16-bit types will return more precise values, in exchange of some minor performance hit. 8-bit types will be less precise, but typically leads to faster execution time.

Parameters

[out]

payload

Pointer to a handle that will receive the created payload.

Returns

VPI_SUCCESS if payload creation succeeded, or any other VPIStatus value in case of error.

vpiSubmitExtractColorNameFeatures()

VPIStatus vpiSubmitExtractColorNameFeatures	(	VPIStream	stream,
		uint32_t	backend,
		VPIPayload	payload,
		VPIImage	input,
		VPIImage *	output,
		int32_t	numOutputs
	)

#include <vpi/experimental/ColorNames.h>

Submits the Color Names algorithm 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 to be submitted along the other parameters.
[in]	input	Input image. The following image types are accepted: VPI_IMAGE_FORMAT_RGB8 VPI_IMAGE_FORMAT_RGBA8 VPI_IMAGE_FORMAT_NV12
[out]	output	Pointer to an array of VPIImage where the features will be written to. The images must have the same type as set during payload creation.
[in]	numOutputs	Number of images in output array. It must be equal to 10.

Returns

VPI_SUCCESS if payload creation succeeded, or any other VPIStatus value in case of error.