利用jpedal进行pdf转换成jpeg,jpg,png,tiff,tif等格式的图片

项目中运用到pdf文件转换成image图片,开始时使用pdfbox开源库进行图片转换,但是转换出来的文件中含有部分乱码的情况.下面是pdfBox 的pdf转换图片的代码示例.

try{
         String password = null;
         int startPage = 1;
         String imageType = "jpg";
         File imageFile = new File("E:\\upload\\pdf\\20140424\\Servlet."+ imageType);
         File pdfFile = new File("E:\\upload\\pdf\\20140424\\Servlet.pdf");
	 PDDocument document = PDDocument.load(pdfFile);
	 endPage = document.getPageCount();
	 PDFImageWriter imageWriter = new PDFImageWriter();
	 imageWriter.writeImage(document,imageType,password,startPage, endPage,imageFile.getAbsolutePath());
	 document.close();			

}catch(IOException  e){
	e.printStackTrace();
}	

比较了其他的开源库之后,准备采用jpedal。但是jpedal的治疗非常少，除了官方网站外，即使是英文资料也很少。而且官方提供的代码示例中的一些方法在的lgpl授权的
jpeal的代码库中不存在。下面是收集到的一些资料

1、jpedal文档：http://javadoc.idrsolutions.com/org/jpedal/PdfDecoder.html

2、简单调用示例：http://www.idrsolutions.com/java-pdf-code-faq/#pdf2img
3、lgpl授权的jpedal库的下载地址：http://sourceforge.net/projects/jpedal/
4、转换示例示例地址：http://files.idrsolutions.com/samplecode/org/jpedal/examples/images/ConvertPagesToImages.java.html

5、高清图片转换示例地址：http://files.idrsolutions.com/samplecode/org/jpedal/examples/images/ConvertPagesToHiResImages.java.html

于是稍微修改了官方的转换示例，下面是经过测试可以使用的转换代码

import cn.com.pujiConvert.util.Common;

import com.sun.imageio.plugins.jpeg.JPEGImageWriter;
import org.jpedal.*;
import org.jpedal.color.ColorSpaces;
import org.jpedal.constants.PageInfo;
import org.jpedal.exception.PdfException;
import org.jpedal.external.Options;
import org.jpedal.fonts.FontMappings;
import org.jpedal.objects.PdfFileInformation;
import org.jpedal.utils.LogWriter;
import org.w3c.dom.Element;

import javax.imageio.IIOImage;
import javax.imageio.ImageIO;
import javax.imageio.ImageTypeSpecifier;
import javax.imageio.metadata.IIOMetadata;
import javax.imageio.plugins.jpeg.JPEGImageWriteParam;
import javax.imageio.stream.ImageOutputStream;
import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.*;
import java.util.Iterator;

public class ConvertPagesToImages{

    /**
     * show if image transparent
     */
    boolean isTransparent=false;

    /**output where we put files */
    private String user_dir = System.getProperty("user.dir");

    /**use 96 dpi as default so pages correct size (72 will be smaller) */
    private float pageScaling =1.33f;

    /**flag to show if we print messages */
    public static boolean outputMessages = false;

    String output_dir=null;

    /**correct separator for OS */
    String separator = System.getProperty("file.separator");

    /**the decoder object which decodes the pdf and returns a data object */
    PdfDecoder decode_pdf = null;

    //type of image to save thumbnails
    private String format = "png";

    /** holding all creators that produce OCR pdf's ocr*/
    private String[] ocr = {"TeleForm"};

    /**scaling to use - default is 100 percent */
    private int scaling=100;

    /**file password or null */
    private String password=null;

    //only used if between 0 and 1
    private float JPEGcompression=-1f;

    private int pageCount = 0;

    public ConvertPagesToImages() { 

    }

    public void init(String file_name, int scaling, String format, String output_dir, String password, int pageCount){
        /*缩小比率*/
    	this.scaling = scaling;
        /*图片格式*/
        this.format = format;
        /*输出目录*/
        this.output_dir = output_dir;
        /*pdf密码*/
        this.password = password;
        /*输出图片数*/
        this.pageCount = pageCount;

        /*判断文件是否存在*/
        File pdf_file = new File(file_name);
        if (!pdf_file.exists()) {
            System.out.println("File " + pdf_file + " not found");
            System.out.println("May need full path");

            return;
        }

        extraction(file_name, output_dir);
    }

