imaqChangeColorSpace

NI Vision for LabWindows/CVI Function

imaqChangeColorSpace

Usage

Color imaqChangeColorSpace(const Color* sourceColor, ColorMode sourceSpace, ColorMode destSpace);

Purpose

Maps the value of a color in one color space into the value of the same color in another color space.

Note   This function does not support the CIE L*a*b* or CIE XYZ color modes.
Note   This function is obsolete. The replacement function is imaqChangeColorSpace2().

Parameters

Name

Type

Description

sourceColor const Color* The color in the source space. This parameter is required and cannot be NULL.
sourceSpace ColorMode The source color space.
destSpace ColorMode The destination color space.

Return Value

Type

Description

Color On success, this function returns the value of the color in the destination color space. On failure, this function returns black. To get extended error information, call imaqGetLastError().