McolPreprocess

This function prepares the specified relative color calibration or color matching context for an McolTransform() (relative color calibration) or McolMatch() (color matching) operation. Preprocessing calculates the necessary data for each color-sample contained in its respective context and specifies internal settings to optimize future calculations for speed and robustness. For a relative color calibration context, preprocessing also establishes the color mapping between each color-sample and the reference color-sample.

You must preprocess the relative color calibration or color matching context before the first call to McolTransform() or McolMatch(). Changes to the context, its settings, or one of its color-samples often require you to preprocess the context again. To inquire if this is the case, use McolInquire() with M_PREPROCESSED.

When you save the context, preprocessing changes are not saved. Upon restoration (McolRestore()), you must preprocess the context.