C# ile Barkod Kesme Bölgesi Nasıl Ayarlanır

Barcode Okumayı Hızlandırmak için C#'te Kırpma Alanını Nasıl Tanımlarım?

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronBarcode'in tarama alanini belirli resim bolgeleriyle sinirlandirmak icin IronSoftware.Drawing.Rectangle kullanarak bir kirpma bolgesi belirleyin. Bu, barkod okuma performansini onemli olcude iyilestirir ve yalnizca ilgili alanlara odaklanarak hatalari azaltir.

IronBarcode'daki en önemli özelliklerden biri, Kırpma Alanları belirleme yeteneğidir. Bu özellik, IronBarcode'in IronSoftware.Drawing.Rectangle nesnesini kullanarak resimde Crop Region ile belirlenen belirli barkodlari veya alanlari okumasini saglar. Bu özelliği kullanmak, okumada hataları azaltmakla kalmaz, aynı zamanda okuma performansını da artırır. Bu teknik, barkod konumlarının tahmin edilebilir olduğu çok sayfalı belgeler veya yüksek çözünürlüklü görüntülerle çalışırken özellikle değerlidir.

Birden fazla barkod veya karmaşık arka planlara sahip görüntüleri işlerken, kırpma alanını tanımlamak, barkod okuma hızınızı optimize etmek için önemlidir. Tarama alanını sınırlayarak, tüm görüntüleri taramaktan 5 kata kadar daha hızlı işlem hızları elde edebilirsiniz ve aynı zamanda barkod olmayan unsurlardan kaynaklanan yanlış pozitifleri de azaltabilirsiniz.

Hızlı başlangıç: Kırpma Bölgesini Tanımlayın ve Uygulayarak Barkodları Daha Hızlı Okuyun

Bir kırpma dikdörtgeni oluşturun ve bunu saniyeler içinde IronBarcode'a besleyin—ekstra kurulum yok, sürtünme yok. Tarama işlemini BarcodeReaderOptions kullanarak belirli bir resim alanina sinirlamanin ne kadar kolay oldugunu gorun.

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/BarCode yükleyin

    PM > Install-Package BarCode
  2. Bu kod parçasını kopyalayıp çalıştırın.

    var results = IronBarCode.BarcodeReader.Read("image.png", new IronBarCode.BarcodeReaderOptions { CropArea = new IronSoftware.Drawing.Rectangle(x: 50, y: 100, width: 300, height: 150) });
  3. Canlı ortamınızda test etmek için dağıtın

    Bugün projenizde IronBarcode kullanmaya başlayın ücretsiz deneme ile

    arrow pointer

Görüntüde Kırpma Bölgesi Koordinatlarını ve Boyutunu Nasıl Bulurum?

Bir görüntüde bir noktanın koordinatlarını bulmanın birçok yolu vardır. Bir yol, görüntüyü bilgisayarınızda bulunan Paint uygulamasıyla yüklemektir. Crop Region'un ilk koordinatini almak icin imleci tercih edilen ilk noktaya, yani Rectangle'in ust-sol kosesine tasiyin ve ekranin sol alt kosesinde uygulama tarafindan verilen x, y koordinatini alin. Daha sonra, Rectangle'in alt-sag kosesi olacak ikinci noktayi bulun. Daha net bir anlayış için aşağıdaki görüntüye bakın.

Daha gelişmiş senaryolar için, GIMP veya Photoshop gibi piksel koordinatları ve ölçüm araçları sağlayan görüntü düzenleme yazılımlarını kullanmayı da düşünebilirsiniz. Bazı geliştiriciler, çevrimiçi koordinat bulucu araçlarını kullanmayı veya görüntü üzerine fare geldiğinde koordinatları gösteren basit HTML/JavaScript uygulamaları oluşturmayı tercih eder.

Crop region diagram showing rectangular area with corner coordinates (x1,y1) and (x2,y2) and dimension calculations

Koordinatları Belirlemek İçin Hangi Araçları Kullanabilirim?

Koordinat degerleri, Rectangle nesnesi icin özellikler olarak kullanilabilir. Nesnenin genişliği x2 - x1 olarak tanımlanabilirken, yüksekliği y2 - y1 olarak tanımlanabilir. Barkod görüntüleri ile çalışırken, koordinatların üst sol köşeden (0,0) başladığını ve sağa (x ekseni) ve aşağıya (y ekseni) hareket ettikçe arttığını anlamak önemlidir.

Birçok koordinat belirleme yaklaşımları şunlardır:

  • Yerleşik işletim sistemi araçları: Windows Paint, macOS Preview
  • Tarayıcı Geliştirici Araçları: Web tabanlı görüntülerde öğe denetle
  • Profesyonel yazılımlar: Adobe Photoshop, GIMP
  • Özel yardımcı programlar: Basit koordinat görüntüleyici uygulamalar
  • IronBarcode'un hata ayıklama özellikleri: Koordinat yerleştirmeleriyle işlenmiş görüntüleri dışa aktarma

