de.intarsys.pdf.content
Class CSBasicDevice

java.lang.Object
  de.intarsys.pdf.content.CSDeviceAdapter
      de.intarsys.pdf.content.CSBasicDevice

All Implemented Interfaces:

ICSDevice, ICSDeviceFeatures

Direct Known Subclasses:

CSBoundingBoxCollector, CSTextDevice

public abstract class CSBasicDevice
extends CSDeviceAdapter

A ICSDevice handling the complex semantics of the path and text drawing operators.

As this are expensive operations, devices that do not rely on path and text handling may override the respective methods to save performance.

Field Summary

static float

THOUSAND

Fields inherited from class de.intarsys.pdf.content.CSDeviceAdapter

MAX_STACK_SIZE

Constructor Summary

CSBasicDevice()

Method Summary

void	open(ICSInterpreter interpreter) Open the device for use by interpreter.
void	pathClipEvenOdd() Intersect the current clipping path with the current path using the even/odd rule.
void	pathClipNonZero() Intersect the current clipping path with the current path using the nonzero winding rule.
void	pathClose() Close the path and append a line segment from the current coordinate to the starting point of the path.
void	pathCloseFillStrokeEvenOdd() Close, Fill and then stroke the path using the even/odd rule.
void	pathCloseFillStrokeNonZero() Close, Fill and then stroke the path using the non zero winding rule.
void	pathCloseStroke() Close and then stroke the path.
void	pathEnd() End the path without filling or stroking.
void	pathFillEvenOdd() Fill the path using the even/odd rule.
void	pathFillNonZero() Fill the path using the non-zero winding rule.
void	pathFillStrokeEvenOdd() Fill and then stroke the path using the even/odd rule.
void	pathFillStrokeNonZero() Fill and then stroke the path using the non-zero winding rule.
void	pathStroke() Stroke the current path.
void	penCurveToC(float x1, float y1, float x2, float y2, float x3, float y3) Append a cubic bezier curve to the path.
void	penCurveToV(float x2, float y2, float x3, float y3) Append a cubic bezier curve to the path.
void	penCurveToY(float x1, float y1, float x3, float y3) Append a cubic bezier curve to the path.
void	penLineTo(float x, float y) Add a line from the current point to x, y.
void	penMoveTo(float x, float y) Move the current point to x, y.
void	penRectangle(float x, float y, float w, float h) Append a complete rectangle to as a subpath.
void	textShow(byte[] text, int offset, int length) Show a sequence of bytes as text.

Methods inherited from class de.intarsys.pdf.content.CSDeviceAdapter

close, compatibilityBegin, compatibilityEnd, doShading, doXObject, getDeviceTransform, getGraphicsState, getInterpreter, inlineImage, markedContentBegin, markedContentBeginProperties, markedContentEnd, markedContentPoint, markedContentPointProperties, restoreState, saveState, setDeviceTransform, setExtendedState, setFlatnessTolerance, setLineCap, setLineDash, setLineJoin, setLineWidth, setMiterLimit, setNonStrokeColorCMYK, setNonStrokeColorGray, setNonStrokeColorRGB, setNonStrokeColorSpace, setNonStrokeColorValues, setNonStrokeColorValues, setRenderingIntent, setStrokeColorCMYK, setStrokeColorGray, setStrokeColorRGB, setStrokeColorSpace, setStrokeColorValues, setStrokeColorValues, supportsColorSpace, supportsExtendedState, supportsFont, supportsInlineImage, supportsPattern, supportsProperties, supportsShading, supportsXObject, textBegin, textEnd, textLineMove, textLineNew, textMove, textMoveTo, textSetCharSpacing, textSetFont, textSetHorizontalScaling, textSetLeading, textSetRenderingMode, textSetRise, textSetTransform, textSetWordSpacing, textShow, textShow, textT3SetGlyphWidth, textT3SetGlyphWidthBB, transform

Methods inherited from class java.lang.Object

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

Field Detail

THOUSAND

