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

概要

polyInstallAction( name , [commandName=boolean], [convertSelection=boolean], [installConstraint=boolean], [installDisplay=boolean], [keepInstances=boolean], [uninstallConstraint=boolean], [uninstallDisplay=boolean])

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

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

ユーザが指定した動作を実行するために次のインストール/アンインストールを行います。

戻り値

string[]コンストレイントをインストールする場合、インストールされたコマンドの作用対象となる項目を文字配列として返します。インストールしない場合、何も返されません。

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

関連

polyListComponentConversion, polySelectConstraint, polySelectConstraintMonitor

フラグ

commandName, convertSelection, installConstraint, installDisplay, keepInstances, uninstallConstraint, uninstallDisplay
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
convertSelection(cs) boolean create
オブジェクト モードで選択したすべてのポリゴンを完全に一致するコンポーネント選択に変換します。例: ポリゴン メッシュが選択されている場合、
polyInstallAction -cs polyCloseBorder
は境界エッジをすべて選択します。
commandName(cn) boolean query
以前インストールしたコマンドの名前を文字列で返します。
installConstraint(ic) boolean createquery

C: actionname に対する選択項目の pickmask と内部コンストレイントをインストールします。
Q:現在のアクションで内部コンストレイントが設定されている場合は 1 が返されます。
installDisplay(id) boolean createquery

C: actionname に対するディスプレイ アトリビュートをインストールします。
Q:現在のアクションで内部コンストレイントが設定されている場合は 1 が返されます。
uninstallConstraint(uc) boolean create
以前インストールした内部コンストレイントをアンインストールします。
uninstallDisplay(ud) boolean create
以前インストールした display アトリビュートをアンインストールします。
keepInstances(ki) boolean create
最初に選択したインスタンスのみではなく、選択したすべてのインスタンスのコンポーネントを変換します。

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

Python 例

import maya.cmds as cmds

# Will set pickmask to edges, install internal constraint
# so that only border edges may be selected.
cmds.polyInstallAction( 'polyCloseBorder', ic=True )
# Same as previous, plus force the display of borders if the
# user didn't asked explicitely for it before.
cmds.polyInstallAction( 'polyCloseBorder', ic=True, id=True )
# Shortcut for polyInstallAction -ic -id polyCloseBorder;
cmds.polyInstallAction( 'polyCloseBorder' )
# Assuming the previous install was for closeBorder,
# will release internal border constraint, but go on displaying
# borders if the user didn't asked explicitely for it before.
cmds.polyInstallAction( uc=True )
# Assuming the previous install was for closeBorder,
# will release internal border constraint, stop displaying
# borders if the user didn't asked explicitely for it before.
cmds.polyInstallAction( uc=True, ud=True )
# Shortcut for polyInstallAction -uc -ud;
cmds.polyInstallAction()