Reconozca y genere códigos de barras PDF417 con VintaSoft Barcode .NET SDK

VintaSoft Barcode .NET SDK es un SDK profesional multiplataforma para Windows, Linux y macOS que le permite reconocer y generar códigos de barras PDF417 en .NET, WPF, Web y MAUI. Solo necesita unas pocas líneas de código para añadir la capacidad de reconocer y generar códigos de barras PDF417 a su aplicación .NET.

¿Qué es un código de barras PDF417?

El código de barras PDF417 es un código de barras 2D multicapa de alta densidad que se utiliza para almacenar grandes cantidades de datos (hasta 1850 caracteres o 1108 bytes). Inventado en 1991, se utiliza ampliamente en tarjetas de identificación gubernamentales, tarjetas de embarque y logística. Utiliza un patrón de 4 barras y 4 espacios, con 17 elementos por palabra de código, admite corrección de errores integrada y proporciona un almacenamiento de datos compacto y fiable.

Aquí está la imagen del código de barras PDF417:


El código de barras PDF417 admite los siguientes modos de almacenamiento de datos:

• Alfanumérico (hasta 1850 símbolos)
• Byte (hasta 1108 bytes)
• Numérico (hasta 2710 dígitos)

El código de barras PDF417 utiliza el algoritmo de corrección de errores Reed-Solomon, que nos permite reconocer códigos de barras PDF417 dañados.

El código de barras PDF417 puede codificar los siguientes caracteres especiales:

