README.ru.md

Frame Splitter

Инструмент для преобразования анимированных PNG, GIF файлов в атласные карты.

Описание

Этот скрипт позволяет:

• Извлекать отдельные кадры из анимированных PNG файлов
• Создавать горизонтальные атласные карты из кадров анимации
• Обрабатывать как отдельные файлы, так и целые директории с PNG файлами
• Сохранять пропорции и размеры исходных кадров в атласной карте

Требования

• Python 3.x
• Pillow 10.2.0

Установка

1. Клонируйте репозиторий:

git clone https://github.com/Chi-Firka/frame-splitter.git
cd frame-splitter

2. Установите зависимость одним из способов:

pip install Pillow==10.2.0
# или
pip install -r requirements.txt

Использование

Обработка одного файла

python frame-splitter.py "path/to/file.png(.gif)"

Обработка директории

python frame-splitter.py "path/to/directory"

Результаты

• При обработке одного файла: создается новый файл с суффиксом _atlas.png в той же директории
• При обработке директории: создается поддиректория atlas_output, сохраняя структуру исходной директории

Особенности

• Поддерживаются кадры любого размера
• Выходная атласная карта сохраняет высоту исходных кадров
• Ширина атласной карты равна (количество кадров × ширина кадра)
• Поддерживается прозрачность (формат RGBA)
• Автоматическое создание необходимых директорий для выходных файлов

Пример

py frame-splitter.py "E:\Desktop\sprite-splitter\av.gif"

Из: av.gif (90x90)

В: av_atlas.png (720x90)

License

MIT License

Для большей информации, читать LICENCE.md