Ako vytvoriť Micro, Compact a Macro PDF417 Barcodes .NET
Tento článok sa zameriava na to, ako vytvoriť Micro PDF417, Compact PDF317 a Macro pdf417 barové kódy v aplikáciách .NET pomocou aplikácie Aspose.BarCode. Tieto varianty ponúkajú šetrné priestory, vysokú kapacitu a viacsegmentové funkcie ideálne pre označovanie, dokumentáciu a prenos údajov.
Reálny svetový problém
Štandardné čárové kódy PDF417 môžu byť príliš veľké pre niektoré produkty alebo štítky, a niekedy je potrebné, aby sa informácie rozdelili na viaceré čarovné kóde alebo zakódovali vo vysoko kompaktnom formáte z regulačných alebo prevádzkových dôvodov.
Prehľad riešenia
Aspose.BarCode pre .NET umožňuje vývojárom vytvárať všetky varianty PDF417 programmaticky.
- Micro PDF417: Pre veľmi malé štítky so zníženými údajmi a veľkosťou.
- Kompaktný PDF417: Optimalizovaný pre veľkosť bez straty kapacity.
- Macro PDF417: Rozdeľuje veľké údaje cez viaceré symboly čiarového kódu s metadatami súboru/segmentu.
Predpoklady
Predtým ako začnete, uistite sa, že máte:
- Visual Studio 2019 alebo neskôr
- .NET 6.0 alebo novší (alebo .Net Framework 4.6.2+)
- Aspose.BarCode pre .NET nainštalovaný prostredníctvom NuGet
- Základné znalosti C#
PM> Install-Package Aspose.BarCode
krok za krokom implementácia
Krok 1: Inštalácia a import Aspose.BarCode
using Aspose.BarCode.Generation;
Krok 2: Vytvorte PDF417 Variant Generator
Mikrofón PDF417
BarcodeGenerator microGen = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Micro data");
microGen.Parameters.Barcode.XDimension.Pixels = 4;
Kompaktný PDF417:
BarcodeGenerator compactGen = new BarcodeGenerator(EncodeTypes.CompactPdf417, "Compact info");
compactGen.Parameters.Barcode.XDimension.Pixels = 4;
Prehľad Macro PDF417:
BarcodeGenerator macroGen = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Segmented large dataset");
macroGen.Parameters.Barcode.Pdf417.Pdf417MacroFileID = 123;
macroGen.Parameters.Barcode.Pdf417.Pdf417MacroSegmentID = 1;
macroGen.Parameters.Barcode.Pdf417.Pdf417MacroSegmentsCount = 3;
macroGen.Parameters.Barcode.XDimension.Pixels = 4;
Krok 3: Prispôsobenie stĺpcov, kolónov a ECC
Customize podľa potreby:
microGen.Parameters.Barcode.Pdf417.Pdf417Rows = 4;
microGen.Parameters.Barcode.Pdf417.Pdf417Columns = 2;
compactGen.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level2;
macroGen.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level4; ```
---
### Step 4: Save and Test the Barcode Output
```cs
microGen.Save("micro-pdf417.png", BarCodeImageFormat.Png);
compactGen.Save("compact-pdf417.png", BarCodeImageFormat.Png);
macroGen.Save("macro-pdf417-segment1.png", BarCodeImageFormat.Png);
Krok 5: Kompletný príklad (Všetky PDF417 varianty)
using Aspose.BarCode.Generation;
using System.Drawing;
class Program
{
static void Main()
{
// Micro PDF417
BarcodeGenerator microGen = new BarcodeGenerator(EncodeTypes.MicroPdf417, "Micro data");
microGen.Parameters.Barcode.XDimension.Pixels = 4;
microGen.Parameters.Barcode.Pdf417.Pdf417Rows = 4;
microGen.Parameters.Barcode.Pdf417.Pdf417Columns = 2;
microGen.Save("micro-pdf417.png", BarCodeImageFormat.Png);
// Compact PDF417
BarcodeGenerator compactGen = new BarcodeGenerator(EncodeTypes.CompactPdf417, "Compact info");
compactGen.Parameters.Barcode.XDimension.Pixels = 4;
compactGen.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level2;
compactGen.Save("compact-pdf417.png", BarCodeImageFormat.Png);
// Macro PDF417 (segment 1 of 3)
BarcodeGenerator macroGen = new BarcodeGenerator(EncodeTypes.MacroPdf417, "Segmented large dataset");
macroGen.Parameters.Barcode.Pdf417.Pdf417MacroFileID = 123;
macroGen.Parameters.Barcode.Pdf417.Pdf417MacroSegmentID = 1;
macroGen.Parameters.Barcode.Pdf417.Pdf417MacroSegmentsCount = 3;
macroGen.Parameters.Barcode.XDimension.Pixels = 4;
macroGen.Parameters.Barcode.Pdf417.Pdf417ErrorLevel = Pdf417ErrorLevel.Level4;
macroGen.Save("macro-pdf417-segment1.png", BarCodeImageFormat.Png);
}
}
Použitie prípadov a aplikácií
- Micro PDF417: Malé produktové štítky, kompaktné balenie
- Compact PDF417: Dokumentové označenie, kompaktné dodávateľské reťazce kódov
- Macro PDF417: Zdieľajte údaje pre formuláre, manifesty alebo regulačné viacúčelové dokumenty
Spoločné výzvy a riešenia
**Výzva 1: Nedostatok kapacity údajov?**riešenie : Použite Macro PDF417 s segmentmi pre veľmi veľké súbory údajov.
Výzva 2: Výstup nečítateľný alebo príliš malý?riešenie : Zvýšte veľkosť modulu (pixel), prispôsobte riadky / stĺpce pre priestor / údaje.
**Výzva 3: rekonštrukcia súborov viacerých segmentov?**riešenie : Použite unikátny MacroFileID a zodpovedajúce segmentové ID / účet pre správnu reorganizáciu.
Preskúmanie výkonnosti
- Vyberte správnu verziu PDF417 pre veľkosť aplikácie / priestor
- Batch generuje Micro/Compact/Macro barové kódy podľa potreby
- Použitie pamäťových tokov pre integráciu s digitálnymi pracovnými tokmi
Najlepšie postupy
- Testovanie všetkých výsledkov PDF417 s fyzikálnymi skenermi alebo validátormi zhody
- Použite Macro na rozdelenie veľkých súborov/dokumentov
- Identifikácie segmentu dokumentu pre použitie Macro PDF417
- Vývoz PNG s vysokým DPI pre malé alebo podrobné štítky
Pokročilé scenáre
Batch generuje všetky PDF417 varianty
foreach (var doc in documents)
{
BarcodeGenerator g = new BarcodeGenerator(EncodeTypes.MacroPdf417, doc.SegmentData);
g.Parameters.Barcode.Pdf417.Pdf417MacroFileID = doc.FileID;
g.Parameters.Barcode.Pdf417.Pdf417MacroSegmentID = doc.SegmentID;
g.Parameters.Barcode.Pdf417.Pdf417MacroSegmentsCount = doc.TotalSegments;
g.Save($"macro_{doc.FileID}_segment{doc.SegmentID}.png", BarCodeImageFormat.Png);
}
Záver
Aspose.BarCode pre .NET uľahčuje generovanie všetkých variantov PDF417 – Micro, Compact a Macro – pre balenie, dokumentáciu, regulačné a digitálne pracovné toky. Aspose.BarCode API Referencia pre detaily .