Function

vImageConvert_16UToF

Converts an image in a special planar format—in which each pixel value is a 16-bit unsigned integer—image to a PlanarF format.

Declaration

vImage_Error vImageConvert_16UToF(const vImage_Buffer *src, const vImage_Buffer *dest, float offset, float scale, vImage_Flags flags);

Parameters

src

A pointer to a vImage buffer structure that contains the source image (for which each pixel value is a 16-bit unsigned integer) whose data you want to overwrite.

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.

offset

The offset value to add to each pixel.

scale

The value to multiply each pixel by.

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

Each pixel value is changed to a floating-point value, then scaled and offset by the provided values. The calculation is:

float result = (float) srcPixel * scale + offset

See Also

Converting from 16-Bit Format

vImageConvert_16Fto16U

Converts a 16F format image to a 16U format image.

vImageConvert_16Fto16Q12

Converts a 16F format image to a 16Q12 format image.

vImageConvert_16SToF

Converts an image in a special planar format—in which each pixel value is a 16-bit signed integer—image to a PlanarF format.

vImageConvert_16UToPlanar8

Converts an image in a special planar format—in which each pixel value is a 16-bit unsigned integer—image to a Planar8 image.

vImageConvert_16Uto16Q12

Converts a 16U format image to a 16Q12 format image.

vImageConvert_16UTo12U

Converts a 16U format image to a 12U format image.

vImageConvert_16Uto16F

Converts a 16U format image to a 16F format image.

vImageConvert_16Q12toF

Converts a 16Q12 format image to a floating-point format image.

vImageConvert_16Q12to8

Converts a 16Q12 format image to an 8-bit format image.

vImageConvert_16Q12to16F

Converts a 16Q12 format image to a 16F format image.

vImageConvert_16Q12to16U

Converts a 16Q12 format image to a 16U format image.