BarcodePDF417 (iText 7 7.1.2 API)

java.lang.Object
- com.itextpdf.barcodes.Barcode2D
- - com.itextpdf.barcodes.BarcodePDF417

public class BarcodePDF417
extends Barcode2D

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`BarcodePDF417.Segment`
`protected static class`	`BarcodePDF417.SegmentList`

Field Summary

Fields
Modifier and Type	Field and Description
`protected static int`	`ABSOLUTE_MAX_TEXT_SIZE`
`protected static int`	`AL`
`protected static int`	`ALPHA`
`protected static int`	`AS`
`protected int`	`bitPtr`
`protected static int`	`BYTE_MODE`
`protected static int`	`BYTE_MODE_6`
`protected static int`	`BYTESHIFT`
`protected int`	`cwPtr`
`protected static float`	`DEFAUL_MODULE_HEIGHT`
`protected static float`	`DEFAUL_MODULE_WIDTH`
`protected static int`	`ISBYTE`
`protected static int`	`LL`
`protected static int`	`LOWER`
`protected static int`	`MACRO_LAST_SEGMENT`
`protected static int`	`MACRO_SEGMENT_ID`
`protected static int`	`MAX_DATA_CODEWORDS`
`protected static int`	`MIXED`
`protected static int`	`ML`
`protected static int`	`MOD`
`protected static int`	`NUMERIC_MODE`
`protected static int`	`PAL`
`static int`	`PDF417_AUTO_ERROR_LEVEL` The error level correction is set automatically according to ISO 15438 recommendations.
`static int`	`PDF417_FIXED_COLUMNS` The size will be at least `codeColumns` with a variable number of `codeRows`.
`static int`	`PDF417_FIXED_RECTANGLE` The size of the barcode will be at least `codeColumns*codeRows`.
`static int`	`PDF417_FIXED_ROWS` The size will be at least `codeRows` with a variable number of `codeColumns`.
`static int`	`PDF417_FORCE_BINARY` One single binary segment is used
`static int`	`PDF417_INVERT_BITMAP` Inverts the output bits of the raw bitmap that is normally bit one for black.
`static int`	`PDF417_USE_ASPECT_RATIO` Auto-size is made based on `aspectRatio` and `yHeight`.
`static int`	`PDF417_USE_ERROR_LEVEL` The error level correction is set by the user.
`static int`	`PDF417_USE_MACRO` Use Macro PDF417 Encoding
`static int`	`PDF417_USE_RAW_CODEWORDS` No `text` interpretation is done and the content of `codewords` is used directly.
`protected static int`	`PL`
`protected static int`	`PS`
`protected static int`	`PUNCTUATION`
`protected BarcodePDF417.SegmentList`	`segmentList`
`protected static int`	`SPACE`
`protected static int`	`START_CODE_SIZE`
`protected static int`	`START_PATTERN`
`protected static int`	`STOP_PATTERN`
`protected static int`	`STOP_SIZE`
`protected static int`	`TEXT_MODE`

Fields inherited from class com.itextpdf.barcodes.Barcode2D
DEFAULT_MODULE_SIZE

Constructor Summary

