Изображения

Извлечь палитру изображения

Показывает основные цвета снимка с долями в процентах и умеет сохранить результат в JSON.

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

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

Скрипт приводит изображение к небольшой палитре методом медианного разрезания и считает, какую площадь занимает каждый цвет. Полученные HEX-коды удобно использовать для сайта, обложек и оформления. Файлы не изменяются, при необходимости отчет пишется в JSON.

Запуск

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

python extract_palette.py --dir ./photos --colors 8

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python extract_palette.py --input ./cover.jpg --colors 6
  • python extract_palette.py --dir ./photos --colors 10 --json palette.json --recursive
Зависимости

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

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
Исходник

extract_palette.py

#!/usr/bin/env python3
"""Извлечение доминирующих цветов изображения."""
from __future__ import annotations

import argparse
import json
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 collect(source: Path, recursive: bool) -> list[Path]:
    if source.is_file():
        return [source]
    pattern = "**/*" if recursive else "*"
    return sorted(
        path for path in source.glob(pattern)
        if path.is_file() and path.suffix.lower() in EXTENSIONS
    )


def colors_for(path: Path, count: int) -> list[dict]:
    with Image.open(path) as opened:
        image = ImageOps.exif_transpose(opened)
        if "A" in image.getbands():
            rgba = image.convert("RGBA")
            background = Image.new("RGB", rgba.size, (255, 255, 255))
            background.paste(rgba, mask=rgba.getchannel("A"))
            image = background
        else:
            image = image.convert("RGB")
        quantized = image.quantize(colors=count, method=Image.Quantize.MEDIANCUT)
        palette = quantized.getpalette()
        raw = quantized.getcolors(maxcolors=count) or []
    total = sum(item[0] for item in raw) or 1
    result = []
    for amount, index in sorted(raw, reverse=True):
        red, green, blue = palette[index * 3:index * 3 + 3]
        result.append(
            {
                "hex": f"#{red:02x}{green:02x}{blue:02x}",
                "percent": round(amount * 100 / total, 2),
            }
        )
    return result


def main() -> int:
    parser = argparse.ArgumentParser(description="Извлечь палитру изображения")
    parser.add_argument("--input", type=Path)
    parser.add_argument("--dir", type=Path)
    parser.add_argument("--colors", type=int, default=8)
    parser.add_argument("--recursive", action="store_true")
    parser.add_argument("--json", type=Path)
    args = parser.parse_args()

    if bool(args.input) == bool(args.dir):
        parser.error("Укажите либо --input, либо --dir")
    if not 2 <= args.colors <= 64:
        parser.error("--colors должен быть от 2 до 64")
    source = (args.input or args.dir).expanduser().resolve()
    if not source.exists():
        parser.error(f"Источник не найден: {source}")
    files = collect(source, args.recursive)
    if not files:
        print("Изображения не найдены.")
        return 0

    report = []
    for path in files:
        try:
            colors = colors_for(path, args.colors)
        except Exception as error:
            print(f"Ошибка {path}: {error}")
            continue
        report.append({"file": str(path), "colors": colors})
        print(f"{path.name}:")
        for item in colors:
            print(f"  {item['hex']}  {item['percent']:.2f}%")

    if args.json:
        report_path = args.json.expanduser().resolve()
        report_path.parent.mkdir(parents=True, exist_ok=True)
        report_path.write_text(
            json.dumps(report, ensure_ascii=False, indent=2) + "\n",
            encoding="utf-8",
        )
        print(f"Отчет сохранен: {args.json}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

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

CLI 1.0.0

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

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

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

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

Категория

Изображения

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