移動先: 概要 戻り値 フラグ. Python 例.

概要

removeMultiInstance( attribute , [b=boolean])

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

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

multiElement の特定のインスタンスを削除します。出力アトリビュートは、ノードが次回実行された際に再生成されるので、 入力アトリビュートのみに便利です。このコマンドはインスタンスを削除し、 オプションでそのインスタンスの入出力接続をすべて切断します。-b true フラグを使用して接続を切断しない場合、 接続が存在すると、このコマンドはエラーになります。

戻り値

boolean(インスタンスが削除された場合は true、何らかの問題がある場合は false (アトリビュートがコネクトされているが、-b true が指定されなかった場合など))

フラグ

b
ロング ネーム(ショート ネーム) 引数型 プロパティ
b(b) boolean create
この引数を true にすると、アトリビュートのすべての接続が切断されてから エレメントが削除されます。false にした場合、エレメントが接続されていると、 このコマンドはエラーになります。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

cmds.createNode('choice',n='choice')
cmds.setAttr('choice.input[0]',2.0)
cmds.setAttr('choice.input[4]',4.0)
cmds.connectAttr('choice.input[8]','choice.input[100]')

# This will remove the element with index 4 from the input of
# the choice node as long as there are no incoming or outgoing
# connections to the attribute.
#
cmds.removeMultiInstance( 'choice.input[4]' )

# This will remove the element with index 100 from the input of
# the choice node, breaking any existing connections first.
#
cmds.removeMultiInstance( 'choice.input[100]', b=True )