utils/README.md

# 🛠️ Animal Grid Vectorizer - ユーティリティ

## 📋 概要
Animal Grid Vectorizerの主要な処理機能を提供するユーティリティモジュール群です。
画像処理、ベクター変換、AI機能などの中核となる機能を実装しています。

## 🏗️ ディレクトリ構造
```

utils/

├── background_removal/  # 背景除去機能

├── grid_splitter/      # グリッド分割機能

├── svg_vectorizer/     # SVG変換機能

└── image_captioner.py  # 画像キャプション生成

```

## 💻 モジュール説明

### 🧹 background_removal/

画像から背景を除去する機能を提供します。

- [詳細説明](background_removal/README.md)



主な機能：

- シンプルモード（閾値ベース）

- 高度モード（GrabCutアルゴリズム）

- 透明部分の最適化

- バッチ処理対応



### 🔲 grid_splitter/
グリッド画像を個別の画像に分割する機能を提供します。
- [詳細説明](grid_splitter/README.md)

主な機能：
- グリッドサイズ指定による分割
- 余白の自動検出と除去
- アスペクト比の保持
- バッチ処理対応

### 🖋️ svg_vectorizer/

画像をSVGベクター形式に変換する機能を提供します。

- [詳細説明](svg_vectorizer/README.md)



主な機能：

- カラー/白黒変換

- 階層モード選択

- パス最適化

- サイズ自動調整



### 💬 image_captioner.py
Google Geminiを使用した画像キャプション生成機能を提供します。

主な機能：
- 画像の内容分析
- キャプション生成
- ファイル名生成
- カスタムプロンプト対応

## 🔧 共通ユーティリティ

### エラー処理
```python

from utils.exceptions import (

    GridSplitError,

    BackgroundRemovalError,

    VectorizeError,

    CaptionError

)

```

### ログ機能
```python

from utils.logging import get_logger



logger = get_logger(__name__)

logger.info("処理開始")

```

### 設定管理
```python

from utils.config import (

    load_config,

    save_config,

    update_config

)

```

## 📊 性能最適化

### メモリ使用量
- 大きな画像の分割処理時のメモリ管理
- バッチ処理時のメモリプール
- 一時ファイルの自動クリーンアップ

### 処理速度
- マルチスレッド処理対応
- GPU支援処理（利用可能な場合）
- キャッシュ機能

## 🔍 デバッグ機能

### デバッグモード
```python

from utils.debug import enable_debug



enable_debug()  # デバッグ情報の出力を有効化

```

### プロファイリング
```python

from utils.profiler import profile



@profile

def process_image():

    # 処理内容

    pass

```

## 🧪 テスト

### ユニットテスト
```bash

python -m pytest tests/utils/

```

### 統合テスト
```bash

python -m pytest tests/integration/

```

## 📝 コード規約
- PEP 8に準拠
- Type hintingの使用
- Docstringの記述（Google形式）
- モジュールごとのREADME.mdの整備