IVSD · evidence-bounded reference

先分清 Server 契約、實驗觀察與待確認事項

本頁以既有唯讀勘查為界：IVSD Server/native 是契約與結果的主要依據；CameraSimulator 是受控實驗工具；兩者共用引擎的觀察不能補成未公開的 native 規格。

來源邊界：同一名稱不代表同一契約

IVSD Server observed

Server/native 是主要結果依據

既有唯讀勘查確認 Server 以表單選型、設定參數並執行 simulation；Node wrapper 啟動 native binary，頁面呈現 H/V FOV、PNG、stdout／exit 狀態與可能的 stereo warning。

Source＋Observed IVSD-CAP-E4 · IVSD-CAP-E5 · IVSD-REQ-E1

IVSD experimental tool observed

CameraSimulator 只描述這個 WASM build

CameraSimulator 以 model、安裝組態與校正狀態組成 WASM request，回傳六類 polygon array；這是受控實驗的可重現觀察，不是 Server 的產品承諾或 native 公式。

Source IVSD-CAP-E1 · Observed IVSD-CAP-E3

Inference／待確認

不能用 wrapper 或實驗結果補規格

不以 ONNX 字串、空 array 或既有 wrapper 反推 native 內部公式、逐點門檻、eSoc 對應或正式支援範圍。兩條路徑的差異只並列，不互相覆蓋。

Inference boundary IVSD-CAP-E8 · IVSD-REQ-E6

執行 npm run docs:vpp-ivsd 開啟 IVSD capability flow 互動圖。

IVSD experimental tool observed

CameraSimulator：預覽、診斷與 polygon 是不同輸出

CameraSimulator 將 model、height、tilt、corridor、zoomStep、LDC 與可選 abnormal inputs 送進 WASM。corridor 是 installation mode；zoomStep 是離散 calibration ID（YAML 的 zoomVal），不是 mm、百分比或 array index；LDC 只在找到 intrinsics_ldc.yml 時切到專用 calibration path。缺失或非數值 zoomStep 的 observed fallback 是 0，zoom-in factor 的 observed fallback 是 1.0。

上述都是這個 experimental tool 的 source-code 行為，不是 Server/native contract。預覽使用 WASM 回傳的 P′／idealFovx／idealFovy 與 displacement map；Edge-Ray FOV 是由 distorted frame edge rays 產生的 debug angle；地面範圍則由 WASM polygon arrays 決定（IVSD-CAP-E2）。三條輸出路徑不可互相替代。

model name、SoC、解析度與安裝幾何造成空 array、以及 Fall 掃描 0／5280，都是這個 build 的診斷觀察。SC9133 只回 Human 也只適用於此 WASM build，不可當其他 model fallback；正式輸入、輸出與空結果語意仍是 open question。

Source IVSD-CAP-E1 · IVSD-CAP-E9 · IVSD-CAP-E10 · IVSD-CAP-E11 · Observed IVSD-CAP-E3

IVSD Server observed

Server contract：表單路由、native 執行與 rendered result

Server 是 server-rendered HTML form；它依 extrinsics 選擇 2D 或 3D 表單，Node wrapper 僅處理 routing、form、spawnSync、stdout／PNG 與 HTML render，不自行計算幾何。

路徑已記錄輸入／限制已記錄結果
2Dheight（cm）、tilt、條件式 LDC／corridor、focal／zoom；依表單條件出現。依 selected package version 執行 native；H/V FOV 與 PNG 隨 rendered result 回傳。
3Dper-model height limits、zoom-in 1.0–1.8；多數沒有 tilt，SC8131／SC8132 是 tilt 例外。3D 是與 2D 擇一的表單路徑，不將 2D 欄位假設套用到它。

已記錄的 native result 以 stdout／exit bitmask 表達結果：eFov_Fail 是失敗；eFov_Stereo_Normal／eFov_Stereo_Warning 是立體正常／警告；eFov_2D_Normal／eFov_2D_Fisheye 是 2D 正常／魚眼；eTilt_Non／eTilt_Small／eTilt_Big 決定 rendered result 配用的安裝示意圖。這只說明結果語意，不推論 native 內部計算。

Source＋Observed IVSD-CAP-E4 · IVSD-CAP-E5 · Source IVSD-REQ-E2 · IVSD-REQ-E3 · IVSD-REQ-E5

