UnityにおけるRayの可視化方法とマウス入力の活用

2025年3月19日

Unityの開発において、Rayの可視化はデバッグや動作確認に非常に有効です。本資料では、基本的なRayの可視化手法に加え、ユーザーのマウス位置から生成されるRayの可視化方法について詳しく解説します。

1. 1. Debug.DrawRay を利用した基本的なRayの可視化
- 1.1. サンプルコード
- 1.2. 特徴
2. 2. Gizmos を利用した常時表示の可視化
- 2.1. サンプルコード
- 2.2. 特徴
3. 3. マウス位置から生成されるRayの可視化
4. 結論

1. Debug.DrawRay を利用した基本的なRayの可視化

Debug.DrawRay は、実行中にシーンビューへRay（線）を描画するためのメソッドです。これにより、オブジェクトの向きやRayキャストの方向をリアルタイムで確認することができます。

サンプルコード

using UnityEngine;

public class BasicRayVisualizer : MonoBehaviour
{
    public Vector3 direction = Vector3.forward;  // 表示するRayの方向
    public float length = 10f;                     // Rayの長さ
    public Color rayColor = Color.red;             // Rayの色

    void Update()
    {
        // オブジェクトの位置から指定方向へRayを描画
        Debug.DrawRay(transform.position, direction.normalized * length, rayColor);
    }
}

特徴

リアルタイム更新: 毎フレーム更新され、動的な状況にも対応可能です。
エディタ限定表示: シーンビューでのみ表示され、実際のゲーム画面（Gameビュー）には反映されません。

2. Gizmos を利用した常時表示の可視化

Gizmos を使用することで、シーンビューに常時Rayを描画することができます。OnDrawGizmos は常に、OnDrawGizmosSelected はオブジェクトが選択されている場合のみ表示されるため、用途に応じた可視化が可能です。

サンプルコード

using UnityEngine;

public class GizmoRayVisualizer : MonoBehaviour
{
    public Vector3 direction = Vector3.forward; // 表示するRayの方向
    public float length = 10f;                    // Rayの長さ
    public Color gizmoColor = Color.green;        // Rayの色

    void OnDrawGizmos()
    {
        Gizmos.color = gizmoColor;
        Gizmos.DrawRay(transform.position, direction.normalized * length);
    }
}

特徴

常時表示: エディタのシーンビューに常に描画され、オブジェクトの状態を継続的に確認できます。
選択時表示: OnDrawGizmosSelected を使用すれば、オブジェクトが選択されたときのみ可視化することも可能です。

3. マウス位置から生成されるRayの可視化

ユーザーのマウス位置に基づいてカメラから生成されるRayを可視化することで、ユーザーインタラクションに合わせたデバッグが可能になります。特に、Camera.main.ScreenPointToRay(Input.mousePosition) を利用して生成されるRayを表示する方法について解説します。

サンプルコード

using UnityEngine;

public class MouseRayVisualizer : MonoBehaviour
{
    public float rayLength = 100f;       // 可視化するRayの長さ
    public Color rayColor = Color.yellow;  // Rayの色

    void Update()
    {
        // カメラからマウス位置へRayを生成
        Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);
        // 生成したRayをデバッグ表示
        Debug.DrawRay(ray.origin, ray.direction * rayLength, rayColor);
    }
}

解説

Rayの生成
Camera.main.ScreenPointToRay(Input.mousePosition) により、カメラの位置からマウスのスクリーン座標に向かうRayを生成します。
デバッグ表示
Debug.DrawRay を用い、生成したRayの起点 (ray.origin) から方向 (ray.direction) に沿って指定した長さの線をシーンビューに描画します。

注意点

シーンビュー限定: これらのデバッグ表示はシーンビュー上でのみ確認可能です。ゲーム画面（Gameビュー）で表示させたい場合は、Line Renderer の利用などを検討してください。
デバッグ用途: 本手法は主にデバッグや検証の目的で利用され、リリースビルド時には不要なコードとなるため、適宜削除することが推奨されます。