Koordinatlardan Dikdörtgen Boyutlarını Nasıl Hesaplarım?

İki köşe noktanız olduğunda, boyutları hesaplamak basittir. Dikdörtgen dört parametre gerektirir: x-koordinatı, y-koordinatı, genişlik ve yükseklik. Kırpma bölgesini doğru şekilde nasıl başlatacağınız aşağıda gösterilmektedir:

:path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-instantiate-CropRegion.cs
using IronBarCode;

int x1 = 62;
int y1 = 29;
int x2 = 345;
int y2 = 522;

IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2-x1, height: y2-y1);
Imports IronBarCode

Private x1 As Integer = 62
Private y1 As Integer = 29
Private x2 As Integer = 345
Private y2 As Integer = 522

Private crop1 As New IronSoftware.Drawing.Rectangle(x:= x1, y:= y1, width:= x2-x1, height:= y2-y1)
$vbLabelText   $csharpLabel

Bu koordinat sistemi, görüntünüzün yalnızca belirli bölgelerine filtre uygulamanıza olanak tanıyan IronBarcode'un görüntü düzeltme özellikleri ile sorunsuz çalışır.

Kırpma Bölgesini Nasıl Uygularım ve Barkodları Nasıl Okurum?

IronBarcode'in okumasi gereken CropRegions'u belirledikten sonra, nesneyi diğer ayarlarla birlikte özelliklerden biri olarak BarcodeReaderOptions icine uygulayabilirsiniz. Daha sonra bu, BarcodeReader.Read() metodunda bir parametre olarak kullanilabilir. Aşağıdaki kod parçası bu süreci göstermektedir:

BarkodReaderOptions Hangi Parametreleri Kabul Eder?

BarcodeReaderOptions sinifi, barkod okuma surecinde kapsamli kontrol saglar. Kırpma bölgelerinin ötesinde, şunları yapılandırabilirsiniz:

  • Hız optimizasyonu: hız ayarlarını kullanarak doğruluk ve performans arasında denge kurun
  • Barkod türleri: Tam aranacak formatları belirleyin (desteklenen formatlar)
  • Görüntü filtreleri: Eğik veya hasarlı barkodlar için düzeltmeler uygulayın
  • Çoklu işleme: Daha iyi performans için paralel işlemeyi etkinleştirin
  • Döndürme işlemi: Döndürülmüş barkodları otomatik olarak algılayın

Bir Kırpılmış Bölgeden Birden Fazla Barkod Sonucu Nasıl İşlenir?

Birden fazla barkod içeren kırpılmış bir bölge tarandığında, IronBarcode bir sonuç koleksiyonu döndürür. Her sonuç, kırpma bölgesindeki tam konumu, barkod türünü ve çözülmüş değeri içeren değerli meta veriler içerir. Kapsamlı kırpma bölgesi işlemenin nasıl uygulanacağı:

:path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-apply-CropRegion.cs
using IronBarCode;
using System;

int x1 = 62;
int y1 = 29;
int x2 = 345;
int y2 = 522;

IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2 - x1, height: y2 - y1);

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    CropArea = crop1
};

var result = BarcodeReader.Read("sample.png", options);
foreach (var item in result)
{
    Console.WriteLine(item.Value);
}
Imports IronBarCode
Imports System

Private x1 As Integer = 62
Private y1 As Integer = 29
Private x2 As Integer = 345
Private y2 As Integer = 522

Private crop1 As New IronSoftware.Drawing.Rectangle(x:= x1, y:= y1, width:= x2 - x1, height:= y2 - y1)

Private options As New BarcodeReaderOptions() With {.CropArea = crop1}

Private result = BarcodeReader.Read("sample.png", options)
For Each item In result
	Console.WriteLine(item.Value)
Next item
$vbLabelText   $csharpLabel

Yukarıdaki kod parcacigindan, BarcodeReaderOptions nesnesinde Rectangle'yi CropArea ozelligi olarak kullandik. Daha sonra bu BarcodeReaderOptions nesnesini BarcodeReader.Read() metodunda parametre olarak kullanarak CropArea'yı resme uygular ve icindeki barkodları okuruz.

Gelişmiş Kırpma Bölgesi Teknikleri

Üretim uygulamaları için aşağıdaki gelişmiş stratejileri göz önünde bulundurun:

  1. Dinamik Kırpma Bölgeleri: Kırpma alanlarını belge şablonlarına veya OCR sonuçlarına göre hesaplayın
  2. Birden Fazla Bölge: Karmaşık düzenler için tek bir görüntüde birden fazla kırpma bölgesi işleyin
  3. Performansı Optimizasyon: Maksimum throughput için kırpma bölgelerini eş zamanlı işleme ile birleştirin
  4. Hata Yönetimi: Beklenen bölgelerde barkod bulunmadığında geri dönüş stratejilerini uygulayın

