ジャンプ先: 概要. 戻り値. キーワード. フラグ. Python 例.

概要

colorManagementFileRules([addRule=string], [colorSpace=string], [down=string], [evaluate=string], [extension=string], [listRules=boolean], [load=boolean], [moveUp=string], [pattern=string], [remove=string], [restoreDefaults=boolean], [save=boolean])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

colorManagementFileRules は、取り消し不可能、照会可能、および編集可能です。

この取り消し不可能なアクションは、ファイルからカラー情報を読み取るディペンデンシー グラフ ノードへの初期入力カラー スペースを割り当てる際に Maya が使用するルールのリストを管理します。ルールは一連の責任として構造化されています。優先順位が高いルールから低いルールへと並べられていて、各ルールがパスのパターンおよび拡張子を照合します。指定されたファイル パスと一致するルールがあった場合、ルール評価の結果としてカラー スペースが返され、それ以降のルールは考慮されません。優先順位が最も低いルールは常に一致を返します。ルールの追加、除去、およびリスト内の優先順位の変更を行うことができます。ルールごとにファイル パス パターン、拡張子、およびカラー スペースを変更できます。ルール リストをユーザ プリファレンスに保存し、そこからロードすることができます。

戻り値

なし

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

キーワード

color, management

フラグ

addRule, colorSpace, down, evaluate, extension, listRules, load, moveUp, pattern, remove, restoreDefaults, save
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
addRule(add) string createedit
引数名を含むルールを、優先順位が最高のルールとしてルール リストに追加します。このフラグを使用する場合は、pattern、extension、および colorSpace も使用して、ファイル ルールのパターン、拡張子、およびカラー スペースをそれぞれ指定する必要があります。
colorSpace(cs) string createqueryedit
ルールの入力カラース ペースです。ルールがファイル パスと一致した場合は、このカラー スペースが返されます。このカラー スペースは入力カラー スペース リスト内の既存のカラー スペースと一致する必要があります。
down(dwn) string createedit
引数名を含むルールの優先順位を 1 つ下げます。
evaluate(ev) string createedit
ルールのリストを評価し、引数のファイル パスに対応する入力カラー スペースの名前を返します。
extension(ext) string createqueryedit
ルールのファイル拡張子には大文字と小文字の区別があります
listRules(lsr) boolean createedit
ルール名の文字列を順番に並べた配列を返します。優先度が最低のルール(ルール 0)が最初で、優先度が最高のルールが配列内の最後になります。
load(ld) boolean createedit
Maya プリファレンスからルールを読み取ります。既存のルールがクリアされます。
moveUp(up) string createedit
引数名を含むルールの優先順位を 1 つ上げます。
pattern(pat) string createqueryedit
ルールのファイル パス パターンです。これは、glob パターンとして表される、ファイル パス内の一致するサブストリングです。たとえば、「*」はすべてのファイルと一致します。glob パターン構文の詳細については、http://en.wikipedia.org/wiki/Glob_%28programming%29 を参照してください。
remove(rm) string createedit
ルールのリストから引数名を含むルールを除去します。
restoreDefaults(rde) boolean createedit
ルールのリストを既定の設定にのみ復元します。
save(sav) boolean createedit
Maya プリファレンスにルールを保存します。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds


import maya.cmds as cmds

cmds.colorManagementFileRules(add='ruleName', pattern='filePattern', extension='extension', colorSpace='colorSpace')
cmds.colorManagementFileRules(remove='ruleName')
cmds.colorManagementFileRules(up='ruleName')
cmds.colorManagementFileRules(down='ruleName')

cmds.colorManagementFileRules('ruleName', edit=True, pattern='filePattern')
cmds.colorManagementFileRules('ruleName', edit=True, extension='extension')
cmds.colorManagementFileRules('ruleName', edit=True, colorSpace='colorSpace')
cmds.colorManagementFileRules('ruleName', query=True, pattern=True)
cmds.colorManagementFileRules('ruleName', query=True, extension=True)
cmds.colorManagementFileRules('ruleName', query=True, colorSpace=True)

cmds.colorManagementFileRules(save=True)
cmds.colorManagementFileRules(load=True)

# Return array of rule name strings.
cmds.colorManagementFileRules(listRules=True)

# Return input space corresponding to file path.
cmds.colorManagementFileRules(evaluate=filePath)