Manchmal ist es notwendig, einen Barcode zu generieren und Daten darin zu kodieren, deren Größe die Kapazität des Barcodes übersteigt, sodass nicht alle Daten in einem einzigen Barcode Platz finden. Um dieses Problem zu lösen, sollten Sie die Quelldaten in mehrere Datenblöcke aufteilen und diese Datenblöcke in mehrere Barcodes kodieren. Außerdem müssen Sie die Datenblöcke markieren, damit sie wieder zu den Quelldaten zusammengefügt werden können.
Für zweidimensionale Barcodes gibt es die Structure-Append-Technologie, mit der Sie die Quelldaten in Datenblöcke aufteilen und die ursprünglichen Daten aus diesen Datenblöcken wiederherstellen können.
Die Structure-Append-Technologie für DataMatrix- und QR-Code-Barcodes ermöglicht es Ihnen, die Quelldaten in bis zu 16 Datenblöcke aufzuteilen und diese Datenblöcke in 16 DataMatrix- oder QR-Code-Barcodes zu kodieren.
Bei Aztec-Barcodes können Sie die Quelldaten in bis zu 26 Datenblöcke aufteilen und diese in 26 Aztec-Barcodes kodieren.
Bei PDF417-Barcodes ermöglicht die Structure-Append-Technologie die Aufteilung der Quelldaten in 99.999 Datenblöcke.
Und bei Code16K-Barcodes ermöglicht die Structure-Append-Technologie 9 Datenblöcke.
Jeder Barcode mit einem Datenblock enthält die Position des Datenblocks in den Quelldaten. Dadurch können Barcodes mit Datenblöcken im Bild in beliebiger Reihenfolge angeordnet werden. Diese Funktion ermöglicht die optimale Platzierung von Barcodes auf einem Bild.
Hier ist C#-Code, mit dem Sie einen Aztec-Barcode mit dem Text "VintaSoft Barcode .NET SDK ist die professionelle 1D- und 2D-Barcode-Lese- und Barcode-Generator-Bibliothek für .NET, WPF und WEB." generieren können.
/// <summary>
/// Generates Aztec barcode as raster image.
/// </summary>
public void GenerateAztecBarcode()
{
// create the barcode writer
Vintasoft.Barcode.BarcodeWriter barcodeWriter = new Vintasoft.Barcode.BarcodeWriter();
// set barcode writer settings
barcodeWriter.Settings.Barcode = Vintasoft.Barcode.BarcodeType.Aztec;
barcodeWriter.Settings.Value = "VintaSoft Barcode .NET SDK is the professional 1D & 2D barcode reader and barcode generator library for .NET, WPF and WEB.";
// get barcode as image
using (System.Drawing.Image barcodeImage = barcodeWriter.GetBarcodeAsBitmap())
{
// save the barcode image to a file
barcodeImage.Save("aztec-barcode.png");
}
}
Hier ist das Bild des generierten Aztec-Barcodes:
Hier ist C#-Code, mit dem Sie die im generierten Aztec-Barcode kodierten Daten lesen können:
/// <summary>
/// Recognizes Aztec barcode in image.
/// </summary>
/// <param name="barcodeImageFilePath">A path to a barcode image file.</param>
public void RecognizeAztecBarcode()
{
// create barcode reader
using (Vintasoft.Barcode.BarcodeReader reader = new Vintasoft.Barcode.BarcodeReader())
{
// specify that reader must search for Aztec barcodes
reader.Settings.ScanBarcodeTypes = Vintasoft.Barcode.BarcodeType.Aztec;
// specify that reader must search for horizontal barcodes only
reader.Settings.ScanDirection = Vintasoft.Barcode.ScanDirection.Horizontal;
// read barcodes from image file
Vintasoft.Barcode.IBarcodeInfo[] barcodeInfos = reader.ReadBarcodes("aztec-barcode.png");
// if barcodes are not detected
if (barcodeInfos.Length == 0)
{
System.Console.WriteLine("Barcodes are not found.");
}
// if barcodes are detected
else
{
// get information about recognized barcodes
System.Console.WriteLine(string.Format("{0} barcode(s) found:", barcodeInfos.Length));
System.Console.WriteLine();
for (int i = 0; i < barcodeInfos.Length; i++)
{
Vintasoft.Barcode.IBarcodeInfo barcodeInfo = barcodeInfos[i];
System.Console.WriteLine(string.Format("[{0}:{1}]", i + 1, barcodeInfo.BarcodeType));
System.Console.WriteLine(string.Format("Value: {0}", barcodeInfo.Value));
System.Console.WriteLine(string.Format("Region: {0}", barcodeInfo.Region));
System.Console.WriteLine();
}
}
}
}
Hier ist das Ergebnis des Lesens der Daten aus dem generierten Aztec-Barcode:
1 barcode(s) found:
[1:Aztec]
Value: VintaSoft Barcode .NET SDK is the professional 1D & 2D barcode reader and barcode generator library for .NET, WPF and WEB.
Der Aztec-Barcode ist quadratisch, was zu einer suboptimalen Platznutzung im Bild führen kann, wenn der Barcode in einem rechteckigen Bereich platziert werden soll.
Daher teilen wir den Text des Barcodes in vier Datenblöcke auf. Anstatt eines einzelnen Barcodes erstellen wir vier Barcodes und platzieren diese vier Barcodes horizontal, um den für die Positionierung des Barcodes vorgesehenen rechteckigen Bereich optimal zu nutzen.
Hier ist C#-Code, der den Text "VintaSoft Barcode .NET SDK ist die professionelle 1D- und 2D-Barcode-Lese- und Barcode-Generator-Bibliothek für .NET, WPF und WEB." in 4 Datenblöcke unterteilt, 4 Aztec-Barcodes aus diesen Datenblöcken generiert und die Aztec-Barcodes horizontal anordnet:
/// <summary>
/// Generates several Aztec barcodes with structure append information and aligns barcodes horizontally.
/// </summary>
public void GenerateAztecBarcodesWithStructureAppendAndAlignBarcodeHorizontally()
{
// source text
string text = "VintaSoft Barcode .NET SDK is the professional 1D & 2D barcode reader and barcode generator library for .NET, WPF and WEB.";
// count of text blocks
int textBlockCount = 4;
// maximum length of text block
int textBlockLen = text.Length / textBlockCount;
if ((text.Length % textBlockCount) != 0)
textBlockLen++;
// array with barcode images
System.Drawing.Image[] barcodeImages = new System.Drawing.Image[textBlockCount];
// for each text block
for (int i = 0; i < textBlockCount; i++)
{
// calculate text block string
string textBlock = text.Substring(0, textBlockLen);
text = text.Substring(textBlockLen);
// generate barcode image with text block
barcodeImages[i] = GenerateImageOfAztecBarcodeWithStructureAppendInformation(textBlock, i + 1, textBlockCount);
}
// width of image with merged barcodes
int mergedBarcodeWidth = 0;
// for each barcode image
for (int i = 0; i < barcodeImages.Length; i++)
{
// increase width of image with merged barcodes
mergedBarcodeWidth += barcodeImages[i].Width;
}
// calculate height of image with merged barcodes
int mergedBarcodeHeight = barcodeImages[0].Height;
// create image with merged barcodes
using (System.Drawing.Image mergedBarcodesImage = new System.Drawing.Bitmap(mergedBarcodeWidth, mergedBarcodeHeight))
{
// create Graphics for drawing on image with merged barcodes
using (System.Drawing.Graphics g = System.Drawing.Graphics.FromImage(mergedBarcodesImage))
{
// fill image with merged barcodes using white color
g.FillRectangle(System.Drawing.Brushes.White, new System.Drawing.RectangleF(0, 0, mergedBarcodesImage.Width, mergedBarcodesImage.Height));
// the horizontal position of barcode image on image with merged barcodes
int barcodeXPosition = 0;
// for each barcode image
for (int i = 0; i < barcodeImages.Length; i++)
{
// draw barcode image on image with merged barcodes
g.DrawImage(barcodeImages[i], new System.Drawing.PointF(barcodeXPosition, 0));
// change the horizontal position of barcode image on image with merged barcodes
barcodeXPosition += barcodeImages[i].Width;
}
}
// save image with merged barcodes to a file
mergedBarcodesImage.Save("aztec-barcodes-with-structure-append-and-aligned-horizontally.png");
}
// for each barcode image
for (int i = 0; i < barcodeImages.Length; i++)
{
// dispose barcode image
barcodeImages[i].Dispose();
}
}
/// <summary>
/// Generates an image of Aztec barcode, which contains information about the structure append.
/// </summary>
/// <param name="barcodeValue">Barcode value.</param>
/// <param name="symbolPosition">Value position in structure append. Value from 1 to <i>symbolCount</i>.</param>
/// <param name="symbolCount">Count of values in structure append.</param>
/// <returns>An image of Aztec barcode, which contains information about the structure append.</returns>
public System.Drawing.Image GenerateImageOfAztecBarcodeWithStructureAppendInformation(string barcodeValue, int symbolPosition, int symbolCount)
{
// create the barcode writer
Vintasoft.Barcode.BarcodeWriter barcodeWriter = new Vintasoft.Barcode.BarcodeWriter();
// specify that Aztec barcode must be created
barcodeWriter.Settings.Barcode = Vintasoft.Barcode.BarcodeType.Aztec;
// specify that created Aztec barcode should not have padding
barcodeWriter.Settings.Padding = 0;
// specify the barcode values
barcodeWriter.Settings.ValueItems = new Vintasoft.Barcode.BarcodeInfo.ValueItemBase[] {
// create the non-data flag that contains information about structure append
Vintasoft.Barcode.BarcodeInfo.NonDataFlags.CreateAztecStructuredAppendCharacter(symbolPosition, symbolCount, null),
// create a text value item
new Vintasoft.Barcode.BarcodeInfo.TextValueItem(barcodeValue)
};
// return generated barcode image
return barcodeWriter.GetBarcodeAsBitmap();
}
Hier ist das Bild der generierten Aztec-Barcodes mit Datenblöcken:
Das Bild mit den Aztec-Barcodes und Datenblöcken hat eine rechteckige Form und kann daher optimal in einem rechteckigen Bereich platziert werden.
Hier ist C#-Code, der Daten aus generierten Aztec-Barcodes erkennt und die Datenblöcke zu den Originaldaten zusammenfügt:
/// <summary>
/// Recognizes Aztec barcodes with structure append information.
/// </summary>
/// <param name="barcodeImageFilePath">A path to a barcode image file.</param>
public void RecognizeAztecBarcodesWithStructureAppend()
{
// create barcode reader
using (Vintasoft.Barcode.BarcodeReader reader = new Vintasoft.Barcode.BarcodeReader())
{
// specify that reader must search for Aztec barcodes
reader.Settings.ScanBarcodeTypes = Vintasoft.Barcode.BarcodeType.Aztec;
// specify that reader must search for horizontal barcodes only
reader.Settings.ScanDirection = Vintasoft.Barcode.ScanDirection.Horizontal;
// read barcodes from image file
Vintasoft.Barcode.IBarcodeInfo[] barcodeInfos = reader.ReadBarcodes("aztec-barcodes-with-structure-append-and-aligned-horizontally.png");
// if barcodes are not detected
if (barcodeInfos.Length == 0)
{
System.Console.WriteLine("Barcodes are not found.");
}
// if barcodes are detected
else
{
// reconstruct barcode info from barcode infos with structure append information
Vintasoft.Barcode.BarcodeInfo.StructuredAppendBarcodeInfo[] reconstructedBarcodeInfos =
Vintasoft.Barcode.BarcodeInfo.StructuredAppendBarcodeInfo.ReconstructFrom(barcodeInfos);
// get information about recognized barcodes
System.Console.WriteLine(string.Format("{0} reconstructed barcode(s) found:", reconstructedBarcodeInfos.Length));
System.Console.WriteLine();
for (int i = 0; i < reconstructedBarcodeInfos.Length; i++)
{
Vintasoft.Barcode.BarcodeInfo.StructuredAppendBarcodeInfo reconstructedBarcodeInfo = reconstructedBarcodeInfos[i];
System.Console.WriteLine(string.Format("[{0}:{1}]", i + 1, reconstructedBarcodeInfo.BarcodeType));
System.Console.WriteLine(string.Format("Value: {0}", reconstructedBarcodeInfo.Value));
System.Console.WriteLine();
}
}
}
}
Hier ist das Ergebnis der Erkennung aus generierten Aztec-Barcodes mit Datenblöcken:
1 reconstructed barcode(s) found:
[1:Aztec]
Value: VintaSoft Barcode .NET SDK is the professional 1D & 2D barcode reader and barcode generator library for .NET, WPF and WEB.
Aztec-Barcodes benötigen keine Ruhezone um den Barcode herum, wodurch die Barcodes eng beieinander platziert werden können.