• ECI - Interpretación de canal extendido (NonDataFlags.CreateECICharacter
• PDF417StructuredAppendCharacter (PDF417StructuredAppendCharacter)
• LinkageFlag (NonDataFlags.LinkageFlag)
• EanUccLinkageFlag (NonDataFlags.EanUccLinkageFlag)
• ReaderProgramming (NonDataFlags.ReaderProgramming)

Estructura del código de barras PDF417

El código de barras PDF417 consta de varios módulos, que se pueden dividir en tres grupos distintos:

• Patrón de inicio/fin
• Indicador de izquierda/derecha
• Palabras de código de datos

Cada módulo comienza con una columna negra sólida y termina con una columna blanca sólida para indicar visualmente dónde comienza y termina cada módulo. También hay un área en blanco a cada lado del código de barras, conocida como zona silenciosa.

Los patrones de búsqueda de inicio y fin indican las áreas de inicio y fin del código de barras. Ayudan al lector a detectar el código de barras, pero no contienen datos.

Los indicadores izquierdo y derecho contienen información sobre el código de barras, como el número de líneas, el nivel de corrección de errores, etc.

El módulo de palabras de código de datos contiene los datos del código de barras. El tamaño de un código de barras PDF417 depende de la cantidad de datos codificados. El módulo de palabras de código de datos puede contener de 1 a 30 palabras de código y de 3 a 90 líneas. En la figura anterior, el módulo de palabras de código de datos contiene 4 palabras de código por fila, marcadas en morado. En la figura anterior, el módulo de palabras de código de datos consta de 4 filas.

Cada palabra de código tiene 17 celdas y consta de 4 franjas negras y 4 celdas blancas, de ahí el nombre PDF417. Cada dato palabra de código se lee de izquierda a derecha, de arriba a abajo.

¿Qué es el código de barras PDF417 Compact?

El código de barras PDF417 Compact es una variante del código de barras PDF417 que elimina el indicador derecho y el patrón de búsqueda de parada para ahorrar espacio.
Aquí hay una imagen del código de barras PDF417 Compact:

¿Qué es el código de barras Micro PDF417?

El código de barras Micro PDF417 es una versión compacta del código de barras PDF417. Los códigos de barras Micro PDF417 se utilizan normalmente como parte de códigos compuestos (como GS1 DataBar) para el etiquetado de productos, el etiquetado de documentos y aplicaciones sanitarias:


El código de barras Micro PDF417 admite los siguientes modos de almacenamiento de datos:

• Alfanumérico (hasta 250 símbolos)
• Byte (hasta 150 bytes)
• Numérico (hasta 366 dígitos)

El código de barras Micro PDF417 puede codificar los siguientes caracteres especiales:

• ECI - Interpretación de canal extendido (NonDataFlags.CreateECICharacter
• PDF417StructuredAppendCharacter (PDF417StructuredAppendCharacter)
• Macro05 (NonDataFlags.Macro05)
• Macro06 (NonDataFlags.Macro06)
• MicroPDF417AsCode128EmulationValueItem (MicroPDF417AsCode128EmulationValueItem)
• LinkageFlag (NonDataFlags.LinkageFlag)
• EanUccLinkageFlag (NonDataFlags.EanUccLinkageFlag)
• ReaderProgramming (NonDataFlags.ReaderProgramming)

¿Qué es el código de barras AAMVA?

Código de barras AAMVA (Estándar de Diseño de Licencias de Conducir/Dar de Identificación): este es un código de barras PDF417 que almacena información de la licencia de conducir. VintaSoft Barcode .NET SDK puede codificar y decodificar datos en formato AAMVA.
Aquí se muestra una imagen del código de barras AAMVA:

¿Qué es el código de barras XFA Compressed PDF417?

El código de barras "XFA Compressed PDF417" es un código de barras PDF417 que almacena datos comprimidos según la especificación Adobe XFA. VintaSoft Barcode .NET SDK puede generar y reconocer códigos de barras "XFA Compressed PDF417".
Aquí se muestra la imagen del código de barras "XFA Compressed QR":

El carácter especial "Structure Append"

El código de barras PDF417 admite el carácter especial "Structure Append", que permite dividir los datos en varios códigos de barras PDF417 (hasta 99.999). Este carácter especial está codificado dentro del código de barras y permite la identificación única del número de partes del código de barras y su orden.

Aquí hay una imagen de un código de barras PDF417 con el texto "In order to fit a non-square area or to handle larger messages than are practical in a single symbol, a data message can be distributed across several symbols. Aztec, Code 16K, DataMatrix, DotCode, MaxiCode, QR Code, PDF417, Micro PDF417 symbols may be appended in a structured format.":

Y aquí hay cinco códigos de barras PDF417 con el mismo texto, pero en un tamaño más pequeño. Estos cinco códigos de barras PDF417 se combinan en un único valor mediante el carácter especial "Structure Append":

VintaSoft Barcode .NET SDK contiene un algoritmo para recuperar datos de un conjunto de partes de códigos de barras PDF417 que se separaron mediante el carácter especial "Structure Append".

¿Qué códigos de barras PDF417 se pueden reconocer con VintaSoft Barcode .NET SDK?

VintaSoft Barcode .NET SDK puede reconocer todos los tipos de códigos de barras PDF417: PDF417, PDF417 Compact, Micro PDF417, AAMVA y XFA Compressed PDF417. Se utilizan algoritmos únicos para el reconocimiento, lo que permite un reconocimiento rápido de códigos de barras en imágenes con varios problemas:

• matriz dañada
• contraste bajo
• modulación baja
• iluminación desigual
• compresión en un lado
• distorsiones espaciales
• gran cantidad de códigos de barras en una sola imagen

Aquí hay un código C# que demuestra cómo reconocer códigos de barras PDF417 en una imagen capturada desde una cámara:

/// <summary>
/// Reads PDF417 barcodes from a <see cref="System.Drawing.Bitmap"/>.
/// </summary>
/// <param name="bitmap">A bitmap with barcodes.</param>
public static void ReadPdf417BarcodesFromBitmap(System.Drawing.Bitmap bitmap)
{
    // create barcode reader
    using (Vintasoft.Barcode.BarcodeReader reader = new Vintasoft.Barcode.BarcodeReader())
    {
        // specify that reader must search for PDF417 barcodes
        reader.Settings.ScanBarcodeTypes = Vintasoft.Barcode.BarcodeType.PDF417;

        // read barcodes from image
        Vintasoft.Barcode.IBarcodeInfo[] infos = Vintasoft.Barcode.GdiExtensions.ReadBarcodes(reader, bitmap);

        // if barcodes are not detected
        if (infos.Length == 0)
        {
            System.Console.WriteLine("No barcodes found.");
        }
        // if barcodes are detected
        else
        {
            // get information about extracted barcodes

            System.Console.WriteLine(string.Format("{0} barcodes found:", infos.Length));
            System.Console.WriteLine();
            for (int i = 0; i < infos.Length; i++)
            {
                Vintasoft.Barcode.IBarcodeInfo info = infos[i];
                System.Console.WriteLine(string.Format("[{0}:{1}]", i + 1, info.BarcodeType));
                System.Console.WriteLine(string.Format("Value:      {0}", info.Value));
                System.Console.WriteLine(string.Format("Region:     {0}", info.Region));
                System.Console.WriteLine();
            }
        }
    }
}

Aquí hay un código C# que demuestra cómo generar y reconocer un código de barras AAMVA:

/// <summary>
/// Generates and recognizes AAMVA barcode.
/// </summary>
public static void GenerateAndRecognizeAamvaBarcode()
{
    // create DL data elements
    AamvaDataElement[] dlElements = new AamvaDataElement[] {
        new AamvaDataElement(AamvaDataElementIdentifiers.DAQ, "C12345678"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DCS, "CARPENTER"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DDE, "N"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DAC, "JON"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DDF, "N"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DAD, "T"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DDG, "N"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DCA, "D"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DCB, "1"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DCD, "NONE"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DBD, "10052015"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DBB, "07241984"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DBA, "01092022"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DBC, "1"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DAU, "067 in"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DAY, "BLK"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DAG, "3211 SANCTUARY LANE"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DAI, "LOUISVILLE"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DAJ, "KY"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DAK, "123454321"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DCF, "9876543210123456"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DCG, "USA"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DCK, "1234567890123456"),
        new AamvaDataElement(AamvaDataElementIdentifiers.DDB, "01062016")
    };

    // create ZK data elements
    AamvaDataElement[] zkElements = new AamvaDataElement[] {
        new AamvaDataElement("ZKA", "Y"),
        new AamvaDataElement("ZKB", "TEST"),
        new AamvaDataElement("ZKC", "9876"),
        new AamvaDataElement("ZKD", "DUP"),
    };

    // create subfiles
    AamvaSubfile[] subfiles = new AamvaSubfile[]{
        new AamvaSubfile("DL", dlElements),
        new AamvaSubfile("ZK", zkElements)
    };
    
    // create AAMVA barcode value
    AamvaBarcodeValue barcodeValue = new AamvaBarcodeValue(AamvaVersionLevel.AAMVA2016, 636046, 0, subfiles);
    
    // generate barcode image
    using (VintasoftBitmap barcodeImage = GenerateAamvaBarcode(barcodeValue))
    {
        // recognize barcode value
        AamvaBarcodeInfo recognizedBarcode = RecognizeAamvaBarcode(barcodeImage);

        // check value
        if (barcodeValue.ToString() != recognizedBarcode.AamvaValue.ToString())
            throw new ApplicationException();

        // print value
        Console.WriteLine("Version:         {0}", recognizedBarcode.VersionLevel);
        Console.WriteLine("Country:         {0}", recognizedBarcode.CountryId);
        Console.WriteLine("IIN:             {0}", recognizedBarcode.IssuerIdentificationNumber);
        Console.WriteLine("License number:  {0}", recognizedBarcode.LicenseNumber);
        Console.WriteLine("First name:      {0}", recognizedBarcode.FirstName);
        Console.WriteLine("Family name:     {0}", recognizedBarcode.FamilyName);
        Console.WriteLine("Middle name:     {0}", recognizedBarcode.MiddleName);
        Console.WriteLine("Sex (1=M;2=F):   {0}", recognizedBarcode.Sex);
        Console.WriteLine("Eye color:       {0}", recognizedBarcode.EyeColor);            
        Console.WriteLine("Date of birth:   {0}", recognizedBarcode.DateOfBirth.ToShortDateString());
        Console.WriteLine("Issue date:      {0}", recognizedBarcode.IssueDate.ToShortDateString());
        Console.WriteLine("Expiration date: {0}", recognizedBarcode.ExpirationDate.ToShortDateString());
        Console.WriteLine("State code:      {0}", recognizedBarcode.AddressStateCode);
        Console.WriteLine("City:            {0}", recognizedBarcode.AddressCity);
        Console.WriteLine("Postal code:     {0}", recognizedBarcode.AddressPostalCode);
        Console.WriteLine("Street:          {0}", recognizedBarcode.AddressStreet1);
        Console.WriteLine();
        Console.WriteLine("Data elements:");
        foreach (AamvaSubfile subfile in recognizedBarcode.Subfiles)
        {
            Console.WriteLine("[{0}] subfile:", subfile.SubfileType);
            foreach (AamvaDataElement dataElement in subfile.DataElements)
            {
                if (dataElement.Identifier.VersionLevel != AamvaVersionLevel.Undefined)
                    Console.Write("  [{0}] {1}:", dataElement.Identifier.ID, dataElement.Identifier.Description);
                else
                    Console.Write("  [{0}]:", dataElement.Identifier.ID);
                Console.WriteLine(" {0}", dataElement.Value);
            }
        }
    }
}

/// <summary>
/// Generates the AAMVA barcode image.
/// </summary>
/// <param name="barcodeValue">The barcode value.</param>
private static VintasoftBitmap GenerateAamvaBarcode(AamvaBarcodeValue barcodeValue)
{
    // create barcode writer
    using (BarcodeWriter writer = new BarcodeWriter())
    {
        // encode AAMVA barcode to writer settings
        BarcodeSymbologySubsets.AAMVA.Encode(barcodeValue, writer.Settings);

        // generate barcode image
        return writer.GetBarcodeAsVintasoftBitmap();
    }
}

/// <summary>
/// Recognizes the AAMVA barcode from image.
/// </summary>
/// <param name="barcodeImage">The barcode image.</param>
private static AamvaBarcodeInfo RecognizeAamvaBarcode(VintasoftBitmap barcodeImage)
{
    // create barcode reader
    using (BarcodeReader reader = new BarcodeReader())
    {
        // specify that AAMVA barcode must be recognized
        reader.Settings.ScanBarcodeSubsets.Add(BarcodeSymbologySubsets.AAMVA);

        // recognize barcodes
        IBarcodeInfo info = reader.ReadBarcodes(barcodeImage)[0];

        // return information about recognized AAMVA barcode
        return (AamvaBarcodeInfo)info;
    }
}

Aquí hay un código C# que demuestra cómo generar y reconocer Un código de barras PDF417, que almacena datos comprimidos según la especificación Adobe XFA:

/// <summary>
/// Generates PDF417 barcode with XFA compression.
/// </summary>
public void GeneratePdf417BarcodeWithXfaCompression()
{
    string barcodeText =
        "https://www.vintasoft.com/vsbarcode-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vstwain-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vstwain-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vsimaging-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vsannotation-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vspdf-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vsjbig2-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vsjpeg2000-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vsdoccleanup-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vsocr-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vsdicom-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vsformsprocessing-dotnet-index.html" + System.Environment.NewLine +
        "https://www.vintasoft.com/vsoffice-dotnet-index.html";

    // create the barcode writer
    using (Vintasoft.Barcode.BarcodeWriter barcodeWriter = new Vintasoft.Barcode.BarcodeWriter())
    {
        // create the XFA compressed PDF417 barcode symbology
        Vintasoft.Barcode.SymbologySubsets.XFACompressedPDF417BarcodeSymbology xfaCompressedPdf417BarcodeSymbology =
            new Vintasoft.Barcode.SymbologySubsets.XFACompressedPDF417BarcodeSymbology();
        // encode barcode text using XFA compressed PDF417 barcode symbology
        xfaCompressedPdf417BarcodeSymbology.Encode(barcodeText, barcodeWriter.Settings);

        // save the barcode image to a file
        barcodeWriter.SaveBarcodeAsImage("pdf417-barcode-with-xfa-compression.png");
    }
}

/// <summary>
/// Recognizes PDF417 barcode with XFA compression.
/// </summary>
public void RecognizePdf417BarcodeWithXfaCompression()
{
    // create barcode reader
    using (Vintasoft.Barcode.BarcodeReader reader = new Vintasoft.Barcode.BarcodeReader())
    {
        // specify that reader must search for XFA compressed PDF417 barcodes
        reader.Settings.ScanBarcodeSubsets.Add(Vintasoft.Barcode.SymbologySubsets.BarcodeSymbologySubsets.XFACompressedPDF417);

        // read barcodes from image file
        Vintasoft.Barcode.IBarcodeInfo[] barcodeInfos = reader.ReadBarcodes("pdf417-barcode-with-xfa-compression.png");

        // if barcodes are not detected
        if (barcodeInfos.Length == 0)
        {
            System.Console.WriteLine("Barcodes are not found.");
        }
        // if barcodes are detected
        else
        {
            // get information about recognized barcodes

            System.Console.WriteLine(string.Format("{0} barcode(s) found:", barcodeInfos.Length));
            System.Console.WriteLine();
            for (int i = 0; i < barcodeInfos.Length; i++)
            {
                Vintasoft.Barcode.IBarcodeInfo barcodeInfo = barcodeInfos[i];
                System.Console.WriteLine(string.Format("[{0}:{1}]", i + 1, barcodeInfo.BarcodeType));
                System.Console.WriteLine(string.Format("Value:      {0}", barcodeInfo.Value));
                System.Console.WriteLine(string.Format("Region:     {0}", barcodeInfo.Region));
                System.Console.WriteLine();
            }
        }
    }
}

¿Qué códigos de barras PDF417 puede generar VintaSoft Barcode .NET SDK?

VintaSoft Barcode .NET SDK generó todos los tipos de códigos de barras PDF417: PDF417, PDF417 Compact, Micro PDF417, AAMVA,PDF417 comprimido XFA.

Aquí hay un código C# que demuestra cómo generar una imagen de mapa de bits de un código de barras PDF417:

/// <summary>
/// Returns the PDF417 barcode as <see cref="System.Drawing.Bitmap"/>.
/// </summary>
/// <param name="value">The barcode value.</param>
/// <returns>A <see cref="System.Drawing.Bitmap"/> object.</returns>
public static System.Drawing.Bitmap GetPdf417BarcodeAsBitmap(string value)
{
    // create the barcode writer
    using (Vintasoft.Barcode.BarcodeWriter barcodeWriter = new Vintasoft.Barcode.BarcodeWriter())
    {
        // set barcode writer settings
        barcodeWriter.Settings.Barcode = Vintasoft.Barcode.BarcodeType.PDF417;
        barcodeWriter.Settings.Value = value;

        // get a barcode image as System.Drawing.Bitmap
        return Vintasoft.Barcode.GdiExtensions.GetBarcodeAsBitmap(barcodeWriter);
    }
}

Aquí hay un código C# que demuestra cómo generar una imagen de mapa de bits de un código de barras Micro PDF417:

/// <summary>
/// Returns the Micro PDF417 barcode as <see cref="System.Drawing.Bitmap"/>.
/// </summary>
/// <param name="value">The barcode value.</param>
/// <returns>A <see cref="System.Drawing.Bitmap"/> object.</returns>
public static System.Drawing.Bitmap GetMicroPdf417BarcodeAsBitmap(string value)
{
    // create the barcode writer
    using (Vintasoft.Barcode.BarcodeWriter barcodeWriter = new Vintasoft.Barcode.BarcodeWriter())
    {
        // set barcode writer settings
        barcodeWriter.Settings.Barcode = Vintasoft.Barcode.BarcodeType.MicroPDF417;
        barcodeWriter.Settings.Value = value;

        // get a barcode image as System.Drawing.Bitmap
        return Vintasoft.Barcode.GdiExtensions.GetBarcodeAsBitmap(barcodeWriter);
    }
}

Aquí hay un código C# que demuestra cómo generar una imagen vectorial (SVG) de un código de barras PDF417:

/// <summary>
/// Returns the PDF417 barcode in vector form as a SVG string.
/// </summary>
/// <param name="barcodeValue">Barcode value.</param>
public static void GetPdf417BarcodeAsSvgString(string barcodeValue)
{
    // create the barcode writer
    using (Vintasoft.Barcode.BarcodeWriter barcodeWriter = new Vintasoft.Barcode.BarcodeWriter())
    {
        // set barcode writer settings
        barcodeWriter.Settings.Barcode = Vintasoft.Barcode.BarcodeType.PDF417;
        barcodeWriter.Settings.Value = barcodeValue;

        // generate PDF417 barcode as a SVG string
        return barcodeWriter.GetBarcodeAsSvgFile();
    }
}