com.qoppa.pdfProcess
Class PDFDocument

java.lang.Object
  com.qoppa.pdfViewer.hiObjects.AbstractPDFDocument
      com.qoppa.pdfProcess.PDFDocument

All Implemented Interfaces:

IPDFDocument, Printable

public class PDFDocument

extends AbstractPDFDocument

implements IPDFDocument

PDF Document object. This class provides methods to load, modify, print and save PDF documents.

Documents can be loaded from a file, an input stream or a URL. Use the URL constructor when loading a document from a web server or from a servlet.

Author:

Qoppa Software

Field Summary

Fields inherited from interface com.qoppa.pdf.dom.IPDFDocument

PAGEMODE_FULLSCREEN, PAGEMODE_USEATTACHMENTS, PAGEMODE_USENONE, PAGEMODE_USEOC, PAGEMODE_USEOUTLINES, PAGEMODE_USETHUMBS

Fields inherited from interface java.awt.print.Printable

NO_SUCH_PAGE, PAGE_EXISTS

Constructor Summary

PDFDocument()
Creates a blank PDF document.

PDFDocument(InputStream inStream, IPassword password)
Creates a PDFDocument object from a PDF InputStream.

PDFDocument(String fileName, IPassword password)
Loads a PDF document from a file.

PDFDocument(URL url, IPassword password)
Loads a PDF document from a URL.

Method Summary

