Newer
Older
RobotCar / docs / 03_TECH / TECH_03_デバッグオーバーレイ仕様.txt
========================================================================
デバッグオーバーレイ仕様 (Debug Overlay Specification)
========================================================================


1. 概要 (Overview)
------------------------------------------------------------------------

    1-0. 目的

    画像処理パイプラインの動作を視覚的に確認するためのオーバーレイ
    表示機能を定義する.GUI のチェックボックスで項目ごとに ON/OFF
    できる.

    1-1. 基本方針

    ・オーバーレイはカメラ映像に重ねて描画する.
    ・線検出は接続中は常に実行し,検出情報は映像下のラベルに表示する.
    ・自動操縦中は操舵量計算で実行済みの検出結果を再利用する.


2. 表示項目 (Overlay Items)
------------------------------------------------------------------------

    2-1. 画像オーバーレイ(チェックボックスで切替)

    ・二値化画像: 二値化結果を赤色の半透明で重ねる(不透明度 0.4)
    ・検出領域: 検出対象領域の枠を青色で表示
    ・フィッティング曲線: 多項式の曲線を緑色で描画
    ・行中心点: 各行の線中心 x 座標をオレンジ色の点で描画
    ・Theil-Sen 直線: 行中心点の Theil-Sen 近似直線をマゼンタで描画
    ・中心線: 画像の中心 x に垂直線を描画(黄色)
    ・パシュート目標点: 2点パシュートの near/far 目標点を赤色の
        円(半径 2px)で描画.制御手法がパシュート,かつ自動操縦中
        のみ有効

    2-2. 検出情報ラベル(常時表示)

    映像の下に配置されたラベルに,位置偏差・傾き・曲率の数値を
    テキストで表示する.線が未検出の場合は「---」を表示する.

    2-3. 描画色 (BGR)

    ・フィッティング曲線: (0, 255, 0) 緑
    ・中心線: (0, 255, 255) 黄
    ・検出領域: (255, 0, 0) 青
    ・行中心点: (0, 165, 255) オレンジ
    ・Theil-Sen 直線: (255, 0, 255) マゼンタ
    ・パシュート目標点: (0, 0, 255) 赤
    ・二値化オーバーレイ: 赤チャンネルに二値化画像を割り当て


3. GUI 操作 (GUI Controls)
------------------------------------------------------------------------

    3-1. チェックボックス

    コントロールパネルに「デバッグ表示」グループを設け,
    各表示項目に対応するチェックボックスを配置する.
    チェックの ON/OFF で即時に表示が切り替わる.

    3-2. 動作モードとの関係

    ・手動操作中: 線検出を常に実行し,検出情報ラベルを更新する
    ・自動操縦中: 操舵量計算の線検出結果をそのまま使用する
    ・未接続時: オーバーレイは表示されない(映像がないため)