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


---

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