void	addDocumentListener(IDocumentListener listener) Internal method to keep track of document events.
boolean	addEmbeddedFile(File file) Embeds a file into this PDF document.
Layer	addLayer(String name, int initialState) Creates and returns a PDF layer (Optional Content Group).
void	appendDocument(PDFDocument appendDoc) Appends a PDF document to this document.
void	appendJPEGAsPage(String jpegFileName) Creates a new page in the PDF document and adds the JPEG file to it.
void	appendJPEGAsPage(String jpegFileName, int dpi) Creates a new page in the PDF document and adds the JPEG file to it.
PDFPage	appendNewPage(double pageWidth, double pageHeight) Creates and appends a new PDFPage to this document.
void	appendPage(PDFPage page) Appends a page to this document.
void	appendPNGAsPage(String pngFileName) Creates a new page in the PDF document and adds the PNG file to it.
void	appendTIFFAsPages(InputStream inStream) Appends the pages in a TIFF image from an input stream to the end of this document.
void	appendTIFFAsPages(String tiffFileName) Appends the pages in a TIFF file to the end of this document.
void	clearSecurity(String currentPermissionsPwd) Clears the security for this document.
Bookmark	createRootBookmark() Creates a new root bookmark and saves it in the document catalog.
void	deleteAnnotations() Delete all annotations in the document.
void	deletePage(int index) Deletes a page from this document.
Font	embedFont(String fileName, int fontFormat) Embeds a font in the PDF file.
void	exportAnnotsAsFDF(OutputStream outStream, String pathToPDFFile) Export annotations comments to an output stream in FDF format.
void	exportAnnotsAsFDF(String fileName) Exports annotations comments in FDF format.
void	exportAnnotsAsXFDF(OutputStream outStream, String pathToPDFFile) Export annotations comments to an output stream in XFDF format.
void	exportAnnotsAsXFDF(String fileName) Exports annotations comments in XFDF format.
void	flattenAnnotations(boolean paintNonPrintableAnnots) Flattens the annotations.
void	flattenFields(boolean paintButtons, boolean paintNonPrintableFields) Flattens the pdf form fields.
AcroForm	getAcroForm() Returns the AcroForm in this document.
DocumentInfo	getDocumentInfo() Returns a copy of a DocumentInfo object containing the information section of a PDF document (author, title, etc.).
Vector	getEmbeddedFiles() Returns the list of embedded files in the document (annotations attachments are not part of the list).
String	getEncryptionAlgorithm() Returns the name of the encryption algorithm used to encrypt the document.
int	getEncryptionLength() Returns an int representing the number of bits used in the encryption technique.
File	getFile() Returns the file for the current pdf file.
String	getFileModifiedID() Returns the file modified ID.
String	getFileName() Returns the name of the pdf document file without the full path.
String	getFileOriginalID() Returns the file original ID.
IPDFPage	getIPage(int pageIndex) Internal method, do not use.
Layer	getLayer(int layerIndex) Returns a particular PDF layer given its index.
int	getLayerCount() Returns the number of PDF layers in this document.
PDFPage	getPage(int pageIndex) Returns a page in this document.
Pageable	getPageable(PrinterJob pJob) Returns an object that implements Pageable for this PDF document.
int	getPageCount() Returns the number of pages in this document.
String	getPDFFileVersion() Return the PDF file version for the current document.
PDFPermissions	getPermissions() Returns the permission object for this document.
PrintSettings	getPrintSettings() Get the current PrintSettings object.
Bookmark	getRootBookmark() Returns the 'root' bookmark.
String	getText() Returns the text in the pdf document as a String.
String	getText(int pageIndex) Returns text contained in the specified page of the pdf document as a String.
static String	getVersion() Returns version string for jPDFProcess.
Vector	getWords() Returns all words in the pdf document as a Vector of Strings.
Vector	getWords(int pageIndex) Returns all words contained in the specified page of the pdf document as a Vector of Strings.
boolean	hasOpenPassword() Returns a flag indicating whether this document is encrypted with a 'user' password.
boolean	hasPermissionsPassword() Returns a flag indicating whether this document is encrypted with a 'owner' password.
void	importAnnotsFDF(InputStream inStream) Import annotations comments from an input stream in FDF format.
void	importAnnotsFDF(String fileName) Import annotations comments from a file in FDF Format.
void	importAnnotsXFDF(InputStream inStream) Import AcroForm field data from an input stream in XML format.
void	importAnnotsXFDF(String fileName) Import Acroform fields data from a file in XML Format.
PDFPage	insertNewPage(double pageWidth, double pageHeight, int index) Creates a new PDFPage and inserts it into the document at the given position.
void	insertPage(PDFPage page, int index) Inserts a page into this document at the given index.
boolean	isEncrypted() Returns a flag indicating whether this document is encrypted.
static PDFDocument	loadRTF(String rtfFile, PageFormat pf) Creates a PDFDocument from an RTF file.
int	print(Graphics graphics, PageFormat pageFormat, int pageIndex) Prints the page.
void	print(PrintSettings printSettings) Prints this PDF document.
void	print(String printerName, PrintSettings printSettings) Prints this PDF document to the specified printer, by name.
void	print(String printerName, PrintSettings printSettings, PrintRequestAttributeSet printAttrSet) Prints this PDF document to the specified printer, by name and passes the print request attribute set to the printer job.
void	removeDocumentListener(IDocumentListener listener) Internal method to keep track of document events.
boolean	removeEmbeddedFile(IEmbeddedFile ef) Remove a file embedded in this document.
void	saveDocument(OutputStream outStream) Saves this document to an output stream.
void	saveDocument(String fileName) Saves this document to a file.
void	saveDocumentAsTIFF(OutputStream outStream, double resDPI, String tiffCompression) Save the entire document as a multi-page TIFF image to the given OutputStream.
void	saveDocumentAsTIFF(OutputStream outStream, TIFFOptions options) Save the entire document as a multi-page TIFF image to an OutputStream.
void	setDocumentInfo(DocumentInfo newInfo) Copies and sets this document's info.
static boolean	setKey(String key) Method to unlock the production version of the library.
void	setPageMode(String pageMode) Changes the value of the page mode viewer preference in the document.
void	setPrintSettings(PrintSettings printSettings) Set the PrintSettings to be used on the next printout.
void	setSecurity(String newPermissionsPwd, String newOpenPwd, PDFPermissions permissions, String currentPermissionsPwd, int encryptType) Sets the security for this document.
void	signDocument(SignatureField signField, SigningInformation signingInfo) Signs this document using the given signature field.
PDFObjectReference	useFont(Font font) Internal method used when using fonts in this document.

Methods inherited from class com.qoppa.pdfViewer.hiObjects.AbstractPDFDocument

getDocumentInfo, getLinesWithPositions, getPageMode, getWordsWithPositions

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.qoppa.pdf.dom.IPDFDocument

getPageMode

Constructor Detail

PDFDocument

public PDFDocument(URL url,
                   IPassword password)
            throws PDFException

Loads a PDF document from a URL.

Parameters:

url - URL pointint to the location of the PDF file.

password - An object that provides passwords to open the document, leave null if not needed. When working with documents that have no passwords, the host application should pass null for the value of this parameter. When documents are known to have passwords, the host application should pass an instance of the PDFPassword class that can hold a single password or a list of passwords.

PDFDocument

