# OCR

Bu fonksiyon bloğu, bir görüntüden basılı veya el yazısı metni çıkarır ve hem görsel hem de metinsel sonuçlar döndürür. Kullanımı kolay olacak şekilde tasarlanmıştır: bir görüntü verin, hassasiyeti ayarlayın ve gerekirse otomatik döndürme veya metin bindirmeyi etkinleştirin.

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

`Image` Bu giriş soketi, metin okunacak görüntüyü kabul eder.

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

`Result` Tespit edilen metin kutularının çizildiği anotasyonlu görüntü (bir görüntü görüntüleyici bağlıysa).

`Whole Text` Tespit edilen metinlerin birleştirilmiş tek bir dize halinde çıktısı.

`Texts` Tespit edilen metin dizilerinin listesi (birden çok çıktı mümkün).

`Boxes` Her bir metin örneği için tespit edilen sınırlayıcı kutular (koordinatlar).

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

`Auto Rotation` Görüntüde döndürülmüş veya baş aşağı metin varsa bloğun bunları denemesine izin veren anahtar.

`Show Texts` Tanınan metni ve güven skorunu anotasyonlu görüntüye çizmek için açma/kapama anahtarı.

`Threshold` Bir tespitin kabul edilmesi için gereken minimum güven düzeyini kontrol eden kaydırıcı (düşük = daha fazla sonuç, yüksek = daha az ama daha güvenilir sonuç).

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

* Bloğa gelen görüntülerden gerçek zamanlı metin çıkarımı.
* Baş aşağı veya döndürülmüş metinlerin okunabilmesi için otomatik döndürme seçeneği.
* Düşük güvenli tanımlamaları filtrelemek için güven eşiği.
* Hızlı doğrulama için sınırlayıcı kutular ve isteğe bağlı metin bindirmesi içeren görsel çıktı.
* Yapılandırılmış çıktılar (metin listeleri ve kutular) ile tek birleştirilmiş metin çıktısı arasından kullanım kolaylığı.

## ⚙️ Çalışma Mekanizması <a href="#running-mechanism" id="running-mechanism"></a>

Görüntü `Image` girişine verildiğinde blok OCR sürecini çalıştırır ve şunları döndürür:

* `Result` üzerinde anotasyonlu bir görüntü (eğer bir çıktı bağlıysa),
* `Whole Text` üzerinde tanınan tüm metin,
* `Texts` üzerinde ayrı tespit edilmiş dizeler,
* ve `Boxes` üzerinde sınırlayıcı kutu koordinatları.

Döndürülmüş görüntüler için tespiti iyileştirmek adına `Auto Rotation` kullanın. Düşük güvenli sonuçları hariç tutmak için `Threshold` ayarını kullanın.

## 📝 Kullanım Talimatları <a href="#usage" id="usage"></a>

1. Görüntü kaynağını `Image` girişine bağlayın (ör. kamera veya görüntü yükleyici).
2. Görüntüleriniz döndürülmüş olabilir ise `Auto Rotation` öğesini etkinleştirin.
3. Hatırlama ve doğruluk dengesi için `Threshold` kaydırıcısını ayarlayın.
4. Anotasyonlu görüntüde tanınan dizeleri görmek isterseniz `Show Texts` öğesini etkinleştirin.
5. Kayıt veya sonraki işlem için `Whole Text`, `Texts` ve `Boxes` çıktılarından veriyi okuyun.

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

* Daha net OCR sonuçları için görüntüyü ön işlemden geçirin: `Contrast Optimization` ve `Blur` ile gürültüyü azaltıp karakter kontrastını artırın.
* Sadece belirli bir alana odaklanmak istiyorsanız önce `Image ROI Select` ile kırpın, sonra bu bloğa kırpılmış görüntüyü verin.
* Çok büyük görüntülerle çalışıyorsanız işlem süresini azaltmak için önce `Image Resizer` kullanın.
* Geliştirme sırasında anotasyonlu çıktıyı hızlıca önizlemek için `Show Image` kullanın.
* Farklı bir OCR motoru tercih ediyorsanız veya alternatif bir yaklaşım denemek isterseniz `OCR (EasyOCR)` ile sonuçları karşılaştırın.
* Tanınan kareleri ve kayıtları offline inceleme veya denetim izleri için `Image Logger` ile kaydedin.

(İpucu: tespit kalitesi ve performansı artırmak için iş akışınızda şu blokları kombine edebilirsiniz: `Image ROI Select`, `Image Resizer`, `Contrast Optimization`, `Blur`, `Show Image`, `Image Logger`, `OCR (EasyOCR)`.)

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

* Hiç metin tespit edilmiyorsa, giriş görüntüsünde okunabilir metin olduğundan emin olun; kontrastı artırmayı veya `Threshold` değerini düşürmeyi deneyin.
* Sonuçlar gürültülü (çok sayıda yanlış pozitif) ise, düşük güvenli tespitleri filtrelemek için `Threshold` değerini yükseltin.
* Döndürülmüş veya baş aşağı metinlerde sorun yaşıyorsanız önce `Auto Rotation`ı etkinleştirin, sonra gerekirse eşiği ayarlayın.
* Anotasyonlu görüntü görünmüyorsa bir görüntü görüntüleyici bağlandığından emin olun veya `Show Image` kullanarak görsel çıktının yönlendirildiğini kontrol edin.


---

# 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.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.