Merge pull request #77 from aspose-barcode/agent/mailmark-four-state-barcode/2026-07-06-212246

feat: Add Aspose.BarCode .NET C# Examples — Mailmark Four State Barcode

Author: asadalikhan90

mailmark-four-state-barcode/adjust-barcode-module-size-to-produce-compact-mailmark-barcode-suitable-for-small-labels.cs

@@ -1,56 +1,68 @@
+// Title: Generate a compact Mailmark barcode for small labels
+// Description: Demonstrates how to adjust the module size and padding of a Mailmark barcode to create a compact image suitable for small label printing.
+// Category-Description: This example belongs to the Aspose.BarCode barcode generation category, focusing on complex barcode symbologies such as Mailmark. It showcases the use of ComplexBarcodeGenerator, MailmarkCodetext, and barcode parameter settings like XDimension, AutoSizeMode, and padding. Developers often need to create high‑density barcodes for limited space applications, and this snippet provides a concise reference for those scenarios.
+// Prompt: Adjust barcode module size to produce a compact Mailmark barcode suitable for small labels.
+// Tags: mailmark, barcode, module size, compact, small labels, generation, aspose.barcode
+
 using System;
+using System.IO;
 using Aspose.BarCode;
 using Aspose.BarCode.Generation;
 using Aspose.BarCode.ComplexBarcode;
 using Aspose.BarCode.BarCodeRecognition;
-using Aspose.Drawing.Imaging;
+using Aspose.Drawing;
 
 /// <summary>
-/// Demonstrates generation of a Mailmark barcode using Aspose.BarCode library.
+/// Program demonstrating compact Mailmark barcode generation.
 /// </summary>
 class Program
 {
     /// <summary>
-    /// Entry point of the application. Generates a Mailmark barcode image and saves it to disk.
+    /// Entry point. Generates a Mailmark barcode with reduced module size and padding, then saves it as PNG.
     /// </summary>
     static void Main()
     {
-        // Prepare Mailmark data (valid sample)
-        var mailmark = new MailmarkCodetext
-        {
-            // 4‑state format identifier
-            Format = 4,
-            // Version identifier
-            VersionID = 1,
-            // Test class identifier
-            Class = "0",
-            // Supply chain identifier
-            SupplychainID = 384224,
-            // Item identifier
-            ItemID = 16563762,
-            // Destination postcode plus DP suffix (trailing space is intentional)
-            DestinationPostCodePlusDPS = "EF61AH8T "
-        };
-
-        // Create a generator for the Mailmark barcode using the prepared data
+        // Prepare Mailmark codetext with required fields
+        var mailmark = new MailmarkCodetext();
+        mailmark.Format = 4; // unspecified/default format for compact barcode
+        mailmark.VersionID = 1;
+        mailmark.Class = "0";
+        mailmark.SupplychainID = 384224;
+        mailmark.ItemID = 16563762;
+        mailmark.DestinationPostCodePlusDPS = "EF61AH8T ";
+
+        // Create ComplexBarcodeGenerator for Mailmark
         using (var generator = new ComplexBarcodeGenerator(mailmark))
         {
-            // Reduce the module size (XDimension) for a tighter barcode appearance
-            generator.Parameters.Barcode.XDimension.Point = 0.5f;
+            // Use interpolation auto-size mode so that XDimension controls overall size
+            generator.Parameters.AutoSizeMode = AutoSizeMode.Interpolation;
 
-            // Enable auto‑size mode to automatically fit the barcode within the target dimensions
-            generator.Parameters.AutoSizeMode = AutoSizeMode.Nearest;
+            // Set a small module (dot) size for compactness
+            generator.Parameters.Barcode.XDimension.Point = 0.5f; // 0.5 point per module
 
-            // Define the target image dimensions (in points)
-            generator.Parameters.ImageWidth.Point = 200f;   // Desired image width
-            generator.Parameters.ImageHeight.Point = 100f;  // Desired image height
+            // Reduce padding to keep the barcode tight on small labels
+            generator.Parameters.Barcode.Padding.Left.Point = 1f;
+            generator.Parameters.Barcode.Padding.Top.Point = 1f;
+            generator.Parameters.Barcode.Padding.Right.Point = 1f;
+            generator.Parameters.Barcode.Padding.Bottom.Point = 1f;
 
-            // Save the generated barcode as a PNG file
-            string outputPath = "mailmark.png";
-            generator.Save(outputPath, BarCodeImageFormat.Png);
+            // Optional: set foreground and background colors
+            generator.Parameters.Barcode.BarColor = Color.Black;
+            generator.Parameters.BackColor = Color.White;
 
-            // Inform the user where the file was saved
-            Console.WriteLine($"Mailmark barcode saved to {outputPath}");
+            // Define output path
+            string outputPath = "mailmark_compact.png";
+
+            // Ensure the directory exists
+            string directory = Path.GetDirectoryName(Path.GetFullPath(outputPath));
+            if (!Directory.Exists(directory))
+            {
+                Directory.CreateDirectory(directory);
+            }
+
+            // Save the barcode image
+            generator.Save(outputPath, BarCodeImageFormat.Png);
+            Console.WriteLine($"Compact Mailmark barcode saved to: {outputPath}");
         }
     }
 }

mailmark-four-state-barcode/batch-generate-mailmark-barcodes-from-customer-records-saving-each-as-separate-bmp-files.cs

@@ -1,3 +1,9 @@
+// Title: Batch Mailmark Barcode Generation to BMP Files
+// Description: Demonstrates generating Mailmark barcodes for a list of customer records and saving each barcode as an individual BMP image.
+// Category-Description: This example belongs to the Aspose.BarCode generation category, focusing on complex barcode types such as Mailmark. It showcases the use of Aspose.BarCode.Generation.ComplexBarcodeGenerator and Aspose.BarCode.ComplexBarcode.MailmarkCodetext to create barcodes programmatically. Developers often need to batch‑process records, embed specific data fields, and export barcodes to image formats for printing or archival purposes.
+// Prompt: Batch generate Mailmark barcodes from customer records, saving each as separate BMP files.
+// Tags: mailmark, barcode, generation, bmp, aspose.barcode, complexbarcode
+
 using System;
 using System.Collections.Generic;
 using System.IO;
@@ -6,62 +12,53 @@
 using Aspose.BarCode.ComplexBarcode;
 
 /// <summary>
-/// Demonstrates generation of Mailmark barcodes using Aspose.BarCode library.
+/// Generates Mailmark barcodes for a collection of customer records and saves each barcode as a BMP file.
 /// </summary>
 class Program
 {
     /// <summary>
-    /// Entry point of the application. Generates a set of Mailmark barcodes and saves them as BMP files.
+    /// Entry point of the application. Creates an output folder, iterates over sample records,
+    /// builds Mailmark codetext, generates the barcode, and writes it to disk.
     /// </summary>
     static void Main()
     {
-        // --------------------------------------------------------------------
-        // Prepare output directory where barcode images will be saved.
-        // --------------------------------------------------------------------
+        // Define the output directory and ensure it exists
         string outputDir = Path.Combine(Directory.GetCurrentDirectory(), "MailmarkBarcodes");
         if (!Directory.Exists(outputDir))
         {
             Directory.CreateDirectory(outputDir);
         }
 
-        // --------------------------------------------------------------------
-        // Sample customer records (limited to a safe batch size).
-        // Each record is represented by a MailmarkCodetext instance.
-        // --------------------------------------------------------------------
-        var customers = new List<MailmarkCodetext>
+        // Sample customer records (limited to 5 for safe execution)
+        var records = new List<(int ItemID, string DestinationPostCodePlusDPS)>
         {
-            new MailmarkCodetext { Format = 4, VersionID = 1, Class = "0", SupplychainID = 384224, ItemID = 16563762, DestinationPostCodePlusDPS = "EF61AH8T " },
-            new MailmarkCodetext { Format = 4, VersionID = 1, Class = "1", SupplychainID = 384224, ItemID = 16563763, DestinationPostCodePlusDPS = "EF61AH8T " },
-            new MailmarkCodetext { Format = 4, VersionID = 1, Class = "2", SupplychainID = 384224, ItemID = 16563764, DestinationPostCodePlusDPS = "EF61AH8T " },
-            new MailmarkCodetext { Format = 4, VersionID = 1, Class = "3", SupplychainID = 384224, ItemID = 16563765, DestinationPostCodePlusDPS = "EF61AH8T " },
-            new MailmarkCodetext { Format = 4, VersionID = 1, Class = "4", SupplychainID = 384224, ItemID = 16563766, DestinationPostCodePlusDPS = "EF61AH8T " }
+            (16563762, "EF61AH8T "),
+            (16563763, "EF61AH8T "),
+            (16563764, "EF61AH8T "),
+            (16563765, "EF61AH8T "),
+            (16563766, "EF61AH8T ")
         };
 
-        // --------------------------------------------------------------------
-        // Iterate over each customer record, generate the barcode, and save it.
-        // --------------------------------------------------------------------
         int index = 1;
-        foreach (var mailmark in customers)
+        foreach (var record in records)
         {
-            // Build a unique file name for each barcode image.
-            string fileName = $"Mailmark_{index:D3}.bmp";
-            string filePath = Path.Combine(outputDir, fileName);
-
-            try
+            // Build the Mailmark codetext with required fields for each record
+            var mailmark = new MailmarkCodetext
             {
-                // Generate the barcode using the ComplexBarcodeGenerator.
-                using (var generator = new ComplexBarcodeGenerator(mailmark))
-                {
-                    // Save the generated barcode as a BMP file.
-                    generator.Save(filePath, BarCodeImageFormat.Bmp);
-                }
+                Format = 4,                     // 4‑state (unspecified/default)
+                VersionID = 1,
+                Class = "0",                    // Test/Null class
+                SupplychainID = 384224,
+                ItemID = record.ItemID,
+                DestinationPostCodePlusDPS = record.DestinationPostCodePlusDPS
+            };
 
-                Console.WriteLine($"Generated: {filePath}");
-            }
-            catch (Exception ex)
+            // Generate the barcode and save it as a BMP image
+            using (var generator = new ComplexBarcodeGenerator(mailmark))
             {
-                // Log any errors that occur during barcode generation.
-                Console.WriteLine($"Failed to generate barcode for record {index}: {ex.Message}");
+                string filePath = Path.Combine(outputDir, $"Mailmark_{index}.bmp");
+                generator.Save(filePath, BarCodeImageFormat.Bmp);
+                Console.WriteLine($"Saved Mailmark barcode to: {filePath}");
             }
 
             index++;

mailmark-four-state-barcode/compare-performance-of-generating-mailmark-barcodes-as-png-versus-jpeg-by-measuring-file-size-and-generation-time.cs

@@ -1,65 +1,85 @@
+// Title: Mailmark Barcode Generation Performance: PNG vs JPEG
+// Description: Demonstrates measuring generation time and file size when creating Mailmark barcodes in PNG and JPEG formats.
+// Category-Description: This example belongs to the Aspose.BarCode generation category, showcasing the use of ComplexBarcodeGenerator to produce Mailmark symbology. It illustrates typical tasks such as configuring Mailmark codetext, rendering barcodes to different image formats, and profiling performance—common needs for developers integrating barcode creation into high‑throughput or size‑sensitive applications. The snippet highlights key API classes like MailmarkCodetext, ComplexBarcodeGenerator, and BarCodeImageFormat, serving as a reference for performance‑oriented barcode generation scenarios.
+/// Prompt: Compare performance of generating Mailmark barcodes as PNG versus JPEG by measuring file size and generation time.
+/// Tags: mailmark, barcode, performance, png, jpeg, generation, aspose.barcode, complexbarcodegenerator
+
 using System;
 using System.Diagnostics;
 using System.IO;
 using Aspose.BarCode;
 using Aspose.BarCode.Generation;
 using Aspose.BarCode.ComplexBarcode;
+using Aspose.Drawing.Imaging;
 
 /// <summary>
-/// Demonstrates generation of Mailmark barcodes in PNG and JPEG formats,
-/// measuring generation time and optionally saving the images to disk.
+/// Generates Mailmark barcodes in PNG and JPEG formats and compares their generation time and file size.
 /// </summary>
 class Program
 {
     /// <summary>
-    /// Entry point of the application.
-    /// Prepares a Mailmark codetext, generates barcodes in two image formats,
-    /// measures performance, and writes the results to the console and files.
+    /// Entry point of the example. Prepares Mailmark data, renders the barcode in two image formats,
+    /// and outputs average generation time and file size for each format.
     /// </summary>
     static void Main()
     {
-        // Prepare a valid Mailmark codetext object with required properties.
+        // Prepare a valid Mailmark codetext with required fields.
         var mailmark = new MailmarkCodetext
         {
-            Format = 4,                     // 4‑state format
+            Format = 4,                 // 4‑state barcode
             VersionID = 1,
-            Class = "0",                    // string property representing class
+            Class = "0",
             SupplychainID = 384224,
             ItemID = 16563762,
-            DestinationPostCodePlusDPS = "EF61AH8T " // known‑valid value (trailing space intentional)
+            DestinationPostCodePlusDPS = "EF61AH8T "
+        };
+
+        // Define the image formats to be tested: PNG and JPEG.
+        var formats = new[]
+        {
+            BarCodeImageFormat.Png,
+            BarCodeImageFormat.Jpeg
         };
 
-        // Define the image formats to compare: PNG and JPEG.
-        var formats = new[] { BarCodeImageFormat.Png, BarCodeImageFormat.Jpeg };
+        const int iterations = 5; // Number of repetitions for averaging results.
 
-        // Iterate over each format, generate the barcode, and record metrics.
-        foreach (var fmt in formats)
+        // Iterate over each format and measure performance.
+        foreach (var format in formats)
         {
-            // Start timing the generation process.
-            var stopwatch = Stopwatch.StartNew();
+            long totalBytes = 0; // Accumulator for total file size.
+            long totalTicks = 0; // Accumulator for total elapsed ticks.
 
-            // Use a memory stream to hold the generated image data.
-            using (var memory = new MemoryStream())
+            // Run the generation multiple times to obtain average metrics.
+            for (int i = 0; i < iterations; i++)
             {
-                // Generate the Mailmark barcode and save it directly to the memory stream.
+                // Create a generator for the Mailmark barcode.
                 using (var generator = new ComplexBarcodeGenerator(mailmark))
                 {
-                    generator.Save(memory, fmt);
-                }
+                    // Use a memory stream to avoid disk I/O overhead.
+                    using (var ms = new MemoryStream())
+                    {
+                        // Start timing the Save operation.
+                        var sw = Stopwatch.StartNew();
+                        generator.Save(ms, format);
+                        sw.Stop();
 
-                // Stop the timer after generation completes.
-                stopwatch.Stop();
+                        // Accumulate elapsed time and resulting byte size.
+                        totalTicks += sw.ElapsedTicks;
+                        totalBytes += ms.Length;
+                    }
+                }
+            }
 
-                // Determine the appropriate file extension based on the format.
-                string extension = fmt == BarCodeImageFormat.Png ? ".png" : ".jpg";
-                string fileName = "Mailmark" + extension;
+            // Compute average generation time in milliseconds.
+            double avgMs = (totalTicks * 1000.0) / Stopwatch.Frequency / iterations;
+            // Compute average file size in kilobytes.
+            double avgKb = (totalBytes / 1024.0) / iterations;
 
-                // Write the image bytes to a file for optional visual verification.
-                File.WriteAllBytes(fileName, memory.ToArray());
+            // Friendly format name for output.
+            string formatName = format == BarCodeImageFormat.Png ? "PNG" : "JPEG";
 
-                // Output the size, generation time, and saved file name to the console.
-                Console.WriteLine($"{fmt} -> Size: {memory.Length} bytes, Generation Time: {stopwatch.ElapsedMilliseconds} ms, Saved As: {fileName}");
-            }
+            // Display the averaged results.
+            Console.WriteLine($"{formatName} - Average generation time: {avgMs:F2} ms, Average file size: {avgKb:F2} KB");
         }
     }
 }