LlosLab Software Development BlogEngineering notes for PDF, Delphi, and document software developers.

技术文章

PDF 条形码生成综合指南

· PDF 编程

使用 HotPDF Delphi 组件实现 22 种条形码类型。

在当今的数字世界中，条形码是库存管理、零售运营和数据跟踪系统的基石。 能够生成包含各种条形码类型的专业 PDF 文档对于各行各业的企业来说至关重要。 本综合指南探讨了使用现代开发工具实现 22 种不同的条形码标准，重点是使用 HotPDF VCL 库的 Delphi 和 C++Builder 实现。 HotPDF VCL 库.

了解条形码标准及其应用

条形码是数据的机器可读表示，它通过视觉图案编码信息。 不同的行业和应用需要特定的条形码标准，每个标准都针对特定的用例进行了优化。 了解这些标准对于开发人员实现条形码生成系统至关重要。

Barcodes with HotPDF Delphi Component
使用 HotPDF Delphi 组件显示条形码

线性条形码类别

线性条形码，也称为一维条形码，通过不同宽度的平行线和空格来编码数据。 最常用的标准包括：

  • 代码 25 家族: 包括交错、工业和矩阵变体，仅适用于数字数据。
  • 代码 39 和代码 93: 字母数字编码，支持扩展字符集。
  • Code 128: 高密度编码，具有三种子集变体（A、B、C）。
  • UPC/EAN 家族: 面向零售的标准，包括 UPC-A、UPC-E、EAN-8 和 EAN-13。
  • 专用标准: MSI、PostNet 和 Codabar，适用于特定行业应用。

条形码数据编码原则

每种条形码标准都遵循特定的编码规则，这些规则决定了数据如何在视觉上表示。例如，Code 128 使用不同的编码表，具体取决于子集。

1
2
3
Code 128A: Uppercase letters, control characters, digits
Code 128B: Mixed case letters, digits, special characters  
Code 128C: Numeric pairs encoded as single characters (high density)

了解这些编码原则对于选择适合特定数据要求的条形码类型至关重要。

现代 PDF 条形码生成架构

专业条形码生成需要一个强大的架构，该架构可以处理多种条形码标准，同时保持 PDF 文档的完整性。现代方法涉及将条形码生成功能直接集成到 PDF 创建库中。

从传统 API 迁移到现代 API。

传统的条形码生成通常涉及复杂的、多步骤的过程，并且依赖于外部组件。现代实现通过集成的API简化了这个过程，该API可以同时处理条形码生成和PDF嵌入。

从旧方法到现代方法的演变，在开发人员体验和输出质量方面都带来了显著的改进。

1
2
3
4
5
6
7
8
9
10
11
Legacy Approach:
1. Generate barcode as image file
2. Load image into PDF library
3. Position and scale image
4. Handle cleanup of temporary files
 
Modern Approach:
1. Direct barcode generation within PDF context
2. Vector-based output for scalability
3. Integrated positioning and sizing
4. No temporary file management required

在Delphi中实现全面的条形码生成。

Delphi是一个非常适合实现全面条形码生成系统的平台。该语言的强类型、组件架构以及广泛的RTL使其非常适合创建强大的PDF生成应用程序。

Delphi实现策略。

Delphi的实现重点是创建一个控制台应用程序，该应用程序在一个PDF文档中演示所有支持的条形码类型。这种方法既提供了一个全面的参考，又是一个实用的测试工具。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
program Barcodes;
{$APPTYPE CONSOLE}
 
uses
  System.Classes,
  System.SysUtils,
  Vcl.Graphics,
  HPDFDoc;
 
var
  I, H: Integer;
  HotPDF: THotPDF;
 
const
  Names: array [0 .. 21] of AnsiString = (
    'Code 25 Interleaved', 'Code 25 Industrial', 'Code 25 Matrix',
    'Code39', 'Code39 Extended', 'Code128A', 'Code128B', 'Code128C',
    'Code93', 'Code93 Extended', 'MSI', 'PostNet', 'Codebar',
    'EAN8', 'EAN13', 'UPC_A', 'UPC_E0', 'UPC_E1',
    'UPC Supp2', 'UPC Supp5', 'EAN128A', 'EAN128B'
  );

智能测试数据生成。