Constructors
Constructor and Description
`BarcodePDF417()` Creates a new `BarcodePDF417` with the default settings.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`assemble()`
`protected void`	`basicNumberCompaction(int start, int length)`
`protected void`	`byteCompaction6(int start)`
`protected void`	`calculateErrorCorrection(int dest)`
`protected boolean`	`checkSegmentType(BarcodePDF417.Segment segment, char type)`
`Image`	`createAwtImage(Color foreground, Color background)` Creates a `java.awt.Image`.
`PdfFormXObject`	`createFormXObject(Color foreground, float moduleWidth, float moduleHeight, PdfDocument document)` Creates a PdfFormXObject with the barcode with given module width and module height.
`PdfFormXObject`	`createFormXObject(Color foreground, PdfDocument document)` Creates a PdfFormXObject with the barcode.
`protected void`	`dumpList()`
`float`	`getAspectRatio()` Gets the barcode aspect ratio.
`Rectangle`	`getBarcodeSize()` Gets the maximum area that the barcode and the text, if any, will occupy.
`int`	`getBitColumns()` Gets the number of X pixels of `outBits`.
`byte[]`	`getCode()` Gets the bytes that form the barcode.
`int`	`getCodeColumns()` Gets the number of barcode data columns.
`int`	`getCodeRows()` Gets the number of Y pixels of `outBits`.
`int[]`	`getCodewords()` Gets the codeword array.
`int`	`getErrorLevel()` Gets the error level correction used for the barcode.
`int`	`getLenCodewords()` Gets the length of the codewords.
`protected int`	`getMaxSquare()`
`int`	`getOptions()` Gets the options to generate the barcode.
`byte[]`	`getOutBits()` Gets the raw image bits of the barcode.
`protected int`	`getSegmentLength(BarcodePDF417.Segment segment)`
`protected int`	`getTextTypeAndValue(int maxLength, int idx)`
`float`	`getYHeight()` Gets the Y pixel height relative to X.
`protected static int`	`maxPossibleErrorLevel(int remain)`
`protected void`	`numberCompaction(int start, int length)`
`protected void`	`outCodeword(int codeword)`
`protected void`	`outCodeword17(int codeword)`
`protected void`	`outCodeword18(int codeword)`
`protected void`	`outPaintCode()`
`protected void`	`outStartPattern()`
`protected void`	`outStopPattern()`
`void`	`paintCode()` Paints the barcode.
`Rectangle`	`placeBarcode(PdfCanvas canvas, Color foreground)` Places the barcode in a `PdfCanvas`.
`Rectangle`	`placeBarcode(PdfCanvas canvas, Color foreground, float moduleWidth, float moduleHeight)`
`void`	`setAspectRatio(float aspectRatio)` Sets the barcode aspect ratio.
`void`	`setCode(byte[] code)` Sets the bytes that form the barcode.
`void`	`setCode(String text)` Sets the code that will form the barcode.
`void`	`setCodeColumns(int codeColumns)` Sets the number of barcode data columns.
`void`	`setCodeRows(int codeRows)` Sets the number of barcode rows.
`void`	`setDefaultParameters()` Set the default settings that correspond to `PDF417_USE_ASPECT_RATIO` and `PDF417_AUTO_ERROR_LEVEL`.
`void`	`setErrorLevel(int errorLevel)` Sets the error level correction for the barcode.
`void`	`setLenCodewords(int lenCodewords)` Sets the length of the codewords.
`void`	`setMacroFileId(String id)` Sets the File ID for macro PDF417 encoding
`void`	`setMacroSegmentCount(int cnt)` Sets the segment count for macro PDF417 encoding
`void`	`setMacroSegmentId(int id)` Sets the segment id for macro PDF417 encoding
`void`	`setOptions(int options)` Sets the options to generate the barcode.
`void`	`setYHeight(float yHeight)` Sets the Y pixel height relative to X.
`protected void`	`textCompaction(int start, int length)`

Methods inherited from class com.itextpdf.barcodes.Barcode2D
createFormXObject

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - PDF417_USE_ASPECT_RATIO
```
public static final int PDF417_USE_ASPECT_RATIO
```
    Auto-size is made based on aspectRatio and yHeight.
    
    See Also:
    
    Constant Field Values
  - PDF417_FIXED_RECTANGLE
```
public static final int PDF417_FIXED_RECTANGLE
```
    The size of the barcode will be at least codeColumns*codeRows.
    
    See Also:
    
    Constant Field Values
  - PDF417_FIXED_COLUMNS
```
public static final int PDF417_FIXED_COLUMNS
```
    The size will be at least codeColumns with a variable number of codeRows.
    
    See Also:
    
    Constant Field Values
  - PDF417_FIXED_ROWS
