nuizu 0.1.0__tar.gz

nuizu-0.1.0/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: nuizu
+Version: 0.1.0
+Summary: Convert photos to embroidery data files (DST / PES / JEF)
+Author: mokuichi147
+License-Expression: MIT OR Apache-2.0
+Requires-Dist: numpy
+Requires-Dist: opencv-python
+Requires-Dist: pillow
+Requires-Dist: scikit-learn
+Requires-Dist: typer
+Requires-Python: >=3.12.10
+Project-URL: Homepage, https://github.com/Mokuichi147/Nuizu
+Project-URL: Repository, https://github.com/Mokuichi147/Nuizu
+Description-Content-Type: text/markdown
+
+# Nuizu
+
+写真・イラスト・漫画など、あらゆる画像を刺繍用データファイルに変換するPython CLIツール。
+JANOME、Brother、その他主要刺繍機向けの出力形式に対応。
+
+## 対応出力形式
+
+| 形式 | 拡張子 | 対応機種 |
+|------|--------|----------|
+| Tajima DST | `.dst` | ほぼ全機種対応（最も互換性が高い） |
+| Brother PES | `.pes` | Brother / Babylock |
+| JANOME JEF | `.jef` | JANOME |
+
+## 必要環境
+
+- `uv`
+- Python 3.12+
+
+```bash
+uv sync
+```
+
+## クイックスタート
+
+```bash
+# 基本変換（JEF形式、出力パス省略）
+uv run nuizu jef photo.jpg
+
+# 12色、最長辺150mmで変換（プレビューはSVG形式に変更）
+uv run nuizu jef photo.png design.jef --colors 12 --size 150 --preview svg
+
+# フル機能（最大色数指定、自動角度、プルコンペンセーション、背景あり）
+uv run nuizu dst photo.jpg design.dst \
+  --max-colors 10 \
+  --auto-angle --pull-comp 0.3 -b
+```
+
+基本構文:
+
+```bash
+uv run nuizu <dst|pes|jef> 入力画像 [出力ファイル]
+```
+
+- `出力ファイル`を省略すると、入力画像と同名で拡張子だけが各形式に変わります（例: `photo.jpg` → `photo.dst`）。
+
+## 全オプション一覧（`dst` / `pes` / `jef` 共通）
+
+### サイズ
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `-s, --size` | 100 | 最長辺の目標サイズ (mm) |
+
+### カラー
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `-c, --colors` | - | 使用する糸色数（厳密に維持） |
+| `-m, --max-colors` | 8 | 最大糸色数（指定数以下に自動調整） |
+| `-p, --palette` | auto | 糸パレット (`auto`, `janome`, `brother`, `madeira`, `generic`) |
+
+### ステッチ
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `-t, --thread-width` | 0.4 | 糸幅 (mm) |
+| `-d, --density` | 糸幅と同値 | フィル行間隔 mm（小さい＝密） |
+| `-l, --stitch-length` | 3.0 | 最大ステッチ長 mm |
+| `-a, --angle` | 45 | フィルステッチ角度（度） |
+| `--auto-angle` | - | 領域ごとに最適フィル角度を自動決定 |
+| `--no-underlay` | - | アンダーレイ（下縫い）無効 |
+| `--no-outline` | - | アウトライン無効 |
+| `--satin-outline` | - | アウトラインをサテンステッチに |
+| `--pull-comp MM` | 0 | プルコンペンセーション mm（推奨: 0.2-0.5） |
+
+### 画像処理
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `--blur` | 3 | ぼかし半径（0=無効） |
+| `--min-region` | 0.001 | 最小領域サイズ（画像全体に対する比率） |
+| `--auto-crop` | - | 被写体を自動検出してクロップ |
+| `-b, --background` | - | 背景色もステッチに含める（デフォルトはスキップ） |
+
+### 出力
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `--preview` | png | プレビュー生成 (`png`, `svg`, `none`) |
+| `-q, --quiet` | - | 進行状況メッセージを抑制 |
+
+## 処理パイプライン
+
+```
+[入力画像]
+    │
+    ▼
+[1] 前処理
+    ├── リサイズ（最大800px）
+    ├── Gaussianぼかし（ノイズ軽減）
+    └── Medianフィルタ（アンチエイリアス・JPEG圧縮ノイズ除去）
+    │
+    ▼
+[2] 色量子化
+    ├── LAB色空間でK-meansクラスタリング
+    ├── 刺繍糸パレットへスナップ（JANOME/Brother/Madeira）
+    ├── 近似色クラスタの自動マージ（ΔE閾値）
+    └── 明るい背景の自動検出（前景比率チェック）
+    │
+    ▼
+[3] 領域分割
+    ├── ラベルマップ平滑化（多数決投票）
+    ├── 暗色ピクセルの復元（輪郭・ストローク保護）
+    ├── OpenCV輪郭抽出（RETR_CCOMP: 穴あり対応）
+    ├── モルフォロジー処理（小ギャップの閉鎖）
+    └── ピクセル座標 → mm座標変換
+    │
+    ▼
+[4] ステッチ順序最適化
+    ├── 色グループ化（色変更最小化）
+    └── グループ内で最近傍法（ジャンプ最小化）
+    │
+    ▼
+[5] ステッチ生成
+    ├── プルコンペンセーション（輪郭拡張）
+    ├── 自動フィル角度決定（PCA / minAreaRect）
+    ├── 細幅領域のフィルスキップ（アウトラインのみ）
+    ├── アンダーレイ（垂直方向・疎）
+    ├── メインフィル（スキャンライン走査）
+    ├── フィルコンペンセーション（行端延長）
+    ├── アウトライン（ランニング or サテン）
+    └── ロングステッチ分割（最大7mm）
+    │
+    ▼
+[6] ファイル出力（DST / PES / JEF）
+```
+
+## アーキテクチャ
+
+```
+src/nuizu/
+├── __main__.py      # CLI エントリーポイント（Typer）
+├── pipeline.py      # メイン変換パイプライン
+├── preprocess.py    # 画像前処理（背景検出、自動クロップ）
+├── quantize.py      # 色量子化（K-means / LAB色空間 / クラスタマージ）
+├── palettes.py      # 実メーカー糸パレット（JANOME / Brother / Madeira）
+├── segment.py       # 領域分割（OpenCV contour / 穴あり階層抽出）
+├── auto_angle.py    # フィル角度自動最適化（PCA / minAreaRect）
+├── fill.py          # フィルステッチ生成（ラスタスキャンライン方式）
+├── compensate.py    # プルコンペンセーション（布引き攣り補正）
+├── optimize.py      # ステッチ順序最適化
+├── svg_preview.py   # SVGプレビュー生成
+└── formats/
+    ├── common.py    # 共通データ構造（Stitch, Pattern, ThreadColor）
+    ├── dst.py       # Tajima DST ライター
+    ├── pes.py       # Brother PES ライター
+    └── jef.py       # JANOME JEF ライター
+```
+
+## 使用例
+
+### 写真をJANOMEで刺繍する
+
+```bash
+uv run nuizu jef portrait.jpg portrait.jef \
+  --palette janome --colors 8 --size 100 \
+  --auto-angle --pull-comp 0.3
+```
+
+### 被写体を自動クロップして刺繍
+
+```bash
+uv run nuizu dst flower.jpg flower.dst \
+  --auto-crop --colors 6
+```
+
+### 密度の高い高品質仕上げ
+
+```bash
+uv run nuizu pes logo.png logo.pes \
+  --density 0.25 --stitch-length 2.5 --satin-outline \
+  --pull-comp 0.4 --max-colors 10
+```
+
+### シンプルな変換
+
+```bash
+uv run nuizu dst photo.jpg \
+  --no-underlay --no-outline --colors 4
+```
+
+## プルコンペンセーションの目安
+
+| 生地タイプ | 推奨値 (mm) |
+|-----------|-------------|
+| 薄い生地（オーガンジー、シルク） | 0.2 - 0.3 |
+| 中厚生地（コットン、リネン） | 0.3 - 0.4 |
+| 厚い生地（デニム、キャンバス） | 0.4 - 0.6 |
+
+## 制限事項
+
+- 出力ファイルのバイナリ形式はリバースエンジニアリングに基づいています。実機での動作は糸・生地・テンションなど多くの要因に依存します。
+- 写真の変換品質は元画像のコントラストと色の明確さに大きく左右されます。
+- 非常に大きな刺繍（200mm超）ではステッチ数が数万を超え、実機での刺繍時間が長くなります。

