partition

ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.

概要

partition( [string] [string...] , [addSet=name], [name=string], [removeSet=name], [render=boolean])

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

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

フラグを指定しないと、既定名のパーティションが作成されます。コマンドの引数であるセットは、パーティションに追加されます。

セットは、そのメンバーがパーティション内の別のセット内に存在しない場合に限ってパーティションに追加されます。パーティションを作成する場合に -re/render フラグを指定すると、「レンダリング可能」セットのみがパーティションに追加されます。

-addSet フラグか -removeSet フラグを使用すると、パーティションのセットの追加と除去ができます。

注: セットが選択されている状態でパーティション コマンドを実行すると、作成されるパーティションにセットが追加されます。

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
addSet(add)	name
指定したパーティションにセットのリストを追加します。
name(n)	string
指定した名前を新しいパーティションに割り当てます。作成モードでのみ有効です。
removeSet(rm)	name
指定したパーティションからセットのリストを除去します。
render(re)	boolean
新しいパーティションにレンダー セットを含めることができます。作成モードのみで使用してください。既定は false です。照会フラグとともに使用することもできます。この場合はブーリアンを返します。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# To create a partition calls p1 which contains set1 and set2 ...
cmds.partition( 'set1', 'set2', n='p1' )

# To create an empty render partition ...
cmds.partition( render=True )

# To add/remove sets from partition p1 ...
cmds.partition( 'set3', add='p1' )
cmds.partition( 'set1', rm='p1' )

# To get a list of all sets in a partition ...
cmds.partition( 'p1', q=True )

# To check if the partition is a render partition
cmds.partition( 'p1', q=True, re=True )