プロジェクト

全般

プロフィール

概要

# GUIアプリ書き出し + 画面フォームデザイナ 追加計画

## Context(なぜ)
現状 `ProjectExport`(VC++書き出し)は**GUIなしのランナー**(実行して画像/ログを保存し終了)しか生成できない。
ユーザーは「作成したブロックを実行ファイル(exe)化」したい。確定した要件:
- **本格フォームデザイナ**(アプリ内・WYSIWYG): 画像表示/数値/合否/文字/ボタンをドラッグ配置・移動・リサイズ・プロパティ編集。
- **生成はプロジェクトのみ**(ビルドは VS。現状の書き出し方針を踏襲)。
- 生成exeの実行形態 3種: **実行ボタンで都度実行 / 連続実行(フォルダ連番=io.frameseq・カメラ) / 外部トリガ(net.recv→net.send)**。
目的: 検査画面付きの単体アプリを、ブロック構成+設計画面から生成できるようにする。

## 【重要・前提バグ】既存エクスポートが現状リンク不能
`Blocks_Builtin.cpp` の `RegisterBuiltinBlocks` は `extern RegisterNetBlocks/RegisterLogBlocks` を呼ぶが、
`ProjectExport::GenVcxproj` のソース一覧は Graph/BlockRegistry/Blocks_Builtin/ExecutionEngine の4つだけで
`NetBlocks.cpp`/`LogBlocks.cpp` と `ws2_32.lib` が欠落 → **生成プロジェクトは未解決シンボルでリンク失敗**。
Phase1 でソース一覧へ `NetBlocks.cpp`/`LogBlocks.cpp` 追加・`AdditionalDependencies` に `ws2_32.lib` 追加(既存ランナーも同時に修正)。

## 方針(確定)
### 1. UIレイアウトモデル(新規 `core/UiLayout.h`・ウィンドウ非依存)
- `enum UiControlKind{ ImageView, ValueLabel, PassFail, StaticText, Button }`
- `enum UiButtonAction{ None, Run, LoadImage, StartContinuous, Stop }`、`enum UiRuntimeMode{ RunOnce, Continuous, NetTrigger }`
- `struct UiControl{ kind; int x,y,w,h(=フォーム client px); CString text; int boundNodeId,boundPort; UiButtonAction action; }`
- `struct UiLayout{ int formW,formH; CString title; UiRuntimeMode mode; int pollIntervalMs; vector<UiControl> controls; }`
- 所有者: `CGraphDoc` に `core::UiLayout m_layout;`(+ `Layout()`)。`OnNewDocument` でクリア。
- **座標規約**: 矩形は「フォームの client ピクセル」で保持。デザイナは描画/当たり判定にのみ zoom/pan を適用し、保存前にフォーム px へ戻す。

### 2. 永続化(`core/GraphStore.*` 拡張・既存 Save/Load シグネチャは不変)
- 追加: `bool SaveLayout(const UiLayout&, LPCTSTR)` / `bool LoadLayout(UiLayout&, LPCTSTR)`(同じ .icg DB に ui_* テーブルを追記)。
- テーブル(params/edges と同じ流儀: BEGIN/COMMIT・DELETE+INSERT・ToU8/FromU8、enum は int):
  `ui_meta(key,value)`(form_w/h・title・mode・poll_ms)、`ui_controls(idx,kind,x,y,w,h,text,bound_node,bound_port,action)`。
- 連携: `CGraphDoc::OnSaveDocument` で `GraphStore::Save` 成功後に `SaveLayout`、`OnOpenDocument` で `LoadLayout`。
- **注意**: `GraphStore::Save` は **SaveSubgraph(.isg) でも使う**ため、ui_* を `Save` 本体に入れない(.isg に混入させない)。doc の open/save からのみ呼ぶ。

### 3. アプリ内フォームデザイナ(新規ドッキングペイン `CFormDesignerPane`)
- 形態は**ドッキングペイン**(既存6ペインと同型で MFC リスク最小。CView 差し替えより安全)。
- `CCanvasView` の流儀を流用: 操作ステートマシン `Mode{Idle,Move,Resize,BoxSelect,Pan}`(**Resize は新規**)、矩形ヒットテスト、グループドラッグ(開始矩形記録)、`CanvasCoord` で zoom/pan、ラバーバンド選択、Shift トグル。
- **8 リサイズハンドル**のヒットテスト + Resize モード(最小サイズクランプ)を新規実装。
- ツールボックス(上部 or 右クリックメニュー=`ShowInsertMenu` 流用)で 5 種を選び、次クリックで既定サイズの要素を配置。
- 描画(GDI/GDI+): フォーム枠 + 各要素 + 選択枠/ハンドル。ImageView は `CPreviewPane` のアスペクト比保持描画でバインド先画像をライブ表示可。
- プロパティ編集: ペイン専用 `CMFCPropertyGridCtrl`(`CGraphDoc::SelectedNode` と競合させない)。text/x/y/w/h/action/バインドを編集。
  **バインドのドロップダウン**: `Graph::Nodes()`→`Registry().Find(typeId)`→**種別に一致する出力ポート**(ImageView=Image / ValueLabel=Number / PassFail=Bool)を `#id name.port` 表記で列挙(生存ノードのみ)。
