nameによってPointアトリビュートを探します。 それに該当するhou.Attribオブジェクトを返します。そのnameのアトリビュートが存在しなかった場合は、Noneが返されます。

ポイントポジションアトリビュートの名前はPで、そのサイズが3つのfloatであることを覚えておいてください。 また、ポイントウェイトアトリビュートの名前はPwで、そのサイズが1つのfloatです。 Pは必ず存在しますが、Pwは存在するとは限りません。

サンプルは、hou.Point.attribValueを参照してください。

nameによってPrimitiveアトリビュートを探します。 それに該当するhou.Attribオブジェクトを返します。そのnameのアトリビュートが存在しなかった場合は、Noneが返されます。

nameによってVertexアトリビュートを探します。 それに該当するhou.Attribオブジェクトを返します。そのnameのアトリビュートが存在しなかった場合は、Noneが返されます。

nameによってGlobal(通称Detail)アトリビュートを探します。 それに該当するhou.Attribオブジェクトを返します。そのnameのアトリビュートが存在しなかった場合は、Noneが返されます。

Pointアトリビュートすべてのタプルを返します。

ポイントポジションアトリビュートの名前はPで、そのサイズが3つのfloatであることを覚えておいてください。 また、ポイントウェイトアトリビュートの名前はPwで、そのサイズが1つのfloatです。 Pは必ず存在しますが、Pwは存在するとは限りません。

Primitiveアトリビュートすべてのタプルを返します。

Vertexアトリビュートすべてのタプルを返します。

Global(通称Detail)アトリビュートすべてのタプルを返します。

新しくPoint,Primitive,Vertex,Global(通称Detail)アトリビュートを作成します。 新しく作成されたアトリビュートを記述したhou.Attribオブジェクトを返します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

この名前のアトリビュートが既に存在した場合は、hou.OperationFailedを引き起こします あなたがC++ Houdini Development Kit (HDK)に詳しいのであれば、Houdiniは同じ名前でタイプが異なるアトリビュートをサポートすることができることを知っていることでしょう。 しかし、ほとんどのSOPは、同じ名前のアトリビュートを区別することができず、同じ名前の複数のアトリビュートは使用するべきではありません。 このため、このメソッドを使用して、そのようなアトリビュートを作成することができません。

transform_as_normalがTrueでデフォルト値が3つのfloatのシーケンスでない場合は、hou.OperationFailedを引き起こします。

# "population"という名前のサイズが1の整数Pointアトリビュートを作成し、
# アトリビュート値が0, 5, 10, 15, 20の5つのポイントを作成します。
# このコードは、Python SOP内から動作しますが、Pythonシェルからは動作しません。
geo = hou.pwd().geometry()
population_attrib = geo.addAttrib(hou.attribType.Point, "population", 0)
for i in range(5):
    point = geo.createPoint()
    point.setPosition((i, 0, 0))
    point.setAttribValue(population_attrib, i * 5)

以下のサンプルでは、既存アトリビュートをコピーする方法を説明しています:

def copyAttrib(attrib, new_name):
    return attrib.geometry().addAttrib(
        attrib.type(), new_name, attrib.defaultValue(), attrib.isTransformedAsNormal())

create_local_variableがTrueの場合、この関数は、以下のコードと同じことを実行します:

def addLocalVariable(geo, attrib_name):
    '''ジオメトリアトリビュートを作成し、それのローカル変数を追加します。'''
    # 変数マッピングは、varmapアトリビュートの文字列テーブルに保存されます。
    # このテーブルは、varmapの現行値と異なります。
    # varmapの現行値は、そのテーブル内のエントリーを参照するだけです。そのため、テーブル内にエントリーが存在するためには
    # 単にvarmapの値を設定すればいいだけです。
    map_value = "%s -> %s" % (attrib_name, attrib_name.upper())
    if geo.findGlobalAttrib("varmap") is None:
        geo.addAttrib(hou.attribType.Global, "varmap", "")
    geo.setGlobalAttribValue("varmap", map_value)

関連項目:

• hou.Prim.setAttribValue

• hou.Point.setAttribValue

• hou.Prim.setAttribValue

• hou.Geometry.setGlobalAttribValue

• hou.Geometry.setArrayAttrib

新しいPoint,Primitive,Vertex,Global(別名Detail)配列アトリビュートを作成します。 これは、新しく作成されたアトリビュートを表現したhou.Attribオブジェクトを返します。 通常では、Python定義のSOPのコードから、このメソッドをコールします。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

この名前のアトリビュートが既に存在していれば、hou.OperationFailedを引き起こします。 あなたがC++ Houdini Development Kit (HDK)に詳しいのであれば、Houdiniがタイプの違う同じ名前のアトリビュートに対応していることを知っていることでしょう。 しかし、ほとんどのSOPは、同じ名前のアトリビュートを区別することができないので、同じ名前の複数アトリビュートは混乱します。 そのため、このメソッドでは、同じ名前のアトリビュートを作成できないようにしています。

特定のアトリビュートのGlobal(通称Detail)アトリビュート値を返します。 アトリビュートは、nameまたはhou.Attribオブジェクトで指定することができます。

この名前のアトリビュートが存在しなかった場合は、hou.OperationFailedを引き起こします。

特定の浮動小数点アトリビュートのGlobal(通称Detail)アトリビュート値を返します。 アトリビュートは、nameまたはhou.Attribオブジェクトで指定することができます。

この名前のアトリビュートが存在しなかった場合や、サイズが1のfloatでなかった場合は、hou.OperationFailedを引き起こします。

たいていの場合、アトリビュート値にアクセスするには、hou.Geometry.attribValueを使用します。 Houdiniは、このメソッドを内部的に使用してattribValueを実装しています。

特定の浮動小数点アトリビュートのGlobal(通称Detail)アトリビュート値を返します。 アトリビュートは、nameまたはhou.Attribオブジェクトで指定することができます。 戻り値は、floatのリストです。

アトリビュートのサイズが1の時でも、このメソッドをコールするのは有効です。 この場合、1個の要素を持つリストが返されます。

関連項目:

• hou.Geometry.attribValue

特定の整数アトリビュートのGlobal(通称Detail)アトリビュート値を返します。 アトリビュートは、nameまたはhou.Attribオブジェクトで指定することができます。 詳細は、hou.Geometry.floatAttribValueを参照してください。

特定の整数アトリビュートのGlobal(通称Detail)アトリビュート値を返します。 アトリビュートは、nameまたはhou.Attribオブジェクトで指定することができます。 戻り値は、intのリストです。 詳細は、hou.Geometry.floatListAttribValueを参照してください。

特定の文字列アトリビュートのGlobal(通称Detail)アトリビュート値を返します。 アトリビュートは、nameまたはhou.Attribオブジェクトで指定することができます。 詳細は、hou.Geometry.floatAttribValueを参照してください。

特定の文字列アトリビュートのGlobal(通称Detail)アトリビュート値を返します。 アトリビュートは、nameまたはhou.Attribオブジェクトで指定することができます。 戻り値は、stringのリストです。 詳細は、hou.Geometry.floatListAttribValueを参照してください。

特定の辞書アトリビュートのGlobal(通称Detail)アトリビュート値を返します。 このアトリビュートには、名前またはhou.Attribオブジェクトを指定することができます。 詳細は、hou.Geometry.floatAttribValueを参照してください。

特定の辞書アトリビュートのGlobal(通称Detail)アトリビュート値をを返します。 このアトリビュートには、名前またはhou.Attribオブジェクトを指定することができます。 この戻り値は辞書のタプルです。

アトリビュートのサイズが1の時でもこのメソッドをコールするのは有効です。 その場合、1個のエレメントを含んだタプルが返されます。 詳細は、hou.Geometry.floatAttribValueを参照してください。

Global(通称Detail)アトリビュート値を設定します。 アトリビュートは、nameまたはhou.Attribオブジェクトで指定することができます。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

このアトリビュートが配列アトリビュートの場合、そのアトリビュートのタプルサイズで割り切れる長さの値シーケンスをattrib_valueに渡す必要があります。 必要なサイズでタプルを満たさないシーケンスの後の値は破棄されます。

この名前のアトリビュートが存在しなかった場合や、アトリビュートのデータタイプが与えられた値に合致しなかった場合は、hou.OperationFailedを引き起こします。 アトリビュートのサイズが2以上の場合、アトリビュート値は必ず整数/浮動小数点のシーケンスでなければならず、シーケンスのサイズはアトリビュートのサイズと同じでなければなりません。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

# このコードは、Python SOP内から動作しますが、Pythonシェルからは動作しません。
geo = hou.pwd().geometry()
geo.addAttrib(hou.attribType.Global, "author", "")
geo.addAttrib(hou.attribType.Global, "version", (0, 0, 0))
geo.setGlobalAttribValue("author", "Joe")
geo.setGlobalAttribValue("version", (1, 0, 7))

以下はグローバル配列アトリビュートに値を設定するサンプルです:

geo = hou.pwd().geometry()
geo.addArrayAttrib(
    hou.attribType.Global, "data", hou.attribData.Float, tuple_size=3)

# これは、グローバルアトリビュートの値に
# [(1.0, 2.0, 3.0), (4.0, 5.0, 6.0)]を設定します。
geo.setGlobalAttribValue("data", [1.0, 2.0, 3.0, 4.0, 5.0, 6.0])

関連項目:

• hou.Geometry.attribValue

• hou.Point.setAttribValue

• hou.Prim.setAttribValue

• hou.Vertex.setAttribValue

このジオメトリのキャプチャー領域のパスを表現した文字列のタプルを返します。 このキャプチャー領域は、ジオメトリのキャプチャーアトリビュートから識別されます。

