ASCIIアート は何をしますか?
scripts/ascii.pyで静止画、scripts/animate.pyでアニメーションを生成します(「アニメーション」参照)。どちらもPython 3.9以上とPillowが必要です(動画にはffmpegも必要)。uvがインストールされていれば、uv runでPillowを自動的に取得します。
uv run scripts/ascii.py 画像 [オプション] # または: python3 scripts/ascii.py (pillowが必要)
以下のパスは、このスキルのフォルダからの相対パスです。
手順
- 画像のパスを取得します。URLの場合は、最初に
curl -L -o /tmp/in.img URLでダウンロードします。 - 出力を選択します。チャットでアートを表示するにはstdoutテキストを使用します。ユーザーが共有するファイルを希望する場合は、
-o file.pngまたは-o file.htmlを使用します。 - 実行し、結果を確認します。PNGの場合は、画像を開いて確認します。
- 被写体が見づらい場合は、調整して再実行します(「弱い結果の修正」を参照)。
オプション
| オプション | 説明 |
|---|---|
-w 100 | 文字単位の幅(1~1000)。チャットでは60~80、PNG/HTMLでは120~200、テキストのスクリーンショットでは120以上を使用します。 |
-c standard | 文字ランプ: standard, detailed, blocks, terminal, minimal, binary, dots、または高密度から空白への独自の文字列(例: -c "#*. ")。 |
-o out.png | 拡張子で出力を決定: .txt, .html, .png, .jpg, .webp。-oなしの場合はプレーンテキストをstdoutに出力します。 |
--bg black | 背景色: black(デフォルト)、white、none(透明PNG/HTML)、または任意の色。暗い背景では明るいピクセルに高密度のグリフが割り当てられます。明るい背景では暗いピクセルに割り当てられます。 |
--fg matrix | 1色のインク色: matrix, amber, cyan, magenta, mint、または任意のCSS色または16進数。指定がない場合、PNG/HTMLは写真の元の色を使用します。 |
--color | テキスト出力(stdoutまたは.txt)でTrueColorANSIエスケープコードを使用します。--fgが指定されている場合はそれを使用し、そうでない場合は写真の色を使用します。 |
--invert | 明暗を反転します。 |
--contrast 1.0 --brightness 1.0 | 自動コントラスト伸張に加算される係数。1.0は変更なしを意味します。 |
--dither | Floyd-Steinbergディザリング。滑らかなグラデーションとblocksやminimalのような短いランプに適しています。 |
--mode ramp | ramp(デフォルト): 明るさで選択された、ピクセルあたり1つのグリフ。shape: rampと似ていますが、輪郭は同じ形状の記号(`/ \ |
--sharpen | 縮小前にエッジをシャープにします。顔や細部に効果があり、特にbrailleモードで効果的です。 |
--aspect 0.5 | 文字幅を高さで割った値。アートが押しつぶされて見える場合は値を上げてください。 |
--font-size 12 | PNG/HTMLのグリフサイズ(ピクセル単位)。 |
--glow 0.8 | PNG、HTML、アニメーションにおいて、古い画面の光のようにグリフの周りに柔らかなぼかしを追加します(0-1)。暗い背景で最も効果的です。 |
弱い結果の修正
スクリプトはすでにすべての画像を全階調範囲に引き伸ばしているため、ほとんどの画像は調整なしで問題なく表示されます。
- 写真:
-c blocks --ditherは、最も認識しやすい顔や動物を生成します。 - 暗い被写体(黒い犬、夜景など)が黒い背景に溶けて見えなくなる場合:
--bg whiteを使用します。--brightness 1.5に上げることも効果的です。コントラストを上げると暗いシーンは悪化します。 - 白い背景の暗いロゴがベタ塗りのブロックのように見える場合:
--bg whiteを追加します(ターミナル出力の場合は--invert)。 - 同じ幅でより詳細にしたい場合:
--mode braille --dither --sharpen(線画スタイル)、または--mode halfblock(カラー写真)。 - ノイズが多すぎる場合: カラム数を減らすか、短いランプ(
-c minimal)を使用します。 - グラデーションにバンディングが発生する場合:
--ditherを追加します。 - チャット出力: エスケープコードが文字化けして表示されるため、
--colorは絶対に使用しないでください。テキストをコードブロックで囲んでください。 - SVGはサポートされていません。最初にPNGに変換してください(
rsvg-convert -w 800 logo.svg -o logo.png)。
モードの簡単な説明
brailleは-cを無視します。写真には--ditherと一緒に使用し、ロゴには単体で使用します。色は写真、または--fgに従います。halfblockは-c、--dither、--fgを無視します。色は画像そのものだからです。プレーンテキスト(--colorなし)には色がないため、各セルは明るさに応じてシェードブロック█▓▒░になります。--bg noneは透過になりません。透明ピクセルは黒になります。- ターミナルは点字ドットを小さく描画するため、点字はPNGよりもターミナルでは暗く見えます。
タイルポスター
--mode tilesはポスターを生成します。落ち着いた色の正方形タイルのグリッドで、各タイルには1つのグリフが配置され、ページはチャコール色になります。画像がページの色に近いセルはタイルになりません。薄いグリフが表示され、グリッドはどこでも続きます。
uv run scripts/ascii.py photo.jpg --mode tiles -w 36 -o poster.png
- タイルモードのデフォルト: 正方形セル(
--aspect 1)、--font-size 80(48ピクセルタイル)、--gap 1、--bg "#1d1f22"。テキスト出力では--aspect 0.5が維持されます。 --palette 8: タイルの色数。被写体から1回選択されます。よりフラットで落ち着いた外観にするには4~6を使用します。- グリフはランダムです。
--seed Nで別のセットを選択します。代わりにランプグリフを使用するには、-cを指定します。 - 明るい背景の写真:
--bg "#ecebe6"のような明るいページを使用します。すると暗い部分がタイルになります。 animate.pyでも動作します。グリフと色はフレーム間で同じままです。
ワードポスター
--mode wordsは、キャンバスを大文字の単語で埋め尽くし、単語同士は1スペースで区切られます。各行は独自のオフセットで始まり、両端からはみ出します。画像は各単語の明るさを通してのみ表示されます。単語の明るさは、その下にある画像の平均値から1レベルずつ決まります。暗い部分は薄い単語になり、被写体は明るい単語になります。
--words "A B C"で語彙を設定します(スペースまたはカンマ区切り)。デフォルトは、タイプとピクセルに関連する短い単語リストです。--accent "#f28c28"は、最もカラフルな単語の背後に、暗いテキストのソリッドボックスを配置します。--accent-level 0.5(0-1)は、単語がどれだけカラフルである必要があるかの閾値です。グレースケールの写真にはボックスは配置されません。完全にカラフルなロゴには多数のボックスが配置されるため、レベルを上げてください。- 背景のデフォルトは
#1d1f22です。--gapは、積み重ねられた行のボックス間のピクセル数を設定します。--seedは別のレイアウトを選択します。--fgは無視されます。 - 暗い背景の明るくシンプルな被写体に最適に機能します。明るい写真の暗い被写体の場合は、
--invertを追加します。 animate.pyでは、レイアウトはすべてのフレームで同じままです。明るさのみが変化します。
プリセット: --mode words -w 110 --font-size 16 --accent "#f28c28" -o poster.png
プリセット
- マトリックス:
-c binary --fg matrix --glow 0.8 -o out.png - レトロアンバーターミナル:
-c terminal --fg amber -o out.png - カラーのフォトモザイク:
-c detailed -w 160 -o out.html - ターミナルで最高のカラー写真:
--mode halfblock --color - ファインなドット描画:
--mode braille --dither --sharpen -o out.png - フィルムノワール:
--fg "#e8e6df" --contrast 1.35 --bg "#050505" --glow 0.7 -o out.png - 印刷向け:
--bg white -o out.png - タイルポスター:
--mode tiles -w 36 -o poster.png
アニメーション
scripts/animate.pyはASCIIアニメーションを生成します。ascii.pyと同じルックオプション(-w、-c、--mode、--sharpen、--bg、--fg、--invert、--contrast、--brightness、--font-size、--aspect、--gap、--glow、およびワード/タイルポスターオプション)を使用できます。動画入力と.mp4出力にはffmpegが必要です。GIFとWebPには必要ありません。
uv run scripts/animate.py cat.gif # ターミナルで再生、Ctrl-Cで停止
uv run scripts/animate.py cat.gif -o out.gif # .webp、.mp4、.html(再生/一時停止プレーヤー付きの1ファイル)も可能
uv run scripts/animate.py clip.mp4 -o out.html --start 2 --duration 4 --fps 12
uv run scripts/animate.py photo.jpg --effect matrix -o intro.gif # 静止画像をアニメーション化
- 入力: アニメーションGIF、WebP、APNG、ffmpegが読み取れる任意の動画、または
--effectを使用した静止画像。 - フレームタイミングはソースから取得されます。
--fpsでリサンプリングします。--startと--durationで秒単位の範囲を指定します。 - デフォルトで300フレームで停止し、その旨を通知します。より長いクリップには
--max-framesを上げるか、--fpsを下げます。 - すべてのフレームで1つのトーン範囲(点字の場合は1つのドットしきい値)が使用されるため、明るさが変動しません。
- 静止領域はちらつきません。ピクセルは、値が
--steady(デフォルト6、255段階中)を超えて変化するまで値を保持します。粒子の粗いフィルムの場合は16以上に上げます。--steady 0でオフにします。 - インターレース動画はインターレース解除され、非正方形ピクセルの動画は実際の形状を維持します。
- アニメーションでは
--ditherを避けてください。フレーム間でグリフが這うように動いて見えます。 - GIFは約50fpsより速く再生できないため、高速な動画では
.gifで一部のフレームがドロップされます。スムーズな60fpsには.mp4または.webpを使用します。
単色背景上の図形
ムイブリッジの走る馬のように、明るい背景に暗い図形がある場合は、--bg whiteを使用します。すると図形にインクが適用され、ページはきれいなままになります。--mode brailleは最もシャープな動く図形を与え、--mode halfblockは写真の色調を保持します。
uv run scripts/animate.py horse.gif --mode braille --bg white -o horse.gif
uv run scripts/animate.py juggler.webm --start 17 --duration 4 --mode braille --subject -o juggler.gif
--subjectは、動くものだけを保持し、残りを空のページとして描画します(背景が明るい場合は白。--bgを設定した場合はその色)。静止画カメラが必要です。最大25フレームの中央値から背景を取得します。注意点:
- 頭のようにクリップの大部分で静止している部分は背景と見なされ、フェードアウトします。
- 画像の端が変化し続ける場合、カメラが動いています。その旨が通知され、フレームはそのまま残ります。ゆっくりとしたパンは常に検出されるとは限らず、輪郭が残ることがあります。
- 各フレームが異なる写真であるクリップ(ムイブリッジの馬やバッファロー)では、代わりに
--bg whiteを使用します。 --subject-cut(デフォルト40、255段階中)は、ピクセルが背景とどの程度異なる必要があるかの閾値です。薄い図形の場合は値を下げ、ノイズの多い動画の場合は値を上げます。
静止画像用エフェクト
--effect エフェクト名は、1枚の画像を、完成したアートで終わり1.5秒間保持する、25fpsの2~3.2秒のイントロに変換します。すべてのエフェクトはすべてのモードで動作します。
matrix: 明るいヘッドを持つグリフの落下する列が、背後にアートを残します。decode: セルがランダムなグリフをスクランブルしてロックインし、左から右にスイープします。scan: 明るいCRTラインが下にスイープし、各行を短いグローとともに入力します。glitch: 短いバーストの千切れた行、グリフの交換、赤/シアンのバンド。ループに適しています。wave: 行が正弦波で左右に揺れ、増幅して収まります。ループに適しています。
シーン
--scene シーン名は、コードでループするアニメーションを描画するため、入力ファイルは必要ありません。各ループは2~3.2秒で、最後のフレームは最初のフレームに流れ込みます。すべてのモード、カラーオプション、出力が機能します。--seed Nは別のバリエーション(炎、波、星、雨)を与え、--fpsは滑らかさを変更しますが、ループの長さは維持します。
uv run scripts/animate.py --scene fire -o fire.gif # 立ち上る炎、暖色
uv run scripts/animate.py --scene donut -o donut.gif # 回転する、光る、アイシングされたドーナツ
uv run scripts/animate.py --scene cube --mode braille -o cube.gif # 明るいエッジを持つ転がる立方体
uv run scripts/animate.py --scene waves --mode halfblock -o waves.gif # 月の下の海のうねり
uv run scripts/animate.py --scene stars -o stars.gif # 星空を飛び抜ける
uv run scripts/animate.py --scene walker --mode braille -o run.gif # その場で走る棒人間
uv run scripts/animate.py --scene rain --mode braille -o rain.gif # 雨と水しぶき
uv run scripts/animate.py --scene bounce --mode halfblock -o ball.gif # 跳ねるときに潰れるボール
uv run scripts/animate.py --scene text --mode halfblock -o text.gif # 虹の波に乗る「ASCII」という単語
-w 60から-w 100を使用します。--mode halfblockは最高の色を提供し、--mode brailleは最も鮮明な線を提供します。-oなしの場合、シーンはターミナルで再生されます。- シーンは
scripts/scenes.py内の単純な関数です:scene(w, h, n, seed)はループするn個の画像を返します。追加するには、関数を記述し、@scene(width, height, frames, fps)行を指定します。
説明文から
ユーザーがファイルを指定する代わりに動くもの(「走る馬」など)を説明した場合は、最初にフリーのクリップを見つけます。scripts/fetch.pyはWikimedia Commonsを検索し、フリーライセンスのアニメーションGIFと短い動画を見つけ、最適なものをダウンロードします。
- クリップを取得:
uv run scripts/fetch.py "running horse" -o /tmp/clip。適切な拡張子(.gif、.webm)を追加し、保存されたパスと帰属表示行を出力します。自分で選択するには、最初に--listで実行し、次に--pick Nで選択します。 - 出力されたパスを変換:
uv run scripts/animate.py /tmp/clip.gif --mode braille -w 80 --bg white -o out.gif。任意のプリセットが機能します。長い動画の場合は--duration 5を追加します。 - 結果のフレームを確認します。被写体が見づらい場合は、
--pickで別の結果を試します。 - 結果とともに帰属表示行をユーザーに提供します。ほとんどのライセンス(CC BY、CC BY-SA)ではこれが必要です。
検索には、被写体と動きを表す短い平易な英語の単語を使用します。線画、シルエット、単色背景のクリップがASCIIとして最も読みやすくなります。込み入った実際の動画はうまくいかないことがよくあります。
適切なものが見つからない場合は、代わりにコード描画シーンを使用します: animate.py --scene シーン名(「シーン」参照)。
Pythonでの使用
import sys; sys.path.insert(0, "scripts")
from PIL import Image
from ascii import convert, to_text, to_png
grid = convert(Image.open("cat.jpg"), width=80, charset="blocks", dither=True)
# セルは (char, (r, g, b)) です。mode="halfblock"の場合、(char, top_rgb, bottom_rgb) になります。
# mode="tiles"の場合、タイルセルは (char, ink_rgb, tile_rgb) になります。
print(to_text(grid))
to_png(grid).save("cat_ascii.png")
from effects import frames # グリッドのリスト。最後の1つは `grid`
intro = [to_png(g) for g in frames(grid, "decode")]