dmColorPrecompute(3dm)                                  dmColorPrecompute(3dm)


NAME
     dmColorPrecompute - performs any precomputation required.

SYNOPSIS
     #include <dmedia/dm_color.h>

     DMstatus dmColorPrecompute (const DMcolorconverter converter);

PARAMETERS
     DMcolorconverter converter
          The converter upon which the action is to be applied.

RETURNED VALUE
     DM_COLOR_ERROR_NONE               if operation is successful.
     DM_COLOR_ERROR_INVALID_CONVERTER  if the converter is invalid.

DESCRIPTION
     Before dmColorConvert can convert an image, some precomputation is
     required.  This computation will be performed during the first
     dmColorConvert call, or any subsequent dmColorConvert call after a
     dmColorSet call has changed the desired transform.  If this
     precomputation overhead would be more suited to occur elsewhere in the
     program (such as outside the main loop), dmColorPrecompute should be
     called.

SEE ALSO
     dmColorCreate(3dm) dmColorDestroy(3dm) dmColorConvert(3dm)


                                                                        Page 1