This non-undoable action manages the list of rules that Maya uses to assign an initial input color space to dependency graph nodes that read in color information from a file. Rules are structured in a chain of responsibility, from highest priority rule to lowest priority rule, each rule matching a file path pattern and extension. If a rule matches a given file path, its color space is returned as the result of rules evaluation, and no further rule is considered. The lowest priority rule will always return a match. Rules can be added, removed, and changed in priority in the list. Each rule can have its file path pattern, extension, and color space changed. The rule list can be saved to user preferences, and loaded from user preferences. In query mode, return type is based on queried flag.
Flags:
Long Name / Short Name | Argument Types | Properties | |
---|---|---|---|
addRule / add | unicode | ![]() ![]() |
|
Add a rule with the argument name to the list of rules, as the highest-priority rule. If this flag is used, the pattern, extension, and colorSpace flags must be used as well, to specify the file rule pattern, extension, and color space, respectively. |
|||
colorSpace / cs | unicode | ![]() ![]() ![]() |
|
The input color space for the rule. If the rule matches a file path, this is the color space that is returned. This color space must match an existing color space in the input color space list. |
|||
down / dwn | unicode | ![]() ![]() |
|
|
|||
evaluate / ev | unicode | ![]() ![]() |
|
Evaluates the list of rules and returns the input color space name that corresponds to the argument file path. Flag can have multiple arguments, passed either as a tuple or a list. |
|||
extension / ext | unicode | ![]() ![]() ![]() |
|
The file extension for the rule, expressed as a glob pattern: for example, ‘*’ matches all extensions. For more information about glob pattern syntax, see http://en.wikipedia.org/wiki/Glob_%28programming%29. |
|||
listRules / lsr | bool | ![]() ![]() |
|
|
|||
load / ld | bool | ![]() ![]() |
|
|
|||
moveUp / up | unicode | ![]() ![]() |
|
|
|||
pattern / pat | unicode | ![]() ![]() ![]() |
|
The file path pattern for the rule. This is the substring to match in the file path, expressed as a glob pattern: for example, ‘*’ matches all files. For more information about glob pattern syntax, see http://en.wikipedia.org/wiki/Glob_%28programming%29. |
|||
remove / rm | unicode | ![]() ![]() |
|
|
|||
save / sav | bool | ![]() ![]() |
|
|
Derived from mel command maya.cmds.colorManagementFileRules