PDF belgeleriyle çalışırken, belirli sayfalara kırpma bölgelerini uygulayabilirsiniz, bu da büyük dosyaların işleme süresini önemli ölçüde azaltır. Bu özellik, barkod konumlarının standart olduğu fatura, nakliye etiketleri veya formlar için özellikle kullanışlıdır.

Kırpma Bölgesi Tanımı için En İyi Uygulamalar

Kırpma bölgelerinin etkinliğini en üst düzeye çıkarmak için:

  • Dolgu ekleyin: Hafif varyasyonları hesaba katmanız için beklenen barkod konumlarının çevresine 10-20 piksel ekleyin
  • Detaylı test edin: Tüm belge kümelerinizde kırpma bölgelerinin çalıştığını doğrulayın
  • Belge koordinatları: Uygulamanız için yaygın kırpma bölgelerinin bir referans sayfasını tutun
  • Ölçeklendirmeyi göz önünde bulundurun: Farklı görüntü çözünürlükleri veya DPI ayarlarını hesaba katın
  • Performansı izleyin: Kırpma bölgesi etkinliğini doğrulamak için işleme sürelerini izleyin

Hata toleransı gerektiren uygulamalar için iki aşamalı bir yaklaşım uygulayın: ilk olarak kırpma bölgesini tarayın ve beklenen bölgelerde barkod bulunmadığında tam görüntü taramasına geri dönün.

Sonuç

Kırpma bölgelerini tanımlamak, .NET uygulamalarınızda barkod okuma performansını optimize etmek için güçlü bir tekniktir. Belirli bölgelere tarama alanını sınırlayarak, yanlış pozitifleri azaltırken önemli hız iyileştirmeleri elde edebilirsiniz. Tekli resimler veya toplu işlemler işliyor olsanız da, kırpma bölgeleri üretim ortamları için gereken hassasiyeti ve performansı sağlar.

Sıkça Sorulan Sorular

Barkod veisin bolgesi nedir ve neden kullanmaliyim?

Barkod veisin bolgesi, IronBarcode'un tarama calismalarini odakladigi bir resmin icindeki belirli bir alandir. IronSoftware.Drawing.Rectangle kullanarak bir veisin bolgesi tanımlayarak, görselinizin yalnizca ilgili alanlari ile taramayi sinirlayarak hatalari azaltirken barkod okuma hizini 5 kata kadar artirabilirsiniz.

Barkod okuma için bir veisin bolgesi nasil tanımlanir?

IronBarcode'da belirli koordinatlar (x, y) ve olculer (genislik, yükseklik) ile bir IronSoftware.Drawing.Rectangle nesnesi oluşturarak veisin bolgesi tanımlayabilirsiniz, sonra bunu Read metodunu cagirirken BarcodeReaderOptions.CropArea özelligine gecirin.

Veisin bolgeleri kullanarak hangi performans iyilestirmelerini bekleyebilirim?

IronBarcode'un veisin bolgesi özelligi, tüm resimleri taramaya kiyasla barkod okuma performansini 5 kata kadar iyilestirebilir. Bu özellikle, birden fazla sayfali belgelere veya barkod yerlerinin onceden bilinebilir oldugu yüksek cozulun urlune resimlerle calisirken faydalidir.

Veisin bolgesi için doğru koordinatlari nasil bulabilirim?

Microsoft Paint, GIMP veya Photoshop gibi resim düzenleme yazılımlari kullanarak veisin bolgesi koordinatlarini bulabilirsiniz. Sadece resminizi acin, istediginiz bolgeye gidin, x, y koordinatlarini not alin, sonra Rectangle için genislik ve yukselik belirlemek için alt sag kose koordinatlarini bulun.

Veisin bolgeleri kullanmak ne zaman özellikle yararlidir?

IronBarcode'daki veisin bolgeleri, birden fazla barkod iceren resimlerle, karma karışık arka planlarla, çok sayfali belgelerle veya barkod yerlerinin tutarli ve onceden bilinebilir oldugu yüksek cozulunurluklu resimlerle calisirken one çıkar.

Hairil Hasyimi Bin Omar
Yazılım Mühendisi
Tüm harika mühendisler gibi, Hairil de hevesli bir öğrenendir. C#, Python ve Java bilgilerini keskinleştiriyor ve bu bilgilerini, Iron Software ekibi genelinde takım üyelerine değer katmak için kullanıyor. Hairil, Malezya'daki Universiti Teknologi MARA'dan mezun olan Ek Kimya ve Süreç Mühendisliği ...
Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 2,169,908 | Sürüm: 2026.4 just released
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package BarCode
bir örnek çalıştırın dize barkod haline geldiğini görün.