IVSD experimental tool observed

Capabilities：產品宣告與本次可繪製結果分開讀

唯一可由 CameraSimulator 回傳直接觀察的 capability 結果是：某類 array 非空時，這次 placement／config 可建立該類 polygon 並加入 fovAvailableMap。它不能取代產品 catalog 或 Server 的正式 capability contract。

Source IVSD-CAP-E2 · Observed IVSD-CAP-E3

Derived／Integration policy

正式宣告存在時才可與本次 observation 交集

drawableNow(T, config) = Array.isArray(response[T]) AND response[T].length > 0
visibleOptions = declaredTypes ∩ drawableTypes

這是整合層的 derived policy，不是 native 計算公式或 Server 已發布 contract。確認方式：由 IVSD owner 提供正式 product catalog／API 的 declaredTypes 與對應的輸入、輸出、錯誤語意；在此之前 UI 只能描述「目前可繪製」。

Observed input IVSD-CAP-E2 · Inference boundary／確認方式 IVSD-CAP-E8 · IVSD-REQ-E6

IVSD Server observed

Request sequence：Server 只記錄已驗證的表單與結果邊界

  1. Browser 選 model；Server 依 extrinsics_num 回傳 2D 或 3D 的參數表單。
  2. Browser 對擇一路徑送出 /set_param；Server 回傳 simulation 表單與 optional abnormal 欄位。
  3. Browser 對 /simulate_fov 送出 abnormal distance／size；Node wrapper 依版本啟動 native binary，並另外取得 H/V FOV。
  4. Server render HTML，包含 H/V、base64 PNG、stdout／exit 結果與必要 warning。

2D 已記錄的 flags 與 optional abnormal inputs 屬既有唯讀勘查；3D 表單→argv 逐欄映射待確認，因此本頁不以 2D 欄位補足 3D native contract。

Source＋Observed IVSD-REQ-E1 · Source IVSD-REQ-E2 · IVSD-REQ-E3 · Source＋Inference boundary IVSD-REQ-E4 · IVSD-REQ-E5

執行 npm run docs:vpp-ivsd 開啟 IVSD Server request 互動圖。

Server 與實驗工具結果不可互相覆蓋

IVSD Server observed

Versioned native evaluation

Server 可選 package version，輸出 H/V FOV、PNG 與 status／warning。H/V 顯示結果與 native evaluation 的 rendered response 一起判讀。

Source＋Observed IVSD-CAP-E4 · IVSD-CAP-E5

IVSD experimental tool observed

Single WASM build in a 3D scene

CameraSimulator 使用單一 WASM build，回傳六類 polygons 供場景繪製；array 空／非空只描述該次實驗組態，不能覆寫 Server 的 native result。

Source＋Observed IVSD-CAP-E6 · IVSD-CAP-E7

Inference／待確認

共有引擎不是共有產品契約

Server 與 CameraSimulator 可同時作為比對材料，但應保留各自的版本、輸出語意、座標與錯誤邊界；任何差異都需要正式 owner 說明。

Inference boundary IVSD-CAP-E6 · IVSD-REQ-E6

Inference／待確認

交接前仍需取得的正式答案

  • 3D 表單→argv 逐欄映射待確認。
  • 正式整合入口、package／calibration version lifecycle，以及 model／SKU／channel mapping。
  • 輸入單位與座標、polygon／PNG 的語意、空結果與錯誤的正式區分。
  • 各 Detection Type 的 Server capability contract；不以 CameraSimulator 的 array 或 Fall 實驗結果代替。
  • FE：fisheye 的 mount、環形／多環 polygon 與中心盲區語意；CC：panoramic 的非凸 geometry 與分類方式。
  • MA：每個 channel 的 request 次數及 model／channel／calibration mapping；SD：連續 focal 與離散 zoom calibration 的正式 mapping。
  • Thermal：是否有獨立 model、target type 與距離標準；Box camera：是否必須提供 lens ID，以及缺 calibration 的語意。
  • SC9133：立體／特殊分析的正式輸入、輸出與空結果語意；LPR：專用機是否採不同 calibration path 與 polygon 定義。
  • native 內部公式、逐點門檻與 eSoc 對應不由 wrapper 或 binary 字串反推。

Inference boundary IVSD-CAP-E8 · IVSD-REQ-E4 · IVSD-REQ-E6