Merge pull request #80 from aspose-barcode/agent/one-dimensional-barcode-types/2026-07-07-225936

feat: Add Aspose.BarCode .NET C# Examples — One Dimensional Barcode Types

Author: asadalikhan90

one-dimensional-barcode-types/adjust-barcode-text-font-to-arial-size-12-pt-and-center-text-beneath-bars.cs

@@ -1,33 +1,39 @@
+// Title: Adjust barcode text font and alignment
+// Description: Demonstrates how to set the barcode's human‑readable text to Arial 12 pt and center it beneath the bars.
+// Category-Description: This example belongs to the Aspose.BarCode generation category, illustrating how to customize CodeTextParameters such as font, size, alignment, and location. It uses the BarcodeGenerator class together with EncodeTypes and CodeTextParameters to produce barcodes with tailored human‑readable text. Developers often need to modify these settings to match branding guidelines or improve readability in printed materials.
+// Prompt: Adjust barcode text font to Arial, size 12 pt, and center the text beneath the bars.
+// Tags: barcode, code128, font, alignment, textlocation, generation, aspnet, aspose.barcode
+
 using System;
 using Aspose.BarCode;
 using Aspose.BarCode.Generation;
 
 /// <summary>
-/// Demonstrates generating a Code128 barcode using Aspose.BarCode and saving it as a PNG file.
+/// Demonstrates adjusting barcode text font to Arial 12 pt and centering it below the bars.
 /// </summary>
 class Program
 {
     /// <summary>
-    /// Entry point of the application. Creates a barcode, configures its appearance, and saves it.
+    /// Generates a Code128 barcode with customized text appearance and saves it as PNG.
     /// </summary>
     static void Main()
     {
-        // Initialize a BarcodeGenerator for Code128 with the desired text
-        using (var generator = new BarcodeGenerator(EncodeTypes.Code128, "Sample123"))
+        // Initialize a barcode generator for Code128 with the sample value "1234567890"
+        using (var generator = new BarcodeGenerator(EncodeTypes.Code128, "1234567890"))
         {
-            // Configure the human‑readable text font: Arial, 12 pt
+            // Configure the human‑readable text font: Arial, 12 pt
             generator.Parameters.Barcode.CodeTextParameters.Font.FamilyName = "Arial";
             generator.Parameters.Barcode.CodeTextParameters.Font.Size.Point = 12f;
 
             // Align the text to the center and position it below the barcode bars
             generator.Parameters.Barcode.CodeTextParameters.Alignment = TextAlignment.Center;
             generator.Parameters.Barcode.CodeTextParameters.Location = CodeLocation.Below;
 
-            // Save the generated barcode image to a PNG file named "barcode.png"
+            // Save the generated barcode image to a PNG file
             generator.Save("barcode.png");
         }
 
-        // Inform the user that the barcode has been generated and saved
-        Console.WriteLine("Barcode generated and saved as 'barcode.png'.");
+        // Inform the user that the barcode has been created
+        Console.WriteLine("Barcode generated: barcode.png");
     }
 }

one-dimensional-barcode-types/align-barcode-text-to-center-and-enable-automatic-scaling-to-fit-within-narrow-barcode-width.cs

@@ -1,41 +1,47 @@
+// Title: Center-aligned barcode text with automatic scaling
+// Description: Demonstrates how to center the human‑readable text of a Code128 barcode and enable automatic scaling to fit a narrow image width.
+// Category-Description: This example belongs to the Aspose.BarCode generation category, illustrating the use of BarcodeGenerator, EncodeTypes, and related parameter classes to customize barcode appearance. Typical scenarios include creating compact barcodes for limited‑space labels while preserving readability. Developers often need to adjust text alignment, font sizing, and image dimensions to meet layout constraints.
+// Prompt: Align barcode text to center and enable automatic scaling to fit within narrow barcode width.
+// Tags: code128, text alignment, auto scaling, png, aspose.barcode, barcode generation
+
 using System;
 using Aspose.BarCode;
 using Aspose.BarCode.Generation;
+using Aspose.Drawing;
 
 /// <summary>
-/// Demonstrates generating a Code128 barcode image using Aspose.BarCode.
+/// Generates a Code128 barcode with centered human‑readable text and automatic scaling
+/// to fit a narrow image width, then saves it as a PNG file.
 /// </summary>
 class Program
 {
     /// <summary>
-    /// Entry point of the application. Generates a barcode and saves it to a PNG file.
+    /// Entry point of the example. Creates a barcode, configures text alignment and scaling,
+    /// and writes the result to "barcode.png".
     /// </summary>
     static void Main()
     {
-        // Define the output file path for the generated barcode image.
-        string outputPath = "barcode.png";
-
-        // Create a BarcodeGenerator instance configured for Code128 encoding.
+        // Initialize a barcode generator for the Code128 symbology.
         using (var generator = new BarcodeGenerator(EncodeTypes.Code128))
         {
-            // Set the text that will be encoded into the barcode.
+            // Set the data that will be encoded in the barcode.
             generator.CodeText = "1234567890";
 
-            // Align the human‑readable text (the code text) to the center of the barcode.
-            generator.Parameters.Barcode.CodeTextParameters.Alignment = TextAlignment.Center;
-
-            // Enable automatic scaling to fit a narrow width while preserving image quality.
+            // Configure automatic scaling (interpolation) so the barcode adapts to the image size.
             generator.Parameters.AutoSizeMode = AutoSizeMode.Interpolation;
 
-            // Specify the desired image dimensions in points (1 point = 1/72 inch).
-            generator.Parameters.ImageWidth.Point = 150f;   // Narrow width
-            generator.Parameters.ImageHeight.Point = 50f;   // Height
+            // Define a narrow image width (150 points) and a suitable height (50 points).
+            generator.Parameters.ImageWidth.Point = 150f;
+            generator.Parameters.ImageHeight.Point = 50f;
 
-            // Save the generated barcode image to the specified file path.
-            generator.Save(outputPath);
-        }
+            // Center‑align the human‑readable text beneath the barcode.
+            generator.Parameters.Barcode.CodeTextParameters.Alignment = TextAlignment.Center;
 
-        // Inform the user that the barcode image has been saved.
-        Console.WriteLine($"Barcode image saved to: {outputPath}");
+            // Enable automatic font sizing so the text scales proportionally with the barcode.
+            generator.Parameters.Barcode.CodeTextParameters.FontMode = FontMode.Auto;
+
+            // Save the generated barcode image to a PNG file.
+            generator.Save("barcode.png");
+        }
     }
 }

one-dimensional-barcode-types/align-barcode-text-to-center-enable-automatic-scaling-and-generate-image-suitable-for-narrow-receipt-printing.cs

@@ -1,65 +1,56 @@
+// Title: Center-aligned Code128 barcode with auto scaling for receipt printing
+// Description: Generates a Code128 barcode with centered human‑readable text, automatic scaling, and a narrow image suitable for receipt printers.
+// Category-Description: This example demonstrates Aspose.BarCode generation features such as setting image dimensions, resolution, text alignment, and auto‑scaling. It uses the BarcodeGenerator, EncodeTypes, and related parameter classes to create barcodes for point‑of‑sale scenarios where narrow, high‑resolution images are required. Developers often need to customize size, DPI, and text appearance for receipt or label printing.
+// Prompt: Align barcode text to center, enable automatic scaling, and generate image suitable for narrow receipt printing.
+// Tags: code128, barcode, auto-scaling, receipt, png, aspose.barcode, generation
+
 using System;
 using Aspose.BarCode;
 using Aspose.BarCode.Generation;
+using Aspose.Drawing;
 
 /// <summary>
-/// Demonstrates generating a Code128 barcode image suitable for narrow receipts using Aspose.BarCode.
+/// Demonstrates how to generate a narrow, center‑aligned Code128 barcode with automatic scaling,
+/// suitable for receipt printers.
 /// </summary>
 class Program
 {
     /// <summary>
-    /// Entry point of the application. Generates a barcode and saves it to a PNG file.
+    /// Entry point of the example. Creates a barcode, configures scaling and alignment,
+    /// and saves the result as a PNG image.
     /// </summary>
     static void Main()
     {
-        // Define the output file path for the generated barcode image.
-        string outputPath = "receipt_barcode.png";
+        // Text to be encoded in the barcode.
+        const string codeText = "1234567890";
 
-        // Initialize a BarcodeGenerator for Code128 with the sample data "1234567890".
-        using (var generator = new BarcodeGenerator(EncodeTypes.Code128, "1234567890"))
+        // Initialize the barcode generator for Code128 symbology.
+        using (var generator = new BarcodeGenerator(EncodeTypes.Code128, codeText))
         {
-            // ------------------------------------------------------------
-            // Configure image sizing and resolution
-            // ------------------------------------------------------------
-
-            // Enable automatic scaling (interpolation) to adapt the barcode to narrow receipt widths.
+            // Enable automatic scaling (interpolation) to fit the target image size.
             generator.Parameters.AutoSizeMode = AutoSizeMode.Interpolation;
 
-            // Set the target image dimensions in points (1 point = 1/72 inch).
-            generator.Parameters.ImageWidth.Point = 200f;   // Width of the barcode image.
-            generator.Parameters.ImageHeight.Point = 80f;   // Height of the barcode image.
-
-            // Use a high resolution (dots per inch) for crisp printing on receipts.
-            generator.Parameters.Resolution = 300f;
+            // Define a narrow receipt width and modest height (points).
+            generator.Parameters.ImageWidth.Point = 200f;   // Width in points.
+            generator.Parameters.ImageHeight.Point = 50f;   // Height in points.
 
-            // ------------------------------------------------------------
-            // Configure human‑readable text appearance
-            // ------------------------------------------------------------
+            // Set the printer resolution typical for receipt printers (203 DPI).
+            generator.Parameters.Resolution = 203f;
 
-            // Center the barcode's human‑readable text horizontally beneath the bars.
+            // Center‑align the human‑readable text beneath the barcode.
             generator.Parameters.Barcode.CodeTextParameters.Alignment = TextAlignment.Center;
 
-            // Set a readable font size for the human‑readable text (in points).
-            generator.Parameters.Barcode.CodeTextParameters.Font.Size.Point = 10f;
+            // Ensure the text font scales automatically with the barcode size.
+            generator.Parameters.Barcode.CodeTextParameters.FontMode = FontMode.Auto;
 
-            // ------------------------------------------------------------
-            // Configure padding around the barcode within the image
-            // ------------------------------------------------------------
-
-            // Apply a small uniform padding to keep the barcode away from the image edges.
-            generator.Parameters.Barcode.Padding.Left.Point   = 2f;
-            generator.Parameters.Barcode.Padding.Right.Point  = 2f;
-            generator.Parameters.Barcode.Padding.Top.Point    = 2f;
-            generator.Parameters.Barcode.Padding.Bottom.Point = 2f;
-
-            // ------------------------------------------------------------
-            // Save the generated barcode image to the specified file
-            // ------------------------------------------------------------
+            // Set barcode bar color to black and background to white.
+            generator.Parameters.Barcode.BarColor = Color.Black;
+            generator.Parameters.BackColor = Color.White;
 
+            // Save the generated barcode image to a PNG file.
+            const string outputPath = "receipt_barcode.png";
             generator.Save(outputPath);
+            Console.WriteLine($"Barcode saved to {outputPath}");
         }
-
-        // Inform the user where the barcode image has been saved.
-        Console.WriteLine($"Barcode image saved to: {outputPath}");
     }
 }