public PDFDocument(InputStream inStream,
                   IPassword password)
            throws PDFException

Creates a PDFDocument object from a PDF InputStream.

Parameters:

inStream - InputStream to read the pdf document from.

password - An object that provides passwords to open the document, leave null if not needed. When working with documents that have no passwords, the host application should pass null for the value of this parameter. When documents are known to have passwords, the host application should pass an instance of the PDFPassword class that can hold a single password or a list of passwords.

PDFDocument

public PDFDocument(String fileName,
                   IPassword password)
            throws PDFException

Loads a PDF document from a file.

Parameters:

fileName - Name of the PDF file.

password - An object that provides passwords to open the document, leave null if not needed. When working with documents that have no passwords, the host application should pass null for the value of this parameter. When documents are known to have passwords, the host application should pass an instance of the PDFPassword class that can hold a single password or a list of passwords.

PDFDocument

public PDFDocument()
            throws PDFException

Creates a blank PDF document. Pages can then be added to this document from other documents or by creating blank pages and drawing to them.

Method Detail

appendDocument

public void appendDocument(PDFDocument appendDoc)
                    throws PDFException

Appends a PDF document to this document. All the pages in appendDoc will be added at the end of this document.

Parameters:

appendDoc - Document to be appended.

Throws:

PDFException

appendPage

public void appendPage(PDFPage page)
                throws PDFException

Appends a page to this document.

Parameters:

page - The page to add to the document.

Throws:

PDFException

appendTIFFAsPages

public void appendTIFFAsPages(String tiffFileName)
                       throws PDFException,
                              IOException

Appends the pages in a TIFF file to the end of this document. The method will create a new page for each image in a TIFF file and then draw the image onto the page. The page dimensions will be the same as for the TIFF image, calculated using the TIFF dpi value.

Parameters:

tiffFileName - The name of the TIFF file to add to this document.

Throws:

PDFException

IOException

appendTIFFAsPages

public void appendTIFFAsPages(InputStream inStream)
                       throws PDFException,
                              IOException

Appends the pages in a TIFF image from an input stream to the end of this document. The method will create a new page for each image in a TIFF file and then draw the image onto the page. The page dimensions will be the same as for the TIFF image, calculated using the TIFF dpi value.

Parameters:

inStream - The input stream to read the TIFF image from

Throws:

PDFException

IOException

appendJPEGAsPage

public void appendJPEGAsPage(String jpegFileName)
                      throws PDFException,
                             IOException

Creates a new page in the PDF document and adds the JPEG file to it. The method looks at the DPI value in the JPEG image to determine the size of the new page. If not present, the method defaults to 72 DPI.

Parameters:

jpegFileName - The name of the JPEG file to add to this document.

Throws:

PDFException

IOException

appendJPEGAsPage

public void appendJPEGAsPage(String jpegFileName,
                             int dpi)
                      throws PDFException,
                             IOException

Creates a new page in the PDF document and adds the JPEG file to it. The method ignores the DPI value in the file and uses the dpi passed into the method to determine the page size.

Parameters:

jpegFileName - The name of the JPEG file to add to this document.

Throws:

PDFException

IOException

appendPNGAsPage

public void appendPNGAsPage(String pngFileName)
                     throws PDFException,
                            IOException

Creates a new page in the PDF document and adds the PNG file to it. The method looks at the DPI value in the PNG image to determine the size of the new page. If not present, the method defaults to 72 DPI.

Parameters:

pngFileName - The name of the PNG file to add to this document.

Throws:

PDFException

IOException

insertPage

public void insertPage(PDFPage page,
                       int index)
                throws PDFException

Inserts a page into this document at the given index. If the index is less than 0, the page is inserted as the first page. If the index is greater than the number of pages in the document, the page is appended to the document.

Parameters:

page - The page to add to the document.

index - Location where to insert the new page.

Throws:

PDFException

deletePage

public void deletePage(int index)
                throws PDFException

Deletes a page from this document. If the index is out of bounds, (index < 0 or index >= number of pages) this method has no effect on the document.

Parameters:

index - Index of the page to remove.

Throws:

PDFException

exportAnnotsAsFDF

public void exportAnnotsAsFDF(String fileName)
                       throws PDFException

Exports annotations comments in FDF format.

Parameters:

fileName - The name of the file to export the data to.

Throws:

PDFException

exportAnnotsAsFDF

