polyColorSet

移動先: 概要 戻り値 キーワード. フラグ. MEL 例.

概要

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

polyColorSet は 「元に戻す」が可能、「照会」が可能、「編集」が可能 です。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

キーワード

フラグ

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

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

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;