関連項目:

• hou.Geometry.attributeCaptureObjectPaths

このジオメトリのキャプチャーオブジェクトのパスを表現した文字列のタプルを返します。 このキャプチャーオブジェクトは、このジオメトリを取り込むために使用されるオブジェクトであり、そのジオメトリのキャプチャーアトリビュートから識別されます。 スケルトンのルートパスは、このキャプチャーオブジェクトのパスの先頭に追加され、それらのオブジェクトノードは以下のコードによって取得します:

# このコードは、Python SOP内から動作しますが、Pythonシェルからは動作しません。
geo = hou.pwd().geometry()
nodes = [hou.node(x) for x in geo.attributeCaptureObjectPaths()]

関連項目:

• hou.Geometry.attributeCaptureRegions

列挙値hou.attribType.Globalを返します。 ポイント、プリミティブ、頂点、ジオメトリは、それらのアトリビュートを照会するための同じメソッドのセットをサポートしており、このメソッドは、その1つです。

関連項目:

• hou.Prim.attribType

• hou.Point.attribType

• hou.Vertex.attribType

指定した古い名前のPointアトリビュートを新しい名前に変更します。 このメソッドは、通常ではPython定義のSOPのジオメトリが書き込み可能な時に、そのSOP内からコールします。

読み込み専用のジオメトリに対してコールするとGeometryPermissionErrorを引き起こします。 old_nameまたはnew_nameがNoneの場合はTypeErrorを引き起こします。 古い名前のPointアトリビュートが存在しなければOperationFailedを引き起こします。 新しい名前のPointアトリビュートが既に存在すればOperationFailedを引き起こします。

指定した古い名前のPrimitiveアトリビュートを新しい名前に変更します。 このメソッドは、通常ではPython定義のSOPのジオメトリが書き込み可能な時に、そのSOP内からコールします。

読み込み専用のジオメトリに対してコールするとGeometryPermissionErrorを引き起こします。 old_nameまたはnew_nameがNoneの場合はTypeErrorを引き起こします。 古い名前のPrimitiveアトリビュートが存在しなければOperationFailedを引き起こします。 新しい名前のPrimitiveアトリビュートが既に存在すればOperationFailedを引き起こします。

指定した古い名前のVertexアトリビュートを新しい名前に変更します。 このメソッドは、通常ではPython定義のSOPのジオメトリが書き込み可能な時に、そのSOP内からコールします。

読み込み専用のジオメトリに対してコールするとGeometryPermissionErrorを引き起こします。 old_nameまたはnew_nameがNoneの場合はTypeErrorを引き起こします。 古い名前のVertexアトリビュートが存在しなければOperationFailedを引き起こします。 新しい名前のVertexアトリビュートが既に存在すればOperationFailedを引き起こします。

指定した古い名前のDetailアトリビュートを新しい名前に変更します。 このメソッドは、通常ではPython定義のSOPのジオメトリが書き込み可能な時に、そのSOP内からコールします。

読み込み専用のジオメトリに対してコールするとGeometryPermissionErrorを引き起こします。 old_nameまたはnew_nameがNoneの場合はTypeErrorを引き起こします。 古い名前のDetailアトリビュートが存在しなければOperationFailedを引き起こします。 新しい名前のDetailアトリビュートが既に存在すればOperationFailedを引き起こします。

ジオメトリのアトリビュートをリストするパラメータメニュー用のトークンとラベルを生成します。

他のジオメトリからアトリビュート(hou.Attrib)をコピーします。 正しいコンテキスト内で同じ名前のアトリビュートが必ず現行ジオメトリ上に存在している必要があります。 失敗するとOperationFailedが引き起こされ、そのエラーの状況の詳細が示されます。

他のジオメトリからアトリビュート(hou.Attrib)のリストをコピーします。 正しいコンテキスト内で同じ名前のアトリビュートが必ず現行ジオメトリ上に存在している必要があります。 失敗するとOperationFailedが引き起こされ、そのエラーの状況の詳細が示されます。

“intrinsic”の値を取得します。これは、頻繁に計算がされており、memoryusage, pointcount, pointattributesなどのジオメトリの値です。 指定したIntrinsic名が存在しなかった場合は、OperationFailedを引き起こします。

Geometry Spreadsheetを使えば、ユーザインターフェースでそれらの値を確認することもできます。

Houdiniでは、プリミティブに“intrinsic”値があり、この値は直接アトリビュートインターフェースからアクセスすることができません。 ほとんどのIntrinsic値は、measuredareaのように計算されていますが、いくつかのIntrinsic値はsetIntrinsicValue methodで書き込むことができます。 例えば、球のプリミティブは、その定義の一部としてトランスフォームマトリックスを持ちます。

intrinsicNames methodを使えば、利用可能なIntrinsic値の名前のリストを取得することができます。 異なるジオメトリタイプには、異なるIntrinsic値が利用可能です。

boundsなどの境界ボックス系Intrinsic値は、(xmin, xmax, ymin, ymax, zmin, zmax)の順番で返されます。

このジオメトリで利用可能なIntrincis値を意味した文字列のタプルを返します。 異なるジオメトリタイプには、異なるIntrinsic値が利用可能です。 intrinsicValueやsetIntrinsicValueを使用することで、その値を取得または設定することができます。

詳細は、intrinsicValueメソッドを参照してください。

Intrinsicの名前とその値をマッピングした辞書を返します。

いくつかの“intrinsic”値は修正可能です。 例えば、トランスフォームを意味する16個のfloatのタプルをsetIntrinsicValueに渡すことで、球プリミティブの内部サイズと回転(トランスフォーム)を変更することができます。 Intrinsicが書き込み不可だったり、渡した値を受け入れなかった場合、または指定したIntrinsic名が存在しなかった場合は、Errorを引き起こします。

詳細は、intrinsicValue methodを参照してください。

ジオメトリの優先される計算精度を返します。 これを使用することで、作成するアトリビュートの種類と中間計算で実行する精度を判断することができます。 返される値は、32または64です。

ジオメトリの優先される精度を調整します。 値には、32または64のどちらかを指定してください。 ノードは、この精度をヒントにして、デフォルトのアトリビュート生成と特定の計算精度を設定します。

attribdataid VEX関数がattribdataid(geo, "meta", "detail")をコールした時に返すのと同じ整数リストを返します。 これは、このオブジェクトに変更があるかどうかの保守的なチェックとして使用可能な識別子です。 この戻り値には、hou.Geometry.modificationCounterの値が含まれます。

このオブジェクトに変更があったかどうかを判断するための保守的なチェックとして使用可能なカウンターを返します。 このカウンターは、hou.Geometryオブジェクト毎に固有ではないことに注意してください。 これらの値を別のジオメトリで比較したいのであれば、代わりにhou.Geometry.vexAttribDataIdを使用してください。

このオブジェクトの内容が変更されたことをマークするために変更カウンターを増分します。

このジオメトリ内のアトリビュート上のすべてのデータIDを増分します。 このジオメトリ内のすべてが変更されたことをマークするのであれば、これを使用するのが一番簡単な方法です。 内部的には、これはhou.Geometry.incrementModificationCounterもコールします。

ポイント/プリミティブが追加または削除されたことを示すためにデータIDを増分します。

Primitiveアトリビュート以外のプリミティブの内容を表現したデータIDを返します。 このデータIDは、プリミティブの数が変わった時でも増分することに注意してください。

Primitiveアトリビュート以外のプリミティブの内容が変更されたことを示すためにPrimitive IntrinsicsデータIDを増分します。

ポイントがプリミティブに接続された時などのように、このジオメトリのトポロジーを表現したデータIDを返します。

このジオメトリのトポロジーが何かしらの方法で変更されたことを示すためにデータIDを増分します。

ポイントパターンで指定されたポイントを含むようにサイズと位置が決められた軸平行の3D境界ボックスを返します。 このパターンが空っぽであれば、すべてのポイントが含まれます。

球などのいくつかのプリミティブは、そのポイントからはみ出します。そのはみ出し分は考慮されません。

プリミティブパターンで指定されたプリミティブを含むようにサイズと位置が決められた軸平行の3D境界ボックスを返します。 このパターンが空っぽであれば、すべてのプリミティブが含まれます。

球などのいくつかのプリミティブは、そのポイントからはみ出します。そのはみ出し分は考慮されます。

このジオメトリを囲むのに十分な大きさのサイズで配置された(オプションでジオメトリインスタンスをトランスフォームさせた)軸平行の3D境界ボックスを返します。

このジオメトリを囲むのに十分な大きさのサイズで配置された向きのある3D境界ボックスを返します。

ポイントパターンで指定されたポイントを含むようにサイズと位置が決められた向きのある3D境界ボックスを返します。 このパターンが空っぽであれば、すべてのポイントが含まれます。

球などのいくつかのプリミティブは、そのポイントからはみ出します。そのはみ出し分は考慮されません。

プリミティブパターンで指定されたプリミティブを含むようにサイズと位置が決められた向きのある3D境界ボックスを返します。 このパターンが空っぽであれば、すべてのプリミティブが含まれます。

球などのいくつかのプリミティブは、そのポイントからはみ出します。そのはみ出し分は考慮されます。

selfのポイントセットまでの最短距離のgeometry内のすべてのポイントの平均を返します。

geometryに頂点がなければ、hou.OperationFailedを引き起こします。

query_geometry = query_node.geometry()
queried_geometry = queried_node.geometry()

# <query_geometry>のポイントセットまでの最短距離にある
# <queried_geometry>内のポイントすべての平均を返します。
query_geometry.averageMinDistance(
    query_node.worldTransform(),
    queried_geometry,
    queried_node.worldTransform())

