Изображения

Собрать коллаж из папки

Раскладывает фотографии сеткой с отступами и фоном, обрезая каждую по центру под размер ячейки.

Python Windows macOS Linux Средний
Скачать build_collage.py
Описание

Что делает скрипт

Скрипт сортирует файлы по имени, приводит каждый кадр к квадратной ячейке и собирает общее полотно. Количество колонок, размер ячейки, отступы и цвет фона задаются параметрами. Результат сохраняется в новый файл, исходные изображения не меняются.

Запуск

Быстрый старт

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.jpg
  • python build_collage.py --dir ./photos --out ./collage.png --columns 3 --cell 600 --gap 16 --background #f8fafc
Зависимости

Что понадобится

Python 3.10+ Интерпретатор Python
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Pillow Открытие, обработка и сохранение изображений
Windows py -m pip install Pillow
macOS python3 -m pip install Pillow
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get images-build-collage
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Изображения

Конвертация, сжатие, водяные знаки, каталоги и пакетная обработка фото.