# 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 で自動チェック）