メッシュの平均エッジ長を返します。

メッシュに何もエッジがなければ、hou.OperationFailedを引き起こします。

# 平均のエッジ長を返します。
geo.averageEdgeLength()

(0, 0, 0)の場所に新しくポイントを作成し、それらに該当するhou.Pointオブジェクトを返します。 通常ではPython定義のSOPのコードからこのメソッドをコールします。

ジオメトリにPointアトリビュートが含まれていれば、その新しいポイントは、それらのアトリビュートのデフォルト値を受け取ります。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

サンプルとしてhou.Geometry.addAttrib, hou.Geometry.createPolygon, hou.Face.addVertexを参照してください。

指定した複数位置にそれぞれポイントを作成し、新しいhou.Pointオブジェクトのタプルを返します。 このメソッドは、通常ではPython定義のSOPのコードからコールします。

point_positionsには、hou.Vector3オブジェクトのタプルまたは3-タプルの浮動小数点のタプルを指定することができます。 例えば、point_positionsが((0, 1, 2), (1, 2, 3))であれば、このメソッドは(0, 1, 2)と(1, 2, 3)の位置に1個ずつポイントを作成します。

ジオメトリにPointアトリビュートが含まれていれば、新しく作成されたポイントのアトリビュートにはそのデフォルト値が入ります。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。 指定したポイントポジションのどれかが3つの値(x,y,z)でない場合は、hou.InvalidSizeを引き起こします。

サンプルは、hou.Geometry.addAttrib, hou.Geometry.createPolygons, hou.Face.addVertexを参照してください。

新しいポリゴンを作成し、それに該当するhou.Polygonオブジェクトを返します。 通常ではPython定義のSOPのコードからこのメソッドをコールします。

新しく作成されたポリゴンには頂点がありません。頂点を追加するにはhou.Face.addVertexを使用します。 また、ポリゴンは、特に指定がなければデフォルトでは閉じ、指定があればポリゴンカーブになります(詳細は、hou.Face.isClosedを参照してください)。

ジオメトリにPrimitiveアトリビュートが含まれていれば、その新しいポリゴンは、それらのアトリビュートのデフォルト値を受け取ります。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

geo = hou.pwd().geometry()
poly = geo.createPolygon()
for position in (0,0,0), (1,0,0), (0,1,0):
    point = geo.createPoint()
    point.setPosition(position)
    poly.addVertex(point)

若干複雑なサンプルはhou.Face.addVertexを参照してください。

指定したポイントを頂点とする一連のポリゴンを作成し、その新しいhou.Polygonオブジェクトのタプルを返します。 通常ではPython定義のSOPのコードからこのメソッドをコールします。

pointsには、hou.Pointオブジェクトのタプルまたはポイント番号を意味した整数のタプルのタプルを指定することができます。 例えば、pointsが((0, 1, 2), (3, 4, 5, 6))であれば、このメソッドは、ポイント番号0,1,2を頂点とするポリゴンとポイント番号3,4,5,6を頂点とするポリゴンを作成します。

作成されたポリゴンは、特に指定がなければデフォルトでは閉じ、指定があればポリゴンカーブになります(詳細は、hou.Face.isClosedを参照してください)。

ジオメトリにPrimitiveアトリビュートが含まれていれば、新しく作成されたポリゴンのアトリビュートにはそのデフォルト値が入ります。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。 指定したポイントタプルが最低でも3つの要素でない場合は、hou.InvalidSizeを引き起こします。 ポイント番号のどれかまたはhou.Pointオブジェクトがジオメトリ内になければ、hou.InvalidInputを引き起こします。

例:

# ジオメトリ内に6つのポイントを作成します。
geo = hou.pwd().geometry()
point_positions = (
    (1, 0, 0), (0, 1, 0), (0, 0, 1),
    (1, 1, 0), (1, 0, 1), (0, 1, 1),
)
points = geo.createPoints(point_positions)

# 2つのポリゴンを作成します。
# 最初のポリゴンは、ジオメトリ内の最初の3つのポイントを頂点として使用します。
# 2番目のポリゴンは、ジオメトリ内の最後の3つのポイントを頂点として使用します。
polygons = geo.createPolygons(
    ((points[0], points[1], points[2]), (points[3], points[4], points[5])))

新しい四面体を作成し、それに該当するhou.Primオブジェクトを返します。 通常ではPython定義のSOPのコードからこのメソッドをコールします。

新しく作成された四面体には4つの頂点があり、その頂点に新しいポイントが割り当てられています。 既存ポイントから四面体を構築するには、hou.Geometry.createTetrahedronInPlaceを使用します。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

新しい四面体を作成し、それに該当するhou.Primオブジェクトを返します。 通常ではPython定義のSOPのコードからこのメソッドをコールします。

新しく作成された四面体には4つの頂点があり、四面体に渡されたポイントを使用します。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

新しい六面体を作成し、それに該当するhou.Primオブジェクトを返します。 通常ではPython定義のSOPのコードからこのメソッドをコールします。

新しく作成された六面体には8つの頂点があり、その頂点に新しいポイントが割り当てられています。 既存ポイントから六面体を構築するには、hou.Geometry.createHexahedronInPlaceを使用します。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

新しい六面体を作成し、それに該当するhou.Primオブジェクトを返します。 通常ではPython定義のSOPのコードからこのメソッドをコールします。

新しく作成された六面体には8つの頂点があり、六面体に渡されたポイントを使用します。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

指定した頂点数で新しいNURBSを作成し、それを返します。 通常ではPython定義のSOPのコードからこのメソッドをコールします。

ジオメトリにPrimitiveアトリビュートが含まれていれば、新しいカーブは、それらのアトリビュートのデフォルト値を受け取ります。

# このコードは、Python SOP内から動作しますが、Pythonシェルからは動作しません。
geo = hou.pwd().geometry()
curve = geo.createNURBSCurve(10)
i = 0
for vertex in curve.vertices():
    vertex.point().setPosition((i, i % 3, 0))
    i = i + 1

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

関連項目:

• hou.Prim.vertices

• hou.Point.setPosition

指定した頂点数で新しいBezierカーブを作成し、それを返します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

開いたBezierカーブは、(order - 1) * n + 1個の頂点がなければなりません。 このnはn>=1です。(そのため、階数が4のカーブに有効な値は、4, 7, 10などです)。 閉じたBezierカーブは、(order - 1) * n個の頂点がなければなりません(例えば、階数が4のカーブには3, 6, 9などの頂点数が必要です)。 この制限は、階数2のカーブには当てはまりません。

結論として、頂点数を変更する必要があるので、非線形なBezierカーブにはhou.Face.setIsClosedを使用することができません。

詳細は、hou.Geometry.createNURBSCurveを参照してください。

(1, 1)のサイズで原点を中心としてXY平面にNURBSサーフェスを作成します。通常では、Python定義のSOPのコードからこのメソッドをコールします。

ジオメトリにPrimitiveアトリビュートが含まれていれば、新しいサーフェスは、それらのアトリビュートのデフォルト値を受け取ります。

hou.Geometry.transformPrimsを使えば、サーフェスを動かしたりサイズを変更することができます。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

縦と横の数が無効な場合は、hou.OperationFailedを引き起こします。

# このコードは、Python SOP内から動作しますが、Pythonシェルからは動作しません。
geo = hou.pwd().geometry()

# 頂点が10x10のグリッドのサーフェスを作成します。
surf = geo.createNURBSSurface(10, 10)

# 初期状態では、その中心は(0, 0, 0)で、サイズが(1, 1, 1)で、XY平面上にあります。
# これを(20, 10)にスケールして、XZ平面へ回転します。
geo.transformPrims((surf,),
    hou.hmath.buildScale((20, 10, 1)) *
    hou.hmath.buildRotateAboutAxis((1, 0, 0), 90))

関連項目:

• hou.Geometry.transformPrims

• hou.Matrix4

• hou.hmath

(1, 1)のサイズで原点を中心としてXY平面にBezierサーフェスを作成します。通常では、Python定義のSOPのコードからこのメソッドをコールします。

Bezierカーブと同様、Bezierサーフェスには各UV方向でポイント数の制限があります。 指定した方向に対して開く場合、その方向のポイント数は、(order - 1) * n + 1でなければなりません。 このnはn >= 1です。(例えば、 4, 7, 10, …)。 閉じる場合、その方向のポイント数は(order - 1) * nでなければなりません。このnはn >= 1です。 (例えば、階数3なら2, 4, 6, ..です)。

hou.Geometry.transformPrimsを使えば、サーフェスを動かしたりサイズを変更することができます。

ジオメトリにPrimitiveアトリビュートが含まれていれば、新しいサーフェスは、それらのアトリビュートのデフォルト値を受け取ります。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

import math

# このコードは、Python SOP内から動作しますが、Pythonシェルからは動作しません。
geo = hou.pwd().geometry()

# Y軸を基準にチューブ状のオブジェクトを構築します。
num_rows, num_cols = (10, 9)
surf = geo.createBezierSurface(num_rows, num_cols, is_closed_in_u=True)
for v_index in range(num_rows):
    for u_index in range(num_cols):
        angle = u_index * (2.0 * math.pi) / num_cols
        surf.vertex(u_index, v_index).point().setPosition(
            (math.cos(angle), v_index / float(num_cols-1), math.sin(angle)))

(1, 1)のサイズで原点を中心としてXY平面に四角形メッシュを作成し、それを返します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

メッシュオブジェクトは、同じ形状を定義したポリゴンセットと同じではないことに注意してください。 メッシュオブジェクトは単一プリミティブです。

詳細は、hou.Geometry.createNURBSSurfaceを参照してください。

