ascii-image-to-ascii

このスキルを使用するタイミング

重要なトリガールール

• ユーザーがスキル名 ascii-image-to-ascii を明示した場合にのみ、このスキルを使用してください。

トリガーとなる語句の例：

• "ascii-image-to-ascii"
• "use ascii-image-to-ascii"
• "用 ascii-image-to-ascii 把图片转字符画"
• "使用 ascii-image-to-ascii 生成可读优先/细节优先两版"

適用範囲

• デフォルトの出力は ASCII のみです。ANSI カラーは任意です。
• 同梱スクリプトはローカルでの変換・検証専用です。ユーザーに代わって画像を取得またはアップロードしないでください。
• 最終的な ASCII アートを生成する前に、必ず前処理のアドバイス（被写体を切り抜く、コントラストを上げる、背景を簡素化する）を提示してください。

このスキルの使い方

入力

• imagePath（ローカルパス、必須）
• width（デフォルト 100。一般的な値：80/100/120）
• charset（デフォルト .:-=+*#%@。明るい文字から暗い文字の順）
• mode（readable | detail。両方を出力する場合は無視できます）
• background（light | dark | unknown。デフォルト unknown）
• colorMode（none | ansi256。デフォルト none）

出力（必須）

• asciiReadable：読みやすさ優先（ノイズを抑え、シルエットを明確に）
• asciiDetail：細部優先（階調を増やし、テクスチャを豊かに）
• paramsGuide：推奨する width/charset と前処理のヒント
• pitfalls：よくある失敗例を 3～5 個と、その対処法

手順

1. 前処理のアドバイス（必須）：
   • 被写体を切り抜き、不要な背景を取り除く
   • コントラストを上げて、グラデーションのノイズを減らす
   • 通常は幅を 80～120 列に設定する
2. 文字セットとマッピングの方向：
   • スペースが最も明るく、@ が最も暗くなります（または一貫して反転します）
3. 2 種類のバリエーションを生成する：
   • readable：階調を減らす（ノイズを抑える）
   • detail：階調を増やす（テクスチャを豊かにする）
4. ANSI（任意）：
   • 色は補助としてのみ使い、シルエットの読みやすさを保つ
   • 必ずカラーなしの代替版も提示する

スクリプト

• scripts/image_to_ascii.py
  • Python と Pillow が必要です（pip install pillow）
  • 対応機能：readable/detail のバリエーション、オプションの --ansi256

出力例の比較

読みやすさ優先のバリエーション（階調が少なく、シルエットが明瞭）：

        .:::.
      .=*##*=.
     .+######+.
    .:########:.
    .+########+.
     :*######*:
      .=*##*=.
        .:::.

細部優先のバリエーション（階調が多く、テクスチャが豊か）：

        .:=+:.
      .-+*##*+-.
     .=*######*=.
    .:*########*:.
    .=*########*=.
     :+*######*+:
      .-+*##*+-.
        .:=+:.

例

• examples/readable-vs-detail.md

品質チェックリスト

1. 行の長さが一貫しており、<= width である
2. 読みやすさ優先のバリエーションで、主要なシルエットを保つ
3. 末尾にスペースがない（コピー＆ペーストに適している）

キーワード

英語： ascii-image-to-ascii, image to ascii, ascii art, terminal preview, charset, grayscale, dithering, ansi 中国語： ascii-image-to-ascii, 图片转字符画, ASCII 字符画, 终端预览, 字符集, 灰度映射, 降噪, ANSI 彩色