com.openhtmltopdf.pdfboxout

Class PdfRendererBuilder

java.lang.Object

com.openhtmltopdf.outputdevice.helper.BaseRendererBuilder<PdfRendererBuilder,PdfRendererBuilderState>

com.openhtmltopdf.pdfboxout.PdfRendererBuilder

public class PdfRendererBuilder
extends BaseRendererBuilder<PdfRendererBuilder,PdfRendererBuilderState>

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PdfRendererBuilder.CacheStore List of caches available.
static class	PdfRendererBuilder.PdfAConformance Various level of PDF/A conformance: PDF/A-1, PDF/A-2 and PDF/A-3

Nested classes/interfaces inherited from class com.openhtmltopdf.outputdevice.helper.BaseRendererBuilder

BaseRendererBuilder.BaseRendererBuilderState, BaseRendererBuilder.FontStyle, BaseRendererBuilder.FSFontUseCase, BaseRendererBuilder.PageSizeUnits, BaseRendererBuilder.TextDirection

Field Summary

Fields inherited from class com.openhtmltopdf.outputdevice.helper.BaseRendererBuilder

PAGE_SIZE_LETTER_HEIGHT, PAGE_SIZE_LETTER_UNITS, PAGE_SIZE_LETTER_WIDTH, state

Constructor Summary

Constructors

Constructor and Description
PdfRendererBuilder()

Method Summary

Modifier and Type	Method and Description
PdfBoxRenderer	buildPdfRenderer() Build a PdfBoxRenderer for further customization.
PdfBoxRenderer	buildPdfRenderer(Closeable diagnosticConsumer)
void	run() Run the XHTML/XML to PDF conversion and output to an output stream set by toStream.
PdfRendererBuilder	toStream(OutputStream out) An output stream to output the resulting PDF.
PdfRendererBuilder	useCacheStore(PdfRendererBuilder.CacheStore which, FSCacheEx<String,FSCacheValue> cache) Use a specific cache.
PdfRendererBuilder	useColorProfile(byte[] colorProfile) Sets the color profile, needed for PDF/A conformance.
PdfRendererBuilder	useFont(PDFontSupplier supplier, String fontFamily) Simpler overload for #useFont(PDFontSupplier, String, Integer, FontStyle, boolean)
PdfRendererBuilder	useFont(PDFontSupplier supplier, String fontFamily, Integer fontWeight, BaseRendererBuilder.FontStyle fontStyle, boolean subset) Like BaseRendererBuilder.useFont(FSSupplier, String, Integer, FontStyle, boolean) but allows to supply a PDFont directly.
PdfRendererBuilder	useHyphenation(Hyphenator hyphenator) Provide a custom auto-hyphenator, that will be used, if the 'hyphens' is being used in css
PdfRendererBuilder	usePageSupplier(PageSupplier pageSupplier) Set a PageSupplier that is called whenever a new page is needed.
PdfRendererBuilder	usePDDocument(org.apache.pdfbox.pdmodel.PDDocument doc) By default, this project creates an entirely in-memory PDDocument.
PdfRendererBuilder	usePdfAConformance(PdfRendererBuilder.PdfAConformance pdfAConformance) Set the PDF/A conformance, typically we use PDF/A-1
PdfRendererBuilder	usePdfUaAccessbility(boolean pdfUaAccessibility) Deprecated. Misspelled method name
PdfRendererBuilder	usePdfUaAccessibility(boolean pdfUaAccessibility) Whether to conform to PDF/UA or Accessible PDF.
PdfRendererBuilder	usePdfVersion(float version) Set the PDF version, typically we use 1.7.
PdfRendererBuilder	withProducer(String producer) Set a producer on the output document

Methods inherited from class com.openhtmltopdf.outputdevice.helper.BaseRendererBuilder

addDOMMutator, applyDiagnosticConsumer, defaultTextDirection, testMode, useDefaultPageSize, useDocumentBuilderFactoryImplementationClass, useExternalResourceAccessControl, useFastMode, useFont, useFont, useFont, useFont, useFont, useFont, useHttpStreamImplementation, useInitialPageNumber, useMathMLDrawer, useObjectDrawerFactory, useProtocolsStreamImplementation, useProtocolsStreamImplementation, useReplacementText, useSVGDrawer, useTransformerFactoryImplementationClass, useUnicodeBidiReorderer, useUnicodeBidiSplitter, useUnicodeCharacterBreaker, useUnicodeLineBreaker, useUnicodeToLowerTransformer, useUnicodeToTitleTransformer, useUnicodeToUpperTransformer, useUriResolver, withDiagnosticConsumer, withFile, withHtmlContent, withUri, withW3cDocument