```
public static final int PDF417_FIXED_ROWS
```
    The size will be at least codeRows with a variable number of codeColumns.
    
    See Also:
    
    Constant Field Values
  - PDF417_AUTO_ERROR_LEVEL
```
public static final int PDF417_AUTO_ERROR_LEVEL
```
    The error level correction is set automatically according to ISO 15438 recommendations.
    
    See Also:
    
    Constant Field Values
  - PDF417_USE_ERROR_LEVEL
```
public static final int PDF417_USE_ERROR_LEVEL
```
    The error level correction is set by the user. It can be 0 to 8.
    
    See Also:
    
    Constant Field Values
  - PDF417_FORCE_BINARY
```
public static final int PDF417_FORCE_BINARY
```
    One single binary segment is used
    
    See Also:
    
    Constant Field Values
  - PDF417_USE_RAW_CODEWORDS
```
public static final int PDF417_USE_RAW_CODEWORDS
```
    No text interpretation is done and the content of codewords is used directly.
    
    See Also:
    
    Constant Field Values
  - PDF417_INVERT_BITMAP
```
public static final int PDF417_INVERT_BITMAP
```
    Inverts the output bits of the raw bitmap that is normally bit one for black. It has only effect for the raw bitmap.
    
    See Also:
    
    Constant Field Values
  - PDF417_USE_MACRO
```
public static final int PDF417_USE_MACRO
```
    Use Macro PDF417 Encoding
    
    See Also:
    
    setMacroFileId(String), setMacroSegmentId(int), setMacroSegmentCount(int), Constant Field Values
  - START_PATTERN
```
protected static final int START_PATTERN
```
    See Also:
    
    Constant Field Values
  - STOP_PATTERN
```
protected static final int STOP_PATTERN
```
    See Also:
    
    Constant Field Values
  - START_CODE_SIZE
```
protected static final int START_CODE_SIZE
```
    See Also:
    
    Constant Field Values
  - STOP_SIZE
```
protected static final int STOP_SIZE
```
    See Also:
    
    Constant Field Values
  - MOD
```
protected static final int MOD
```
    See Also:
    
    Constant Field Values
  - ALPHA
```
protected static final int ALPHA
```
    See Also:
    
    Constant Field Values
  - LOWER
```
protected static final int LOWER
```
    See Also:
    
    Constant Field Values
  - MIXED
```
protected static final int MIXED
```
    See Also:
    
    Constant Field Values
  - PUNCTUATION
```
protected static final int PUNCTUATION
```
    See Also:
    
    Constant Field Values
  - ISBYTE
```
protected static final int ISBYTE
```
    See Also:
    
    Constant Field Values
  - BYTESHIFT
```
protected static final int BYTESHIFT
```
    See Also:
    
    Constant Field Values
  - PL
```
protected static final int PL
```
    See Also:
    
    Constant Field Values
  - LL
```
protected static final int LL
```
    See Also:
    
    Constant Field Values
  - AS
```
protected static final int AS
```
    See Also:
    
    Constant Field Values
  - ML
```
protected static final int ML
```
    See Also:
    
    Constant Field Values
  - AL
```
protected static final int AL
```
    See Also:
    
    Constant Field Values
  - PS
```
protected static final int PS
```
    See Also:
    
    Constant Field Values
  - PAL
```
protected static final int PAL
```
    See Also:
    
    Constant Field Values
  - SPACE
```
protected static final int SPACE
```
    See Also:
    
    Constant Field Values
  - TEXT_MODE
```
protected static final int TEXT_MODE
```
    See Also:
    
    Constant Field Values
  - BYTE_MODE_6
```
protected static final int BYTE_MODE_6
```
    See Also:
    
    Constant Field Values
  - BYTE_MODE
```
protected static final int BYTE_MODE
```
    See Also:
    
    Constant Field Values
  - NUMERIC_MODE
