ASCII 아트은(는) 무엇을 하나요?
scripts/ascii.py는 정지 이미지를, scripts/animate.py는 애니메이션을 만듭니다 ("애니메이션" 참조). 둘 다 Python 3.9+와 Pillow만 필요합니다 (비디오는 ffmpeg 추가 필요). uv가 설치되어 있으면 uv run이 Pillow를 자동으로 가져옵니다.
uv run scripts/ascii.py IMAGE [옵션] # 또는: 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가 없으면 plain text를 stdout에 출력합니다. |
--bg black | 배경: black (기본값), white, none (투명 PNG/HTML), 또는 모든 색상. 어두운 배경에서는 밝은 픽셀에 밀집된 글리프가 사용됩니다. 밝은 배경에서는 어두운 픽셀에 사용됩니다. |
--fg matrix | 단일 잉크 색상: matrix, amber, cyan, magenta, mint, 또는 모든 CSS 색상이나 hex 값. 지정하지 않으면 PNG/HTML은 사진의 원래 색상을 사용합니다. |
--color | 텍스트 출력 (stdout 또는 .txt)에서 트루컬러 ANSI 이스케이프 코드를 사용합니다. --fg가 있으면 해당 색상을, 없으면 사진 색상을 사용합니다. |
--invert | 밝음과 어두움을 바꿉니다. |
--contrast 1.0 --brightness 1.0 | 자동 대비 확장에 추가되는 계수입니다. 1.0은 변화 없음을 의미합니다. |
--dither | Floyd-Steinberg 디더링. 부드러운 그라데이션과 짧은 램프(blocks나 minimal 등)에 좋습니다. |
--mode ramp | ramp (기본값): 픽셀당 하나의 글리프, 밝기로 선택. shape: ramp와 비슷하지만, 가장자리를 같은 모양의 기호(`/ \ |
--sharpen | 축소하기 전에 가장자리를 선명하게 합니다. 얼굴과 미세한 디테일에 도움이 되며, 특히 braille 모드에서 효과적입니다. |
--aspect 0.5 | 문자 너비를 높이로 나눈 값입니다. 아트가 찌그러져 보이면 값을 높입니다. |
--font-size 12 | PNG/HTML용 글리프 크기 (px). |
--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는 포스터를 만듭니다: 차콜색 페이지 위에 각각 하나의 글리프가 있는 몇 가지 차분한 색상의 정사각형 타일 격자입니다. 이미지가 페이지 색상에 가까운 셀은 타일이 아니라 희미한 글리프를 표시하여 격자가 모든 곳에 계속됩니다.
uv run scripts/ascii.py photo.jpg --mode tiles -w 36 -o poster.png
- 타일 모드 기본값: 정사각형 셀 (
--aspect 1),--font-size 80(48 px 타일),--gap 1,--bg "#1d1f22". 텍스트 출력은--aspect 0.5를 유지합니다. --palette 8: 타일 색상의 수, 피사체에서 한 번 선택됩니다. 더 평평하고 차분한 느낌을 위해 4–6을 사용합니다.- 글리프는 무작위입니다.
--seed N은 다른 세트를 선택합니다. 대신 램프 글리프를 사용하려면-c를 지정합니다. - 밝은 배경의 사진:
--bg "#ecebe6"처럼 밝은 페이지를 사용합니다. 그러면 어두운 부분이 타일이 됩니다. animate.py에서도 작동합니다. 글리프와 색상은 프레임마다 동일하게 유지됩니다.
단어 포스터
--mode words는 캔버스를 대문자 단어로 채우며, 단어 사이는 한 칸 띄웁니다. 각 행은 자체 오프셋에서 시작하여 양쪽 가장자리 밖으로 이어집니다. 이미지는 각 단어의 밝기를 통해서만 보입니다: 단어당 하나의 레벨, 그 아래 이미지의 평균에서 비롯됩니다. 어두운 부분은 희미한 단어를, 밝은 피사체는 밝은 단어를 제공합니다.
--words "A B C"는 어휘를 설정합니다 (공백 또는 쉼표로 구분). 기본값은 짧은 유형 및 픽셀 단어 목록입니다.--accent "#f28c28"는 가장 다채로운 단어 뒤에 어두운 텍스트가 있는 단색 상자를 놓습니다.--accent-level 0.5(0-1)는 단어가 얼마나 다채로워야 하는지입니다. 회색 사진은 상자가 없습니다. 완전히 채색된 로고는 많은 상자를 얻으므로 레벨을 높이십시오.- 배경 기본값은
#1d1f22입니다.--gap은 쌓인 행에서 상자 사이의 px를 설정합니다.--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 (재생/일시정지 플레이어가 있는 단일 파일)도 가능
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를 낮춥니다. - 모든 프레임에 대해 하나의 명암 범위 (그리고 braille의 경우 하나의 점 임계값)이 사용되므로 밝기가 변하지 않습니다.
- 정지 영역은 깜빡이지 않습니다: 픽셀은 값이
--steady(기본값 6, 255 중) 이상 변경될 때까지 값을 유지합니다. 거친 필름의 경우 16 이상으로 높이십시오.--steady 0은 이를 끕니다. - 인터레이스 비디오는 디인터레이스되고, 정사각형이 아닌 픽셀이 있는 비디오는 실제 모양을 유지합니다.
- 애니메이션에는
--dither를 피하십시오: 프레임마다 글리프가 움직이게 만듭니다. - GIF는 약 50fps보다 빠르게 재생될 수 없으므로 빠른 비디오는
.gif에서 일부 프레임을 잃습니다. 부드러운 60fps를 위해.mp4또는.webp를 사용하십시오.
단색 배경의 인물
밝은 배경의 어두운 인물 (예: Muybridge의 달리는 말)의 경우 --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프레임의 중앙값에서 배경을 가져옵니다. 참고:
- 대부분의 클립에서 정지해 있는 부분 (예: 머리)은 배경으로 간주되어 사라집니다.
- 그림의 가장자리가 계속 변경되면 카메라가 움직이는 것입니다: 그렇게 알리고 프레임을 그대로 둡니다. 느린 패닝은 항상 포착되지는 않으며 윤곽선을 남깁니다.
- 각 프레임이 다른 사진인 클립 (Muybridge의 말과 버팔로)에서는 대신
--bg white를 사용하십시오. --subject-cut(기본값 40, 255 중)은 픽셀이 배경과 얼마나 달라야 하는지입니다. 희미한 인물의 경우 낮추고, 노이즈가 많은 비디오의 경우 높이십시오.
정지 이미지 효과
--effect NAME은 하나의 이미지를 2~3.2초 인트로 (25fps)로 바꾸며, 완성된 아트로 끝나고 1.5초 동안 유지합니다. 모든 효과가 모든 모드와 함께 작동합니다.
matrix: 밝은 머리를 가진 글리프 기둥이 떨어지며 뒤에 아트를 남깁니다.decode: 셀이 무작위 글리프를 통해 스크램블되어 잠기며, 왼쪽에서 오른쪽으로 휩쓸립니다.scan: 밝은 CRT 라인이 아래로 휩쓸며 각 행을 입력하고, 짧은 광택이 있습니다.glitch: 찢어진 행, 글리프 교체, 빨간색/시안색 밴드의 짧은 버스트. 루프가 잘 됩니다.wave: 행이 부풀었다가 가라앉는 사인파에 의해 옆으로 흔들립니다. 루프가 잘 됩니다.
장면
--scene NAME은 코드에서 루핑 애니메이션을 그리므로 입력 파일이 필요 없습니다. 각 루프는 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 NAME ("장면" 참조).
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 # 그리드 목록; 마지막 것은 `grid`
intro = [to_png(g) for g in frames(grid, "decode")]