hou.SceneViewer.selectGeometryをコールすると、ユーザがビューポート内で選択を実行するのを待ち、 その選択されたコンポーネントを意味するこのタイプのオブジェクトを返します。 その返された選択は、それを特定のコンポーネントタイプに変換することで操作したり、選択を広げたり、選択を縮小させたりすることができます。 また、その選択はSOPノードのgroupパラメータで使用することができる文字列に変換することができます。
その選択に2つ以上のSOPのコンポーネントが含まれていれば、hou.GeometrySelection.mergedNode関数を使用することで、 その参照されているジオメトリすべてを1個のノードにまとめるためのMerge SOPやObject Merge SOPを作成することができます。
メソッド ¶
boundingBox() -> BoundingBox
選択した領域の境界ボックスを返します。
connectivity() -> hou.connectivityType enum value
このジオメトリ選択に設定されたhou.connectivityTypeを返します。 hou.GeometrySelection.setConnectivityをコールしない限りは、 この関数は、接続性なしの値を返します。
geometryType() -> hou.geometryType enum value
選択したコンポーネントのタイプを返します。
mergedNode(parent, creator_name, force_keep_original_objects=False, display_original_objects=False) -> Node
選択で参照されているSOPすべてを結合するMerge SOPを作成します。 ほとんどの選択は、Merge SOPを必要としない場合には1個のSOPだけを参照し、その選択されているSOPが返されます。
mergedSelectionString(empty_string_selects_all=True, force_numeric=False) -> string
hou.GeometrySelection.mergedNodeで返される結合されたノードのgroupパラメータで使用することができる単一文字列を返します。 1個のノードからすべてのコンポーネントが選択されていれば、これはhou.GeometrySelection.selectionStringsで返されるタプルの最初文字列と等価です。
shrinkSelection(checkuv = true)
選択の境界上にあるコンポーネントを除去します。
growSelection()
現在選択されているコンポーネントに繋がっているコンポーネントすべてを追加することで、選択を拡張します。
needsMergedNode(parent) -> bool
選択内のすべてのコンポーネントにアクセスするためにMerge SOPを作成する必要があれば、Trueを返します。
nodes() -> tuple of Nodes
選択で参照されているノードすべてのタプルを返します。
ordered() -> bool
これが順番通りの選択ならばTrueを返します。つまり、ユーザがコンポーネントを選択した順番が維持されます。
順番通りの選択にするには、hou.SceneViewer.geometrySelectionをコールした時に、ordered
パラメータがTrueに設定されている必要があります。
orientedBoundingBox() -> OrientedBoundingBox
選択した領域の指向性境界ボックスを返します。
primitiveTypes() -> tuple of hou.primitiveType enum values
選択に含まれているプリミティブタイプすべてを含んだタプルを返します。
selections() -> tuple of [Hom:hou.Selection]
コンポーネント選択オブジェクトのタプルを返します。これらは、nodes関数が返すノードに相当します。
selectionStrings(empty_string_selects_all=True, bool force_numeric=False) -> tuple of strings
選択で参照されている個々のSOPノード内の選択されたコンポーネントを参照するために使用することができる文字列のタプルを返します。
setConnectivity(connectivity)
選択を修正する時に強制させる接続性のタイプを設定します。 また、その現行選択は、(その指定した接続形式を使用して)繋がったコンポーネントすべてが選択の一部になるように拡張されます。
setGeometryType(type)
選択に含まれたコンポーネントのタイプを変更し、既存選択を新しいコンポーネントタイプに変換します。
setPrimitiveTypes(primitive_types)
選択で許可されるプリミティブタイプのタプルを設定します。許可されていないタイプのプリミティブは選択から除去されます。 これがプリミティブ選択の場合のみ効果があります。