x,y,zの解像度(またはサイズ)のボクセル配列を指定すると、ジオメトリに新しいボリュームプリミティブが追加され、それを返します。 新しいボリュームのボクセル値はすべて0です。

新しいチャンネルプリミティブを作成してジオメトリに追加して、それを返します。 その新しいチャンネルプリミティブは空っぽのチャンネルに初期化されます。

point

詳細は、hou.PackedPrimを参照してください。

指定した埋め込みジオメトリを使用したジオメトリパックプリミティブを作成します。

point

詳細は、hou.PackedPrimを参照してください。

一連のプリミティブを削除します。通常では、Python定義のSOPのコードからこのメソッドをコールします。

1つのプリミティブを削除するには、1つのプリミティブのシーケンスを渡してください。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

# 1つおきにプリミティブを削除します:
prims = [p for p in geo.prims() if p.number() % 2 == 0]
geo.deletePrims(prims)

# 1番目のプリミティブを削除します:
geo.deletePrims([geo.iterPrims()[0]])

指定した境界ボックスから完全に外にある境界ボックスのプリミティブを削除します。

また、削除したプリミティブと関連付けられているポイントも削除します。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

一連のポイントを削除します。通常では、Python定義のSOPのコードからこのメソッドをコールします。

Houdiniは、そのポイントを参照している頂点を削除することに注意してください。 例えば、6つのポリゴンで構成されたボックスがあり、その各ポリゴンが4つの頂点を持っていると仮定します。 また、ボックス上の各ポイントが3つのポリゴン上の3つの頂点で共有されていると仮定します。 これらのポイントのどれかを削除すると、Houdiniは、それに相当するポリゴンからその頂点を削除し、 その結果、4つの頂点を持つ3つのポリゴンと3つの頂点を持つ3つのポリゴンが残ります。

1つのポイントを削除するには、1つのポイントのシーケンスを渡してください。

このジオメトリが変更不可の場合は、hou.GeometryPermissionErrorを引き起こします。

指定した名前のPointグループを返します。そのようなグループが存在しなければNoneを返します。

ジオメトリ内のすべてのPointグループのタプルを返します。

以下の関数は、ジオメトリ内のすべてのグループの名前を返します:

def pointGroupNames(geometry):
    return [group.name() for group in geometry.pointGroups()]

このジオメトリ内に新しいPointグループを作成します。

ジオメトリからPointグループを削除するには、hou.PointGroup.destroyを使用します。

指定した名前のPrimitiveグループを返します。そのようなグループが存在しなければNoneを返します。

ジオメトリ内のすべてのPrimitiveグループのタプルを返します。

このジオメトリ内に新しいPrimitiveグループを作成します。

ジオメトリからPrimitiveグループを削除するには、hou.PrimGroup.destroyを使用します。

指定した名前のエッジグループを返します。そのようなグループが存在しなければNoneを返します。

ジオメトリ内のすべてのエッジグループのタプルを返します。

このジオメトリ内に新しいエッジグループを作成します。

ジオメトリからエッジグループを削除するには、hou.EdgeGroup.destroyを使用します。

指定した名前の頂点グループを返します。そのようなグループが存在しなければNoneを返します。

ジオメトリ内のすべての頂点グループのタプルを返します。

以下の関数は、ジオメトリ内のすべてのグループの名前を返します:

def vertexGroupNames(geometry):
    return [group.name() for group in geometry.vertexGroups()]

このジオメトリ内に新しい頂点グループを作成します。

ジオメトリから頂点グループを削除するには、hou.VertexGroup.destroyを使用します。

ジオメトリのグループをリストするパラメータメニュー用のトークンとラベルを生成します。

特定のSOPにリンクされていない他のGeometryオブジェクトを返します。

通常では、hou.SopNode.geometryをコールすると、その結果のGeometryオブジェクトがそのSOPの参照を維持します。 それをUnfrozenと言います。 UnfrozenのGeometryオブジェクト内のポイント、プリミティブ、アトリビュートにアクセスする度に、Houdiniは、そのSOPが最後にクックしたジオメトリを使用します。 そのため、パラメータを変更したり、アニメーションするSOPに関しては時間を変更すると、そのGeometryオブジェクトは、そのSOPの新しいジオメトリに更新されます。

Python SOPを呼び出さない限り、フリーズしたGeometryオブジェクトは、特定のSOPと同様のライブの連動性を持ちません。 SOPにそのジオメトリを要求し、そのジオメトリのフリーズしたコピーを保存した場合、SOPを再クックした時、そのフリーズしたGeometryオブジェクトは更新されません。 その代わりに、フリーズしたジオメトリは、自身のポイントやプリミティブのデータのコピーを保存し、そのSOPへのその後の変更から影響を受けません。 フリーズしたGeometryオブジェクトを破壊した時、それが作成したジオメトリコピーも破壊されます。

Geometryオブジェクトのポイント、プリミティブ、アトリビュートなどへのアクセスは、フリーズしたオブジェクトを扱う時に高速になることを覚えておいてください。 速度が重要な処理では、フリーズしたGeometryで作業したいことがあるでしょう。

UnfrozenのGeometryオブジェクトに対してこのメソッドをコールすると、フリーズしたGeometryオブジェクトが返されます。 フリーズしたオブジェクトに対してこのメソッドをコールしても何の効果もなく、フリーズしたオブジェクトが返されます。

Python定義のSOPをクックして、そのSOPのジオメトリを要求するPythonコードを実行する時は、その返されたGeometryオブジェクトは書き込み可能です。 このGeometryオブジェクトを修正すると、このSOPの出力に影響を与えます。 効率を上げるために、このGeometryオブジェクトは既にフリーズされているので、そのオブジェクトにフリーズをコールしても何の効果もありません。

ジオメトリが読み込み専用ならTrueを返します。

Geometryがフリーズされていない場合は、このジオメトリに相当するhou.SopNodeオブジェクトを返します。 フリーズされている場合は、Noneを返します。

フリーズしたジオメトリに関する詳細は、hou.Geometry.freezeを参照してください。

Geometryがフリーズされていない場合は、このジオメトリが相当するSOPノードの出力のインデックスを返します。 フリーズされている場合は、-1を返します。

たいていの場合、このメソッドは、1番目の出力に相当するジオメトリを意味する0を返します。 このメソッドは、複数の出力を持つSOPノードに対しては0以外の値を返すだけです。

フリーズしたジオメトリに関する詳細は、hou.Geometry.freezeを参照してください。

ジオメトリ内のすべてのポイントのタプルを返します。

hou.Geometry.iterPointsメソッドも参照してください。

ジオメトリ内のすべてのポイントを通じて反復するジェネレータを返します。

hou.Geometry.pointsはジオメトリ内のすべてのポイントのタプルを割り当てて返すのに対し、 このメソッドは、要求に応じてhou.Pointオブジェクトを割り当てるジェネレータオブジェクトを返します。 このオブジェクトは、シーケンスのランダムアクセスで非常に高速です。

インデックスによって特定のポイントにアクセスして、そのジオメトリにポイントがたくさんある場合、 points()よりもiterPoints()を使用する方が高速です。 しかし、ジオメトリ内のすべてのポイントに対して反復する場合には、一般的にはiterPoints()よりもpoints()の方が高速です。

# これが望ましいです:
geo.iterPoints()[23]

# これよりも:
geo.points()[23]

# しかし、これが望ましいです:
for point in geo.points():
    ...ポイントを処理...

# これよりも:
for point in geo.iterPoints():
    ...ポイントを処理...

ポイント番号のパターンに相当するポイントのタプルを返します。

パターンフォーマットは、ポイント選択を受け取るSOPノード上のグループフィールドで使われているものと同じフォーマットです。 そのパターン内のエレメントは、スペースで区切り、それらのエレメントにはポイント番号、ポイント番号の範囲、グループ名を指定することができます。

オプションで、グループに追加された順番でポイントを返すことができます。

このメソッドは、選択したポイントセットだけに動作するPython SOPを記述する時に役に立ちます。

パターンが有効でない、または存在しないグループを参照した場合は、hou.OperationFailedを引き起こします。 空っぽのパターンは無効とみなされることに注意してください。 有効なポイントを参照していない番号は、エラーになるのではなく、単にポイントに合致しないだけです。

# 5と7のポイントを含むタプルを返します。
geo.globPoints("5 7")

# 5から10までのポイントを含むタプルを返します。
geo.globPoints("5-10")

# group1ポイントグループ内のポイントすべてを含むタプルを返します。
geo.globPoints("group1")

# 0から98以外のポイントすべてを返します。
geo.globPoints("!0-98")

# 5, 10から20までのポイントとgroup1内のポイントを返します。
geo.globPoints("5 group1 10-20")

以下のPython SOPのサンプルは、Point SOPと同じ挙動をします。

# このコードは、Python SOP内から動作しますが、Pythonシェルからは動作しません。
# Python SOPに以下のparmタプルがあると想定します:
#     group: 影響を与えるポイントを含んだ文字列
#     t:     Point SOPのpositionパラメータのような挙動をする3つのfloatのセット。
#            これらのパラメータをエクスプレッション($TX, $TY, $TZ)に設定します。
geo = hou.pwd().geometry()

# グループフィールドを使用して、影響を与えるポイントを決めます。グループフィールドが空っぽの場合、
# すべてのポイントに対して作用します。
pattern = hou.ch("group")
if pattern == "":
    points = geo.points()
else:
    points = geo.globPoints(pattern)

# ポイントをループして、SOPの現行ポイントを設定します。
# そして、t parmタプルを評価するので、現行ポイントを(例えば、hscriptの$TXやPythonのpwd().curPoint()と一緒に)使用することができます。
for point in points:
    hou.pwd().setCurPoint(point)
    new_position = hou.pwd().evalParmTuple("t")
    point.setPosition(new_position)