在条形码生成中，一个关键的挑战是确保每种条形码类型都接收到适当的测试数据，这些数据符合其规范。Delphi的实现包括一个智能函数，该函数为每种条形码标准提供有效的测试数据。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
function GetBarcodeText(BarcodeType: Integer): AnsiString;
begin
  case BarcodeType of
    0, 1, 2: Result := '12345678'; // Code 25 variants (digits only)
    3: Result := 'ABC123'; // Code39 (alphanumeric)
    4: Result := 'Code39Ext'; // Code39 Extended (mixed case)
    5, 6: Result := 'Hello123'; // Code128A/B (text)
    7: Result := '123456789012'; // Code128C (digits only, even length)
    8: Result := 'CODE93'; // Code93 (uppercase)
    9: Result := 'Code93Ext'; // Code93 Extended (mixed case)
    10: Result := '123456789'; // MSI (digits only)
    11: Result := '12345'; // PostNet (ZIP code)
    12: Result := 'A12345B'; // Codabar (starts/ends with letter)
    13: Result := '1234567'; // EAN8 (7 digits, check digit added)
    14: Result := '123456789012'; // EAN13 (12 digits, check digit added)
    15: Result := '012345678905'; // UPC_A (12 digits)
    16, 17: Result := '1234567'; // UPC_E variants (7 digits)
    18: Result := '59'; // UPC Supp2 (2 digits)
    19: Result := '12345'; // UPC Supp5 (5 digits)
    20, 21: Result := 'EAN128TEST'; // EAN128 variants (text)
    else Result := '12345'; // Default
  end;
end;

这种方法确保每种条形码类型都使用符合其特定要求的的数据进行测试，从而防止生成错误，并提供真实的示例。

优化布局算法

Delphi 版本的实现使用了复杂的布局算法，该算法以最佳的网格格式排列 22 种不同的条形码类型。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
begin
  HotPDF := THotPDF.Create(nil);
  try
    HotPDF.AutoLaunch := true;
    HotPDF.FileName := 'Barcodes.pdf';
    HotPDF.BeginDoc;
    
    // Display 22 barcode types in a compact layout (4 columns x 6 rows)
    for I := 0 to 5 do // 6 rows (0-5)
    begin
      for H := 0 to 3 do // 4 columns (0-3)
      begin
        if ((I * 4) + H) > 21 then Break; // Total 22 barcodes (0-21)
        
        // Use new DirectDrawBarcode method with compact size
        HotPDF.CurrentPage.DirectDrawBarcode(
          H * 130 + 30,     // X position (tighter spacing)
          I * 110 + 40,     // Y position
          100, 30,          // Width, Height (optimized for clarity)
          GetBarcodeText((I * 4) + H), // Appropriate test data
          (I * 4) + H       // BarcodeType (0-21)
        );
        
        HotPDF.CurrentPage.SetFont('Arial', [], 6);
        HotPDF.CurrentPage.TextOut(H * 130 + 30, I * 110 + 75, 0,
          Names[(I * 4) + H]);
      end;
    end;
    
    HotPDF.EndDoc;
  finally
    HotPDF.Free;
  end;
end.

这种布局算法确保了最佳的空间利用率，同时保持了条形码的可读性，并提供了清晰的类型标识。

C++Builder 实现

C++Builder 的实现提供了与 Delphi 版本相同的功能，同时具有 C++ 语法和更广泛的平台兼容性的优势。该实现展示了如何将现代 C++ 技术应用于 PDF 条形码生成。

C++ 架构和内存管理

C++Builder 的实现强调了正确的内存管理和异常安全性，这是专业 C++ 开发的关键方面。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
int main(int argc, char* argv[])
{
    THotPDF* HotPDF = NULL;
    
    try
    {
        HotPDF = new THotPDF(NULL);
        HotPDF->AutoLaunch = true;
        HotPDF->FileName = "Barcodes.pdf";
        HotPDF->BeginDoc();
        
        std::cout << "Creating PDF with 22 different barcode types..." << std::endl;
        
        // Implementation continues...
    }
    catch (Exception& E)
    {
        std::cerr << "Error: " << E.Message.c_str() << std::endl;
        if (HotPDF) delete HotPDF;
        return 1;
    }
    catch (...)
    {
        std::cerr << "Unknown error occurred!" << std::endl;
        if (HotPDF) delete HotPDF;
        return 1;
    }
    
    if (HotPDF) delete HotPDF;
    return 0;
}

类型安全的条形码数据管理。

