mieki256's diary

ImmediateMesh を使うと、動的にポリゴンモデルを作成して描画することができる。使い方は OpenGL 1.x の glBegin - glEnd に似ている。begin と end の間でプリミティブの座標群を指定すると描画される感じ。

_Using ImmediateMesh - Godot Engine (stable) documentation in English
_ImmediateMesh - Godot Engine (stable) documentation in English

ノードとして ImmediateMesh があるのかなと思ったけれど、そうではないらしい。MeshInstance3D ノードを用意して、その MeshInstance3D の Mesh に ImmediateMesh を追加する。

とりあえずサンプルを書いてみた。

ノード構成は以下。

Node3D
├─ Camera3D           ← カメラ。これを忘れると画面に何も描画されない
├─ DirectionalLight3D ← 平行光源
├─ MeshInstance3D     ← 床box
├─ MeshInstance3D_2   ← ここに ImmediateMesh を追加する
└─ MeshInstance3D_3   ← 球

スクリプトソースは以下。

_mesh_instance_3d_2.gd

extends MeshInstance3D

var mat: StandardMaterial3D
var ang: float = 0.0

# Called when the node enters the scene tree for the first time.
func _ready():
    mat = StandardMaterial3D.new()
    mat.albedo_color = Color(0, 1, 0, 0.5)
    mat.cull_mode = BaseMaterial3D.CULL_DISABLED
    mat.transparency = BaseMaterial3D.TRANSPARENCY_ALPHA
    mat.shading_mode = BaseMaterial3D.SHADING_MODE_UNSHADED
        
    mesh = ImmediateMesh.new()


func _process(delta):
    var x0: float = 0.0
    var y0: float
    var z0: float
    var h: float = 5.0

    mesh.clear_surfaces()
    mesh.surface_begin(Mesh.PRIMITIVE_TRIANGLES, mat)
    mesh.surface_set_color(Color.WHITE)
    
    y0 = h * sin(deg_to_rad(ang))
    z0 = 10.0
    for i in range(1, 20, 1):
        var y1 = h * sin(deg_to_rad(ang + 10 * i))
        var z1 = z0 - 1.5
        mesh.surface_add_vertex(Vector3(x0, y1, z1))
        mesh.surface_add_vertex(Vector3(x0 + 1, y0, z0))
        mesh.surface_add_vertex(Vector3(x0 - 1, y0, z0))
        y0 = y1
        z0 = z1
    
    mesh.surface_end()
    
    ang += 120.0 * delta
    if ang >= 360.0:
        ang -= 360.0

実行するとこんな感じの画面になる。緑色で描画されてる三角ポリゴン群が、ImmediateMesh で描画している部分。Sin値を使って座標群を毎フレーム変化させている。




ここまでできれば、後は形状を工夫することでボールの軌跡っぽいものも描画できそう。

マテリアルの指定は、StandardMaterial3D を使った。StandardMaterial3D.new() で確保して、色々指定していく。

• albedo_color で基本色を指定できる。Color(R, G, B, A) で指定。RGBA は 0.0 - 1.0 を与える。
• cull_mode で片面を描画するか、両面を描画するかを変更できる。BaseMaterial3D.CULL_DISABLED を指定すると両面を描画。
• transparency で、半透明描画を指定できる。BaseMaterial3D.TRANSPARENCY_ALPHA でアルファ値が反映される…のだろうか？
• shading_mode で、陰影の有無を指定できる。BaseMaterial3D.SHADING_MODE_UNSHADED で陰影無し。

MeshInstance3D の mesh に、ImmediateMesh.new() で確保した ImmediateMesh を指定する。

• mesh.clear_surfaces() ... 今までの描画内容をクリア
• mesh.surface_begin(Mesh.PRIMITIVE_TRIANGLES, mat) ... 描画内容の指定を開始。PRIMITIVE_TRIANGLES は三角形ポリゴンを指定。mat はマテリアル。マテリアルの指定は省略できる。
• mesh.surface_set_color(Color.WHITE) ... 色を指定。ただ、今回はマテリアル側で色を指定しちゃってるので、この指定は無視された。
• mesh.surface_add_vertex(Vector3(x0, y1, z1)) ... 頂点座標を1つ指定。
• mesh.surface_end() ... 描画内容の指定を終了。

標準機能で似たようなことをしたい際は、以下のような手順になるらしい。3Dカーソルを一時的に使って目的を果たす模様。

_【Blender】原点を移動させる｜yugaki

1. オブジェクトを選択して、編集モードに切替 (TABキー)。
2. 原点を移動させたい面を選択。
3. Shift+S でパイメニューを出して、カーソル→選択物。もしくは、メッシュ → スナップ → カーソル→選択物。これで3Dカーソルの位置が変更される。
4. オブジェクトモードに切替 (TABキー)
5. オブジェクト → 原点を設定 → 原点を3Dカーソルへ移動。

移動してしまった3Dカーソルをワールド原点に戻すには以下の操作を行う。

• Shift+C
• あるいは、Shift+S でパイメニューを出して、カーソル → ワールド原点。
• もしくは、オブジェクトモードで、オブジェクト → スナップ → カーソル→ワールド原点。