    private void extraction(String file_name, String output_dir) {
        this.output_dir=output_dir;

        if (!user_dir.endsWith(separator)){
            user_dir = user_dir + separator;
        }

        if (file_name.toLowerCase().endsWith(".pdf")) {

            if(output_dir==null){
                output_dir=user_dir + "thumbnails" + separator;
            }

            decodeFile(file_name,output_dir);
        } else {
            String[] files = null;
            File inputFiles;

            if (!file_name.endsWith(separator)){
                file_name = file_name + separator;
            }

            try {
                inputFiles = new File(file_name);

                if (!inputFiles.isDirectory()) {
                    System.err.println(file_name + " is not a directory. Exiting program");
                }else{
                    files = inputFiles.list();
                }
            } catch (Exception ee) {
                LogWriter.writeLog("Exception trying to access file " + ee.getMessage());

            }

            if(files!=null){
                for (String file : files) {

                    if (file.toLowerCase().endsWith(".pdf")) {
                        if (outputMessages){
                            System.out.println(file_name + file);
                        }

                        decodeFile(file_name + file, output_dir);
                    }
                }
            }
        }

        if(outputMessages){
            System.out.println("Thumbnails created");
        }
    }

    /**
     * routine to decode a file
     */
    private void decodeFile(String file_name,String output_dir) {
        String name = "demo"; //set a default just in case

        int pointer = file_name.lastIndexOf(separator);

        if(pointer==-1){
            pointer = file_name.lastIndexOf('/');
        }

        if (pointer != -1){
            name = file_name.substring(pointer + 1, file_name.length() - 4);
        }else if((file_name.toLowerCase().endsWith(".pdf"))){
            name=file_name.substring(0,file_name.length()-4);
        }

        //fix for odd files on Linux created when you view pages
        if(name.startsWith(".")){
            return;
        }

        //create output dir for images
        if(output_dir==null){
            output_dir = user_dir + "thumbnails" + separator ;
        }

        //PdfDecoder returns a PdfException if there is a problem
        try {
            if(decode_pdf==null){
                decode_pdf = new PdfDecoder(true);
            }

            /**optional JAI code for faster rendering*/
            org.jpedal.external.ImageHandler myExampleImageHandler=new org.jpedal.examples.handlers.ExampleImageDrawOnScreenHandler();
            decode_pdf.addExternalHandler(myExampleImageHandler, Options.ImageHandler);

            //mappings for non-embedded fonts to use
            FontMappings.setFontReplacements();

            //true as we are rendering page
            decode_pdf.setExtractionMode(0, pageScaling);
            //don't bother to extract text and images

            /**
             * open the file (and read metadata including pages in  file)
             */
            if (outputMessages){
                System.out.println("Opening file :" + file_name);
            }

            if(password != null && password != ""){
                decode_pdf.openPdfFile(file_name,password);
            }else{
                decode_pdf.openPdfFile(file_name);
            }

        } catch (Exception e) {
            System.err.println("8.Exception " + e + " in pdf code in "+file_name);
        }

        /**
         * extract data from pdf (if allowed).
         */
        if(decode_pdf.isEncrypted() && !decode_pdf.isFileViewable()){
        	throw new RuntimeException("Wrong password password used=>"+password+ '<');
        }else if ((decode_pdf.isEncrypted()&&(!decode_pdf.isPasswordSupplied())) && (!decode_pdf.isExtractionAllowed())) {
            throw new RuntimeException("Extraction not allowed");
        } else {
        	extractPageAsImage(file_name, output_dir, name, isTransparent);
        }

        /**close the pdf file */
        decode_pdf.closePdfFile();
    }

    private void extractPageAsImage(String file_name, String output_dir, String name, boolean isTransparent) {
        //create a directory if it doesn't exist
        File output_path = new File(output_dir);
        if (!output_path.exists()){
            output_path.mkdirs();
        }

        boolean isSingleOutputFile=false;
        boolean compressTiffs = false;
        String rawJPEGComp = null;
        String jpgFlag = "96";        

        //page range
        int start = 1,  end = decode_pdf.getPageCount();

        end = (pageCount == 0) ? end : pageCount;

        if (outputMessages){
            System.out.println("Thumbnails will be in  " + output_dir);
        }

        try {
            BufferedImage[] multiPages = new BufferedImage[1 + (end - start)];

            for (int page = start; page < end + 1; page++){
            	getPage(output_dir, name, isTransparent, isSingleOutputFile,rawJPEGComp, jpgFlag, compressTiffs, start, end,multiPages, page);
            }
        } catch (Exception e) {
            decode_pdf.closePdfFile();
            throw new RuntimeException("Exception " + e.getMessage()+" with thumbnails on File="+file_name);
        }
    }

