Package com.tom_roush.pdfbox.rendering

Class PageDrawer

java.lang.Object

com.tom_roush.pdfbox.contentstream.PDFStreamEngine

com.tom_roush.pdfbox.contentstream.PDFGraphicsStreamEngine

com.tom_roush.pdfbox.rendering.PageDrawer

public class PageDrawer
extends PDFGraphicsStreamEngine

Paints a page in a PDF document to a Canvas context. May be subclassed to provide custom rendering.

If you want to do custom graphics processing rather than Canvas rendering, then you should subclass PDFGraphicsStreamEngine instead. Subclassing PageDrawer is only suitable for cases where the goal is to render onto a Canvas surface.

Constructor Summary

Constructors

Constructor	Description
PageDrawer(PageDrawerParameters parameters)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	appendRectangle(android.graphics.PointF p0, android.graphics.PointF p1, android.graphics.PointF p2, android.graphics.PointF p3)	Append a rectangle to the current path.
void	beginText()	Called when the BT operator is encountered.
void	clip(android.graphics.Path.FillType windingRule)	Modify the current clipping path by intersecting it with the current path.
void	closePath()	Closes the current path.
void	curveTo(float x1, float y1, float x2, float y2, float x3, float y3)	Draws a curve from the current point to (x3,y3) using (x1,y1) and (x2,y2) as control points.
void	drawImage(PDImage pdImage)	Draw the image.
void	drawPage(android.graphics.Paint p, android.graphics.Canvas c, PDRectangle pageSize)	Draws the page to the requested canvas.
void	endPath()	Ends the current path without filling or stroking it.
void	endText()	Called when the ET operator is encountered.
void	fillAndStrokePath(android.graphics.Path.FillType windingRule)	Fills and then strokes the path.
void	fillPath(android.graphics.Path.FillType windingRule)	Fill the path.
protected android.graphics.Canvas	getCanvas()	Returns the underlying Canvas.
android.graphics.PointF	getCurrentPoint()	Returns the current point of the current path.
protected android.graphics.Path	getLinePath()	Returns the current line path.
PDFRenderer	getRenderer()	Returns the parent renderer.
void	lineTo(float x, float y)	Draws a line from the current point to (x,y).
void	moveTo(float x, float y)	Starts a new path at (x,y).
void	shadingFill(COSName shadingName)	Fill with Shading.
void	showAnnotation(PDAnnotation annotation)	Shows the given annotation.
protected void	showFontGlyph(Matrix textRenderingMatrix, PDFont font, int code, String unicode, Vector displacement)	Called when a glyph is to be processed.This method is intended for overriding in subclasses, the default implementation does nothing.
void	showTransparencyGroup(PDFormXObject form)	Shows a transparency group from the content stream.
void	strokePath()	Stroke the path.

Methods inherited from class java.lang.Object

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

Methods inherited from class com.tom_roush.pdfbox.contentstream.PDFGraphicsStreamEngine

getPage

Methods inherited from class com.tom_roush.pdfbox.contentstream.PDFStreamEngine

addOperator, applyTextAdjustment, getAppearance, getCurrentPage, getGraphicsStackSize, getGraphicsState, getInitialMatrix, getResources, getTextLineMatrix, getTextMatrix, operatorException, processAnnotation, processChildStream, processOperator, processOperator, processPage, processSoftMask, processTilingPattern, processTilingPattern, processTransparencyGroup, processType3Stream, registerOperatorProcessor, restoreGraphicsStack, restoreGraphicsState, saveGraphicsStack, saveGraphicsState, setLineDashPattern, setTextLineMatrix, setTextMatrix, showForm, showGlyph, showText, showTextString, showTextStrings, showType3Glyph, transformedPoint, transformWidth, unsupportedOperator

Constructor Detail

PageDrawer

public PageDrawer(PageDrawerParameters parameters)
           throws IOException

Constructor.

Parameters:

parameters - Parameters for page drawing.

Throws:

IOException - If there is an error loading properties from the file.

Method Detail

getRenderer

public final PDFRenderer getRenderer()

Returns the parent renderer.

getCanvas

protected final android.graphics.Canvas getCanvas()

Returns the underlying Canvas. May be null if drawPage has not yet been called.

getLinePath

protected final android.graphics.Path getLinePath()

Returns the current line path. This is reset to empty after each fill/stroke.

drawPage

public void drawPage(android.graphics.Paint p,
                     android.graphics.Canvas c,
                     PDRectangle pageSize)
              throws IOException

Draws the page to the requested canvas.

Parameters:

p - The paint.

c - The canvas to draw onto.

pageSize - The size of the page to draw.

Throws:

IOException - If there is an IO error while drawing the page.

beginText

public void beginText()
               throws IOException

Description copied from class: PDFStreamEngine

Called when the BT operator is encountered. This method is for overriding in subclasses, the default implementation does nothing.

Overrides:

beginText in class PDFStreamEngine

Throws:

IOException - if there was an error processing the text

endText

public void endText()
             throws IOException

Description copied from class: PDFStreamEngine

Called when the ET operator is encountered. This method is for overriding in subclasses, the default implementation does nothing.