public void exportAnnotsAsFDF(OutputStream outStream,
                              String pathToPDFFile)
                       throws PDFException,
                              IOException

Export annotations comments to an output stream in FDF format.

Parameters:

outStream - The output stream to write the data to.

pathToPDFFile - is the relative path from the fdf file to the pdf file name. This parameter can be left null. This parameter is used to fill the pdf file name entry in the FDF file, the file entry will be set to pathToPDFFile + fileNa The file entry is used when you open an fdf file to be able to locate the corresponding pdf file. Example of pathToPDFFile ../qoppa/mydir

Throws:

PDFException

IOException

exportAnnotsAsXFDF

public void exportAnnotsAsXFDF(String fileName)
                        throws PDFException

Exports annotations comments in XFDF format.

Parameters:

fileName - The name of the file to export the data to.

Throws:

PDFException

importAnnotsFDF

public void importAnnotsFDF(InputStream inStream)
                     throws PDFException

Import annotations comments from an input stream in FDF format.

Parameters:

inStream - The input stream in FDF format to read the data from.

Throws:

PDFException

importAnnotsFDF

public void importAnnotsFDF(String fileName)
                     throws PDFException

Import annotations comments from a file in FDF Format.

Parameters:

fileName - The name of the FDF file to import the data from.

Throws:

PDFException

importAnnotsXFDF

public void importAnnotsXFDF(String fileName)
                      throws PDFException

Import Acroform fields data from a file in XML Format.

Parameters:

fileName - The name of the XML file to import the data from.

Throws:

PDFException

importAnnotsXFDF

public void importAnnotsXFDF(InputStream inStream)
                      throws PDFException

Import AcroForm field data from an input stream in XML format.

Parameters:

inStream - The input stream in XML format to read the data from.

Throws:

PDFException

exportAnnotsAsXFDF

public void exportAnnotsAsXFDF(OutputStream outStream,
                               String pathToPDFFile)
                        throws PDFException

Export annotations comments to an output stream in XFDF format.

Parameters:

outStream - The output stream to write the data to.

pathToPDFFile - is the relative path from the fdf file to the pdf file name. This parameter can be left null. This parameter is used to fill the pdf file name entry in the FDF file, the file entry will be set to pathToPDFFile + fileNa The file entry is used when you open an fdf file to be able to locate the corresponding pdf file. Example of pathToPDFFile ../qoppa/mydir

Throws:

IOException

PDFException

appendNewPage

public PDFPage appendNewPage(double pageWidth,
                             double pageHeight)
                      throws PDFException

Creates and appends a new PDFPage to this document. The pageWidth and pageHeight are specified in 72DPI. The page object can be drawn to by getting a graphics object from it and then drawing to that.

Parameters:

pageWidth - Width of the page in 72DPI.

pageHeight - Height of the page in 72DPI.

Throws:

PDFException

insertNewPage

public PDFPage insertNewPage(double pageWidth,
                             double pageHeight,
                             int index)
                      throws PDFException

Creates a new PDFPage and inserts it into the document at the given position. The pageWidth and pageHeight are specified in 72DPI. The page object can be drawn to by getting a graphics object from it and then drawing to that.

Parameters:

pageWidth - Width of the page in 72DPI.

pageHeight - Height of the page in 72DPI.

Throws:

PDFException

saveDocument

public void saveDocument(String fileName)
                  throws IOException,
                         PDFException

Saves this document to a file.

Parameters:

fileName - Name of the file to save the document.

Throws:

IOException

PDFException

saveDocumentAsTIFF

public void saveDocumentAsTIFF(OutputStream outStream,
                               double resDPI,
                               String tiffCompression)
                        throws PDFException,
                               IOException

Save the entire document as a multi-page TIFF image to the given OutputStream. dpi is the resolution in DPI used to render the pages, 72 is the native PDF resolution and is equivalent to 100% scale.

If any of the CCITT compression algorithms are used, the image will be converted to black and white before saving.

Parameters:

outStream - The stream to save the image to.

resDPI - Dots per inch at which to render the image, 72 is the native PDF resolution and is equivalent to 100% scale..

tiffCompression - The type of TIFF compression to use. This value needs to be one of these predefined values:

