Click here to Skip to main content
Click here to Skip to main content

Simplest PDF Generating API for JPEG Image Content

, 19 Dec 2008 CPOL
Rate this:
Please Sign up or sign in to vote.
An article on how to generate PDF file based on JPEG file as page content

Introduction

I was working on a project in which I need to wrap a JPEG file into PDF format. The program needs to be done in C, and after searched on the Internet, I could not find anything that I can refer to. Most of the Open Source PDF engine is based on either Java or PHP, and a few C PDF engines are huge and will add a lot of unnecessary code to my project. I decided to write this simple JPEG to PDF wrapper. And it's the result of reverse-engineering of the simplest PDF file that contains one single JPEG file. I just want to share this API so you can grab and use it if you have a similar requirement.

Using the Code

Just give an example to demonstrate how to generate a 2 page PDF file based on 2 JPEG files. Please refer to testMain.c for details. But the idea is:

PJPEG2PDF pPDF;
int pdfByteSize, pdfOutByteSize;
unsigned char *pdfBuf;

pPDF = Jpeg2PDF_BeginDocument(8.5, 11);    
	/* pdfW, pdfH: Page Size in Inch ( 1 inch=25.4 mm ); Letter Size 8.5x11 */

if(NULL != pPDF) {
    
    Loop For All JPEG Files {
        ... Prepare the current JPEG File to be inserted.
        /* You'll need to know the dimension of the JPEG Image, 
	and the ByteSize of the JPEG Image */
        Jpeg2PDF_AddJpeg(pPDF, JPEG_IMGW, JPEG_IMGH, JPEG_BYTE_SIZE, 
		JPEG_DATA_POINTER, IS_COLOR_JPEG);
    } 
    
    /* Call this after all of the JPEG image has been inserted. 
	The return value is the PDF file Byte Size */
    pdfByteSize = Jpeg2PDF_EndDocument(pPDF);
    
    /* Allocate the buffer for PDF Output */
    pdfBuf = malloc(pdfByteSize);
    
    /* Output the PDF to the pdfBuf */
   Jpeg2PDF_GetFinalDocumentAndCleanup(pPDF, pdfBuf, &pdfOutByteSize);
   
   ... Do something you want to the PDF file in the memory.
}

There are several places that you can fine-tune in the Jpeg2PDF.h file:

#define MAX_PDF_PAGES        256     /* Currently only supports less than 256 Images */

#define PDF_TOP_MARGIN        (0.0 * PDF_DOT_PER_INCH)    /* Currently No Top Margin */
#define PDF_LEFT_MARGIN        (0.0 * PDF_DOT_PER_INCH)   /* Currently No Left Margin */

That's it, guys. Enjoy.

History

  • Updated [2008-12-19] - Added some extra code to auto scan the current folder and automatically obtain the JPEG image dimension from the JPEG file instead of using hard coded value before.
    The JPEG image dimension code is borrowed from here.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Hao Hu
Software Developer
United States United States
No Biography provided

Comments and Discussions

 
Questionwhy you only supports less than 256 Images? Pinmemberveeta23-Nov-14 21:20 
QuestionExcellent PinmemberT800G27-Sep-14 11:57 
Questionpatches done: keep images's aspect ratio & automatic page rotate for best fit Pinmemberdab1826-Aug-11 7:55 
QuestionRemove the max 250 pages limitation? Pinmembermonday200015-Mar-11 2:54 
AnswerRe: Remove the max 250 pages limitation? PinmemberHao Hu15-Mar-11 8:15 
QuestionHow to get DPI from JPEG? Pinmembermonday200011-Mar-11 6:22 
AnswerRe: How to get DPI from JPEG? PinmemberHao Hu11-Mar-11 6:39 
GeneralRe: How to get DPI from JPEG? Pinmembermonday200011-Mar-11 11:09 
Generalhttps://sourceforge.net/projects/jpeg2pdf/ PinmemberHao Hu26-Aug-10 13:27 
GeneralRe: https://sourceforge.net/projects/jpeg2pdf/ Pinmembermonday200012-Mar-11 22:20 
QuestionWhat about the XMP manipulation? [modified] Pinmembermonday200018-Aug-10 0:11 
Hello, Hao Hu.
 
It would be nice also if your program could manipulate the XMP-metadata inside PDF files.
 
XMP is contaned just inside another PDF-object - using XML syntax.
 
XMP manipulation is a useful thing because XMP provides the different metadata information about a PDF document like Author, Title, Keywords, etc.
 
The XMP specification is available from Adobe:
 
   http://www.adobe.com/devnet/xmp/
 
Here is an example of XMP inside PDF:
 