C++ 版本的实现包含一个强大的数据管理系统，该系统确保了类型安全，同时提供了与 Delphi 版本相同的智能测试数据生成功能：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// Array of barcode type names
const AnsiString Names[22] = {
    "Code 25 Interleaved", "Code 25 Industrial", "Code 25 Matrix",
    "Code39", "Code39 Extended", "Code128A", "Code128B", "Code128C",
    "Code93", "Code93 Extended", "MSI", "PostNet", "Codebar",
    "EAN8", "EAN13", "UPC_A", "UPC_E0", "UPC_E1",
    "UPC Supp2", "UPC Supp5", "EAN128A", "EAN128B"
};
 
// Function to get appropriate test text for each barcode type
AnsiString GetBarcodeText(int BarcodeType)
{
    switch (BarcodeType)
    {
        case 0: case 1: case 2:
            return "12345678"; // Code 25 variants (digits only)
        case 3:
            return "ABC123"; // Code39 (alphanumeric)
        case 4:
            return "Code39Ext"; // Code39 Extended (mixed case)
        // Additional cases for all 22 barcode types...
        default:
            return "12345"; // Default fallback
    }
}

用户友好的进度报告。

C++ 版本的实现包含全面的进度报告，可在条形码生成过程中提供实时反馈：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
for (int I = 0; I <= 5; I++) // 6 rows (0-5)
{
    for (int H = 0; H <= 3; H++) // 4 columns (0-3) { int barcodeIndex = (I * 4) + H; if (barcodeIndex > 21) break; // Total 22 barcodes (0-21)
        
        // Generate barcode with optimized parameters
        HotPDF->CurrentPage->DirectDrawBarcode(
            H * 130 + 30,           // X position
            I * 110 + 40,           // Y position
            100, 30,                // Width, Height
            GetBarcodeText(barcodeIndex),  // Appropriate test data
            barcodeIndex            // BarcodeType (0-21)
        );
        
        // Add descriptive label
        HotPDF->CurrentPage->SetFont("Arial", TFontStyles(), 6);
        HotPDF->CurrentPage->TextOut(
            H * 130 + 30, I * 110 + 75, 0, Names[barcodeIndex]
        );
        
        // Provide progress feedback
        std::cout << "Generated barcode " << (barcodeIndex + 1) << "/22: "
                 << Names[barcodeIndex].c_str() << std::endl;
    }
}

高级条形码规范兼容性。

专业的条形码生成需要严格遵守行业标准。每种条形码类型都有特定的数据格式、校验位计算和视觉表示要求。

Code 128 规范详细信息。

Code 128 是一种非常通用的条形码标准，支持三种不同的字符集：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
Code 128 Subset A:
- ASCII characters 00-95 (0-9, A-Z, control characters)
- Start character: 11010000100
- Used for: Uppercase text, control characters
 
Code 128 Subset B:  
- ASCII characters 32-127 (0-9, A-Z, a-z, special characters)
- Start character: 11010010000
- Used for: Mixed case text, standard keyboard characters
 
Code 128 Subset C:
- Numeric pairs 00-99 encoded as single characters
- Start character: 11010011100
- Used for: High-density numeric data (even number of digits)

UPC/EAN 系列规范

UPC/EAN 系列代表在零售环境中使用的最广泛的条形码标准。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
UPC-A Structure:
- 12 digits total
- First digit: Number system character
- Next 5 digits: Manufacturer code
- Next 5 digits: Product code  
- Last digit: Check digit (calculated)
 
EAN-13 Structure:
- 13 digits total
- First 2-3 digits: Country code
- Next 4-5 digits: Manufacturer code
- Next 5 digits: Product code
- Last digit: Check digit (calculated)
 
EAN-8 Structure:
- 8 digits total
- First 2-3 digits: Country code
- Next 4-5 digits: Product code
- Last digit: Check digit (calculated)

PDF 集成和矢量图形的优势

现代 PDF 条形码生成利用矢量图形功能，以确保在所有输出尺寸和分辨率下获得最佳质量。 这种方法比基于位图的替代方案具有显著优势。

矢量与栅格条形码生成

基于矢量的条形码生成为专业应用提供几个关键优势：

  • 无限可扩展性矢量条形码在任何尺寸下都能保持清晰的边缘。
  • 打印质量: 打印时无像素化或质量下降。
  • 文件大小效率: 与高分辨率位图相比，文件尺寸更小。
  • 专业外观: 清晰、精确的线条，适用于商业用途。

PDF结构用于条形码集成