nuizu-0.1.0/README.md

@@ -0,0 +1,204 @@
+# Nuizu
+
+写真・イラスト・漫画など、あらゆる画像を刺繍用データファイルに変換するPython CLIツール。
+JANOME、Brother、その他主要刺繍機向けの出力形式に対応。
+
+## 対応出力形式
+
+| 形式 | 拡張子 | 対応機種 |
+|------|--------|----------|
+| Tajima DST | `.dst` | ほぼ全機種対応（最も互換性が高い） |
+| Brother PES | `.pes` | Brother / Babylock |
+| JANOME JEF | `.jef` | JANOME |
+
+## 必要環境
+
+- `uv`
+- Python 3.12+
+
+```bash
+uv sync
+```
+
+## クイックスタート
+
+```bash
+# 基本変換（JEF形式、出力パス省略）
+uv run nuizu jef photo.jpg
+
+# 12色、最長辺150mmで変換（プレビューはSVG形式に変更）
+uv run nuizu jef photo.png design.jef --colors 12 --size 150 --preview svg
+
+# フル機能（最大色数指定、自動角度、プルコンペンセーション、背景あり）
+uv run nuizu dst photo.jpg design.dst \
+  --max-colors 10 \
+  --auto-angle --pull-comp 0.3 -b
+```
+
+基本構文:
+
+```bash
+uv run nuizu <dst|pes|jef> 入力画像 [出力ファイル]
+```
+
+- `出力ファイル`を省略すると、入力画像と同名で拡張子だけが各形式に変わります（例: `photo.jpg` → `photo.dst`）。
+
+## 全オプション一覧（`dst` / `pes` / `jef` 共通）
+
+### サイズ
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `-s, --size` | 100 | 最長辺の目標サイズ (mm) |
+
+### カラー
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `-c, --colors` | - | 使用する糸色数（厳密に維持） |
+| `-m, --max-colors` | 8 | 最大糸色数（指定数以下に自動調整） |
+| `-p, --palette` | auto | 糸パレット (`auto`, `janome`, `brother`, `madeira`, `generic`) |
+
+### ステッチ
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `-t, --thread-width` | 0.4 | 糸幅 (mm) |
+| `-d, --density` | 糸幅と同値 | フィル行間隔 mm（小さい＝密） |
+| `-l, --stitch-length` | 3.0 | 最大ステッチ長 mm |
+| `-a, --angle` | 45 | フィルステッチ角度（度） |
+| `--auto-angle` | - | 領域ごとに最適フィル角度を自動決定 |
+| `--no-underlay` | - | アンダーレイ（下縫い）無効 |
+| `--no-outline` | - | アウトライン無効 |
+| `--satin-outline` | - | アウトラインをサテンステッチに |
+| `--pull-comp MM` | 0 | プルコンペンセーション mm（推奨: 0.2-0.5） |
+
+### 画像処理
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `--blur` | 3 | ぼかし半径（0=無効） |
+| `--min-region` | 0.001 | 最小領域サイズ（画像全体に対する比率） |
+| `--auto-crop` | - | 被写体を自動検出してクロップ |
+| `-b, --background` | - | 背景色もステッチに含める（デフォルトはスキップ） |
+
+### 出力
+
+| オプション | デフォルト | 説明 |
+|-----------|-----------|------|
+| `--preview` | png | プレビュー生成 (`png`, `svg`, `none`) |
+| `-q, --quiet` | - | 進行状況メッセージを抑制 |
+
+## 処理パイプライン
+
+```
+[入力画像]
+    │
+    ▼
+[1] 前処理
+    ├── リサイズ（最大800px）
+    ├── Gaussianぼかし（ノイズ軽減）
+    └── Medianフィルタ（アンチエイリアス・JPEG圧縮ノイズ除去）
+    │
+    ▼
+[2] 色量子化
+    ├── LAB色空間でK-meansクラスタリング
+    ├── 刺繍糸パレットへスナップ（JANOME/Brother/Madeira）
+    ├── 近似色クラスタの自動マージ（ΔE閾値）
+    └── 明るい背景の自動検出（前景比率チェック）
+    │
+    ▼
+[3] 領域分割
+    ├── ラベルマップ平滑化（多数決投票）
+    ├── 暗色ピクセルの復元（輪郭・ストローク保護）
+    ├── OpenCV輪郭抽出（RETR_CCOMP: 穴あり対応）
+    ├── モルフォロジー処理（小ギャップの閉鎖）
+    └── ピクセル座標 → mm座標変換
+    │
+    ▼
+[4] ステッチ順序最適化
+    ├── 色グループ化（色変更最小化）
+    └── グループ内で最近傍法（ジャンプ最小化）
+    │
+    ▼
+[5] ステッチ生成
+    ├── プルコンペンセーション（輪郭拡張）
+    ├── 自動フィル角度決定（PCA / minAreaRect）
+    ├── 細幅領域のフィルスキップ（アウトラインのみ）
+    ├── アンダーレイ（垂直方向・疎）
+    ├── メインフィル（スキャンライン走査）
+    ├── フィルコンペンセーション（行端延長）
+    ├── アウトライン（ランニング or サテン）
+    └── ロングステッチ分割（最大7mm）
+    │
+    ▼
+[6] ファイル出力（DST / PES / JEF）
+```
+
+## アーキテクチャ
+
+```
+src/nuizu/
+├── __main__.py      # CLI エントリーポイント（Typer）
+├── pipeline.py      # メイン変換パイプライン
+├── preprocess.py    # 画像前処理（背景検出、自動クロップ）
+├── quantize.py      # 色量子化（K-means / LAB色空間 / クラスタマージ）
+├── palettes.py      # 実メーカー糸パレット（JANOME / Brother / Madeira）
+├── segment.py       # 領域分割（OpenCV contour / 穴あり階層抽出）
+├── auto_angle.py    # フィル角度自動最適化（PCA / minAreaRect）
+├── fill.py          # フィルステッチ生成（ラスタスキャンライン方式）
+├── compensate.py    # プルコンペンセーション（布引き攣り補正）
+├── optimize.py      # ステッチ順序最適化
+├── svg_preview.py   # SVGプレビュー生成
+└── formats/
+    ├── common.py    # 共通データ構造（Stitch, Pattern, ThreadColor）
+    ├── dst.py       # Tajima DST ライター
+    ├── pes.py       # Brother PES ライター
+    └── jef.py       # JANOME JEF ライター
+```
+
+## 使用例
+
+### 写真をJANOMEで刺繍する
+
+```bash
+uv run nuizu jef portrait.jpg portrait.jef \
+  --palette janome --colors 8 --size 100 \
+  --auto-angle --pull-comp 0.3
+```
+
+### 被写体を自動クロップして刺繍
+
+```bash
+uv run nuizu dst flower.jpg flower.dst \
+  --auto-crop --colors 6
+```
+
+### 密度の高い高品質仕上げ
+
+```bash
+uv run nuizu pes logo.png logo.pes \
+  --density 0.25 --stitch-length 2.5 --satin-outline \
+  --pull-comp 0.4 --max-colors 10
+```
+
+### シンプルな変換
+
+```bash
+uv run nuizu dst photo.jpg \
+  --no-underlay --no-outline --colors 4
+```
+
+## プルコンペンセーションの目安
+
+| 生地タイプ | 推奨値 (mm) |
+|-----------|-------------|
+| 薄い生地（オーガンジー、シルク） | 0.2 - 0.3 |
+| 中厚生地（コットン、リネン） | 0.3 - 0.4 |
+| 厚い生地（デニム、キャンバス） | 0.4 - 0.6 |
+
+## 制限事項
+
+- 出力ファイルのバイナリ形式はリバースエンジニアリングに基づいています。実機での動作は糸・生地・テンションなど多くの要因に依存します。
+- 写真の変換品質は元画像のコントラストと色の明確さに大きく左右されます。
+- 非常に大きな刺繍（200mm超）ではステッチ数が数万を超え、実機での刺繍時間が長くなります。

