How to use Image Correction Filters

using System;
using IronBarCode;

namespace BarcodeReaderExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create an instance of BarcodeReaderOptions
            // These options allow us to specify image processing filters to improve barcode reading accuracy
            BarcodeReaderOptions options = new BarcodeReaderOptions()
            {
                // Define the image filters to be applied in sequence
                ImageFilters = new ImageFilterCollection()
                {
                    new ImageFilter.Sharpen(3.5f),  // Apply sharpen filter with intensity 3.5
                    new ImageFilter.Contrast(2)     // Apply contrast filter with intensity 2
                },
            };

            try
            {
                // Apply options and read the barcode from the specified image file
                BarcodeResults results = BarcodeReader.Read("sample.png", options);

                // Loop through the results and output the text from each detected barcode
                foreach (BarcodeResult result in results)
                {
                    Console.WriteLine(result.Text);
                }
            }
            catch (Exception ex)
            {
                // Output error message if barcode reading fails
                Console.WriteLine($"An error occurred: {ex.Message}");
            }
        }
    }
}

Imports System
Imports IronBarCode

Namespace BarcodeReaderExample
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create an instance of BarcodeReaderOptions
			' These options allow us to specify image processing filters to improve barcode reading accuracy
			Dim options As New BarcodeReaderOptions() With {
				.ImageFilters = New ImageFilterCollection() From {
					New ImageFilter.Sharpen(3.5F),
					New ImageFilter.Contrast(2)
				}
			}

			Try
				' Apply options and read the barcode from the specified image file
				Dim results As BarcodeResults = BarcodeReader.Read("sample.png", options)

				' Loop through the results and output the text from each detected barcode
				For Each result As BarcodeResult In results
					Console.WriteLine(result.Text)
				Next result
			Catch ex As Exception
				' Output error message if barcode reading fails
				Console.WriteLine($"An error occurred: {ex.Message}")
			End Try
		End Sub
	End Class
End Namespace

using IronBarCode;

// This code demonstrates how to configure a barcode reader to read a barcode from an image.
// It applies image filters to improve the accuracy of the barcode reading process. 

// Configure barcode reader options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Create a collection of image filters and apply them in sequence.
    ImageFilters = new ImageFilterCollection(true)
    {
        // Apply an Adaptive Threshold filter with a threshold value of 0.9.
        // This filter enhances the image to make the barcode more visible.
        new AdaptiveThresholdFilter(0.9f),
    },
};

// Use the configured options to read the barcode from the specified image file
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export the processed images that have been filtered to the disk.
// This allows users to inspect or use the filtered images for further processing.
results.ExportFilterImagesToDisk("adaptiveThreshold_0.9.png");

Imports IronBarCode

' This code demonstrates how to configure a barcode reader to read a barcode from an image.
' It applies image filters to improve the accuracy of the barcode reading process. 

' Configure barcode reader options
Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New AdaptiveThresholdFilter(0.9F)}
}

' Use the configured options to read the barcode from the specified image file
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export the processed images that have been filtered to the disk.
' This allows users to inspect or use the filtered images for further processing.
results.ExportFilterImagesToDisk("adaptiveThreshold_0.9.png")

// Import necessary libraries for barcode processing
using IronBarCode;

// Set up barcode reader options with specified image filters
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true)
    {
        new BinaryThresholdFilter(0.9f) // Applying a binary threshold to the image
    }
};

// Read the barcode from an image file using specified options
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Check if any barcodes were found and print the result
if (results != null && results.Count > 0)
{
    foreach (var result in results)
    {
        Console.WriteLine($"Barcode Found: {result.Text}"); // Display the barcode text
    }
}
else
{
    Console.WriteLine("No barcodes found."); // Inform the user if no barcodes were found
}

// Export the filtered images generated during barcode reading process to disk
results.ExportFilterImagesToDisk("binaryThreshold_0.9.png");

' Import necessary libraries for barcode processing
Imports IronBarCode

' Set up barcode reader options with specified image filters
Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New BinaryThresholdFilter(0.9F)}
}

' Read the barcode from an image file using specified options
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Check if any barcodes were found and print the result
If results IsNot Nothing AndAlso results.Count > 0 Then
	For Each result In results
		Console.WriteLine($"Barcode Found: {result.Text}") ' Display the barcode text
	Next result
Else
	Console.WriteLine("No barcodes found.") ' Inform the user if no barcodes were found
End If

' Export the filtered images generated during barcode reading process to disk
results.ExportFilterImagesToDisk("binaryThreshold_0.9.png")

using IronBarCode;

// Create barcode reader options and specify image filters
BarcodeReaderOptions options = new BarcodeReaderOptions
{
    // Initialize a collection of image filters
    ImageFilters = new ImageFilterCollection(true)
    {
        // Adjust image brightness. 1.5 factor increases brightness by 50%
        new BrightnessFilter(1.5f)
    }
};