    private void getPage(
    		String output_dir,
    		String name,
    		boolean isTransparent,
            boolean isSingleOutputFile,
            String rawJPEGComp,
            String jpgFlag,
            boolean compressTiffs,
            int start,
            int end,
            BufferedImage[] multiPages,
            int page
	) throws PdfException, IOException, FileNotFoundException {
        if (outputMessages ){
            System.out.println("Page " + page);
        }

        /**
         * 补0操作
         */
        String pageAsString	= String.valueOf(page);
        String maxPageSize	= String.valueOf(end);
        int padding			= maxPageSize.length()-pageAsString.length();

        for(int ii = 0; ii < padding; ii++){
            pageAsString = '0' + pageAsString;
        }

        String image_name;
        if(isSingleOutputFile){
            image_name =name;
        }else{
            image_name =name+"_page_" + pageAsString;
        }

        /**
         * get PRODUCER and if OCR disable text printing
         */
        PdfFileInformation currentFileInformation = decode_pdf.getFileInformationData();

        String[] values=currentFileInformation.getFieldValues();
        String[] fields=PdfFileInformation.getFieldNames();

        for(int i=0;i<fields.length;i++){
            if(fields[i].equals("Creator")){
                for (String anOcr : ocr) {
                    if (values[i].equals(anOcr)) {
                        decode_pdf.setRenderMode(PdfDecoder.RENDERIMAGES);
                    }
                }
            }
        }

        BufferedImage image_to_save;
        if(!isTransparent){
            image_to_save=decode_pdf.getPageAsImage(page);
        }else{
        	//use this if you want a transparent image
            image_to_save =decode_pdf.getPageAsTransparentImage(page);

            //java adds odd tint if you save this as JPEG which does not have transparency
            // so put as RGB on white background
            // (or save as PNG or TIFF which has transparency)
            // or just call decode_pdf.getPageAsImage(page)
            if(image_to_save!=null && format.toLowerCase().startsWith("jp")){

                BufferedImage rawVersion=image_to_save;

                int w=rawVersion.getWidth(), h=rawVersion.getHeight();
                //blank canvas
                image_to_save = new BufferedImage(w,h , BufferedImage.TYPE_INT_RGB);

                //
                Graphics2D g2 = image_to_save.createGraphics();
                //white background
                g2.setPaint(Color.WHITE);
                g2.fillRect(0,0,w,h);
                //paint on image
                g2.drawImage(rawVersion, 0, 0,null);
            }
        }

        /*if just gray we can reduce memory usage by converting image to Grayscale

        @SuppressWarnings("rawtypes")
		Iterator colorspacesUsed = decode_pdf.getPageInfo(PageInfo.COLORSPACES);

        int nextID;
        boolean isGrayOnly=colorspacesUsed!=null; //assume true and disprove
        while(colorspacesUsed!=null && colorspacesUsed.hasNext()){
            nextID= (Integer) (colorspacesUsed.next());

            if(nextID!= ColorSpaces.DeviceGray && nextID!=ColorSpaces.CalGray){
                isGrayOnly=false;
            }
        }

        //draw onto GRAY image to reduce colour depth
        if(isGrayOnly){
            BufferedImage image_to_save2=new BufferedImage(image_to_save.getWidth(),image_to_save.getHeight(), BufferedImage.TYPE_BYTE_GRAY);
            image_to_save2.getGraphics().drawImage(image_to_save,0,0,null);
            image_to_save = image_to_save2;
        }

        //put image in array if multi-images
        if(isSingleOutputFile){
            multiPages[page-start] = image_to_save;
        }

        if (image_to_save != null) {

            /**BufferedImage does not support any dpi concept. A higher dpi can be created
             * using JAI to convert to a higher dpi image*/

            //shrink the page to 50% with graphics2D transformation
            //- add your own parameters as needed
            //you may want to replace null with a hints object if you
            //want to fine tune quality.

            /** example 1 biliniear scaling
             AffineTransform scale = new AffineTransform();
             scale.scale(.5, .5); //50% as a decimal
             AffineTransformOp scalingOp =new AffineTransformOp(scale, null);
             image_to_save =scalingOp.filter(image_to_save, null);

             */

            /** example 2 bicubic scaling - better quality but slower
             to preserve aspect ratio set newWidth or newHeight to -1*/

            /**allow user to specify maximum dimension for thumbnail*/
            int maxDimension = -1;

            if(scaling!=100 || maxDimension != -1){
                int newWidth=image_to_save.getWidth()*scaling/100;
                int newHeight=image_to_save.getHeight()*scaling/100;

                Image scaledImage;
                if(maxDimension != -1 && (newWidth > maxDimension || newHeight > maxDimension)){
                    if(newWidth > newHeight){
                        newWidth = maxDimension;
                        scaledImage= image_to_save.getScaledInstance(newWidth,-1,BufferedImage.SCALE_SMOOTH);
                    } else {
                        newHeight = maxDimension;
                        scaledImage= image_to_save.getScaledInstance(-1,newHeight,BufferedImage.SCALE_SMOOTH);
                    }
                } else {
                    scaledImage= image_to_save.getScaledInstance(newWidth,-1,BufferedImage.SCALE_SMOOTH);
                }

                if(format.toLowerCase().startsWith("jp")){
                    image_to_save = new BufferedImage(scaledImage.getWidth(null),scaledImage.getHeight(null) , BufferedImage.TYPE_INT_RGB);
                }else{
                    image_to_save = new BufferedImage(scaledImage.getWidth(null),scaledImage.getHeight(null) , BufferedImage.TYPE_INT_ARGB);
                }

                Graphics2D g2 = image_to_save.createGraphics();

                g2.drawImage(scaledImage, 0, 0,null);
            }

            if (format.startsWith("jp")) {
            	saveAsJPEG(jpgFlag, image_to_save, JPEGcompression, new BufferedOutputStream(new FileOutputStream(output_dir + pageAsString + image_name + '.' + format)));
            } else {
                //save image
                decode_pdf.getObjectStore().saveStoredImage(
                        output_dir + pageAsString + image_name,
                        image_to_save,
                        true,
                        false,
                        format);
            }
        }