指定したインデックスのポイントを返します。

これは、hou.Geometry.pointsを使って無駄にすべてのポイントを取得することなく、特定のポイントにアクセスするための便利メソッドです。

指定したインデックスのポイントが存在しなかった場合は、Noneを返します。

照会位置を含んだ3個のfloatのシーケンスを与えると、ジオメトリ内でその位置からmax_radius以内にある最近接ポイントを検索します。

ptgroupが文字列グループパターンの場合、その検索は、指定されたポイントに制限されます。

ジオメトリ内に何もポイントが存在しなかった場合は、Noneを返すことに注意してください。

関連項目: hou.nearestPoints

照会位置を含んだ3個のfloatのシーケンスを与えると、ジオメトリ内でその位置からmax_radius以内にあるmax_points個の最近接ポイントを検索します。

ptgroupが文字列グループパターンの場合、その検索は、指定されたポイントに制限されます。

ジオメトリ内に何もポイントが存在しなかった場合は、Noneを返すことに注意してください。

関連項目: hou.nearestPoint

すべてのポイントの指定したアトリビュートの値を含んだfloatのタプルを返します。

このメソッドは、intまたはfloatのアトリビュートでのみ動作します。 指定したアトリビュートに2つ以上の要素が含まれている場合、各ポイントは、その結果の複数値に呼応します。 例えば、Cdがサイズ3のfloatアトリビュートで、(0.1, 0.2, 0.3), (0.5, 0.5, 0.5), (0.8, 0.7, 0.6)の3つのポイントがあれば、 その結果は、(0.1, 0.2, 0.3, 0.5, 0.5, 0.5, 0.8, 0.7, 0.6)になります。

このメソッドのコールは、hou.Point.attribValueコールですべてのポイントをループさせるよりも高速です。

アトリビュート名が無効な場合や、アトリビュートがintでもfloatでもない(例えば、文字列アトリビュートになっている)場合、このメソッドはhou.OperationFailedを引き起こします。

多くのメソッドではアトリビュートを扱うことができますが、このメソッドにはhou.Attribオブジェクトを渡すことができません。 とはいえ、hou.Attrib.nameを使用することで、Attribオブジェクトから簡単にアトリビュート名を取得することができます。

すべてのポイントに対してfloatのアトリビュート値を意味したバイナリ文字列を返します。 このメソッドは、hou.Geometry.pointFloatAttribValuesよりも高速で、arrayモジュールを使用すれば、文字列をPythonシーケンスに変換することができます。

返されるバイナリ文字列は、Python3だとbytesオブジェクト、Python2だとstrオブジェクトです。 詳細は、HOMバイナリデータを参照してください。

このメソッドは、以下の実装によって高速化しています:

import array
def pointFloatAttribValuesAsString(self, name):
    return array.array("f", self.pointFloatAttribValues(name)).tostring()

このメソッドからの戻り値を以下のメソッドを使用して配列に変換することができます:

import array
def pointFloatAttribValuesAsArray(geometry, name):
    a = array.array("f")
    a.fromstring(geometry.pointFloatAttribValuesAsString(name))
    return a

詳細は、hou.Geometry.pointFloatAttribValuesを参照してください。

特定のアトリビュートに対して、すべてのポイントのアトリビュート値を設定します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)や、値の配列が正しいサイズでない場合は、 このメソッドは、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.pointFloatAttribValuesも参照してください。

特定のアトリビュートに対して、指定したfloat_type値のシーケンスの文字列表現からすべてのポイントにアトリビュート値を設定します。 このメソッドは、hou.Geometry.setPointFloatAttribValuesよりも高速です。

このメソッドは、文字列だけでなく他のタイプも受け入れることができます。つまりバッファインターフェースに対応したPythonオブジェクトを受け取ることができます。 特に、arrayとnumpyのPythonモジュールからの配列がサポートされているので、それらの配列から文字列を構築する必要がありません。

文字列の長さがlen(self.iterPoints() * byte_size_of_float_type)でない場合は、hou.OperationFailedを引き起こします。

詳細は、hou.Geometry.setPointFloatAttribValuesとhou.Geometry.pointFloatAttribValuesAsStringを参照してください。

以下のサンプルの関数は、array.array("f")を受け取り、そのアトリビュート値をその内容に設定します:

def setPointFloatAttribValuesFromArray(geometry, arr):
    assert(arr.typecode == "f")
    geometry.setPointFloatAttribValuesFromString(arr))

すべてのポイントのアトリビュート値を含んだintのタプルを返します。

このメソッドは、intまたはfloatのアトリビュートに対してのみ動作します。 アトリビュートに2つ以上のエレメントが含まれている場合、各ポイントはその結果の複数値に相当します。 例えば、“idmap”がサイズ2のintアトリビュートで、(1, 2), (2, 3), (3, 4)の値の3つのポイントが存在すると、 その結果は、(1, 2, 2, 3, 3, 4)になります。

このメソッドのコールは、すべてのポイントをループしたり、hou.Point.attribValueをコールするよりも高速です。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)は、このメソッドは、hou.OperationFailedを引き起こします。

アトリビュートを扱う他の多くのメソッドのように、hou.Attribオブジェクトをこのメソッドに渡すことが出来ないことに注意してください。 とはいえ、hou.Attrib.nameを使用すれば、簡単にAttribオブジェクトから名前を取得することができます。

すべてのポイントに対してintのアトリビュート値を意味したバイナリ文字列を返します。 このメソッドは、hou.Geometry.pointIntAttribValuesよりも高速で、arrayモジュールを使用すれば、文字列をPythonシーケンスに変換することができます。

返されるバイナリ文字列は、Python3だとbytesオブジェクト、Python2だとstrオブジェクトです。 詳細は、HOMバイナリデータを参照してください。

このメソッドは、以下の実装によって高速化しています:

import array
def pointIntAttribValuesAsString(self, name):
    return array.array("i", self.pointIntAttribValues(name)).tostring()

このメソッドからの戻り値を以下のメソッドを使用して配列に変換することができます:

import array
def pointIntAttribValuesAsArray(geometry, name):
    a = array.array("i")
    a.fromstring(geometry.pointIntAttribValuesAsString(name))
    return a

詳細は、hou.Geometry.pointIntAttribValuesを参照してください。

特定のアトリビュートに対して、すべてのポイントのアトリビュート値を設定します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)や、値の配列が正しいサイズでない場合は、 このメソッドは、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.pointIntAttribValuesも参照してください。

特定のアトリビュートに対して、指定したint_type値のシーケンスの文字列表現からすべてのポイントにアトリビュート値を設定します。 このメソッドは、hou.Geometry.setPointIntAttribValuesよりも高速です。

このメソッドは、文字列だけでなく他のタイプも受け入れることができます。つまりバッファインターフェースに対応したPythonオブジェクトを受け取ることができます。 特に、arrayとnumpyのPythonモジュールからの配列がサポートされているので、それらの配列から文字列を構築する必要がありません。

文字列の長さがlen(self.iterPoints() * byte_size_of_int_type)でない場合は、hou.OperationFailedを引き起こします。

詳細は、hou.Geometry.setPointIntAttribValuesとhou.Geometry.pointIntAttribValuesAsStringを参照してください。

以下のサンプルの関数は、sizeof(signed int) == 4と仮定してarray.array("i")を受け取り、そのアトリビュート値をその内容に設定します:

def setPointIntAttribValuesFromArray(geometry, arr):
    assert(arr.typecode == "i")
    geometry.setPointIntAttribValuesFromString(arr))

すべてのポイントの指定したアトリビュートの値を含んだ文字列のタプルを返します。

このメソッドは、文字列アトリビュートでのみ動作します。 指定したアトリビュートに2つ以上の要素が含まれている場合、各ポイントは、その結果の複数値に呼応します。 例えば、“strmap”がサイズ2の文字列アトリビュートで、(“apple”, “orange”), (“red”, “blue”), (“one”, “two”)の3つのポイントがあれば、 その結果は、(“apple”, “orange”, “red”, “blue”, “one”, “two”)になります。

このメソッドのコールは、hou.Point.attribValueコールですべてのポイントをループさせるよりも高速です。

アトリビュート名が無効な場合や、アトリビュートが文字列アトリビュートでない場合、このメソッドはhou.OperationFailedを引き起こします。

多くのメソッドではアトリビュートを扱うことができますが、このメソッドにはhou.Attribオブジェクトを渡すことができません。 とはいえ、hou.Attrib.nameを使用することで、Attribオブジェクトから簡単にアトリビュート名を取得することができます。

特定のアトリビュートに対して、すべてのポイントにそのアトリビュート値を設定します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

アトリビュート名が無効だったり、アトリビュートが文字列でない、または値の配列が正しいサイズでない場合は、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.pointStringAttribValuesも参照してください。

指定した2つのポイントのエッジを検索します。そのようなエッジが存在しなければNoneを返します。

エッジパターンに相当するエッジのタプルを返します。

パターンフォーマットは、エッジ選択を受け取るSOPノード上のグループフィールドで使われているものと同じフォーマットです。 詳細は、hou.Geometry.globPointsを参照してください。

位置に関する3つのfloatのシーケンスを指定すると、その位置に最も近いプリミティブの位置を検索し、 そのプリミティブ、そのプリミティブ上のu値、そのプリミティブ上のv値、そのプリミティブまでの距離含んだタプルを返します。

ジオメトリにプリミティブがなかった場合は、戻りのタプルの1番目の値がNoneになることに注意してください。

ジオメトリ内のすべてのプリミティブのタプルを返します。返されるプリミティブは、hou.Primのサブクラス(例えば、ポリゴン、ボリュームなど)です。

