[fix] SaveImages で画像の保存失敗を IOException にして完了表示せず失敗を通知する ...

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

[fix] CalcGainValue で現在値と比率の積が NaN のとき現在値を維持し int.MinValue の設定を防止 ...

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

[fix] OpenCvSharp 4.13 の ArUco API へ移行しチャート検出のテストを追加

[fix] 撮影ボタンの固着経路を塞ぎ保存スレッドの中断処理を安全化 ...

設計レビューで見つかった残存経路を修正し，撮影セッションの定型処理を基底へ集約した．

- 保存スレッド起動フラグを Shot 到達前にリセットし，スレッド生存判定と併用して
  保存フォルダ作成失敗など Shot 到達前の例外でも 2 回目以降に撮影ボタンが復帰するよう修正
- 未消費 Mat の解放待ちを総経過時間から無通信時間の上限に変更し，長時間の連続撮影で
  誤って打ち切られて Mat がリークし撮影中にボタンが有効化される問題を解消
- 保存スレッドの終端処理（通知・UI 復帰）を個別に例外捕捉し，フォーム破棄後の Invoke
  失敗でプロセスが異常終了しないよう防護
- Lucam/IScam に重複していた撮影セッションの定型処理を CameraBase へ抽出（挙動不変）

SPEC_01 に撮影準備・保存の失敗時の通知と，撮影ボタンが保存完了まで無効である旨を追記

[fix] 撮影経路の例外境界を追加し例外時のUI固着とSaveThreadリークを防止 ...

撮影ボタンハンドラ・撮影セッション・保存スレッドに例外境界を置き，
どの経路でも撮影終了処理と _shots.CompleteAdding() に到達させる．

- Form1 に ExecuteShot を追加し，撮影失敗を ShowError で通知して UI 状態を復帰
  （SaveThread 起動後は保存完了時の復帰に委ねて再入を防ぐ）
- CameraBase に PrepareShotSession/FinalizeShotSession を追加し，RunShotLoop 未完走の
  ときだけ CompleteAdding を呼ぶ構造にして SaveThread の永久ブロックを解消
- SaveThread に例外境界を追加し，未消費 Mat を解放してから通知・UI 復帰
- Lucam/IScam の Shot を try/finally 化し，撮影終了処理（FastFrames 無効化・Sink 復帰）を保証
  IScam はインラインの Sink 切り替えを BeginShot/EndShot へ移設

[fix] 撮影失敗を無通知で不正画像として保存する問題を修正し即中止とダイアログ通知に変更 ...

Lucam.CaptureFrame が LucamTakeFastFrame・LucamConvertFrameToRgb24 の戻り値を検査せず，
失敗しても _rawImage の中身（1枚目はゼロ埋め，2枚目以降は前フレームの複製）を正常画像として
保存していた．専用例外 CaptureFailedException を送出し，撮影ループで捕捉して即座に中止する．

- 取得済み画像は破棄せず保存し，Info.csv に中止理由を記録（列を Shot,Time(ms),Note に拡張）
- 通知は Form1.ShowError に MessageBox を集約し，撮影終了処理の完了後（Shot 戻り直後）に表示
  （撮影ループ内で出すとモーダル中に EnableShots(true) が届き再入し得るため）
- 想定外例外も中止扱いにして完了メッセージ・完了音を抑止（例外自体は従来どおり伝播）

[fix] IScam のホワイトバランスゲイン設定値を RangeMin/RangeMax にクランプし非有限比率での範囲外設定を防止 ...

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

[add] ゲイン設定値算出ヘルパー CalcGainValue を抽出し範囲外・非有限比率で範囲外値を設定する再現テストと正常時四捨五入の特性化テストを追加 ...

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

[fix] 画像保存4箇所のImWrite戻り値を検査し保存失敗を無通知にせずDebugログに記録 ...

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

[fix] 設定由来ファイル名を無害化してから保存フォルダと結合し絶対パス・トラバーサルによる保存フォルダ外への書き込みを防止

連続撮影の不安定さを解決

[fix] 自動校正経路の Mat リークを解消し v1.7 のメモリ修正を内包 ...

ColorCorrector.CalcTcc と CameraBase.CalcTcc で未解放だった Mat を確実に破棄する．
- CalcTcc: 再校正時に旧 _convRGB2SRGB を Dispose してから Clear，中間 Mat
  （convRGB2XYZ・convOld・tccSrgb・convSrgb2Xyz）を using で解放．保持する
  convRGB2SRGB と引数 tccRgb は解放しない
- CameraBase.CalcTcc: tccRgb・imgRois を using で解放（所有権は生成元）
- ColorCorrectorTests: 再校正で旧行列破棄・中間Mat解放・入力保持を検証するテストを追加

