OnRenderObject()の解説資料

2025年5月14日

概要

OnRenderObject() は Unity の MonoBehaviour に用意されている特殊なイベントメソッドで、オブジェクトの描画タイミングで呼び出される関数です。主にカスタム描画処理（GL, Graphics API）を記述する際に使用されます。

呼び出しタイミングと特徴

主な用途

• ワイヤーフレームやデバッグ用のライン描画
• GL クラスを使った低レベル描画
• CommandBuffer を使わない軽量カスタム描画処理
• 複数カメラに対して別の描画処理をしたいとき

使用例：GLを使ってラインを描画

using UnityEngine;

public class RenderLine : MonoBehaviour
{
    public Material lineMaterial;

    void OnRenderObject()
    {
        if (lineMaterial == null) return;

        lineMaterial.SetPass(0);

        GL.Begin(GL.LINES);
        GL.Color(Color.red);
        GL.Vertex3(-1.0f, 0.0f, 0.0f);
        GL.Vertex3(1.0f, 0.0f, 0.0f);
        GL.End();
    }
}

補足：

• lineMaterial.SetPass(0) は描画シェーダーのパス指定です。
• GL.Begin() ～ GL.End() の中で描画内容を定義します。
• 実行対象となるオブジェクトにこのスクリプトをアタッチし、lineMaterial に適切なシェーダー（Unlitなど）を割り当てる必要があります。

他の描画系イベントとの比較

注意点

• メッシュ描画とは異なり、GL 描画はバッチ処理の対象外になるため、描画コストが高くなる可能性があります。
• 描画結果が意図しないカメラにも適用されることがあるため、カメラのフィルタリングに注意が必要です（例：Camera.current の利用）。
• URP/HDRPでは正しく動作しないこともあり、ScriptableRenderPassの利用が推奨されるケースもあります。

まとめ

• OnRenderObject() は低レベル描画が必要なときに使う強力なフックポイント。
• 一般的なゲームオブジェクトの表示とは異なり、シェーダー、マテリアル、描画順序への理解が不可欠。
• プロファイルやフレームレートに注意しながら使用することが重要です。

この資料に含めたいサンプルやGL描画例をさらに追加したい場合はお知らせください。より実践的な応用資料も作成可能です。

    ┌────────────────────┐
    │ Update()           │ ← ロジック処理
    └────────────────────┘
              ↓
    ┌────────────────────┐
    │ OnWillRenderObject()│ ← カメラごとの事前処理
    └────────────────────┘
              ↓
    ┌────────────────────┐
    │ OnRenderObject()    │ ← GL描画などユーザー描画の指示
    └────────────────────┘
              ↓
    ┌────────────────────┐
    │ OnRenderImage()     │ ← ポストエフェクト（RenderTexture 必須）
    └────────────────────┘
              ↓
    ┌────────────────────┐
    │ OnPostRender()      │ ← カメラ描画完了直後
    └────────────────────┘