Class PDFGraphics2D
- All Implemented Interfaces:
Cloneable
,NativeImageHandler
- Direct Known Subclasses:
PDFDocumentGraphics2D
PDF Graphics 2D. Used for drawing into a pdf document as if it is a graphics object. This takes a pdf document and draws into it.
This work was authored by Keiron Liddle (keiron@aftexsw.com).
- See Also:
-
AbstractGraphics2D
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic interface
May be used to give proper feedback to the user when a particular PDF profile is being used that disallows transparency. -
Field Summary
Modifier and TypeFieldDescriptionprotected int
The PDF graphics state level that this svg is being drawn into.protected PDFColorHandler
the PDF color handlerprotected String
the current (internal) font nameprotected float
the current font size in millipointsprotected StringWriter
the current stream to add PDF commands toprotected FontInfo
The current font information.protected int
The count of natively handled images added to document so they receive unique keys.protected OutputStream
The output stream for the pdf document.protected Font
The override font state used when drawing text and the font cannot be set using java fonts.protected PDFReference
The PDF reference of the current page.protected PDFPaintingState
The PDF painting stateprotected PDFDocument
the PDF Document being createdprotected PDFResourceContext
The current resource context for adding fonts, patterns etc.Fields inherited from class org.apache.xmlgraphics.java2d.AbstractGraphics2D
gc, inPossibleRecursion, textAsShapes
-
Constructor Summary
ModifierConstructorDescriptionprotected
PDFGraphics2D
(boolean textAsShapes) Create a new PDFGraphics2D.PDFGraphics2D
(boolean textAsShapes, FontInfo fi, PDFDocument doc, PDFResourceContext page, PDFReference pref, String font, float size, PDFGraphics2D.TransparencyIgnoredEventListener listener) Create a new PDFGraphics2D with the given pdf document info.This constructor supports the create method. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addLink
(Rectangle2D bounds, AffineTransform trans, String dest, int linkType) This is a pdf specific method used to add a link to the pdf document.void
addNativeImage
(org.apache.xmlgraphics.image.loader.Image image, float x, float y, float width, float height) Add a natively handled image directly to the PDF document.protected void
applyAlpha
(int fillAlpha, int strokeAlpha) Applies the given alpha values for filling and stroking.protected void
applyColor
(Color col, boolean fill) Apply the java Color to PDF.protected boolean
applyPaint
(Paint paint, boolean fill) Apply the java paint to the PDF.protected void
applyStroke
(Stroke stroke) Apply the stroke to the PDF.protected boolean
applyUnknownPaint
(Paint paint, Shape shape) void
copyArea
(int x, int y, int width, int height, int dx, int dy) Copies an area of the component by a distance specified bydx
anddy
.create()
Creates a newGraphics
object that is a copy of thisGraphics
object.void
dispose()
Disposes of this graphics context and releases any system resources that it is using.protected void
doDrawing
(boolean fill, boolean stroke, boolean nonzero) Do the PDF drawing command.void
Strokes the outline of aShape
using the settings of the currentGraphics2D
context.boolean
drawImage
(Image img, int x, int y, int width, int height, ImageObserver observer) boolean
drawImage
(Image img, int x, int y, ImageObserver observer) Draws as much of the specified image as is currently available.void
drawInnerRenderedImage
(String key, RenderedImage img, AffineTransform xform) void
drawRenderableImage
(RenderableImage img, AffineTransform xform) void
drawRenderedImage
(RenderedImage img, AffineTransform xform) void
drawString
(String s, float x, float y) Renders the text specified by the specifiedString
, using the currentFont
andPaint
attributes in theGraphics2D
context.void
Fills the interior of aShape
using the settings of theGraphics2D
context.protected AffineTransform
This is mainly used for shading patterns which use the document-global coordinate system instead of the local one.Get the string buffer from the currentStream, containing all the commands written into this Graphics so far.Returns the device configuration associated with thisGraphics2D
.Gets the font metrics for the specified font.protected Font
getInternalFontForAWTFont
(Font awtFont) Deprecated.use FontInfo.getFontInstanceForAWTFont(java.awt.Font awtFont) insteadGets the PDF reference of the current page.Get the string containing all the commands written into this Graphics.protected void
Central handler for IOExceptions for this class.protected boolean
isMultiByteFont
(String name) Determines whether the font with the given name is a multi-byte font.protected Object
Checks whether the use of transparency is allowed.protected void
This method is used by PDFDocumentGraphics2D to prepare a new page if necessary.void
Processes a path iterator generating the necessary painting operations.registerFunction
(PDFFunction function) Registers a function object against the output format documentregisterPattern
(PDFPattern pattern) Registers a pattern object against the output format documentregisterShading
(PDFShading shading) Registers a shading object against the otuput format documentvoid
setGraphicContext
(org.apache.xmlgraphics.java2d.GraphicContext c) Set the Graphics context.void
Set the output stream that this PDF document is being drawn to.void
setOverrideFontState
(Font infont) Set the override font state for drawing text.void
setPaintingState
(PDFPaintingState state) Set the PDF state to use when starting to draw into the PDF graphics.void
setXORMode
(Color c1) Sets the paint mode of this graphics context to alternate between this graphics context's current color and the new specified color.protected void
updateCurrentFont
(Font font) Updates the currently selected font.protected void
Set the clipping shape for future PDF drawing in the current graphics state.Methods inherited from class org.apache.xmlgraphics.java2d.AbstractGraphics2D
addRenderingHints, clearRect, clip, clipRect, drawArc, drawGlyphVector, drawImage, drawImage, drawImage, drawImage, drawImage, drawImage, drawLine, drawOval, drawPolygon, drawPolyline, drawRect, drawRoundRect, drawString, drawString, drawString, fillArc, fillOval, fillPolygon, fillRect, fillRoundRect, getBackground, getClip, getClipBounds, getColor, getComposite, getFont, getFontRenderContext, getGraphicContext, getPaint, getRenderingHint, getRenderingHints, getStroke, getTransform, hit, rotate, rotate, scale, setBackground, setClip, setClip, setColor, setComposite, setFont, setPaint, setPaintMode, setRenderingHint, setRenderingHints, setStroke, setTransform, shear, transform, translate, translate
Methods inherited from class java.awt.Graphics2D
draw3DRect, fill3DRect
Methods inherited from class java.awt.Graphics
create, drawBytes, drawChars, drawPolygon, fillPolygon, finalize, getClipBounds, getClipRect, getFontMetrics, hitClip, toString
-
Field Details
-
pdfDoc
the PDF Document being created -
resourceContext
The current resource context for adding fonts, patterns etc. -
pageRef
The PDF reference of the current page. -
paintingState
The PDF painting state -
colorHandler
the PDF color handler -
baseLevel
protected int baseLevelThe PDF graphics state level that this svg is being drawn into. -
nativeCount
protected int nativeCountThe count of natively handled images added to document so they receive unique keys. -
fontInfo
The current font information. -
ovFontState
The override font state used when drawing text and the font cannot be set using java fonts. -
currentStream
the current stream to add PDF commands to -
currentFontName
the current (internal) font name -
currentFontSize
protected float currentFontSizethe current font size in millipoints -
outputStream
The output stream for the pdf document. If this is set then it can progressively output the pdf document objects to reduce memory. Especially with images.
-
-
Constructor Details
-
PDFGraphics2D
public PDFGraphics2D(boolean textAsShapes, FontInfo fi, PDFDocument doc, PDFResourceContext page, PDFReference pref, String font, float size, PDFGraphics2D.TransparencyIgnoredEventListener listener) Create a new PDFGraphics2D with the given pdf document info. This is used to create a Graphics object for use inside an already existing document.- Parameters:
textAsShapes
- if true then draw text as shapesfi
- the current font informationdoc
- the pdf document for creating pdf objectspage
- the current resource context or pagepref
- the PDF reference of the current pagefont
- the current font namesize
- the current font size
-
PDFGraphics2D
protected PDFGraphics2D(boolean textAsShapes) Create a new PDFGraphics2D.- Parameters:
textAsShapes
- true if drawing text as shapes
-
PDFGraphics2D
This constructor supports the create method. This is not implemented properly.- Parameters:
g
- the PDF graphics to make a copy of
-
-
Method Details
-
create
Creates a newGraphics
object that is a copy of thisGraphics
object. -
handleIOException
Central handler for IOExceptions for this class.- Parameters:
ioe
- IOException to handle
-
preparePainting
protected void preparePainting()This method is used by PDFDocumentGraphics2D to prepare a new page if necessary. -
setPaintingState
Set the PDF state to use when starting to draw into the PDF graphics.- Parameters:
state
- the PDF state
-
setOutputStream
Set the output stream that this PDF document is being drawn to. This is so that it can progressively use the PDF document to output data such as images. This results in a significant saving on memory.- Parameters:
os
- the output stream that is being used for the PDF document
-
getString
Get the string containing all the commands written into this Graphics.- Returns:
- the string containing the PDF markup
-
getBuffer
Get the string buffer from the currentStream, containing all the commands written into this Graphics so far.- Returns:
- the StringBuffer containing the PDF markup
-
getPageReference
Gets the PDF reference of the current page.- Returns:
- the PDF reference of the current page
-
setGraphicContext
public void setGraphicContext(org.apache.xmlgraphics.java2d.GraphicContext c) Set the Graphics context.- Parameters:
c
- the graphics context to use
-
setOverrideFontState
Set the override font state for drawing text. This is used by the PDF text painter so that it can temporarily set the font state when a java font cannot be used. The next drawString will use this font state.- Parameters:
infont
- the font state to use
-
getBaseTransform
This is mainly used for shading patterns which use the document-global coordinate system instead of the local one.- Returns:
- the transformation matrix that established the basic user space for this document
-
addLink
This is a pdf specific method used to add a link to the pdf document.- Parameters:
bounds
- the bounds of the link in user coordinatestrans
- the transform of the current drawing positiondest
- the PDF destinationlinkType
- the type of link, internal or external
-
addNativeImage
public void addNativeImage(org.apache.xmlgraphics.image.loader.Image image, float x, float y, float width, float height) Add a natively handled image directly to the PDF document. This is used by the PDFImageElementBridge to draw a natively handled image (like JPEG or CCITT images) directly into the PDF document rather than converting the image into a bitmap and increasing the size.- Specified by:
addNativeImage
in interfaceNativeImageHandler
- Parameters:
image
- the image to drawx
- the x positiony
- the y positionwidth
- the width to draw the imageheight
- the height to draw the image
-
drawImage
Draws as much of the specified image as is currently available. The image is drawn with its top-left corner at (x, y) in this graphics context's coordinate space. Transparent pixels in the image do not affect whatever pixels are already there.This method returns immediately in all cases, even if the complete image has not yet been loaded, and it has not been dithered and converted for the current output device.
If the image has not yet been completely loaded, then
drawImage
returnsfalse
. As more of the image becomes available, the process that draws the image notifies the specified image observer. -
drawImage
-
dispose
public void dispose()Disposes of this graphics context and releases any system resources that it is using. AGraphics
object cannot be used afterdispose
has been called.When a Java program runs, a large number of
Graphics
objects can be created within a short time frame. Although the finalization process of the garbage collector also disposes of the same system resources, it is preferable to manually free the associated resources by calling this method rather than to rely on a finalization process which may not run to completion for a long period of time.Graphics objects which are provided as arguments to the
paint
andupdate
methods of components are automatically released by the system when those methods return. For efficiency, programmers should calldispose
when finished using aGraphics
object only if it was created directly from a component or anotherGraphics
object. -
draw
Strokes the outline of aShape
using the settings of the currentGraphics2D
context. The rendering attributes applied include theClip
,Transform
,Paint
,Composite
andStroke
attributes.- Specified by:
draw
in classGraphics2D
- Parameters:
s
- theShape
to be rendered- See Also:
-
AbstractGraphics2D.setStroke(java.awt.Stroke)
AbstractGraphics2D.setPaint(java.awt.Paint)
Graphics.setColor(java.awt.Color)
AbstractGraphics2D.transform(java.awt.geom.AffineTransform)
AbstractGraphics2D.setTransform(java.awt.geom.AffineTransform)
AbstractGraphics2D.clip(java.awt.Shape)
AbstractGraphics2D.setClip(int, int, int, int)
AbstractGraphics2D.setComposite(java.awt.Composite)
-
writeClip
Set the clipping shape for future PDF drawing in the current graphics state. This sets creates and writes a clipping shape that will apply to future drawings in the current graphics state.- Parameters:
s
- the clipping shape
-
applyColor
Apply the java Color to PDF. This converts the java colour to a PDF colour and sets it for the next drawing.- Parameters:
col
- the java colourfill
- true if the colour will be used for filling
-
applyPaint
Apply the java paint to the PDF. This takes the java paint sets up the appropraite PDF commands for the drawing with that paint. Currently this supports the gradients and patterns from batik.- Parameters:
paint
- the paint to convert to PDFfill
- true if the paint should be set for filling- Returns:
- true if the paint is handled natively, false if the paint should be rasterized
-
applyUnknownPaint
- Parameters:
paint
- some paintshape
- a shape- Returns:
- true (always)
-
applyStroke
Apply the stroke to the PDF. This takes the java stroke and outputs the appropriate settings to the PDF so that the stroke attributes are handled.- Parameters:
stroke
- the java stroke
-
drawRenderedImage
- Specified by:
drawRenderedImage
in classGraphics2D
-
drawInnerRenderedImage
- Parameters:
key
- a keyimg
- an imagexform
- a transform
-
drawRenderableImage
- Specified by:
drawRenderableImage
in classGraphics2D
-
drawString
Renders the text specified by the specifiedString
, using the currentFont
andPaint
attributes in theGraphics2D
context. The baseline of the first character is at position (x, y) in the User Space. The rendering attributes applied include theClip
,Transform
,Paint
,Font
andComposite
attributes. For characters in script systems such as Hebrew and Arabic, the glyphs can be rendered from right to left, in which case the coordinate supplied is the location of the leftmost character on the baseline.- Specified by:
drawString
in classGraphics2D
- Parameters:
s
- theString
to be renderedx
- the coordinate where theString
should be renderedy
- the coordinate where theString
should be rendered- See Also:
-
AbstractGraphics2D.setPaint(java.awt.Paint)
Graphics.setColor(java.awt.Color)
Graphics.setFont(java.awt.Font)
AbstractGraphics2D.setTransform(java.awt.geom.AffineTransform)
AbstractGraphics2D.setComposite(java.awt.Composite)
AbstractGraphics2D.setClip(int, int, int, int)
-
applyAlpha
protected void applyAlpha(int fillAlpha, int strokeAlpha) Applies the given alpha values for filling and stroking.- Parameters:
fillAlpha
- A value between 0 and 255 (=OPAQUE) for fillingstrokeAlpha
- A value between 0 and 255 (=OPAQUE) for stroking
-
updateCurrentFont
Updates the currently selected font.- Parameters:
font
- the new font to use
-
getInternalFontForAWTFont
Deprecated.use FontInfo.getFontInstanceForAWTFont(java.awt.Font awtFont) insteadReturns a suitable internal font given an AWT Font instance.- Parameters:
awtFont
- the AWT font- Returns:
- the internal Font
-
isMultiByteFont
Determines whether the font with the given name is a multi-byte font.- Parameters:
name
- the name of the font- Returns:
- true if it's a multi-byte font
-
fill
Fills the interior of aShape
using the settings of theGraphics2D
context. The rendering attributes applied include theClip
,Transform
,Paint
, andComposite
.- Specified by:
fill
in classGraphics2D
- Parameters:
s
- theShape
to be filled- See Also:
-
AbstractGraphics2D.setPaint(java.awt.Paint)
Graphics.setColor(java.awt.Color)
AbstractGraphics2D.transform(java.awt.geom.AffineTransform)
AbstractGraphics2D.setTransform(java.awt.geom.AffineTransform)
AbstractGraphics2D.setComposite(java.awt.Composite)
AbstractGraphics2D.clip(java.awt.Shape)
AbstractGraphics2D.setClip(int, int, int, int)
-
isTransparencyAllowed
Checks whether the use of transparency is allowed. -
processPathIterator
Processes a path iterator generating the necessary painting operations.- Parameters:
iter
- PathIterator to process
-
doDrawing
protected void doDrawing(boolean fill, boolean stroke, boolean nonzero) Do the PDF drawing command. This does the PDF drawing command according to fill stroke and winding rule.- Parameters:
fill
- true if filling the pathstroke
- true if stroking the pathnonzero
- true if using the non-zero winding rule
-
getDeviceConfiguration
Returns the device configuration associated with thisGraphics2D
.- Specified by:
getDeviceConfiguration
in classGraphics2D
- Returns:
- the PDF graphics configuration
-
getFontMetrics
Gets the font metrics for the specified font.- Specified by:
getFontMetrics
in classGraphics
- Parameters:
f
- the specified font- Returns:
- the font metrics for the specified font.
- See Also:
-
setXORMode
Sets the paint mode of this graphics context to alternate between this graphics context's current color and the new specified color. This specifies that logical pixel operations are performed in the XOR mode, which alternates pixels between the current color and a specified XOR color.When drawing operations are performed, pixels which are the current color are changed to the specified color, and vice versa.
Pixels that are of colors other than those two colors are changed in an unpredictable but reversible manner; if the same figure is drawn twice, then all pixels are restored to their original values.
- Specified by:
setXORMode
in classGraphics
- Parameters:
c1
- the XOR alternation color
-
copyArea
public void copyArea(int x, int y, int width, int height, int dx, int dy) Copies an area of the component by a distance specified bydx
anddy
. From the point specified byx
andy
, this method copies downwards and to the right. To copy an area of the component to the left or upwards, specify a negative value fordx
ordy
. If a portion of the source rectangle lies outside the bounds of the component, or is obscured by another window or component,copyArea
will be unable to copy the associated pixels. The area that is omitted can be refreshed by calling the component'spaint
method.- Specified by:
copyArea
in classGraphics
- Parameters:
x
- the x coordinate of the source rectangle.y
- the y coordinate of the source rectangle.width
- the width of the source rectangle.height
- the height of the source rectangle.dx
- the horizontal distance to copy the pixels.dy
- the vertical distance to copy the pixels.
-
registerFunction
Registers a function object against the output format document- Parameters:
function
- The function object to register- Returns:
- Returns either the function which has already been registered or the current new registered object.
-
registerShading
Registers a shading object against the otuput format document- Parameters:
shading
- The shading object to register- Returns:
- Returs either the shading which has already been registered or the current new registered object
-
registerPattern
Registers a pattern object against the output format document- Parameters:
pattern
- The pattern object to register- Returns:
- Returns either the pattern which has already been registered or the current new registered object
-