Add API to save generated barcode images

BigIslandBarcode/MainPage.xaml

@@ -22,7 +22,7 @@
 			Grid.Row="3"
 			BackgroundColor="#aa000000"
 			Padding="20"
-			ColumnDefinitions="Auto,Auto,*,Auto">
+			ColumnDefinitions="Auto,Auto,*,Auto,Auto">
 
 			<Button Text="🔄️" Grid.Column="0" BackgroundColor="#aa000000" CornerRadius="8" BorderColor="Black" Clicked="SwitchCameraButton_Clicked" />
 
@@ -41,7 +41,9 @@
 				CharacterSet="UTF-8"
 				BarcodeMargin="1" />
 
-			<Button Text="💡" Grid.Column="3" BackgroundColor="#aa000000" CornerRadius="8" BorderColor="Black" Clicked="TorchButton_Clicked" />
+			<Button Text="💾" Grid.Column="3" BackgroundColor="#aa000000" CornerRadius="8" BorderColor="Black" Clicked="SaveBarcodeButton_Clicked" />
+
+			<Button Text="💡" Grid.Column="4" BackgroundColor="#aa000000" CornerRadius="8" BorderColor="Black" Clicked="TorchButton_Clicked" />
 		</Grid>
 
 	</Grid>

BigIslandBarcode/MainPage.xaml.cs

@@ -80,5 +80,32 @@ void TorchButton_Clicked(object sender, EventArgs e)
 		{
 			barcodeView.IsTorchOn = !barcodeView.IsTorchOn;
 		}
+
+		async void SaveBarcodeButton_Clicked(object sender, EventArgs e)
+		{
+			try
+			{
+				// Generate barcode from the view
+				var barcode = await barcodeGenerator.GenerateBarcodeAsync();
+
+				if (barcode != null)
+				{
+					// Save to app data directory (no permissions needed)
+					var filePath = System.IO.Path.Combine(FileSystem.AppDataDirectory, $"barcode_{DateTime.Now:yyyyMMddHHmmss}.png");
+					await barcode.SaveAsync(filePath);
+
+					await DisplayAlert("Success", $"Barcode saved to:\n{filePath}", "OK");
+					ResultLabel.Text = "Barcode saved!";
+				}
+				else
+				{
+					await DisplayAlert("Error", "Failed to generate barcode", "OK");
+				}
+			}
+			catch (Exception ex)
+			{
+				await DisplayAlert("Error", $"Failed to save barcode: {ex.Message}", "OK");
+			}
+		}
 	}
 }

README.md

@@ -156,6 +156,170 @@ The `BarcodeGeneratorView` supports UTF-8 character encoding by default, which a
 
 The `CharacterSet` property defaults to "UTF-8" if not specified. Other common values include "ISO-8859-1", "Shift_JIS", etc., depending on your barcode format requirements.
 