// Try to read the barcode from an image file using the specified options
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Check if any barcodes were successfully read before proceeding
if (results != null && results.Any())
{
    // Export filtered images to disk with the filename "brightness_1.5.png"
    results.ExportFilterImagesToDisk("brightness_1.5.png");
}
else
{
    // Output an error message if no barcodes were detected
    Console.WriteLine("No barcodes were detected in the image.");
}

Imports IronBarCode

' Create barcode reader options and specify image filters
Private options As New BarcodeReaderOptions With {
	.ImageFilters = New ImageFilterCollection(True) From {New BrightnessFilter(1.5F)}
}

' Try to read the barcode from an image file using the specified options
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Check if any barcodes were successfully read before proceeding
If results IsNot Nothing AndAlso results.Any() Then
	' Export filtered images to disk with the filename "brightness_1.5.png"
	results.ExportFilterImagesToDisk("brightness_1.5.png")
Else
	' Output an error message if no barcodes were detected
	Console.WriteLine("No barcodes were detected in the image.")
End If

// Import the necessary library for barcode reading
using IronBarCode;

// Set the options for the barcode reader
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order)
    ImageFilters = new ImageFilterCollection(true)
    {
        // Apply a contrast filter with a strength of 1.5
        new ContrastFilter(1.5f),
    }
};

// Read the barcode from the specified image file using the options set
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Check if the barcode reading was successful and handle any errors
if (results != null && results.Barcodes.Count > 0)
{
    // Export the filtered images used in the processing to a file on disk
    results.ExportFilterImagesToDisk("contrast_1.5.png");
    Console.WriteLine("Barcode reading and image export successful.");
}
else
{
    // Handle the case when no barcodes are found or there is an error
    Console.WriteLine("No barcodes found or there was an error in reading the image.");
}

' Import the necessary library for barcode reading
Imports IronBarCode

' Set the options for the barcode reader
Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New ContrastFilter(1.5F)}
}

' Read the barcode from the specified image file using the options set
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Check if the barcode reading was successful and handle any errors
If results IsNot Nothing AndAlso results.Barcodes.Count > 0 Then
	' Export the filtered images used in the processing to a file on disk
	results.ExportFilterImagesToDisk("contrast_1.5.png")
	Console.WriteLine("Barcode reading and image export successful.")
Else
	' Handle the case when no barcodes are found or there is an error
	Console.WriteLine("No barcodes found or there was an error in reading the image.")
End If

using IronBarCode;

// Initialize BarcodeReaderOptions with specific settings
// These options allow for customization of barcode reading behaviors.
BarcodeReaderOptions options = new BarcodeReaderOptions
{
    // Specify image filters to be applied in order.
    // This is useful for preprocessing the image before attempting to read barcodes.
    ImageFilters = new ImageFilterCollection(true)
    {
        // Apply an inversion filter to the images. 
        // This step is helpful if the barcode is on a light background.
        new InvertFilter()
    }
};

// Read the barcode from the specified image using the defined options.
// The Read method attempts to decode any barcode present in the 'sample.png' file.
BarcodeResults results = BarcodeReader.Read("sample.png", options);

// Export the filtered images that were used to find barcodes to disk.
// This can be helpful for debugging purposes to ensure that the filters are being applied correctly.
results.ExportFilterImagesToDisk("invert.png");

Imports IronBarCode

' Initialize BarcodeReaderOptions with specific settings
' These options allow for customization of barcode reading behaviors.
Private options As New BarcodeReaderOptions With {
	.ImageFilters = New ImageFilterCollection(True) From {New InvertFilter()}
}

' Read the barcode from the specified image using the defined options.
' The Read method attempts to decode any barcode present in the 'sample.png' file.
Private results As BarcodeResults = BarcodeReader.Read("sample.png", options)

' Export the filtered images that were used to find barcodes to disk.
' This can be helpful for debugging purposes to ensure that the filters are being applied correctly.
results.ExportFilterImagesToDisk("invert.png")

using IronBarCode;
using System;

// Create and configure options for barcode reading
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    // Enable image filters for optimized barcode scanning
    ImageFilters = new ImageFilterCollection(true)
    {
        // Apply a sharpen filter to enhance image edges, improving barcode clarity
        new SharpenFilter(0.5f),
    },
};

try
{
    // Attempt to read barcode(s) from the specified image file with the provided options
    BarcodeResults results = BarcodeReader.Read("sample.png", options);

    // Verify if any barcode(s) have been detected
    if (results == null || results.Count == 0)
    {
        Console.WriteLine("No barcodes were detected in the image.");
    }
    else
    {
        // Save the processed image(s) with applied filters to disk
        results.ExportFilterImagesToDisk("sharpen_0.5.png");
        Console.WriteLine("Filtered image(s) exported successfully.");
    }
}
catch (Exception ex)
{
    // Catch and display any errors encountered during barcode processing
    Console.WriteLine($"An error occurred while reading the barcode: {ex.Message}");
}

