# 機能仕様 (Feature Specification)

## 1. 対応カメラ (Supported Cameras)

起動時に Lucam → ImagingSource の順で接続を試みる．

**ImagingSource カメラ（新カメラ）**

- 対応機種: DFK33UX178，DFK23UX249
  - ※ README には DBK33UX178 と記載されていたが，ソースコード上は DFK33UX178 として扱われている．実機の型番は要確認．
- SDK: IC Imaging Control (TIS.Imaging)
- 設定ファイル: `[デバイス名].xml`（例: `DFK33UX178.xml`）

**Lumenera カメラ（旧カメラ）**

- 対応機種: Lw110
- SDK: Lumenera SDK（`lumenera.api.dll`）

## 2. プレビュー (Preview)

- 起動後，接続したカメラのライブ映像をメインウィンドウに表示する．
- サブモニタへのプレビュー表示にも対応する（PreviewMonitor）．
- ImagingSource カメラはプレビュー時に ROI クリップを適用する．

## 3. 自動キャリブレーション (Auto Calibration)

プレビュー中に舌診チャートを検出すると自動でキャリブレーションを開始する．

### 3-1. チャート検出

- ArUco マーカー（ID 40, 41）を使用してチャートを自動検出する．
- チャートが一定フレーム数静止したことを確認してからキャリブを開始する．

### 3-2. ホワイトバランス調整

- チャートの白色票（24色票の13番）を基準にカメラのゲインを自動調整する．
- 目標値は `config.xml` の `Calib/Reference` で指定する．

### 3-3. TCC（色変換行列）計算

- 24パッチの平均 RGB 値を計測し，最小二乗法（SVD）で変換行列を算出する．
- 変換次元数（多項式の次数）は `Calib/ConversionChannels` で指定する．
  - 4: 1次式（R，G，B，1）
  - 10: 2次式（+RG，RB，GB，R²，G²，B²）
  - 17: 3次式（+R²B，R²G，G²R，G²B，B²R，B²G，RGB）
- 複数の次元数をカンマ区切りで同時に指定可能（例: `4,10,17`）．
- 算出した変換行列は CSV ファイルに保存される．

## 4. 撮影 (Shooting)

キャリブレーション完了後に撮影ボタンが有効になる．

**1枚撮影**

- 撮影した画像を1枚保存する．

**連続撮影**

- 指定した枚数・間隔で連続撮影する．
- 枚数・間隔は UI で変更可能（デフォルト値は `config.xml` で設定）．

**保存される画像**

- 元画像（RGB）: `Shot{NO}.png`
- sRGB 変換画像: `sRGB{CN}_{NO}.jpg`（指定した次元数ぶん生成される）

## 5. データ保存 (Data Saving)

撮影・キャリブレーション結果は保存フォルダ以下に日時フォルダで自動保存される．

**保存先フォルダ構成**

- `[SaveFolder]/[日付]/[時刻]-[データ名]/`

**キャリブレーション保存ファイル**

- `TCC.png`: キャリブ時の画像
- `TCC_ROIs.jpg`: チャートの ROI 確認画像
- `TCC_RGB.csv`: チャート24色票の RGB 値
- `TCC_sRGB{CN}.csv`: チャート24色票の sRGB 変換値
- `Conv_RGB-sRGB{CN}.csv`: RGB→sRGB 変換行列
- `Conv_RGB-XYZ{CN}.csv`: RGB→XYZ 変換行列
- `Conv_sRGB-XYZ{CN}.csv`: sRGB→XYZ 変換行列

**撮影保存ファイル**

- `Info.csv`: 撮影情報（カメラ型番・SN，露光時間，ゲイン等）
- `Shot{NO}.png`: 元画像（RGB）
- `sRGB{CN}_{NO}.jpg`: sRGB 変換画像

## 6. 光源制御 (Light Source Control)

- シリアル通信（USB-シリアル変換）で光源の ON/OFF を制御する．
- 対応デバイス: Silicon Labs CP210x（`config.xml` で変更可能）．
- キャリブレーション中は光源の切り替えが無効になる．
- 光源デバイスが見つからない場合，光源ボタンが無効化される．