> 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/roi-processing/image-roi-polygon.md).

# Image ROI Polygon

Bu fonksiyon bloğu, bir görüntü üzerinde doğrudan çokgen (polygon) çizerek özel bir ilgi alanı (ROI) tanımlamanıza olanak sağlar. Düzensiz şekilleri seçmek, köşe noktalarını etkileşimli olarak düzenlemek ve hem çokgen içindeki kırpılmış görüntüyü hem de çokgen koordinatlarını sonraki bloklarda kullanmak üzere çıkış olarak almak için kullanın.

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

* `Image Any`\
  Gösterilecek ve üzerinde anotasyon yapılacak görüntü. Canlı önizleme üzerinde çokgen çizmek için herhangi bir görüntü üreten bloğu buraya bağlayın.

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

* `Image Any`\
  Çokgen alanına karşılık gelen kırpılmış görüntü. Hiçbir çokgen tanımlı değilse bu çıktı boş olabilir.
* `Polygon`\
  Diğer bloklar tarafından kullanılabilecek şekilde kontur/şekil listesi olarak döndürülen çokgen koordinatları.

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

* `Left Click`\
  Tıklanan konuma bir köşe (vertex) ekler.
* `Drag`\
  Var olan bir köşeyi tıklayıp sürükleyerek yeniden konumlandırın.
* `U`\
  Son eklenen köşeyi geri alır (undo).
* `C`\
  Tüm köşeleri temizler ve baştan başlamanızı sağlar.
* `Overlay Preview`\
  Düzenleme sırasında çokgeni, köşe noktalarını ve seçilen alanı gerçek zamanlı görmek için görsel işaretler ve dolgu gösterilir.

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

* Bir görüntü kaynağını `Image Any` girişine bağlayın ve önizlemeyi doldurmak için senaryoyu bir kez çalıştırın.
* Köşe eklemek için tıklayarak çokgeni çizin. Overlay anında güncellenir.
* Şekli ince ayarlamak için sürükleme ve klavye kısayollarını kullanın.
* Bir çokgen mevcut olduğunda blok her değerlendirmede çokgene sıkı oturan dikdörtgen şeklinde kırpılmış görüntüyü ve çokgen koordinat listesini üretir.

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

* Köşe düzenlemesi ile etkileşimli çokgen çizimi.
* Hızlı düzeltmeler için geri al/temizle kısayolları.
* Üzerinde gezinme veya sürükleme sırasında köşe vurguları içeren görsel overlay.
* Hem kırpılmış görüntü hem de hassas çokgen koordinatlarını çıktı olarak sağlar.
* Düzensiz nesneler için dikdörtgen dışı ve çok noktalı ROI desteği.

## 📝 Kullanım İpuçları <a href="#usage" id="usage"></a>

* Dolu bir çokgen oluşturmak için en az üç nokta çizin; daha az nokta geçerli bir ROI kırpması üretmez.
* Çizimi yaptıktan sonra kırpılmış görüntüyü veya çokgen koordinatlarını işlemek için sonraki blokları çalıştırın.
* Ölçümlerde doğruluk için köşe konumlarını ince ayarlamak amacıyla sürükleme özelliğini kullanın.

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

* Daha hassas çizim için çıktıyı `Show Image` bloğuna bağlayarak daha büyük bir görüntüde önizleme yapın.
* Aynı görüntüde birden fazla ROI gerektiğinde, birden fazla çokgen seçimini saklamak için `Image ROI Polygon Multi` kullanın ve ardından her birini işleme bloklarına besleyin.
* Önce dikdörtgen kırpma tercih ediyorsanız `Get ROI` veya `Image ROI Select` ile başlayıp karmaşık şekiller için daha sonra çokgenle ince ayar yapın.
* Bu bloktan sonra `Apply Mask` kullanarak orijinal görüntüyü çokgenle maskelendirip maskelenmiş görüntüyü analiz bloklarına verin.
* Kırpılmış çokgen görüntüsünü `Find Object`, `Object Detection`, `Mask Detection`, `Histogram On Line` veya `Color Density Percentage` gibi tespit/analiz bloklarına besleyerek işlemi seçili alana odaklayın.
* Görüntü çok büyükse rahat çizim için bu bloktan önce `Image Resizer` veya `Image Resize` ekleyin; ancak yeniden boyutlandırmanın aşağı akıştaki geometri hassas bloklarda kullanılan piksel koordinatlarını değiştireceğini unutmayın.
* Veri seti toplama veya daha sonra inceleme için seçilmiş ROI'leri `Image Logger`, `Image Write` veya `Multi Image Write` ile kaydedin.

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

* Görüntü görünmüyorsa: önizlemeyi doldurmak için `Image Any` girişine bir görüntü üreten blok bağlandığından ve bloğun bir kez çalıştırıldığından emin olun.
* ROI üretilmiyorsa: en az üç köşe noktası eklediğinizden emin olun; daha az nokta doldurulmuş bir çokgen oluşturmaz.
* Yeniden boyutlandırmadan sonra çokgen yanlış yerde görünüyorsa: ya son çözünürlükte çizin ya da koordinatların hizalanması için pipeline'da tutarlı bir şekilde `Image Resizer` kullanın.
* Diğer bloklar için kesin koordinat gerekliyse: `Polygon` çıktısını (koordinat listesi) kullanın ve bir önizleme ile (örn. `Show Image`) doğrulayın veya ayarlardan sonra yeniden çalıştırın.