﻿Image2PDF - плагин-архиватор для Total Commander
Версия 1.6 (30.10.2026)

Copyright (C) 2026 Andrei Piasetski
Лицензия: GNU General Public License версии 3 или более поздней (см. LICENSE.txt)
Исходный код: https://github.com/apiasetski/Image2PDF


НАЗНАЧЕНИЕ
----------
Упаковывает выделенные в Total Commander изображения в один PDF-файл,
по одному изображению на страницу. Выделите изображения, нажмите Alt+F5
(Упаковать файлы), выберите упаковщик "pdf" и нажмите OK.

 * JPEG встраивается байт в байт: без пересжатия и без потери качества.
 * PNG встраивается без потерь, включая прозрачность (альфа-канал).
 * BMP, GIF, TIFF (все страницы), WebP, HEIC, AVIF и другие форматы, которые
   умеет открывать Windows, тоже конвертируются.
 * Страницы идут в "естественном" порядке имён (img2 перед img10),
   в том числе при выделении подпапок; либо как в панели, по дате файла
   или по дате съёмки.
 * Размеры страниц A3, A4, A5, Letter, Legal или свой; вписать или
   заполнить.
 * Закладки для папок и файлов; название и автор в свойствах PDF.
 * Уменьшение размера файла (по желанию) для сканов и фото с телефона.
 * Фотографии поворачиваются по ориентации из EXIF (можно отключить).
 * Файлы, не являющиеся изображениями, пропускаются.
 * Русский и английский интерфейс; 32- и 64-битный Total Commander;
   без внешних библиотек.


УСТАНОВКА
---------
Откройте архив плагина в Total Commander (Enter на zip-файле) и
подтвердите установку. Total Commander скопирует плагин и свяжет с ним
расширение "pdf".

Плагин регистрируется как "скрытый": Enter на обычном .pdf-файле
по-прежнему открывает ваш просмотрщик PDF.

Обновление: установите новый архив тем же способом. Настройки сохраняются.


НАСТРОЙКИ
---------
В диалоге упаковки (Alt+F5) выберите "pdf" и нажмите "Настройка".

Страница
 * Размер            - По размеру изображения: страница точно по размеру
                       картинки. A3, A4, A5, Letter, Legal или Свой размер
                       (ширина x высота в мм): изображение размещается
                       внутри полей.
 * Разрешение        - число пикселей на дюйм для режима "По размеру
                       изображения" и для "Не увеличивать маленькие
                       изображения".
 * Поля              - поля страницы в миллиметрах.
 * Размещение        - Вписать в страницу: изображение видно целиком.
                       Заполнить страницу: изображение закрывает всю
                       область внутри полей, лишнее обрезается.
 * Выравнивание      - По центру или По верхнему краю (свободное место
                       остаётся внизу).
 * Всегда книжная    - все страницы книжные. Если выключено, для широких
                       изображений страница поворачивается.
 * Не увеличивать маленькие изображения - маленькие картинки сохраняют
                       свой размер (при указанном разрешении), а не
                       растягиваются.
 * Поворачивать фото по EXIF.

Документ
 * Порядок страниц   - По имени (img2 перед img10); Как в панели; По дате
                       файла; По дате съёмки (EXIF, если её нет - дата
                       файла). Сортировка по дате идёт внутри каждой папки.
 * Закладки          - Нет; По одной на папку (каждая выделенная
                       подпапка); По одной на файл; Папки и файлы (файлы
                       вложены в свои папки).
 * Автор             - записывается в PDF. Название - имя PDF-файла.

Размер файла (по умолчанию выключено: без вашего желания ничего не
пересжимается)
 * Уменьшить размер файла - изображения с разрешением выше "Макс.
                       разрешения" уменьшаются до него (считается по
                       размеру на странице, поэтому важнее всего для A4 и
                       других форматов бумаги). Фото сохраняются в JPEG с
                       заданным качеством; PNG, BMP, TIFF остаются без
                       потерь. Изображения, которые и так достаточно малы и
                       не требуют смены цвета, остаются без изменений.
 * Цвета             - Без изменений, Оттенки серого или Чёрно-белое
                       (1 бит на пиксель, простой порог 50%: хорошо для
                       текста, не для фотографий).

