Package org.apache.fop.render.pdf

Class PDFRenderingUtil

java.lang.Object

org.apache.fop.render.pdf.PDFRenderingUtil

class PDFRenderingUtil
extends Object

Utility class which enables all sorts of features that are not directly connected to the normal rendering process.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	PDFRenderingUtil.EncryptionParamsBuilder

Field Summary

Fields

Modifier and Type	Field	Description
private static org.apache.commons.logging.Log	log	logging instance
private PDFICCStream	outputProfile	the ICC stream used as output profile by this document for PDF/A and PDF/X functionality.
private PDFDocument	pdfDoc	the PDF Document being created
private PDFRendererOptionsConfig	rendererConfig
private PDFICCBasedColorSpace	sRGBColorSpace	the default sRGB color space.
private FOUserAgent	userAgent

Constructor Summary

Constructors

Constructor	Description
PDFRenderingUtil(FOUserAgent userAgent)

Method Summary

Modifier and Type	Method	Description
private void	addDefaultOutputProfile()
void	addEmbeddedFile(PDFEmbeddedFileAttachment embeddedFile)	Adds an embedded file to the PDF file.
void	addLayer(PDFDictionaryExtension extension)
void	addNavigator(PDFDictionaryExtension extension)
void	addNavigatorAction(PDFDictionaryExtension extension)
private void	addPDFA1OutputIntent()	Adds an OutputIntent to the PDF as mandated by PDF/A-1 when uncalibrated color spaces are used (which is true if we use DeviceRGB to represent sRGB colors).
private void	addPDFXOutputIntent()	Adds an OutputIntent to the PDF as mandated by PDF/X when uncalibrated color spaces are used (which is true if we use DeviceRGB to represent sRGB colors).
private void	addsRGBColorSpace()
private PDFArray	augmentArray(PDFArray array, PDFArrayExtension extension)
private void	augmentArray(PDFArray array, PDFCollectionEntryExtension entry)
private void	augmentDictionary(PDFDictionary dictionary, PDFCollectionEntryExtension entry)
private PDFDictionary	augmentDictionary(PDFDictionary dictionary, PDFDictionaryExtension extension)
protected static PDFRendererOptionsConfig	createFromUserAgent(FOUserAgent userAgent)
void	generateDefaultXMPMetadata()
void	generatePageLabel(int pageIndex, String pageNumber)	Generates a page label in the PDF document.
private boolean	hasKeyedEntry(List<?> entries)
private void	initialize()
private Object	makeArray(Object value)
private Object	makeDictionary(Object value)
private Object	makeDictionaryOrArray(Object value)
(package private) void	mergeRendererOptionsConfig(PDFRendererOptionsConfig config)
private Object	populateArray(PDFArray array, List<?> entries)
private Object	populateDictionary(PDFDictionary dictionary, List<?> entries)
void	renderDictionaryExtension(PDFDictionaryAttachment attachment, PDFPage currentPage)
void	renderDictionaryExtension(PDFDictionaryExtension extension, PDFPage currentPage)
private void	renderExtension(PDFPage currentPage, ExtensionAttachment extension)
void	renderXMPMetadata(XMPMetadata metadata)
private Object	resolveReference(PDFReferenceExtension entry)
PDFDocument	setupPDFDocument(OutputStream out)
private void	updateInfo()
private void	updatePDFProfiles()

Methods inherited from class java.lang.Object

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

Field Details

log

private static org.apache.commons.logging.Log log

logging instance

userAgent

private FOUserAgent userAgent

pdfDoc

private PDFDocument pdfDoc

the PDF Document being created

rendererConfig

private PDFRendererOptionsConfig rendererConfig

outputProfile

private PDFICCStream outputProfile

the ICC stream used as output profile by this document for PDF/A and PDF/X functionality.

sRGBColorSpace

private PDFICCBasedColorSpace sRGBColorSpace

the default sRGB color space.

Constructor Details

PDFRenderingUtil

PDFRenderingUtil(FOUserAgent userAgent)

Method Details

initialize

private void initialize()

createFromUserAgent

protected static PDFRendererOptionsConfig createFromUserAgent(FOUserAgent userAgent)

mergeRendererOptionsConfig

void mergeRendererOptionsConfig(PDFRendererOptionsConfig config)

updateInfo

private void updateInfo()

updatePDFProfiles

private void updatePDFProfiles()

addsRGBColorSpace

private void addsRGBColorSpace()
                        throws IOException

Throws:

IOException

addDefaultOutputProfile

private void addDefaultOutputProfile()
                              throws IOException

Throws:

IOException

addPDFA1OutputIntent

private void addPDFA1OutputIntent()
                           throws IOException

Adds an OutputIntent to the PDF as mandated by PDF/A-1 when uncalibrated color spaces are used (which is true if we use DeviceRGB to represent sRGB colors).

Throws:

IOException - in case of an I/O problem

addPDFXOutputIntent

private void addPDFXOutputIntent()
                          throws IOException

Adds an OutputIntent to the PDF as mandated by PDF/X when uncalibrated color spaces are used (which is true if we use DeviceRGB to represent sRGB colors).

Throws:

IOException - in case of an I/O problem

renderXMPMetadata

public void renderXMPMetadata(XMPMetadata metadata)

generateDefaultXMPMetadata

public void generateDefaultXMPMetadata()

renderDictionaryExtension

public void renderDictionaryExtension(PDFDictionaryAttachment attachment,
 PDFPage currentPage)

addLayer

public void addLayer(PDFDictionaryExtension extension)

addNavigatorAction

public void addNavigatorAction(PDFDictionaryExtension extension)

addNavigator

public void addNavigator(PDFDictionaryExtension extension)

makeArray

private Object makeArray(Object value)

populateArray

private Object populateArray(PDFArray array,
 List<?> entries)

makeDictionary

private Object makeDictionary(Object value)

populateDictionary

private Object populateDictionary(PDFDictionary dictionary,
 List<?> entries)

makeDictionaryOrArray

private Object makeDictionaryOrArray(Object value)

hasKeyedEntry

private boolean hasKeyedEntry(List<?> entries)

renderDictionaryExtension

public void renderDictionaryExtension(PDFDictionaryExtension extension,
 PDFPage currentPage)

renderExtension

private void renderExtension(PDFPage currentPage,
 ExtensionAttachment extension)

augmentDictionary

private PDFDictionary augmentDictionary(PDFDictionary dictionary,
 PDFDictionaryExtension extension)

augmentDictionary

private void augmentDictionary(PDFDictionary dictionary,
 PDFCollectionEntryExtension entry)

resolveReference

private Object resolveReference(PDFReferenceExtension entry)

augmentArray

private PDFArray augmentArray(PDFArray array,
 PDFArrayExtension extension)

augmentArray

private void augmentArray(PDFArray array,
 PDFCollectionEntryExtension entry)

setupPDFDocument

public PDFDocument setupPDFDocument(OutputStream out)
                             throws IOException

Throws:

IOException

generatePageLabel

public void generatePageLabel(int pageIndex,
 String pageNumber)

Generates a page label in the PDF document.

Parameters:

pageIndex - the index of the page

pageNumber - the formatted page number

addEmbeddedFile

public void addEmbeddedFile(PDFEmbeddedFileAttachment embeddedFile)
                     throws IOException

Adds an embedded file to the PDF file.

Parameters:

embeddedFile - the object representing the embedded file to be added

Throws:

IOException - if an I/O error occurs