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.FOPTranscoderUserAgentNested classes/interfaces inherited from class org.apache.batik.transcoder.SVGAbstractTranscoder
org.apache.batik.transcoder.SVGAbstractTranscoder.SVGAbstractTranscoderUserAgent -
Field Summary
FieldsModifier and TypeFieldDescriptionprotected PDFDocumentGraphics2DGraphics2D 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_ONFields 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, widthFields 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_VALIDATINGFields inherited from class org.apache.batik.transcoder.TranscoderSupport
handler, hints -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected org.apache.batik.bridge.BridgeContextorg.apache.batik.bridge.BridgeContextcreateBridgeContext(String version) Creates and returns the default user agent for this transcoder.protected voidTranscodes 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, setupImageInfrastructureMethods inherited from class org.apache.batik.transcoder.SVGAbstractTranscoder
createBridgeContext, getCanvasGraphicsNode, setImageSize, transcodeMethods inherited from class org.apache.batik.transcoder.TranscoderSupport
addTranscodingHint, getErrorHandler, getTranscodingHints, removeTranscodingHint, setErrorHandler, setTranscodingHints, setTranscodingHintsMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods 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:
createUserAgentin 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:
transcodein 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:
createBridgeContextin classorg.apache.batik.transcoder.SVGAbstractTranscoder
-
createBridgeContext
- Overrides:
createBridgeContextin classorg.apache.batik.transcoder.SVGAbstractTranscoder
-