Files
scripts/image/crop_image_to_object_pixels.md
2024-12-02 19:38:23 +03:00

66 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Руководство по использованию скрипта для обрезки PNG изображений
Этот скрипт предназначен для обрезки PNG изображений в указанной папке, чтобы сохранить только видимый объект, удаляя пустое пространство вокруг. Обрезка выполняется с использованием информации о непрозрачных пикселях изображения.
## Требования
Перед запуском скрипта убедитесь, что установлены следующие библиотеки:
- **Pillow**: для обработки изображений.
Установите их с помощью команды:
```bash
pip install Pillow
```
## Как использовать
### Запуск скрипта
1. Скачайте или скопируйте скрипт на ваш компьютер.
2. В командной строке запустите скрипт, указав путь к папке с PNG изображениями:
```bash
python script.py <путь_к_входной_папке> [путь_к_выходной_папке]
```
- **<путь_к_входной_папке>** — путь к папке с PNG изображениями, которые необходимо обработать.
- **[путь_к_выходной_папке]** (необязательный параметр) — путь к папке, куда будут сохранены обработанные изображения. Если не указать, изображения сохранятся в той же папке, что и входные.
### Пример использования
```bash
python script.py /path/to/images /path/to/output
```
Если не указать выходную папку, изображения будут обработаны и сохранены в той же папке:
```bash
python script.py /path/to/images
```
### Что делает скрипт?
- Скрипт перебирает все PNG изображения в указанной входной папке.
- Для каждого изображения он находит границы видимых объектов (то есть непрозрачных пикселей).
- Затем изображение обрезается до этих границ и сохраняется в выходной папке.
### Пример вывода
При обработке каждого изображения в консоль выводится сообщение:
```
Processed image1.png
Processed image2.png
```
## Возможности
- Скрипт поддерживает работу с папками, содержащими несколько изображений.
- Если выходная папка не указана, скрипт создает её автоматически или использует входную папку для сохранения результатов.
## Примечание
Скрипт работает только с изображениями формата PNG.