カメラ制御仕様 (Camera Control Specification)

起動時のカメラ接続フロー (Startup Connection Flow)

Form1 ロード時に以下の順で接続を試みる．

1. Lucam.Connect() を実行する

   • 成功: Lucam をアクティブカメラとして使用する
   • 失敗: 次へ

2. ImagingSource デバイス一覧を走査する

   • 接続されているデバイス名を順に IScam.Connect() で試行する
   • 最初に成功したカメラをアクティブカメラとして使用する

3. どのカメラも接続できない場合

   • エラーダイアログを表示してアプリを終了する

IScam（ImagingSource カメラ）の制御 (IScam Control)

接続

• 列挙したデバイスから，機種名（列挙名から空白を除いたもの．例: DFK 33UX178 → DFK33UX178）が一致するものを選んで開く（IScamDeviceSelector）．
• [デバイス名].xml（デバイス状態ファイル）は設定の適用だけに使う（LoadDeviceStateFromFile(file, false)）．ファイルに書かれた個体（シリアル番号）は開かないため，同じ機種なら別の個体でも接続できる．
  • ※ 以前は LoadDeviceStateFromFile(file, true) でファイルのデバイスを開いていたため，同梱の DFK33UX178.xml（シリアル 41520093 の個体）と別の個体では接続できず，例外が外へ漏れていた（2026-10-08 に実機テストで発見して修正）．
• デバイスが見つからない・開けない・設定を適用できない場合は，例外を外へ出さず ErrorMsg に理由を設定して false を返す（起動時の接続フローが次のデバイスを試せる）．
• config.xml の <カメラ名>/ROI から ROI 設定を読み込む．
• FrameQueueSink をシンクに設定してライブ開始する．

プレビュー（フレーム取得コールバック）

• FrameQueueSink の Retrieve コールバックでフレームを受け取る．
• 受け取った画像を転置（.T()）し，ROI を切り出して表示する．
• キャリブレーション中は白色票の測定・ゲイン更新も行う（後述）．

ROI クリップ

• ImagingSource カメラは横向きに画像を出力するため，転置して縦向きに変換する．
• 転置後の画像座標系で ROI（X，Y，W，H）を切り出す．

撮影

• シンクを FrameQueueSink → FrameSnapSink に切り替える．
• SnapSingle() で1フレームずつ取得して _shots に蓄積する．
• 撮影完了後，シンクを FrameQueueSink に戻す．
• 最初の1フレームは捨てる（カメラの安定待ち）．

Lucam（Lumenera カメラ）の制御 (Lucam Control)

接続

• LucamNumCameras() で接続台数を確認する（0台または2台以上はエラー）．
• カメラ ID から機種を特定する（0x49f → Lw110）．
• LucamRgbPreviewCallback コールバックを登録する．
• config.xml の <Lucam> からカメラパラメータを設定して，プレビューを開始する．

プレビュー（フレーム取得コールバック）

• LucamRgbPreviewCallback でフレームを受け取る．
• 受け取った画像を転置（.T()）して表示する（ROI クリップなし）．
• キャリブレーション中は白色票の測定・ゲイン更新も行う（後述）．

撮影

• LucamEnableFastFrames() でスナップ撮影モードに切り替える．
• LucamTakeFastFrame() でRAW画像を取得し，LucamConvertFrameToRgb24() でRGB変換する．
• 撮影完了後，LucamDisableFastFrames() で通常モードに戻す．

ホワイトバランス自動調整 (White Balance Calibration)

チャート検出後（_calibrating が Calib/Frames にセットされた後），各フレームで以下の処理を行う．

1. 白色票（_chartMasks[12]，24色票の13番）の平均 RGB 値を測定する

2. Calib/UpdateInterval フレームごとにゲインを更新する

   • 更新比率: ratio = (target / current - 1) * UpdateRate + 1
   • IScam: VCDRangeProperty.Value を直接更新する
   • Lucam: _snap.Gain* を更新し SetCameraParam() で反映する

3. _calibrating をデクリメントし，0 になったら CalcTcc() を呼び出す

データ保存フォルダの生成 (Save Folder)

SetSaveFolder(note) が保存先フォルダを以下の書式で生成する．

[SaveFolder]/[yyyy-MM-dd]/[HH_mm_ss]-[note]/

• SaveFolder は config.xml の <File/SaveFolder> で指定する．
• note は「データ名」（撮影時）または「校正」（キャリブ時）．
• フォルダが存在しない場合は自動作成する．