関連項目:

• hou.Geometry.iterPrims

• hou.Face

• hou.Polygon

• hou.Surface

• hou.Volume

ジオメトリ内のすべてのプリミティブを通じて反復するジェネレータを返します。

hou.Geometry.primsはジオメトリ内のすべてのプリミティブのタプルを割り当てて返すのに対し、 このメソッドは、要求に応じてhou.Primを生成するジェネレータオブジェクトを返します。 このオブジェクトは、シーケンスのランダムアクセスで非常に高速です。

インデックスによって特定のプリミティブにアクセスして、そのジオメトリにプリミティブがたくさんある場合、 prims()よりもiterPrims()を使用する方が高速です。 しかし、ジオメトリ内のすべてのプリミティブに対して反復する場合には、一般的にはiterPrims()よりもprims()の方が高速です。

# これが望ましいです:
geo.iterPrims()[23]

# これよりも:
geo.prims()[23]

# しかし、これが望ましいです:
for prim in geo.prims():
    ...プリミティブを処理...

# これよりも:
for prim in geo.iterPrims():
    ...プリミティブを処理...

hou.Geometry.primsメソッドも参照してください。

プリミティブ番号のパターンに相当するプリミティブのタプルを返します。

パターンフォーマットは、プリミティブ選択を受け取るSOPノード上のグループフィールドで使われているものと同じフォーマットです。 詳細は、hou.Geometry.globPointsを参照してください。

指定したインデックスのプリミティブを返します。

これは、hou.Geometry.primsを使って無駄にすべてのプリミティブを取得することなく、特定のプリミティブにアクセスするための便利メソッドです。

指定したインデックスのプリミティブが存在しなかった場合は、Noneを返します。

ジオメトリに、最低でも1個の指定したタイプのプリミティブが含まれているかどうか返します。

ジオメトリ内の指定したタイプのプリミティブの数を返します。

すべてのプリミティブのアトリビュートの値を含んだfloatのタプルを返します。

このメソッドは、intまたはfloatのアトリビュートに対してのみ動作します。 アトリビュートに2つ以上のエレメントが含まれている場合、各プリミティブはその結果の複数値に相当します。 例えば、Cdがサイズ3のfloatアトリビュートで、(0.1, 0.2, 0.3), (0.5, 0.5, 0.5), (0.8, 0.7, 0.6)の値の3つのプリミティブが存在すると、 その結果は、(0.1, 0.2, 0.3, 0.5, 0.5, 0.5, 0.8, 0.7, 0.6)になります。

このメソッドのコールは、すべてのプリミティブをループしたり、hou.Prim.attribValueをコールするよりも高速です。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)は、このメソッドは、hou.OperationFailedを引き起こします。

アトリビュートを扱う他の多くのメソッドのように、hou.Attribオブジェクトをこのメソッドに渡すことが出来ないことに注意してください。 とはいえ、hou.Attrib.nameを使用すれば、簡単にAttribオブジェクトから名前を取得することができます。

すべてのプリミティブに対してfloatのアトリビュート値を意味したバイナリ文字列を返します。 このメソッドは、hou.Geometry.primFloatAttribValuesよりも高速で、arrayモジュールを使用すれば、文字列をPythonシーケンスに変換することができます。

返されるバイナリ文字列は、Python3だとbytesオブジェクト、Python2だとstrオブジェクトです。 詳細は、HOMバイナリデータを参照してください。

このメソッドは、以下の実装によって高速化しています:

import array
def primFloatAttribValuesAsString(self, name):
    return array.array("f", self.primFloatAttribValues(name)).tostring()

このメソッドからの戻り値を以下のメソッドを使用して配列に変換することができます:

import array
def primFloatAttribValuesAsArray(geometry, name):
    a = array.array("f")
    a.fromstring(geometry.primFloatAttribValuesAsString(name))
    return a

詳細は、hou.Geometry.primFloatAttribValuesを参照してください。

特定のアトリビュートに対して、すべてのプリミティブのアトリビュート値を設定します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)や、値の配列が正しいサイズでない場合は、 このメソッドは、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.primFloatAttribValuesも参照してください。

特定のアトリビュートに対して、指定したfloat_type値のシーケンスの文字列表現からすべてのプリミティブのアトリビュート値を設定します。 このメソッドは、hou.Geometry.setPrimFloatAttribValuesよりも高速です。

このメソッドは、文字列だけでなく他のタイプも受け入れることができます。つまりバッファインターフェースに対応したPythonオブジェクトを受け取ることができます。 特に、arrayとnumpyのPythonモジュールからの配列がサポートされているので、それらの配列から文字列を構築する必要がありません。

文字列の長さがlen(self.iterPrims() * byte_size_of_float_type)でない場合は、hou.OperationFailedを引き起こします。

詳細は、hou.Geometry.setPrimFloatAttribValuesとhou.Geometry.primFloatAttribValuesAsStringを参照してください。

以下のサンプルの関数は、array.array("f")を受け取り、そのアトリビュート値をその内容に設定します:

def setPrimFloatAttribValuesFromArray(geometry, arr):
    assert(arr.typecode == "f")
    geometry.setPrimFloatAttribValuesFromString(arr)

すべてのプリミティブのアトリビュート値を含んだintのタプルを返します。

このメソッドは、intまたはfloatのアトリビュートに対してのみ動作します。 アトリビュートに2つ以上のエレメントが含まれている場合、各ポイントはその結果の複数値に相当します。 例えば、“idmap”がサイズ2のintアトリビュートで、(1, 2), (2, 3), (3, 4)の値の3つのプリミティブが存在すると、 その結果は、(1, 2, 2, 3, 3, 4)になります。

このメソッドのコールは、すべてのプリミティブをループしたり、hou.Prim.attribValueをコールするよりも高速です。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)は、このメソッドは、hou.OperationFailedを引き起こします。

アトリビュートを扱う他の多くのメソッドのように、hou.Attribオブジェクトをこのメソッドに渡すことが出来ないことに注意してください。 とはいえ、hou.Attrib.nameを使用すれば、簡単にAttribオブジェクトから名前を取得することができます。

すべてのプリミティブに対してintのアトリビュート値を意味したバイナリ文字列を返します。 このメソッドは、hou.Geometry.primFloatAttribValuesよりも高速で、arrayモジュールを使用すれば、文字列をPythonシーケンスに変換することができます。

返されるバイナリ文字列は、Python3だとbytesオブジェクト、Python2だとstrオブジェクトです。 詳細は、HOMバイナリデータを参照してください。

このメソッドは、以下の実装によって高速化しています:

import array
def primIntAttribValuesAsString(self, name):
    return array.array("i", self.primIntAttribValues(name)).tostring()

このメソッドからの戻り値を以下のメソッドを使用して配列に変換することができます:

import array
def primIntAttribValuesAsArray(geometry, name):
    a = array.array("i")
    a.fromstring(geometry.primIntAttribValuesAsString(name))
    return a

詳細は、hou.Geometry.primIntAttribValuesを参照してください。

特定のアトリビュートに対して、すべてのプリミティブのアトリビュート値を設定します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)や、値の配列が正しいサイズでない場合は、 このメソッドは、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.primIntAttribValuesも参照してください。

特定のアトリビュートに対して、指定したint_type値のシーケンスの文字列表現からすべてのプリミティブにアトリビュート値を設定します。 このメソッドは、hou.Geometry.setPrimIntAttribValuesよりも高速です。

このメソッドは、文字列だけでなく他のタイプも受け入れることができます。つまりバッファインターフェースに対応したPythonオブジェクトを受け取ることができます。 特に、arrayとnumpyのPythonモジュールからの配列がサポートされているので、それらの配列から文字列を構築する必要がありません。

文字列の長さがlen(self.iterPrims() * byte_size_of_int_type)でない場合は、hou.OperationFailedを引き起こします。

詳細は、hou.Geometry.setPrimIntAttribValuesとhou.Geometry.primIntAttribValuesAsStringを参照してください。

以下のサンプルの関数は、sizeof(signed int) == 4と仮定してarray.array("i")を受け取り、そのアトリビュート値をその内容に設定します:

def setPrimIntAttribValuesFromArray(geometry, arr):
    assert(arr.typecode == "i")
    geometry.setPrimIntAttribValuesFromString(arr)

すべてのプリミティブの指定したアトリビュートの値を含んだ文字列のタプルを返します。

このメソッドは、文字列アトリビュートでのみ動作します。 指定したアトリビュートに2つ以上の要素が含まれている場合、各プリミティブは、その結果の複数値に呼応します。 例えば、“strmap”がサイズ2の文字列アトリビュートで、(“apple”, “orange”), (“red”, “blue”), (“one”, “two”)の3つのプリミティブがあれば、 その結果は、(“apple”, “orange”, “red”, “blue”, “one”, “two”)になります。

このメソッドのコールは、hou.Prim.attribValueコールですべてのプリミティブをループさせるよりも高速です。

アトリビュート名が無効な場合や、アトリビュートが文字列アトリビュートでない場合、このメソッドはhou.OperationFailedを引き起こします。

アトリビュートを扱う他の多くのメソッドのように、hou.Attribオブジェクトをこのメソッドに渡すことが出来ないことに注意してください。 とはいえ、hou.Attrib.nameを使用すれば、簡単にAttribオブジェクトから名前を取得することができます。

特定のアトリビュートに対して、すべてのプリミティブにそのアトリビュート値を設定します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

アトリビュート名が無効だったり、アトリビュートが文字列でない、または値の配列が正しいサイズでない場合は、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.primStringAttribValuesも参照してください。

このオブジェクト内のジオメトリと光線の交点を求めます。