- 配線: Resource.h に ID(`ID_VIEW_FORMDESIGNER`/`ID_GRAPH_EXPORTGUI`/`ID_FORMCTL_*`)、.rc メニュー、MainFrame に `CFormDesignerPane m_formDesigner`(既定非表示)生成・トグル・`RefreshPanes` 連携。書き出しは `OnExportGUIProject`(CFolderPickerDialog)を既存 `OnExportVCProject` の隣に。

### 4. GUIランナーのコード生成(`ProjectExport` 拡張)
- まず `GenMainCpp` のグラフ再構築ループを `GenGraphBuildCode(g, graphVar, nodeVar)` に**抽出**しヘッドレス/GUI で共用。
- 新 API: `bool ExportGUIProject(const Graph&, const UiLayout&, outDir, projName, err)`。
- 生成 `main.cpp`(GUI): `CWinApp`(GdiplusStartup→RegisterBuiltins→`CMainWnd` 生成→`m_pMainWnd=wnd`→`return TRUE`)。
  `CMainWnd:CFrameWnd` の**メンバに `Graph m_g; ExecutionEngine m_eng;`** を持ち **OnCreate で1回だけ**構築
  (`io.frameseq`/`net.recv` は alwaysRun で node->id 単位に状態保持・増分実行のため毎回再構築は不可)。
  `layout.controls` から子コントロール生成(`CStatic`/`CButton::Create`、実行時 ID 1000~。ImageView は矩形保持し OnPaint 描画)。
  `DoRun()`=`m_eng.Run(); UpdateBound(); Invalidate();`。`UpdateBound()` で ValueLabel←number / PassFail←flag(PASS/FAIL) / ImageView 画像キャッシュ。
  `OnPaint` で ImageView をアスペクト比保持描画(`valid&&image&&width>0` ガード)。
  ボタン: Run→DoRun / LoadImage→CFileDialog→SetParam("path")→DoRun / Start→`SetTimer` / Stop→`KillTimer`、`OnTimer`→DoRun。
  NetTrigger は Start ボタンが無ければ OnCreate で `pollIntervalMs` のタイマ起動(alwaysRun の net.recv をポーリング)。
  `boundNodeId` が存在しない要素は生成時にスキップ(警告)。
- 生成 `vcxproj`: 既存 `GenVcxproj` を流用しつつ **NetBlocks.cpp/LogBlocks.cpp/ws2_32.lib を追加**(ヘッドレス側も同時修正)。toolset/MFC/utf-8/include/PostBuild(DLLコピー)は現状踏襲。`GenSln` 流用。

## フェーズ(各フェーズ独立ビルド可・ヘッドレス検証付き)
- **Phase 1(基盤含む)**: vcxproj ソース一覧修正 + `GenGraphBuildCode` 抽出 / `UiLayout.h` + doc メンバ / `SaveLayout`・`LoadLayout` + ui_* テーブルを open/save に結線 / `CFormDesignerPane`(配置・移動・リサイズ・選択・ツールボックス・バインド) / MainFrame・Resource・.rc 結線 / `ExportGUIProject`(都度実行GUI: 永続グラフ・OnPaint描画・Run/LoadImage)。検証: `/uilayouttest`・`/guigentest`(・任意 `/guibuildtest`)。
- **Phase 2(連続実行)**: Start/Stop・`OnTimer`→DoRun・frameseq interval 取得・Continuous の自動開始。検証: gentest で SetTimer/KillTimer/OnTimer 出力を確認、frameseq サンプルで buildtest。
- **Phase 3(外部トリガ)**: net.recv ポーリング + net.send。Phase1 のソース一覧修正に依存。検証: gentest で net 経路・NetBlocks.cpp・ws2_32 を確認、net.recv→…→net.send サンプルで buildtest(リンク成立を証明)。

