←Select platform

PDF417BarcodeWriteOptions Class

Contains extra options to use when writing PDF417 barcodes.
public class PDF417BarcodeWriteOptions : BarcodeWriteOptions 
@interface LTPDF417BarcodeWriteOptions : LTBarcodeWriteOptions 
public class PDF417BarcodeWriteOptions extends BarcodeWriteOptions 
public ref class PDF417BarcodeWriteOptions : public BarcodeWriteOptions, System.ICloneable   
class PDF417BarcodeWriteOptions(BarcodeWriteOptions): 

The PDF417BarcodeWriteOptions class is used to control the options for writing PDF417 barcodes using LEADTOOLS. Set the options in two ways:

The BarcodeWriter class contains default options for each barcode symbology (or group of common symbologies). These options can be retrieved using the BarcodeWriter.GetDefaultOptions method, by passing BarcodeSymbology.PDF417. Then change the members of the returned PDF417BarcodeWriteOptions by casting it from BarcodeWriteOptions to PDF417BarcodeWriteOptions.

You can also create an instance of the PDF417BarcodeWriteOptions class and use it directly in the BarcodeWriter.WriteBarcode method which accepts the options as an input parameter.

The base BarcodeWriteOptions contains the following members and features:

Member Description

Controls the barcode foreground color (color of the bars or symbols) to use when writing a barcode to an image.


Controls the barcode background color (color of the spaces) to use when writing a barcode to an image.

BarcodeWriteOptions.Load and BarcodeWriteOptions.Save

Can be used to save or load the options to/from an XML file or stream.


This class overrides the base class method to return an array containing the following symbologies: BarcodeSymbology.PDF417

In addition to these features and members, PDF417BarcodeWriteOptions contains these PDF417 barcode specific features:

Member Description

Horizontal alignment for the barcode inside the destination bounds.


Vertical alignment for the barcode inside the destination bounds.


Write truncated PDF417 symbols.


Enable group mode when writing PDF417 barcodes.


The width part of the aspect ratio for the symbol.


The height part of the aspect ratio for the symbol.


Use the Rows and Columns values as limits when writing the symbol.


The maximum number of columns to use when writing PDF417 symbols.


The maximum number of Rows to use when writing PDF417 symbols.


The size of the smallest module when writing a PDF417 barcode.


The ratio between the width of the smallest element (XModule) to the height of a row of the PDF417 symbol to use when writing PDF417 barcodes.


The ECC (Error Correction) level to use when writing PDF417 barcodes.


Indicates the percentage of ECC characters to use when writing PDF417 barcodes.

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Barcode; 
using Leadtools.ImageProcessing; 
public void PDF417Barcode_Example() 
   string imageFileName = Path.Combine(LEAD_VARS.ImagesDir, "MyPDF417Barcodes.tif"); 
   BarcodeEngine engine = new BarcodeEngine(); 
   // Create the image to write the barcodes to 
   int resolution = 300; 
   using (RasterImage image = RasterImage.Create((int)(8.5 * resolution), (int)(11.0 * resolution), 1, resolution, RasterColor.FromKnownColor(RasterKnownColor.White))) 
      // Write two PDF417 barcodes 
      WriteBarcode(engine.Writer, image, "DATA1", 10, 10, true); 
      WriteBarcode(engine.Writer, image, "DATA2", 20, 20, false); 
      // Save the image 
      using (RasterCodecs codecs = new RasterCodecs()) 
         codecs.Save(image, imageFileName, RasterImageFormat.CcittGroup4, 1); 
   // Now read the barcodes again 
   using (RasterCodecs codecs = new RasterCodecs()) 
      using (RasterImage image = codecs.Load(imageFileName)) 
         ReadBarcodes(engine.Reader, image); 
private void WriteBarcode(BarcodeWriter writer, RasterImage image, string value, int rows, int columns, bool topLeft) 
   // Create the barcode data 
   PDF417BarcodeData barcode = new PDF417BarcodeData(); 
   barcode.Value = value; 
   barcode.Group = 0; 
   barcode.Symbology = BarcodeSymbology.PDF417; 
   // We will use the alignment to position the barcodes, so use all of the image 
   barcode.Bounds = new LeadRect(0, 0, image.ImageWidth, image.ImageHeight); 
   // Set the write options 
   PDF417BarcodeWriteOptions options = new PDF417BarcodeWriteOptions(); 
   if (topLeft) 
      options.HorizontalAlignment = BarcodeAlignment.Near; 
      options.VerticalAlignment = BarcodeAlignment.Near; 
      options.HorizontalAlignment = BarcodeAlignment.Far; 
      options.VerticalAlignment = BarcodeAlignment.Far; 
   options.Truncated = false; 
   options.EnableGroupMode = false; 
   options.SymbolWidthAspectRatio = 2; 
   options.SymbolHeightAspectRatio = 1; 
   options.LimitByRowsAndColumns = true; 
   options.Rows = rows; 
   options.Columns = columns; 
   options.XModule = 30; 
   options.XModuleAspectRatio = 3; 
   options.ECCLevel = PDF417BarcodeECCLevel.Level0; 
   options.ECCPercentage = 0; 
   // Write it 
   Console.WriteLine("Writing barcode with symbol rows/columns: {0}/{1} and Data: {2}", rows, columns, value); 
   writer.WriteBarcode(image, barcode, options); 
private void ReadBarcodes(BarcodeReader reader, RasterImage image) 
   // Setup read options 
   PDF417BarcodeReadOptions options = new PDF417BarcodeReadOptions(); 
   options.SearchDirection = BarcodeSearchDirection.Horizontal; 
   options.EnableDoublePass = false; 
   options.EnableFastMode = false; 
   options.ReadMode = PDF417BarcodeReadMode.Mode0; 
   options.ReturnCorruptedSymbolArea = false; 
   options.ReadOptionalMacroFileNameField = false; 
   options.ReadOptionalMacroSegmentCountField = false; 
   options.ReadOptionalMacroTimestampField = false; 
   options.ReadOptionalMacroSenderField = false; 
   options.ReadOptionalMacroAddresseeField = false; 
   options.ReadOptionalMacroFileSizeField = false; 
   options.ReadOptionalMacroChecksumField = false; 
   options.ReadOptionalMacro79AndAZField = false; 
   options.EnableDoublePassIfSuccess = true; 
   options.EnableNoIndicatorTrail = true; 
   options.EnablePreprocessing = true; 
   Console.WriteLine("Reading Barcodes"); 
   BarcodeData[] barcodes = reader.ReadBarcodes(image, LeadRect.Empty, 0, new BarcodeSymbology[] { BarcodeSymbology.PDF417 }, new BarcodeReadOptions[] { options }); 
   Console.WriteLine("{0} barcodes found:", barcodes.Length); 
   foreach (PDF417BarcodeData barcode in barcodes) 
      Console.WriteLine(" At {0} data: {1} and symbology: {2}", barcode.Bounds, barcode.Value, barcode.Symbology); 
static class LEAD_VARS 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 

Target Platforms

Help Version 22.0.2023.5.9
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Barcode Assembly

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.