# SOPノードからジオメトリを取得します。
geometry = hou.node("/obj/geo1/sphere1").geometry()
# "天井"から原点にまっすぐ下に向いて光線を放射します。
origin = hou.Vector3(0, 100, 0)
direction = hou.Vector3(0, -1, 0)
# intersect()メソッドに渡すオブジェクトを作成します。
position = hou.Vector3()
normal = hou.Vector3()
uvw = hou.Vector3()
# 最初の交点(存在すれば)を求めます。
did_intersect = geometry.intersect(origin, direction, position, normal, uvw)

光線がジオメトリと交差した場合は当たったプリミティブのID番号が返され、光線が当たらなかった場合は-1を返します。

hit_positions = []
prev_dist = 0.01
while geometry.intersect(origin, direction, position, normal, uvw,
                         min_hit=prev_dist):
    # ループを反復させる度にmin_hitを変更できるように、交点の *コピー* を格納する必要があります。
    hit_positions.append(hou.Vector3(position))
    prev_dist = origin.distanceTo(position) + 0.01

頂点番号のパターンに相当する頂点のタプルを返します。

パターンフォーマットは、頂点選択を受け取るSOPノード上のグループフィールドで使われているものと同じフォーマットです。 詳細は、hou.Geometry.globPointsを参照してください。

すべての頂点の指定したアトリビュートの値を含んだfloatのタプルを返します。

このメソッドは、intまたはfloatのアトリビュートでのみ動作します。 指定したアトリビュートに2つ以上の要素が含まれている場合、各頂点は、その結果の複数値に呼応します。 例えば、“attrib”がサイズ3のfloatアトリビュートで、(0.1, 0.2, 0.3), (0.5, 0.5, 0.5), (0.8, 0.7, 0.6)の3つの頂点があれば、 その結果は、(0.1, 0.2, 0.3, 0.5, 0.5, 0.5, 0.8,0.7, 0.6)になります。

このメソッドのコールは、hou.Vertex.attribValueコールですべての頂点をループさせるよりも高速です。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)は、このメソッドは、hou.OperationFailedを引き起こします。

アトリビュートを扱う他の多くのメソッドのように、hou.Attribオブジェクトをこのメソッドに渡すことが出来ないことに注意してください。 とはいえ、hou.Attrib.nameを使用すれば、簡単にAttribオブジェクトから名前を取得することができます。

すべての頂点のfloatアトリビュート値を表現したバイナリ文字列を返します。 このメソッドはhou.Geometry.vertexFloatAttribValuesよりも高速で、arrayモジュールを使用することで、その文字列をPythonシーケンスに変換することができます。

返されるバイナリ文字列は、Python3だとbytesオブジェクト、Python2だとstrオブジェクトです。 詳細は、HOMバイナリデータを参照してください。

このメソッドは、以下の実装によって高速化しています:

import array
def vertexFloatAttribValuesAsString(self, name):
    return array.array("f", self.vertexFloatAttribValues(name)).tostring()

このメソッドからの戻り値を以下のメソッドを使用して配列に変換することができます:

import array
def vertexFloatAttribValuesAsArray(geometry, name):
    a = array.array("f")
    a.fromstring(geometry.vertexFloatAttribValuesAsString(name))
    return a

詳細は、hou.Geometry.vertexFloatAttribValuesを参照してください。

特定のアトリビュートに対して、すべての頂点のアトリビュート値を設定します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)や、値の配列が正しいサイズでない場合は、 このメソッドは、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.vertexFloatAttribValuesも参照してください。

特定のアトリビュートに対して、指定したfloat_type値のシーケンスの文字列表現からすべての頂点にアトリビュート値を設定します。 このメソッドは、hou.Geometry.setVertexFloatAttribValuesよりも高速です。

このメソッドは、文字列だけでなく他のタイプも受け入れることができます。つまりバッファインターフェースに対応したPythonオブジェクトを受け取ることができます。 特に、arrayとnumpyのPythonモジュールからの配列がサポートされているので、それらの配列から文字列を構築する必要がありません。

文字列の長さがlen(self.iterVertexs() * byte_size_of_float_type)でない場合は、hou.OperationFailedを引き起こします。

詳細は、hou.Geometry.setVertexFloatAttribValuesとhou.Geometry.vertexFloatAttribValuesAsStringを参照してください。

以下のサンプルの関数は、array.array("f")を受け取り、そのアトリビュート値をその内容に設定します:

def setVertexFloatAttribValuesFromArray(geometry, arr):
    assert(arr.typecode == "f")
    geometry.setVertexFloatAttribValuesFromString(arr))

すべての頂点の指定したアトリビュートの値を含んだ整数のタプルを返します。

このメソッドは、intまたはfloatのアトリビュートでのみ動作します。 指定したアトリビュートに2つ以上の要素が含まれている場合、各頂点は、その結果の複数値に呼応します。 例えば、“idmap”がサイズ2の整数アトリビュートで、(1, 2), (2, 3), (3, 4)の3つの頂点があれば、 その結果は、(1, 2, 2, 3, 3, 4)になります。

このメソッドのコールは、hou.Vertex.attribValueコールですべての頂点をループさせるよりも高速です。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)は、このメソッドは、hou.OperationFailedを引き起こします。

アトリビュートを扱う他の多くのメソッドのように、hou.Attribオブジェクトをこのメソッドに渡すことが出来ないことに注意してください。 とはいえ、hou.Attrib.nameを使用すれば、簡単にAttribオブジェクトから名前を取得することができます。

すべての頂点の整数アトリビュート値を表現したバイナリ文字列を返します。 このメソッドはhou.Geometry.vertexIntAttribValuesよりも高速で、arrayモジュールを使用することで、その文字列をPythonシーケンスに変換することができます。

返されるバイナリ文字列は、Python3だとbytesオブジェクト、Python2だとstrオブジェクトです。 詳細は、HOMバイナリデータを参照してください。

このメソッドは、以下の実装によって高速化しています:

import array
def vertexIntAttribValuesAsString(self, name):
    return array.array("i", self.vertexIntAttribValues(name)).tostring()

このメソッドからの戻り値を以下のメソッドを使用して配列に変換することができます:

import array
def vertexIntAttribValuesAsArray(geometry, name):
    a = array.array("i")
    a.fromstring(geometry.vertexIntAttribValuesAsString(name))
    return a

詳細は、hou.Geometry.vertexIntAttribValuesを参照してください。

特定のアトリビュートに対して、すべての頂点のアトリビュート値を設定します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

アトリビュート名が無効な場合や、アトリビュートがintまたはfloatでない場合(例えば、文字列アトリビュート)や、値の配列が正しいサイズでない場合は、 このメソッドは、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.vertexIntAttribValuesも参照してください。

特定のアトリビュートに対して、指定したint_type値のシーケンスの文字列表現からすべての頂点にアトリビュート値を設定します。 このメソッドは、hou.Geometry.setVertexIntAttribValuesよりも高速です。

このメソッドは、文字列だけでなく他のタイプも受け入れることができます。つまりバッファインターフェースに対応したPythonオブジェクトを受け取ることができます。 特に、arrayとnumpyのPythonモジュールからの配列がサポートされているので、それらの配列から文字列を構築する必要がありません。

文字列の長さがlen(self.iterVertexs() * byte_size_of_int_type)でない場合は、hou.OperationFailedを引き起こします。

詳細は、hou.Geometry.setVertexIntAttribValuesとhou.Geometry.vertexIntAttribValuesAsStringを参照してください。

以下のサンプルの関数は、sizeof(signed int) == 4と仮定してarray.array("i")を受け取り、そのアトリビュート値をその内容に設定します:

def setVertexIntAttribValuesFromArray(geometry, arr):
    assert(arr.typecode == "i")
    geometry.setVertexIntAttribValuesFromString(arr))

すべての頂点の指定したアトリビュートの値を含んだ文字列のタプルを返します。

このメソッドは、文字列アトリビュートでのみ動作します。 指定したアトリビュートに2つ以上の要素が含まれている場合、各頂点は、その結果の複数値に呼応します。 例えば、“strmap”がサイズ2の文字列アトリビュートで、(“apple”, “orange”), (“red”, “blue”), (“one”, “two”)の3つの頂点があれば、 その結果は、(“apple”, “orange”, “red”, “blue”, “one”, “two”)になります。

このメソッドのコールは、hou.Vertex.attribValueコールですべての頂点をループさせるよりも高速です。

アトリビュート名が無効な場合や、アトリビュートが文字列アトリビュートでない場合、このメソッドはhou.OperationFailedを引き起こします。

アトリビュートを扱う他の多くのメソッドのように、hou.Attribオブジェクトをこのメソッドに渡すことが出来ないことに注意してください。 とはいえ、hou.Attrib.nameを使用すれば、簡単にAttribオブジェクトから名前を取得することができます。

特定のアトリビュートに対して、すべての頂点にそのアトリビュート値を設定します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

アトリビュート名が無効だったり、アトリビュートが文字列でない、または値の配列が正しいサイズでない場合は、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.vertexStringAttribValuesも参照してください。

bgeoフォーマットのジオメトリデータを返します。

例:

geometry = hou.node("/obj/geo1/torus1").geometry()
bgeo_data = geometry.data()
open("/tmp/torus.bgeo", "wb").write(bgeo_data)

bgeoバイトをこのオブジェクトに読み込みます。

例:

torus = hou.node("/obj/geo1/torus1").geometry()
bgeo_data = torus.data()

geometry = hou.Geometry()
geometry.load(bgeo_data)

ジオメトリオブジェクトの内容をファイルに保存します。ファイルの拡張子は、使用するファイルフォーマットで決まります。

