﻿=================================================
[Software     name]  PDF image extraction Ver.3.4
[Registered   name]  PDFTools.zip
[Copyright  holder]  A.MORICHIKA m_akira@ka2.so-net.ne.jp
[Compatible models]  Windows 11/10 64bit version.
[Required      DLL]  .NET Framework 4.8.1
[Software     type]  Free software
=================================================
[Software introduction]

+ Overview.

 A tool that extracts only images from PDF files that contain images.

 If you drag and drop the file, the image data will be saved in the specified folder.

 Since it uses XpdfLib, you can call commands to convert to text, etc.

 Besides, you can convert pbm, pgm, ppm, wmf, emf, ico, tif, jpg, gif, png, bmp format image files to jpg, gif, png, bmp format.

+ Description of the file.

    <Unzip folder>
    .\ReadMe.txt        : Japanese file.
    .\ReadMe_en.txt     : This file.
    .\PDFTools.exe      : Installer


+ How to install.

 Please unblock the decompressed file from the file properties.

 Confirm that the extracted configuration is in the above state, and run PDFTools.exe to start installation.

 To uninstall, go to "Add or Remove Programs" in the Control Panel.
 The program name is "PDF image extraction".

 ".NET Framework 4.8.1" is required for operation.
 https://dotnet.microsoft.com/en-us/download/dotnet-framework/thank-you/net481-web-installer


+ Precautions.

 If you use the Xpdf command for garbled characters, you need to prepare an Xpdf environment for each language.

 You cannot specify wildcards in the file name when started with a command.


+ Simple usage instructions.

 When started, a dialog will be displayed.

 If you drag and drop the target PDF file from Explorer, the image file (jpg, ppm) will be extracted to the output folder.

 If there are multiple images, a number is added to the file name.

 Shortcut link files are also included.

 A ring-shaped button is displayed during extraction. If you want to cancel, please press.

 Once extraction is complete, you can display the image list by pressing F6.

 The conversion result (PDFTools.log, IMGTools.log for image conversion) remains in the output folder.

 If no image data is included, a warning message will be logged.

 Also, password protected PDFs cannot be extracted.

 The log file is updated when the application is closed.

 The following functions are assigned to the keyboard.

 F3: Register/Unregister for "Send to". (*1)
 F4: Launch Xpdf command.
 F5: Start image conversion.
 F6: Display extracted images. (*2,*3)
 F7: Display log contents.


+ Other.

 You can also extract the files by selecting them from Explorer, clicking "Send to" and then "PDF image extraction." (*4)

 It can also be extracted by specifying the following arguments in the executable file.

     PDFTools.exe /pdf C:\Document\*.pdf /out C:\Temp

     ⇒ Extract all PDFs in the 'C:\Document' folder to the 'C:\Temp' folder. (Including log)

     /pdf <PDF file path name> (Wildcards can be used in the file name)
     /out <output path name>   (setting value if omitted, initial value is picture folder)

 The following arguments can be specified in the shortcut properties as log specifications.

     PDFTools.exe /log C:\LOG\MyLogFile.txt

     ⇒ Create a log file as C:\LOG\MyLogFile.txt.

     PDFTools.exe /log no

     ⇒ Do not create a log file.

 You can also specify the image type and extract.

     PDFTools.exe /png

     ⇒ Convert the dragged and dropped PDF to png format and extract the image.

 Besides, you can convert pbm, pgm, ppm, wmf, emf, ico, tif, jpg, gif, png, bmp format image files to jpg, gif, png, bmp format.

    PDFTools.exe /img C:\Pictures\*. ppm /out C:\Temp /jpg

    ⇒ Convert all PPMs in the 'C:\Pictures' folder to jpg in the 'C:\Temp' folder. (/jpg can be omitted)

    If the path name contains a space, enclose the path name in "". (Do not add \ to the end of the path name)

    /img <image file path name> (Wildcards can be used in the file name)
    /out <output path name> (setting value if omitted, initial value is picture folder)

    /jpg Convert to JPG format. (set value if omitted, initial value is JPG format)
    /gif Convert to GIF format.
    /png Convert to PNG format.
    /bmp Convert to BMP format.
    /w+  Overwrites existing files. (write-protected files are excluded)
    /w-  Does not update existing files.
    /n+  Searches the entire specified folder.
    /n-  Does not search subfolders of the specified folder.
    /end Ends after conversion.

    /log <log file path name> (fixed value if not specified)
    /log no (does not create log)

    /ImageConv   Starts as an image conversion tool.
    /Thumbnail   Launches as an image display tool. (*5)
    /Command     Launches as a command tool.

 The Xpdf library is used for conversion. You can specify the command as an argument in batch or shortcut.

     1.pdfdetach : Extract the part attached to the PDF as a file.
                   https://www.xpdfreader.com/pdfdetach-man.html
     2.pdffonts  : Display PDF font information.
                   https://www.xpdfreader.com/pdffonts-man.html
     3.pdfimages : Extract images from PDF.
                   https://www.xpdfreader.com/pdfimages-man.html
     4.pdfinfo   : Display property information of PDF documents, etc.
                   https://www.xpdfreader.com/pdfinfo-man.html
     5.pdftohtml : Convert PDF to HTML format.
                   https://www.xpdfreader.com/pdftohtml-man.html
     6.pdftopng  : Convert each page of PDF to PNG image.
                   https://www.xpdfreader.com/pdftopng-man.html
     7.pdftoppm  : Convert PDF to PPM image format.
                   https://www.xpdfreader.com/pdftoppm-man.html
     8.pdftops   : Convert PDF to PostScript file.
                   https://www.xpdfreader.com/pdftops-man.html
     9.pdftotext : Extract text from PDF.
                   https://www.xpdfreader.com/pdftotext-man.html

     This tool makes use of the pdfimages command.