Imports IronBarCode
Imports System

' Create and configure options for barcode reading
Private options As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New SharpenFilter(0.5F)}
}

Try
	' Attempt to read barcode(s) from the specified image file with the provided options
	Dim results As BarcodeResults = BarcodeReader.Read("sample.png", options)

	' Verify if any barcode(s) have been detected
	If results Is Nothing OrElse results.Count = 0 Then
		Console.WriteLine("No barcodes were detected in the image.")
	Else
		' Save the processed image(s) with applied filters to disk
		results.ExportFilterImagesToDisk("sharpen_0.5.png")
		Console.WriteLine("Filtered image(s) exported successfully.")
	End If
Catch ex As Exception
	' Catch and display any errors encountered during barcode processing
	Console.WriteLine($"An error occurred while reading the barcode: {ex.Message}")
End Try

// Include the necessary namespace for working with IronBarCode.
using IronBarCode;

public class BarcodeReaderDemo
{
    public static void Main()
    {
        // Create an instance of BarcodeReaderOptions to configure the reading process.
        BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
        {
            // Initialize an image filter collection to apply specific filters to the image.
            // This collection is set to active with 'true' as a parameter.
            ImageFilters = new ImageFilterCollection(true)
            {
                // Applying a GaussianBlurFilter with specified parameters.
                // The parameters (3, 3, 3.0f) refer to the kernel size and sigma value for the blur effect.
                new GaussianBlurFilter(3, 3, 3.0f),
            },
        };

        try
        {
            // Use the BarcodeReader class to read a barcode from the specified image file.
            // The image file "sharpen.webp" is processed using the options specified in 'myOptionsExample'.
            BarcodeResults results = BarcodeReader.Read("sharpen.webp", myOptionsExample);

            // Check if any barcode was successfully read from the image.
            if (results.Barcodes.Length > 0)
            {
                // Export the filtered image(s) to disk.
                // The result of applying the Gaussian blur filter is saved as "gaussianBlur.png".
                results.ExportFilterImagesToDisk("gaussianBlur.png");

                // Optionally, output the results to the console.
                Console.WriteLine("Barcodes successfully read and filtered image exported.");
                
                // Display the content of the first barcode as an example.
                Console.WriteLine("First barcode content: " + results.Barcodes[0].Text);
            }
            else
            {
                Console.WriteLine("No barcodes found in the image.");
            }
        }
        catch (Exception ex)
        {
            // Handle any errors that occur during barcode reading and filtering.
            Console.WriteLine("An error occurred: " + ex.Message);
        }
    }
}

' Include the necessary namespace for working with IronBarCode.
Imports IronBarCode

Public Class BarcodeReaderDemo
	Public Shared Sub Main()
		' Create an instance of BarcodeReaderOptions to configure the reading process.
		Dim myOptionsExample As New BarcodeReaderOptions() With {
			.ImageFilters = New ImageFilterCollection(True) From {New GaussianBlurFilter(3, 3, 3.0F)}
		}

		Try
			' Use the BarcodeReader class to read a barcode from the specified image file.
			' The image file "sharpen.webp" is processed using the options specified in 'myOptionsExample'.
			Dim results As BarcodeResults = BarcodeReader.Read("sharpen.webp", myOptionsExample)

			' Check if any barcode was successfully read from the image.
			If results.Barcodes.Length > 0 Then
				' Export the filtered image(s) to disk.
				' The result of applying the Gaussian blur filter is saved as "gaussianBlur.png".
				results.ExportFilterImagesToDisk("gaussianBlur.png")

				' Optionally, output the results to the console.
				Console.WriteLine("Barcodes successfully read and filtered image exported.")

				' Display the content of the first barcode as an example.
				Console.WriteLine("First barcode content: " & results.Barcodes(0).Text)
			Else
				Console.WriteLine("No barcodes found in the image.")
			End If
		Catch ex As Exception
			' Handle any errors that occur during barcode reading and filtering.
			Console.WriteLine("An error occurred: " & ex.Message)
		End Try
	End Sub
End Class

using IronBarCode;

// Define barcode reading options with specific image filtering settings.
BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Choose which filters are to be applied (in order).
    // Using a bilateral filter to reduce noise while maintaining edges.
    ImageFilters = new ImageFilterCollection(true)
    {
        new BilateralFilter(5, 75, 75) // Filter parameters: diameter, sigmaColor, sigmaSpace.
    },
};

