feat: initial public release (MAESTRO)

2026-06-03 05:08:00 +00:00
commit f5c7666f6b
823 changed files with 184150 additions and 0 deletions
@@ -0,0 +1,54 @@
+# AnnotateImage
+
+画像上に矩形枠・矢印・テキストラベルを SVG で重畳描画する。元画像は変更せず `output/` に新しいファイルとして保存される。
+
+## 基本
+
+```js
+AnnotateImage({
+  input_path: "input/screenshot.png",
+  output_path: "output/annotated.png",
+  annotations: [
+    { type: "rectangle", x: 100, y: 50, width: 200, height: 80, color: "#FF0000", label: "問題箇所" },
+    { type: "arrow", from_x: 50, from_y: 200, to_x: 150, to_y: 250, color: "#00FF00", label: "ここに注目" },
+    { type: "text", x: 300, y: 100, text: "重要", color: "#0000FF", font_size: 24 }
+  ]
+})
+```
+
+## annotation の種類
+
+### rectangle（矩形）
+- `x`, `y`: 左上の座標（px）
+- `width`, `height`: 幅・高さ（px）
+- `color`: 線色（CSS カラー、デフォルト `#FF0000`）
+- `label`: 矩形の上に表示するラベル（任意）
+
+### arrow（矢印）
+- `from_x`, `from_y`: 始点
+- `to_x`, `to_y`: 終点（矢印の先）
+- `color`: 線・矢じり色
+- `label`: 始点付近に表示するラベル（任意）
+
+### text（テキスト）
+- `x`, `y`: テキストの基準点
+- `text`: 表示文字列
+- `color`: 文字色
+- `font_size`: フォントサイズ（任意、画像サイズに応じて自動調整）
+
+## 自動スケーリング
+
+線幅・フォントサイズは画像サイズに応じて自動調整される（短辺ベース）。固定値で見栄えが崩れることは少ない。
+
+## 用途
+
+- スクリーンショットへの注釈追加
+- 手順書の作成（操作手順を矢印で示す）
+- バグ報告での問題箇所のハイライト
+- レポート用の図解作成
+
+## 注意
+
+- `output_path` は `output/` 配下である必要がある
+- 元画像は変更されない（非破壊的）
+- 日本語ラベル使用時は環境に日本語フォントが必要（prepare.sh で自動チェック）