## 検証(`/xxxtest` を SelfTest + ImgChkApp ディスパッチに追加)
- **/uilayouttest**: 各種コントロール+バインドを作り、temp .icg へ `GraphStore::Save`+`SaveLayout`→`LoadLayout`→フィールド一致を確認。
- **/guigentest**: 代表グラフ(io.load→rgb2bw→otsu→judge.passfail + io.frameseq + net.recv/send)+バインド付きレイアウトを `ExportGUIProject`→生成ファイル存在 + main.cpp に `AddNodeWithId`/`CButton::Create`/`CStatic::Create`/`->Draw(`/`SetTimer`/`m_pMainWnd`/`return TRUE`、vcxproj に `NetBlocks.cpp`/`LogBlocks.cpp`/`ws2_32.lib` を含むことを assert。
- **/guibuildtest(任意)**: 生成 .sln を MSBuild(Release|x64)し exit0 を確認(リンク不能を捕捉する唯一の検査。各フェーズ末で実施)。
- **手動のみ**: デザイナのドラッグ/リサイズ/選択、生成 exe の3モード実動作。

## 既存再利用
- グラフ再構築コード生成: `ProjectExport.cpp`(GenMainCpp の AddNodeWithId/SetParam/AddEdge ループ)。
- アスペクト比保持描画: `PreviewPane.cpp`(s=min・中央寄せ・`Draw(...,COLORONCOLOR/HALFTONE)`)。
- 当たり判定/ドラッグ/選択/zoom-pan: `CanvasView.cpp`(Mode・HitNode・グループdrag・CanvasCoord)。
- 永続化: `GraphStore.cpp`(CSQLite・ToU8/FromU8・テーブル流儀)。
- ペイン生成/トグル: `MainFrame.cpp`、`Resource.h`/.rc。

## リスク/勘所
- **vcxproj ソース欠落(ブロッカー)**: NetBlocks/LogBlocks/ws2_32 が無いと未解決シンボル。現状から壊れている。Phase1 で修正。
- **永続グラフ/エンジンをメンバ保持(ブロッカー)**: frameseq/net 状態・増分実行に必須。毎クリック再構築は不可。
- **CWinApp 必須**(yfoximg は MFC 拡張DLL): return TRUE + メッセージループ + コード生成コントロール(.rc テンプレート不使用)。
- **デザイナ座標とフォーム px**: 保存はフォーム px、zoom/pan は描画のみ。混同すると生成 exe で位置ズレ。
- **リサイズハンドルは新規**(CanvasView に無い)。
- **バインド生存**: id は AddNodeWithId で安定。ドロップダウンは生存ノードのみ、生成時に死んだ bound をスクラブ。
- **PASS/FAIL の色**: 素の CStatic は文字色不可 → オーナードロー or 反射 WM_CTLCOLORSTATIC、または OnPaint 直描画(Phase1 で決める)。
- レイアウト table を .isg に混入させない(SaveLayout を GraphStore::Save に入れない)。

## 変更/新規ファイル
- 新規 `core/UiLayout.h`、`FormDesignerPane.h/.cpp`。
- `core/GraphStore.h/.cpp`(SaveLayout/LoadLayout + ui_*)、`GraphDoc.h/.cpp`(m_layout・open/save 結線・OnExportGUIProject)。
- `ProjectExport.h/.cpp`(GenGraphBuildCode 抽出・ExportGUIProject・GenVcxproj ソース修正)。
- `MainFrame.h/.cpp`・`Resource.h`・`ImgChkSystem.rc`(ペイン/メニュー/ID)。
- `SelfTest.h/.cpp`・`ImgChkApp.cpp`(/uilayouttest・/guigentest・/guibuildtest)。

---

# 設定値テーブル(全設定一覧編集+レシピ保存/読込) 追加計画

## Context(なぜ)
ImgChkSystem は各ブロックの設定値を「プロパティ」ペインでノード単位にしか編集できない。
製品/検査ごとに多数のしきい値・面積・ホスト等を**一覧で見渡して編集**し、設定一式を
**レシピ(.icp)として保存・切替**したい(ユーザー選択: 「全設定一覧表+レシピ保存/読込」)。
目的: 全ブロックのパラメータを1つの表で編集でき、レシピ切替で検査設定をまとめて差し替える。

## 方針(確定)
- 新規ドッキングペイン **設定値テーブル**(`CParamsTablePane`)に、全ノードの全パラメータを
  `CMFCPropertyGridCtrl` で「ノードごとグループ」表示し、その場編集できる。編集は既存
  `CPropertyPane` と同じ適用経路(PushUndo→SetParam→RunGraph→Refresh)を踏襲。
