Import img2pdf_0.2.1.orig.tar.gz

[dgit import orig img2pdf_0.2.1.orig.tar.gz]

1 files changed, 164 insertions, 0 deletions

diff --git a/PKG-INFO b/PKG-INFO
new file mode 100644
index 0000000..b18e9d6
--- /dev/null
+++ b/PKG-INFO
@@ -0,0 +1,164 @@
+Metadata-Version: 1.1
+Name: img2pdf
+Version: 0.2.1
+Summary: Convert images to PDF via direct JPEG inclusion.
+Home-page: https://gitlab.mister-muffin.de/josch/img2pdf
+Author: Johannes 'josch' Schauer
+Author-email: josch@mister-muffin.de
+License: LGPL
+Download-URL: https://gitlab.mister-muffin.de/josch/img2pdf/repository/archive.tar.gz?ref=0.2.1
+Description: img2pdf
+        =======
+        
+        Losslessly convert raster images to PDF. The file size will not unnecessarily
+        increase. One major application would be a number of scans made in JPEG format
+        which should now become part of a single PDF document.  Existing solutions
+        would either re-encode the input JPEG files (leading to quality loss) or store
+        them in the zip/flate format which results into the PDF becoming unnecessarily
+        large in terms of its file size.
+        
+        Background
+        ----------
+        
+        Quality loss can be avoided when converting JPEG and JPEG2000 images to PDF by
+        embedding them without re-encoding.  I wrote this piece of python code.
+        because I was missing a tool to do this automatically. Img2pdf basically just
+        wraps JPEG images into the PDF container as they are.
+        
+        If you know an existing tool which allows one to embed JPEG and JPEG2000 images
+        into a PDF container without recompression, please contact me so that I can put
+        this code into the garbage bin.
+        
+        Functionality
+        -------------
+        
+        This program will take a list of images and produce a PDF file with the images
+        embedded in it.  JPEG and JPEG2000 images will be included without
+        recompression.  Raster images in other formats will be included with zip/flate
+        encoding which usually leads to an increase in the resulting size because
+        formats like png compress better than PDF which just zip/flate compresses the
+        RGB data.  As a result, this tool is able to losslessly wrap images into a PDF
+        container with a quality to filesize ratio that is typically better (in case of
+        JPEG and JPEG2000 images) or equal (in case of other formats) than that of
+        existing tools.
+        
+        For example, imagemagick will re-encode the input JPEG image (thus changing
+        its content):
+        
+        	$ convert img.jpg img.pdf
+        	$ pdfimages img.pdf img.extr # not using -j to be extra sure there is no recompression
+        	$ compare -metric AE img.jpg img.extr-000.ppm null:
+        	1.6301e+06
+        
+        If one wants to losslessly convert from any format to PDF with
+        imagemagick, one has to use zip compression:
+        
+        	$ convert input.jpg -compress Zip output.pdf
+        	$ pdfimages img.pdf img.extr # not using -j to be extra sure there is no recompression
+        	$ compare -metric AE img.jpg img.extr-000.ppm null:
+        	0
+        
+        However, this approach will result in PDF files that are a few times larger
+        than the input JPEG or JPEG2000 file.
+        
+        img2pdf is able to losslessly embed JPEG and JPEG2000 files into a PDF
+        container without additional overhead (aside from the PDF structure itself),
+        save other graphics formats using lossless zip compression, and produce
+        multi-page PDF files when more than one input image is given.
+        
+        Also, since JPEG and JPEG2000 images are not reencoded, conversion with img2pdf
+        is several times faster than with other tools.
+        
+        Usage
+        -----
+        
+        The images must be provided as files because img2pdf needs to seek in the file
+        descriptor.
+        
+        If no output file is specified with the `-o`/`--output` option, output will be
+        done to stdout.
+        
+        The detailed documentation can be accessed by running:
+        
+        	img2pdf --help
+        
+        
+        Bugs
+        ----
+        
+        If you find a JPEG or JPEG2000 file that, when embedded cannot be read
+        by the Adobe Acrobat Reader, please contact me.
+        
+        For lossless conversion of formats other than JPEG or JPEG2000, zip/flate
+        encoding is used.  This choice is based on tests I did with a number of images.
+        I converted them into PDF using the lossless variants of the compression
+        formats offered by imagemagick.  In all my tests, zip/flate encoding performed
+        best.  You can verify my findings using the test_comp.sh script with any input
+        image given as a commandline argument.  If you find an input file that is
+        outperformed by another lossless compression method, contact me.
+        
+        I have not yet figured out how to determine the colorspace of JPEG2000 files.
+        Therefore JPEG2000 files use DeviceRGB by default. For JPEG2000 files with
+        other colorspaces, you must explicitly specify it using the `--colorspace`
+        option.
+        
+        It might be possible to store transparency using masks but it is not clear
+        what the utility of such a functionality would be.
+        
+        Most vector graphic formats can be losslessly turned into PDF (minus some of
+        the features unsupported by PDF) but img2pdf will currently turn vector
+        graphics into their lossy raster representations. For converting raster
+        graphics to PDF, use another tool like inkscape and then join the resulting
+        pages with a tool like pdftk.
+        
+        A configuration file could be used for default options.
+        
+        Installation
+        ------------
+        
+        On a Debian- and Ubuntu-based systems, dependencies may be installed
+        with the following command:
+        
+        	apt-get install python3 python3-pil python3-setuptools
+        
+        You can then install the package using:
+        
+        	$ pip install img2pdf
+        
+        If you prefer to install from source code use:
+        
+        	$ cd img2pdf/
+        	$ pip install .
+        
+        To test the console script without installing the package on your system,
+        use virtualenv:
+        
+        	$ cd img2pdf/
+        	$ virtualenv ve
+        	$ ve/bin/pip install .
+        
+        You can then test the converter using:
+        
+        	$ ve/bin/img2pdf -o test.pdf src/tests/test.jpg
+        
+        The package can also be used as a library:
+        
+        	import img2pdf
+        	pdf_bytes = img2pdf.convert('test.jpg')
+        
+        	file = open("name.pdf","wb")
+        	file.write(pdf_bytes)
+        
+Keywords: jpeg pdf converter
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Other Audience
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent