> 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-circle.md).

# Image ROI Circle

Bu fonksiyon bloğu, bir görüntü üzerinde tek bir düzenlenebilir dairesel ilgi bölgesi (ROI) oluşturmanızı sağlar. Etkileşimli tuvali kullanarak daireyi çizebilir, taşıyabilir ve yeniden boyutlandırabilirsiniz. Blok, kırpılmış dairesel görüntüyü ve diğer bloklara iletebileceğiniz merkez ve yarıçapı içeren bir daire şekli döndürür.

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

`Image` Kırpılacak ve daire bindirmesinin düzenleneceği görüntü (grayscale veya renkli).

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

`Image` Dairesel alanı içeren kırpılmış görüntü (dairenin dışındaki arka plan maskelenmiş).

`Circle` Seçilen ROI'yi merkez ve yarıçap olarak tanımlayan daire şekli (geometri bilgisi gerektiren bloklar için yararlı).

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

`ROI Canvas` Daireyi fare ile oluşturduğunuz ve düzenlediğiniz etkileşimli görüntü alanı.

`Create by Drag` Tuval üzerinde tıklayıp sürükleyerek yeni bir daire oluşturma.

`Move Center` ROI merkezini yeniden konumlandırmak için daire merkezini sürükleyin.

`Resize Radius` Dairenin boyutunu değiştirmek için yarıçap tutamacını sürükleyin.

`Clear (C)` Mevcut daireyi temizlemek ve yeniden başlamak için C tuşuna basın.

## ⚙️ Çalışma Mekanizması <a href="#how-it-works" id="how-it-works"></a>

* Blok, sağlanan görüntüyü etkileşimli tuvalde gösterir ve mevcut daireyi (tanımlıysa) bindirme olarak çizer.
* Çalışırken tuval, daire oluşturma, taşıma veya yeniden boyutlandırma için fare sürükleme ve hareket olaylarını dinler.
* Geçerli ve geçerli bir daire olduğunda, blok maskelenmiş kırpılmış dairesel görüntüyü ve merkez ile yarıçap değerlerini içeren bir şekil çıktısı üretir.
* Daire tanımlı değilse veya yarıçap sıfırsa, blok her iki soket için de `None` döndürür; böylece sonraki bloklar bir ROI yokluğunu işleyebilir.

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

* ROI oluşturmak için sezgisel tıklayıp sürükleme etkileşimi.
* Merkez taşımak ve yarıçapı yeniden boyutlandırmak için ayrı tutamaçlar.
* Renkli bindirme ve tutamaç vurgulama ile anlık görsel geri bildirim.
* Hem maskelenmiş kırpma hem de yeniden kullanılabilir şekil tanımı çıktıları.

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

1. `Image` girişine bir görüntü üreten bloğu bağlayın ve görüntünün tuvale gelmesi için bir kez çalıştırın.
2. `ROI Canvas` üzerinde tıklayıp sürükleyerek bir daire oluşturun.
3. Taşımak için daire merkezini sürükleyin veya boyutlandırmak için yarıçap tutamacını sürükleyin.
4. Gerekirse temizlemek ve yeniden çizmek için `C` tuşuna basın.
5. Kırpmayı veya şekli diğer bloklara göndermek için `Image` ve `Circle` çıktılarını kullanın.

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

* Kırpılmış alanı dışa aktarmadan önce daha ayrıntılı incelemek için `Show Image` ile daha büyük bir pencerede önizleyin.
* Kaynak görüntünüz büyükse, etkileşimi hızlandırmak ve ROI'nin çalışma alanına sığmasını sağlamak için bu bloktan önce `Image Resize` kullanın.
* Dairesel maskeyi başka görüntülerle birleştirmek veya maskeyi farklı bir arka plana bindirmek için `Apply Mask` kullanın.
* Daha karmaşık veya birden fazla bölge seçmeniz gerekiyorsa önce `Image ROI Select` veya `Image ROI Polygon Multi` kullanmayı, ardından gerekirse bu dairesel ROI ile düzeltme yapmayı düşünün.
* Kaydedilen kırpmaları kayıt veya sonraki işlemler için doğrudan `Image Logger` veya `Image Write` ile saklayın.
* Gürültülü girişleri ön işlemden geçirmek için `Blur` veya `Image Threshold` kullanarak görsel bölgenin tespit veya ölçüm akışlarıyla daha iyi hizalanmasını sağlayın.
* Ölçüm veya analiz bloklarıyla (ör. shape-analysis veya detectors) birlikte kullanmak için `Circle` çıktısını destekleyen yerlere iletin.

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

* Tuvalde görüntü görünmüyor: üst akıştaki bloğun görüntü ürettiğinden emin olun ve görüntünün yüklenmesi için senaryoyu bir kez çalıştırın.
* Çıktılar `None` dönüyor: daire merkezi veya yarıçap tanımlı değil ya da yarıçap pratikte sıfır. Daireyi yeniden çizin.
* Daire yerinden sapmış veya çok küçük görünüyor: üst akıştaki `Image Resize` ile tuvali yeniden ölçeklemeyi veya daireyi daha büyük bir ölçekte yeniden çizmeyi deneyin.
* Etkileşim duyarsız hissediliyor: görüntünün en az bir kez sağlandığından ve tuvalde gösterildiğinden emin olun; gerekirse bloğu yeniden çalıştırın.