[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] LoadMatFromCsv・SaveMatToCsv の数値入出力をInvariantCulture固定にしカンマ小数ロケールでの参照値誤読とCSV破壊を防止

[fix] CalcConvertMatrix・ConvertColor の中間拡張 Mat と MatExpr を確実に解放 ...

校正経路（CalcTcc）で毎回リークしていた中間 Mat を try-finally で解放する．
ExtendMat が src をそのまま返すパススルー経路では参照同一性で判定し，
呼び出し側所有の入力 Mat は解放しない

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

[add] CalcConvertMatrix・ConvertColor の中間Mat解放と入力所有権を検証するテストを追加 ...

修正前は中間拡張 Mat の未解放により赤 2 件（リーク再現）．ExtendMat の
パススルー経路（src をそのまま返す）で入力を破壊しないことも特性化．
テスト用シームとして ExtendMat を internal virtual 化（挙動不変）

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

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

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

[add] 画像保存ヘルパー SaveImage を抽出しImWrite失敗がfalseで報告されることの再現テストと正常保存の特性化テストを追加 ...

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

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

[add] 設定由来ファイル名の保存パス結合ヘルパー抽出と絶対パス・トラバーサルの再現テストおよび同梱config値の特性化テストを追加

[fix] Config.GetInt/GetFloat がパース失敗時に黙って0を返す問題を修正しArgumentExceptionを送出

[fix] 保存フォルダ名のユーザー入力を無害化しパストラバーサルと例外中断を防止 ...

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

[update] 上流の ConvertImage 全段 Clone 化と ExtendMat 逐次化を不採用としフォーク実装へ戻す

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

DFK33UX178カメラパラメータ設定

[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 は撮影シンクとして使用中のため残置

[remove] 完了済み計画（PLAN_01/02）と対比用 LEAKY_REPRO フラグを撤去 ...

- 完了済みで PROGRESS.md に要点が残る PLAN_01（リファクタリング）・PLAN_02（バグ修正）を
  削除し，削除ファイルへの実リンク・ファイル名参照を整理（歴史的言及は残置）
- LEAKY_REPRO フラグとリーク分岐（ColorCorrector.ConvertImage）・観測窓のモード表示
  （lblMode・Designer 含む）を撤去，ENV_06／PLAN_04 の記述も削除
- 標準構成では未定義のデッドコード除去のため挙動不変（ビルド成功・色補正テスト全パス）
- 3 版性能評価と本整理を PROGRESS.md／CLAUDE.md 進捗行に記録

[add] 性能評価計測の基盤（プレビュー計測グラフの FPS オーバーレイ）と計測計画・結果ドキュメント ...

MemoryMonitorForm のグラフを左軸メモリ＋右軸 FPS の 2 軸化し，本モニタ／副モニタの
実描画 FPS を折れ線で重ねて表示（WorkingSet はグラフから外し CSV には維持）．凡例を
グラフ下部へ横並び配置し，起動時に本体（左）と観測窓（右）を作業領域いっぱいに自動整列．

PLAN_04 の計測シナリオを基準プロトコル（単発撮影の繰り返し・現行 perf_current.csv の
秒数に全版を合わせる）へ更新．現行バージョンの計測結果を TEST_02 に整理し，基準データ
perf_current.csv を追加．

[add] BitmapUtil.FastClone の仕様ベーステストを追加 ...

/implement Phase 2 の成果．FastClone に NUnit テストを追加し，独立コピー・
src 非破壊・24/32bpp の画素一致・ストライドパディング・Indexed フォールバック
（色は等価だが PixelFormat は 32bppArgb に変換されうる）・null→null を検証．
全 80 件成功（MSBuild + vstest で確認）．

あわせて BitmapUtil の Indexed フォールバックの doc を補足（ロジック不変）し，
テスト方針（自動テストは FastClone のみ担保・UI/並行系は実機 MEMMONITOR 計測で
検証）を CLAUDE.md / docs/PROGRESS.md に記録．

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

[update] プレビューのフレームコピーを LockBits で高速化 ...

毎フレームの new Bitmap(bmp)（GDI+ DrawImage 経路・32bppARGB 変換で ~25ms）を，
同一 PixelFormat の生画素を LockBits + RtlMoveMemory で行単位コピーする
BitmapUtil.FastClone に置換．コールバックスレッドのコピー律速を解消した．

実機計測（MEMMONITOR）: コピー ~25ms→~2.5ms（約10倍），callback_fps ~16→~30，
両プレビュー描画 ~10→~20fps．色化け・クラッシュなし．

生成コピーは入力と独立し UI スレッドでのみ Dispose される所有権・スレッド安全性は
従来の new Bitmap(bmp) と同一で不変．src は ReadOnly ロックのみで非破壊．
インデックスカラー系は安全網として従来の GDI+ フルコピーにフォールバック．

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

[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>

[add] PLAN_02 メモリ修正の効果検証ツール（メモリ観測ウィンドウ・リーク再現モード）を追加 ...

MEMMONITOR 記号で TIASshot 本体にライブメモリ観測ウィンドウを統合（起動時自動オープン・Timer サンプリングの折れ線グラフ＋CSV）。LEAKY_REPRO 記号で ConvertImage を修正前（中間 Mat 未解放）に切替可能化し対比録画できるようにした。いずれも既定で 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 限定）を実装

[fix] ConvertImage の中間 Mat を using で解放し OOM クラッシュを修正（PLAN_02 優先度2）

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

[add] テストプロジェクト（TIASshot.Tests, NUnit）を立ち上げ

[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>

プレビューフォームのTopMost解除

画像表示にInvoke使わず，Invalidateで再描画要求

プレビューモニタ表示

ISカメラのROI切出し

lumenera dll追加

校正と撮影のイベント音実装

音源追加

説明変数の並び順を旧形式にあわせ修正

古い変換行列の出力

Lucam対応

撮影情報の設定名変更

ISカメラの撮影情報保存

保存ファイル名変更　アイコン設定

config修正

変換行列の要素数を変更可 ...

configファイルを階層化

拡張行列の変換処理の柔軟化

色変換エクセルシート追加

TCCデータをマットフォトペーパーに変更

Lucam動作確認，画像色変換の並列化

TCCのROI画像を校正後の画像に変更

保存のスレッド化

撮影時間計測とCSV保存

撮影の実装

基本クラスのインターフェース実装

IScam自動校正まで実装 ...

CameraBase親クラス

IScamプレビュー表示

照明on/offスイッチの接続確認

照明制御

連続撮影の表示更新　画像保存ファイル名をConfig化

RGB->XYZ変換行列算出　csv出力の指数表記解除

XYZデータ読み込み　起動チェック関数化

データ保存フォルダを開くボタン

チャート検出中の通知

チャート上下逆の検出と通知

色補正 前後の保存

撮影完了メッセージ表示

撮影画像の保存

校正ファイルをフォルダ保存

SRGBへの変換

設定ファイル読み込みエラーの対処

設定ファイル導入　チャートの固定判定

チャート検出と自動校正

キャリブレーション実装

OpenCVでプレビュー表示