Собрать коллаж из папки
Раскладывает фотографии сеткой с отступами и фоном, обрезая каждую по центру под размер ячейки.
Что делает скрипт
Скрипт сортирует файлы по имени, приводит каждый кадр к квадратной ячейке и собирает общее полотно. Количество колонок, размер ячейки, отступы и цвет фона задаются параметрами. Результат сохраняется в новый файл, исходные изображения не меняются.
Быстрый старт
python build_collage.py --dir ./photos --out ./collage.jpg --columns 4 --cell 400
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python build_collage.py --dir ./photos --out ./collage.jpgpython build_collage.py --dir ./photos --out ./collage.png --columns 3 --cell 600 --gap 16 --background #f8fafc
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install Pillow
python3 -m pip install Pillow
python3 -m pip install Pillow
build_collage.py
#!/usr/bin/env python3
"""Сборка коллажа из изображений папки."""
from __future__ import annotations
import argparse
import math
import sys
from pathlib import Path
try:
from PIL import Image, ImageOps
except ImportError:
sys.exit("Нужен Pillow: python3 -m pip install Pillow")
EXTENSIONS = {".jpg", ".jpeg", ".png", ".webp", ".bmp", ".tif", ".tiff"}
def parse_color(value: str) -> tuple[int, int, int]:
text = value.strip().lstrip("#")
if len(text) != 6:
raise argparse.ArgumentTypeError("цвет нужен в формате #rrggbb")
try:
return tuple(int(text[index:index + 2], 16) for index in (0, 2, 4))
except ValueError as error:
raise argparse.ArgumentTypeError(f"неверный цвет: {value}") from error
def collect(root: Path, recursive: bool) -> list[Path]:
pattern = "**/*" if recursive else "*"
return sorted(
path for path in root.glob(pattern)
if path.is_file() and path.suffix.lower() in EXTENSIONS
)
def flatten(image: Image.Image, background: tuple[int, int, int]) -> Image.Image:
if image.mode in ("RGBA", "LA") or (image.mode == "P" and "transparency" in image.info):
rgba = image.convert("RGBA")
canvas = Image.new("RGB", rgba.size, background)
canvas.paste(rgba, mask=rgba.getchannel("A"))
return canvas
if image.mode != "RGB":
return image.convert("RGB")
return image
def main() -> int:
parser = argparse.ArgumentParser(description="Собрать коллаж из папки")
parser.add_argument("--dir", type=Path, required=True)
parser.add_argument("--out", type=Path, required=True)
parser.add_argument("--columns", type=int, default=4)
parser.add_argument("--cell", type=int, default=400)
parser.add_argument("--gap", type=int, default=8)
parser.add_argument("--background", type=parse_color, default=(255, 255, 255))
parser.add_argument("--recursive", action="store_true")
parser.add_argument("--overwrite", action="store_true")
args = parser.parse_args()
if args.columns < 1:
parser.error("--columns должен быть больше нуля")
if args.cell < 32:
parser.error("--cell должен быть не меньше 32")
if args.gap < 0:
parser.error("--gap не может быть отрицательным")
root = args.dir.expanduser().resolve()
if not root.is_dir():
parser.error(f"Папка не найдена: {root}")
target = args.out.expanduser().resolve()
if target.exists() and not args.overwrite:
print(f"Файл уже существует: {target}. Добавьте --overwrite.")
return 2
target.parent.mkdir(parents=True, exist_ok=True)
files = collect(root, args.recursive)
if not files:
print("Изображения не найдены.")
return 0
columns = min(args.columns, len(files))
rows = math.ceil(len(files) / columns)
width = columns * args.cell + (columns + 1) * args.gap
height = rows * args.cell + (rows + 1) * args.gap
canvas = Image.new("RGB", (width, height), args.background)
placed = 0
for path in files:
try:
with Image.open(path) as opened:
image = flatten(ImageOps.exif_transpose(opened), args.background)
tile = ImageOps.fit(
image,
(args.cell, args.cell),
method=Image.Resampling.LANCZOS,
centering=(0.5, 0.5),
)
except Exception as error:
print(f"Пропуск {path}: {error}")
continue
column = placed % columns
row = placed // columns
left = args.gap + column * (args.cell + args.gap)
top = args.gap + row * (args.cell + args.gap)
canvas.paste(tile, (left, top))
placed += 1
if placed == 0:
print("Не удалось прочитать ни одного изображения.")
return 1
if target.suffix.lower() == ".png":
canvas.save(target, format="PNG", optimize=True)
else:
canvas.save(target, format="JPEG", quality=90, optimize=True, progressive=True)
print(f"Коллаж сохранен: {target} ({placed} изображений, {width}x{height})")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.