> 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/detections-shapes/draw/write-text-on-image.md).

# Write Text On Image

Bu fonksiyon bloğu, görüntülerin üzerine özelleştirilebilir metin bindirmeleri ekler. Metni görüntü boyutuna göre ölçeklendirir, metni normalize edilmiş koordinatlar kullanarak konumlandırmanızı sağlar ve isteğe bağlı olarak metnin okunabilirliğini artırmak için metnin arkasına yarı saydam bir arka plan çizebilir.

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

`Image Any` Üzerine metin yazılacak görüntüyü alır.

`String` İsteğe bağlı metin girişi. Boş bırakılırsa blok boş bir string çizer (görünür metin olmaz).

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

`Image Any` Uygulanan metin bindirmesi ile birlikte çıkan görüntü.

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

`Text Position Horizontal` Metni sola/sağa taşıma; normalize edilmiş bir değer kullanır (0.0 = sol, 1.0 = sağ).

`Text Position Vertical` Metni yukarı/aşağı taşıma; normalize edilmiş bir değer kullanır (0.0 = üst, 1.0 = alt).

`Font Scale` Metin boyutunu görüntüye göre ayarlamak için genel ölçek.

`Font Thickness` Metnin çizgi (stroke) kalınlığını ayarlar.

`Font` Mevcut seçenekler arasından yazı tipini seçin.

`Color` Metin rengini seçin.

`Background Enabled` Metnin arkasına kontrastı artırmak amacıyla yarı saydam bir arka plan dikdörtgeni çizilmesini açıp kapatır.

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

* Metin boyutunun görüntü boyutlarına göre otomatik ölçeklenmesi; farklı çözünürlüklerde tutarlı görünüm sağlar.
* Normalize edilmiş konumlandırma, metni görüntü boyutundan bağımsız orantılı olarak yerleştirmeyi kolaylaştırır.
* Yarı saydam arka plan seçeneği, karmaşık arka planlarda okunabilirliği artırır.
* Dinamik metin girdileri ile çalışır; bu sayede bindirmeler değişken içerikleri (ör. kimlikler, etiketler, sensör değerleri) gösterebilir.

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

Blok çalıştığında gelen görüntüyü ve mevcut kontrol değerlerini okur, görüntü boyutlarına göre uygun bir font ölçeği ve pozisyon hesaplar, isteğe bağlı arka plan dikdörtgenini çizer (etkinse), seçilen font, renk ve kalınlıkla metni render eder ve ortaya çıkan görüntüyü sonraki bloklar için çıktılar.

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

1. `Image Any` girişine görüntü sağlayan bir kaynak bağlayın.
2. `String` girişine metni verin ya da bloğun dahili metnini kullanmak için boş bırakın.
3. Görünüm için `Font`, `Color`, `Font Scale` ve `Font Thickness` ayarlarını yapın.
4. Metni konumlandırmak için `Text Position Horizontal` ve `Text Position Vertical` kullanın.
5. Karmaşık görüntülerde daha yüksek kontrast gerekiyorsa `Background Enabled`i etkinleştirin.
6. Çıktıyı önizlemek için bu bloğu `Show Image` gibi bir görüntüleyici bloğa bağlayın veya sonucu `Image Write` / `Image Logger` ile kaydedin.

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

* Sürekli güncellenen bir zaman damgası eklemek için, `String` girişini `Date-Time` veya `Date-Time List` bloğundan besleyin ve gerekirse bir `String Merge` bloğunda biçimlendirme yapın.
* Pozisyon ve ölçeği ayarlarken canlı önizleme için çıktıyı `Show Image` bloğuna bağlayın.
* Metni yalnızca belirli bir alana yazmak istiyorsanız önce `Image ROI` veya `Image ROI Select` ile kırpın, sonra bu bloğu uygulayın.
* Farklı çözünürlüklere sahip görüntülerde tutarlı bir son metin boyutu istiyorsanız, metin yazmadan önce `Image Resize` kullanın.
* Açıklamalı kareleri kaydetmek için çıktıyı `Image Logger` veya `Image Write`e bağlayın.
* Tespit sonuçlarını bindirmek için, `Find Object` veya `Object Detection` gibi tespit bloklarıyla birleştirip tespit edilen etiketleri ya da sayıları `String` girişine verin.
* Koşula bağlı durum metinleri (ör. OK / NOK) çizmek için mantık blokları (ör. `Logic Input` veya karşılaştırma blokları) ve bir `String Merge` kullanarak gösterilecek metni hazırlayın.

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

* Metin çok küçük veya çok büyük görünüyorsa: `Font Scale`i ayarlayın veya tutarlı sonuç için giriş görüntüsünü `Image Resize` ile yeniden boyutlandırın.
* Metin yoğun arka planda okunamıyorsa: `Background Enabled`i etkinleştirin veya `Color`ı yüksek kontrastlı bir değere değiştirin.
* Farklı görüntülerde metin pozisyonu tutarsız görünüyorsa: normalize edilmiş `Text Position Horizontal` ve `Text Position Vertical` değerlerini kullanın ve yerleşimi temsil eden bir görüntüde `Show Image` ile doğrulayın.