Methods inherited from class java.lang.Object

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

Constructor Detail

PdfRendererBuilder

public PdfRendererBuilder()

Method Detail

run

public void run()
         throws IOException

Run the XHTML/XML to PDF conversion and output to an output stream set by toStream.

Throws:

IOException

buildPdfRenderer

public PdfBoxRenderer buildPdfRenderer()

Build a PdfBoxRenderer for further customization. Remember to call PdfBoxRenderer.close() after use.

buildPdfRenderer

public PdfBoxRenderer buildPdfRenderer(Closeable diagnosticConsumer)

toStream

public PdfRendererBuilder toStream(OutputStream out)

An output stream to output the resulting PDF. The caller is required to close the output stream after calling run.

usePdfVersion

public PdfRendererBuilder usePdfVersion(float version)

Set the PDF version, typically we use 1.7. If you set a lower version, it is your responsibility to make sure no more recent PDF features are used.

usePdfAConformance

public PdfRendererBuilder usePdfAConformance(PdfRendererBuilder.PdfAConformance pdfAConformance)

Set the PDF/A conformance, typically we use PDF/A-1

Note: PDF/A documents require fonts to be embedded. So if this is not set to NONE, the built-in fonts will not be available and currently any text without a specified and embedded font will cause the renderer to crash with an exception.

usePdfUaAccessbility

@Deprecated
public PdfRendererBuilder usePdfUaAccessbility(boolean pdfUaAccessibility)

Deprecated. Misspelled method name

Whether to conform to PDF/UA or Accessible PDF. False by default.

See Also:

usePdfUaAccessibility(boolean)

usePdfUaAccessibility

public PdfRendererBuilder usePdfUaAccessibility(boolean pdfUaAccessibility)

Whether to conform to PDF/UA or Accessible PDF. False by default.

useColorProfile

public PdfRendererBuilder useColorProfile(byte[] colorProfile)

Sets the color profile, needed for PDF/A conformance.

You can use the sRGB.icc from Apache PdfBox

usePDDocument

public PdfRendererBuilder usePDDocument(org.apache.pdfbox.pdmodel.PDDocument doc)

By default, this project creates an entirely in-memory PDDocument. The user can use this method to create a document either entirely on-disk or a mix of in-memory and on-disk using the PDDocument constructor that takes a MemoryUsageSetting.

Parameters:

doc - a (usually empty) PDDocument

Returns:

this for method chaining

useFont

public PdfRendererBuilder useFont(PDFontSupplier supplier,
                                  String fontFamily,
                                  Integer fontWeight,
                                  BaseRendererBuilder.FontStyle fontStyle,
                                  boolean subset)

Like BaseRendererBuilder.useFont(FSSupplier, String, Integer, FontStyle, boolean) but allows to supply a PDFont directly. Subclass PDFontSupplier if you need special font-loading rules (like using a font-cache).

useFont

public PdfRendererBuilder useFont(PDFontSupplier supplier,
                                  String fontFamily)

Simpler overload for #useFont(PDFontSupplier, String, Integer, FontStyle, boolean)

withProducer

public PdfRendererBuilder withProducer(String producer)

Set a producer on the output document

Parameters:

producer - the name of the producer to set defaults to openhtmltopdf.com

Returns:

this for method chaining

useHyphenation

public PdfRendererBuilder useHyphenation(Hyphenator hyphenator)

Provide a custom auto-hyphenator, that will be used, if the 'hyphens' is being used in css

Parameters:

hyphenator - custom hyphenator, that should be used

useCacheStore

public PdfRendererBuilder useCacheStore(PdfRendererBuilder.CacheStore which,
                                        FSCacheEx<String,FSCacheValue> cache)

Use a specific cache. Cache values should be thread safe, so provided your cache store itself is thread safe can be used across threads.

Returns:

this for method chaining.

See Also:

PdfRendererBuilder.CacheStore

usePageSupplier

public PdfRendererBuilder usePageSupplier(PageSupplier pageSupplier)

Set a PageSupplier that is called whenever a new page is needed.

Parameters:

pageSupplier - PageSupplier to use

Returns:

this for method chaining.