ascii-art README

README проекта с github.com/0xSero/ascii-art. Одним файлом markdown: README.md.

ascii-art

Turn any photo, sculpture, object or drawing into a figure made of dots on a fixed grid — charcoal ground, two grey tones, rare crimson — then animate it into a seamless loop: disintegration into wind-blown dust, things emerging or growing out of the figure, voids, tentacles, fine-stipple creatures.

This repo is the skill: the method, the engine, and the scripts that do the mechanical parts.

source image ──photo_dots/mask──► dot map (text) ──render_map──► still
                                        │
                                   scene JSON ──build_scene──► self-contained HTML (render(tt))
                                                          └──grab_frames──► PNG frames ──ffmpeg──► MP4

Requirements

pip install numpy scipy pillow scikit-image playwright
python -m playwright install chromium

Quickstart

# 1. image -> dot map.  rows, then the bright/mid percentiles of the subject's own tones
python scripts/photo_dots.py photo.jpg map.txt 52 58 86

# 2. look at the still before anything moves
python scripts/render_map.py map.txt still 0.6

# 3. scene JSON -> animated page
python scripts/build_scene.py examples/scenes/bust-dust.scene.json out.html

# 4. frames, then encode
python scripts/grab_frames.py out.html frames 30 12      # fps, seconds
ffmpeg -framerate 30 -i frames/f%04d.png -c:v libx264 -crf 16 -pix_fmt yuv420p \
       -movflags +faststart piece.mp4

grab_frames.py out.html sheet.png sheet captures a contact sheet instead of frames.

The look

Element Rule
Ground flat #161616, never pure black
Lattice one fixed grid, tall cells (≈19 × 36 px), every still dot on a cell centre
Two tones bright #f2f2f0 (r ≈ 6.5) and dim #70706e (r ≈ 2.85), nudged 7 px down
Accent crimson #dc143c, rare, only on things that move
Grain subject = coarse lattice; visitors, voids, far dust = fine stipple

Coverage matters more than contrast: most subject cells should be bright; dim dots are shadow accents, empty cells are line art (eyes, mouth, the deepest folds).

Tools

Script Purpose
scripts/photo_dots.py IMG OUT ROWS [top% mid%] image → dot map (env BLUR, MIX, ISO)
scripts/render_map.py MAP OUT [scale] map → PNG + SVG
scripts/rotate_map.py MAP DEG SCALE OUT tilt or scale a map on the same grid
scripts/build_scene.py SCENE.json OUT.html scene → animated page (assets/engine.js)
scripts/grab_frames.py HTML OUT|DIR ... contact sheet or all frames, headless

Docs

Examples

examples/scenes/*.json and examples/bust-skull.map.txt are the scenes and dot map of one finished piece. The reference photographs they point at are not included (third-party imagery), so the scenes document structure rather than run as-is; bust-skull.map.txt is enough to build the figure layers.

License

MIT — see LICENSE. It covers this code and text only. Any image you feed the scripts stays yours (or its owner's); nothing here grants rights to it.

ascii-art (0xSero/ascii-art)

Ищем в базе…

Что это?Набор инструментов, который превращает фотографию, скульптуру или рисунок в двухтоновую фигуру из точечной решётки на фиксированной сетке, а затем анимирует её в бесшовное зацикленное видео (распад в пыль, рост, пустоты, щупальца).
Это приложение или набор скриптов, которые я запускаю сам?Это набор скриптов на Python и JavaScript (движок и конвейер утилит командной строки), а не приложение с графическим интерфейсом: каждый скрипт вы запускаете вручную из командной строки.
Как превратить фотографию в одну из таких анимаций?Запустите photodots.py для изображения, чтобы получить карту точек, затем rendermap.py, чтобы превратить карту в PNG/SVG, buildscene.py, чтобы собрать анимированную HTML-страницу по JSON-описанию сцены, а затем grabframes.py, чтобы снять кадры или контактный лист с этой страницы.
Что нужно установить, чтобы всё заработало?Python 3.10+ с numpy, scipy, Pillow и scikit-image, Playwright со сборкой Chromium и ffmpeg для кодирования кадров в видео.
Можно ли просто запустить примеры сцен, чтобы увидеть, как это работает?Нет, сразу не получится: примеры сцен ссылаются на фотографии сторонних авторов, которых нет в репозитории, поэтому они показывают структуру, а не работают как есть.
Для кого это?Для художников и моушн-дизайнеров, которым нужен воспроизводимый метод создания анимаций точечных фигур вместо ручной прорисовки каждого кадра.
Как на самом деле выглядит точечная сетка?Это фиксированная решётка из вытянутых по вертикали ячеек на почти чёрном фоне (#161616), с точками двух оттенков серого (светлый #f2f2f0 и тусклый #70706e) и редким малиновым акцентом (#dc143c), который приберегается для движущихся элементов.
Для чего нужен SKILL.md?В нём описано ремесло, стоящее за этим стилем: пошаговый метод, словарь движения, математика зацикливания и контрольный список для проверки работы при создании композиции.
Нужен ли для рендеринга браузер?Да: сцены собираются в виде HTML-страниц и снимаются без открытия окна браузера через сборку Chromium из Playwright, чтобы получить кадры или контактный лист.
Кому принадлежат изображения, которые я в него загружаю?Вам: лицензия MIT распространяется только на код и документацию, но не на изображения, которые вы обрабатываете скриптами.
Автор
0xSero
Размер
<0.1 MB
Звёзды
274
Обновлён
КоммитOct 25
Возраст
24 д
Коммиты · 90 дней