```
protected static final int NUMERIC_MODE
```
    See Also:
    
    Constant Field Values
  - ABSOLUTE_MAX_TEXT_SIZE
```
protected static final int ABSOLUTE_MAX_TEXT_SIZE
```
    See Also:
    
    Constant Field Values
  - MAX_DATA_CODEWORDS
```
protected static final int MAX_DATA_CODEWORDS
```
    See Also:
    
    Constant Field Values
  - MACRO_SEGMENT_ID
```
protected static final int MACRO_SEGMENT_ID
```
    See Also:
    
    Constant Field Values
  - MACRO_LAST_SEGMENT
```
protected static final int MACRO_LAST_SEGMENT
```
    See Also:
    
    Constant Field Values
  - DEFAUL_MODULE_WIDTH
```
protected static final float DEFAUL_MODULE_WIDTH
```
    See Also:
    
    Constant Field Values
  - DEFAUL_MODULE_HEIGHT
```
protected static final float DEFAUL_MODULE_HEIGHT
```
    See Also:
    
    Constant Field Values
  - bitPtr
```
protected int bitPtr
```
  - cwPtr
```
protected int cwPtr
```
  - segmentList
```
protected BarcodePDF417.SegmentList segmentList
```
- Constructor Detail
  - BarcodePDF417
```
public BarcodePDF417()
```
    Creates a new BarcodePDF417 with the default settings.
- Method Detail
  - setMacroSegmentId
```
public void setMacroSegmentId(int id)
```
    Sets the segment id for macro PDF417 encoding
    
    Parameters:
    
    id - the id (starting at 0)
    
    See Also:
    
    setMacroSegmentCount(int)
  - setMacroSegmentCount
```
public void setMacroSegmentCount(int cnt)
```
    Sets the segment count for macro PDF417 encoding
    
    Parameters:
    
    cnt - the number of macro segments
    
    See Also:
    
    setMacroSegmentId(int)
  - setMacroFileId
```
public void setMacroFileId(String id)
```
    Sets the File ID for macro PDF417 encoding
    
    Parameters:
    
    id - the file id
  - setDefaultParameters
```
public void setDefaultParameters()
```
    Set the default settings that correspond to PDF417_USE_ASPECT_RATIO and PDF417_AUTO_ERROR_LEVEL.
  - getBarcodeSize
```
public Rectangle getBarcodeSize()
```
    Description copied from class: Barcode2D
    
    Gets the maximum area that the barcode and the text, if any, will occupy. The lower left corner is always (0, 0).
    
    Specified by:
    
    getBarcodeSize in class Barcode2D
    
    Returns:
    
    the size the barcode occupies.
  - placeBarcode
```
public Rectangle placeBarcode(PdfCanvas canvas,
                              Color foreground)
```
    Description copied from class: Barcode2D
    
    Places the barcode in a PdfCanvas. The barcode is always placed at coordinates (0, 0). Use the translation matrix to move it elsewhere.
    
    Specified by:
    
    placeBarcode in class Barcode2D
    
    Parameters:
    
    canvas - the PdfCanvas where the barcode will be placed
    
    foreground - the foreground color. It can be null
    
    Returns:
    
    the dimensions the barcode occupies
  - placeBarcode
```
public Rectangle placeBarcode(PdfCanvas canvas,
                              Color foreground,
                              float moduleWidth,
                              float moduleHeight)
```
  - paintCode
```
public void paintCode()
```
    Paints the barcode. If no exception was thrown a valid barcode is available.
  - createFormXObject
```
public PdfFormXObject createFormXObject(Color foreground,
                                        PdfDocument document)
```
    Creates a PdfFormXObject with the barcode.
    
    Specified by:
    
    createFormXObject in class Barcode2D
    
    Parameters:
    
    foreground - the color of the pixels. It can be null
    
    document - The document
    
    Returns:
    
    the XObject.
  - createFormXObject
