pymel.core.general.colorManagementPrefs¶

colorManagementPrefs(*args, **kwargs)¶

This command allows querying and editing the color management global data in a scene. It also allows for setting the view transform and rendering space which automatically configures the color processing in the enabled views. In query mode, return type is based on queried flag.

Flags:

Long Name / Short Name		Argument Types	Properties
cmConfigFileEnabled / cfe		bool
	Turn on or off applying an OCIO configuration file. If set, the color management configuration set in the preferences is used.
cmEnabled / cme		bool
	Turn on or off color management in general. If set, the color management configuration set in the preferences is used.
colorManagePots / cmp		bool
	Turn on or off color management of color pots in the UI. If set, colors in color pots are taken to be in rendering space, and are displayed after being transformed by the view transform set in the preferences.
colorManagedNodes / cmn		bool
	Gets the names of all nodes that apply color management to bring pixels from an input color space to the rendering space. Examples include file texture node.
colorManagementSDKVersion / cmv		unicode
	Obtain the version of the color management SDK used by Maya.
configFilePath / cfp		unicode
	The configuration file to be used, if color management is enabled.
defaultInputSpaceName / din		unicode
	This flag is obsolete. See the colorManagementFileRules command for more information.
equalsToPolicyFile / etp		unicode
	Query if the current loaded policy settings is the same with the settings described in the policy file which is the argument of the command.
exportPolicy / epy		unicode
	Export the color management parameters to policy file
inputSpaceNames / iss		bool
	Returns the list of available input color spaces. Used to populate the input color spaces UI popup.
loadPolicy / lpy		unicode
	Load the color management policy file. This file overides the color management settings.
loadedDefaultInputSpaceName / ldn		unicode
	This flag is obsolete.
loadedOutputTransformName / lon		unicode
	Gets the loaded output transform. Used by file open, import, and reference to check for missing color spaces or transforms.
loadedRenderingSpaceName / lrn		unicode
	Gets the loaded rendering space. Used by file open, import, and reference to check for missing color spaces or transforms.
loadedViewTransformName / lvn		unicode
	Gets the loaded view transform. Used by file open, import, and reference to check for missing color spaces or transforms.
missingColorSpaceNodes / mcn		bool
	Gets the names of the nodes that have color spaces not defined in the selected transform collection.
ocioRulesEnabled / ore		bool
	Turn on or off the use of colorspace assignment rules from the OCIO library.
outputTarget / ott		unicode
	Indicates to which output the outputTransformEnabled or the outputTransformName flags are to be applied. Valid values are rendereror playblast.
outputTransformEnabled / ote		bool
	Turn on or off applying the output transform for out of viewport renders. If set, the output transform set in the preferences is used.
outputTransformName / otn		unicode
	The output transform to be applied for out of viewport renders. Disables output use view transform mode.
outputTransformNames / ots		bool
	Returns the list of available output transforms.
outputTransformUseColorConversion / otc		bool
	Turn on or off selecting the color space conversion for the output color space of viewport renders. If set, a conversion color space is used; otherwise, a view transform is used.
outputUseViewTransform / ovt		bool
	Turns use view transform mode on. In this mode, the output transform is set to match the view transform. To turn the mode off, set an output transform using the outputTransformName flag.
policyFileName / pfn		unicode
	Set the policy file name
popupOnError / poe		bool
	Turn on or off displaying a modal popup on error (as well as the normal script editor reporting of the error), for this invocation of the command. Default is off.
refresh / rfr		bool
	Refresh the color management.
renderingSpaceName / rsn		unicode
	The color space to be used during rendering. This is the source color space to the viewing transform, for color managed viewers and color managed UI controls, and the destination color space for color managed input pixels.
renderingSpaceNames / rss		bool
	Returns the list of available rendering spaces. Used to populate the color management preference UI popup.
restoreDefaults / rde		bool
	Restore the color management settings to their default value.
viewTransformName / vtn		unicode
	The view transform to be applied by color managed viewers and color managed UI controls.
viewTransformNames / vts		bool
	Returns the list of available view transforms. Used to populate the color management preference UI popup. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.colorManagementPrefs

Example:

::

import pymel.core as pm

ws = pm.colorManagementPrefs(q=True, renderingSpaceName=True) pm.colorManagementPrefs(e=True, viewTransformName=”Log”)

renderingSpaces = cmd.colorManagementPrefs(q=True, renderingSpaceNames=True) viewingTransforms = cmd.colorManagementPrefs(q=True, viewTransformNames=True)

pm.colorManagementPrefs(e=True, configFilePath=”/project/local_config.ocio”)