GEOioでリストされている拡張子を含むHoudiniでサポートされているファイルフォーマット(例えば、geo, bgeo, objなど)がサポートされています。 ファイルの拡張子が認識できなかった場合、bgeoフォーマットが使用されます。

ファイルのパスが無効または権限エラーや他のI/Oエラーがあった場合は、hou.OperationFailedを引き起こします。

このジオメトリオブジェクトの内容をファイルに保存されたデータに置換します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

HoudiniのFile SOPでサポートされているファイルのタイプを指定することができます。 詳細は、hou.Geometry.saveToFileを参照してください。

ファイルが存在しない、またはファイルを読み込むことができなかった場合は、hou.OperationFailedを引き起こします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.mergeも参照してください。

このジオメトリオブジェクトからすべてを削除します。 このメソッドをコールした後は、ジオメトリにはポイントやプリミティブがなくなります。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

他のhou.Geometryオブジェクトのポイントとプリミティブをこのオブジェクトにマージします。 新しいポイントとプリミティブが、このジオメトリのポイントとプリミティブに追加されます。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

空っぽのGeometryオブジェクトにマージする時は、clone_data_idsには、その結果のアトリビュートに同じデータIDを持たせるかどうかを指定します。 Trueの場合、これは、アトリビュートデータIDが同じジオメトリオブジェクトからコピーされたものなのかどうかに関係なく、そのアトリビュートデータIDのみを調べてデータをキャッシュ化するといった最適化を有効にするのに役立ちます。 Falseの場合、コピーしたアトリビュートのデータIDは固有になります。

オプションのprimsパラメータには、マージするプリミティブのサブセットをもっと正確に指定できるようにhou.Selectionを使用します。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.loadFromFileも参照してください。

他のhou.Geometryオブジェクトのポイントとプリミティブをこのオブジェクトにコピーします。 これは、アトリビュートとプリミティブの再割り当てを回避するので、clear()やmerge()よりも高速です。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

空っぽのGeometryオブジェクトにマージする時は、clone_data_idsには、その結果のアトリビュートに同じデータIDを持たせるかどうかを指定します。 Trueの場合、これは、アトリビュートデータIDが同じジオメトリオブジェクトからコピーされたものなのかどうかに関係なく、そのアトリビュートデータIDのみを調べてデータをキャッシュ化するといった最適化を有効にするのに役立ちます。 Falseの場合、コピーしたアトリビュートのデータIDは固有になります。

オプションのprimsパラメータには、コピーするプリミティブのサブセットをもっと正確に指定できるようにhou.Selectionを使用します。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

hou.Geometry.loadFromFileも参照してください。

myselfを1番目の入力としてverb.execute()を呼び出し、その結果のジオメトリを返します。 これによって、一連のVerbの呼び出しをチェーン化することができます: geo.execute(subdivide).execute(subdivide)。

オプションの入力は、ジオメトリ自体を前に追加します。

指定したLOPのステージからプリミティブをパックプリミティブとしてインポートします。

このメソッドで作成されたパックプリミティブがこのジオメトリオブジェクトに含まれている限り、スコープ内に保持すべきhou.LopLockedStageオブジェクトを返します。 このhou.LopLockedStageオブジェクトの削除を許可すれば、USDパックプリミティブを表示またはアンパックされなくなります。

プリミティブは、hou.LopSelectionRuleに応じて選択されます。

purpose引数を指定した場合、そのpurposeを持ったプリミティブのみがインポートされます。

traversal引数を指定した場合、hou.LopSelectionRuleで指定されたプリミティブの子が、指定した走査方法で走査されます。 この引数に指定可能な値は、例えば、std:component, std:boundables, std:groupsです。

path_attrib_name引数を指定した場合、その名前のアトリビュートに各LOPプリミティブのパスが格納されます。

name_attrib_name引数を指定した場合、その名前のアトリビュートに各LOPプリミティブの名前が格納されます。

strip_layers引数がTrueの場合、要求したLOPノードに直接的または間接的に接続されたLayer Breakノードより上にあるレイヤーをUSDステージから除外した後に、そのステージをインポートします。 これは、Layer Breakノードを使って、(Layer Breakノードの上のステージに追加された)変更すべきでないプリミティブとは別に(そのLayer Breakノードの下に追加した)変更可能なデータを維持したい場合に役立ちます。

frame引数を指定した場合、その指定されたサンプルでのLOPが評価されます。 Noneのままにすると、代わりに現在の評価タイムサンプルが使用されます。

Imports primitives from a USD Stage as packed primitives.

このメソッドで作成されたパックプリミティブがこのジオメトリオブジェクトに含まれている限り、USDステージはスコープ内に保持されている必要があります。 Stageオブジェクトの破壊を許可すると、USDパックプリミティブが表示もアンパックもされないようにすることができます。

プリミティブは、hou.LopSelectionRuleに応じて選択されます。

purpose引数を指定した場合、そのpurposeを持つプリミティブのみが取り込まれます。

traversal引数を指定した場合、その走査方法によって、hou.LopSelectionRuleで指定されたプリミティブの子プリミティブが走査されます。 traversalに指定可能な値は例えば、std:component、std:boundables、std:groupsです。

path_attrib_name引数を指定した場合、各LOPプリミティブのパスがその名前のアトリビュートに格納されます。

name_attrib_name引数を指定した場合、各LOPプリミティブの名前がその名前のアトリビュートに格納されます。

frame引数を指定した場合、指定されたサンプルでステージからタイムサンプルが抽出されます。 Noneのままにすると、代わりにHoudiniの現在の評価タイムサンプルが使用されます。

トランスフォームマトリックスでジオメトリをトランスフォーム(例えば、回転、スケール、移動など)します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

トランスフォームマトリックスを構築する関数に関しては、hou.hmathを参照してください。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

トランスフォームマトリックスでプリミティブのセットをトランスフォーム(例えば、回転、スケール、移動など)します。 通常では、Python定義のSOPのコードからこのメソッドをコールします。

このジオメトリが変更不可であれば、hou.GeometryPermissionErrorを引き起こします。

import math

# このコードは、Python SOP内から動作しますが、Pythonシェルからは動作しません。

def createCircle(geo, num_vertices=10):
    # 指定した頂点数で閉じたカーブを作成します。
    curve = geo.createNURBSCurve(num_vertices)
    curve.setIsClosed(True)

    # ポイントをXZ平面上の原点を中心としたユニット円に配置します。
    for i, vertex in enumerate(curve.vertices()):
        angle = i * (2.0 * math.pi) / num_vertices
        position = (math.cos(angle), 0, math.sin(angle))
        vertex.point().setPosition(position)
    return curve

# XY平面上にたくさんの円を作成し、それらの円をX軸で若干傾け、原点から移動させ、Y軸でそれぞれの円を1度ずつ回転させます。
geo = hou.pwd().geometry()
num_copies = 20
for i in range(num_copies):
    curve = createCircle(geo)
    geo.transformPrims([curve],
        hou.hmath.buildRotateAboutAxis((1, 0, 0), 30) *
        hou.hmath.buildTranslate((2, 0, 0)) *
        hou.hmath.buildRotateAboutAxis((0, 1, 0), i * 360.0 / num_copies))

primsパラメータで指定したプリミティブに繋がったパスを作成するhou.Primオブジェクトのタプルを返します。 複数のパスが返される場合は、それらがNoneの値によって単一の戻りタプルに分けられます。 ビューポート内でループ選択を実行する時に使用される同じアルゴリズムを使用してパスが生成されます。

指定したコンポーネントからループを構築することができなかった場合は、hou.OperationFailedを引き起こします。

pointsパラメータで指定したポイントに繋がったパスを作成するhou.Pointオブジェクトのタプルを返します。 複数のパスが返される場合は、それらがNoneの値によって単一の戻りタプルに分けられます。 ビューポート内でループ選択を実行する時に使用される同じアルゴリズムを使用してパスが生成されます。

指定したコンポーネントからループを構築することができなかった場合は、hou.OperationFailedを引き起こします。

edgesパラメータで指定したポイントに繋がったパスを作成するhou.Edgeオブジェクトのタプルを返します。 複数のパスが返される場合は、それらがNoneの値によって単一の戻りタプルに分けられます。 ビューポート内でループ選択を実行する時に使用される同じアルゴリズムを使用してパスが生成されます。

指定したコンポーネントからループを構築することができなかった場合は、hou.OperationFailedを引き起こします。

指定したポイントのポイント法線を表現したhou.Vector3オブジェクトのタプルを返します。

このジオメトリに関係する現在のクックコンポーネント選択を返します。 これは、そのジオメトリを作成したSOPで設定されたデフォルトの選択です。

指定したパターンに合致したすべてのパックプリムファイルのパスを返します。 hou.Geometry.unpackFromFolderとhou.Geometry.packToFolderも参照してください。

指定したパスのファイルからアンパックされたジオメトリを返します。 hou.Geometry.packToFolderとhou.Geometry.extractPackedPathsも参照してください。

指定したpathのフォルダにgeometryを詰め込みます。 is_folderがTrueの場合、geometryはパックコンテンツが含まれたフォルダとして扱われます。 成功すればTrueを返します。 指定したパスを作成できなかった場合は失敗します。 hou.Geometry.unpackFromFolderとhou.Geometry.extractPackedPathsも参照してください。

指定したpathのフォルダプロパティを含んだ辞書を返します。 この辞書には2個のエントリーが含まれています: “visible”キーのエントリーには、パックプリミティブが_3d_hidden_primitivesグループに含められているかどうかのブール値が入ります。“treat_as_folder”キーのエントリーには、プリミティブがパックコンテンツを含んだフォルダとして扱われているかどうかのブール値が入ります。