> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/turkish/fonksiyon-bloklari/blocks-reference/ai-blocks/ocr-easyocr.md).

# OCR (EasyOCR)

EasyOCR motorunu kullanarak görüntülerdeki metni tespit eden bir fonksiyon bloğudur. Tanınan metni, bireysel metin segmentlerini, sınırlayıcı kutuları ve isteğe bağlı olarak açıklamalı bir görüntüyü döndürebilir. Döndürülmüş metinlerle başa çıkmak için otomatik döndürme denemeleri içerir.

## 📥 Girdiler

`Image` Metni tanınacak gri tonlu veya renkli görüntü.

## 📤 Çıktılar

`Result` Tespit edilen metin kutları ve isteğe bağlı metin etiketleriyle açıklamalı görüntü.

`Whole Text` Tanınan tüm metnin birleştirilmiş tek bir dize hâlinde çıktısı.

`Texts` Tanınan metin segmentlerinin listesi.

`Boxes` Her tespit edilen metin için çokgen kutuların listesi (her kutu 4 nokta).

## 🕹️ Kontroller

`Use auto rotation` Döndürülmüş metin tespitini iyileştirmek için görüntüyü (90°, -90°, 180°) döndürme denemelerini etkinleştirir.

`Show Texts` Açıklamalı `Result` görüntüsünde tanınan metin etiketlerinin gösterilmesini açıp kapatır.

`Threshold` Düşük güven skorlu metin tespitlerini filtrelemek için güven eşiği kaydırıcısı (0–100%).

## 🎯 Özellikler

* Çok açılı tespit: `Use auto rotation` etkin olduğunda döndürülmüş metinleri işlemek için basit döndürme denemeleri yapar.
* Güven filtresi: `Threshold` ile zayıf tespitleri çıkarma olanağı sağlar.
* Görsel çıktı: Tespitler üretildiğinde kutular ve isteğe bağlı metin etiketleriyle açıklamalı bir `Result` görüntüsü döndürür.
* Hem birleştirilmiş `Whole Text` hem de ayrı `Texts` ve `Boxes` çıktıları downstream işlemler için sunar.

## 📝 Kullanım

1. Görüntü üreten bir bloğun çıktısını `Image` soketine bağlayın.
2. Kaynak görüntüler döndürülmüş olabilir ise isteğe bağlı olarak `Use auto rotation`u etkinleştirin.
3. Hassasiyet ile yanlış pozitifler arasındaki dengeyi belirlemek için `Threshold`u ayarlayın.
4. `Result` görüntüsünde metin etiketlerinin çizilmesini istiyorsanız `Show Texts`i etkinleştirin.
5. Tanınan metni ve kutu koordinatlarını kaydetmek, loglamak veya daha ileri işlemek için çıktıları kullanın.

## 📊 Değerlendirme

Bloğu çalıştırdığınızda, giriş görüntüsünü (etkinse döndürülmüş varyantlarıyla birlikte) analiz eder, tespitleri `Threshold`a göre filtreler ve açıklamalı görüntüyü (varsa), tam birleştirilmiş metni, metin segmentleri listesini ve çokgen kutu listesini döndürür.

## 💡 İpuçları ve Püf Noktaları

* Küçük veya bulanık metinlerde tanımayı iyileştirmek için `Image Resizer` veya `Super Resolution` ile ön işleme yapın.
* Bloğun ilgili bölgelere odaklanması için önce `Image ROI Select` veya `Image ROI` kullanarak metin alanını kırpın.
* Metin karmaşık arka plan üzerindeyse arka planı azaltmak için `Background Removal (RMBG-1.4)` veya `Background Removal (BiRefNet)` kullanın.
* Kontrastı ve okunabilirliği artırmak için girdiye bağlı olarak `Auto Contrast`, `Adjust Colors`, `Denoising` veya `Image Threshold` uygulayın.
* Canlı denetim için `Result` çıktısını önizlemek üzere `Show Image`e yönlendirin.
* Tespit görüntülerini veya logları `Image Logger`, `Image Write` ile kaydedin ya da tanınan metni `Data to JSON` veya `CSV Export` ile dışa aktarın.
* Farklı OCR davranışları gerekiyorsa, genel `OCR` bloğu ile karşılaştırma yapın veya özel görseller bindirmek için `Draw Detections` ile birleştirin.

## 🛠️ Sorun Giderme

* Metin tespit edilmedi: `Threshold`u düşürün ve giriş görüntüsünün çok küçük olmadığından emin olun — gerekirse `Image Resizer` veya `Super Resolution` deneyin.
* Yanlış pozitifler veya bozuk metinler: `Threshold`u artırın ve girdiyi stabilize etmek için `Denoising` veya `Auto Contrast` uygulayın.
* Döndürülmüş metin bulunamıyor: Yaygın döndürmeleri denemek için `Use auto rotation`u etkinleştirin veya bir referansınız varsa `Auto Alignment` ile ön hizalama yapın.
* Çok fazla küçük tespit: `Image ROI Select` ile ilgilenilen bölgeye kırpın ve downstream bloklarda sınır kutusu boyutuna göre sonuçları filtreleyin.