Class PDFTranscoder
- All Implemented Interfaces:
org.apache.batik.transcoder.Transcoder
,Configurable
This class enables to transcode an input to a PDF document.
Two transcoding hints (KEY_WIDTH
and
KEY_HEIGHT
) can be used to respectively specify the image
width and the image height. If only one of these keys is specified,
the transcoder preserves the aspect ratio of the original image.
The KEY_BACKGROUND_COLOR
defines the background color
to use for opaque image formats, or the background color that may
be used for image formats that support alpha channel.
The KEY_AOI
represents the area of interest to paint
in device space.
Three additional transcoding hints that act on the SVG processor can be specified:
KEY_LANGUAGE
to set the default language to use (may be
used by a <switch> SVG element for example),
KEY_USER_STYLESHEET_URI
to fix the URI of a user
stylesheet, and KEY_PIXEL_TO_MM
to specify the pixel to
millimeter conversion factor.
KEY_AUTO_FONTS
to disable the auto-detection of fonts installed in the system.
The PDF Transcoder cannot use AWT's font subsystem and that's why the fonts have to be
configured differently. By default, font auto-detection is enabled to match the behaviour
of the other transcoders, but this may be associated with a price in the form of a small
performance penalty. If font auto-detection is not desired, it can be disable using this key.
This work was authored by Keiron Liddle (keiron@aftexsw.com).
-
Nested Class Summary
Nested classes/interfaces inherited from class org.apache.fop.svg.AbstractFOPTranscoder
AbstractFOPTranscoder.FOPErrorHandler, AbstractFOPTranscoder.FOPTranscoderUserAgent
Nested classes/interfaces inherited from class org.apache.batik.transcoder.SVGAbstractTranscoder
org.apache.batik.transcoder.SVGAbstractTranscoder.SVGAbstractTranscoderUserAgent
-
Field Summary
Modifier and TypeFieldDescriptionprotected PDFDocumentGraphics2D
Graphics2D instance that is used to paint toFields inherited from class org.apache.fop.svg.AbstractFOPTranscoder
KEY_AUTO_FONTS, KEY_DEVICE_RESOLUTION, KEY_STROKE_TEXT, VALUE_FORMAT_OFF, VALUE_FORMAT_ON
Fields inherited from class org.apache.batik.transcoder.SVGAbstractTranscoder
builder, ctx, curAOI, curTxf, DEFAULT_ALLOWED_SCRIPT_TYPES, DEFAULT_DEFAULT_FONT_FAMILY, height, KEY_ALLOW_EXTERNAL_RESOURCES, KEY_ALLOWED_SCRIPT_TYPES, KEY_ALTERNATE_STYLESHEET, KEY_AOI, KEY_CONSTRAIN_SCRIPT_ORIGIN, KEY_DEFAULT_FONT_FAMILY, KEY_EXECUTE_ONLOAD, KEY_HEIGHT, KEY_LANGUAGE, KEY_MAX_HEIGHT, KEY_MAX_WIDTH, KEY_MEDIA, KEY_PIXEL_TO_MM, KEY_PIXEL_UNIT_TO_MILLIMETER, KEY_SNAPSHOT_TIME, KEY_USER_STYLESHEET_URI, KEY_WIDTH, root, userAgent, width
Fields inherited from class org.apache.batik.transcoder.XMLAbstractTranscoder
KEY_DOCUMENT_ELEMENT, KEY_DOCUMENT_ELEMENT_NAMESPACE_URI, KEY_DOM_IMPLEMENTATION, KEY_XML_PARSER_CLASSNAME, KEY_XML_PARSER_VALIDATING
Fields inherited from class org.apache.batik.transcoder.TranscoderSupport
handler, hints
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected org.apache.batik.bridge.BridgeContext
org.apache.batik.bridge.BridgeContext
createBridgeContext
(String version) Creates and returns the default user agent for this transcoder.protected void
Transcodes the specified Document as an image in the specified output.Methods inherited from class org.apache.fop.svg.AbstractFOPTranscoder
configure, createDocumentFactory, getAutoFontsDefault, getDeviceResolution, getEffectiveConfiguration, getImageManager, getImageSessionContext, getLogger, isTextStroked, setEntityResolver, setLogger, setupImageInfrastructure
Methods inherited from class org.apache.batik.transcoder.SVGAbstractTranscoder
createBridgeContext, getCanvasGraphicsNode, setImageSize, transcode
Methods inherited from class org.apache.batik.transcoder.TranscoderSupport
addTranscodingHint, getErrorHandler, getTranscodingHints, removeTranscodingHint, setErrorHandler, setTranscodingHints, setTranscodingHints
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.apache.batik.transcoder.Transcoder
addTranscodingHint, getErrorHandler, getTranscodingHints, removeTranscodingHint, setErrorHandler, setTranscodingHints, setTranscodingHints
-
Field Details
-
graphics
Graphics2D instance that is used to paint to
-
-
Constructor Details
-
PDFTranscoder
public PDFTranscoder()Constructs a newPDFTranscoder
.
-
-
Method Details
-
createUserAgent
Creates and returns the default user agent for this transcoder. Override this method if you need non-default behaviour.- Overrides:
createUserAgent
in classAbstractFOPTranscoder
- Returns:
- UserAgent the newly created user agent
-
transcode
protected void transcode(Document document, String uri, org.apache.batik.transcoder.TranscoderOutput output) throws org.apache.batik.transcoder.TranscoderException Transcodes the specified Document as an image in the specified output.- Overrides:
transcode
in classorg.apache.batik.transcoder.SVGAbstractTranscoder
- Parameters:
document
- the document to transcodeuri
- the uri of the document or null if anyoutput
- the ouput where to transcode- Throws:
org.apache.batik.transcoder.TranscoderException
- if an error occured while transcoding
-
createBridgeContext
protected org.apache.batik.bridge.BridgeContext createBridgeContext()- Overrides:
createBridgeContext
in classorg.apache.batik.transcoder.SVGAbstractTranscoder
-
createBridgeContext
- Overrides:
createBridgeContext
in classorg.apache.batik.transcoder.SVGAbstractTranscoder
-