Function Name: CMYK to CMY

Definition

This function converts a CMYK color value to a CMY color value.

The color model conversion algorithm is based on the algorithm published in section 13.3.2, "The CMY Model" of Computer Graphics: Principles and Practice - Second Edition in C, by James D. Foley, Andries van Dam, Steven K. Feiner, and John F. Hughes, published by Addison-Wesley Publishing Company (Reprinted with corrections November 1992, November 1993, and July 1995), Copyright 1996, 1990 by Addison-Wesley Publishing Company, Inc.

Incoming data values are expected to be between 0.0 and 1.0, inclusive. Furthermore, after adding the incoming Black value to the incoming Cyan, Magenta, and Yellow values, all results are expected to be between 0.0 and 1.0, inclusive. Note that no checking of parameters or results will be made by this function. This function will not clamp a result even if the result is greater than 1.0. This function simply performs the arithmetic of the following algorithm:

     Cyan    = incoming Cyan    + incoming Black
     Magenta = incoming Magenta + incoming Black
     Yellow  = incoming Yellow  + incoming Black

Returns

SE_COLOR_NULL_PTR_OUT_PARAMETER - if new_color_ptr was NULL.

SE_COLOR_INVALID_ORIGINAL_COLOR - if original_color_ptr is NULL. In this case, *new_color_ptr is not modified.

Prototype

Parameters Notes

original_color_ptr

 a pointer to the incoming CMYK color

new_color_ptr

 a pointer to where the converted CMY color will be stored