+## Generating and Saving Barcode Images
+
+You can generate barcode images programmatically and save them to files or streams using the `BarcodeGenerator` class:
+
+```csharp
+using ZXing.Net.Maui;
+
+// Create a barcode generator
+var generator = new BarcodeGenerator
+{
+    Format = BarcodeFormat.QrCode,
+    Value = "https://dotnet.microsoft.com",
+    Width = 300,
+    Height = 300,
+    Margin = 10,
+    ForegroundColor = Colors.Black,
+    BackgroundColor = Colors.White
+};
+
+// Generate the barcode image
+var barcodeImage = await generator.GenerateAsync("https://dotnet.microsoft.com");
+
+// Save to file
+await barcodeImage.SaveAsync("/path/to/barcode.png");
+
+// Or save to a stream
+using var stream = new MemoryStream();
+await barcodeImage.SaveAsync(stream, BarcodeImageFormat.Png);
+```
+
+### Supported Image Formats
+
+- **PNG** (all platforms) - Recommended for best quality
+- **JPEG** (all platforms) - For smaller file sizes with compression
+- **WebP** (Android only)
+- **BMP** (Windows only)
+- **GIF** (Windows only)
+- **TIFF** (Windows only)
+
+### Required Permissions for Saving Files
+
+#### Android
+
+To save barcode images to external storage on Android, add the following permissions to your `AndroidManifest.xml` file (under the Platforms\Android folder) inside the `manifest` node:
+
+For Android 12 and below (API level 32 and below):
+```xml
+<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
+```
+
+For Android 13+ (API level 33+), the above permissions are not needed if you're using app-specific directories or the MediaStore API. However, for accessing shared storage, you may need:
+```xml
+<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
+```
+
+**Note:** You must also request these permissions at runtime using `Permissions.RequestAsync<Permissions.StorageWrite>()` and `Permissions.RequestAsync<Permissions.StorageRead>()`.
+
+For app-specific directories (recommended), no permissions are needed:
+```csharp
+// Save to app-specific directory (no permissions needed)
+var path = Path.Combine(FileSystem.AppDataDirectory, "barcode.png");
+await barcodeImage.SaveAsync(path);
+```
+
+#### iOS
+
+To save barcode images to the photo library on iOS, add the following permission to your `info.plist` file (under the Platforms\iOS folder) inside the `dict` node:
+
+```xml
+<key>NSPhotoLibraryAddUsageDescription</key>
+<string>This app needs permission to save barcode images to your photo library</string>
+```
+
+For app-specific directories (recommended), no permissions are needed:
+```csharp
+// Save to app-specific directory (no permissions needed)
+var path = Path.Combine(FileSystem.AppDataDirectory, "barcode.png");
+await barcodeImage.SaveAsync(path);
+```
+
+#### Windows
+
+No special permissions are required for Windows. However, to access certain folders like Documents or Pictures, you may need to declare capabilities in your `Package.appxmanifest`:
+
+```xml
+<Capabilities>
+  <Capability Name="picturesLibrary" />
+  <Capability Name="documentsLibrary" />
+</Capabilities>
+```
+
+For app-specific directories (recommended), no capabilities are needed:
+```csharp
+// Save to app-specific directory (no capabilities needed)
+var path = Path.Combine(FileSystem.AppDataDirectory, "barcode.png");
+await barcodeImage.SaveAsync(path);
+```
+
+### Complete Example
+
+```csharp
+using ZXing.Net.Maui;
+
+public async Task GenerateAndSaveBarcodeAsync()
+{
+    try
+    {
+        // Create the generator
+        var generator = new BarcodeGenerator
+        {
+            Format = BarcodeFormat.QrCode,
+            Width = 500,
+            Height = 500,
+            Margin = 10
+        };
+
+        // Generate barcode
+        var barcode = await generator.GenerateAsync("https://github.com/Redth/ZXing.Net.Maui");
+
+        if (barcode != null)
+        {
+            // Save to app data directory (no permissions needed)
+            var filePath = Path.Combine(FileSystem.AppDataDirectory, "mybarcode.png");
+            await barcode.SaveAsync(filePath);
+
+            Console.WriteLine($"Barcode saved to: {filePath}");
+        }
+    }
+    catch (Exception ex)
+    {
+        Console.WriteLine($"Error generating barcode: {ex.Message}");
+    }
+}
+```
+
+### Saving from BarcodeGeneratorView
+
+You can also generate and save a barcode image directly from a `BarcodeGeneratorView` control:
+
+```csharp
+// In your XAML
+<zxing:BarcodeGeneratorView 
+    x:Name="barcodeView"
+    HeightRequest="300"
+    WidthRequest="300"
+    Value="https://dotnet.microsoft.com"
+    Format="QrCode" />
+
+<Button Text="Save Barcode" Clicked="OnSaveClicked" />
+
+// In your code-behind
+private async void OnSaveClicked(object sender, EventArgs e)
+{
+    var barcode = await barcodeView.GenerateBarcodeAsync();
+
+    if (barcode != null)
+    {
+        var filePath = Path.Combine(FileSystem.AppDataDirectory, "barcode.png");
+        await barcode.SaveAsync(filePath);
+        await DisplayAlert("Success", $"Barcode saved to {filePath}", "OK");
+    }
+}
+```
 
 
 

ZXing.Net.MAUI.Controls/Controls/BarcodeGeneratorView.cs