public static final float THOUSAND

See Also:

Constant Field Values

Constructor Detail

CSBasicDevice

public CSBasicDevice()

Method Detail

open

public void open(ICSInterpreter interpreter)

Description copied from interface: ICSDevice

Open the device for use by interpreter.

Specified by:

open in interface ICSDevice

Overrides:

open in class CSDeviceAdapter

pathClipEvenOdd

public void pathClipEvenOdd()

Description copied from interface: ICSDevice

Intersect the current clipping path with the current path using the even/odd rule.

PDF graphics operator "W*"

Specified by:

pathClipEvenOdd in interface ICSDevice

Overrides:

pathClipEvenOdd in class CSDeviceAdapter

pathClipNonZero

public void pathClipNonZero()

Description copied from interface: ICSDevice

Intersect the current clipping path with the current path using the nonzero winding rule.

PDF graphics operator "W"

Specified by:

pathClipNonZero in interface ICSDevice

Overrides:

pathClipNonZero in class CSDeviceAdapter

pathClose

public void pathClose()

Description copied from interface: ICSDevice

Close the path and append a line segment from the current coordinate to the starting point of the path.

PDF graphics operator "h"

Specified by:

pathClose in interface ICSDevice

Overrides:

pathClose in class CSDeviceAdapter

pathCloseFillStrokeEvenOdd

public void pathCloseFillStrokeEvenOdd()

Description copied from interface: ICSDevice

Close, Fill and then stroke the path using the even/odd rule.

PDF graphics operator "b*"

Specified by:

pathCloseFillStrokeEvenOdd in interface ICSDevice

Overrides:

pathCloseFillStrokeEvenOdd in class CSDeviceAdapter

pathCloseFillStrokeNonZero

public void pathCloseFillStrokeNonZero()

Description copied from interface: ICSDevice

Close, Fill and then stroke the path using the non zero winding rule.

PDF graphics operator "b"

Specified by:

pathCloseFillStrokeNonZero in interface ICSDevice

Overrides:

pathCloseFillStrokeNonZero in class CSDeviceAdapter

pathCloseStroke

public void pathCloseStroke()

Description copied from interface: ICSDevice

Close and then stroke the path.

PDF graphics operator "s"

Specified by:

pathCloseStroke in interface ICSDevice

Overrides:

pathCloseStroke in class CSDeviceAdapter

pathEnd

public void pathEnd()

Description copied from interface: ICSDevice

End the path without filling or stroking.

This may for example be used to manipulate the clipping path without a painting operation.

PDF graphics operator "n"

Specified by:

pathEnd in interface ICSDevice

Overrides:

pathEnd in class CSDeviceAdapter

pathFillEvenOdd

public void pathFillEvenOdd()

Description copied from interface: ICSDevice

Fill the path using the even/odd rule.

PDF graphics operator "f*"

Specified by:

pathFillEvenOdd in interface ICSDevice

Overrides:

pathFillEvenOdd in class CSDeviceAdapter

pathFillNonZero

public void pathFillNonZero()

Description copied from interface: ICSDevice

Fill the path using the non-zero winding rule.

An open subpath is closed before filling.

PDF graphics operator "f"

Specified by:

pathFillNonZero in interface ICSDevice

Overrides:

pathFillNonZero in class CSDeviceAdapter

pathFillStrokeEvenOdd

public void pathFillStrokeEvenOdd()

Description copied from interface: ICSDevice

Fill and then stroke the path using the even/odd rule.

PDF graphics operator "B*"

Specified by:

pathFillStrokeEvenOdd in interface ICSDevice

Overrides:

pathFillStrokeEvenOdd in class CSDeviceAdapter

pathFillStrokeNonZero

public void pathFillStrokeNonZero()

Description copied from interface: ICSDevice

Fill and then stroke the path using the non-zero winding rule.

PDF graphics operator "B"

Specified by:

pathFillStrokeNonZero in interface ICSDevice

Overrides:

pathFillStrokeNonZero in class CSDeviceAdapter

pathStroke

public void pathStroke()

Description copied from interface: ICSDevice

Stroke the current path.

PDF graphics operator "S"

Specified by:

pathStroke in interface ICSDevice

Overrides:

pathStroke in class CSDeviceAdapter

penCurveToC

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

Description copied from interface: ICSDevice

Append a cubic bezier curve to the path.
The curve extends from the current point to x3, y3, where x1,y1 and x2,y2 are the bezier control points. current +---------* x1/y1 . _ -. . *x2/y2 . . . + x3/y3

PDF graphics operator "c"

Specified by:

penCurveToC in interface ICSDevice

Overrides:

penCurveToC in class CSDeviceAdapter

Parameters:

x1 - x coordinate of first control point

y1 - y coordinate of first control point

x2 - x coordinate of second control point

y2 - y coordinate of second control point

x3 - x coordinate of endpoint

y3 - y coordinate of endpoint

penCurveToV

public void penCurveToV(float x2,
                        float y2,
                        float x3,
                        float y3)

Description copied from interface: ICSDevice

Append a cubic bezier curve to the path. The curve extends from the current point to x3, y3, where the first control point coincides with the current point and x2,y2 is the second bezier control point. current + . _ -. . *x2/y2 . . . + x3/y3

PDF graphics operator "v"

Specified by:

penCurveToV in interface ICSDevice

Overrides:

penCurveToV in class CSDeviceAdapter

Parameters:

x2 - x coordinate of second control point

y2 - y coordinate of second control point

x3 - x coordinate of endpoint

y3 - y coordinate of endpoint

penCurveToY

public void penCurveToY(float x1,
                        float y1,
                        float x3,
                        float y3)

Description copied from interface: ICSDevice

Append a cubic bezier curve to the path.

The curve extends from the current point to x3, y3, where x1,y1 and x3,y3 are the bezier control points. current +---------* x1/y1 . _ -. . . . . + x3/y3

PDF graphics operator "y"

Specified by:

penCurveToY in interface ICSDevice

Overrides:

penCurveToY in class CSDeviceAdapter

Parameters:

x1 - x coordinate of first control point

y1 - y coordinate of first control point

x3 - x coordinate of endpoint

y3 - y coordinate of endpoint

penLineTo

public void penLineTo(float x,
                      float y)

Description copied from interface: ICSDevice

Add a line from the current point to x, y. The new current point is x, y.

PDF graphics operator "l"

Specified by:

penLineTo in interface ICSDevice

Overrides:

penLineTo in class CSDeviceAdapter

Parameters:

x - The new current x coordinate

y - The new current y coordinate

penMoveTo

public void penMoveTo(float x,
                      float y)

Description copied from interface: ICSDevice

Move the current point to x, y. No line is added to the path, a new subpath is started.

PDF graphics operator "m"

Specified by:

penMoveTo in interface ICSDevice

Overrides:

penMoveTo in class CSDeviceAdapter

Parameters:

x - The new current x coordinate

y - The new current y coordinate

penRectangle

public void penRectangle(float x,
                         float y,
                         float w,
                         float h)

Description copied from interface: ICSDevice

Append a complete rectangle to as a subpath.

The lower left corner is at x, y, the dimensions are width and height. The numbers are defined in user space.

PDF graphics operator "re"

Specified by:

penRectangle in interface ICSDevice

Overrides:

penRectangle in class CSDeviceAdapter

Parameters:

x - The x coordinate of the lower left corner in user space

y - The y coordinate of the lower left corner in user space

w - The width in user space

h - The height in user space

textShow

public void textShow(byte[] text,
                     int offset,
                     int length)

Description copied from interface: ICSDevice

Show a sequence of bytes as text. The bytes are assumed to be encoded and copied directly to the device.

PDF graphics operator "Tj"

Specified by:

textShow in interface ICSDevice

Overrides:

textShow in class CSDeviceAdapter

Parameters:

text - The bytes to be shown.