Function

vImageMultiDimensionalInterpolatedLookupTable_Planar16Q12

Uses a multidimensional lookup table to transform an image in Planar16Q12 format.

Declaration

vImage_Error vImageMultiDimensionalInterpolatedLookupTable_Planar16Q12(const vImage_Buffer srcs[], const vImage_Buffer dests[], void *tempBuffer, vImage_MultidimensionalTable table, vImage_InterpolationMethod method, vImage_Flags flags);

Parameters

srcs

An array of vImage buffers that reference the source image planes. The number of such buffers is given by the numSrcChannels parameter passed to vImageMultidimensionalTable_Create.

dests

An array of vImage buffers that reference the source image planes. The number of such buffers is given by the numSrcChannels parameter passed to vImageMultidimensionalTable_Create.

tempBuffer

An optional pointer to a region of memory that vImage can use as a scratch space for storing temporary data.

table

A valid table created by vImageMultidimensionalTable_Create.

method

The interpolation method, either kvImageFullInterpolation or kvImageHalfInterpolation.

flags

The options to use when performing the transformation. This function supports the following flags:

kvImageNoFlags

Default operation.

kvImageDoNotTile

Turns off internal multithreading.

kvImageGetTempBufferSize

Returns the size of the temp buffer. Use this flag to calculate the minimum size of tempBuffer.

Return Value

kvImageNoError; otherwise, one of the error codes described in Data Types and Constants.

Discussion

This function uses the input color channel values (treated as an N-dimensional coordinate) to index an N-dimensional lookup table to find a new color value, possibly in a new color space. The number of color channels in the destination image doesn’t need to match the number of color channels in the source image.

See Also

Transforming with a Multidimensional Lookup Table

vImage_MultidimensionalTable

A structure representing a multidimensional table for use with vImage's multidimensional interpolated lookup functions.

vImageMultidimensionalTable_Create

Creates a multidimensional table for use with vImage's multidimensional interpolated lookup functions.

vImageMDTableUsageHint

Constants that indicate how a multidimensional table will be used.

vImageMultiDimensionalInterpolatedLookupTable_PlanarF

Uses a multidimensional lookup table to transform an image in PlanarF format.

vImage_InterpolationMethod

Constants that represent different interpolation methods.

vImageMultidimensionalTable_Retain

Retains a multidimensional table.

vImageMultidimensionalTable_Release

Releases a multidimensional table.