PDF格式为条形码数据提供理想的容器，因为它支持矢量图形和精确定位。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
PDF Barcode Object Structure:
1 0 obj
<<
  /Type /XObject
  /Subtype /Form
  /BBox [0 0 100 30]
  /Matrix [1 0 0 1 0 0]
  /Resources << /ProcSet [/PDF] >>
  /Length 245
>>
stream
q
1 0 0 1 0 0 cm
% Barcode drawing commands
0.8 w
0 0 m
0 30 l
S
% Additional barcode elements...
Q
endstream
endobj

自动化构建和开发工作流程

专业的开发需要强大的自动化构建功能，以确保在不同的环境和平台上获得一致的结果。Delphi 和 C++Builder 的实现都包含全面的构建脚本。

自动化构建配置

自动化构建系统提供针对特定平台的编译，并具有适当的优化设置。

1
2
3
4
5
6
7
Build Script Features:
- Platform detection (Win32/Win64)
- Compiler optimization settings
- Library path configuration
- Automatic dependency resolution
- Error handling and reporting
- Post-build testing and validation

质量保证集成

开发工作流程包括集成的质量保证措施，用于验证条形码生成的准确性。

  • 规范合规性测试自动验证条形码格式是否符合规范。
  • 视觉质量评估: 对生成的条形码清晰度的程序化分析
  • 跨平台验证: 确保在不同系统上的输出一致性
  • 性能基准测试: 监控生成速度和内存使用情况

行业应用和用例

完整的条形码生成系统满足多个行业和应用领域的实际需求。

零售和库存管理

零售环境需要支持多种条形码标准，以适应不同的产品类别和供应商需求：

  • UPC/EAN 码 用于消费品
  • Code 128 用于内部库存跟踪
  • Code 39。 用于资产管理
  • 补充码 用于促销价格。

医疗保健和制药。

医疗保健应用需要最高的准确性和对行业标准的合规性。

  • Code 128 用于患者识别。
  • EAN-128。 用于药品包装。
  • Code 39。 用于设备跟踪。
  • MSI 用于实验室样本。

物流和运输。

物流运营需要强大的条形码系统，能够处理高吞吐量。

  • Code 128 用于包裹跟踪。
  • PostNet 用于邮政自动化。
  • 编码 93。 用于安全文档跟踪。
  • Codabar。 用于图书馆和血库应用。

性能优化和最佳实践。

专业的条形码生成系统必须在质量、性能和资源利用之间取得平衡。该实现包括多种优化策略，以确保高效运行。

内存管理优化。

内存管理对于生成大量条形码的应用程序至关重要。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// Delphi memory management best practices
try
  HotPDF := THotPDF.Create(nil);
  try
    // Barcode generation operations
    HotPDF.BeginDoc;
    // ... generation code ...
    HotPDF.EndDoc;
  finally
    HotPDF.Free; // Ensure proper cleanup
  end;
except
  on E: Exception do
  begin
    // Handle errors gracefully
    WriteLn('Error: ', E.Message);
  end;
end;

批量处理策略。

对于需要生成大量条形码的情况，批量处理可以显著提高性能。

  • 文档重用: 在单个PDF文档中创建多个条形码。
  • 资源池: 重用PDF对象和图形上下文。
  • 延迟求值: 仅在需要时生成条形码。
  • 并行处理。: 利用多个核心进行独立的条形码生成。

未来发展和新兴标准

条码行业不断发展，新的标准和技术应运而生，以满足数字商业和供应链管理领域的新需求。

二维条码集成

虽然本次实现侧重于线性条码，但该架构为未来集成二维标准，如二维码、Data Matrix 和 PDF417，奠定了基础。

增强的错误纠正

未来的发展可能包括高级错误纠正功能，可在恶劣环境下或在各种基材上提高条码的可读性。

结论。

专业 PDF 条码生成需要对条码规范、PDF 结构以及现代开发实践有深入的理解。本指南中提供的实现示例展示了如何使用 Delphi 和 C++Builder 创建强大、可扩展的条码生成系统，以满足实际需求。

智能测试数据生成、优化的布局算法以及严格的规范符合性相结合，确保生成的条码符合专业标准，同时为开发人员提供实用、可重用的代码示例。无论您是实施库存管理系统、零售应用程序还是专业行业解决方案，这些技术都为专业条码生成提供了坚实的基础。

通过利用现代 PDF 库并遵循既定最佳实践，开发人员可以创建条形码生成系统，该系统能够在各种应用和环境中提供一致、高质量的结果。这里展示的全面方法确保与行业标准兼容，同时保持自定义实现的灵活性。