example:
     PDFTools.exe pdftopng -h
                  ~~~↑~~~ ~↑
              Command name, parameters

     PDFTools.exe pdftopng d:\Sample\Test.pdf d:\Temp\Test
                           ~~~~~~~~↑~~~~~~~~
              If the file path name contains a half-width space, enclose the file path name in "".
     The running message is displayed in text when finished. (Add -q to suppress the display)

 (*1) To release it, press the Ctrl and F3 keys simultaneously.
 (*2) After extraction, you can convert the extracted images.
 (*3) Before extraction, you can convert the images in the specified folder. (You can select a folder by pressing the F4 key)
 (*4) Advance registration using the F3 key is required.
 (*5) You can specify a folder by using /Thumbnail <image folder name>.


+ Version history.

    Ver.3.4   2026.1.17

    - Added a command launch page to the F4 key.
    - Prevents extraction of duplicate images.
    - Added support for updating the Xpdf library (Ver.4.06).
    - The library has been changed from .NET Framework 4.8 to 4.8.1.
    - Rebuilt using Microsoft Visual Studio 2026 Community.

    Ver.3.3   2025.4.5

    - Operating environment is limited to 64-bit version.
    - Added display of extracted image files.
    - Added verification of identical files to the image conversion tool.
    - Added image formats (png, jpg, bmp, gif) to the menu.

    Ver.3.2   2024.6.28

    - Fixed a bug that caused to freeze when confirming an interruption.

    Ver.3.1   2024.5.5

    - Added support for updating the Xpdf library (Ver.4.05).

    Ver.3.0   2023.4.24

    - Improved the number of files to "Send to" from Explorer.

    Ver.2.9   2023.3.1

    - Removed Windows 8 from supported models.
    - Changed the version of .NET Framework to 4.8.

    Ver.2.8   2022.11.18

    - Added support for dark mode switching on Windows 10 and later.

    Ver.2.7   2022.8.10

    - Added support for updating the Xpdf library (Ver.4.04).

    Ver.2.6   2022.4.1

    - Added support for English version resources.

    Ver.2.5   2022.3.10

    - Fixed a bug that the /out parameter could not be set.
    - Changed to end after conversion with the /end parameter.
    - It is now possible to specify /pdf and image type (either /jpg /gif /png /bmp).

    Ver.2.4   2021.11.11

    - We have confirmed the operation on the Windows 11 product version.
    - Added support for updating the Xpdf library (Ver.4.03).
    - Rebuilt with the latest version of Microsoft Visual Studio 2022 Community.

    Ver.2.3   2020.10.1

    - Fixed a bug that characters are blurred at DPI other than 100%.
    - Changed the version of .NET Framework to 4.7.2.

    Ver.2.2   2020.2.20

    - Support for Windows 7 has ended.
    - Added support for updating the Xpdf library (Ver.4.02).
    - Changed the version of .NET Framework to 4.7.
    - Rebuilt with the latest version of Microsoft Visual Studio 2019 Community.

    Ver.2.1   2019.2.11

    - Fixed a bug that the menu is not updated with Alt+Space.

    Ver.2.0   2018.11.1

    - For exclusive control, multiple startups are no longer possible.

    Ver.1.9   2018.8.20

    - Changed to confirm the interruption by pressing the x button during conversion.

    Ver.1.8   2018.7.23

    - Arranged the line breaks displayed in the log.
    - Changed to verify the length of the path.
    - Fixed a bug that ended with continuous conversion.
    - Changed to record the information that failed to be converted.
    - Fixed the bug that the check box setting is not reflected.

    Ver.1.7   2018.7.18

    - Improved thread processing.
    - Integrated functions with image conversion tools.
    - Reviewed the structure and ported the U/I part from C++ to C#.
    - Enabled to call Xpdf commands from arguments.
    - Changed the name of the installer from setup.exe to PDFTools.exe.

    Ver.1.6   2018.2.10

    - The installation name has been changed to Japanese.

    Ver.1.5   2017.10.1

    - Fixed the bug that an error occurs in the second and subsequent conversions.
    - The output destination of the log can be specified by the argument.
    - If the log file cannot be updated, it is saved with a different name.

    Ver.1.4   2017.9.19

    - Updated the Xpdf library.
    - Changed to leave a log file.
    - Adjusted the display position of the interrupt button.
    - The window is not hidden.
    - Added the option to separate by folder.
    - Due to lack of funds, the contract with the certification body could not be renewed, and the digital signature was stopped.

    Ver.1.3   2014.3.28

    - The file size of the setup has been reduced.
    - A digital signature has been added to the module.

    Ver.1.2   2014.2.20

    - File extraction can now be stopped with a button.
    - Enabled conversion of ppm format files to jpg, gif, png, bmp from the command line.
    - Corrected the image of the icon.

    Ver.1.1   2014.2.2

    - Selected from Explorer and can be extracted by "Send".
    - Added command argument options.

    Ver.1.0   2014.1.26

    - First edition released.

-----------------------------------------------------------------

+ Copyright and Disclaimer, etc.

 This software is free software.
 I have the copyright of this program.
 The author assumes no responsibility for any damages or disabilities resulting from the use of this program.
 The author is not obligated to fix bugs or upgrade.
 There are no restrictions on reprinting and distribution by communication and personal handing as long as there are no changes to the contents.

+ Contact information.

    m_akira@ka2.so-net.ne.jp


+ Reference document.

    https://developer.microsoft.com/ja-jp/

    https://docs.microsoft.com/ja-jp/dotnet/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application

    https://www.xpdfreader.com/index.html

-----------------------------------------------------------------

Windows 10/11 is a registered trademark or trademark of Microsoft Corporation in the United States and other countries.

