ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
filterExpand([expand=boolean], [fullPath=boolean], [selectionMask=int])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
filterExpand は、取り消し可能、照会不可能、および 編集不可能 です。
選択したコンポーネント(またはコマンドラインで指定したコンポーネント)に基づき、このコマンドはリストで指定したオプションにフィルタをかけたり展開したりします。すべての一致する選択項目を含む文字配列を返します。セレクション マスクには次のものがあります。
オブジェクト タイプ | マスク |
ハンドル | 0 |
Nurbs カーブ | 9 |
Nurbs サーフェス | 10 |
Nurbs カーブオンサーフェス | 11 |
ポリゴン | 12 |
ロケータ XYZ | 22 |
方向ロケータ | 23 |
ロケータ UV | 24 |
Control Vertex (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
ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
selectionMask(sm)
|
int
|
|
|
expand(ex)
|
boolean
|
|
|
これが true の場合、各項目は単一のエンティティになります。既定は true です。
|
|
fullPath(fp)
|
boolean
|
|
|
これが true で選択項目が DAG オブジェクトの場合、フル選択パスを返します。この値が false のときは、オブジェクトの名前だけを返します。既定は false です。
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
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)