Java tutorial
/* * * This file is part of the iText (R) project. Copyright (c) 1998-2019 iText Group NV * Authors: Bruno Lowagie, Paulo Soares, et al. * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License version 3 * as published by the Free Software Foundation with the addition of the * following permission added to Section 15 as permitted in Section 7(a): * FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY * ITEXT GROUP. ITEXT GROUP DISCLAIMS THE WARRANTY OF NON INFRINGEMENT * OF THIRD PARTY RIGHTS * * This program 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 Affero General Public License for more details. * You should have received a copy of the GNU Affero General Public License * along with this program; if not, see http://www.gnu.org/licenses or write to * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA, 02110-1301 USA, or download the license from the following URL: * http://itextpdf.com/terms-of-use/ * * The interactive user interfaces in modified source and object code versions * of this program must display Appropriate Legal Notices, as required under * Section 5 of the GNU Affero General Public License. * * In accordance with Section 7(b) of the GNU Affero General Public License, * a covered work must retain the producer line in every PDF that is created * or manipulated using iText. * * You can be released from the requirements of the license by purchasing * a commercial license. Buying such a license is mandatory as soon as you * develop commercial activities involving the iText software without * disclosing the source code of your own applications. * These activities include: offering paid services to customers as an ASP, * serving PDFs on the fly in a web application, shipping iText with a closed * source product. * * For more information, please contact iText Software Corp. at this * address: sales@itextpdf.com */ package com.itextpdf.text.pdf; import com.itextpdf.text.ExceptionConverter; import com.itextpdf.text.Image; import com.itextpdf.text.Rectangle; import com.itextpdf.text.BaseColor; /** Base class containing properties and methods common to all * barcode types. * * @author Paulo Soares */ 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 coordinates (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, BaseColor barColor, BaseColor 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, BaseColor barColor, BaseColor textColor) */ public PdfTemplate createTemplateWithBarcode(PdfContentByte cb, BaseColor barColor, BaseColor 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, BaseColor barColor, BaseColor textColor) */ public Image createImageWithBarcode(PdfContentByte cb, BaseColor barColor, BaseColor textColor) { try { return Image.getInstance(createTemplateWithBarcode(cb, barColor, textColor)); } catch (Exception e) { throw new ExceptionConverter(e); } } /** 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) { this.inkSpreading = 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; } // AWT related methods (remove this if you port to Android / GAE) /** 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(java.awt.Color foreground, java.awt.Color background); }