ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
filterExpand([expand=boolean], [fullPath=boolean], [selectionMask=int], [symActive=boolean], [symNegative=boolean], [symPositive=boolean], [symSeam=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
filterExpand は、取り消し可能、照会不可能、および編集不可能です。
選択したコンポーネント(またはコマンドラインで指定したコンポーネント)に基づき、このコマンドはリストで指定したオプションにフィルタをかけたり展開したりします。すべての一致する選択項目を含む文字配列を返します。セレクション マスクには次のものがあります。
| オブジェクト タイプ | マスク |
| ハンドル | 0 |
| Nurbs カーブ | 9 |
| Nurbs サーフェス | 10 |
| Nurbs カーブオンサーフェス | 11 |
| ポリゴン | 12 |
| ロケータ XYZ | 22 |
| 方向ロケータ | 23 |
| ロケータ UV | 24 |
| コントロール頂点(CV) | 28 |
| エディット ポイント | 30 |
| ポリゴン頂点 | 31 |
| ポリゴンエッジ | 32 |
| ポリゴン フェース | 34 |
| ポリゴン UV | 35 |
| サブディビジョン メッシュ ポイント | 36 |
| サブディビジョン メッシュ エッジ | 37 |
| サブディビジョン メッシュ フェース | 38 |
| カーブ パラメータ ポイント | 39 |
| カーブ ノット | 40 |
| サーフェス パラメータ ポイント | 41 |
| サーフェス ノット | 42 |
| サーフェス範囲 | 43 |
| トリム サーフェス エッジ | 44 |
| サーフェス アイソパラム | 45 |
| ラティス ポイント | 46 |
| パーティクル | 47 |
| スケール ピボット | 49 |
| 回転ピボット | 50 |
| セレクション ハンドル | 51 |
| サブディビジョン サーフェス | 68 |
| ポリゴン頂点フェース | 70 |
| NURBS サーフェスのフェース | 72 |
| サブディビジョン メッシュ UV | 73 |
selectType
expand, fullPath, selectionMask, symActive, symNegative, symPositive, symSeam
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
|
expand(ex)
|
boolean
|
|
|
これが true の場合、各項目は単一のエンティティになります。既定は true です。
|
|
fullPath(fp)
|
boolean
|
|
|
これが true で選択項目が DAG オブジェクトの場合、フル選択パスを返します。この値が false のときは、オブジェクトの名前だけを返します。既定は false です。
|
|
selectionMask(sm)
|
int
|
|
|
|
symActive(sma)
|
boolean
|
|
|
シンメトリが有効になっている場合、オブジェクトのアクティブなシンメトリ側にあるコンポーネントのみを返します。このフラグは、シンメトリがアクティブでない場合には影響しません。
|
|
symNegative(smn)
|
boolean
|
|
|
シンメトリが有効になっている場合、現在のシンメトリ プレーンと比較してオブジェクトの負の側にあるコンポーネントのみを返します。このフラグは、シンメトリがアクティブでない場合には影響しません。
|
|
symPositive(smp)
|
boolean
|
|
|
シンメトリが有効になっている場合、現在のシンメトリ プレーンと比較してオブジェクトの正の側にあるコンポーネントのみを返します。このフラグは、シンメトリがアクティブでない場合には影響しません。
|
|
symSeam(sms)
|
boolean
|
|
|
シンメトリが有効になっている場合、現在のシンメトリ プレーンと比較してオブジェクトの両側に均等に位置するコンポーネントのみを返します。このフラグは、シンメトリがアクティブでない場合には影響しません。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# Returns any selected isoparms (mask 45) as individual items
# (because of "ex=True").
cmds.filterExpand( ex=True, sm=45 )
# Returns any selected CVs (mask 28) as compact items. For example,
# if curve.cv[0:3] is selected, then "curve.cv[0:3]" is returned.
# If "ex=True", then four items are returned, one for each CV.
cmds.filterExpand( ex=False, sm=28 )
# Returns any selected CVs (mask 28) and edit points (mask 30).
cmds.filterExpand( sm=(28,30) )
# Returns any selected nurbs curves.
cmds.filterExpand( sm=9 )
# Returns any selected nurbs curves-on-surface.
cmds.filterExpand( sm=11 )
# return the poly faces (mask 34) from the specified arguments
cmds.filterExpand(["pCube1.f[1]","pCube1.f[4]","pCube1.vtx[0:3]"], sm=34)