PdfContentByte is an object containing the user positioned
* text and graphic contents of a page. It knows how to apply the proper
* font encoding.
*/
public class PdfContentByte {
/**
* This class keeps the graphic state of the current page
*/
static class GraphicState {
/** This is the font in use */
FontDetails fontDetails;
/** This is the color in use */
ColorDetails colorDetails;
/** This is the font size in use */
float size;
/** The x position of the text line matrix. */
protected float xTLM = 0;
/** The y position of the text line matrix. */
protected float yTLM = 0;
protected float aTLM = 1;
protected float bTLM = 0;
protected float cTLM = 0;
protected float dTLM = 1;
protected float tx = 0;
/** The current text leading. */
protected float leading = 0;
/** The current horizontal scaling */
protected float scale = 100;
/** The current character spacing */
protected float charSpace = 0;
/** The current word spacing */
protected float wordSpace = 0;
protected BaseColor textColorFill = new GrayColor(0);
protected BaseColor graphicsColorFill = new GrayColor(0);
protected BaseColor textColorStroke = new GrayColor(0);
protected BaseColor graphicsColorStroke = new GrayColor(0);
protected AffineTransform CTM = new AffineTransform();
GraphicState() {
}
GraphicState(final GraphicState cp) {
copyParameters(cp);
}
void copyParameters(final GraphicState cp) {
fontDetails = cp.fontDetails;
colorDetails = cp.colorDetails;
size = cp.size;
xTLM = cp.xTLM;
yTLM = cp.yTLM;
aTLM = cp.aTLM;
bTLM = cp.bTLM;
cTLM = cp.cTLM;
dTLM = cp.dTLM;
tx = cp.tx;
leading = cp.leading;
scale = cp.scale;
charSpace = cp.charSpace;
wordSpace = cp.wordSpace;
textColorFill = cp.textColorFill;
graphicsColorFill = cp.graphicsColorFill;
textColorStroke = cp.textColorStroke;
graphicsColorStroke = cp.graphicsColorStroke;
CTM = new AffineTransform(cp.CTM);
}
void restore(final GraphicState restore) {
copyParameters(restore);
}
}
/** The alignment is center */
public static final int ALIGN_CENTER = Element.ALIGN_CENTER;
/** The alignment is left */
public static final int ALIGN_LEFT = Element.ALIGN_LEFT;
/** The alignment is right */
public static final int ALIGN_RIGHT = Element.ALIGN_RIGHT;
/** A possible line cap value */
public static final int LINE_CAP_BUTT = 0;
/** A possible line cap value */
public static final int LINE_CAP_ROUND = 1;
/** A possible line cap value */
public static final int LINE_CAP_PROJECTING_SQUARE = 2;
/** A possible line join value */
public static final int LINE_JOIN_MITER = 0;
/** A possible line join value */
public static final int LINE_JOIN_ROUND = 1;
/** A possible line join value */
public static final int LINE_JOIN_BEVEL = 2;
/** A possible text rendering value */
public static final int TEXT_RENDER_MODE_FILL = 0;
/** A possible text rendering value */
public static final int TEXT_RENDER_MODE_STROKE = 1;
/** A possible text rendering value */
public static final int TEXT_RENDER_MODE_FILL_STROKE = 2;
/** A possible text rendering value */
public static final int TEXT_RENDER_MODE_INVISIBLE = 3;
/** A possible text rendering value */
public static final int TEXT_RENDER_MODE_FILL_CLIP = 4;
/** A possible text rendering value */
public static final int TEXT_RENDER_MODE_STROKE_CLIP = 5;
/** A possible text rendering value */
public static final int TEXT_RENDER_MODE_FILL_STROKE_CLIP = 6;
/** A possible text rendering value */
public static final int TEXT_RENDER_MODE_CLIP = 7;
private static final float[] unitRect = {0, 0, 0, 1, 1, 0, 1, 1};
// membervariables
/** This is the actual content */
protected ByteBuffer content = new ByteBuffer();
protected int markedContentSize = 0;
/** This is the writer */
protected PdfWriter writer;
/** This is the PdfDocument */
protected PdfDocument pdf;
/** This is the GraphicState in use */
protected GraphicState state = new GraphicState();
/** The list were we save/restore the state */
protected ArrayListPdfContentByte-object.
*
* @param wr the writer associated to this content
*/
public PdfContentByte(final PdfWriter wr) {
if (wr != null) {
writer = wr;
pdf = writer.getPdfDocument();
}
}
// methods to get the content of this object
/**
* Returns the String representation of this PdfContentByte-object.
*
* @return a String
*/
@Override
public String toString() {
return content.toString();
}
/**
* Checks if the content needs to be tagged.
* @return false if no tags need to be added
*/
public boolean isTagged() {
return writer != null && writer.isTagged();
}
/**
* Gets the internal buffer.
* @return the internal buffer
*/
public ByteBuffer getInternalBuffer() {
return content;
}
/** Returns the PDF representation of this PdfContentByte-object.
*
* @param writer the PdfWriter
* @return a byte array with the representation
*/
public byte[] toPdf(final PdfWriter writer) {
sanityCheck();
return content.toByteArray();
}
// methods to add graphical content
/**
* Adds the content of another PdfContentByte-object to this object.
*
* @param other another PdfByteContent-object
*/
public void add(final PdfContentByte other) {
if (other.writer != null && writer != other.writer)
throw new RuntimeException(MessageLocalization.getComposedMessage("inconsistent.writers.are.you.mixing.two.documents"));
content.append(other.content);
markedContentSize += other.markedContentSize;
}
/**
* Gets the x position of the text line matrix.
*
* @return the x position of the text line matrix
*/
public float getXTLM() {
return state.xTLM;
}
/**
* Gets the y position of the text line matrix.
*
* @return the y position of the text line matrix
*/
public float getYTLM() {
return state.yTLM;
}
/**
* Gets the current text leading.
*
* @return the current text leading
*/
public float getLeading() {
return state.leading;
}
/**
* Gets the current character spacing.
*
* @return the current character spacing
*/
public float getCharacterSpacing() {
return state.charSpace;
}
/**
* Gets the current word spacing.
*
* @return the current word spacing
*/
public float getWordSpacing() {
return state.wordSpace;
}
/**
* Gets the current character spacing.
*
* @return the current character spacing
*/
public float getHorizontalScaling() {
return state.scale;
}
/**
* Changes the Flatness.
*
* Flatness sets the maximum permitted distance in device pixels between the
* mathematically correct path and an approximation constructed from straight line segments.
*
* @param flatness a value
*/
public void setFlatness(final float flatness) {
if (flatness >= 0 && flatness <= 100) {
content.append(flatness).append(" i").append_i(separator);
}
}
/**
* Changes the Line cap style.
*
* The line cap style specifies the shape to be used at the end of open subpaths
* when they are stroked.
* Allowed values are LINE_CAP_BUTT, LINE_CAP_ROUND and LINE_CAP_PROJECTING_SQUARE.
*
* @param style a value
*/
public void setLineCap(final int style) {
if (style >= 0 && style <= 2) {
content.append(style).append(" J").append_i(separator);
}
}
/**
* Changes the value of the line dash pattern.
*
* The line dash pattern controls the pattern of dashes and gaps used to stroke paths.
* It is specified by an array and a phase. The array specifies the length
* of the alternating dashes and gaps. The phase specifies the distance into the dash
* pattern to start the dash.
*
* @param phase the value of the phase
*/
public void setLineDash(final float phase) {
content.append("[] ").append(phase).append(" d").append_i(separator);
}
/**
* Changes the value of the line dash pattern.
*
* The line dash pattern controls the pattern of dashes and gaps used to stroke paths.
* It is specified by an array and a phase. The array specifies the length
* of the alternating dashes and gaps. The phase specifies the distance into the dash
* pattern to start the dash.
*
* @param phase the value of the phase
* @param unitsOn the number of units that must be 'on' (equals the number of units that must be 'off').
*/
public void setLineDash(final float unitsOn, final float phase) {
content.append("[").append(unitsOn).append("] ").append(phase).append(" d").append_i(separator);
}
/**
* Changes the value of the line dash pattern.
*
* The line dash pattern controls the pattern of dashes and gaps used to stroke paths.
* It is specified by an array and a phase. The array specifies the length
* of the alternating dashes and gaps. The phase specifies the distance into the dash
* pattern to start the dash.
*
* @param phase the value of the phase
* @param unitsOn the number of units that must be 'on'
* @param unitsOff the number of units that must be 'off'
*/
public void setLineDash(final float unitsOn, final float unitsOff, final float phase) {
content.append("[").append(unitsOn).append(' ').append(unitsOff).append("] ").append(phase).append(" d").append_i(separator);
}
/**
* Changes the value of the line dash pattern.
*
* The line dash pattern controls the pattern of dashes and gaps used to stroke paths.
* It is specified by an array and a phase. The array specifies the length
* of the alternating dashes and gaps. The phase specifies the distance into the dash
* pattern to start the dash.
*
* @param array length of the alternating dashes and gaps
* @param phase the value of the phase
*/
public final void setLineDash(final float[] array, final float phase) {
content.append("[");
for (int i = 0; i < array.length; i++) {
content.append(array[i]);
if (i < array.length - 1) content.append(' ');
}
content.append("] ").append(phase).append(" d").append_i(separator);
}
/**
* Changes the Line join style.
*
* The line join style specifies the shape to be used at the corners of paths
* that are stroked.
* Allowed values are LINE_JOIN_MITER (Miter joins), LINE_JOIN_ROUND (Round joins) and LINE_JOIN_BEVEL (Bevel joins).
*
* @param style a value
*/
public void setLineJoin(final int style) {
if (style >= 0 && style <= 2) {
content.append(style).append(" j").append_i(separator);
}
}
/**
* Changes the line width.
*
* The line width specifies the thickness of the line used to stroke a path and is measured
* in user space units.
*
* @param w a width
*/
public void setLineWidth(final float w) {
content.append(w).append(" w").append_i(separator);
}
/**
* Changes the Miter limit.
*
* When two line segments meet at a sharp angle and mitered joins have been specified as the
* line join style, it is possible for the miter to extend far beyond the thickness of the line
* stroking path. The miter limit imposes a maximum on the ratio of the miter length to the line
* witdh. When the limit is exceeded, the join is converted from a miter to a bevel.
*
* @param miterLimit a miter limit
*/
public void setMiterLimit(final float miterLimit) {
if (miterLimit > 1) {
content.append(miterLimit).append(" M").append_i(separator);
}
}
/**
* Modify the current clipping path by intersecting it with the current path, using the
* nonzero winding number rule to determine which regions lie inside the clipping
* path.
*/
public void clip() {
if (inText && isTagged()) {
endText();
}
content.append("W").append_i(separator);
}
/**
* Modify the current clipping path by intersecting it with the current path, using the
* even-odd rule to determine which regions lie inside the clipping path.
*/
public void eoClip() {
if (inText && isTagged()) {
endText();
}
content.append("W*").append_i(separator);
}
/**
* Changes the currentgray tint for filling paths (device dependent colors!).
*
* Sets the color space to DeviceGray (or the DefaultGray color space), * and sets the gray tint to use for filling paths.
* * @param gray a value between 0 (black) and 1 (white) */ public void setGrayFill(final float gray) { saveColor(new GrayColor(gray), true); content.append(gray).append(" g").append_i(separator); } /** * Changes the current gray tint for filling paths to black. */ public void resetGrayFill() { saveColor(new GrayColor(0), true); content.append("0 g").append_i(separator); } /** * Changes the currentgray tint for stroking paths (device dependent colors!). ** Sets the color space to DeviceGray (or the DefaultGray color space), * and sets the gray tint to use for stroking paths.
* * @param gray a value between 0 (black) and 1 (white) */ public void setGrayStroke(final float gray) { saveColor(new GrayColor(gray), false); content.append(gray).append(" G").append_i(separator); } /** * Changes the current gray tint for stroking paths to black. */ public void resetGrayStroke() { saveColor(new GrayColor(0), false); content.append("0 G").append_i(separator); } /** * Helper to validate and write the RGB color components * @param red the intensity of red. A value between 0 and 1 * @param green the intensity of green. A value between 0 and 1 * @param blue the intensity of blue. A value between 0 and 1 */ private void HelperRGB(float red, float green, float blue) { PdfWriter.checkPdfIsoConformance(writer, PdfIsoKeys.PDFISOKEY_RGB, null); if (red < 0) red = 0.0f; else if (red > 1.0f) red = 1.0f; if (green < 0) green = 0.0f; else if (green > 1.0f) green = 1.0f; if (blue < 0) blue = 0.0f; else if (blue > 1.0f) blue = 1.0f; content.append(red).append(' ').append(green).append(' ').append(blue); } /** * Changes the current color for filling paths (device dependent colors!). ** Sets the color space to DeviceRGB (or the DefaultRGB color space), * and sets the color to use for filling paths.
** Following the PDF manual, each operand must be a number between 0 (minimum intensity) and * 1 (maximum intensity).
* * @param red the intensity of red. A value between 0 and 1 * @param green the intensity of green. A value between 0 and 1 * @param blue the intensity of blue. A value between 0 and 1 */ public void setRGBColorFillF(final float red, final float green, final float blue) { saveColor(new BaseColor(red, green, blue), true); HelperRGB(red, green, blue); content.append(" rg").append_i(separator); } /** * Changes the current color for filling paths to black. */ public void resetRGBColorFill() { resetGrayFill(); } /** * Changes the current color for stroking paths (device dependent colors!). ** Sets the color space to DeviceRGB (or the DefaultRGB color space), * and sets the color to use for stroking paths.
** Following the PDF manual, each operand must be a number between 0 (miniumum intensity) and * 1 (maximum intensity). * * @param red the intensity of red. A value between 0 and 1 * @param green the intensity of green. A value between 0 and 1 * @param blue the intensity of blue. A value between 0 and 1 */ public void setRGBColorStrokeF(final float red, final float green, final float blue) { saveColor(new BaseColor(red, green, blue), false); HelperRGB(red, green, blue); content.append(" RG").append_i(separator); } /** * Changes the current color for stroking paths to black. * */ public void resetRGBColorStroke() { resetGrayStroke(); } /** * Helper to validate and write the CMYK color components. * * @param cyan the intensity of cyan. A value between 0 and 1 * @param magenta the intensity of magenta. A value between 0 and 1 * @param yellow the intensity of yellow. A value between 0 and 1 * @param black the intensity of black. A value between 0 and 1 */ private void HelperCMYK(float cyan, float magenta, float yellow, float black) { if (cyan < 0) cyan = 0.0f; else if (cyan > 1.0f) cyan = 1.0f; if (magenta < 0) magenta = 0.0f; else if (magenta > 1.0f) magenta = 1.0f; if (yellow < 0) yellow = 0.0f; else if (yellow > 1.0f) yellow = 1.0f; if (black < 0) black = 0.0f; else if (black > 1.0f) black = 1.0f; content.append(cyan).append(' ').append(magenta).append(' ').append(yellow).append(' ').append(black); } /** * Changes the current color for filling paths (device dependent colors!). *
* Sets the color space to DeviceCMYK (or the DefaultCMYK color space), * and sets the color to use for filling paths.
** Following the PDF manual, each operand must be a number between 0 (no ink) and * 1 (maximum ink).
* * @param cyan the intensity of cyan. A value between 0 and 1 * @param magenta the intensity of magenta. A value between 0 and 1 * @param yellow the intensity of yellow. A value between 0 and 1 * @param black the intensity of black. A value between 0 and 1 */ public void setCMYKColorFillF(final float cyan, final float magenta, final float yellow, final float black) { saveColor(new CMYKColor(cyan, magenta, yellow, black), true); HelperCMYK(cyan, magenta, yellow, black); content.append(" k").append_i(separator); } /** * Changes the current color for filling paths to black. * */ public void resetCMYKColorFill() { saveColor(new CMYKColor(0, 0, 0, 1), true); content.append("0 0 0 1 k").append_i(separator); } /** * Changes the current color for stroking paths (device dependent colors!). ** Sets the color space to DeviceCMYK (or the DefaultCMYK color space), * and sets the color to use for stroking paths.
*
* Following the PDF manual, each operand must be a number between 0 (miniumum intensity) and
* 1 (maximum intensity).
*
* @param cyan the intensity of cyan. A value between 0 and 1
* @param magenta the intensity of magenta. A value between 0 and 1
* @param yellow the intensity of yellow. A value between 0 and 1
* @param black the intensity of black. A value between 0 and 1
*/
public void setCMYKColorStrokeF(final float cyan, final float magenta, final float yellow, final float black) {
saveColor(new CMYKColor(cyan, magenta, yellow, black), false);
HelperCMYK(cyan, magenta, yellow, black);
content.append(" K").append_i(separator);
}
/**
* Changes the current color for stroking paths to black.
*
*/
public void resetCMYKColorStroke() {
saveColor(new CMYKColor(0, 0, 0, 1), false);
content.append("0 0 0 1 K").append_i(separator);
}
/**
* Move the current point (x, y), omitting any connecting line segment.
*
* @param x new x-coordinate
* @param y new y-coordinate
*/
public void moveTo(final float x, final float y) {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append(x).append(' ').append(y).append(" m").append_i(separator);
}
/**
* Appends a straight line segment from the current point (x, y). The new current
* point is (x, y).
*
* @param x new x-coordinate
* @param y new y-coordinate
*/
public void lineTo(final float x, final float y) {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append(x).append(' ').append(y).append(" l").append_i(separator);
}
/**
* Appends a Bêzier curve to the path, starting from the current point.
*
* @param x1 x-coordinate of the first control point
* @param y1 y-coordinate of the first control point
* @param x2 x-coordinate of the second control point
* @param y2 y-coordinate of the second control point
* @param x3 x-coordinate of the ending point (= new current point)
* @param y3 y-coordinate of the ending point (= new current point)
*/
public void curveTo(final float x1, final float y1, final float x2, final float y2, final float x3, final float y3) {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append(x1).append(' ').append(y1).append(' ').append(x2).append(' ').append(y2).append(' ').append(x3).append(' ').append(y3).append(" c").append_i(separator);
}
/**
* Appends a Bêzier curve to the path, starting from the current point.
*
* @param x2 x-coordinate of the second control point
* @param y2 y-coordinate of the second control point
* @param x3 x-coordinate of the ending point (= new current point)
* @param y3 y-coordinate of the ending point (= new current point)
*/
public void curveTo(final float x2, final float y2, final float x3, final float y3) {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append(x2).append(' ').append(y2).append(' ').append(x3).append(' ').append(y3).append(" v").append_i(separator);
}
/**
* Appends a Bêzier curve to the path, starting from the current point.
*
* @param x1 x-coordinate of the first control point
* @param y1 y-coordinate of the first control point
* @param x3 x-coordinate of the ending point (= new current point)
* @param y3 y-coordinate of the ending point (= new current point)
*/
public void curveFromTo(final float x1, final float y1, final float x3, final float y3) {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append(x1).append(' ').append(y1).append(' ').append(x3).append(' ').append(y3).append(" y").append_i(separator);
}
/** Draws a circle. The endpoint will (x+r, y).
*
* @param x x center of circle
* @param y y center of circle
* @param r radius of circle
*/
public void circle(final float x, final float y, final float r) {
float b = 0.5523f;
moveTo(x + r, y);
curveTo(x + r, y + r * b, x + r * b, y + r, x, y + r);
curveTo(x - r * b, y + r, x - r, y + r * b, x - r, y);
curveTo(x - r, y - r * b, x - r * b, y - r, x, y - r);
curveTo(x + r * b, y - r, x + r, y - r * b, x + r, y);
}
/**
* Adds a rectangle to the current path.
*
* @param x x-coordinate of the starting point
* @param y y-coordinate of the starting point
* @param w width
* @param h height
*/
public void rectangle(final float x, final float y, final float w, final float h) {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append(x).append(' ').append(y).append(' ').append(w).append(' ').append(h).append(" re").append_i(separator);
}
private boolean compareColors(final BaseColor c1, final BaseColor c2) {
if (c1 == null && c2 == null)
return true;
if (c1 == null || c2 == null)
return false;
if (c1 instanceof ExtendedColor)
return c1.equals(c2);
return c2.equals(c1);
}
/**
* Adds a variable width border to the current path.
* Only use if {@link com.lowagie.text.Rectangle#isUseVariableBorders() Rectangle.isUseVariableBorders}
* = true.
* @param rect a
* The leading parameter is measured in text space units. It specifies the vertical distance
* between the baselines of adjacent lines of text.
* This allows to write text in subscript or superscript mode.
* Remark: this operation also initializes the current point position.
* @param transform overwrite the current text matrix with this one
*/
public void setTextMatrix(final AffineTransform transform) {
double matrix[] = new double[6];
transform.getMatrix(matrix);
setTextMatrix((float) matrix[0], (float) matrix[1], (float) matrix[2],
(float) matrix[3], (float) matrix[4], (float) matrix[5]);
}
/**
* Changes the text matrix. The first four parameters are {1,0,0,1}.
*
* Remark: this operation also initializes the current point position.
* As a side effect, this sets the leading parameter in the text state.
* (x1, y1) and (x2, y2) are the corners of the enclosing rectangle.
* Angles, measured in degrees, start with 0 to the right (the positive X
* axis) and increase counter-clockwise. The arc extends from startAng
* to startAng+extent. I.e. startAng=0 and extent=180 yields an openside-down
* semi-circle.
*
* The resulting coordinates are of the form float[]{x1,y1,x2,y2,x3,y3, x4,y4}
* such that the curve goes from (x1, y1) to (x4, y4) with (x2, y2) and
* (x3, y3) as their respective Bezier control points.
*
* Note: this code was taken from ReportLab (www.reportlab.org), an excellent
* PDF generator for Python (BSD license: http://www.reportlab.org/devfaq.html#1.3 ).
*
* @param x1 a corner of the enclosing rectangle
* @param y1 a corner of the enclosing rectangle
* @param x2 a corner of the enclosing rectangle
* @param y2 a corner of the enclosing rectangle
* @param startAng starting angle in degrees
* @param extent angle extent in degrees
* @return a list of float[] with the bezier curves
*/
public static ArrayList
* Creates a new template that is nothing more than a form XObject. This template can be included
* in this
* Sets the color space to DeviceCMYK (or the DefaultCMYK color space),
* and sets the color to use for filling paths.
* This method is described in the 'Portable Document Format Reference Manual version 1.3'
* section 8.5.2.1 (page 331).
* Following the PDF manual, each operand must be a number between 0 (no ink) and
* 1 (maximum ink). This method however accepts only integers between 0x00 and 0xFF.
* Sets the color space to DeviceCMYK (or the DefaultCMYK color space),
* and sets the color to use for stroking paths.
* This method is described in the 'Portable Document Format Reference Manual version 1.3'
* section 8.5.2.1 (page 331).
* Sets the color space to DeviceRGB (or the DefaultRGB color space),
* and sets the color to use for filling paths.
* This method is described in the 'Portable Document Format Reference Manual version 1.3'
* section 8.5.2.1 (page 331).
* Following the PDF manual, each operand must be a number between 0 (minimum intensity) and
* 1 (maximum intensity). This method however accepts only integers between 0x00 and 0xFF.
* Sets the color space to DeviceRGB (or the DefaultRGB color space),
* and sets the color to use for stroking paths.
* This method is described in the 'Portable Document Format Reference Manual version 1.3'
* section 8.5.2.1 (page 331).Rectangle
*/
public void variableRectangle(final Rectangle rect) {
float t = rect.getTop();
float b = rect.getBottom();
float r = rect.getRight();
float l = rect.getLeft();
float wt = rect.getBorderWidthTop();
float wb = rect.getBorderWidthBottom();
float wr = rect.getBorderWidthRight();
float wl = rect.getBorderWidthLeft();
BaseColor ct = rect.getBorderColorTop();
BaseColor cb = rect.getBorderColorBottom();
BaseColor cr = rect.getBorderColorRight();
BaseColor cl = rect.getBorderColorLeft();
saveState();
setLineCap(PdfContentByte.LINE_CAP_BUTT);
setLineJoin(PdfContentByte.LINE_JOIN_MITER);
float clw = 0;
boolean cdef = false;
BaseColor ccol = null;
boolean cdefi = false;
BaseColor cfil = null;
// draw top
if (wt > 0) {
setLineWidth(clw = wt);
cdef = true;
if (ct == null)
resetRGBColorStroke();
else
setColorStroke(ct);
ccol = ct;
moveTo(l, t - wt / 2f);
lineTo(r, t - wt / 2f);
stroke();
}
// Draw bottom
if (wb > 0) {
if (wb != clw)
setLineWidth(clw = wb);
if (!cdef || !compareColors(ccol, cb)) {
cdef = true;
if (cb == null)
resetRGBColorStroke();
else
setColorStroke(cb);
ccol = cb;
}
moveTo(r, b + wb / 2f);
lineTo(l, b + wb / 2f);
stroke();
}
// Draw right
if (wr > 0) {
if (wr != clw)
setLineWidth(clw = wr);
if (!cdef || !compareColors(ccol, cr)) {
cdef = true;
if (cr == null)
resetRGBColorStroke();
else
setColorStroke(cr);
ccol = cr;
}
boolean bt = compareColors(ct, cr);
boolean bb = compareColors(cb, cr);
moveTo(r - wr / 2f, bt ? t : t - wt);
lineTo(r - wr / 2f, bb ? b : b + wb);
stroke();
if (!bt || !bb) {
cdefi = true;
if (cr == null)
resetRGBColorFill();
else
setColorFill(cr);
cfil = cr;
if (!bt) {
moveTo(r, t);
lineTo(r, t - wt);
lineTo(r - wr, t - wt);
fill();
}
if (!bb) {
moveTo(r, b);
lineTo(r, b + wb);
lineTo(r - wr, b + wb);
fill();
}
}
}
// Draw Left
if (wl > 0) {
if (wl != clw)
setLineWidth(wl);
if (!cdef || !compareColors(ccol, cl)) {
if (cl == null)
resetRGBColorStroke();
else
setColorStroke(cl);
}
boolean bt = compareColors(ct, cl);
boolean bb = compareColors(cb, cl);
moveTo(l + wl / 2f, bt ? t : t - wt);
lineTo(l + wl / 2f, bb ? b : b + wb);
stroke();
if (!bt || !bb) {
if (!cdefi || !compareColors(cfil, cl)) {
if (cl == null)
resetRGBColorFill();
else
setColorFill(cl);
}
if (!bt) {
moveTo(l, t);
lineTo(l, t - wt);
lineTo(l + wl, t - wt);
fill();
}
if (!bb) {
moveTo(l, b);
lineTo(l, b + wb);
lineTo(l + wl, b + wb);
fill();
}
}
}
restoreState();
}
/**
* Adds a border (complete or partially) to the current path..
*
* @param rectangle a Rectangle
*/
public void rectangle(final Rectangle rectangle) {
// the coordinates of the border are retrieved
float x1 = rectangle.getLeft();
float y1 = rectangle.getBottom();
float x2 = rectangle.getRight();
float y2 = rectangle.getTop();
// the backgroundcolor is set
BaseColor background = rectangle.getBackgroundColor();
if (background != null) {
saveState();
setColorFill(background);
rectangle(x1, y1, x2 - x1, y2 - y1);
fill();
restoreState();
}
// if the element hasn't got any borders, nothing is added
if (! rectangle.hasBorders()) {
return;
}
// if any of the individual border colors are set
// we draw the borders all around using the
// different colors
if (rectangle.isUseVariableBorders()) {
variableRectangle(rectangle);
}
else {
// the width is set to the width of the element
if (rectangle.getBorderWidth() != Rectangle.UNDEFINED) {
setLineWidth(rectangle.getBorderWidth());
}
// the color is set to the color of the element
BaseColor color = rectangle.getBorderColor();
if (color != null) {
setColorStroke(color);
}
// if the box is a rectangle, it is added as a rectangle
if (rectangle.hasBorder(Rectangle.BOX)) {
rectangle(x1, y1, x2 - x1, y2 - y1);
}
// if the border isn't a rectangle, the different sides are added apart
else {
if (rectangle.hasBorder(Rectangle.RIGHT)) {
moveTo(x2, y1);
lineTo(x2, y2);
}
if (rectangle.hasBorder(Rectangle.LEFT)) {
moveTo(x1, y1);
lineTo(x1, y2);
}
if (rectangle.hasBorder(Rectangle.BOTTOM)) {
moveTo(x1, y1);
lineTo(x2, y1);
}
if (rectangle.hasBorder(Rectangle.TOP)) {
moveTo(x1, y2);
lineTo(x2, y2);
}
}
stroke();
if (color != null) {
resetRGBColorStroke();
}
}
}
/**
* Closes the current subpath by appending a straight line segment from the current point
* to the starting point of the subpath.
*/
public void closePath() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("h").append_i(separator);
}
/**
* Ends the path without filling or stroking it.
*/
public void newPath() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("n").append_i(separator);
}
/**
* Strokes the path.
*/
public void stroke() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("S").append_i(separator);
}
/**
* Closes the path and strokes it.
*/
public void closePathStroke() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("s").append_i(separator);
}
/**
* Fills the path, using the non-zero winding number rule to determine the region to fill.
*/
public void fill() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("f").append_i(separator);
}
/**
* Fills the path, using the even-odd rule to determine the region to fill.
*/
public void eoFill() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("f*").append_i(separator);
}
/**
* Fills the path using the non-zero winding number rule to determine the region to fill and strokes it.
*/
public void fillStroke() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("B").append_i(separator);
}
/**
* Closes the path, fills it using the non-zero winding number rule to determine the region to fill and strokes it.
*/
public void closePathFillStroke() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("b").append_i(separator);
}
/**
* Fills the path, using the even-odd rule to determine the region to fill and strokes it.
*/
public void eoFillStroke() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("B*").append_i(separator);
}
/**
* Closes the path, fills it using the even-odd rule to determine the region to fill and strokes it.
*/
public void closePathEoFillStroke() {
if (inText) {
if (isTagged()) {
endText();
} else {
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("path.construction.operator.inside.text.object"));
}
}
content.append("b*").append_i(separator);
}
/**
* Adds an Image to the page. The Image must have
* absolute positioning.
* @param image the Image object
* @throws DocumentException if the Image does not have absolute positioning
*/
public void addImage(final Image image) throws DocumentException {
addImage(image, false);
}
/**
* Adds an Image to the page. The Image must have
* absolute positioning. The image can be placed inline.
* @param image the Image object
* @param inlineImage true to place this image inline, false otherwise
* @throws DocumentException if the Image does not have absolute positioning
*/
public void addImage(final Image image, final boolean inlineImage) throws DocumentException {
if (!image.hasAbsoluteY())
throw new DocumentException(MessageLocalization.getComposedMessage("the.image.must.have.absolute.positioning"));
float matrix[] = image.matrix();
matrix[Image.CX] = image.getAbsoluteX() - matrix[Image.CX];
matrix[Image.CY] = image.getAbsoluteY() - matrix[Image.CY];
addImage(image, matrix[0], matrix[1], matrix[2], matrix[3], matrix[4], matrix[5], inlineImage);
}
/**
* Adds an Image to the page. The positioning of the Image
* is done with the transformation matrix. To position an image at (x,y)
* use addImage(image, image_width, 0, 0, image_height, x, y).
* @param image the Image object
* @param a an element of the transformation matrix
* @param b an element of the transformation matrix
* @param c an element of the transformation matrix
* @param d an element of the transformation matrix
* @param e an element of the transformation matrix
* @param f an element of the transformation matrix
* @throws DocumentException on error
*/
public void addImage(final Image image, final float a, final float b, final float c, final float d, final float e, final float f) throws DocumentException {
addImage(image, a, b, c, d, e, f, false);
}
/**
* adds an image with the given matrix.
* @param image image to add
* @param transform transform to apply to the template prior to adding it.
*/
public void addImage(final Image image, final AffineTransform transform) throws DocumentException {
double matrix[] = new double[6];
transform.getMatrix(matrix);
addImage( image, (float)matrix[0], (float)matrix[1], (float)matrix[2],
(float)matrix[3], (float)matrix[4],(float) matrix[5], false );
}
/**
* Adds an Image to the page. The positioning of the Image
* is done with the transformation matrix. To position an image at (x,y)
* use addImage(image, image_width, 0, 0, image_height, x, y). The image can be placed inline.
* @param image the Image object
* @param a an element of the transformation matrix
* @param b an element of the transformation matrix
* @param c an element of the transformation matrix
* @param d an element of the transformation matrix
* @param e an element of the transformation matrix
* @param f an element of the transformation matrix
* @param inlineImage true to place this image inline, false otherwise
* @throws DocumentException on error
*/
public void addImage(final Image image, final float a, final float b, final float c, final float d, final float e, final float f, final boolean inlineImage) throws DocumentException {
try {
if (image.getLayer() != null)
beginLayer(image.getLayer());
if (inText && isTagged()) {
endText();
}
if (writer != null && image.isImgTemplate()) {
writer.addDirectImageSimple(image);
PdfTemplate template = image.getTemplateData();
float w = template.getWidth();
float h = template.getHeight();
addTemplate(template, a / w, b / w, c / h, d / h, e, f);
}
else {
content.append("q ");
content.append(a).append(' ');
content.append(b).append(' ');
content.append(c).append(' ');
content.append(d).append(' ');
content.append(e).append(' ');
content.append(f).append(" cm");
if (inlineImage) {
content.append("\nBI\n");
PdfImage pimage = new PdfImage(image, "", null);
if (image instanceof ImgJBIG2) {
byte[] globals = ((ImgJBIG2)image).getGlobalBytes();
if (globals != null) {
PdfDictionary decodeparms = new PdfDictionary();
decodeparms.put(PdfName.JBIG2GLOBALS, writer.getReferenceJBIG2Globals(globals));
pimage.put(PdfName.DECODEPARMS, decodeparms);
}
}
for (Object element : pimage.getKeys()) {
PdfName key = (PdfName)element;
PdfObject value = pimage.get(key);
String s = abrev.get(key);
if (s == null)
continue;
content.append(s);
boolean check = true;
if (key.equals(PdfName.COLORSPACE) && value.isArray()) {
PdfArray ar = (PdfArray)value;
if (ar.size() == 4
&& PdfName.INDEXED.equals(ar.getAsName(0))
&& ar.getPdfObject(1).isName()
&& ar.getPdfObject(2).isNumber()
&& ar.getPdfObject(3).isString()
) {
check = false;
}
}
if (check && key.equals(PdfName.COLORSPACE) && !value.isName()) {
PdfName cs = writer.getColorspaceName();
PageResources prs = getPageResources();
prs.addColor(cs, writer.addToBody(value).getIndirectReference());
value = cs;
}
value.toPdf(null, content);
content.append('\n');
}
content.append("ID\n");
pimage.writeContent(content);
content.append("\nEI\nQ").append_i(separator);
}
else {
PdfName name;
PageResources prs = getPageResources();
Image maskImage = image.getImageMask();
if (maskImage != null) {
name = writer.addDirectImageSimple(maskImage);
prs.addXObject(name, writer.getImageReference(name));
}
name = writer.addDirectImageSimple(image);
name = prs.addXObject(name, writer.getImageReference(name));
content.append(' ').append(name.getBytes()).append(" Do Q").append_i(separator);
}
}
if (image.hasBorders()) {
saveState();
float w = image.getWidth();
float h = image.getHeight();
concatCTM(a / w, b / w, c / h, d / h, e, f);
rectangle(image);
restoreState();
}
if (image.getLayer() != null)
endLayer();
Annotation annot = image.getAnnotation();
if (annot == null)
return;
float[] r = new float[unitRect.length];
for (int k = 0; k < unitRect.length; k += 2) {
r[k] = a * unitRect[k] + c * unitRect[k + 1] + e;
r[k + 1] = b * unitRect[k] + d * unitRect[k + 1] + f;
}
float llx = r[0];
float lly = r[1];
float urx = llx;
float ury = lly;
for (int k = 2; k < r.length; k += 2) {
llx = Math.min(llx, r[k]);
lly = Math.min(lly, r[k + 1]);
urx = Math.max(urx, r[k]);
ury = Math.max(ury, r[k + 1]);
}
annot = new Annotation(annot);
annot.setDimensions(llx, lly, urx, ury);
PdfAnnotation an = PdfAnnotationsImp.convertAnnotation(writer, annot, new Rectangle(llx, lly, urx, ury));
if (an == null)
return;
addAnnotation(an);
}
catch (Exception ee) {
throw new DocumentException(ee);
}
}
/**
* Makes this PdfContentByte empty.
* Calls reset( true )
*/
public void reset() {
reset( true );
}
/**
* Makes this PdfContentByte empty.
* @param validateContent will call sanityCheck() if true.
* @since 2.1.6
*/
public void reset( final boolean validateContent ) {
content.reset();
markedContentSize = 0;
if (validateContent) {
sanityCheck();
}
state = new GraphicState();
stateList = new ArrayListsaveState and
* restoreState must be balanced.
*/
public void saveState() {
if (inText && isTagged()) {
endText();
}
content.append("q").append_i(separator);
stateList.add(new GraphicState(state));
}
/**
* Restores the graphic state. saveState and
* restoreState must be balanced.
*/
public void restoreState() {
if (inText && isTagged()) {
endText();
}
content.append("Q").append_i(separator);
int idx = stateList.size() - 1;
if (idx < 0)
throw new IllegalPdfSyntaxException(MessageLocalization.getComposedMessage("unbalanced.save.restore.state.operators"));
state.restore(stateList.get(idx));
stateList.remove(idx);
}
/**
* Sets the character spacing parameter.
*
* @param charSpace a parameter
*/
public void setCharacterSpacing(final float charSpace) {
if (!inText && isTagged()) {
beginText(true);
}
state.charSpace = charSpace;
content.append(charSpace).append(" Tc").append_i(separator);
}
/**
* Sets the word spacing parameter.
*
* @param wordSpace a parameter
*/
public void setWordSpacing(final float wordSpace) {
if (!inText && isTagged()) {
beginText(true);
}
state.wordSpace = wordSpace;
content.append(wordSpace).append(" Tw").append_i(separator);
}
/**
* Sets the horizontal scaling parameter.
*
* @param scale a parameter
*/
public void setHorizontalScaling(final float scale) {
if (!inText && isTagged()) {
beginText(true);
}
state.scale = scale;
content.append(scale).append(" Tz").append_i(separator);
}
/**
* Sets the text leading parameter.
* text
* converted to bytes according to the font's encoding.
*
* @param text the text to write
*/
private void showText2(final String text) {
if (state.fontDetails == null)
throw new NullPointerException(MessageLocalization.getComposedMessage("font.and.size.must.be.set.before.writing.any.text"));
byte b[] = state.fontDetails.convertToBytes(text);
escapeString(b, content);
}
/**
* Shows the text.
*
* @param text the text to write
*/
public void showText(final String text) {
if (!inText && isTagged()) {
beginText(true);
}
showText2(text);
updateTx(text, 0);
content.append("Tj").append_i(separator);
}
/**
* Constructs a kern array for a text in a certain font
* @param text the text
* @param font the font
* @return a PdfTextArray
*/
public static PdfTextArray getKernArray(final String text, final BaseFont font) {
PdfTextArray pa = new PdfTextArray();
StringBuffer acc = new StringBuffer();
int len = text.length() - 1;
char c[] = text.toCharArray();
if (len >= 0)
acc.append(c, 0, 1);
for (int k = 0; k < len; ++k) {
char c2 = c[k + 1];
int kern = font.getKerning(c[k], c2);
if (kern == 0) {
acc.append(c2);
}
else {
pa.add(acc.toString());
acc.setLength(0);
acc.append(c, k + 1, 1);
pa.add(-kern);
}
}
pa.add(acc.toString());
return pa;
}
/**
* Shows the text kerned.
*
* @param text the text to write
*/
public void showTextKerned(final String text) {
if (state.fontDetails == null)
throw new NullPointerException(MessageLocalization.getComposedMessage("font.and.size.must.be.set.before.writing.any.text"));
BaseFont bf = state.fontDetails.getBaseFont();
if (bf.hasKernPairs())
showText(getKernArray(text, bf));
else {
showText(text);
}
}
/**
* Moves to the next line and shows text.
*
* @param text the text to write
*/
public void newlineShowText(final String text) {
if (!inText && isTagged()) {
beginText(true);
}
state.yTLM -= state.leading;
showText2(text);
content.append("'").append_i(separator);
state.tx = state.xTLM;
updateTx(text, 0);
}
/**
* Moves to the next line and shows text string, using the given values of the character and word spacing parameters.
*
* @param wordSpacing a parameter
* @param charSpacing a parameter
* @param text the text to write
*/
public void newlineShowText(final float wordSpacing, final float charSpacing, final String text) {
if (!inText && isTagged()) {
beginText(true);
}
state.yTLM -= state.leading;
content.append(wordSpacing).append(' ').append(charSpacing);
showText2(text);
content.append("\"").append_i(separator);
// The " operator sets charSpace and wordSpace into graphics state
// (cfr PDF reference v1.6, table 5.6)
state.charSpace = charSpacing;
state.wordSpace = wordSpacing;
state.tx = state.xTLM;
updateTx(text, 0);
}
/**
* Changes the text matrix.
* byte array according to the PDF conventions.
*
* @param b the byte array to escape
* @return an escaped byte array
*/
static byte[] escapeString(final byte b[]) {
ByteBuffer content = new ByteBuffer();
escapeString(b, content);
return content.toByteArray();
}
/**
* Escapes a byte array according to the PDF conventions.
*
* @param b the byte array to escape
* @param content the content
*/
static void escapeString(final byte b[], final ByteBuffer content) {
content.append_i('(');
for (int k = 0; k < b.length; ++k) {
byte c = b[k];
switch (c) {
case '\r':
content.append("\\r");
break;
case '\n':
content.append("\\n");
break;
case '\t':
content.append("\\t");
break;
case '\b':
content.append("\\b");
break;
case '\f':
content.append("\\f");
break;
case '(':
case ')':
case '\\':
content.append_i('\\').append_i(c);
break;
default:
content.append_i(c);
}
}
content.append(")");
}
/**
* Adds a named outline to the document.
*
* @param outline the outline
* @param name the name for the local destination
*/
public void addOutline(final PdfOutline outline, final String name) {
checkWriter();
pdf.addOutline(outline, name);
}
/**
* Gets the root outline.
*
* @return the root outline
*/
public PdfOutline getRootOutline() {
checkWriter();
return pdf.getRootOutline();
}
/**
* Computes the width of the given string taking in account
* the current values of "Character spacing", "Word Spacing"
* and "Horizontal Scaling".
* The additional spacing is not computed for the last character
* of the string.
* @param text the string to get width of
* @param kerned the kerning option
* @return the width
*/
public float getEffectiveStringWidth(final String text, final boolean kerned) {
BaseFont bf = state.fontDetails.getBaseFont();
float w;
if (kerned)
w = bf.getWidthPointKerned(text, state.size);
else
w = bf.getWidthPoint(text, state.size);
if (state.charSpace != 0.0f && text.length() > 1) {
w += state.charSpace * (text.length() -1);
}
if (state.wordSpace != 0.0f && !bf.isVertical()) {
for (int i = 0; i < text.length() -1; i++) {
if (text.charAt(i) == ' ')
w += state.wordSpace;
}
}
if (state.scale != 100.0)
w = w * state.scale / 100.0f;
//System.out.println("String width = " + Float.toString(w));
return w;
}
/**
* Computes the width of the given string taking in account
* the current values of "Character spacing", "Word Spacing"
* and "Horizontal Scaling".
* The spacing for the last character is also computed.
* It also takes into account kerning that can be specified within TJ operator (e.g. [(Hello) 123 (World)] TJ)
* @param text the string to get width of
* @param kerned the kerning option
* @param kerning the kerning option from TJ array
* @return the width
*/
private float getEffectiveStringWidth(final String text, final boolean kerned, final float kerning) {
BaseFont bf = state.fontDetails.getBaseFont();
float w;
if (kerned)
w = bf.getWidthPointKerned(text, state.size);
else
w = bf.getWidthPoint(text, state.size);
if (state.charSpace != 0.0f && text.length() > 0) {
w += state.charSpace * (text.length());
}
if (state.wordSpace != 0.0f && !bf.isVertical()) {
for (int i = 0; i < text.length(); i++) {
if (text.charAt(i) == ' ')
w += state.wordSpace;
}
}
w -= kerning / 1000.f * state.size;
if (state.scale != 100.0)
w = w * state.scale / 100.0f;
return w;
}
/**
* Shows text right, left or center aligned with rotation.
* @param alignment the alignment can be ALIGN_CENTER, ALIGN_RIGHT or ALIGN_LEFT
* @param text the text to show
* @param x the x pivot position
* @param y the y pivot position
* @param rotation the rotation to be applied in degrees counterclockwise
*/
public void showTextAligned(final int alignment, final String text, final float x, final float y, final float rotation) {
showTextAligned(alignment, text, x, y, rotation, false);
}
private void showTextAligned(final int alignment, final String text, float x, float y, final float rotation, final boolean kerned) {
if (state.fontDetails == null)
throw new NullPointerException(MessageLocalization.getComposedMessage("font.and.size.must.be.set.before.writing.any.text"));
if (rotation == 0) {
switch (alignment) {
case ALIGN_CENTER:
x -= getEffectiveStringWidth(text, kerned) / 2;
break;
case ALIGN_RIGHT:
x -= getEffectiveStringWidth(text, kerned);
break;
}
setTextMatrix(x, y);
if (kerned)
showTextKerned(text);
else
showText(text);
}
else {
double alpha = rotation * Math.PI / 180.0;
float cos = (float)Math.cos(alpha);
float sin = (float)Math.sin(alpha);
float len;
switch (alignment) {
case ALIGN_CENTER:
len = getEffectiveStringWidth(text, kerned) / 2;
x -= len * cos;
y -= len * sin;
break;
case ALIGN_RIGHT:
len = getEffectiveStringWidth(text, kerned);
x -= len * cos;
y -= len * sin;
break;
}
setTextMatrix(cos, sin, -sin, cos, x, y);
if (kerned)
showTextKerned(text);
else
showText(text);
setTextMatrix(0f, 0f);
}
}
/**
* Shows text kerned right, left or center aligned with rotation.
* @param alignment the alignment can be ALIGN_CENTER, ALIGN_RIGHT or ALIGN_LEFT
* @param text the text to show
* @param x the x pivot position
* @param y the y pivot position
* @param rotation the rotation to be applied in degrees counterclockwise
*/
public void showTextAlignedKerned(final int alignment, final String text, final float x, final float y, final float rotation) {
showTextAligned(alignment, text, x, y, rotation, true);
}
/**
* Concatenate a matrix to the current transformation matrix.
*
* Common transformations:
*
*
*
*
* @param a an element of the transformation matrix
* @param b an element of the transformation matrix
* @param c an element of the transformation matrix
* @param d an element of the transformation matrix
* @param e an element of the transformation matrix
* @param f an element of the transformation matrix
**/
public void concatCTM(final float a, final float b, final float c, final float d, final float e, final float f) {
if (inText && isTagged()) {
endText();
}
state.CTM.concatenate(new AffineTransform(a, b, c, d, e, f));
content.append(a).append(' ').append(b).append(' ').append(c).append(' ');
content.append(d).append(' ').append(e).append(' ').append(f).append(" cm").append_i(separator);
}
/**
* Concatenate a matrix to the current transformation matrix.
* @param transform added to the Current Transformation Matrix
*/
public void concatCTM(final AffineTransform transform) {
double matrix[] = new double[6];
transform.getMatrix(matrix);
concatCTM((float) matrix[0], (float) matrix[1], (float) matrix[2],
(float) matrix[3], (float) matrix[4], (float) matrix[5]);
}
/**
* Generates an array of bezier curves to draw an arc.
*
*
PdfPatternPainter where the pattern will be created
*/
public PdfPatternPainter createPattern(final float width, final float height, final float xstep, final float ystep) {
checkWriter();
if ( xstep == 0.0f || ystep == 0.0f )
throw new RuntimeException(MessageLocalization.getComposedMessage("xstep.or.ystep.can.not.be.zero"));
PdfPatternPainter painter = new PdfPatternPainter(writer);
painter.setWidth(width);
painter.setHeight(height);
painter.setXStep(xstep);
painter.setYStep(ystep);
writer.addSimplePattern(painter);
return painter;
}
/**
* Create a new colored tiling pattern. Variables xstep and ystep are set to the same values
* of width and height.
* @param width the width of the pattern
* @param height the height of the pattern
* @return the PdfPatternPainter where the pattern will be created
*/
public PdfPatternPainter createPattern(final float width, final float height) {
return createPattern(width, height, width, height);
}
/**
* Create a new uncolored tiling pattern.
*
* @param width the width of the pattern
* @param height the height of the pattern
* @param xstep the desired horizontal spacing between pattern cells.
* May be either positive or negative, but not zero.
* @param ystep the desired vertical spacing between pattern cells.
* May be either positive or negative, but not zero.
* @param color the default color. Can be null
* @return the PdfPatternPainter where the pattern will be created
*/
public PdfPatternPainter createPattern(final float width, final float height, final float xstep, final float ystep, final BaseColor color) {
checkWriter();
if ( xstep == 0.0f || ystep == 0.0f )
throw new RuntimeException(MessageLocalization.getComposedMessage("xstep.or.ystep.can.not.be.zero"));
PdfPatternPainter painter = new PdfPatternPainter(writer, color);
painter.setWidth(width);
painter.setHeight(height);
painter.setXStep(xstep);
painter.setYStep(ystep);
writer.addSimplePattern(painter);
return painter;
}
/**
* Create a new uncolored tiling pattern.
* Variables xstep and ystep are set to the same values
* of width and height.
* @param width the width of the pattern
* @param height the height of the pattern
* @param color the default color. Can be null
* @return the PdfPatternPainter where the pattern will be created
*/
public PdfPatternPainter createPattern(final float width, final float height, final BaseColor color) {
return createPattern(width, height, width, height, color);
}
/**
* Creates a new template.
* PdfContentByte or in another template. Templates are only written
* to the output when the document is closed permitting things like showing text in the first page
* that is only defined in the last page.
*
* @param width the bounding box width
* @param height the bounding box height
* @return the created template
*/
public PdfTemplate createTemplate(final float width, final float height) {
return createTemplate(width, height, null);
}
PdfTemplate createTemplate(final float width, final float height, final PdfName forcedName) {
checkWriter();
PdfTemplate template = new PdfTemplate(writer);
ArrayListcolor can be an
* ExtendedColor.
* @param color the color
*/
public void setColorStroke(final BaseColor color) {
PdfWriter.checkPdfIsoConformance(writer, PdfIsoKeys.PDFISOKEY_COLOR, color);
int type = ExtendedColor.getType(color);
switch (type) {
case ExtendedColor.TYPE_GRAY: {
setGrayStroke(((GrayColor) color).getGray());
break;
}
case ExtendedColor.TYPE_CMYK: {
CMYKColor cmyk = (CMYKColor)color;
setCMYKColorStrokeF(cmyk.getCyan(), cmyk.getMagenta(), cmyk.getYellow(), cmyk.getBlack());
break;
}
case ExtendedColor.TYPE_SEPARATION: {
SpotColor spot = (SpotColor)color;
setColorStroke(spot.getPdfSpotColor(), spot.getTint());
break;
}
case ExtendedColor.TYPE_PATTERN: {
PatternColor pat = (PatternColor) color;
setPatternStroke(pat.getPainter());
break;
}
case ExtendedColor.TYPE_SHADING: {
ShadingColor shading = (ShadingColor) color;
setShadingStroke(shading.getPdfShadingPattern());
break;
}
default:
setRGBColorStroke(color.getRed(), color.getGreen(), color.getBlue());
}
}
/** Sets the fill color. color can be an
* ExtendedColor.
* @param color the color
*/
public void setColorFill(final BaseColor color) {
PdfWriter.checkPdfIsoConformance(writer, PdfIsoKeys.PDFISOKEY_COLOR, color);
int type = ExtendedColor.getType(color);
switch (type) {
case ExtendedColor.TYPE_GRAY: {
setGrayFill(((GrayColor) color).getGray());
break;
}
case ExtendedColor.TYPE_CMYK: {
CMYKColor cmyk = (CMYKColor)color;
setCMYKColorFillF(cmyk.getCyan(), cmyk.getMagenta(), cmyk.getYellow(), cmyk.getBlack());
break;
}
case ExtendedColor.TYPE_SEPARATION: {
SpotColor spot = (SpotColor)color;
setColorFill(spot.getPdfSpotColor(), spot.getTint());
break;
}
case ExtendedColor.TYPE_PATTERN: {
PatternColor pat = (PatternColor) color;
setPatternFill(pat.getPainter());
break;
}
case ExtendedColor.TYPE_SHADING: {
ShadingColor shading = (ShadingColor) color;
setShadingFill(shading.getPdfShadingPattern());
break;
}
default:
setRGBColorFill(color.getRed(), color.getGreen(), color.getBlue());
}
}
/** Sets the fill color to a spot color.
* @param sp the spot color
* @param tint the tint for the spot color. 0 is no color and 1
* is 100% color
*/
public void setColorFill(final PdfSpotColor sp, final float tint) {
checkWriter();
state.colorDetails = writer.addSimple(sp);
PageResources prs = getPageResources();
PdfName name = state.colorDetails.getColorName();
name = prs.addColor(name, state.colorDetails.getIndirectReference());
saveColor(new SpotColor(sp, tint), true);
content.append(name.getBytes()).append(" cs ").append(tint).append(" scn").append_i(separator);
}
/** Sets the stroke color to a spot color.
* @param sp the spot color
* @param tint the tint for the spot color. 0 is no color and 1
* is 100% color
*/
public void setColorStroke(final PdfSpotColor sp, final float tint) {
checkWriter();
state.colorDetails = writer.addSimple(sp);
PageResources prs = getPageResources();
PdfName name = state.colorDetails.getColorName();
name = prs.addColor(name, state.colorDetails.getIndirectReference());
saveColor(new SpotColor(sp, tint), false);
content.append(name.getBytes()).append(" CS ").append(tint).append(" SCN").append_i(separator);
}
/** Sets the fill color to a pattern. The pattern can be
* colored or uncolored.
* @param p the pattern
*/
public void setPatternFill(final PdfPatternPainter p) {
if (p.isStencil()) {
setPatternFill(p, p.getDefaultColor());
return;
}
checkWriter();
PageResources prs = getPageResources();
PdfName name = writer.addSimplePattern(p);
name = prs.addPattern(name, p.getIndirectReference());
saveColor(new PatternColor(p), true);
content.append(PdfName.PATTERN.getBytes()).append(" cs ").append(name.getBytes()).append(" scn").append_i(separator);
}
/** Outputs the color values to the content.
* @param color The color
* @param tint the tint if it is a spot color, ignored otherwise
*/
void outputColorNumbers(final BaseColor color, final float tint) {
PdfWriter.checkPdfIsoConformance(writer, PdfIsoKeys.PDFISOKEY_COLOR, color);
int type = ExtendedColor.getType(color);
switch (type) {
case ExtendedColor.TYPE_RGB:
content.append((float)color.getRed() / 0xFF);
content.append(' ');
content.append((float)color.getGreen() / 0xFF);
content.append(' ');
content.append((float)color.getBlue() / 0xFF);
break;
case ExtendedColor.TYPE_GRAY:
content.append(((GrayColor)color).getGray());
break;
case ExtendedColor.TYPE_CMYK: {
CMYKColor cmyk = (CMYKColor)color;
content.append(cmyk.getCyan()).append(' ').append(cmyk.getMagenta());
content.append(' ').append(cmyk.getYellow()).append(' ').append(cmyk.getBlack());
break;
}
case ExtendedColor.TYPE_SEPARATION:
content.append(tint);
break;
default:
throw new RuntimeException(MessageLocalization.getComposedMessage("invalid.color.type"));
}
}
/** Sets the fill color to an uncolored pattern.
* @param p the pattern
* @param color the color of the pattern
*/
public void setPatternFill(final PdfPatternPainter p, final BaseColor color) {
if (ExtendedColor.getType(color) == ExtendedColor.TYPE_SEPARATION)
setPatternFill(p, color, ((SpotColor)color).getTint());
else
setPatternFill(p, color, 0);
}
/** Sets the fill color to an uncolored pattern.
* @param p the pattern
* @param color the color of the pattern
* @param tint the tint if the color is a spot color, ignored otherwise
*/
public void setPatternFill(final PdfPatternPainter p, final BaseColor color, final float tint) {
checkWriter();
if (!p.isStencil())
throw new RuntimeException(MessageLocalization.getComposedMessage("an.uncolored.pattern.was.expected"));
PageResources prs = getPageResources();
PdfName name = writer.addSimplePattern(p);
name = prs.addPattern(name, p.getIndirectReference());
ColorDetails csDetail = writer.addSimplePatternColorspace(color);
PdfName cName = prs.addColor(csDetail.getColorName(), csDetail.getIndirectReference());
saveColor(new UncoloredPattern(p, color, tint), true);
content.append(cName.getBytes()).append(" cs").append_i(separator);
outputColorNumbers(color, tint);
content.append(' ').append(name.getBytes()).append(" scn").append_i(separator);
}
/** Sets the stroke color to an uncolored pattern.
* @param p the pattern
* @param color the color of the pattern
*/
public void setPatternStroke(final PdfPatternPainter p, final BaseColor color) {
if (ExtendedColor.getType(color) == ExtendedColor.TYPE_SEPARATION)
setPatternStroke(p, color, ((SpotColor)color).getTint());
else
setPatternStroke(p, color, 0);
}
/** Sets the stroke color to an uncolored pattern.
* @param p the pattern
* @param color the color of the pattern
* @param tint the tint if the color is a spot color, ignored otherwise
*/
public void setPatternStroke(final PdfPatternPainter p, final BaseColor color, final float tint) {
checkWriter();
if (!p.isStencil())
throw new RuntimeException(MessageLocalization.getComposedMessage("an.uncolored.pattern.was.expected"));
PageResources prs = getPageResources();
PdfName name = writer.addSimplePattern(p);
name = prs.addPattern(name, p.getIndirectReference());
ColorDetails csDetail = writer.addSimplePatternColorspace(color);
PdfName cName = prs.addColor(csDetail.getColorName(), csDetail.getIndirectReference());
saveColor(new UncoloredPattern(p, color, tint), false);
content.append(cName.getBytes()).append(" CS").append_i(separator);
outputColorNumbers(color, tint);
content.append(' ').append(name.getBytes()).append(" SCN").append_i(separator);
}
/** Sets the stroke color to a pattern. The pattern can be
* colored or uncolored.
* @param p the pattern
*/
public void setPatternStroke(final PdfPatternPainter p) {
if (p.isStencil()) {
setPatternStroke(p, p.getDefaultColor());
return;
}
checkWriter();
PageResources prs = getPageResources();
PdfName name = writer.addSimplePattern(p);
name = prs.addPattern(name, p.getIndirectReference());
saveColor(new PatternColor(p), false);
content.append(PdfName.PATTERN.getBytes()).append(" CS ").append(name.getBytes()).append(" SCN").append_i(separator);
}
/**
* Paints using a shading object.
* @param shading the shading object
*/
public void paintShading(final PdfShading shading) {
writer.addSimpleShading(shading);
PageResources prs = getPageResources();
PdfName name = prs.addShading(shading.getShadingName(), shading.getShadingReference());
content.append(name.getBytes()).append(" sh").append_i(separator);
ColorDetails details = shading.getColorDetails();
if (details != null)
prs.addColor(details.getColorName(), details.getIndirectReference());
}
/**
* Paints using a shading pattern.
* @param shading the shading pattern
*/
public void paintShading(final PdfShadingPattern shading) {
paintShading(shading.getShading());
}
/**
* Sets the shading fill pattern.
* @param shading the shading pattern
*/
public void setShadingFill(final PdfShadingPattern shading) {
writer.addSimpleShadingPattern(shading);
PageResources prs = getPageResources();
PdfName name = prs.addPattern(shading.getPatternName(), shading.getPatternReference());
saveColor(new ShadingColor(shading), true);
content.append(PdfName.PATTERN.getBytes()).append(" cs ").append(name.getBytes()).append(" scn").append_i(separator);
ColorDetails details = shading.getColorDetails();
if (details != null)
prs.addColor(details.getColorName(), details.getIndirectReference());
}
/**
* Sets the shading stroke pattern
* @param shading the shading pattern
*/
public void setShadingStroke(final PdfShadingPattern shading) {
writer.addSimpleShadingPattern(shading);
PageResources prs = getPageResources();
PdfName name = prs.addPattern(shading.getPatternName(), shading.getPatternReference());
saveColor(new ShadingColor(shading), false);
content.append(PdfName.PATTERN.getBytes()).append(" CS ").append(name.getBytes()).append(" SCN").append_i(separator);
ColorDetails details = shading.getColorDetails();
if (details != null)
prs.addColor(details.getColorName(), details.getIndirectReference());
}
/** Check if we have a valid PdfWriter.
*
*/
protected void checkWriter() {
if (writer == null)
throw new NullPointerException(MessageLocalization.getComposedMessage("the.writer.in.pdfcontentbyte.is.null"));
}
/**
* Show an array of text.
* @param text array of text
*/
public void showText(final PdfTextArray text) {
if (!inText && isTagged()) {
beginText(true);
}
if (state.fontDetails == null)
throw new NullPointerException(MessageLocalization.getComposedMessage("font.and.size.must.be.set.before.writing.any.text"));
content.append("[");
ArrayList