Class IFSerializer
java.lang.Object
org.apache.fop.render.intermediate.AbstractIFDocumentHandler
org.apache.fop.render.intermediate.AbstractXMLWritingIFDocumentHandler
org.apache.fop.render.intermediate.IFSerializer
- All Implemented Interfaces:
IFConstants,IFDocumentHandler,IFDocumentNavigationHandler,IFPainter,XMLConstants
public class IFSerializer
extends AbstractXMLWritingIFDocumentHandler
implements IFConstants, IFPainter, IFDocumentNavigationHandler
IFPainter implementation that serializes the intermediate format to XML.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringIntermediate Format (IF) version, used to express an @version attribute in the root element of the IF document, the initial value of which is set to '2.0' to signify that something preceded it (but didn't happen to be marked as such), and that this version is not necessarily backwards compatible with the unmarked (<2.0) version.Fields inherited from class org.apache.fop.render.intermediate.AbstractXMLWritingIFDocumentHandler
handler, tFactoryFields inherited from interface org.apache.fop.render.intermediate.IFConstants
EL_BORDER_RECT, EL_CLIP_RECT, EL_DOCUMENT, EL_FONT, EL_GROUP, EL_HEADER, EL_ID, EL_IMAGE, EL_LINE, EL_LOCALE, EL_PAGE, EL_PAGE_CONTENT, EL_PAGE_HEADER, EL_PAGE_SEQUENCE, EL_PAGE_TRAILER, EL_RECT, EL_STRUCTURE_TREE, EL_TEXT, EL_TRAILER, EL_VIEWPORT, MIME_TYPE, NAMESPACEFields inherited from interface org.apache.fop.util.XMLConstants
CDATA, XLINK_HREF, XLINK_NAMESPACE, XLINK_PREFIX, XML_NAMESPACE, XML_PREFIX, XML_SPACE, XMLNS_NAMESPACE_URI, XMLNS_PREFIX -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidaddResolvedAction(AbstractAction action) voidclipBackground(Rectangle rect, BorderProps bpsBefore, BorderProps bpsAfter, BorderProps bpsStart, BorderProps bpsEnd) Restricts the current clipping region to the inner border.voidRestricts the current clipping region with the given rectangle.protected RenderingContextvoiddrawBorderRect(Rectangle rect, BorderProps top, BorderProps bottom, BorderProps left, BorderProps right, Color innerBackgroundColor) Draws a border rectangle.voidDraws an image identified by a URI inside a given rectangle.voidDraws an image (represented by a DOM document) inside a given rectangle.voidDraws a line.voidDraws text.voiddrawText(int x, int y, int letterSpacing, int wordSpacing, int[][] dp, String text, boolean nextIsSpace) voidIndicates the end of a document.voidIndicates the end of the document header.voidIndicates the end of the document trailer.voidendGroup()Ends the current group and restores the previous coordinate system (and layer).voidendPage()Indicates the end of a pagevoidIndicates the end of the page content.voidIndicates the end of the page header.voidIndicates the end of a page sequence.voidIndicates the end of the page trailer.voidEnds the current viewport and restores the previous coordinate system.voidFills a rectangular area.Returns the configurator for this document handler, if any.Returns a document navigation handler if this feature is supported.Returns the font set to work with.protected StringReturns the main namespace used for generated XML content.Returns the MIME type of the output format that is generated by this implementation.Returns the document handler that is being mimicked by this serializer.intvoidhandleExtensionObject(Object extension) Handles an extension object.booleanisBackgroundRequired(BorderProps bpsTop, BorderProps bpsBottom, BorderProps bpsLeft, BorderProps bpsRight) TODO Painter-specific rounded borders logic required background drawing to be made optional.voidmimicDocumentHandler(IFDocumentHandler targetHandler) Tells this serializer to mimic the given document handler (mostly applies to the font set that is used during layout).voidRender the bookmark tree.voidrenderLink(Link link) voidrenderNamedDestination(NamedDestination destination) Renders a named destination.voidsetDefaultFontInfo(FontInfo fontInfo) Sets the default font set (with no custom configuration).voidsetDocumentLocale(Locale locale) voidUpdates the current font.voidsetFontInfo(FontInfo fontInfo) Sets the font set to work with.voidIndicates the start of a document.voidIndicates the start of the document header.voidIndicates the start of the document trailer.voidstartGroup(AffineTransform[] transforms, String layer) Starts a new group of graphical elements.voidstartGroup(AffineTransform transform, String layer) Starts a new group of graphical elements.voidIndicates the start of a new page.Indicates the start of the page content.voidIndicates the start of the page header.voidIndicates the start of a new page sequence.voidIndicates the start of the page trailer.voidstartViewport(AffineTransform[] transforms, Dimension size, Rectangle clipRect) Starts a new viewport, establishing a new coordinate system.voidstartViewport(AffineTransform transform, Dimension size, Rectangle clipRect) Starts a new viewport, establishing a new coordinate system.booleanIndicates whether the painter supports to handle the pages in mixed order rather than ascending order.Methods inherited from class org.apache.fop.render.intermediate.AbstractXMLWritingIFDocumentHandler
createContentHandler, setResultMethods inherited from class org.apache.fop.render.intermediate.AbstractIFDocumentHandler
getContext, getUserAgent
-
Field Details
-
VERSION
Intermediate Format (IF) version, used to express an @version attribute in the root element of the IF document, the initial value of which is set to '2.0' to signify that something preceded it (but didn't happen to be marked as such), and that this version is not necessarily backwards compatible with the unmarked (<2.0) version.- See Also:
-
-
Constructor Details
-
IFSerializer
-
-
Method Details
-
getMainNamespace
Returns the main namespace used for generated XML content.- Specified by:
getMainNamespacein classAbstractXMLWritingIFDocumentHandler- Returns:
- the main namespace
-
supportsPagesOutOfOrder
public boolean supportsPagesOutOfOrder()Indicates whether the painter supports to handle the pages in mixed order rather than ascending order.- Specified by:
supportsPagesOutOfOrderin interfaceIFDocumentHandler- Returns:
- true if out-of-order handling is supported
-
getMimeType
Returns the MIME type of the output format that is generated by this implementation.- Specified by:
getMimeTypein interfaceIFDocumentHandler- Returns:
- the MIME type
-
getConfigurator
Returns the configurator for this document handler, if any.- Specified by:
getConfiguratorin interfaceIFDocumentHandler- Returns:
- the configurator or null if there's no configurator
-
mimicDocumentHandler
Tells this serializer to mimic the given document handler (mostly applies to the font set that is used during layout).- Parameters:
targetHandler- the document handler to mimic
-
getMimickedDocumentHandler
Returns the document handler that is being mimicked by this serializer.- Returns:
- the mimicked document handler or null if no such document handler has been set
-
getFontInfo
Returns the font set to work with.- Specified by:
getFontInfoin interfaceIFDocumentHandler- Returns:
- the font info object
-
setFontInfo
Sets the font set to work with.- Specified by:
setFontInfoin interfaceIFDocumentHandler- Parameters:
fontInfo- the font info object
-
setDefaultFontInfo
Sets the default font set (with no custom configuration).- Specified by:
setDefaultFontInfoin interfaceIFDocumentHandler- Parameters:
fontInfo- the font info object to populate
-
getStructureTreeEventHandler
Description copied from class:AbstractIFDocumentHandler- Specified by:
getStructureTreeEventHandlerin interfaceIFDocumentHandler- Overrides:
getStructureTreeEventHandlerin classAbstractIFDocumentHandler- Returns:
- the structure tree builder
-
startDocument
Indicates the start of a document. This method may only be called once before any other event method.- Specified by:
startDocumentin interfaceIFDocumentHandler- Overrides:
startDocumentin classAbstractIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
setDocumentLocale
Description copied from class:AbstractIFDocumentHandler- Specified by:
setDocumentLocalein interfaceIFDocumentHandler- Overrides:
setDocumentLocalein classAbstractIFDocumentHandler- Parameters:
locale- Locale of the document.
-
startDocumentHeader
Indicates the start of the document header. This method is called right after theIFDocumentHandler.startDocument()method. Extensions sent to this painter betweenIFDocumentHandler.startDocumentHeader()andIFDocumentHandler.endDocumentHeader()apply to the document as a whole (like document metadata).- Specified by:
startDocumentHeaderin interfaceIFDocumentHandler- Overrides:
startDocumentHeaderin classAbstractIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
endDocumentHeader
Indicates the end of the document header. This method is called before the first page sequence.- Specified by:
endDocumentHeaderin interfaceIFDocumentHandler- Overrides:
endDocumentHeaderin classAbstractIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
startDocumentTrailer
Indicates the start of the document trailer. This method is called after the last page sequence. Extensions sent to the painter betweenIFDocumentHandler.startDocumentTrailer()andIFDocumentHandler.endDocumentTrailer()apply to the document as a whole and is used for document-level content that is only known after all pages have been rendered (like named destinations or the bookmark tree).- Specified by:
startDocumentTrailerin interfaceIFDocumentHandler- Overrides:
startDocumentTrailerin classAbstractIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
endDocumentTrailer
Indicates the end of the document trailer. This method is called right before theIFDocumentHandler.endDocument()method.- Specified by:
endDocumentTrailerin interfaceIFDocumentHandler- Overrides:
endDocumentTrailerin classAbstractIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
endDocument
Indicates the end of a document. This method may only be called once after the whole document has been handled. Implementations can release resources (close streams). It is an error to call any event method after this method.- Specified by:
endDocumentin interfaceIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
startPageSequence
Indicates the start of a new page sequence.- Specified by:
startPageSequencein interfaceIFDocumentHandler- Parameters:
id- the page sequence's identifier (or null if none is available)- Throws:
IFException- if an error occurs while handling this event
-
endPageSequence
Indicates the end of a page sequence.- Specified by:
endPageSequencein interfaceIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
startPage
public void startPage(int index, String name, String pageMasterName, Dimension size) throws IFException Indicates the start of a new page.- Specified by:
startPagein interfaceIFDocumentHandler- Parameters:
index- the index of the page (0-based)name- the page name (usually the formatted page number)pageMasterName- the name of the simple-page-master that generated this pagesize- the size of the page (equivalent to the MediaBox in PDF)- Throws:
IFException- if an error occurs while handling this event
-
startPageHeader
Indicates the start of the page header.- Specified by:
startPageHeaderin interfaceIFDocumentHandler- Overrides:
startPageHeaderin classAbstractIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
endPageHeader
Indicates the end of the page header.- Specified by:
endPageHeaderin interfaceIFDocumentHandler- Overrides:
endPageHeaderin classAbstractIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
startPageContent
Indicates the start of the page content. The method returns anIFPainterinterface which is used to paint the page contents.- Specified by:
startPageContentin interfaceIFDocumentHandler- Returns:
- the IFPainter for the page content
- Throws:
IFException- if an error occurs while handling this event
-
endPageContent
Indicates the end of the page content. Calls to theIFPainterreturned by the respectiveIFDocumentHandler.startPageContent()method are illegal.- Specified by:
endPageContentin interfaceIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
startPageTrailer
Indicates the start of the page trailer. The page trailer is used for writing down page elements which are only know after handling the page itself (like PDF targets).- Specified by:
startPageTrailerin interfaceIFDocumentHandler- Overrides:
startPageTrailerin classAbstractIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
endPageTrailer
Indicates the end of the page trailer.- Specified by:
endPageTrailerin interfaceIFDocumentHandler- Overrides:
endPageTrailerin classAbstractIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
endPage
Indicates the end of a page- Specified by:
endPagein interfaceIFDocumentHandler- Throws:
IFException- if an error occurs while handling this event
-
startViewport
public void startViewport(AffineTransform transform, Dimension size, Rectangle clipRect) throws IFException Starts a new viewport, establishing a new coordinate system. A viewport has a size and can optionally be clipped. Corresponds to SVG's svg element.- Specified by:
startViewportin interfaceIFPainter- Parameters:
transform- the transformation matrix establishing the new coordinate systemsize- the size of the viewportclipRect- the clipping rectangle (may be null)- Throws:
IFException- if an error occurs while handling this element
-
startViewport
public void startViewport(AffineTransform[] transforms, Dimension size, Rectangle clipRect) throws IFException Starts a new viewport, establishing a new coordinate system. A viewport has a size and can optionally be clipped. Corresponds to SVG's svg element.- Specified by:
startViewportin interfaceIFPainter- Parameters:
transforms- a series of transformation matrices establishing the new coordinate systemsize- the size of the viewportclipRect- the clipping rectangle (may be null)- Throws:
IFException- if an error occurs while handling this element
-
endViewport
Ends the current viewport and restores the previous coordinate system.- Specified by:
endViewportin interfaceIFPainter- Throws:
IFException- if an error occurs while handling this element
-
startGroup
Starts a new group of graphical elements. Corresponds to SVG's g element.- Specified by:
startGroupin interfaceIFPainter- Parameters:
transforms- a series of transformation matrices establishing the new coordinate systemlayer- an optional layer label (or null if none)- Throws:
IFException- if an error occurs while handling this element
-
startGroup
Starts a new group of graphical elements. Corresponds to SVG's g element.- Specified by:
startGroupin interfaceIFPainter- Parameters:
transform- the transformation matrix establishing the new coordinate systemlayer- an optional layer label (or null if none)- Throws:
IFException- if an error occurs while handling this element
-
endGroup
Ends the current group and restores the previous coordinate system (and layer).- Specified by:
endGroupin interfaceIFPainter- Throws:
IFException- if an error occurs while handling this element
-
drawImage
Draws an image identified by a URI inside a given rectangle. This is the equivalent to an fo:external-graphic in XSL-FO.- Specified by:
drawImagein interfaceIFPainter- Parameters:
uri- the image's URIrect- the rectangle in which the image shall be painted- Throws:
IFException- if an error occurs while handling this event
-
drawImage
Draws an image (represented by a DOM document) inside a given rectangle. This is the equivalent to an fo:instream-foreign-object in XSL-FO.- Specified by:
drawImagein interfaceIFPainter- Parameters:
doc- the DOM document containing the foreign objectrect- the rectangle in which the image shall be painted- Throws:
IFException- if an error occurs while handling this event
-
clipRect
Restricts the current clipping region with the given rectangle.- Specified by:
clipRectin interfaceIFPainter- Parameters:
rect- the rectangle's coordinates and extent- Throws:
IFException- if an error occurs while handling this event
-
clipBackground
public void clipBackground(Rectangle rect, BorderProps bpsBefore, BorderProps bpsAfter, BorderProps bpsStart, BorderProps bpsEnd) throws IFException Restricts the current clipping region to the inner border.- Specified by:
clipBackgroundin interfaceIFPainter- Parameters:
rect- the rectangle's coordinates and extentbpsBefore- the border segment on the before-side (top)bpsAfter- the border segment on the after-side (bottom)bpsStart- the border segment on the start-side (left)bpsEnd- the border segment on the end-side (right)- Throws:
IFException- if an error occurs while handling this event
-
fillRect
Fills a rectangular area.- Specified by:
fillRectin interfaceIFPainter- Parameters:
rect- the rectangle's coordinates and extentfill- the fill paint- Throws:
IFException- if an error occurs while handling this event
-
drawBorderRect
public void drawBorderRect(Rectangle rect, BorderProps top, BorderProps bottom, BorderProps left, BorderProps right, Color innerBackgroundColor) throws IFException Draws a border rectangle. The border segments are specified throughBorderPropsinstances.- Specified by:
drawBorderRectin interfaceIFPainter- Parameters:
rect- the rectangle's coordinates and extenttop- the border segment on the top edgebottom- the border segment on the bottom edgeleft- the border segment on the left edgeright- the border segment on the right edgeinnerBackgroundColor- the color of the inner background- Throws:
IFException- if an error occurs while handling this event
-
drawLine
public void drawLine(Point start, Point end, int width, Color color, RuleStyle style) throws IFException Draws a line. NOTE: Currently, only horizontal lines are implemented!- Specified by:
drawLinein interfaceIFPainter- Parameters:
start- the start point of the lineend- the end point of the linewidth- the line widthcolor- the line colorstyle- the line style (using the Constants.EN_* constants for the rule-style property)- Throws:
IFException- if an error occurs while handling this event
-
drawText
public void drawText(int x, int y, int letterSpacing, int wordSpacing, int[][] dp, String text) throws IFException Draws text. The initial coordinates (x and y) point to the starting point at the normal baseline of the font. The parameters letterSpacing, wordSpacing and the array dx are optional and can be used to influence character positioning (for example, for kerning).- Specified by:
drawTextin interfaceIFPainter- Parameters:
x- X-coordinate of the starting point of the texty- Y-coordinate of the starting point of the textletterSpacing- additional spacing between characters (may be 0)wordSpacing- additional spacing between words (may be 0)dp- an array of 4-tuples, expressing [X,Y] placment adjustments and [X,Y] advancement adjustments, in that order (may be null); if not null, then adjustments.length must be the same as text.length()text- the text- Throws:
IFException- if an error occurs while handling this event
-
drawText
public void drawText(int x, int y, int letterSpacing, int wordSpacing, int[][] dp, String text, boolean nextIsSpace) throws IFException - Specified by:
drawTextin interfaceIFPainter- Throws:
IFException
-
setFont
public void setFont(String family, String style, Integer weight, String variant, Integer size, Color color) throws IFException Updates the current font.- Specified by:
setFontin interfaceIFPainter- Parameters:
family- the font family (or null if there's no change)style- the font style (or null if there's no change)weight- the font weight (or null if there's no change)variant- the font variant (or null if there's no change)size- the font size (or null if there's no change)color- the text color (or null if there's no change)- Throws:
IFException- if an error occurs while handling this event
-
handleExtensionObject
Handles an extension object. This can be a DOM document or any arbitrary object. If an implementation doesn't know how to handle a particular extension it is simply ignored.- Specified by:
handleExtensionObjectin interfaceIFDocumentHandler- Parameters:
extension- the extension object- Throws:
IFException- if an error occurs while handling this event
-
createRenderingContext
- Returns:
- a new rendering context
- Throws:
IllegalStateException- unless overridden
-
renderNamedDestination
Renders a named destination.- Specified by:
renderNamedDestinationin interfaceIFDocumentNavigationHandler- Parameters:
destination- the named destination- Throws:
IFException- if an error occurs while handling this event
-
renderBookmarkTree
Render the bookmark tree.- Specified by:
renderBookmarkTreein interfaceIFDocumentNavigationHandler- Parameters:
tree- the bookmark tree- Throws:
IFException- if an error occurs while handling this event
-
renderLink
- Specified by:
renderLinkin interfaceIFDocumentNavigationHandler- Parameters:
link- a link- Throws:
IFException- of not caught
-
addResolvedAction
- Specified by:
addResolvedActionin interfaceIFDocumentNavigationHandler- Parameters:
action- an action- Throws:
IFException- of not caught
-
getPageIndex
public int getPageIndex()- Specified by:
getPageIndexin interfaceIFDocumentNavigationHandler
-
isBackgroundRequired
public boolean isBackgroundRequired(BorderProps bpsTop, BorderProps bpsBottom, BorderProps bpsLeft, BorderProps bpsRight) TODO Painter-specific rounded borders logic required background drawing to be made optional. A future refactoring of the rounded borders code should aim to make the need for this abstraction obsolete- Specified by:
isBackgroundRequiredin interfaceIFPainter- Parameters:
bpsTop- the before borderbpsBottom- the after borderbpsLeft- the start borderbpsRight- the end border- Returns:
- true if and only if background drawing is required
-