TIFFCompression.TIFF_DEFLATE - Deflate lossless compression (Zip-in-TIFF)
TIFFCompression.TIFF_CCITT_RLE - CCITT Modified Huffman RLE
TIFFCompression.TIFF_CCITT_T4 - CCITT Group 3 fax encoding
TIFFCompression.TIFF_CCITT_T6 - CCITT Group 4 fax encoding
TIFFCompression.TIFF_JPEG - JPEG-in-TIFF compression.
TIFFCompression.TIFF_LZW - LZW Compression
TIFFCompression.TIFF_PACKBITS - Byte-oriented run-length encoding "PackBits" compression.
TIFFCompression.TIFF_ZLIB - ZLib Compression.
TIFFCompression.TIFF_NO_COMPRESSION - No compression.

Throws:

PDFException

IOException

saveDocumentAsTIFF

public void saveDocumentAsTIFF(OutputStream outStream,
                               TIFFOptions options)
                        throws PDFException,
                               IOException

Save the entire document as a multi-page TIFF image to an OutputStream. This method takes a TIFFOptions object as an argument to describe various TIFF options when saving the file.

Parameters:

outStream - The stream to save the image to.

options - Options to use when saving the TIFF file.

Throws:

PDFException

IOException

saveDocument

public void saveDocument(OutputStream outStream)
                  throws IOException,
                         PDFException

Saves this document to an output stream.

Parameters:

outStream - OutputStream where the document will be written to.

Throws:

IOException

PDFException

setKey

public static boolean setKey(String key)

Method to unlock the production version of the library.

Parameters:

key - Production key.

loadRTF

public static PDFDocument loadRTF(String rtfFile,
                                  PageFormat pf)
                           throws PDFException,
                                  IOException,
                                  BadLocationException

Creates a PDFDocument from an RTF file. The document will create as many pages as needed to draw the full RTF document.

Parameters:

rtfFile - - Name of the RTF file.

pf - - PageFormat to use when creating pages in the PDF document.

Throws:

PDFException

IOException

BadLocationException

useFont

public PDFObjectReference useFont(Font font)

Internal method used when using fonts in this document.

getVersion

public static String getVersion()

Returns version string for jPDFProcess. If this is the demo version, the return string will contain 'Demo Version' at the end.

getPage

public PDFPage getPage(int pageIndex)

Returns a page in this document.

Parameters:

pageIndex - Index of the page to return.

getPageable

public Pageable getPageable(PrinterJob pJob)

Returns an object that implements Pageable for this PDF document. The method takes a PrinterJob object as a parameter because information about the printer is needed in order to fulfill the Pageable interface properly.

Specified by:

getPageable in interface IPDFDocument

Parameters:

pJob - PrinterJob object where the Pageable will be used.

Returns:

Object that implements the Pageable interface.

getPageCount

public int getPageCount()

Returns the number of pages in this document.

Specified by:

getPageCount in interface IPDFDocument

getIPage

public IPDFPage getIPage(int pageIndex)

Internal method, do not use.

Specified by:

getIPage in interface IPDFDocument

Parameters:

pageIndex - Index of the page to return.

getFile

public File getFile()

Returns the file for the current pdf file. This value is only valid when the document was loaded from a file. The method will return null if the document was loaded from an InputStream or a URL.

Specified by:

getFile in interface IPDFDocument

Returns:

The file for the pdf document.

getFileName

public String getFileName()

Returns the name of the pdf document file without the full path. This value is only valid when the document was loaded from a file. The method will return null if the document was loaded from an InputStream or a URL.

Specified by:

getFileName in interface IPDFDocument

Returns:

The name of the file that this document was loaded from.

getFileOriginalID

public String getFileOriginalID()

Returns the file original ID. A PDF document contains 2 IDs, an original ID and a modified ID generated by the application that created or modified the document.

Specified by:

getFileOriginalID in interface IPDFDocument

Returns:

The PDF document "original" ID.

getFileModifiedID

public String getFileModifiedID()

Returns the file modified ID. A PDF document contains 2 IDs, an original ID and a modified ID generated by the application that created or modified the document.

Specified by:

getFileModifiedID in interface IPDFDocument

Returns:

The PDF document "modified" ID.

addLayer

public Layer addLayer(String name,
                      int initialState)
               throws PDFException

Creates and returns a PDF layer (Optional Content Group). This layer can then be used to add optional content sections to the document by passing it as a parameter to the createGraphics method in PDFPage.

Parameters:

name - The name of the layer. This name will show up on a PDF viewer to turn the layer on or off.

initialState - The initial visibility state of the layer. This determines whether the layer will be visible or not when the PDF document is opened. Valid values for this are Layer.STATE_ON or Layer.STATE_OFF.

