polyColorSet

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

概要

polyColorSet [-allColorSets] [-clamped boolean] [-colorSet string] [-copy] [-create] [-currentColorSet] [-currentPerInstanceSet] [-delete] [-newColorSet string] [-perInstance boolean] [-rename] [-representation string] [-shareInstances] [-unshared]

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

戻り値

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

キーワード

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-allColorSets(-acs)
このフラグを照会に使用すると、すべてのカラー セット名のリストを返します。
-clamped(-cla)	boolean
このフラグは、カラー セットが 0 から 1 の範囲外にあるすべての値を切り捨てるかどうかを指定します。
-colorSet(-cs)	string
このコマンドを実行するカラー セット名を指定します。このコマンドで、現在のカラー セットを照会する以外に重要な操作を実行するには、このフラグを指定する必要があります。
-copy(-cp)
このフラグを使用して、colorSet フラグで指定した名前に対応するカラー セットを、newColorSet フラグで指定した名前に対応するカラー セットにコピーします。
-create(-cr)
このフラグを使用して、colorSet フラグで指定した名前に対応する空のカラー セットを作成します。同じ名前のカラー セットがすでに存在する場合は、カラー セットは新規作成されません。
-currentColorSet(-ccs)
このフラグを使用して、オブジェクトの操作対象である現在のカラー セットを、colorSet フラグで指定した名前に対応するカラー セットに設定します。つまり、指定した名前の colorSet が存在している必要があります。照会すると、現在のカラー セットを返します。
-currentPerInstanceSet(-cpi)
これは照会専用フラグで、現在のカラー セットがインスタンス単位のカラー セット ファミリである場合に使用します。現在選択しているインスタンスに対応するセット ファミリのメンバーを返します。
-delete(-d)
このフラグを使用して、colorSet フラグで指定した名前に対応するカラー セットを削除します。
-newColorSet(-nc)	string
colorSet フラグで指定した名前に対応する、変更する必要があるカラー セットの名前を指定します。
-perInstance(-pi)	boolean
このフラグを create フラグと一緒に使用して、カラー セットがインスタンス単位かどうかを指定します。インスタンス単位のカラー セットを作成すると、unshared フラグを使用した場合を除き、セットはシェイプにあるすべての選択したインスタンスの間で共有されるものとして適用されます。照会モードで perInstance フラグを currentColorSet フラグや allColorSets フラグと一緒に使用することで、設定したファミリ名(インスタンス識別子を含まない)を照会で返すように指定できます。 照会モードでは、このフラグは値を受け入れることができます。
-rename(-rn)
このフラグを使用して、colorSet フラグで指定した名前に対応するカラー セットの名前を、newColorSet フラグで指定した名前に変更します。
-representation(-rpt)	string
このフラグは、A (アルファのみ)、RGBA、RGBA などの使用するカラー チャネルに対応します。
-shareInstances(-si)
このフラグを使用して、指定したカラー セット ファミリに属するインスタンス単位のカラー セットの共有設定を修正し、選択したすべてのインスタンスが指定したセットを共有するようにできます。照会モードでは、colorSet フラグで指定したセットを共有するインスタンスのリストを返します。
-unshared(-us)
このフラグを create フラグと perInstance フラグと一緒に使用して、新規作成されたインスタンス単位のセットとともに、インスタンスごとに別のセットを作成することを指定できます。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

// To set the current color set to be "color2".
polyColorSet -currentColorSet -colorSet "color2";
// To query the current color set.
polyColorSet -q -currentColorSet;
// To create a per-instance color set family with one set member
// per selected instance.
polyColorSet -create -colorSet "perInst" -perInstance true -unshared;
// To create a per-instance color set family with one set member
// for all selected instances.
polyColorSet -create -colorSet "perInst" -perInstance true;
// To rename a currently existing color set from "color3" to "color4".
polyColorSet -rename -colorSet "color3" -newColorSet "color4";
// Rename the current color set (if any) to "color3".
polyColorSet -rename -newColorSet "color3";
// To delete a currently existing color set "color3".
polyColorSet -delete -colorSet "color3";
// To delete the current color set (if any)
polyColorSet -delete;
// Copy values of color set "color1" to "color2"
// Note if the second color set exist it will be overwriten by
// the copy. Leaving the destination color blank and the command
// will generate a new unique name based on the source name.
polyColorSet -copy -colorSet "color1" -newColorSet "color2";
// Copy values of the current color set to "color2"
polyColorSet -copy -newColorSet "color2";
// Make a copy of "color1" to a new color set. The
// name of which is automatically generated and returned.
polyColorSet -copy -colorSet "color1";
// Create a new empty color set
polyColorSet -create -colorSet "newColor";
// Create a new empty color set with a generate new name
// The newly generated name is returned.
polyColorSet -create;
// Create a new empty color set that has the values in the
// range from 0 to 1 and has 3 channels of R, G, and B.
polyColorSet -create -clamped true -representation "RGB" -colorSet "color5";
// To query all of the color sets
polyColorSet -q -allColorSets;
// To query all of the color set names and their representation values
polyColorSet -q -allColorSets -representation;
// To query the clamped value of the current color set
polyColorSet -q -currentColorSet -clamped;