# OCR (EasyOCR)

Bu fonksiyon bloğu, görüntülerden metin tespit edip çıkarmak için bir OCR motoru kullanır. Entegrasyonu kolay olacak şekilde tasarlanmıştır: bir görüntü sağlayın, güven eşiğini ayarlayın ve döndürülmüş metinlerin tanınmasını iyileştirmek için isteğe bağlı olarak otomatik döndürmeyi etkinleştirin.

## 📥 Girdiler <a href="#inputs" id="inputs"></a>

* `Image` Metni içeren gri tonlama veya renkli görüntü.

## 📤 Çıktılar <a href="#outputs" id="outputs"></a>

* `Result` Tespit edilmiş kutular ve isteğe bağlı metin etiketleriyle işaretlenmiş görüntü (aşağı yönlendirilmiş görselleştirme bağlıysa).
* `Whole Text` Tüm tanınan metnin tek bir string olarak birleşik hâli.
* `Texts` Tanınan bireysel metin parçaları listesi.
* `Boxes` Her tespit edilen metin alanı için 4 noktalı sınırlayıcı çokgenler.

## 🕹️ Kontroller <a href="#controls" id="controls"></a>

* `Auto Rotation` Metin aranırken girdi görüntüsünün döndürülmüş versiyonlarını denemek için açık/kapa. Telefon veya eğik tabelalar gibi döndürülmüş metinlerde faydalıdır.
* `Show Texts` Görselleştirme etkinse, tanınan metin etiketlerini `Result` çıktısına eklemek için açık/kapa.
* `Threshold` Bir tespitin kabul edilebilmesi için gereken minimum güven düzeyini ayarlayan kaydırıcı. Daha yüksek değerler yanlış pozitifleri azaltır ama sönük metinleri kaçırabilir.

## ✨ Özellikler <a href="#features" id="features"></a>

* `Auto Rotation` açık olduğunda çok açılı tanıma ile döndürülmüş metinlerde tespiti iyileştirir.
* `Threshold` ile güvene dayalı filtreleme, tespit katılığını kontrol etmeyi sağlar.
* Hem metinsel sonuçları hem de her tespit için kesin sınırlayıcı çokgenleri döndürür; bu sayede sonraki işlemler veya kayıtlar kolaydır.
* Mevcutsa donanım hızlandırmasını kullanarak performansı iyileştirir.

## 📊 Nasıl çalışır <a href="#evaluation" id="evaluation"></a>

`Image` girişine bir görüntü verildiğinde blok, yapılandırılmış eşik ve döndürme davranışını uygulayarak görüntüyü metin açısından analiz eder. Kabul edilen tespitler metin ve sınırlayıcı kutular olarak döndürülür. Görselleştirme bağlıysa, tespit kutuları (ve isteğe bağlı etiketlerle) işaretlenmiş bir görüntü `Result` çıktısında üretilir.

## 📝 Hızlı başlangıç <a href="#usage" id="usage"></a>

1. Bir görüntü üreten bloğu (ör. bir kamera veya image loader) `Image` girişine bağlayın.
2. Metin döndürülmüş olabilir diye `Auto Rotation`’ı açın.
3. Duyarlılık ile yanlış pozitif arasındaki dengeyi ayarlamak için `Threshold`’u düzenleyin.
4. Tespitleri çizmek veya kaydetmek için `Boxes` çıktısını kullanın veya önizleme için `Result` görüntüsünü bir görüntü gösterme bloğuna bağlayın.

## 💡 İpuçları ve Püf Noktaları <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Küçük veya gürültülü metinler için OCR öncesinde `Image Resizer` veya `Super Resolution` ile boyut ve okunabilirliği artırın.
* OCR yalnızca ilgili alanları işlesin diye `Image ROI Select` veya `Image ROI` ile ilgi alanını kırpın (daha hızlı ve daha doğru).
* Kontrastı artırmak ve gürültüyü azaltmak için `Contrast Optimization`, `Denoising` veya `Adjust Colors` uygulayın.
* Karmaşık sahnelerde metin varsa dikkat dağıtan arka planları `Background Removal (RMBG-1.4)` veya `Background Removal (BiRefNet)` ile kaldırın.
* Hızlı görsel kontroller için işaretlenmiş `Result` çıktısını `Show Image`’e bağlayarak kutu yerleşimini ve metin etiketlerini inceleyin.
* Tanıma kalitesini karşılaştırmak veya yedek strateji denemek için alternatif `OCR` bloğunu da deneyin.
* Tanınan metinleri ve kayıtları `CSV Export` ile kaydedin veya `Data to JSON` ile yapılandırılmış günlükler oluşturun.
* Çok fazla yanlış pozitif görünüyorsa, `Threshold` değerini yükseltin veya ilgili olmayan bölgeleri dışlamak için `Apply Mask` kullanın.

## 🛠️ Sorun Giderme <a href="#troubleshooting" id="troubleshooting"></a>

* Hiç metin bulunmuyor: `Image Resizer` ile görüntü boyutunu artırın veya `Denoising` / `Contrast Optimization` ile netliği iyileştirin.
* Düşük güvene sahip tespitler: `Threshold` kaydırıcısını yükseltin ve/veya arka planı arka plan kaldırma bloklarıyla temizleyin.
* Metin döndürülmüş veya ters ise: `Auto Rotation`’ı etkinleştirin. Sadece tek bir açı sorunluysa, `Image ROI Select` ile kırpıp harici olarak döndürebilirsiniz.
* Dokulu arka planlarda çok fazla yanlış pozitif: İşleme alanını `Image ROI Select` ile sınırlayın ve gürültülü bölgeleri engellemek için `Apply Mask` kullanın.
* Yapılandırılmış çıktı istiyorsanız: `Texts` ve `Boxes` çıktısını `Data to JSON` veya `CSV Export`’a yönlendirerek kaydedin veya sonraki sistemlere gönderin.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/turkish/fonksiyon-bloklari/ai-blocks/ocr-easyocr.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.