Initial import of release 2.2.REL-2.2@923

git-svn-id: https://joinup.ec.europa.eu/svn/pdf-as/trunk@4 7b5415b0-85f9-ee4d-85bd-d5d0c3b42d1c

1 files changed, 477 insertions, 0 deletions

diff --git a/src/main/java/com/lowagie/text/pdf/Barcode.java b/src/main/java/com/lowagie/text/pdf/Barcode.java
new file mode 100644
index 0000000..5eea0dc
--- /dev/null
+++ b/src/main/java/com/lowagie/text/pdf/Barcode.java
@@ -0,0 +1,477 @@
+/*

+ * $Id: Barcode.java,v 1.20 2006/02/09 18:07:56 psoares33 Exp $

+ *

+ * Copyright 2002-2006 by Paulo Soares.

+ *

+ * The contents of this file are subject to the Mozilla Public License Version 1.1

+ * (the "License"); you may not use this file except in compliance with the License.

+ * You may obtain a copy of the License at http://www.mozilla.org/MPL/

+ *

+ * Software distributed under the License is distributed on an "AS IS" basis,

+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License

+ * for the specific language governing rights and limitations under the License.

+ *

+ * The Original Code is 'iText, a free JAVA-PDF library'.

+ *

+ * The Initial Developer of the Original Code is Bruno Lowagie. Portions created by

+ * the Initial Developer are Copyright (C) 1999, 2000, 2001, 2002 by Bruno Lowagie.

+ * All Rights Reserved.

+ * Co-Developer of the code is Paulo Soares. Portions created by the Co-Developer

+ * are Copyright (C) 2000, 2001, 2002 by Paulo Soares. All Rights Reserved.

+ *

+ * Contributor(s): all the names of the contributors are added in the source code

+ * where applicable.

+ *

+ * Alternatively, the contents of this file may be used under the terms of the

+ * LGPL license (the "GNU LIBRARY GENERAL PUBLIC LICENSE"), in which case the

+ * provisions of LGPL are applicable instead of those above.  If you wish to

+ * allow use of your version of this file only under the terms of the LGPL

+ * License and not to allow others to use your version of this file under

+ * the MPL, indicate your decision by deleting the provisions above and

+ * replace them with the notice and other provisions required by the LGPL.

+ * If you do not delete the provisions above, a recipient may use your version

+ * of this file under either the MPL or the GNU LIBRARY GENERAL PUBLIC LICENSE.

+ *

+ * This library is free software; you can redistribute it and/or modify it

+ * under the terms of the MPL as stated above or under the terms of the GNU

+ * Library General Public License as published by the Free Software Foundation;

+ * either version 2 of the License, or any later version.

+ *

+ * This library is distributed in the hope that it will be useful, but WITHOUT

+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS

+ * FOR A PARTICULAR PURPOSE. See the GNU Library general Public License for more

+ * details.

+ *

+ * If you didn't download this code from the following link, you should check if

+ * you aren't using an obsolete version:

+ * http://www.lowagie.com/iText/

+ */

+package com.lowagie.text.pdf;

+

+import com.lowagie.text.ExceptionConverter;

+import com.lowagie.text.Rectangle;

+import com.lowagie.text.Image;

+import java.awt.Color;

+/** Base class containing properties and methods commom to all

+ * barcode types.

+ *

+ * @author Paulo Soares (psoares@consiste.pt)

+ */