        //flush images in case we do more than 1 page so only contains
        //images from current page
        decode_pdf.flushObjectValues(true);
    }

    private static void saveAsJPEG(String jpgFlag,BufferedImage image_to_save, float JPEGcompression, BufferedOutputStream fos) throws IOException {
        JPEGImageWriter imageWriter = (JPEGImageWriter) ImageIO.getImageWritersBySuffix("jpeg").next();
        ImageOutputStream ios = ImageIO.createImageOutputStream(fos);
        imageWriter.setOutput(ios);

        IIOMetadata imageMetaData = imageWriter.getDefaultImageMetadata(new ImageTypeSpecifier(image_to_save), null);

        if (Common.isInteger(jpgFlag)){

            int dpi = 96;

            try {
                dpi = Integer.parseInt(jpgFlag);
            } catch (Exception e) {
                e.printStackTrace();
            }

            Element tree = (Element) imageMetaData.getAsTree("javax_imageio_jpeg_image_1.0");
            Element jfif = (Element)tree.getElementsByTagName("app0JFIF").item(0);
            jfif.setAttribute("Xdensity", Integer.toString(dpi));
            jfif.setAttribute("Ydensity", Integer.toString(dpi));
        }

        JPEGImageWriteParam jpegParams = (JPEGImageWriteParam) imageWriter.getDefaultWriteParam();
        if(JPEGcompression>=0 && JPEGcompression<=1f){
            jpegParams.setCompressionMode(JPEGImageWriteParam.MODE_EXPLICIT);
            jpegParams.setCompressionQuality(JPEGcompression);

        }

        imageWriter.write(imageMetaData, new IIOImage(image_to_save, null, null), jpegParams);
        ios.close();
        imageWriter.dispose();
    }

     public static void main(String[] args) {
		 long start=System.currentTimeMillis();

		 String pdfPath = "E:\\upload\\pdf\\20140424\\Servlet.pdf";
		 int scaling = -1;
		 String format = "jpg";
		 String output_dir = "E:\\upload\\pdf\\20140424\\jpg\\";
		 String password = null;
		 int pageCount = 10;

		 ConvertPagesToImages convertPagesToImages = new ConvertPagesToImages();
		 convertPagesToImages.init(pdfPath, scaling, format, output_dir, password, pageCount);

		 System.out.println("花费时间为="+(System.currentTimeMillis()-start)/1000 + "秒");
 	}
}

功能说明：

1、支持对文件夹下的所有pdf转换成图片，同时也支持对单个pdf进行转换操作。

2、支持转换成jpg，jpeg，tiff，tif，png格式的图片

3、支持指定转换的图片数。

4、支持指定图片的存储位置

传入参数说明

1、pdfPath pdf文件绝对路径，可以是pdf所在的目录也可以是pdf文件路径 
 2、format  图片格式 (支持jpg,jpeg,tiff,png) ，传参时不能带有点号
 3、scaling 图片比率从1到100(100 = 全尺寸) 支持设置为-1 将保持高质量
 4、output_dir 输出路径，输出路径为绝对路径
 5、password 文件密码 若没有传入null值