```
public PdfFormXObject createFormXObject(Color foreground,
                                        float moduleWidth,
                                        float moduleHeight,
                                        PdfDocument document)
```
    Creates a PdfFormXObject with the barcode with given module width and module height.
    
    Parameters:
    
    foreground - The color of the pixels. It can be null
    
    moduleWidth - The width of the pixels.
    
    moduleHeight - The height of the pixels.
    
    document - The document
    
    Returns:
    
    the XObject.
  - createAwtImage
```
public Image createAwtImage(Color foreground,
                            Color background)
```
    Creates a java.awt.Image.
    
    Parameters:
    
    foreground - the color of the bars
    
    background - the color of the background
    
    Returns:
    
    the image
  - getOutBits
```
public byte[] getOutBits()
```
    Gets the raw image bits of the barcode. The image will have to be scaled in the Y direction by yHeight.
    
    Returns:
    
    The raw barcode image
  - getBitColumns
```
public int getBitColumns()
```
    Gets the number of X pixels of outBits.
    
    Returns:
    
    the number of X pixels of outBits
  - getCodeRows
```
public int getCodeRows()
```
    Gets the number of Y pixels of outBits. It is also the number of rows in the barcode.
    
    Returns:
    
    the number of Y pixels of outBits
  - setCodeRows
```
public void setCodeRows(int codeRows)
```
    Sets the number of barcode rows. This number may be changed to keep the barcode valid.
    
    Parameters:
    
    codeRows - the number of barcode rows
  - getCodeColumns
```
public int getCodeColumns()
```
    Gets the number of barcode data columns.
    
    Returns:
    
    he number of barcode data columns
  - setCodeColumns
```
public void setCodeColumns(int codeColumns)
```
    Sets the number of barcode data columns. This number may be changed to keep the barcode valid.
    
    Parameters:
    
    codeColumns - the number of barcode data columns
  - getCodewords
```
public int[] getCodewords()
```
    Gets the codeword array. This array is always 928 elements long. It can be written to if the option PDF417_USE_RAW_CODEWORDS is set.
    
    Returns:
    
    the codeword array
  - getLenCodewords
```
public int getLenCodewords()
```
    Gets the length of the codewords.
    
    Returns:
    
    the length of the codewords
  - setLenCodewords
```
public void setLenCodewords(int lenCodewords)
```
    Sets the length of the codewords.
    
    Parameters:
    
    lenCodewords - the length of the codewords
  - getErrorLevel
```
public int getErrorLevel()
```
    Gets the error level correction used for the barcode. It may different from the previously set value.
    
    Returns:
    
    the error level correction used for the barcode
  - setErrorLevel
```
public void setErrorLevel(int errorLevel)
```
    Sets the error level correction for the barcode.
    
    Parameters:
    
    errorLevel - the error level correction for the barcode
  - getCode
```
public byte[] getCode()
```
    Gets the bytes that form the barcode. This bytes should be interpreted in the codepage Cp437.
    
    Returns:
    
    the bytes that form the barcode
  - setCode
```
public void setCode(byte[] code)
```
    Sets the bytes that form the barcode. This bytes should be interpreted in the codepage Cp437.
    
    Parameters:
    
    code - the bytes that form the barcode
  - setCode
```
public void setCode(String text)
```
    Sets the code that will form the barcode. This text is converted to bytes using the encoding Cp437.
    
    Parameters:
    
    text - the text that will form the barcode
  - getOptions
```
public int getOptions()
```
    Gets the options to generate the barcode.
    
    Returns:
    
    the options to generate the barcode
  - setOptions
```
public void setOptions(int options)
```
    Sets the options to generate the barcode. This can be all the PDF417_* constants.
    
    Parameters:
    
    options - the options to generate the barcode
  - getAspectRatio
```
public float getAspectRatio()
```
    Gets the barcode aspect ratio.
    
    Returns:
    
    the barcode aspect ratio
  - setAspectRatio
