ArrayMeshの使用

このチュートリアルでは、 ArrayMesh の使用の基本について説明します。

そのためには、最大5つのパラメータを取る関数 add_surface_from_arrays() を使用します。最初の2つは必須ですが、残りの3つはオプションです。

1つ目は PrimitiveType です。これは指定された頂点に基づいてプリミティブをどのように配置するか、つまり頂点が三角形、線、点など、どれを表すかを GPU に指示する OpenGL の概念です。使用可能なオプションについては Mesh.PrimitiveType を参照してください。

2番目のパラメータ arrays はメッシュ情報を格納する実際の配列です。配列は空の括弧 [] で構成された通常のGodot配列です。サーフェスの構築に使用される情報の種類ごとに、 Packed**Array (例: PackedVector3Array、PackedInt32Array など) を格納します。

arrays の共通要素と、それが arrays 内で指定する位置を以下に示します。完全なリストは Mesh.ArrayType を参照してください。

インデックス	Mesh.ArrayType	配列タイプ
0	ARRAY_VERTEX	PackedVector3Array または PackedVector2Array
1	ARRAY_NORMAL	PackedVector3Array
2	ARRAY_TANGENT	PackedFloat32Array または PackedFloat64Array の4つのfloatのグループ。最初の3つのfloatは接線を決定し、最後のfloatは従法線方向を -1 または 1 として指定します。
3	ARRAY_COLOR	PackedColorArray
4	ARRAY_TEX_UV	PackedVector2Array または PackedVector3Array
5	ARRAY_TEX_UV2	PackedVector2Array または PackedVector3Array
10	ARRAY_BONES	4つのfloatのグループの PackedFloat32Array 。または4つの int のグループの PackedInt32Array。各グループには特定の頂点に影響を与える4つのボーンのインデックスがリストされます。
11	ARRAY_WEIGHTS	PackedFloat32Array または PackedFloat64Array の4つのfloatのグループ。各floatには ARRAY_BONES 内の対応するボーンが特定の頂点に対して持つ重みの量がリストされます。
12	ARRAY_INDEX	PackedInt32Array

ほとんどのケースでメッシュを作成するときは頂点の位置を使ってメッシュを定義します。通常は頂点配列 (index=0) は必須ですが、インデックス配列 (index=12) はオプションであり、含まれている場合にのみ使用されます。インデックス配列のみで頂点配列を使用せずにメッシュを作成することも可能ですが、それはこのチュートリアルでは解説しません。

その他の全ての配列は、頂点に関する情報を保持します。これらもオプションであり、含まれている場合にのみ使用されます。これらの配列の一部 (例: ARRAY_COLOR) は、頂点ごとに1つのエントリを使用して、頂点に関する追加情報を提供します。これらは頂点配列と同じサイズである必要があります。その他の配列 (例: ARRAY_TANGENT) は、1つの頂点を記述するために4つのエントリを使用します。これらは、頂点配列のちょうど4倍の大きさである必要があります。

以上の配列を準備してメッシュを生成するには、関数 add_surface_from_arrays() を使用します。これは最大4つのパラメーターを指定します。始めの2つは必須ですが、残りの2つはオプションです。

ArrayMeshの設定

エディターで MeshInstance3D を作成し、インスペクターでそれに ArrayMesh を追加します。通常、エディターで ArrayMesh を追加しても意味がありませんが、この場合は ArrayMesh を作成しなくてもコードから ArrayMesh にアクセスできるようになります。

続いて、 MeshInstance3D にスクリプトを追加します。

_ready() 下に、新しい配列を作成します。

GDScriptC#

var surface_array = []

これは、サーフェス情報を保持する配列になります。サーフェスに必要なすべてのデータ配列が保持されます。Godot は、サイズが Mesh.ARRAY_MAX であると想定しているため、それに応じてサイズを変更します。

GDScriptC#

var surface_array = []
surface_array.resize(Mesh.ARRAY_MAX)

次に、使用する各データ型の配列を作成します。

