3ds Max C++ API Reference
|
3ds Max can work in three different color management modes:
OpenColorIO: There are two OCIO modes (ColorPipelineMode::kOCIO_DEFAULT and ColorPipelineMode::kOCIO_CUSTOM) which are the most powerful color management modes 3ds Max provides. In these modes the user can use textures and colors from different color spaces, can pick any linear color space (such as ACEScg) to perform renderings in, can work on monitors with different color gamuts and can save images in various color spaces with different view transforms applied. This mode uses OpenColorIO as the color management engine and the available color spaces, displays, transforms etc are defined in OCIO config files.
IColorPipelineMgr is the central hub for controlling and querying the active color management mode, available color spaces, displays, views and and accessing the other settings. IModeSettings class provides access to detailed settings of each mode. (see IColorPipelineMgr::Settings() )
If you need to convert colors from one color space to another, you'll need to create objects of class IColorPipeline. You can create IColorPipeline objects using various methods of the IColorPipelineMgr class. Although IColorPipeline defines the operations needed to transform colors, it can not do the computations by itself. The actual conversions are done by the ColorConverter class which is a template class and can perform operations in an optimized way for the specified input and output data types.
Here is an example showing how the classes relate to each other and how to use them in some simple scenarios.
Please See Color Management in the 3ds Max Developer Guide for more information.