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

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

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

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

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

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

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

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

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

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

2-1. 接続

• [デバイス名].xml からカメラ設定をロードする．
• config.xml の <カメラ名>/ROI から ROI 設定を読み込む．
• FrameQueueSink をシンクに設定してライブ開始する．

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

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

2-3. ROI クリップ

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

2-4. 撮影

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

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

3-1. 接続

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

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

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

3-3. 撮影

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

4. ホワイトバランス自動調整 (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() を呼び出す

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

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

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

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