移動先: 概要 戻り値 関連項目. フラグ. 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: 現在のアクションで display が設定されている場合は 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()