try
{
    // Attempt to read the barcode from the specified image.
    BarcodeResults results = BarcodeReader.Read("sharpen.webp", myOptionsExample);

    if (results.Barcodes.Count > 0)
    {
        // If barcodes are found, export the filtered image(s) to disk.
        results.ExportFilterImagesToDisk("bilateral.png");
        Console.WriteLine("Barcodes detected and filtered images exported.");
    }
    else
    {
        // Handle the case where no barcodes are detected.
        Console.WriteLine("No barcodes were found in the image.");
    }
}
catch (Exception ex)
{
    // Catch and display any errors that occur during the process.
    Console.WriteLine($"An error occurred: {ex.Message}");
}

Imports IronBarCode

' Define barcode reading options with specific image filtering settings.
Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {New BilateralFilter(5, 75, 75)}
}

Try
	' Attempt to read the barcode from the specified image.
	Dim results As BarcodeResults = BarcodeReader.Read("sharpen.webp", myOptionsExample)

	If results.Barcodes.Count > 0 Then
		' If barcodes are found, export the filtered image(s) to disk.
		results.ExportFilterImagesToDisk("bilateral.png")
		Console.WriteLine("Barcodes detected and filtered images exported.")
	Else
		' Handle the case where no barcodes are detected.
		Console.WriteLine("No barcodes were found in the image.")
	End If
Catch ex As Exception
	' Catch and display any errors that occur during the process.
	Console.WriteLine($"An error occurred: {ex.Message}")
End Try

using IronBarCode;

// Create BarcodeReaderOptions with specific settings
BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions
{
    // Specify which image processing filters to apply (in order)
    ImageFilters = new ImageFilterCollection(true) 
    {
        new MedianBlurFilter(5) // Apply median blur with a filter size of 5
    }
};

// Apply options and attempt to read the barcode from the given image file
BarcodeResult[] results = BarcodeReader.Read("sharpen.webp", myOptionsExample);

// Check if any barcodes were successfully detected
if (results != null && results.Length > 0)
{
    // If barcodes were detected, export the filtered image to the disk
    results.ExportFilterImagesToDisk("medianBlur.png");
}
else
{
    // Handle the case where no barcodes were detected
    Console.WriteLine("No barcodes were detected in the image.");
}

Imports IronBarCode

' Create BarcodeReaderOptions with specific settings
Private myOptionsExample As New BarcodeReaderOptions With {
	.ImageFilters = New ImageFilterCollection(True) From {New MedianBlurFilter(5)}
}

' Apply options and attempt to read the barcode from the given image file
Private results() As BarcodeResult = BarcodeReader.Read("sharpen.webp", myOptionsExample)

' Check if any barcodes were successfully detected
If results IsNot Nothing AndAlso results.Length > 0 Then
	' If barcodes were detected, export the filtered image to the disk
	results.ExportFilterImagesToDisk("medianBlur.png")
Else
	' Handle the case where no barcodes were detected
	Console.WriteLine("No barcodes were detected in the image.")
End If

using IronBarCode;

// Configure options for reading the barcode with specific image filters
BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Apply a sequence of image filters to preprocess the image, improving barcode detection accuracy
    ImageFilters = new ImageFilterCollection(true)
    {
        new SharpenFilter(3.5f),             // Enhances the details of the image
        new AdaptiveThresholdFilter(0.5f),   // Converts image to binary for better pattern detection
        new ContrastFilter(2)                // Increases the contrast of the image
    }
};

// Read the barcode from the specified image file using the configured options
BarcodeResults results = BarcodeReader.Read("sample.webp", myOptionsExample);

// Check if any barcodes were successfully detected
if (results.BarcodeValues.Count > 0)
{
    // Output the detected barcode values
    foreach (var barcode in results.BarcodeValues)
    {
        Console.WriteLine("Detected Barcode: " + barcode);
    }
}
else
{
    Console.WriteLine("No barcodes detected.");
}

// Export the filtered images to disk; useful for debugging or processing analysis
results.ExportFilterImagesToDisk("filteredImages", ImageFormat.Png);
```

Imports IronBarCode

' Configure options for reading the barcode with specific image filters
Private myOptionsExample As New BarcodeReaderOptions() With {
	.ImageFilters = New ImageFilterCollection(True) From {
		New SharpenFilter(3.5F),
		New AdaptiveThresholdFilter(0.5F),
		New ContrastFilter(2)
	}
}

' Read the barcode from the specified image file using the configured options
Private results As BarcodeResults = BarcodeReader.Read("sample.webp", myOptionsExample)

' Check if any barcodes were successfully detected
If results.BarcodeValues.Count > 0 Then
	' Output the detected barcode values
	For Each barcode In results.BarcodeValues
		Console.WriteLine("Detected Barcode: " & barcode)
	Next barcode
Else
	Console.WriteLine("No barcodes detected.")
End If

' Export the filtered images to disk; useful for debugging or processing analysis
results.ExportFilterImagesToDisk("filteredImages", ImageFormat.Png)
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'```