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

概要

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

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

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

パーティションのセットの作成、照会、追加、除去に使用します。パーティション名を指定する必要がある場合は 1 番目の引数に指定します。その他の引数はセット名を表します。フラグを指定しないと、既定名のパーティションが作成されます。コマンドの引数であるセットは、パーティションに追加されます。セットは、そのメンバーがパーティション内の別のセット内に存在しない場合に限ってパーティションに追加されます。パーティションを作成する場合に -re/render フラグを指定すると、「レンダリング可能」セットのみがパーティションに追加されます。-addSet フラグか -removeSet フラグを使用すると、パーティションのセットの追加と除去ができます。注: セットが選択されている状態でパーティション コマンドを実行すると、作成されるパーティションにセットが追加されます。

戻り値

string作成または編集されたパーティションの名前

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

関連

character, sets

フラグ

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

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

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 )