Function

vImageConvert_Planar8toPlanarF

Converts a Planar8 image to a PlanarF image.

Declaration

vImage_Error vImageConvert_Planar8toPlanarF(const vImage_Buffer *src, const vImage_Buffer *dest, Pixel_F maxFloat, Pixel_F minFloat, vImage_Flags flags);

Parameters

src

A pointer to a vImage buffer structure that contains the source image whose data you want to convert.

dest

A pointer to a vImage buffer data structure. You're responsible for filling out the height, width, and rowBytes fields of this structure, and for allocating a data buffer of the appropriate size. On return, the data buffer this structure points to contains the destination image data. When you no longer need the data buffer, you must deallocate the memory.

maxFloat

The maximum pixel value for the destination image.

minFloat

The minimum pixel value for the destination image.

flags

The options to use when performing the operation. If you plan to perform your own tiling or use multithreading, pass kvImageDoNotTile.

Return Value

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

Discussion

This function transforms a Planar8 image to a PlanarF image, using a minFloat value and a maxFloat value to specify the range of values for the PlanarF image. The function maps each source pixel value(which can be in the range of 0 to 255 inclusive) linearly into the range minFloat to maxFloat, using the following mapping (where i is the old pixel value):

new pixel value = i* (maxFloat - minFloat)/255.0f + minFloat

The two buffers must have the same number of rows and the same number of columns.

See Also

Converting Between Planar Formats

vImageConvert_PlanarFtoPlanar8_dithered

Converts a PlanarF image to a Planar8 image with dithering.

vImageConvert_PlanarFtoPlanar16F

Converts a PlanarF image to a Planar16F image.

vImageConvert_PlanarFtoPlanar8

Converts a PlanarF image to a Planar8 image, clipping values to the provided minimum and maximum values.

vImageConvert_Planar1toPlanar8

Converts a Planar1 image to a Planar8 image.

vImageConvert_Planar2toPlanar8

Converts a Planar2 image to a Planar8 image.

vImageConvert_Planar4toPlanar8

Converts a Planar4 image to a Planar8 image.

vImageConvert_Planar8toPlanar16F

Converts a Planar8 image to a Planar16F image.

vImageConvert_Planar8toPlanar1

Converts a Planar8 image to a Planar1 image.

vImageConvert_Planar8toPlanar2

Converts a Planar8 image to a Planar2 image.

vImageConvert_Planar8toPlanar4

Converts a Planar8 image to a Planar4 image.

vImageConvert_Planar16FtoPlanar8

Converts a Planar16F image to a Planar8 image.

vImageConvert_Planar16FtoPlanarF

Separates an ARGB8888 image into four Planar8 images.

vImageConvert_Planar16UtoPlanar8_dithered

Converts a Planar16U image to a Planar8 image with dithering.

vImageConvert_Indexed1toPlanar8

Converts an indexed 1-bit image to a Planar8 image.

vImageConvert_Indexed2toPlanar8

Converts an indexed 2-bit image to a Planar8 image.

vImageConvert_Indexed4toPlanar8

Converts an indexed 4-bit image to a Planar8 image.