イントロダクション - actnwit/RhodoniteTS GitHub Wiki

Rhodoniteとは

Rhodonite（ロードナイト）はTypeScriptで書かれたWeb3Dライブラリです。

Rhodoniteの特徴

コンポーネント指向

Unityゲームエンジンなどにもみられるコンポーネント指向設計を採用しています。３D空間上における実体であるエンティティに各種コンポーネントを搭載させることにより、「物体」に機能をもたせます。

コンポーネントは「物体」に能力を与える、各種機能の最小限の単位であり、TypeScriptのクラスで表されます。　機能の単位であるコンポーネントを入れ物であるエンティティに搭載させることで機能を増やしていきます。

このアプローチは古典的なクラス継承プログラミングよりも柔軟性やコードメンテナンス性においてより優れています。今日のゲームエンジンで主流の設計アプローチです。

ブリッタブルメモリアーキテクチャ

Rhodoniteのコンポーネントクラスの各メンバ変数は、メモリ的に連続しています。

Rhodoniteは最初に巨大なArrayBufferのメモリプールを取得し、そのプールからコンポーネントの各フィールドメンバーにメモリをアサインします。各フィールドメンバーは、エンティティ間でメモリ連続である（他のメモリレイアウトを取ることも潜在的には可能です）ため、CPUのキャッシュメモリのヒット率向上に貢献しています。

また、この巨大なメモリプールをレンダリング前にGPUへテクスチャとして一気に送信し、複数メッシュをインスタンス描画することで高速なシーン描画を行うことができます。各エンティティが描かれる位置情報やマテリアル情報などは、シェーダーがそのテクスチャから取得します。これをRhodoniteではブリッタブルメモリアーキテクチャと呼んでいます。

WebGLではUniform変数の更新が常に性能上の大きなボトルネックになります。ブリッタブルメモリアーキテクチャでは、setUniformを使わずに全てのデータをテクスチャとしてGPUに一気に送りこむため、このボトルネックを回避できます。

この仕組みは、比較的少ないポリゴン数で、多くのジオメトリバッチを大量に描画（インスタンス描画）しなければならない場合に特に高い性能を発揮します。非インスタンス描画の場合でも、重たいsetUniform系の処理を回避できるため、通常の描画方法よりも多くのケースで高性能です。

また、ゲームなどのように、複雑かつ大量のデータにシェーダーがアクセスしなければならない場合にも適しています。

Rhodoniteことはじめ

次のリスト1-1は、現時点でのRhodoniteにおけるポリゴン表示のための最小コードです。

async function main() {

    // Rhodoniteの初期化。描画処理方法（今回はUniform）と描画先canvasを指定
    await Rn.System.init({
      approach: Rn.ProcessApproach.Uniform,
      canvas: document.getElementById('world')
    });

    // Component搭載済みEntityの作成
    const firstEntity = Rn.EntityHelper.createMeshEntity();

    // 頂点データの作成
    const indices = new Float32Array([
        0, 1, 3, 3, 1, 2
    ]);

    const positions = new Float32Array([
        -1.5, -0.5, 0.0,
        -0.5, -0.5, 0.0,
        -0.5, 0.5, 0.0,
        -1.5, 0.5, 0.0
    ]);

    const colors = new Float32Array([
        0.0, 1.0, 1.0,
        1.0, 1.0, 0.0,
        1.0, 0.0, 0.0,
        0.0, 0.0, 1.0
    ]);

    // 頂点データを指定してPrimitiveオブジェクトを作成
    const primitive = Rn.Primitive.createPrimitive({
        indices: indices,
        attributeSemantics: [VertexAttribute.Position.XYZ, VertexAttribute.Color0.XYZ],
        attributes: [positions, colors],
        material: void 0,
        primitiveMode: PrimitiveMode.Triangles
    });

    // EntityのMeshコンポーネントにPrimitiveを追加
    const meshComponent = firstEntity.getMesh();
    const mesh = new Rn.Mesh();
    mesh.addPrimitive(primitive);
    meshComponent.setMesh(mesh);

    // 描画する。
    // Entityの存在は作成した時点でRhodoniteが内部的に把握しているため、プログラマが明示的にシステムにEntityを登録する必要はありません。
    const draw = function(time) {
        Rn.system.processAuto();
        requestAnimationFrame(draw);
    }

    draw();
}

List 1-1

Primitiveクラスの設計はglTF2フォーマットに概念的に合うよう設計されています。