上流 v1.7 が校正経路で塞いだ Mat リークをリファクタ抽出時に取りこぼしていた分の補完．
挙動（保存 CSV・音・メッセージ）は不変．

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

[remove] 自動検出以前の手動校正デッドコードとコメント跡を削除 ...

自動チャート検出の導入で不要化した手動校正の残骸を除去（挙動不変）。

- Form1 の非表示ボタン btnCalib（Visible=false）＋空ハンドラ btnCalib_Click を削除
- Lucam.Calibration()（唯一の参照が上記コメント行。_calibrating を立てるだけで
  現行の _chartMasks 前提フローと非整合＝そのままでは動作しない残骸）を削除
- IScam のコメントアウト行（LoadShowSaveDeviceState）を削除
- FrameSnapSink/_snapSink は撮影シンクとして使用中のため残置

[fix] プレビューメモリリークと Lucam クロススレッド GDI クラッシュ・副モニタ描画飢餓を修正 ...

PLAN_03 の原因1〜3（ShowImage のフルコピー Bitmap リーク・表示バッファの
取りこぼし未 Dispose・PreviewMonitor.UpdateImage の上書き前未 Dispose）を修正．
実機検証で発覚した派生2件も解決:
- Lucam の二重バッファをコールバックスレッドで Dispose する経路が UI の描画と
  衝突するクロススレッド GDI クラッシュ → 表示バッファを UI 所有コピーに統一し
  入力 Bitmap の所有権を呼び出し側に統一（IScam は ToBitmap を using で破棄）
- 校正後にコールバックスレッドが高速化し毎フレーム Invalidate が飢餓を招く
  副モニタ描画崩壊 → 両プレビューを自ペースの UI タイマー駆動に統一し
  コールバックスレッドからの Invalidate を全廃

あわせて MEMMONITOR 限定のプレビュー計測（各段 FPS・コピー/描画時間・
GDI/handle 数・画像サイズ・校正/撮影/F9 イベントの CSV 化）を追加（Release 無影響）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

[clean] 白板撮影の出し分けを専用ビルド記号 WHITEBOARD に変更し Designer の条件コンパイルを全廃 ...

#if DEBUG から独立した #if WHITEBOARD に切り替え、Form1.Designer.cs の条件コンパイルを撤去して白板ボタンを Form1.WhiteBoard.cs に分離。白板ボタンのレイアウト衝突も修正。撮影ロジックは不変。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

[update] 白板撮影モードにフルフレーム（クロップなし）保存を追加

[add] 白板撮影モード（照明均一性評価用・DEBUG 限定）を実装

[clean] ゲイン補正式（GetRatio）を純粋クラス GainCalc に抽出しテスト対象化

[fix] _shots をスレッドセーフ化し連続撮影クラッシュを修正（PLAN_02 優先度1）

[clean] IScam/Lucam の重複するプレビュー・撮影処理を CameraBase に集約（Phase 5）

[clean] ファイルI/O・サウンドをIoUtilクラスに分離（リファクタリング Phase 4） ...

- Utils/IoUtil.cs を新設し CSV 読み書き・保存フォルダ生成・撮影情報出力・サウンド再生を集約
- CameraBase は IoUtil へ委譲（SetSaveFolder/WriteInfo は派生クラス共有状態のため薄いラッパーで保持）
- PLAN_01 の Phase4 にラッパー保持の方針を注記
- 抽出ロジックは元コードと一致（挙動不変）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

[clean] チャート検出処理を ChartDetector クラスに分離（リファクタリング Phase 3） ...

- ChartDetection/ChartDetector.cs を新設し ARマーカー検出・固定判定・ホモグラフィ・マスク生成を集約
- CameraBase は DetectChart を委譲し，マスクは戻り値で受け取る（フォーム通知はデリゲート注入）
- 検出系フィールドと未使用 using を CameraBase から除去
- 検出ロジックは元コードと文字単位で一致（挙動不変）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

[clean] 色補正処理を ColorCorrector クラスに分離（リファクタリング Phase 2） ...

- ColorCorrection/ColorCorrector.cs を新設し TCC 変換行列計算・色変換を集約
- CameraBase は ColorCorrector を保持して委譲（CSV 保存はデリゲートで注入）
- UpdateRate/GetRatio は色補正と別関心事のため CameraBase に保持
- PLAN_01 のフィールド一覧を実態に合わせ更新（UpdateRate を除外）
- 計算ロジックは元コードと文字単位で一致（挙動不変）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

[clean] カメラ制御と UI を Cameras/・UI/ フォルダに分離（リファクタリング Phase 1） ...

- Cameras/ へ CameraBase.cs, IScam.cs, Lucam.cs を移動
- UI/ へ Form1.*, PreviewMonitor.* を移動
- TIASshot.csproj の参照パスを更新（namespace・ファイル内容は無変更）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>