one-dimensional-barcode-types/align-barcode-text-to-left-enable-automatic-scaling-and-generate-image-suitable-for-narrow-column-layout.cs

@@ -1,42 +1,45 @@
+// Title: Align Code128 barcode text left with auto‑scaling for narrow column layout
+// Description: Demonstrates how to left‑align human‑readable text, enable automatic scaling, and set image size for a narrow column using Aspose.BarCode.
+// Category-Description: This example belongs to the Aspose.BarCode image generation category, illustrating the use of BarcodeGenerator, EncodeTypes, and Parameters classes to customize barcode appearance. Typical scenarios include creating compact barcodes for reports, invoices, or mobile screens where space is limited. Developers often need to control text alignment, scaling mode, and image dimensions to fit specific layout constraints.
+// Prompt: Align barcode text to left, enable automatic scaling, and generate image suitable for narrow column layout.
+// Tags: code128, alignment, autoscaling, png, barcodegenerator, parameters, aspose.barcode, imagegeneration
+
 using System;
 using Aspose.BarCode;
 using Aspose.BarCode.Generation;
+using Aspose.Drawing;
 
 /// <summary>
-/// Demonstrates generation of a narrow‑column Code128 barcode using Aspose.BarCode.
+/// Generates a Code128 barcode with left‑aligned text, automatic scaling, and a compact image size.
 /// </summary>
 class Program
 {
     /// <summary>
-    /// Entry point of the application. Generates a barcode image and saves it to disk.
+    /// Entry point that creates and saves the barcode image.
     /// </summary>
     static void Main()
     {
-        // Define the file path where the generated barcode image will be saved.
-        string outputPath = "narrow_column_barcode.png";
-
-        // Create a BarcodeGenerator instance for Code128 with the sample text "123456".
-        // The generator is wrapped in a using statement to ensure proper disposal.
-        using (var generator = new BarcodeGenerator(EncodeTypes.Code128, "123456"))
+        // Initialize a barcode generator for Code128 with the sample value.
+        using (var generator = new BarcodeGenerator(EncodeTypes.Code128, "1234567890"))
         {
-            // Align the human‑readable text (the encoded value) to the left side of the barcode.
-            generator.Parameters.Barcode.CodeTextParameters.Alignment = TextAlignment.Left;
-
-            // Enable automatic scaling so the barcode fits the specified image dimensions.
+            // Enable automatic scaling using interpolation to fit the specified dimensions.
             generator.Parameters.AutoSizeMode = AutoSizeMode.Interpolation;
 
-            // Set the target image width and height (in points) to create a narrow column appearance.
-            generator.Parameters.ImageWidth.Point = 150f;   // narrow width
-            generator.Parameters.ImageHeight.Point = 50f;   // appropriate height
+            // Define image size (points) suitable for a narrow column layout.
+            generator.Parameters.ImageWidth.Point = 150f;
+            generator.Parameters.ImageHeight.Point = 50f;
+
+            // Align the human‑readable text to the left side of the barcode.
+            generator.Parameters.Barcode.CodeTextParameters.Alignment = TextAlignment.Left;
 
-            // Optionally increase the resolution to 300 DPI for higher quality output.
-            generator.Parameters.Resolution = 300f;
+            // Optional: adjust the module (X) dimension for clearer rendering at small sizes.
+            generator.Parameters.Barcode.XDimension.Point = 2f;
 
-            // Save the generated barcode image to the specified file path.
-            generator.Save(outputPath);
+            // Save the generated barcode as a PNG file.
+            generator.Save("barcode.png");
         }
 
-        // Inform the user that the barcode image has been saved.
-        Console.WriteLine($"Barcode image saved to: {outputPath}");
+        // Inform the user that the image has been created.
+        Console.WriteLine("Barcode image generated: barcode.png");
     }
 }