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

技術記事

PDF バーコード生成の総合ガイド

· PDFプログラミング

HotPDF Delphiコンポーネントを利用した22種類のバーコードの実現

現代のデジタル世界において、バーコードは在庫管理、小売業務、データ追跡システムの基盤となっています。 さまざまな種類のバーコードを含むプロフェッショナルなPDFドキュメントを作成する能力は、あらゆる業界の企業にとって不可欠です。 この包括的なガイドでは、最新の開発ツールを利用して22種類の異なるバーコード規格を実装する方法を説明し、特にDelphiおよびC++Builderの実装に焦点を当てています。 HotPDF VCLライブラリ.

バーコード規格とその用途の理解

バーコードは、視覚的なパターンで情報をエンコードする、機械で読み取れるデータの表現です。 さまざまな業界やアプリケーションには、特定のバーコード規格が必要であり、それぞれが特定の用途に最適化されています。 これらの規格を理解することは、バーコード作成システムを実装する開発者にとって非常に重要です。

Barcodes with HotPDF Delphi Component
HotPDF Delphiコンポーネントを利用したバーコードの表示

線形バーコードのカテゴリ

線形バーコードは、異なる幅の平行な線とスペースでデータをエンコードする、一次元バーコードとも呼ばれます。 最も一般的に実装される規格には以下が含まれます。

  • コード25ファミリー: 整数データ専用のインターリーブ、産業用、およびマトリックスのバリアントを含む
  • コード39およびコード93: 拡張文字セットをサポートする英数字エンコーディング
  • Code 128: 3つのサブセットバリアント（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を利用して、バーコード作成と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'
  );

インテリジェントなテストデータ作成

バーコード作成における重要な課題の1つは、各バーコードタイプが、その仕様に準拠した適切なテストデータを受け取るようにすることです。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つであり、3つの異なる文字セットをサポートしています。

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;

批量處理策略。

大量のバーコードを生成する場合、バッチ処理によって性能を大きく向上できます。

  • ドキュメント重用: 1 つの PDF ドキュメント内に複数のバーコードを生成する。
  • リソースプール化:重用PDFオブジェクト和图形上下文。
  • 延迟求值: 必要なときだけバーコードを生成する。
  • 並列処理。: 複数のコアを使って独立したバーコード生成を並列実行する。

今後の開発と新興標準

バーコード業界は、デジタルコマースおよびサプライチェーン管理における新たな要件に対応する、新しい標準と技術とともに進化を続けています。

二次元バーコードの統合

この実装は、主に一次元バーコードに焦点を当てていますが、アーキテクチャは、QRコード、Data Matrix、およびPDF417のような二次元標準の将来的な統合のための基盤を提供します。

強化されたエラー訂正

今後の開発では、困難な環境下やさまざまな基材に印刷された場合でも、バーコードの読み取り可能性を向上させる、高度なエラー訂正機能が導入される可能性があります。

結論

プロフェッショナルなPDFバーコード作成には、バーコード仕様、PDF構造、および最新の開発手法に関する包括的な理解が必要です。このガイドで紹介されている実装は、DelphiとC++Builderを利用して、堅牢で拡張性のあるバーコード作成システムを構築し、現実世界の要件を満たす方法を示しています。

インテリジェントなテストデータ作成、最適化されたレイアウトアルゴリズム、および厳格な仕様への準拠を組み合わせることで、作成されたバーコードはプロの基準を満たし、同時に開発者に実用的で再利用可能なコード例を提供します。在庫管理システム、小売アプリケーション、または特殊な業界ソリューションを実装する場合でも、これらの技術はプロのバーコード作成のための確固の基盤となります。

現代的な PDF ライブラリを活用し、確立されたベストプラクティスに従うことで、開発者はさまざまなアプリケーションや環境で一貫した高品質の結果を出せるバーコード生成システムを作成できます。ここで示した包括的な方法は、業界標準との互換性を保ちながら、独自実装に必要な柔軟性も確保します。