GDScriptC#

var verts = PackedVector3Array()
var uvs = PackedVector2Array()
var normals = PackedVector3Array()
var indices = PackedInt32Array()

データ配列にジオメトリを入力したら、各配列を surface_array に追加し、メッシュにコミットすることでメッシュを作成できます。

GDScriptC#

surface_array[Mesh.ARRAY_VERTEX] = verts
surface_array[Mesh.ARRAY_TEX_UV] = uvs
surface_array[Mesh.ARRAY_NORMAL] = normals
surface_array[Mesh.ARRAY_INDEX] = indices

# No blendshapes, lods, or compression used.
mesh.add_surface_from_arrays(Mesh.PRIMITIVE_TRIANGLES, surface_array)

注釈

この例では、Mesh.PRIMITIVE_TRIANGLES を使用しましたが、メッシュから利用可能な任意のプリミティブタイプを使用できます。

完全なコードをまとめると次のようになります:

GDScriptC#

extends MeshInstance3D

func _ready():
    var surface_array = []
    surface_array.resize(Mesh.ARRAY_MAX)

    # PackedVector**Arrays for mesh construction.
    var verts = PackedVector3Array()
    var uvs = PackedVector2Array()
    var normals = PackedVector3Array()
    var indices = PackedInt32Array()

    #######################################
    ## Insert code here to generate mesh ##
    #######################################

    # Assign arrays to surface array.
    surface_array[Mesh.ARRAY_VERTEX] = verts
    surface_array[Mesh.ARRAY_TEX_UV] = uvs
    surface_array[Mesh.ARRAY_NORMAL] = normals
    surface_array[Mesh.ARRAY_INDEX] = indices

    # Create mesh surface from mesh array.
    # No blendshapes, lods, or compression used.
    mesh.add_surface_from_arrays(Mesh.PRIMITIVE_TRIANGLES, surface_array)

中間にあるコードは、あなたが望むものなら何でも構いません。以下に、例として球を生成するコードを示します。

ジオメトリの生成

球体を生成するためのサンプルコードを次に示します。コードはGDScriptで表示されますが、コードを生成する方法についてGodot固有のものはありません。この実装は、ArrayMeshとは特に関係がなく、球体を生成するための一般的なアプローチです。理解に問題がある場合、または手続き型ジオメトリ全般について詳しく知りたい場合は、オンラインで見つけたチュートリアルを使用できます。

GDScriptC#

extends MeshInstance3D

var rings = 50
var radial_segments = 50
var radius = 1

func _ready():

    # Insert setting up the PackedVector**Arrays here.

    # Vertex indices.
    var thisrow = 0
    var prevrow = 0
    var point = 0

    # Loop over rings.
    for i in range(rings + 1):
        var v = float(i) / rings
        var w = sin(PI * v)
        var y = cos(PI * v)

        # Loop over segments in ring.
        for j in range(radial_segments + 1):
            var u = float(j) / radial_segments
            var x = sin(u * PI * 2.0)
            var z = cos(u * PI * 2.0)
            var vert = Vector3(x * radius * w, y * radius, z * radius * w)
            verts.append(vert)
            normals.append(vert.normalized())
            uvs.append(Vector2(u, v))
            point += 1

            # Create triangles in ring using indices.
            if i > 0 and j > 0:
                indices.append(prevrow + j - 1)
                indices.append(prevrow + j)
                indices.append(thisrow + j - 1)

                indices.append(prevrow + j)
                indices.append(thisrow + j)
                indices.append(thisrow + j - 1)

        prevrow = thisrow
        thisrow = point

  # Insert committing to the ArrayMesh here.

保存

最後に、ArrayMesh を保存するために ResourceSaver クラスを使用できます。これは事前にメッシュを生成して保存しておき、後で使用したい場合に便利です。

GDScriptC#

# Saves mesh to a .tres file with compression enabled.
ResourceSaver.save(mesh, "res://sphere.tres", ResourceSaver.FLAG_COMPRESS)