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

Техническая статья

Комплексное руководство по созданию штрих-кода PDF

· Программирование PDF

Реализация 22 типов штрихкодов с компонентом HotPDF для Delphi.

В современном цифровом мире штрихкоды являются основой систем управления запасами, розничной торговли и отслеживания данных. Возможность создания профессиональных PDF-документов, содержащих различные типы штрихкодов, стала необходимостью для предприятий в различных отраслях. Это подробное руководство исследует реализацию 22 различных стандартов штрихкодов с использованием современных инструментов разработки, уделяя особое внимание реализации для Delphi и C++Builder с использованием библиотеки HotPDF VCL. Библиотека 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, которые обрабатывают как генерацию штрихкодов, так и встраивание в 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 предоставляет отличную платформу для реализации комплексных систем генерации штрихкодов. Строгая типизация языка, компонентная архитектура и обширная стандартная библиотека делают его идеальным для создания надежных приложений для генерации 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 и графических контекстов.
  • Отложенная оценка.Генерация штрихкодов только при необходимости.
  • Параллельная обработка.Использование нескольких ядер для независимой генерации штрихкодов.

Будущие разработки и новые стандарты.

Индустрия штрихкодов продолжает развиваться, внедряя новые стандарты и технологии, которые отвечают возникающим требованиям в области цифровой коммерции и управления цепочками поставок.

Интеграция двухмерных штрихкодов.

Хотя данная реализация ориентирована на линейные штрихкоды, архитектура обеспечивает основу для будущей интеграции двухмерных стандартов, таких как QR-коды, Data Matrix и PDF417.

Улучшенная коррекция ошибок.

В будущих разработках могут быть реализованы расширенные возможности коррекции ошибок, которые повысят читаемость штрихкодов в сложных условиях или при печати на различных материалах.

Заключение.

Профессиональная генерация PDF-штрихкодов требует глубокого понимания спецификаций штрихкодов, структуры PDF и современных методов разработки. Примеры реализации, представленные в этом руководстве, демонстрируют, как Delphi и C++Builder могут использоваться для создания надежных и масштабируемых систем генерации штрихкодов, отвечающих реальным требованиям.

Сочетание интеллектуальной генерации тестовых данных, оптимизированных алгоритмов компоновки и строгого соблюдения спецификаций обеспечивает соответствие генерируемых штрихкодов профессиональным стандартам, одновременно предоставляя разработчикам практические и многоразовые примеры кода. Независимо от того, реализуете ли вы системы управления запасами, розничные приложения или специализированные отраслевые решения, эти методы обеспечивают надежную основу для профессиональной генерации штрихкодов.

Используя современные библиотеки для работы с PDF и следуя общепринятым лучшим практикам, разработчики могут создавать системы генерации штрихкодов, которые обеспечивают стабильные и высококачественные результаты в различных приложениях и средах. Представленный здесь комплексный подход обеспечивает совместимость с отраслевыми стандартами, сохраняя при этом гибкость, необходимую для индивидуальных решений.