Function

vImageEqualization_Planar8

Equalizes the histogram of an ARGB8888 source image.

Declaration

vImage_Error vImageEqualization_Planar8(const vImage_Buffer *src, const vImage_Buffer *dest, vImage_Flags flags);

Parameters

src

A pointer to a vImage buffer structure that contains the source image.

dest

A pointer to a vImage buffer data structure. You are 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 pointed to by this structure contains the destination image data. When you no longer need the data buffer, you must deallocate the memory.

flags

The options to use. Set the kvImageDoNotTile flag if you plan to perform your own tiling or use multithreading.

Set the kvImageLeaveAlphaUnchanged flag to copy the alpha channel to the destination image unchanged.

Return Value

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

Discussion

The equalization operation alters the image histogram so that it is closer to a uniform intensity distribution. The source and destination buffers must have the same height and the same width.

See Also

Equalizing a Histogram

vImageEqualization_ARGBFFFF

Equalizes the histogram of an ARGBFFFF source image.

vImageEqualization_ARGB8888

Equalizes the histogram of an ARGB8888 source image.

vImageEqualization_PlanarF

Equalizes the histogram of a PlanarF source image.