delete

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

概要

delete( objects , [all=boolean], [attribute=string], [channels=boolean], [constraints=boolean], [constructionHistory=boolean], [controlPoints=boolean], [expressions=boolean], [hierarchy=string], [inputConnectionsAndNodes=boolean], [shape=boolean], [staticChannels=boolean], [timeAnimationCurves=boolean], [unitlessAnimationCurves=boolean])

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

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

指定した項目以外が削除されることもあります。たとえば、NURBS サーフェス上で同じ「行」 の 2 つの CV を削除すると、行全体が削除されます。

戻り値

なし

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
attribute(at)	string
選択するアトリビュートのリストです。 このフラグは照会モードでは値が必要になります。
hierarchy(hi)	string
階層展開オプションです。有効な値は、「above」、「below」、「both」、「none」です。（「pasteKey」コマンドでは無効）。 このフラグは照会モードでは値が必要になります。
shape(s)	boolean
トランスフォームの下にあるシェイプのアトリビュート（「controlPoints」以外）も考慮します。デフォルト: true（「pasteKey」コマンドでは無効）。 このフラグは照会モードでは値が必要になります。
controlPoints(cp)	boolean
このフラグは、アトリビュートのリストにシェイプの制御点を含めるかどうかを明示的に指定します（「-s」フラグを参照）。 デフォルト: false（「pasteKey」コマンドでは無効）。 このフラグは照会モードでは値が必要になります。
all(all)	boolean
シーンに含まれる指定した種類のすべてのオブジェクトを削除します。このフラグは、以下のフラグと一緒に使用します。
inputConnectionsAndNodes(icn)	boolean
指定したアトリビュートの入力コネクションが解除され、残された未接続ノードがすべて削除されます。グラフは、削除できないノードが出現するまで調べられます。
constructionHistory(ch)	boolean
指定または選択したオブジェクトのコンストラクション ヒストリが削除されます。
staticChannels(sc)	boolean
シーン内のスタティックなアニメーション チャンネルが削除されます。すべてのスタティックなチャンネルを削除できますが、上のオプションを指定して削除対象のチャンネルを絞り込むこともできます。
channels(c)	boolean
シーン内のアニメーション チャンネルが削除されます。すべてのチャンネルを削除できますが、上のオプションを指定して削除対象のチャンネルを絞り込むこともできます。
unitlessAnimationCurves(uac)	boolean
-c/channels と -sc/staticChannels フラグを変更します。 true の場合、単位なし入力アニメーション カーブ（「setDrivenKeyframe」で作成されたものなど）に接続されたチャンネルのみが削除されます。false の場合、単位なし入力アニメーション カーブは削除されません。デフォルト: true。
timeAnimationCurves(tac)	boolean
-c/channels と -sc/staticChannels フラグを変更します。 true の場合、時間入力アニメーション カーブ（「setKeyframe」で作成されたものなど）に接続されたチャンネルのみが削除されます。false の場合、時間入力アニメーション カーブは削除されません。 デフォルト: true。
expressions(e)	boolean
シーン内のエクスプレッションが削除されます。すべてのエクスプレッションを削除できますが、上のオプションを指定して削除対象のエクスプレッションを絞り込むこともできます。
constraints(cn)	boolean
選択したコンストレインと選択したノードにアタッチされたコンストレイン、またはシーン内のすべてのコンストレインが削除されます。

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

Python 例

import maya.cmds as cmds

# To delete selected objects use:
cmds.delete()

# To delete a few specific objects like surfaceShape1, surface1 and
# paramCurve1 use:
cmds.delete( 'surfaceShape1', 'surface1', 'paramCurve1' )

# To delete all channels in the scene:
cmds.delete( all=True, c=True )

# To delete static channels connected to selected nodes:
cmds.delete( sc=True )

# To delete motion path nodes connected to selected nodes:
cmds.delete( mp=True )

# To delete all expressions in the scene:
cmds.delete( all=True, e=True )

# To delete selected constraints and constraints attached to selected nodes:
cmds.delete( cn=True )

# Notes:

# The at, h, s and cp flags only apply when either c/channels
# or sc/staticChannels or e/expressions options are specified.