+public abstract class Barcode {

+    /** A type of barcode */

+    public static final int EAN13 = 1;

+    /** A type of barcode */

+    public static final int EAN8 = 2;

+    /** A type of barcode */

+    public static final int UPCA = 3;

+    /** A type of barcode */

+    public static final int UPCE = 4;

+    /** A type of barcode */

+    public static final int SUPP2 = 5;

+    /** A type of barcode */

+    public static final int SUPP5 = 6;

+    /** A type of barcode */

+    public static final int POSTNET = 7;

+    /** A type of barcode */

+    public static final int PLANET = 8;

+    /** A type of barcode */

+    public static final int CODE128 = 9;

+    /** A type of barcode */

+    public static final int CODE128_UCC = 10;

+    /** A type of barcode */

+    public static final int CODE128_RAW = 11;

+    /** A type of barcode */

+    public static final int CODABAR = 12;

+

+    /** The minimum bar width.

+     */

+    protected float x;    

+

+    /** The bar multiplier for wide bars or the distance between

+     * bars for Postnet and Planet.

+     */

+    protected float n;

+    

+    /** The text font. <CODE>null</CODE> if no text.

+     */

+    protected BaseFont font;

+

+    /** The size of the text or the height of the shorter bar

+     * in Postnet.

+     */    

+    protected float size;

+    

+    /** If positive, the text distance under the bars. If zero or negative,

+     * the text distance above the bars.

+     */

+    protected float baseline;

+    

+    /** The height of the bars.

+     */

+    protected float barHeight;

+    

+    /** The text alignment. Can be <CODE>Element.ALIGN_LEFT</CODE>,

+     * <CODE>Element.ALIGN_CENTER</CODE> or <CODE>Element.ALIGN_RIGHT</CODE>.

+     */

+    protected int textAlignment;

+    

+    /** The optional checksum generation.

+     */

+    protected boolean generateChecksum;

+    

+    /** Shows the generated checksum in the the text.

+     */

+    protected boolean checksumText;

+    

+    /** Show the start and stop character '*' in the text for

+     * the barcode 39 or 'ABCD' for codabar.

+     */

+    protected boolean startStopText;

+    

+    /** Generates extended barcode 39.

+     */

+    protected boolean extended;

+    

+    /** The code to generate.

+     */

+    protected String code = "";

+    

+    /** Show the guard bars for barcode EAN.

+     */

+    protected boolean guardBars;

+    

+    /** The code type.

+     */

+    protected int codeType;

+    

+    /** The ink spreading. */

+    protected float inkSpreading = 0;

+    

+    /** Gets the minimum bar width.

+     * @return the minimum bar width

+     */

+    public float getX() {

+        return x;

+    }

+    

+    /** Sets the minimum bar width.

+     * @param x the minimum bar width

+     */

+    public void setX(float x) {

+        this.x = x;

+    }

+    

+    /** Gets the bar multiplier for wide bars.

+     * @return the bar multiplier for wide bars

+     */

+    public float getN() {

+        return n;

+    }

+    

+    /** Sets the bar multiplier for wide bars.

+     * @param n the bar multiplier for wide bars

+     */

+    public void setN(float n) {

+        this.n = n;

+    }

+    

+    /** Gets the text font. <CODE>null</CODE> if no text.

+     * @return the text font. <CODE>null</CODE> if no text

+     */

+    public BaseFont getFont() {

+        return font;

+    }

+    

+    /** Sets the text font.

+     * @param font the text font. Set to <CODE>null</CODE> to suppress any text

+     */

+    public void setFont(BaseFont font) {

+        this.font = font;

+    }

+    

+    /** Gets the size of the text.

+     * @return the size of the text

+     */

+    public float getSize() {

+        return size;

+    }

+    

+    /** Sets the size of the text.

+     * @param size the size of the text

+     */

+    public void setSize(float size) {

+        this.size = size;

+    }

+    

+    /** Gets the text baseline.

+     * If positive, the text distance under the bars. If zero or negative,

+     * the text distance above the bars.

+     * @return the baseline.

+     */

+    public float getBaseline() {

+        return baseline;

+    }

+    

+    /** Sets the text baseline. 

+     * If positive, the text distance under the bars. If zero or negative,

+     * the text distance above the bars.

+     * @param baseline the baseline.

+     */

+    public void setBaseline(float baseline) {

+        this.baseline = baseline;

+    }

+    

+    /** Gets the height of the bars.

+     * @return the height of the bars

+     */

+    public float getBarHeight() {

+        return barHeight;

+    }

+    

+    /** Sets the height of the bars.

+     * @param barHeight the height of the bars

+     */

+    public void setBarHeight(float barHeight) {

+        this.barHeight = barHeight;

+    }

+    

+    /** Gets the text alignment. Can be <CODE>Element.ALIGN_LEFT</CODE>,

+     * <CODE>Element.ALIGN_CENTER</CODE> or <CODE>Element.ALIGN_RIGHT</CODE>.

+     * @return the text alignment

+     */

+    public int getTextAlignment() {

+        return textAlignment;

+    }

+    

+    /** Sets the text alignment. Can be <CODE>Element.ALIGN_LEFT</CODE>,

+     * <CODE>Element.ALIGN_CENTER</CODE> or <CODE>Element.ALIGN_RIGHT</CODE>.

+     * @param textAlignment the text alignment

+     */

+    public void setTextAlignment(int textAlignment) {

+        this.textAlignment = textAlignment;

+    }

+    

+    /** Gets the optional checksum generation.

+     * @return the optional checksum generation

+     */

+    public boolean isGenerateChecksum() {

+        return generateChecksum;

+    }

+    

+    /** Setter for property generateChecksum.

+     * @param generateChecksum New value of property generateChecksum.

+     */

+    public void setGenerateChecksum(boolean generateChecksum) {

+        this.generateChecksum = generateChecksum;

+    }

+    

+    /** Gets the property to show the generated checksum in the the text.

+     * @return value of property checksumText

+     */

+    public boolean isChecksumText() {

+        return checksumText;

+    }

+    

+    /** Sets the property to show the generated checksum in the the text.

+     * @param checksumText new value of property checksumText

+     */

+    public void setChecksumText(boolean checksumText) {

+        this.checksumText = checksumText;

+    }

+    

+    /** Sets the property to show the start and stop character '*' in the text for

+     * the barcode 39.

+     * @return value of property startStopText

+     */

+    public boolean isStartStopText() {

+        return startStopText;

+    }

+    

+    /** Gets the property to show the start and stop character '*' in the text for

+     * the barcode 39.

+     * @param startStopText new value of property startStopText

+     */

+    public void setStartStopText(boolean startStopText) {

+        this.startStopText = startStopText;

+    }

+    

+    /** Gets the property to generate extended barcode 39.

+     * @return value of property extended.

+     */

+    public boolean isExtended() {

+        return extended;

+    }

+    

+    /** Sets the property to generate extended barcode 39.

+     * @param extended new value of property extended

+     */

+    public void setExtended(boolean extended) {

+        this.extended = extended;

+    }

+    

+    /** Gets the code to generate.

+     * @return the code to generate

+     */

+    public String getCode() {

+        return code;

+    }

+    

+    /** Sets the code to generate.

+     * @param code the code to generate

+     */

+    public void setCode(String code) {

+        this.code = code;

+    }

+    

+    /** Gets the property to show the guard bars for barcode EAN.

+     * @return value of property guardBars

+     */

+    public boolean isGuardBars() {

+        return guardBars;

+    }

+    

+    /** Sets the property to show the guard bars for barcode EAN.

+     * @param guardBars new value of property guardBars

+     */

+    public void setGuardBars(boolean guardBars) {

+        this.guardBars = guardBars;

+    }

+    

+    /** Gets the code type.

+     * @return the code type

+     */

+    public int getCodeType() {

+        return codeType;

+    }

+    

+    /** Sets the code type.

+     * @param codeType the code type

+     */

+    public void setCodeType(int codeType) {

+        this.codeType = codeType;

+    }

+    

+    /** Gets the maximum area that the barcode and the text, if

+     * any, will occupy. The lower left corner is always (0, 0).

+     * @return the size the barcode occupies.

+     */    

+    public abstract Rectangle getBarcodeSize();

+    

+    /** Places the barcode in a <CODE>PdfContentByte</CODE>. The

+     * barcode is always placed at coodinates (0, 0). Use the

+     * translation matrix to move it elsewhere.<p>

+     * The bars and text are written in the following colors:<p>

+     * <P><TABLE BORDER=1>

+     * <TR>

+     *    <TH><P><CODE>barColor</CODE></TH>

+     *    <TH><P><CODE>textColor</CODE></TH>

+     *    <TH><P>Result</TH>

+     *    </TR>

+     * <TR>

+     *    <TD><P><CODE>null</CODE></TD>

+     *    <TD><P><CODE>null</CODE></TD>

+     *    <TD><P>bars and text painted with current fill color</TD>

+     *    </TR>

+     * <TR>

+     *    <TD><P><CODE>barColor</CODE></TD>

+     *    <TD><P><CODE>null</CODE></TD>

+     *    <TD><P>bars and text painted with <CODE>barColor</CODE></TD>

+     *    </TR>

+     * <TR>

+     *    <TD><P><CODE>null</CODE></TD>

+     *    <TD><P><CODE>textColor</CODE></TD>

+     *    <TD><P>bars painted with current color<br>text painted with <CODE>textColor</CODE></TD>

+     *    </TR>

+     * <TR>

+     *    <TD><P><CODE>barColor</CODE></TD>

+     *    <TD><P><CODE>textColor</CODE></TD>

+     *    <TD><P>bars painted with <CODE>barColor</CODE><br>text painted with <CODE>textColor</CODE></TD>

+     *    </TR>

+     * </TABLE>

+     * @param cb the <CODE>PdfContentByte</CODE> where the barcode will be placed

+     * @param barColor the color of the bars. It can be <CODE>null</CODE>

+     * @param textColor the color of the text. It can be <CODE>null</CODE>

+     * @return the dimensions the barcode occupies

+     */    

+    public abstract Rectangle placeBarcode(PdfContentByte cb, Color barColor, Color textColor);

+    

+    /** Creates a template with the barcode.

+     * @param cb the <CODE>PdfContentByte</CODE> to create the template. It

+     * serves no other use

+     * @param barColor the color of the bars. It can be <CODE>null</CODE>

+     * @param textColor the color of the text. It can be <CODE>null</CODE>

+     * @return the template

+     * @see #placeBarcode(PdfContentByte cb, Color barColor, Color textColor)

+     */    

+    public PdfTemplate createTemplateWithBarcode(PdfContentByte cb, Color barColor, Color textColor) {

+        PdfTemplate tp = cb.createTemplate(0, 0);

+        Rectangle rect = placeBarcode(tp, barColor, textColor);

+        tp.setBoundingBox(rect);

+        return tp;

+    }

+    

+    /** Creates an <CODE>Image</CODE> with the barcode.

+     * @param cb the <CODE>PdfContentByte</CODE> to create the <CODE>Image</CODE>. It

+     * serves no other use

+     * @param barColor the color of the bars. It can be <CODE>null</CODE>

+     * @param textColor the color of the text. It can be <CODE>null</CODE>

+     * @return the <CODE>Image</CODE>

+     * @see #placeBarcode(PdfContentByte cb, Color barColor, Color textColor)

+     */    

+    public Image createImageWithBarcode(PdfContentByte cb, Color barColor, Color textColor) {

+        try {

+            return Image.getInstance(createTemplateWithBarcode(cb, barColor, textColor));

+        }

+        catch (Exception e) {

+            throw new ExceptionConverter(e);

+        }

+    }

+    

+    /** Creates a <CODE>java.awt.Image</CODE>. This image only

+     * contains the bars without any text.

+     * @param foreground the color of the bars

+     * @param background the color of the background

+     * @return the image

+     */    

+    public abstract java.awt.Image createAwtImage(Color foreground, Color background);

+    

+    /** Gets the amount of ink spreading.

+     * @return the ink spreading

+     *

+     */

+    public float getInkSpreading() {

+        return this.inkSpreading;

+    }

+    

+    /** Sets the amount of ink spreading. This value will be subtracted

+     * to the width of each bar. The actual value will depend on the ink

+     * and the printing medium.

+     * @param inkSpreading the ink spreading

+     *

+     */

+    public void setInkSpreading(float inkSpreading) {

+    }

+

+    /**

+     * The alternate text to be used, if present.

+     */

+    protected String altText;

+

+    /**

+     * Gets the alternate text.

+     * @return the alternate text

+     */

+    public String getAltText() {

+        return this.altText;

+    }

+

+    /**

+     * Sets the alternate text. If present, this text will be used instead of the

+     * text derived from the supplied code.

+     * @param altText the alternate text

+     */

+    public void setAltText(String altText) {

+        this.altText = altText;

+    }

+    

+}