Python-Bitmaps-to-PDF

This script serves as both a function and a standalone program to convert a folder of .bmp files to a single PDF.

Introduction

Welcome to bmp2pdf! A quick little script to convert a folder of .bmp files into a single PDF. This script can be used as a function or run by itself.

This script works by first converting the .bmp files to .png files and then writing those .png files to individual pages in the final PDF. You can set the name and output path for the PDF as well as whether to save the converted .png files or not.

Dependencies

This program requires natsort, fpdf, and cv2. If you wish to use this program standalone, you will also need tkinter.

• natsort is used to sort the list of .bmp files in a more natural way. This means that .bmp files will be sorted alphabetically or numerically in the fashion "1, 2, 3, 4, 5..." rather than the default "1, 10, 11...2, 20, 21...etc.".
• fpdf is used to create and write the final PDF.
• cv2 is used to process and handle the image files.
• tkinter is used in the standalone process for easy folder selection.

Install these dependencies like so:

python -m pip install natsort fpdf opencv-python

Tkinter should already be included in the defualt Python installation.

Arguments

The function requires the following arguments:

• bmp_folder: This should be a directory path (string) leading to the directory containing the .bmp files you want to convert.
• save_path: This should be a directory path (string) leading to the directory in which you want to save the PDF. This can be the same as bmp_path or different.
• pdf_name: This should be a string containing the desired name of your PDF. If this name is missing the .pdf extension, it will automatically be added.
• save_png: Boolean. This script converts the .bmp images to .png images before adding them to the PDF. If you wish to save the .png versions of the images in addition to the PDF, set this value to 1.

So a call to this function should look like:

bmp2pdf(bmpd_folder, save_path, pdf_name, 0);

or

bmp2pdf(bmpd_folder, save_path, pdf_name, 1);

Copyright

NotMyMajor/Python-Bitmaps-to-PDF is licensed under the GNU General Public License v3.0

Permissions of this strong copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights.

See COPYING.txt for full licensing information.

If you use my code to do something fun or cool, share it with me! Also, credit is nice to have too.

Enjoy!