Overrides:

endText in class PDFStreamEngine

Throws:

IOException - if there was an error processing the text

showFontGlyph

protected void showFontGlyph(Matrix textRenderingMatrix,
                             PDFont font,
                             int code,
                             String unicode,
                             Vector displacement)
                      throws IOException

Description copied from class: PDFStreamEngine

Called when a glyph is to be processed.This method is intended for overriding in subclasses, the default implementation does nothing.

Overrides:

showFontGlyph in class PDFStreamEngine

Parameters:

textRenderingMatrix - the current text rendering matrix, T_rm

font - the current font

code - internal PDF character code for the glyph

unicode - the Unicode text for this glyph, or null if the PDF does provide it

displacement - the displacement (i.e. advance) of the glyph in text space

Throws:

IOException - if the glyph cannot be processed

appendRectangle

public void appendRectangle(android.graphics.PointF p0,
                            android.graphics.PointF p1,
                            android.graphics.PointF p2,
                            android.graphics.PointF p3)

Description copied from class: PDFGraphicsStreamEngine

Append a rectangle to the current path.

Specified by:

appendRectangle in class PDFGraphicsStreamEngine

strokePath

public void strokePath()
                throws IOException

Description copied from class: PDFGraphicsStreamEngine

Stroke the path.

Specified by:

strokePath in class PDFGraphicsStreamEngine

Throws:

IOException - If there is an IO error while stroking the path.

fillPath

public void fillPath(android.graphics.Path.FillType windingRule)
              throws IOException

Description copied from class: PDFGraphicsStreamEngine

Fill the path.

Specified by:

fillPath in class PDFGraphicsStreamEngine

Parameters:

windingRule - The winding rule this path will use.

Throws:

IOException

fillAndStrokePath

public void fillAndStrokePath(android.graphics.Path.FillType windingRule)
                       throws IOException

Fills and then strokes the path.

Specified by:

fillAndStrokePath in class PDFGraphicsStreamEngine

Parameters:

windingRule - The winding rule this path will use.

Throws:

IOException - If there is an IO error while filling the path.

clip

public void clip(android.graphics.Path.FillType windingRule)

Description copied from class: PDFGraphicsStreamEngine

Modify the current clipping path by intersecting it with the current path. The clipping path will not be updated until the succeeding painting operator is called.

Specified by:

clip in class PDFGraphicsStreamEngine

Parameters:

windingRule - The winding rule which will be used for clipping.

moveTo

public void moveTo(float x,
                   float y)

Description copied from class: PDFGraphicsStreamEngine

Starts a new path at (x,y).

Specified by:

moveTo in class PDFGraphicsStreamEngine

lineTo

public void lineTo(float x,
                   float y)

Description copied from class: PDFGraphicsStreamEngine

Draws a line from the current point to (x,y).

Specified by:

lineTo in class PDFGraphicsStreamEngine

curveTo

public void curveTo(float x1,
                    float y1,
                    float x2,
                    float y2,
                    float x3,
                    float y3)

Description copied from class: PDFGraphicsStreamEngine

Draws a curve from the current point to (x3,y3) using (x1,y1) and (x2,y2) as control points.

Specified by:

curveTo in class PDFGraphicsStreamEngine

getCurrentPoint

public android.graphics.PointF getCurrentPoint()

Description copied from class: PDFGraphicsStreamEngine

Returns the current point of the current path.

Specified by:

getCurrentPoint in class PDFGraphicsStreamEngine

closePath

public void closePath()

Description copied from class: PDFGraphicsStreamEngine

Closes the current path.

Specified by:

closePath in class PDFGraphicsStreamEngine

endPath

public void endPath()

Description copied from class: PDFGraphicsStreamEngine

Ends the current path without filling or stroking it. The clipping path is updated here.

Specified by:

endPath in class PDFGraphicsStreamEngine

drawImage

public void drawImage(PDImage pdImage)
               throws IOException

Description copied from class: PDFGraphicsStreamEngine

Draw the image.

Specified by:

drawImage in class PDFGraphicsStreamEngine

Parameters:

pdImage - The image to draw.

Throws:

IOException

shadingFill

public void shadingFill(COSName shadingName)
                 throws IOException

Description copied from class: PDFGraphicsStreamEngine

Fill with Shading.

Specified by:

shadingFill in class PDFGraphicsStreamEngine

Parameters:

shadingName - The name of the Shading Dictionary to use for this fill instruction.

Throws:

IOException

showAnnotation

public void showAnnotation(PDAnnotation annotation)
                    throws IOException

Description copied from class: PDFStreamEngine

Shows the given annotation.

Overrides:

showAnnotation in class PDFStreamEngine

Parameters:

annotation - An annotation on the current page.

Throws:

IOException - If an error occurred reading the annotation

showTransparencyGroup

public void showTransparencyGroup(PDFormXObject form)
                           throws IOException

Description copied from class: PDFStreamEngine

Shows a transparency group from the content stream.

Overrides:

showTransparencyGroup in class PDFStreamEngine

Parameters:

form - transparency group (form) XObject

Throws:

IOException - if the transparency group cannot be processed