Throws:

PDFException

setPrintSettings

public void setPrintSettings(PrintSettings printSettings)

Set the PrintSettings to be used on the next printout.

Specified by:

setPrintSettings in interface IPDFDocument

Parameters:

printSettings - Settings to use on the next printout.

setSecurity

public void setSecurity(String newPermissionsPwd,
                        String newOpenPwd,
                        PDFPermissions permissions,
                        String currentPermissionsPwd,
                        int encryptType)
                 throws PDFException

Sets the security for this document. If the open password is null, the user won't have to enter a password to open the document. If the permissions password is null, any user can change the permissions on the document. The document will be encrypted regardless. To clear the encryption, call the clearSecurity method.

Parameters:

newPermissionsPwd - The document's permissions password.

newOpenPwd - The document's open password.

permissions - Permission object.

currentPermissionsPwd - The current permissions password in the document, if any. This password is needed to be able to change the passwords and permissions in a document.

encryptType - - The encryption type to use, this value can be either PDFPermissions.ENCRYPTION_RC4 or PDFPermissions.ENCRYPTION_AES.

Throws:

PDFPermissionException - If currentPermissionsPwd is invalid.

PDFException

clearSecurity

public void clearSecurity(String currentPermissionsPwd)
                   throws PDFPermissionException

Clears the security for this document. Calling this method will clear user password, owner password, permissions and encryption.

Parameters:

currentPermissionsPwd - The current permissions password in the document, if any. This password is needed to be able to change the passwords and permissions in a document.

Throws:

PDFPermissionException - If currentPermissionsPwd is invalid.

hasOpenPassword

public boolean hasOpenPassword()

Returns a flag indicating whether this document is encrypted with a 'user' password.

Returns:

boolean true if the document is encrypted with an open password, false otherwise.

isEncrypted

public boolean isEncrypted()

Returns a flag indicating whether this document is encrypted.

Returns:

boolean true if the document is encrypted with a user password, false otherwise.

getEncryptionLength

public int getEncryptionLength()

Returns an int representing the number of bits used in the encryption technique. The integer is the length of the encryption key. It can be 40 for the 40 bits encryption or 128 for 128 bits encryption. -1 indicates that the documents is not encrypted.

Returns:

int The number of bits used in the encryption algorithm.

getEncryptionAlgorithm

public String getEncryptionAlgorithm()

Returns the name of the encryption algorithm used to encrypt the document. If the document is not encrypted, the method returns null. Encryptions supported are RC4 and AES.

Returns:

The name of the encryption algorithm.

print

public int print(Graphics graphics,
                 PageFormat pageFormat,
                 int pageIndex)
          throws PrinterException

Prints the page. This method fulfills the Printable interface and usually gets called by PrinterJob when printing the document.

Specified by:

print in interface Printable

Throws:

PrinterException

print

public void print(PrintSettings printSettings)
           throws PDFPermissionException,
                  PrinterException

Prints this PDF document. This method will prompt the user with the printer dialog and then print the document.

If more control is desired when printing, the calling application can create its own PrinterJob and then use this object as a Printable or a Pageable in the PrinterJob before initiating the printout.

Specified by:

print in interface IPDFDocument

Parameters:

printSettings - Print job settings. Use this object to tell jPDFProcess how to print the document. If null, the library will print using default settings.

Throws:

PDFPermissionException

PrinterException

print

public void print(String printerName,
                  PrintSettings printSettings)
           throws PDFPermissionException,
                  PrinterException

Prints this PDF document to the specified printer, by name. If the printerName parameter is null, this method will print to the default printer. This method can only be called if using Java 1.4.2 or higher as it needs PrintServices, which were only implemented starting on 1.4.

If finer control of printing is necessary, the PDFPrint object implements both Printable and Pageable (through its getPageable method). The host application can then create its own PrinterJob and set any settings necessary, then call either setPageable or setPrintable and then start the print job.

Parameters:

printSettings - Print job settings. Use this object to tell the library how to print the document. If null, the library will print using default settings.

printerName - The name of the printer to print to. If this parameter is set to null, the method will print to the default printer.

Throws:

PrinterException - This exception is thrown if the printer is not found or if there is an error while printing.

PDFPermissionException

print

public void print(String printerName,
                  PrintSettings printSettings,
                  PrintRequestAttributeSet printAttrSet)
           throws PDFPermissionException,
                  PrinterException

