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

概要

binMembership([addToBin=string], [exists=string], [inheritBinsFromNodes=name], [isValidBinName=string], [listBins=boolean], [makeExclusive=string], [notifyChanged=boolean], [removeFromBin=string])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

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

ノードをビンに割り当てるコマンドです。

戻り値

boolean

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

キーワード

binMembership

フラグ

addToBin, exists, inheritBinsFromNodes, isValidBinName, listBins, makeExclusive, notifyChanged, removeFromBin
ロング ネーム（ショート ネーム） 引数型 プロパティ
addToBin(add) string create
ノード リスト内のノードをビンに追加します。
removeFromBin(rm) string create
ノード リスト内のノードをビンから削除します。
exists(ex) string create
ノードがビンに存在するかどうかを照会します。exists フラグは 1 つのノードしか指定できません。
listBins(lb) boolean createquery
ノードのリストが属するビンのリストを照会して返します。ビンがセレクション リスト内のノードのいずれかを含む場合、返されるビン リストに入ります。
makeExclusive(mke) string create
指定したノードが指定したビンに排他的に属するようにします。
inheritBinsFromNodes(ibn) name create
指定したノード リスト内のノードからフラグの引数にあるノードにビンを継承させます。ノード リストはコマンドのオブジェクトとして指定します。
notifyChanged(nfc) boolean create
このフラグを使用して、binMembership が変更されたとこを通知します。
isValidBinName(ivn) string create
指定したビン名が有効かどうかを照会します。有効な場合、true を返します。無効な場合、false を返します。
: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# Add a given node to a bin.
#
cmds.binMembership( 'lambert1', addToBin='wood' )
# Add a selection of nodes to a given bin.
#
newLambertNode = cmds.createNode('lambert')
list = ("lambert1", newLambertNode)
cmds.binMembership( list, addToBin='grass' )
# Check if a node exists in a bin.
#
cmds.binMembership( 'lambert1', exists='wood' )
# Query and return all the nodes which belong to the bin.
#
newLambertNode = cmds.createNode('lambert')
nodeList = ("lambert1", newLambertNode)
cmds.binMembership( nodeList, query=True, listBins=True )
# Make the nodes belong exclusively in bin "wood".
#
newLambertNode = cmds.createNode('lambert')
nodeList = ("lambert1", newLambertNode)
cmds.binMembership( nodeList, makeExclusive='wood' )
# Let the dest node inherit bins from nodes in the src node list.
# The dest node is specified by the "inheritBinsFromNodes" flag's
# argument.
#
cmds.binMembership( 'lambert1', addToBin='wood' )
node = cmds.createNode('lambert')
cmds.binMembership( node, addToBin='grass' )
srcNodeList = ("lambert1", node)
destNode = cmds.createNode('blinn')
cmds.binMembership( srcNodeList, inheritBinsFromNodes=destNode )
# Notify that binMembership has been changed.
#
cmds.binMembership( notifyChanged=True )
# Check if a bin name is valid or not.  If valid, return true.
# Otherwise, return false.
#
cmds.binMembership( isValidBinName='wood' )