Function

vImageConvert_Planar8ToARGBFFFF

Combines four Planar8 images into one ARGBFFFF image.

Declaration

vImage_Error vImageConvert_Planar8ToARGBFFFF(const vImage_Buffer *alpha, const vImage_Buffer *red, const vImage_Buffer *green, const vImage_Buffer *blue, const vImage_Buffer *dest, const Pixel_FFFF maxFloat, const Pixel_FFFF minFloat, vImage_Flags flags);

Parameters

alpha

A pointer to a vImage buffer structure that contains the Planar8 image to use as the alpha channel of the destination image.

red

A pointer to a vImage buffer structure that contains the Planar8 image to use as the red channel of the destination image.

green

A pointer to a vImage buffer structure that contains the Planar8 image to use as the green channel of the destination image.

blue

A pointer to a vImage buffer structure that contains the Planar8 image to use as the blue channel of the destination image.

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

A group of maximum pixel values, one per channel, in the same order as in the output pixels. The function clips larger values to these values in the destination image.

minFloat

A group of minimum pixel values, one per channel, in the same order as in the output pixels. The function clips smaller values to these values in 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 routine cannot be used in place.

If the maxFloat value for a channel is less than the minFloat value, the output range for that channel is inverted.

To use a constant value for a single channel, set the maximum and minimum values for that channel to be the same value. When you do this, you must still provide a valid vImage_Buffer pointer for that channel, but the values in that buffer are unimportant.

See Also

Converting from Planar Formats

vImageConvert_Planar8toARGB1555

Combines four Planar8 images into one ARGB1555 image.

vImageConvert_Planar8toARGB8888

Combines four Planar8 images into one ARGB8888 image.

vImageConvert_Planar8ToBGRX8888

Interleaves three Planar8 images into one BGRX8888 image.

vImageConvert_Planar8ToBGRXFFFF

Combines three Planar8 images into one BGRXFFFF image.

vImageConvert_Planar8toRGB565

Combines three Planar8 images into one RGB565 image.

vImageConvert_Planar8toRGB888

Combines three Planar8 images into one RGB888 image.

vImageConvert_Planar8ToXRGBFFFF

Combines three Planar8 images into one XRGBFFFF image.

vImageConvert_Planar8ToXRGB8888

Interleaves three Planar8 images into one XRGB8888 image.

vImageConvert_Planar8To16U

Converts a Planar8 image to a 16U image .

vImageConvert_Planar8ToRGBXFFFF

Combines three Planar8 images into one RGBXFFFF image.

vImageConvert_Planar8ToRGBX8888

Interleaves three Planar8 images into one RGBX8888 image.

vImageConvert_Planar8toIndexed1

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

vImageConvert_Planar8toIndexed2

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

vImageConvert_Planar8toIndexed4

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

vImageConvert_Planar16Q12toARGB16F

Combines three 16Q12 images into one ARGB16F image.

vImageConvert_Planar16UtoARGB16U

Combines four 16U images into one ARGB16U image.

vImageConvert_Planar16Q12toRGB888

Combines three 16Q12 images into one RGB888 image.

vImageConvert_Planar16Q12toARGB8888

Combines three 16Q12 images into one ARGB8888 image.

vImageConvert_Planar16Q12toRGB16F

Combines three 16Q12 images into one RGB16F image.

vImageConvert_Planar16UtoRGB16U

Combines three 16U images into one RGB16U image.

vImageConvert_FTo16S

Converts a PlanarF image into a special format in which each pixel is a 16-bit signed integer.

vImageConvert_FTo16U

Converts a PlanarF image into a special format in which each pixel is a 16-bit unsigned integer.

vImageConvert_PlanarFtoARGBFFFF

Combines four PlanarF images into one ARGBFFFF image.

vImageConvert_PlanarFToARGB8888

Converts four PlanarF images into one ARGB8888 image.

vImageConvert_PlanarFtoRGBFFF

Combines three PlanarF images into one RGBFFF image.

vImageConvert_PlanarFToBGRX8888

Converts three PlanarF images into one BGRX8888 image.

vImageConvert_PlanarFToBGRXFFFF

Converts three PlanarF images into one BGRXFFFF image.

vImageConvert_PlanarFToXRGBFFFF

Converts three PlanarF images into one XRGBFFFF image.

vImageConvert_PlanarFToXRGB8888

Converts three PlanarF images into one XRGB8888 image.

vImageConvert_PlanarFToRGBXFFFF

Converts three PlanarF images into one RGBXFFFF image.

vImageConvert_PlanarFToRGBX8888

Converts three PlanarF images into one RGBX8888 image.