Prints this PDF document to the specified printer, by name and passes the print request attribute set to the printer job. If the printerName parameter is null, this method will print to the default printer. If the printAttrSet parameter is null, this is equivalent to calling print (printerName, printSettings). This method can only be called if using Java 1.4.2 or higher as it needs PrintServices, which were only implemented starting on 1.4.

If finer control of printing is necessary, the PDFPrint object implements both Printable and Pageable (through its getPageable method). The host application can then create its own PrinterJob and set any settings necessary, then call either setPageable or setPrintable and then start the print job.

Parameters:

printSettings - Print job settings. Use this object to tell the library how to print the document. If null, the library will print using default settings.

printerName - The name of the printer to print to. If this parameter is set to null, the method will print to the default printer.

printAttrSet - The attribute set to pass to the printer. This parameter simply gets passed through to the printer job to set options such as the media tray, chromaticity and others. If null is passed, the print job will use default attributes.

Throws:

PrinterException - This exception is thrown if the printer is not found or if there is an error while printing.

PDFPermissionException

hasPermissionsPassword

public boolean hasPermissionsPassword()

Returns a flag indicating whether this document is encrypted with a 'owner' password.

Returns:

boolean true if the document is encrypted with a permissions password, false otherwise.

getPermissions

public final PDFPermissions getPermissions()

Returns the permission object for this document. A new permissions object with all permissions is returned if the document is not encrypted.

Specified by:

getPermissions in interface IPDFDocument

Returns:

The permission object.

getPrintSettings

public PrintSettings getPrintSettings()

Get the current PrintSettings object.

Specified by:

getPrintSettings in interface IPDFDocument

addEmbeddedFile

public boolean addEmbeddedFile(File file)
                        throws IOException,
                               PDFException

Embeds a file into this PDF document. The file is not embedded as an annotation, it simply gets embedded, so it will be visible in the attachments pane.

Parameters:

file - The file to embed in the document

Returns:

true if the file is embedded successfully

Throws:

IOException

PDFException

getEmbeddedFiles

public Vector getEmbeddedFiles()

Returns the list of embedded files in the document (annotations attachments are not part of the list). The list is a vector of @see com.qoppa.pdf.IEmbeddedFile.

Specified by:

getEmbeddedFiles in interface IPDFDocument

Returns:

Vector a vector of IEmbbededFile

removeEmbeddedFile

public boolean removeEmbeddedFile(IEmbeddedFile ef)
                           throws IOException,
                                  PDFException

Remove a file embedded in this document. The list of embedded files can be obtained through the getEmbeddedFiles() method.

Parameters:

ef - the embedded file to remove

Returns:

true if the embedded file was removed, false if not

Throws:

IOException

PDFException

getText

public String getText()
               throws PDFException

Returns the text in the pdf document as a String. Pages are separated with a return char.

Specified by:

getText in interface IPDFDocument

Returns:

Text contained in the pdf document as String.

Throws:

PDFException

getText

public String getText(int pageIndex)
               throws PDFException

Returns text contained in the specified page of the pdf document as a String.

Specified by:

getText in interface IPDFDocument

Parameters:

pageIndex - is the 0 based page number. pageIndex = 0 is the first page of the document.

Returns:

Text contained in the specified page as a String.

Throws:

PDFException

getWords

public Vector getWords()
                throws PDFException

Returns all words in the pdf document as a Vector of Strings.

Returns:

Words contained in the pdf document as a Vector of Strings.

Throws:

PDFException

getWords

public Vector getWords(int pageIndex)
                throws PDFException

Returns all words contained in the specified page of the pdf document as a Vector of Strings.

Parameters:

pageIndex - is the 0 based page number. pageIndex = 0 is the first page of the document.

Returns:

Words contained in the specified page as a Vector of Strings.

Throws:

PDFException

getRootBookmark

public Bookmark getRootBookmark()

Returns the 'root' bookmark. Bookmarks form a tree structure in a document.

Specified by:

getRootBookmark in interface IPDFDocument

Returns:

Bookmark The root bookmark for this document.

getLayerCount

public int getLayerCount()

Returns the number of PDF layers in this document.

Specified by:

getLayerCount in interface IPDFDocument

Returns:

Number of layers in the document.

getLayer

public Layer getLayer(int layerIndex)

Returns a particular PDF layer given its index.

Specified by:

getLayer in interface IPDFDocument