- **レシピ保存/読込**は `core::GraphStore` に params 専用の入出力を追加(`.icp`=SQLite)。
  読込は現グラフへ **node id + typeId + key 一致**で `SetParam` 適用(トポロジ非依存・前方互換)。
- メニュー: 「表示」にペイン表示On/Off、「設定(&S)」にレシピ保存/読込。

## 変更ファイルと要点
1. **ParamsTablePane.h/.cpp(新規)** — `CDockablePane`+`CMFCPropertyGridCtrl`。
   - `Refresh()`: `ActiveDoc()`→`Graph::Nodes()` を走査し、ノードごとに親 `CMFCPropertyGridProperty`
     (ラベル「#id name」)を作り、配下に各 `ParamDesc` を種別変換して追加。種別→プロパティ変換は
     `CPropertyPane::ShowNode`(PropertyPane.cpp:68-104)と同じ switch を流用(複製で可)。
   - プロパティ→(nodeId,key) は `std::map<CMFCPropertyGridProperty*, std::pair<int,CString>>` で保持。
   - 値変更通知は PropertyPane と同じ仕組み(`AFX_WM_PROPERTY_CHANGED`/`ApplyChange` 相当)を流用し、
     対象ノードへ `PushUndo()→SetParam()→dirty→SetModifiedFlag()→RunGraph()→RefreshPreview()`。
   - 再構築タイミング: ペイン表示時・レシピ読込後・構造変更後(`RefreshPanes` 経由)。実行毎は不要
     (paramsは実行で変化しない)。
2. **MainFrame.h/.cpp** — `CParamsTablePane m_paramsTable;` 追加、`OnCreate` で
   `Create(_T("設定値"),this,…,ID_VIEW_PARAMS_TABLE, baseStyle|CBRS_RIGHT)`→`EnableDocking`→`DockPane`
   (MainFrame.cpp:42-66 の踏襲)。Message Map に `ON_COMMAND/ON_UPDATE_COMMAND_UI(ID_VIEW_PARAMS_TABLE)`、
   `TogglePane` ハンドラ追加。`RefreshPanes()` に `m_paramsTable.Refresh()` を追加。
3. **core/GraphStore.h/.cpp** — `static bool SaveRecipe(const Graph&, LPCTSTR)` /
   `static bool LoadRecipe(Graph&, LPCTSTR)` 追加。**SQLite は yfoxbase の `CSQLite`/`CSQLiteStmt`
   を使用**(GraphStore が .icg で既に使っているものと同一。新規SQLite依存は追加しない)。既存
   `ParamTypeStr`/`ParamValueStr`/`ParseParam`(GraphStore.cpp:30-63)も再利用。recipe テーブル列:
   `node_id, type_id, key, type, value`。読込は `FindNode(id)` が在り `typeId` 一致のノードにのみ
   `SetParam`(不一致/不在はスキップ)。.icp = 1ファイル1DB。
4. **GraphDoc.h/.cpp** — `OnRecipeSave`/`OnRecipeLoad`(`CFileDialog` で .icp 選択 →
   `GraphStore::SaveRecipe/LoadRecipe` → 読込後 `RunGraph()` + `RefreshPanes()`)。
   Message Map に `ON_COMMAND(ID_RECIPE_SAVE/LOAD)`。
5. **Resource.h** — `ID_VIEW_PARAMS_TABLE=33204`, `IDC_PARAMS_GRID=33213`,
   `ID_RECIPE_SAVE=32783`, `ID_RECIPE_LOAD=32784`。
6. **ImgChkSystem.rc** — 「表示」に `設定値テーブル(&T)`、新 POPUP 「設定(&S)」に `レシピ保存(&S)...`/
   `レシピ読込(&L)...`。STRINGTABLE に説明。
7. **ImgChkSystem.vcxproj** — `ParamsTablePane.cpp`(ClCompile)・`ParamsTablePane.h`(ClInclude)追加。

## 既存再利用
- 種別→グリッド変換・編集適用: `PropertyPane.cpp`(ShowNode/ApplyChange、PushUndo→RunGraph 経路)。
- パラメータ直列化: `GraphStore.cpp` の `ParamTypeStr`/`ParamValueStr`/`ParseParam`。
- ペイン生成・トグル: `MainFrame.cpp`(OnCreate/TogglePane/RefreshPanes)、`Resource.h`/.rc の ID/メニュー。
- ノード/パラメータ走査: `Graph::Nodes()`, `Node::params/SetParam/FindParam`, `BlockRegistry::Find`。

## 検証
- **/recipetest(SelfTest 追加・ヘッドレス)**: グラフ構築→数値系パラメータを設定→
  `GraphStore::SaveRecipe(.icp)`→パラメータを別値に変更→`LoadRecipe`→元値に復元されることを
  `recipetest_result.txt` で確認(レシピ入出力の中核検証)。さらに「ノード削除後の読込で未一致は
  スキップ」も確認。
- **ビルド**: VS2022 v143/x64 Release で MSBuild。`/snap` で既存パイプライン回帰なし。
- **GUI**: ビルド成功で配線確認(ペインのグリッド編集・メニューはヘッドレス検証不可)。必要なら
  `/demo` 起動で目視。
- 既存の Undo/再実行/フレーム再生に悪影響がないこと(paramsテーブルの Refresh は実行毎に呼ばない)。

---

# ImgChkSystem — ノーコード画像検査アプリ(yfoximg ブロックエディタ)

## Context(なぜ作るか)

`yfoximg`(C:\debug\yfoxlib\yfoximg)の画像処理関数(`CImgProcessing` 約140メソッド)を、
プログラミングなしで使えるようにしたい。各関数を「ブロック(ノード)」として並べ、
線(ワイヤ)で繋いで画像検査パイプラインを組み立て、そのまま**実行**して結果を確認できる
ビジュアルエディタを `C:\debug\ImgChkSystem`(現在ほぼ空)に新規作成する。

将来的にはグラフ実行時の**最適化**も視野に入れるが、本MVPでは対象外(後述)。

### 確定した方針(ユーザー選択)
- **純MFCアプリ**(単一プロセス・単一ツールチェーン)で `yfoxbase.lib` + `yfoximg.lib` を直接リンク。
  - 決め手: `yfoximg` は **MFC拡張DLL**(`AFX_EXT_CLASS`)であり、呼べるのは MFCアプリ か
    MFC動的リンクのMFC正規DLLのみ。純MFCなら相互運用リスクゼロ。
- 実行UX: **各ノードのライブプレビュー**(中間 `CDiBitmap` をノード上/プレビュー枠に表示)。
- 最適化: **MVPでは無し**(後フェーズ。エンジンは後付けできる構造にする)。

## 設計を支配する2つの事実(探索で確認済み・厳守)

1. **リンク構成は imgbench に合わせる**(`C:\debug\yfoxlib\test\imgbench\imgbench.vcxproj` が正しい
   消費側テンプレート)。確認済み設定: `UseOfMfc=Dynamic` / `PlatformToolset=v143` /
   `LanguageStandard=stdcpp17` / lib dir `..\..\x64\$(Configuration)` /
   deps `yfoximg.lib;yfoxbase.lib`。
   → **AveryDennisonUtil は不可**(静的MFC/静的CRTで拡張DLLと非互換)。構造とGDIキャンバスの
   参考(`CoordMap.h`)にのみ使う。**消費側で `_AFXEXT` は定義しない**。
2. **CImgProcessing は強くステートフル&多くがin-place**。結果を戻り値でなくメンバ経由で渡す:
   `RGB2HSV`→`m_HSV`→`HSV2BIN` / `Labeling`→`m_lpnLabel`,`m_LabelCount` / `HouphLine`→`m_pHouphTbl`。
   → 「1ノード=1生関数・線はCDiBitmapのみ」は破綻。**複合ブロック**で吸収する(後述)。

### 全ブロック共通の実装ルール(必須)
- **R1 入力は不変**: ノード出力は複数下流へ分岐しうる。受け取った入力バッファに書き込まない。
  out-of-place オーバーロードを優先。in-placeしか無い場合は **`CDiBitmap::Copy` してから**操作。
- **R2 ノードキャッシュはノード所有のディープコピー**: 共有 `CImgProcessing` の内部バッファは
  次ノードで上書きされる。プレビュー/分岐の元になるキャッシュは各ノード所有の `CDiBitmap`(Copyで充填)。
- **R3 生 `COUNT` をポートに流さない**: `COUNT.lpFeature` 等は共有メモリへのポインタ。
  ラベリング直後にスカラ項目(bbox/area/centroid/angle/count)だけをノード所有の値構造体へ抽出して流す。

## ビルド/プロジェクト設定(M0)

VS2022 MFCウィザードで **SDI + ドッキングペイン**アプリを生成(`CFrameWndEx` + featureパック)。
ダイアログベースより、パレット/プロパティ/プレビューの3ペイン+中央キャンバス+Doc/Viewの
保存に最適。`.sln` は本アプリ単体(yfoxlibは事前ビルド済みlibをリンク、プロジェクト参照しない)。

`.vcxproj`(x64 のみ。Debug/Release):
```
ConfigurationType=Application / PlatformToolset=v143 / CharacterSet=Unicode
UseOfMfc=Dynamic / LanguageStandard=stdcpp17
RuntimeLibrary=MultiThreadedDLL(Release) / MultiThreadedDebugDLL(Debug)   ← 共有CRT必須
AdditionalIncludeDirectories = C:\debug\yfoxlib\yfoximg ; C:\debug\yfoxlib\yfoxbase ; C:\debug\yfoxlib\yfoxbase\include
AdditionalLibraryDirectories = C:\debug\yfoxlib\x64\$(Configuration)
AdditionalDependencies = yfoximg.lib;yfoxbase.lib;gdiplus.lib
PostBuild = copy /Y C:\debug\yfoxlib\x64\$(Configuration)\yfoximg.dll  $(OutDir)
            copy /Y C:\debug\yfoxlib\x64\$(Configuration)\yfoxbase.dll $(OutDir)
VcpkgEnabled=false(applocal警告抑制)
```
GDI+: `InitInstance` で `GdiplusStartup` / `ExitInstance` で `GdiplusShutdown`。
拡張DLL呼び出し側で `AFX_MANAGE_STATE` は不要。

> **前提リスク(要対応)**: 事前ビルドDLLは **Release のみ存在**(`x64\Debug` は `.lib` のみで `.dll` 無し)。
> 対策: **当面は `Release|x64` で開発**(出荷DLLと一致、CRTも /MD で整合)。Debug実行が必要なら
> 先に yfoxlib の Debug DLL(`yfoximg`/`yfoxbase`)をビルドする。M0でまずReleaseの疎通を確認する。

**M0完了条件**: 生成アプリの `InitInstance` で `CDiBitmap::Load(_T("test.bmp"),0)` と
`CImgProcessing` インスタンス化が通り、DLLが `$(OutDir)` にコピーされ起動する(=リンク前提の実証)。

## モジュール構成

UI非依存の **core**(MFC窓に依存しない。`CDiBitmap`/`CString`/MFCコンテナは可)と MFC **ui** 層に分離。

### core/
- `PortType.h` — `enum class PortType { Image, Number, Region, Bool }`、`RegionItem{CRect bbox;int area;CPoint centroid;double angle;}`、`RegionData{vector<RegionItem> items;int count;}`(R3の安全値)。
- `Port` / `Edge` / `Node` — `Node` は typeId・instance id・座標・`ParamValue`配列・**所有キャッシュ `CDiBitmap m_cacheImage`**+Region/Number/Bool出力・処理時間(us)・エラー文字列・dirtyフラグ。
- `ParamDesc.h` — `ParamDesc`/`ParamValue`(int/double/bool/string variant)、`ParamKind{Int,Double,Bool,Enum,FilePath}`+range/default/step。
- `Graph` — nodes/edges所有、隣接照会、サイクル検査。
- `BlockType` — メタデータ(id,name,category,入出力Port記述,ParamDesc一覧)+`std::function<bool(ExecContext&)> execute`。
- `BlockRegistry`(シングルトン)— 全BlockType登録、id検索、カテゴリ列挙(パレット用)。`RegisterBuiltins()` で一括登録。
- `ExecContext` — 実行時引数: 共有`CImgProcessing&`、`InputImage(port)`/`OutputImage()`/`Input/OutputRegion`/`Param<T>(key)`/`SetError`。
- `ExecutionEngine` — トポロジカルソート・検証・逐次実行・計測・キャッシュ充填。
- `GraphStore` — `CSQLite`/`CSQLiteStmt`(C:\debug\yfoxlib\yfoxbase\SQLite.h) による保存/読込。

### ui/
- `CImgChkApp:CWinAppEx`(GDI+/VisualManager)/ `CMainFrame:CFrameWndEx`(ペイン生成・ツールバー Run/Save/Load/Zoom)。
- `CGraphDoc:CDocument`(`Graph`所有、`Serialize`→`GraphStore`)。
- `CCanvasView:CView` — ノードキャンバス(描画+操作ステートマシン)。`CanvasCoord`(pan/zoom変換、`CoordMap`流用)。
- `CPalettePane`(カテゴリ別ブロック一覧、ドラッグ/ダブルクリック挿入)/ `CPropertyPane`(`CMFCPropertyGridCtrl` で選択ノードのparam編集)/ `CPreviewPane`(選択ノード `m_cacheImage` を `CDiBitmap::Draw(CDC*,rcDst,true)` で表示)。

## ブロック定義(代表10種・厳密シグネチャは ImgProcessing.h 準拠)

| # | ブロック | カテゴリ | 入力→出力 | 主なparam | 呼び出し(R1/R3順守) |
|---|---|---|---|---|---|
|1|Load Image|I/O|—→Image|path|`CDiBitmap::Load(path,0)`|
|2|Save Image|I/O|Image→Image(透過)|path|入力Copy→`Save(path)`|
|3|RGB→Gray|Color|Image→Image|—|`RGB2BW(pDst,pSrc)`(out-of-place)|
|4|Threshold|Binarize|Image→Image|low,high,invert|`Threshold(pDst,pSrc,rc,L,H,fMode)`(in-place版は禁止)|
|5|Median/Matrix|Filter|Image→Image|(kernel)|`Median(pDst,pSrc)` / `MatrixFilter(pDst,pSrc,mat,n,add)`|
|6|Dilation/Erosion|Morphology|Image→Image|op,iterations|`DilationBin(pDst,pSrc,rc,bMode)`/`ErosionBin(...)`。反復は2スクラッチでping-pong(入力不変)|
|7|Color Threshold(HSV)|Color(複合)|Image→Image(bin)|hue,hueRange,sMin/Max,vMin/Max,invert|`CreateHSV`→`RGB2HSV`(→m_HSV)→`HSV2BIN(pDst,...)`|
|8|Labeling+AreaFilter|Analysis(複合)|Image(bin)→Image+Region|minArea,maxArea|`LabelingInit`→`CreateLabelMem`→`Labeling(.,.,AREA)`→入力Copy→`LabelingPicUpArea(out,..)`。直後に`m_LabelCount[i]`→`RegionItem`抽出(R3)|
|9|Hough Line|Analysis(複合)|Image→Image+Region|maxCount,threshold,theta0/1|`HouphLine`(→m_pHouphTbl)→`GetHouphLine(.,.,buf,..)`→入力Copy→`DrawHouphLines(out,..,buf,n)`。bufから線端点を抽出|
|10|Subtract|Arithmetic|ImageA,ImageB→Image+Number|mode(Sub/SubAbs)|入力ACopy→`Sub(out,inB,avg,max,min)`/`SubAbs(...)`。avgをNumber出力|
|11|Judgement(PASS/FAIL)|Judgement|Region/Number→Bool|countMin/Max,areaMin/Max|CImgProcessing不使用。条件判定→Bool。ノードに緑/赤バッジ|

## 実行エンジン

1. **検証**: 各入力ポートに入辺1本(任意入力は別途宣言)/辺の両端ポート型一致/**サイクル検出**(DFS彩色)。
   エラーはノード別+全体に集約、ハードエラーで実行中止。
2. **トポロジカルソート**(Kahn)で線形順序。
3. **共有 `CImgProcessing` 1インスタンス**を `ExecContext` 経由で全 `execute` に渡す(ステートフル連鎖が成立)。
   ただし共有バッファは一時的なため **R2(出力はノード所有へディープコピー)必須**。
4. **ノード実行**: 入力=上流の所有キャッシュ(読取専用,R1)→`CStopWatch`開始→`execute`が
   ノード所有 `m_cacheImage`/`RegionData`/scalar/bool へ書込(R2/R3)→`GetTimeUS()`保存→clean化。
   例外/false→ノードエラー設定、下流を実行不可に。
5. **非画像出力**: `RegionData`(値,R3)・`ScalarData{double}`・`bool`。`ExecContext` の型付きアクセサで強制。
6. **プレビュー/計測の反映**: 実行後 `CCanvasView` 再描画(サムネ+処理時間ラベル+エラー着色)、
   `CPreviewPane` は選択ノードのキャッシュ、Judgementは PASS/FAIL 表示。
7. **将来の最適化への布石**: *計画(検証+トポ順)* と *実行* を分離済み。後で不要ノード除去/バッファ再利用/
   独立枝の並列化を両者の間に差し込める。dirtyフラグ+キャッシュにより選択ノードの祖先部分グラフのみ
   再実行(インクリメンタルプレビュー)も可能。

## キャンバス実装

- `CCanvasView:CView`。`OnDraw` はメモリDC上のGDI+ `Graphics`(ダブルバッファ、`OnEraseBkgnd`→TRUE)。
- 座標変換 `CanvasCoord`(`m_zoom`+`m_panX/Y`、`Screen↔Graph`)。ホイールズーム(カーソル基点)、中ボタン/Spaceでpan。
- 描画: ノード=角丸矩形(`GraphicsPath`)+タイトル+本体(param要約+キャッシュサムネ)+左入力/右出力ポート(型で色分け)。
  ワイヤ=3次ベジェ(`DrawBezier`)、ソースポート型で着色。選択=枠強調。
- ヒットテスト順: ポート→ノード本体(z順)→ワイヤ(ベジェ距離閾値)→空白。
- 操作ステートマシン `enum class Mode{Idle,DragNode,DragWire,BoxSelect,Pan}`:
  ノード上Down→DragNode(複数移動可)/ポート上Down→DragWire(ラバーバンド、互換型の入力ポートで離すと`Edge`生成、
  既存入辺は置換)/空白Down→BoxSelect/Space・中ボタンでPan/Deleteで選択削除/Ctrl+ホイールでズーム。
- パレットからのドロップ/ダブルクリックでカーソルのグラフ座標に `Node` 生成。

## 永続化(SQLite / `CSQLite`・`CSQLiteStmt`)

JSONライブラリ未同梱のため yfoxbase の SQLite を採用。1ファイル(`.icg`)=1 DB。
```sql
meta  (key TEXT PRIMARY KEY, value TEXT)               -- schema_version, view pan/zoom 等
nodes (id INTEGER PRIMARY KEY, type_id TEXT, x REAL, y REAL)
params(node_id INTEGER, key TEXT, type TEXT, value TEXT, PRIMARY KEY(node_id,key))  -- type: int/double/bool/string/path
edges (id INTEGER PRIMARY KEY, from_node INT, from_port INT, to_node INT, to_port INT)
```
- 保存: `BEGIN`→全テーブルclear→`CSQLiteStmt` で一括insert→`COMMIT`。キャッシュ画像は保存しない(実行時再計算)。
- 読込: `meta`(schema_versionガード)→`BlockType`照合しノード復元(param型キャスト)→辺復元。
  未知 type_id/key は警告付きスキップ(前方互換)。

## フェーズ(マイルストーン)

- **M0** 骨組みがビルド/リンク/起動。Release疎通で**リンク前提を最初に実証**。
- **M1** core モデル+registry(ブロック1,3,4登録)、コードで3ノードグラフを組むスモークテスト。
- **M2** 実行エンジン(トポ順・検証・共有CImgProcessing・R2キャッシュ・計測)。
- **M3** キャンバス(描画・pan/zoom・操作SM・型チェック付きワイヤ生成)。
- **M4** 3ペイン(パレット/プロパティグリッド/プレビュー)と選択イベント連携。
- **M5** 残りブロック(Save, Median/Matrix, Dilation/Erosion, HSV複合, Labeling+AreaFilter複合, Hough複合, Sub, Judgement)。
- **M6** 永続化(`GraphStore` 保存/読込、`Serialize` 連携、往復テスト)。

## 検証(受け入れ条件)

UI上で **Load → RGB→Gray → Threshold → Labeling+AreaFilter → Judgement** を配線して Run。
- (a) 各ノードに中間 `CDiBitmap` のサムネ表示。
- (b) ノード別マイクロ秒の処理時間表示。
- (c) Judgement が面積/個数条件で PASS/FAIL 表示。
- (d) `.icg` 保存→再オープン→再実行で同一結果。
- 否定確認: 型不一致ワイヤは描画時に拒否、サイクルは報告され実行不可。

### 重要ファイル(参照)
- C:\debug\yfoxlib\yfoximg\ImgProcessing.h — API・ステートフル性の真実(全ブロックexecuteの基準)
- C:\debug\yfoxlib\yfoximg\DiBitmap.h — 画像コンテナ(Load/Save/Copy/Create/Draw)=ポートのImage型
- C:\debug\yfoxlib\test\imgbench\imgbench.vcxproj — 正しいリンク/コピー設定テンプレート
- C:\debug\yfoxlib\yfoxbase\SQLite.h — CSQLite/CSQLiteStmt 永続化API
- C:\debug\AveryDennisonUtil\CoordMap.h — pan/zoom変換の流用元(構造のみ。リンク設定は流用不可)

時間管理

  • 予定工数: 0:00時間
  • 作業時間: 222:00時間

詳細 | レポート

メンバー

Manager: 藤崎

Developer: 藤崎

Reporter: 藤崎

Redmine Appliance - Powered by TurnKey Linux