nuizu-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "nuizu"
+version = "0.1.0"
+description = "Convert photos to embroidery data files (DST / PES / JEF)"
+authors = [{ name = "mokuichi147" }]
+readme = "README.md"
+license = "MIT OR Apache-2.0"
+requires-python = ">=3.12.10"
+urls = { Homepage = "https://github.com/Mokuichi147/Nuizu", Repository = "https://github.com/Mokuichi147/Nuizu" }
+dependencies = [
+    "numpy",
+    "opencv-python",
+    "pillow",
+    "scikit-learn",
+    "typer",
+]
+
+[project.scripts]
+nuizu = "nuizu.__main__:main"
+
+[build-system]
+requires = ["uv_build>=0.9.17,<0.10.0"]
+build-backend = "uv_build"

nuizu-0.1.0/src/nuizu/__init__.py

@@ -0,0 +1,2 @@
+"""nuizu - Convert images to embroidery files."""
+__version__ = "0.1.0"

nuizu-0.1.0/src/nuizu/__main__.py

@@ -0,0 +1,232 @@
+"""nuizu のCLIエントリーポイント。"""
+
+from __future__ import annotations
+
+import os
+import traceback
+from pathlib import Path
+from typing import Literal
+
+import typer
+
+
+PaletteName = Literal["auto", "janome", "brother", "madeira", "generic"]
+PreviewFormat = Literal["png", "svg", "none"]
+
+app = typer.Typer(
+    no_args_is_help=True,
+    add_completion=False,
+    context_settings={"help_option_names": ["-h", "--help"]},
+    help=(
+        "写真を刺繍用データ（DST / PES / JEF）へ変換します。\n\n"
+        "使用例:\n"
+        "  nuizu dst photo.jpg\n"
+        "  nuizu dst photo.jpg -c 12 -s 150\n"
+        "  nuizu jef photo.png output.jef --max-colors 10\n"
+        "  nuizu pes photo.jpg --palette brother -b"
+    ),
+)
+
+
+def _run_convert(
+    input_path: str,
+    output_path: str | None,
+    ext: str,
+    *,
+    size: float,
+    colors: int | None,
+    max_colors: int,
+    palette: str,
+    thread_width: float,
+    density: float | None,
+    stitch_length: float,
+    angle: float,
+    auto_angle: bool,
+    no_underlay: bool,
+    no_outline: bool,
+    satin_outline: bool,
+    pull_comp: float,
+    blur: int,
+    min_region: float,
+    auto_crop: bool,
+    skip_bg: bool,
+    preview: str | None,
+    quiet: bool,
+) -> None:
+    in_file = Path(input_path)
+    if not in_file.exists() or not in_file.is_file():
+        typer.echo(f"エラー: 入力ファイルが見つかりません: {input_path}", err=True)
+        raise typer.Exit(code=1)
+
+    if output_path is None:
+        output_path = str(in_file.with_suffix(ext))
+
+    fill_density = density if density is not None else thread_width
+
+    if colors is not None:
+        n_colors = colors
+        strict = True
+    else:
+        n_colors = max_colors
+        strict = False
+
+    from .pipeline import convert_photo_to_embroidery, generate_preview
+    from .svg_preview import generate_svg_preview
+
+    try:
+        pattern = convert_photo_to_embroidery(
+            image_path=input_path,
+            output_path=output_path,
+            target_size_mm=size,
+            n_colors=n_colors,
+            use_thread_palette=palette != "auto",
+            thread_brand=palette,
+            fill_density=fill_density,
+            stitch_length=stitch_length,
+            fill_angle=angle,
+            auto_angle=auto_angle,
+            underlay=not no_underlay,
+            outline=not no_outline,
+            outline_satin=satin_outline,
+            pull_compensation=pull_comp,
+            thread_width=thread_width,
+            blur_radius=blur,
+            min_region_ratio=min_region,
+            auto_crop=auto_crop,
+            skip_background=skip_bg,
+            strict_colors=strict,
+            verbose=not quiet,
+        )
+
+        if preview:
+            base = os.path.splitext(output_path)[0]
+
+            if preview == "png":
+                thread_path = f"{base}_preview.png"
+                generate_preview(pattern, thread_path, thread_width_mm=thread_width)
+                if not quiet:
+                    typer.echo(f"プレビュー（糸幅）: {thread_path}", err=True)
+
+                stitch_path = f"{base}_stitches.png"
+                generate_preview(pattern, stitch_path, thread_width_mm=0)
+                if not quiet:
+                    typer.echo(f"プレビュー（針落ち）: {stitch_path}", err=True)
+
+            elif preview == "svg":
+                svg_thread_path = f"{base}_preview.svg"
+                generate_svg_preview(pattern, svg_thread_path, thread_width_mm=thread_width)
+                if not quiet:
+                    typer.echo(f"プレビュー（SVG 糸幅）: {svg_thread_path}", err=True)
+
+                svg_stitch_path = f"{base}_stitches.svg"
+                generate_svg_preview(pattern, svg_stitch_path, thread_width_mm=0)
+                if not quiet:
+                    typer.echo(f"プレビュー（SVG 針落ち）: {svg_stitch_path}", err=True)
+
+    except Exception as exc:
+        typer.echo(f"エラー: {exc}", err=True)
+        traceback.print_exc()
+        raise typer.Exit(code=1) from exc
+
+
+def _make_command(ext: str, description: str):
+    """サブコマンド生成ファクトリ。"""
+
+    def command(
+        input_path: str = typer.Argument(
+            ...,
+            metavar="入力画像",
+            help="入力画像ファイル（JPG, PNG など）",
+        ),
+        output_path: str | None = typer.Argument(
+            None,
+            metavar="出力ファイル",
+            help=f"出力ファイル（省略時は 入力名{ext}）",
+        ),
+        size: float = typer.Option(
+            100.0, "--size", "-s", help="最長辺の目標サイズ（mm）",
+        ),
+        colors: int | None = typer.Option(
+            None, "--colors", "-c", help="使用する糸色数（厳密に維持）",
+        ),
+        max_colors: int = typer.Option(
+            8, "--max-colors", "-m", help="最大糸色数（指定数以下に自動調整）",
+        ),
+        palette: PaletteName = typer.Option(
+            "auto", "--palette", "-p", help="糸パレット",
+        ),
+        thread_width: float = typer.Option(
+            0.4, "--thread-width", "-t", help="糸幅（mm）",
+        ),
+        density: float | None = typer.Option(
+            None, "--density", "-d", help="フィル行間隔（mm）。未指定時は --thread-width と同値",
+        ),
+        stitch_length: float = typer.Option(
+            3.0, "--stitch-length", "-l", help="最大ステッチ長（mm）",
+        ),
+        angle: float = typer.Option(
+            45.0, "--angle", "-a", help="フィル角度（度）",
+        ),
+        auto_angle: bool = typer.Option(
+            False, "--auto-angle", help="領域ごとにフィル角度を自動最適化",
+        ),
+        no_underlay: bool = typer.Option(
+            False, "--no-underlay", help="アンダーレイ（下縫い）を無効化",
+        ),
+        no_outline: bool = typer.Option(
+            False, "--no-outline", help="アウトライン縫いを無効化",
+        ),
+        satin_outline: bool = typer.Option(
+            False, "--satin-outline", help="アウトラインをサテンステッチ化",
+        ),
+        pull_comp: float = typer.Option(
+            0.0, "--pull-comp", help="プルコンペンセーション（mm）。推奨: 0.2-0.5",
+        ),
+        blur: int = typer.Option(
+            3, "--blur", help="前処理ぼかし半径（0で無効）",
+        ),
+        min_region: float = typer.Option(
+            0.001, "--min-region", help="最小領域比率",
+        ),
+        auto_crop: bool = typer.Option(
+            False, "--auto-crop", help="主被写体を自動検出してクロップ",
+        ),
+        background: bool = typer.Option(
+            False, "--background", "-b", help="背景色もステッチに含める",
+        ),
+        preview: PreviewFormat = typer.Option(
+            "png", "--preview", help="プレビュー生成形式",
+        ),
+        quiet: bool = typer.Option(
+            False, "--quiet", "-q", help="進行メッセージを抑制",
+        ),
+    ) -> None:
+        _run_convert(
+            input_path, output_path, ext,
+            size=size, colors=colors,
+            max_colors=max_colors, palette=palette,
+            thread_width=thread_width, density=density,
+            stitch_length=stitch_length, angle=angle,
+            auto_angle=auto_angle, no_underlay=no_underlay,
+            no_outline=no_outline, satin_outline=satin_outline,
+            pull_comp=pull_comp, blur=blur, min_region=min_region,
+            auto_crop=auto_crop, skip_bg=not background,
+            preview=preview if preview != "none" else None, quiet=quiet,
+        )
+
+    command.__doc__ = description
+    return command
+
+
+app.command("dst")(_make_command(".dst", "DST形式（Tajima）で出力"))
+app.command("pes")(_make_command(".pes", "PES形式（Brother / Babylock）で出力"))
+app.command("jef")(_make_command(".jef", "JEF形式（JANOME）で出力"))
+
+
+def main() -> None:
+    """pyproject の scripts から呼ばれるエントリーポイント。"""
+    app(prog_name="nuizu")
+
+
+if __name__ == "__main__":
+    main()