Function Name: CMY to CMYK

Definition

This function converts a CMY color value to a CMYK 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.

The algorithm that will be applied is:

     Black  = Minimum of (incoming Cyan,
                          incoming Magenta,
                          incoming Yellow)

     Cyan    = incoming Cyan    - Black
     Magenta = incoming Magenta - Black
     Yellow  = incoming Yellow  - 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 CMY color

new_color_ptr

 a pointer to where the converted CMYK color will be stored