| Customize Help
| Save Settings

McolPreprocess


Function Map
Syntax
Description
Parameters
- ContextId
- ControlFlag
Compilation information
Synopsis
Preprocess a relative color calibration or color matching context.
Syntax
void McolPreprocess(
MIL_ID ContextId, //in
MIL_INT64 ControlFlag //in
)
Description

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.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.
Parameters
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.
Parameters
ContextId

Specifies the identifier of the context to preprocess. The context must have been previously allocated on the required system using McolAlloc() with M_COLOR_CALIBRATION_RELATIVE or M_COLOR_MATCHING.

ControlFlag

Reserved for future expansion. This parameter must be set to M_DEFAULT.

Compilation information
Header Include mil.h.
Library Use mil.lib; milcolor.lib.
DLL Requires mil.dll; milcolor.dll.