```
public void setAspectRatio(float aspectRatio)
```
    Sets the barcode aspect ratio. A ratio or 0.5 will make the barcode width twice as large as the height.
    
    Parameters:
    
    aspectRatio - the barcode aspect ratio
  - getYHeight
```
public float getYHeight()
```
    Gets the Y pixel height relative to X.
    
    Returns:
    
    the Y pixel height relative to X
  - setYHeight
```
public void setYHeight(float yHeight)
```
    Sets the Y pixel height relative to X. It is usually 3.
    
    Parameters:
    
    yHeight - the Y pixel height relative to X
  - outCodeword17
```
protected void outCodeword17(int codeword)
```
  - outCodeword18
```
protected void outCodeword18(int codeword)
```
  - outCodeword
```
protected void outCodeword(int codeword)
```
  - outStopPattern
```
protected void outStopPattern()
```
  - outStartPattern
```
protected void outStartPattern()
```
  - outPaintCode
```
protected void outPaintCode()
```
  - calculateErrorCorrection
```
protected void calculateErrorCorrection(int dest)
```
  - textCompaction
```
protected void textCompaction(int start,
                              int length)
```
  - basicNumberCompaction
```
protected void basicNumberCompaction(int start,
                                     int length)
```
  - getTextTypeAndValue
```
protected int getTextTypeAndValue(int maxLength,
                                  int idx)
```
  - checkSegmentType
```
protected boolean checkSegmentType(BarcodePDF417.Segment segment,
                                   char type)
```
  - getSegmentLength
```
protected int getSegmentLength(BarcodePDF417.Segment segment)
```
  - numberCompaction
```
protected void numberCompaction(int start,
                                int length)
```
  - byteCompaction6
```
protected void byteCompaction6(int start)
```
  - assemble
```
protected void assemble()
```
  - maxPossibleErrorLevel
```
protected static int maxPossibleErrorLevel(int remain)
```
  - dumpList
```
protected void dumpList()
```
  - getMaxSquare
```
protected int getMaxSquare()
```

Class BarcodePDF417

Nested Class Summary

Field Summary

Fields inherited from class com.itextpdf.barcodes.Barcode2D

Constructor Summary

Method Summary

Methods inherited from class com.itextpdf.barcodes.Barcode2D

Methods inherited from class java.lang.Object

Field Detail

PDF417_USE_ASPECT_RATIO

PDF417_FIXED_RECTANGLE

PDF417_FIXED_COLUMNS

PDF417_FIXED_ROWS

PDF417_AUTO_ERROR_LEVEL

PDF417_USE_ERROR_LEVEL

PDF417_FORCE_BINARY

PDF417_USE_RAW_CODEWORDS

PDF417_INVERT_BITMAP

PDF417_USE_MACRO

START_PATTERN

STOP_PATTERN

START_CODE_SIZE

STOP_SIZE

MOD

ALPHA

LOWER

MIXED

PUNCTUATION

ISBYTE

BYTESHIFT

PL

LL

AS

ML

AL

PS

PAL

SPACE

TEXT_MODE

BYTE_MODE_6

BYTE_MODE

NUMERIC_MODE

ABSOLUTE_MAX_TEXT_SIZE

MAX_DATA_CODEWORDS

MACRO_SEGMENT_ID

MACRO_LAST_SEGMENT

DEFAUL_MODULE_WIDTH

DEFAUL_MODULE_HEIGHT

bitPtr

cwPtr

segmentList

Constructor Detail

BarcodePDF417

Method Detail

setMacroSegmentId

setMacroSegmentCount

setMacroFileId

setDefaultParameters

getBarcodeSize

placeBarcode

placeBarcode

paintCode

createFormXObject

createFormXObject

createAwtImage

getOutBits

getBitColumns

getCodeRows

setCodeRows

getCodeColumns

setCodeColumns

getCodewords

getLenCodewords

setLenCodewords

getErrorLevel

setErrorLevel

getCode

setCode

setCode

getOptions