投影デカール開発ガイド

using LCCCore;
using UnityEngine;

/// <summary>
/// デカール投影 — 最小限の開発者向け使用例。
///
/// このスクリプトは「インテグレータースクリプト」をシミュレートします。LCCManager の公開 API のみを呼び出し、SDK 内部には触れません。
/// デカール API 全 7 つをカバー：
///   基本投影（5）: SetDecalEnabled / SetDecalTexture / SetDecalProjection / SetDecalOpacity / SetDecalEdgeFade
///   オクルージョンカリング（2）: SetDecalOcclusion / SetDecalOcclusionSettings
///
/// 使用手順：
///   1) 空の GameObject を作成し、このスクリプトをアタッチします；
///   2) Inspector でシーン内の LCCManager を m_manager へドラッグします；
///   3) m_filePath に有効な LCC シーンパスを設定します；
///   4) 投影する画像を m_decalTexture へドラッグします（インポート設定で Read/Write を有効化することを推奨）；
///   5) 空のオブジェクトを m_projector へドラッグしてプロジェクターとします（空のままにするとこのオブジェクトを使用）。+Z 軸が投影方向です；
///   6) Play します。シーンの読み込み完了後、デカールが自動的にオンになります。プロジェクターをドラッグすると点群上のデカールをリアルタイムに確認できます。
///
/// プラットフォーム注記：デカールとオクルージョンカリングは PC/Mac（URP）でのみ有効です。モバイル/VR での呼び出しは SDK に無視され、警告としてログ出力されます。
/// </summary>
public class Decal : MonoBehaviour
{
    [Header("必須")]
    [Tooltip("シーン内の LCCManager インスタンス")]
    public LCCManager m_manager;
    [Tooltip("有効な LCC シーンパス")]
    public string m_filePath;
    [Tooltip("投影するデカール画像。RGB=カラー、A=デカール自身のマスク")]
    public Texture2D m_decalTexture;

    [Header("プロジェクター（+Z 方向に投影）")]
    [Tooltip("プロジェクターの姿勢。空の場合はこのオブジェクトの Transform を使用")]
    public Transform m_projector;
    [Range(1f, 179f)] public float m_fov = 60f;
    [Tooltip("投影アスペクト比。<=0 の場合はデカール画像のアスペクト比を自動使用")]
    public float m_aspect = 0f;
    public float m_near = 0.1f;
    public float m_far = 100f;

    [Header("デカールの外観")]
    [Range(0f, 1f)] public float m_opacity = 1.0f;
    [Range(0f, 0.5f)][Tooltip("エッジフェード幅（UV 比）。0 = ハードエッジ")]
    public float m_edgeFade = 0.1f;
    [Tooltip("毎フレーム投影を更新し、実行時にプロジェクターのドラッグやパラメータ調整が可能に")]
    public bool m_updateEveryFrame = true;

    [Header("オクルージョンカリング（PC/Mac のみ）")]
    [Tooltip("オンの場合、前面ジオメトリの背後にある背面/遮蔽点はデカールで着色されなくなります（スライドプロジェクター効果）。オフの場合は X 線です")]
    public bool m_occlusion = false;
    [Range(0f, 1f)][Tooltip("不透明度閾値：この値以上の不透明度を持つ Splat のみが深度マップに寄与し、浮遊/霧状の点を除去します。0 = すべて参加")]
    public float m_occlusionCutoff = 0f;
    [Range(0f, 0.5f)][Tooltip("相対深度許容値。小さすぎる -> 近傍サーフェスの自己オクルージョン、大きすぎる -> X 線着色の漏れ。デフォルト 0.05")]
    public float m_occlusionBias = 0.05f;
    [Range(0, 16)][Tooltip("正方形フットプリント半径の上限（px）。X 線の透過漏れを除去する主なノブ。0 = 単一テクセル、デフォルト 2")]
    public int m_occlusionFootprint = 2;
    [Tooltip("深度マップ解像度（px、2 のべき乗 256〜4096）。かすめ角の穴を埋めるには下げます。デフォルト 1024")]
    public int m_occlusionResolution = 1024;

