Штрих-код Royal Mail Mailmark 2D — це машинозчитуваний складний штрих-код, який використовується в листах. Він надає інформацію про відстеження пошти та стан доставки. Він також може містити додаткову інформацію, таку як графік доставки та статистику звітності. У цій статті ми навчимося генерувати та читати двовимірний штрих-код Royal Mail Mailmark за допомогою C#.
У цій статті будуть розглянуті такі теми:
- C# API для створення та читання QR-кодів Royal Mail
- Що таке королівський штрих-код?
- Типи QR-кодів Royal Mail
- Створити QR-код Royal Mail
- Прочитайте QR-код Royal Mail
- Безкоштовні навчальні ресурси
C# API для створення та читання QR-коду Royal Mail
Для створення та зчитування QR-коду Royal Mail ми будемо використовувати API Aspose.BarCode for .NET. Використовуючи API, ми можемо генерувати та розпізнавати широкий спектр 1D та 2D типів штрих-кодів.
Завантажте DLL API або встановіть його за допомогою NuGet.
PM> Install-Package Aspose.BarCode
Що таке королівський штрих-код?
Штрих-код Royal Mail — це штрих-код Complex Mail Data Mark (CMDM). Він був розроблений Поштовою системою Великобританії для автоматизації сортування та відстеження пошти. Він має заданий формат коду Data Matrix типу ECC200, що відповідає міжнародному стандарту. Його також називають Королівським кодом клієнта 4 штату (RM4SCC).
Типи QR-кодів Royal Mail
Існує три типи двовимірних складних штрих-кодів позначок даних пошти:
- Тип 7:
- Листи
- Розмір штрих-коду: 24 × 24 модуля
- Фізичний розмір: 12 × 12 мм
- Загальна кількість символів: 51 символ
- Використання клієнтом: 6 вільних місць
- Тип 9:
- Великі літери, у тому числі поліетиленові літери
- Розмір штрих-коду: 32 × 32 модуля
- Фізичний розмір: 16 × 16 мм
- Загальна кількість символів: 90 символів
- Використання клієнтом: >25, але максимум 45 вільних місць
- Тип 29:
- Великі літери, включно з багаторазовими
- Розмір штрих-коду: 16 × 48 модулів
- Фізичний розмір: 8 × 24 мм
- Загальна кількість символів: 70 символів
- Загальна кількість символів: нам потрібно 6–25 символів клієнта.
Створення штрих-коду Royal Mail на C#
Ми можемо створити штрих-код марки Royal Mail, виконавши наведені нижче дії.
- По-перше, створіть екземпляр класу Mailmark2DCodetext.
- Далі встановіть різні властивості, такі як UPUCountryID, VersionID, Class, ItemID тощо.
- Потім укажіть Mailmark2DType як Type7, Type9 або Type29.
- Потім створіть екземпляр класу ComplexBarcodeGenerator з об’єктом Mailmark2DCodetext як аргументом.
- Після цього встановіть розміри штрих-коду.
- Нарешті, викличте метод Save, щоб зберегти зображення штрих-коду на локальному диску.
У наведеному нижче прикладі коду показано, як створити двовимірний штрих-код Mailmark типу 7 за допомогою C#.
// У цьому прикладі коду показано, як створити двовимірний штрих-код поштової позначки
// Ініціалізація двовимірного коду поштової позначки
Mailmark2DCodetext mailmark2D = new Mailmark2DCodetext();
mailmark2D.UPUCountryID = "JGB ";
mailmark2D.InformationTypeID = "0";
mailmark2D.VersionID = "1";
mailmark2D.Class = "1";
mailmark2D.SupplyChainID = 123;
mailmark2D.ItemID = 1234;
mailmark2D.DestinationPostCodeAndDPS = "QWE1";
mailmark2D.RTSFlag = "0";
mailmark2D.ReturnToSenderPostCode = "QWE2";
// Кодування поштової позначки 2D типу 7
mailmark2D.DataMatrixType = Mailmark2DType.Type_7;
mailmark2D.CustomerContent = "CUSTOM";
// Ініціалізація генератора штрих-кодів
var generator = new ComplexBarcodeGenerator(mailmark2D);
generator.Parameters.Barcode.XDimension.Pixels = 4;
// зберегти
generator.зберегти(@"D:\Files\BarCode\Mailmark2DType7.png");
Читайте QR-код Royal Mail за допомогою C#
Ми можемо прочитати QR-код Royal Mail, виконавши наведені нижче дії:
- По-перше, створіть екземпляр класу BarCodeReader.
- Далі введіть шлях зображення вхідного штрих-коду та DecodeType.
- Потім отримайте BarCodeResult, викликавши метод ReadBarCodes().
- Після цього розкодуйте штрих-код за допомогою методу TryDecodeMailmark2D().
- Нарешті, прочитайте декодовані властивості об’єкта Mailmark2DCodetext.
У наведеному нижче прикладі коду показано, як читати QR-код Mailmark за допомогою C#.
// У цьому прикладі коду показано, як читати 2D штрих-код поштової позначки
// Розпізнати двовимірний код поштової марки
BarCodeReader reader = new BarCodeReader(@"D:\Files\BarCode\Mailmark2DType7.png", DecodeType.DataMatrix);
foreach (BarCodeResult result in reader.ReadBarCodes())
{
// Розшифруйте Mailmark 2D
Mailmark2DCodetext mailmarkResult = ComplexCodetextReader.TryDecodeMailmark2D(result.CodeText);
// Прочитайте властивості
Console.WriteLine($"UPUCountryID:{mailmarkResult.UPUCountryID}");
Console.WriteLine($"InformationTypeID:{mailmarkResult.InformationTypeID}");
Console.WriteLine($"VersionID:{mailmarkResult.VersionID}");
Console.WriteLine($"Class:{mailmarkResult.Class}");
Console.WriteLine($"SupplyChainID:{mailmarkResult.SupplyChainID}");
Console.WriteLine($"ItemID:{mailmarkResult.ItemID}");
Console.WriteLine($"DestinationPostCodeAndDPS:{mailmarkResult.DestinationPostCodeAndDPS}");
Console.WriteLine($"RTSFlag:{mailmarkResult.RTSFlag}");
Console.WriteLine($"ReturnToSenderPostCode:{mailmarkResult.ReturnToSenderPostCode}");
Console.WriteLine($"CustomerContent:{mailmarkResult.CustomerContent}");
}
UPUCountryID:JGB
InformationTypeID:0
VersionID:1
Class:1
SupplyChainID:123
ItemID:1234
DestinationPostCodeAndDPS:QWE1
RTSFlag:0
ReturnToSenderPostCode:QWE2
CustomerContent:CUSTOM DATA
Отримайте безкоштовну ліцензію
Ви можете отримати безкоштовну тимчасову ліцензію, щоб спробувати бібліотеку без оціночних обмежень.
Бібліотека 2D штрих-кодів Mailmark – навчальні ресурси
Окрім створення та зчитування QR-кодів Royal Mail, ви можете дізнатися більше про різні інші функції Aspose.BarCode, використовуючи наведені нижче ресурси:
Висновок
У цій статті ми навчилися генерувати QR-код Royal Mail і зберігати зображення штрих-коду на диску. Ми також побачили, як зчитувати згенерований двовимірний штрих-код Mailmark програмним шляхом. Крім того, ви можете дізнатися більше про Aspose.BarCode for .NET API за допомогою документації. У разі будь-яких неясностей зв’яжіться з нами на нашому безкоштовному форумі підтримки.