خواننده بارکد 1D برای .NET

شروع کار با خواننده بارکد 1D برای .NET

این Aspose.BarCode 1D Reader for .NET یک API قدرتمند و کارآمد است که برای توسعه‌دهندگان طراحی شده است تا بتوانند طیف گسترده‌ای از 1D barcodes از تصاویر درون .NET برنامه‌ها. این راهنما نمای کلی کاملی از ویژگی‌ها و قابلیت‌های API را ارائه می‌دهد، همراه با مثال‌های عملی کد C# برای کمک به شما در یکپارچه‌سازی سریع و مؤثر آن.

نمادهای پشتیبانی‌شده بارکد 1D

ما 1D barcode reader از تمام انواع بارکدهای خطی اصلی پشتیبانی می‌کند، که به شما امکان می‌دهد نیازهای تجاری متنوعی را برآورده کنید. می‌توانید یک یا چند symbologies را در هر decoding session مشخص کنید تا هم دقت و هم عملکرد را بهبود بخشید.

موارد زیر نمادهای بارکد پشتیبانی می‌شوند:

  • UPC-A
  • UPC-E
  • EAN-13
  • EAN-8
  • Code 39
  • Code 93
  • Code 128
  • Interleaved 2 of 5
  • Code 11

در اینجا یک مثال از نحوه تعیین سمبولی برای خواندن با استفاده از BarcodeReader کلاس:

// Read from a stream
using (System.IO.Stream stream = System.IO.File.OpenRead("image.png"))
{
    using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader(stream))
    {
        foreach (var result in reader.ReadBarCodes())
        {
            Console.WriteLine($"Found Code: {result.CodeText}, Type: {result.CodeType}");
        }
    }
}

خواندن و رمزگشایی بارکدهای 1D از تصاویر

کلاس BarcodeReader کلاس جزء مرکزی برای خواندن بارکدها است. می‌تواند فایل‌های تصویر، استریم‌ها یا بیت‌مپ‌های در‑حافظه را پردازش کند و یکپارچگی بی‌نقصی با منابع داده مختلف مانند اسکنرها، دوربین‌ها یا گردش‌کارهای مبتنی بر فایل فراهم می‌آورد.

خواندن از مسیر فایل

ساده‌ترین روش برای خواندن بارکد، ارائه مسیر فایل تصویر است:

// Read from an image file
using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader("image.png"))
{
    foreach (var result in reader.ReadBarCodes())
    {
        Console.WriteLine($"Found Code: {result.CodeText}, Type: {result.CodeType}");
    }
}

خواندن از یک استریم تصویر

برای برنامه‌هایی که تصاویر را از حافظه یا منابع شبکه دریافت می‌کنند، می‌توانید از یک استریم استفاده کنید:

// Read from a stream
using (System.IO.Stream stream = System.IO.File.OpenRead("image.png"))
{
    using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader(stream))
    {
        foreach (var result in reader.ReadBarCodes())
        {
            Console.WriteLine($"Found Code: {result.CodeText}, Type: {result.CodeType}");
        }
    }
}

دسترسی به داده‌های بارکد رمزگشایی‌شده

هر بارکد رمزگشایی‌شده یک BarCodeResult شیء برمی‌گرداند که متادیتای غنی شامل متن رمزگشایی‌شده، نوع سمبولی و مختصات جعبه مرزی را فراهم می‌کند.

// Get decoded information
using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader("image.png"))
{
    var result = reader.ReadBarCodes()[0];
    
    // Get the symbology and code text
    string symbology = result.CodeType.ToString();
    string codeText = result.CodeText;

    Console.WriteLine($"Symbology: {symbology}, Code Text: {codeText}");
}

ویژگی‌های پیشرفته و بهینه‌سازی

فراتر از خواندن پایه، 1D Barcode Reader ویژگی‌های قدرتمندی برای بهبود دقت و عملکرد در سناریوهای پیچیده ارائه می‌دهد.

  • جبران چرخش و کج‌نمایی: API ما به‌صورت خودکار چرخش و تحریف پرسپکتیو را شناسایی و اصلاح می‌کند. بارکدهای گرفته‌شده در زوایای نامعمول به‌طور قابل اعتماد بدون نیاز به پیش‌پردازش خوانده می‌شوند.
  • منطقه سفارشی مورد علاقه (ROI): اسکن را به یک ناحیه مستطیلی خاص درون تصویر محدود کنید. این کار به‌طور چشمگیری رمزگشایی را سرعت می‌بخشد وقتی مکان بارکد را می‌دانید و مثبت‌های کاذب را کاهش می‌دهد.
  • پردازش دسته‌ای و موازی: برای سرویس‌های با حجم بالا، کتابخانه از رمزگشایی موازی بر روی چندین تصویر یا رشته پشتیبانی می‌کند.
  • تشخیص و اصلاح خطا: خواننده از چک‌سام و مکانیزم‌های اصلاح خطای داخلی که در صورت پشتیبانی موجود هستند استفاده می‌کند، بارکدهای نامعتبر را علامت‌گذاری کرده و برای هر خواندن امتیاز اطمینان ارائه می‌دهد.

مثال: مدیریت خطاها به‌صورت مناسب

اجرای مدیریت خطا برای مدیریت سناریوهایی که بارکد قابل خواندن نیست یا یافت نمی‌شود، بسیار مهم است.

using Aspose.BarCode.BarCodeRecognition;
using System;
using System.IO;


// Example of reading a barcode from a file
try
{
    using (BarCodeReader reader = new BarCodeReader(Path.Combine("C:", "path", "to", "your", "image.png")))
    {
        foreach (BarCodeResult result in reader.ReadBarCodes())
        {
            Console.WriteLine("Code Text: " + result.CodeText);
            Console.WriteLine("Symbology: " + result.CodeType);
        }
    }
}
catch (Exception ex)
{
    Console.WriteLine($"An error occurred: {ex.Message}");
}

نصب و راه‌اندازی

شروع کار با Aspose.BarCode 1D Reader ساده است. فقط بسته را به پروژه‌تان اضافه کنید.

  1. نصب از طریق NuGet: افزودن Aspose.BarCode پکیج را به پروژه خود با استفاده از NuGet Package Manager اضافه کنید.
  2. مجوز: برای استفاده در محیط تولید، پیکربندی کنید مجوز متری همان‌طور که در راهنمای Metered Licensing .

با دنبال کردن این راهنما، می‌توانید راه‌حل‌های قوی و مقیاس‌پذیر برای استخراج 1D barcode data از تقریباً هر منبع تصویری با استفاده از Aspose.BarCode 1D Reader for .NET.

 فارسی