Язык: "Автоматически" - как в Total Commander (русский, если выбран
русский языковой файл, иначе английский), либо English или Русский.

Настройки сохраняются в image2pdf.ini в папке плагина и действуют для всех
последующих упаковок.

Ход выполнения: окно прогресса Total Commander продвигается постранично,
в том числе внутри многостраничных TIFF, а "Отмена" останавливает
упаковку на следующей странице; файл в этом случае не создаётся.


ПОДДЕРЖИВАЕМЫЕ ИЗОБРАЖЕНИЯ
--------------------------
Встраиваются как есть, без преобразования:
 * JPEG: baseline и progressive; оттенки серого, RGB и CMYK.
 * PNG: оттенки серого, RGB и палитра, любая глубина цвета, с альфа-каналом
   и без него (не interlaced).

Конвертируются через Windows Imaging Component (входит в Windows):
 * BMP, GIF (первый кадр), ICO, TIFF (каждая страница становится страницей
   PDF), PNG с чересстрочной развёрткой и редкие варианты JPEG - без потерь;
   чёрно-белые сканы остаются 1-битными.
 * WebP, HEIC, AVIF, JPEG XR и RAW-файлы камер - сохраняются как JPEG
   (качество 90), так как эти форматы и так сжаты с потерями.
 * Прозрачность сохраняется.
 Для HEIC нужны "Расширения для изображений HEIF" и "Расширения для видео
 HEVC" из Microsoft Store, для AVIF - "Расширение видео AV1", для WebP на
 старых версиях Windows 10 - "Расширения для изображений WebP". Если кодека
 нет, упаковка останавливается с сообщением, в котором указан файл.

Игнорируются: прозрачность палитры PNG (tRNS), цветовые профили и гамма.


ОГРАНИЧЕНИЯ
-----------
 * Только упаковка: плагин не открывает, не показывает и не распаковывает
   PDF-файлы.
 * Добавить страницы в существующий PDF нельзя. При упаковке в файл с уже
   существующим именем выводится сообщение; существующий файл не меняется.
 * Изображения больше 2 ГБ не поддерживаются.


ИСТОРИЯ ВЕРСИЙ
--------------
1.6  Размеры A3, A5, Legal и свой; заполнение с обрезкой, выравнивание по
     верху, "Не увеличивать маленькие изображения". Закладки для папок и
     файлов. Название и автор. Уменьшение размера файла (разрешение,
     качество JPEG, оттенки серого, чёрно-белое). Порядок как в панели,
     по дате файла или дате съёмки. Русский интерфейс. Прогресс и отмена
     внутри многостраничных TIFF.
1.5  BMP, GIF, TIFF (многостраничные), WebP, HEIC, AVIF и другие форматы
     через Windows Imaging Component. Теперь поддерживается interlaced PNG.
1.4  Первый публичный выпуск под лицензией GNU GPL. Файл настроек больше
     не входит в архив, поэтому обновление сохраняет ваши настройки.
1.3  Понятное сообщение, если среди выделенных файлов нет JPEG или PNG.
1.2  Понятное сообщение, если PDF-файл с таким именем уже существует.
1.1  Окно настроек; параметр "Always portrait" для A4 и Letter.
1.0  Первая версия.


ЛИЦЕНЗИЯ
--------
Эта программа является свободным программным обеспечением: вы можете
распространять и/или изменять её на условиях GNU General Public License,
опубликованной Free Software Foundation, версии 3 либо (по вашему выбору)
любой более поздней версии.

Программа распространяется в надежде, что она будет полезна, но БЕЗ КАКИХ-
ЛИБО ГАРАНТИЙ, даже без подразумеваемых гарантий ТОВАРНОЙ ПРИГОДНОСТИ или
ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЁННОЙ ЦЕЛИ. Подробнее см. GNU General Public License
(LICENSE.txt).
