﻿Image2PDF - packer plugin for Total Commander
Version 1.4 (2026-10-28)

Copyright (C) 2026 Andrei Piasetski
License: GNU General Public License, version 3 or later (see LICENSE.txt)
Source code: https://github.com/apiasetski/Image2PDF


WHAT IT DOES
------------
Packs the image files selected in Total Commander into one PDF file,
one image per page. Select the images, press Alt+F5 (Pack files),
choose "pdf" as the packer and press OK.

 * JPEG images are embedded byte for byte: no recompression, no quality loss.
 * PNG images are embedded losslessly, including transparency (alpha channel).
 * Pages follow the natural name order (img2 before img10), also across
   selected subfolders.
 * Photos are turned upright using their EXIF orientation (can be switched off).
 * Files that are not JPEG or PNG are skipped.
 * No external libraries; 32-bit and 64-bit Total Commander.


INSTALLATION
------------
Open the plugin archive in Total Commander (Enter on the zip file) and
confirm the installation prompt. Total Commander copies the plugin and
associates the "pdf" extension with it.

The plugin is registered as "hidden": Enter on an ordinary .pdf file still
opens your PDF viewer.

Updating: install the new archive the same way. Your settings are kept.


SETTINGS
--------
In the Pack files dialog (Alt+F5) choose "pdf" and click "Configure":

 * Page size
     Original image size - every page is exactly as large as its image;
                           "Resolution" sets how many pixels make an inch.
     A4 / Letter         - fixed paper size; the image is scaled to fit
                           inside the margin and centred.
 * Margin                - paper margin in millimetres (A4/Letter).
 * Always portrait       - A4/Letter only. When ticked, every page is portrait
                           and wide images are scaled down to the page width.
                           When not ticked, wide images get a landscape page.
 * Turn JPEG photos upright using their EXIF orientation.

The settings are saved in image2pdf.ini in the plugin folder and apply to
every following pack.


SUPPORTED IMAGES
----------------
 * JPEG: baseline and progressive; grayscale, RGB and CMYK.
 * PNG: grayscale, RGB and palette images, all bit depths, with or without
   alpha channel.

Not supported:
 * Other formats (BMP, GIF, TIFF, WebP, HEIC, ...) - skipped.
 * Interlaced PNG; arithmetic-coded, lossless or 12-bit JPEG - packing stops
   with a message naming the file.
 * PNG palette transparency (tRNS), colour profiles and gamma are ignored.


LIMITATIONS
-----------
 * Pack only: the plugin cannot open, list or extract PDF files.
 * Pages cannot be added to an existing PDF. Packing onto a file name that
   already exists stops with a message; the existing file is not changed.
 * Images larger than 2 GB are not supported.


VERSION HISTORY
---------------
1.4  First public release under the GNU GPL. The package no longer contains
     a settings file, so updating keeps your settings.
1.3  Clear message when none of the selected files is a JPEG or PNG image.
1.2  Clear message when the target PDF already exists.
1.1  Settings window; "Always portrait" option for A4 and Letter.
1.0  First version.


LICENSE
-------
This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details (LICENSE.txt).