@@ -1,5 +1,6 @@
 using Microsoft.Maui.Controls;
 using Microsoft.Maui.Graphics;
+using System.Threading.Tasks;
 
 namespace ZXing.Net.Maui.Controls
 {
@@ -58,5 +59,29 @@ public string CharacterSet
 			get => (string)GetValue(CharacterSetProperty);
 			set => SetValue(CharacterSetProperty, value);
 		}
+
+		/// <summary>
+		/// Generates a barcode image from the current view settings
+		/// </summary>
+		/// <returns>The generated barcode image, or null if the value is empty</returns>
+		public async Task<NativePlatformImage?> GenerateBarcodeAsync()
+		{
+			// Use WidthRequest/HeightRequest or default to 300x300 if not set (WidthRequest defaults to -1)
+			var width = WidthRequest > 0 ? (int)WidthRequest : 300;
+			var height = HeightRequest > 0 ? (int)HeightRequest : 300;
+
+			var generator = new BarcodeGenerator
+			{
+				Format = Format,
+				ForegroundColor = ForegroundColor,
+				BackgroundColor = BackgroundColor,
+				Width = width,
+				Height = height,
+				Margin = BarcodeMargin,
+				CharacterSet = CharacterSet
+			};
+
+			return await generator.GenerateAsync(Value);
+		}
 	}
 }

ZXing.Net.MAUI/Apple/BarcodeImageExtensions.ios.maccatalyst.cs

@@ -0,0 +1,76 @@
+using System;
+using System.IO;
+using System.Threading.Tasks;
+using Foundation;
+using UIKit;
+
+#nullable enable
+
+#if IOS || MACCATALYST
+namespace ZXing.Net.Maui
+{
+	/// <summary>
+	/// Extension methods for saving barcode images on iOS and MacCatalyst
+	/// </summary>
+	public static class BarcodeImageExtensions
+	{
+		/// <summary>
+		/// Saves a barcode UIImage to a stream
+		/// </summary>
+		/// <param name="image">The image to save</param>
+		/// <param name="stream">The stream to write to</param>
+		/// <param name="format">The image format (default: PNG)</param>
+		/// <param name="quality">The quality (0-1, default: 1.0)</param>
+		public static async Task SaveAsync(this UIImage? image, Stream stream, BarcodeImageFormat format = BarcodeImageFormat.Png, double quality = 1.0)
+		{
+			if (image == null)
+				throw new ArgumentNullException(nameof(image));
+
+			if (stream == null)
+				throw new ArgumentNullException(nameof(stream));
+
+			NSData? data = format switch
+			{
+				BarcodeImageFormat.Png => image.AsPNG(),
+				BarcodeImageFormat.Jpeg => image.AsJPEG((nfloat)quality),
+				_ => image.AsPNG()
+			};
+
+			if (data == null)
+				throw new InvalidOperationException("Failed to convert image to data");
+
+			await Task.Run(() =>
+			{
+				using var nsStream = data.AsStream();
+				nsStream.CopyTo(stream);
+			});
+		}
+
+		/// <summary>
+		/// Saves a barcode UIImage to a file
+		/// </summary>
+		/// <param name="image">The image to save</param>
+		/// <param name="filePath">The file path to write to</param>
+		/// <param name="format">The image format (default: PNG)</param>
+		/// <param name="quality">The quality (0-1, default: 1.0)</param>
+		public static async Task SaveAsync(this UIImage? image, string filePath, BarcodeImageFormat format = BarcodeImageFormat.Png, double quality = 1.0)
+		{
+			if (image == null)
+				throw new ArgumentNullException(nameof(image));
+
+			if (string.IsNullOrEmpty(filePath))
+				throw new ArgumentNullException(nameof(filePath));
+
+			// Create directory if it doesn't exist
+			var directory = Path.GetDirectoryName(filePath);
+			if (!string.IsNullOrEmpty(directory) && !Directory.Exists(directory))
+			{
+				Directory.CreateDirectory(directory);
+			}
+
+			using var stream = File.Create(filePath);
+			await image.SaveAsync(stream, format, quality);
+		}
+	}
+}
+#endif