Returns:

A reference to the PDF layer.

addDocumentListener

public void addDocumentListener(IDocumentListener listener)

Internal method to keep track of document events.

Specified by:

addDocumentListener in interface IPDFDocument

removeDocumentListener

public void removeDocumentListener(IDocumentListener listener)

Internal method to keep track of document events.

Specified by:

removeDocumentListener in interface IPDFDocument

getDocumentInfo

public DocumentInfo getDocumentInfo()

Returns a copy of a DocumentInfo object containing the information section of a PDF document (author, title, etc.).
Note: The object returned by this method is a copy of the document info from this document, making any changes to the object will have no effect on the document when it is saved. To change the document's info, the host application must call setDocumentInfo (DocumentInfo newInfo)

Specified by:

getDocumentInfo in interface IPDFDocument

Returns:

DocumentInfo Object containing header information for the document.

setDocumentInfo

public void setDocumentInfo(DocumentInfo newInfo)
                     throws PDFException

Copies and sets this document's info. The information sent to this method is copied into the document, so any changes in the newInfo object after this call is made will not be reflected in the document unless setDocumentInfo is called again.

Parameters:

newInfo - The new document information.

Throws:

PDFException

getAcroForm

public AcroForm getAcroForm()

Returns the AcroForm in this document. Returns null if the document has no fields.

Specified by:

getAcroForm in interface IPDFDocument

Returns:

AcroForm The AcroForm object for this document.

deleteAnnotations

public void deleteAnnotations()
                       throws PDFException

Delete all annotations in the document.

Throws:

PDFException

flattenAnnotations

public void flattenAnnotations(boolean paintNonPrintableAnnots)
                        throws PDFException

Flattens the annotations. This method paints the content of the annotations directly into the pages and remove the annotations themselves from the document.

Parameters:

paintNonPrintableAnnots - Flag to indicate whether non-printable annotations should be painted or not.

Throws:

PDFException

flattenFields

public void flattenFields(boolean paintButtons,
                          boolean paintNonPrintableFields)
                   throws PDFException

Flattens the pdf form fields. This method paints the content of the fields directly into the pages and remove the fields themselves from the document.

Parameters:

paintButtons - Flag to indicate whether push buttons should be painted or not.

paintNonPrintableFields - Flag to indicate whether non-printable fields should be painted or not.

Throws:

PDFException

createRootBookmark

public Bookmark createRootBookmark()
                            throws PDFException

Creates a new root bookmark and saves it in the document catalog. When this method is called, any existing bookmarks will be discarded and the new root bookmark will be put in place. Initially, the new root bookmark will have no children (no entries will be displayed in the bookmarks pane when viewing the document).

Returns:

The new root bookmark.

Throws:

PDFException

getPDFFileVersion

public String getPDFFileVersion()

Return the PDF file version for the current document.

Returns:

The version of the PDF document.

setPageMode

public void setPageMode(String pageMode)
                 throws PDFException

Changes the value of the page mode viewer preference in the document. The page mode is used when the document is opened in a PDF Viewer.

Parameters:

pageMode - The new page mode. This value has to be one of:
PAGEMODE_USENONE: Neither document outline nor thumbnail images are visible.
PAGEMODE_USEOUTLINES: Document outline visible.
PAGEMODE_USETHUMBS: Thumbnail images visible.
PAGEMODE_FULLSCREEN: Full screen mode, with no menu bar, window controls, or any other window visible.

Throws:

PDFException

signDocument

public void signDocument(SignatureField signField,
                         SigningInformation signingInfo)
                  throws PDFException

Signs this document using the given signature field.

Parameters:

signField - The field to use to sign the document.

signingInfo - Information required to sign the document.

Throws:

PDFException

embedFont

public Font embedFont(String fileName,
                      int fontFormat)
               throws IOException,
                      FontFormatException,
                      PDFException

Embeds a font in the PDF file. Use this method to use custom fonts when creating a PDF file. The method returns a Font object that can then be used in the setFont method of Graphics2D. The fonts returned by this method can be used to generate different sizes using deriveFont, but not to generate different styles (bold, italic)

Parameters:

fileName - Name of the font file.

fontFormat - Font format. This can be Font.TRUETYPE_FONT or Font.TYPE1_FONT (if using JDK1.5)

Returns:

Font - The newly created Font object. This can be used in Graphics2d.setFont().

Throws:

IOException

FontFormatException

PDFException