380 0 obj<</Subtype/XML/Length 3247/Type/Metadata>>stream
<?xpacket begin="?»?" id="W5M0MpCehiHzreSzNTczkc9d"?>
<x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="3.1-701">
   <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
         <rdf:Description rdf:about=""
                  xmlns:xap="http://ns.adobe.com/xap/1.0/">
            <xap:CreateDate>2009-11-03T17:06:02Z</xap:CreateDate>
            <xap:ModifyDate>2009-11-03T20:08:04+03:00</xap:ModifyDate>
            <xap:MetadataDate>2009-11-03T20:08:04+03:00</xap:MetadataDate>
         </rdf:Description>
         <rdf:Description rdf:about=""
                  xmlns:pdf="http://ns.adobe.com/pdf/1.3/">
            <pdf:Producer>ABBYY FineReader 9.0 Professional Edition</pdf:Producer>
         </rdf:Description>
         <rdf:Description rdf:about=""
                  xmlns:dc="http://purl.org/dc/elements/1.1/">
            <dc:format>application/pdf</dc:format>
         </rdf:Description>
         <rdf:Description rdf:about=""
                  xmlns:xapMM="http://ns.adobe.com/xap/1.0/mm/">
            <xapMM:DocumentID>uuid:6c762139-bdde-4faa-9adc-b1e164c6db73</xapMM:DocumentID>
            <xapMM:InstanceID>uuid:a2270d76-823e-405c-b377-b3a7f72c4575</xapMM:InstanceID>
         </rdf:Description>
   </rdf:RDF>
</x:xmpmeta>
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                                                                                                                                     
                                      
<?xpacket end="w"?>
endstream
endobj
 

 
-- Modified Wednesday, August 18, 2010 5:17 AM
AnswerRe: What about the XMP manipulation? PinmemberHao Hu18-Aug-10 7:09 
GeneralDesired enhancements Pinmembermonday200014-Aug-10 1:09 
GeneralRe: Desired enhancements PinmemberHao Hu14-Aug-10 16:12 
GeneralRe: Desired enhancements Pinmembermonday200015-Aug-10 20:44 
GeneralI made my program based on this one Pinmembermonday200013-Aug-10 2:12 
GeneralRe: I made my program based on this one Pinmembermonday200016-Mar-11 23:03 
GeneralRe: I made my program based on this one PinmemberHao Hu18-Mar-11 21:16 
GeneralBug found Pinmembermonday200013-Aug-10 2:08 
GeneralRe: Bug found [modified] PinmemberHao Hu13-Aug-10 6:43 
QuestionMay I re-use your code under the "GPL 2 and later" license? Pinmembermonday20002-Jul-10 2:32 
AnswerRe: May I re-use your code under the "GPL 2 and later" license? PinmemberHao Hu2-Jul-10 8:33 
GeneralMy vote of 5 Pinmembermonday20002-Jul-10 0:06 
GeneralBmp 2 pdf function PinmemberJunson_Feng13-May-10 21:32 
GeneralRe: Bmp 2 pdf function PinmemberHao Hu13-May-10 22:20 
QuestionHow to keep image's aspect ratio? PinmemberSuper Garrison6-Nov-09 18:50 
AnswerRe: How to keep image's aspect ratio? PinmemberHao Hu6-Nov-09 21:27 
QuestionHow to add more than 2 images? PinmemberWaleedH11-Jul-09 5:54 
AnswerRe: How to add more than 2 images? PinmemberHao Hu11-Jul-09 14:03 
GeneralRe: How to add more than 2 images? [modified] PinmemberWaleedH11-Jul-09 20:58 
GeneralRe: How to add more than 2 images? PinmemberHao Hu11-Jul-09 21:33 
GeneralRe: How to add more than 2 images? PinmemberWaleedH11-Jul-09 22:30 
GeneralRe: How to add more than 2 images? PinmemberHao Hu11-Jul-09 22:48 
Generalhi Pinmemberxyang_200928-May-09 15:55 
GeneralRe: hi PinmemberHao Hu28-May-09 16:17 
Generalvery good! Pinmemberganfeng200320-Dec-08 17:14 
GeneralRe: very good! PinmemberHao Hu20-Dec-08 23:01 
GeneralJPEG Requirements PinmemberDavide Zaccanti4-Oct-08 22:14 
GeneralRe: JPEG Requirements PinmemberHao Hu4-Oct-08 22:32 
GeneralRe: JPEG Requirements [modified] PinmemberDavide Zaccanti5-Oct-08 0:22 
GeneralRe: JPEG Requirements PinmemberHao Hu5-Oct-08 11:25 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.1411023.1 | Last Updated 19 Dec 2008
Article Copyright 2008 by Hao Hu
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid