I was trying to diagnose a problem with a PDF file we generated yesterday, and suspected that the images were corrupted. To see, I wrote this quick script to extract JPGs from PDF files. It is quick and dirty, with the absolute minimum understanding of PDF files, which can be quite opaque.

# Extract jpg's from pdf's. Quick and dirty.
import sys

pdf = file(sys.argv[1], "rb").read()

startmark = "\xff\xd8"
startfix = 0
endmark = "\xff\xd9"
endfix = 2
i = 0

njpg = 0
while True:
    istream = pdf.find("stream", i)
    if istream < 0:
        break
    istart = pdf.find(startmark, istream, istream+20)
    if istart < 0:
        i = istream+20
        continue
    iend = pdf.find("endstream", istart)
    if iend < 0:
        raise Exception("Didn't find end of stream!")
    iend = pdf.find(endmark, iend-20)
    if iend < 0:
        raise Exception("Didn't find end of JPG!")
    
    istart += startfix
    iend += endfix
    print "JPG %d from %d to %d" % (njpg, istart, iend)
    jpg = pdf[istart:iend]
    jpgfile = file("jpg%d.jpg" % njpg, "wb")
    jpgfile.write(jpg)
    jpgfile.close()
    
    njpg += 1
    i = iend

This script works for my PDF files. Maybe it doesn't work for all, I don't know. PDF files are complex beasts. Your mileage may vary.

What I'd really like is a tool for exploring inside PDF files, so that I could see exactly what's going on in there. pyPdf is a start, but only scratches the surface of the kind of stuff I'd like to see...

tagged: python, how-to, graphics, pdf» 8 reactions

Comments

[gravatar]
David Boddie 12:58 PM on 6 Dec 2007

I decided to try and do something similar with pdftools:

http://www.boddie.org.uk/david/Projects/Python/pdftools/

However, the code is also quite long and assumes certain things about the file it is given. It doesn't look like I can post code here, either. :-(

[gravatar]
andrew 3:41 PM on 6 Dec 2007

PDFPeek, The New Obsession

[gravatar]
Lee Harr 5:22 PM on 6 Dec 2007

Nice. I needed to do this just the other day. I tried pdftk, which
normally has all of the pdf tools that I need, but I could not see
how to make it extract the images. I went back to the pdf just
now to test out your script and it worked perfectly.

[gravatar]
susan 7:27 PM on 6 Dec 2007

PDF = Pretty Darned Fun
JPG = Just PlayinG

[gravatar]
David Boddie 8:23 PM on 6 Dec 2007

In the end, I ran my code through a syntax highlighter and put it here:

http://chaos.troll.no/~dboddie/Python/pdf_extract_jpegs.html

It even tries to decode images that it thinks are PNGs, but only in a restricted set of circumstances.

[gravatar]
Eric Florenzano 1:59 AM on 7 Dec 2007

I've not messed with the PDF specification at all, but some of my friends had an assignment to write a PDF parser in C, and complained about it loudly. It was enough to make me never want to try :)

[gravatar]
Mathieu Fenniak 6:08 PM on 7 Dec 2007

Hi Ned,

I'm the author of pyPdf. I've often wished for a program to explore inside PDF files myself. But, typically I need it for files that pyPdf can't open, so I've never developed one using pyPdf. ;-)

I think that pyPdf has the necessary core functionality that would be needed for a general purpose PDF library, but it clearly lacks in the implementation of useful functions based upon that core. For example, it can read and decode stream objects, but there's no function that just says "Get me all the images on this page". Someday...

Thanks for the link and exposure.

[gravatar]
abdul 9:12 AM on 3 Feb 2008

Hi and thanks for your code.
I have a question about other graphic formats: how can I find png,gif,tiff etc etc as they have only a "start" magic number, but no end mark?
Bye

Add a comment:

name
email
Ignore this:
not displayed and no spam.
Leave this empty:
www
not searched.
 
Name and either email or www are required.
Don't put anything here:
Leave this empty:
URLs auto-link and some tags are allowed: <a><b><i><p><br><pre>.