    // -- 実行時状態 --
    private bool m_loaded;
    private bool m_lastOcclusion;
    private float m_lastCutoff = float.NaN;
    private float m_lastBias = float.NaN;
    private int m_lastFootprint = -1;
    private int m_lastResolution = -1;

    void Start()
    {
        if (m_manager == null || string.IsNullOrEmpty(m_filePath))
        {
            Debug.LogError("[DecalDemo] m_manager または m_filePath が割り当てられていません。");
            enabled = false;
            return;
        }

        // 1) レンダーパイプラインを PC 単一シーンのエディターモードに初期化
        m_manager.SetPlatformType(PlatformType.PC);
        m_manager.SwitchRenderPass(ActiveRenderMode.SingleRender);
        m_manager.SetEditorMode(true);

        // 2) 点群シーンを読み込み、完了後にデカールを有効化（デカールはグローバル状態。シーン準備完了後に設定するのが最も安全）
        var renderer = m_manager.GetRender(this.transform);
        Debug.Log($"[DecalDemo] 読み込みを開始: {m_filePath}");
        renderer.Load(m_filePath,
            _ => { /* 進捗コールバック。この例では未使用 */ },
            OnSceneLoaded);
    }

    private void OnSceneLoaded()
    {
        Debug.Log("[DecalDemo] 読み込み完了、デカール投影を有効化します。");

        // -- 基本投影: 5 つの API --
        m_manager.SetDecalTexture(m_decalTexture);   // デカールの内容
        m_manager.SetDecalOpacity(m_opacity);        // 全体の不透明度
        m_manager.SetDecalEdgeFade(m_edgeFade);      // エッジフェード
        ApplyProjection();                           // プロジェクターの姿勢（内部的に SetDecalProjection を呼び出す）
        m_manager.SetDecalEnabled(true);             // デカールを有効化（_DECAL キーワード）

        // -- オクルージョンカリング: 2 つの API -- ApplyProjection の後でなければならない（深度マップには有効なプロジェクター VP が必要）
        m_manager.SetDecalOcclusionSettings(BuildOcclusionSettings());
        m_manager.SetDecalOcclusion(m_occlusion);
        CacheOcclusionState();

        m_loaded = true;
    }

    /// <summary>
    /// デモ専用です。実際のプロジェクトでは、パフォーマンス向上のため Update() で毎フレーム
    /// SetDecalProjection / SetDecalOpacity / SetDecalEdgeFade を呼び出す必要はありません。
    /// パラメータが変更されたときに対応する API を呼び出すだけで十分です。
    /// </summary>
    void Update()
    {
        if (!m_loaded) return;

        // 実行時にオクルージョンを切り替え
        if (m_occlusion != m_lastOcclusion)
        {
            m_manager.SetDecalOcclusion(m_occlusion);
            m_lastOcclusion = m_occlusion;
        }

        // オクルージョン品質パラメータが変更されたら -> 構造体を一度プッシュ
        if (!Mathf.Approximately(m_occlusionCutoff, m_lastCutoff) ||
            !Mathf.Approximately(m_occlusionBias, m_lastBias) ||
            m_occlusionFootprint != m_lastFootprint ||
            m_occlusionResolution != m_lastResolution)
        {
            m_manager.SetDecalOcclusionSettings(BuildOcclusionSettings());
            CacheOcclusionState();
        }

        // 便利なリアルタイムデバッグのため毎フレームプロジェクター / 外観を更新
        if (!m_updateEveryFrame) return;
        m_manager.SetDecalOpacity(m_opacity);
        m_manager.SetDecalEdgeFade(m_edgeFade);
        ApplyProjection();
    }

    /// <summary>現在のプロジェクター姿勢と透視パラメータから投影行列を構築します。</summary>
    private void ApplyProjection()
    {
        Transform p = m_projector != null ? m_projector : this.transform;
        float aspect = m_aspect > 0f
            ? m_aspect
            : (m_decalTexture != null ? (float)m_decalTexture.width / m_decalTexture.height : 1f);
        m_manager.SetDecalProjection(p.position, p.rotation, m_fov, aspect, m_near, m_far);
    }

    /// <summary>4 つのオクルージョンパラメータを構造体にまとめます。</summary>
    private DecalOcclusionSettings BuildOcclusionSettings()
    {
        return new DecalOcclusionSettings
        {
            opacityCutoff  = m_occlusionCutoff,
            depthBias      = m_occlusionBias,
            footprintMaxPx = m_occlusionFootprint,
            resolution     = m_occlusionResolution,
        };
    }

    private void CacheOcclusionState()
    {
        m_lastOcclusion  = m_occlusion;
        m_lastCutoff     = m_occlusionCutoff;
        m_lastBias       = m_occlusionBias;
        m_lastFootprint  = m_occlusionFootprint;
        m_lastResolution = m_occlusionResolution;
    }

    // -- 便利なデバッグエントリポイント（Inspector 右クリック） --
    [ContextMenu("デカール オン")]  private void DecalOn()  { m_manager?.SetDecalEnabled(true); }
    [ContextMenu("デカール オフ")] private void DecalOff() { m_manager?.SetDecalEnabled(false); }
    [ContextMenu("オクルージョン オン")]  private void OcclusionOn()  { m_occlusion = true;  m_manager?.SetDecalOcclusion(true);  m_lastOcclusion = true; }
    [ContextMenu("オクルージョン オフ")] private void OcclusionOff() { m_occlusion = false; m_manager?.SetDecalOcclusion(false); m_lastOcclusion = false; }
}

// 戻り値: void
public void SetDecalEnabled(bool enable)

m_manager.SetDecalEnabled(true);
m_manager.SetDecalTexture(decalTex);
m_manager.SetDecalProjection(projectorPos, projectorRot, 60f, 1.778f, 0.1f, 20f);

// 戻り値: void
public void SetDecalTexture(Texture2D tex)

m_manager.SetDecalTexture(logoTex);

// 戻り値: void
public void SetDecalProjection(Vector3 pos, Quaternion rot, float fov, float aspect, float near, float far)

m_manager.SetDecalProjection(new Vector3(0, 10, 0), Quaternion.Euler(90, 0, 0), 60f, 1.778f, 0.1f, 20f);

// 戻り値: void
public void SetDecalOpacity(float opacity)

m_manager.SetDecalOpacity(0.8f);

// 戻り値: void
public void SetDecalEdgeFade(float edgeFade)

m_manager.SetDecalEdgeFade(0.1f);

// 戻り値: void
public void SetDecalOcclusion(bool enable)

m_manager.SetDecalOcclusion(true);

// 戻り値: void
public void SetDecalOcclusionSettings(DecalOcclusionSettings settings)

m_manager.SetDecalOcclusionSettings(DecalOcclusionSettings.Default);
m_manager.SetDecalOcclusionSettings(new DecalOcclusionSettings {
    opacityCutoff = 0.1f,
    depthBias = 0.05f,
    footprintMaxPx = 2,
    resolution = 1024
});

public struct DecalOcclusionSettings {
    public float opacityCutoff;   // [0,1] Splat が深度マップに参加するための最小不透明度。デフォルト 0（全参加）
    public float depthBias;       // 相対深度許容比率。デフォルト 0.05
    public int   footprintMaxPx;  // 正方形フットプリント半径の上限（px）。0〜16、デフォルト 2
    public int   resolution;      // 深度マップ解像度（px、2 のべき乗、256〜4096）。デフォルト 1024

    public static DecalOcclusionSettings Default { get; } // cutoff=0, bias=0.05, footprint=2, resolution=1024
}