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

# Image ROI Select

Bu fonksiyon bloğu, önizleme üzerinde sürükleyerek tek bir dikdörtgen ilgi alanı (ROI) seçmenize olanak tanır. Görüntüden bir alanı kırpmak ve sonraki işleme veya inceleme için kullanmak için idealdir.

## 📥 Girdiler

`Image Any` Kırpılacak görüntü. Seçilebilecek alanı tanımlamak için gri tonlu veya renkli bir görüntü bağlayın.

## 📤 Çıktılar

`Image Any` Seçilen dikdörtgene karşılık gelen kırpılmış görüntü.

`Rectangle` Seçilen alanı tanımlayan piksel dikdörtgeni (sol-üst ve sağ-alt koordinatları).

## 🕹️ Kontroller

`Image Preview` Dikdörtgen ROI'yi fare ile oluşturup düzenleyeceğiniz etkileşimli önizleme alanı.

`Drag` Önizleme üzerinde sürükleyerek dikdörtgen oluşturun veya dikdörtgen içinde sürükleyerek konumunu değiştirin.

`Edge / Corner Drag` Bir kenar veya köşeyi sürükleyerek dikdörtgeni yeniden boyutlandırın.

`Ctrl` Mevcut bir dikdörtgen olsa bile yeni bir dikdörtgen oluşturmak için basılı tutun.

## 🎯 Özellikler

* Önizleme üzerinde etkileşimli dikdörtgen oluşturma, taşıma ve yeniden boyutlandırma.
* Görsel bindirme, mevcut dikdörtgeni gösterir ve etkileşim sırasında vurgular.
* Tek veya tekrar seçime izin verir; en son seçilen ROI çıktı için kullanılır.
* Kırpılmış sonuç, görüntü ve dikdörtgen koordinatlarıyla birlikte anında döndürülür.
* Seçilen dikdörtgen korunur; proje yeniden yüklendiğinde aynı ROI geri yüklenebilir.

## ⚙️ Çalışma Mekanizması

* `Image Any` girişine bir görüntü sağlayın ve önizlemeye yüklemek için senaryoyu bir kez çalıştırın.
* Önizlemeyi kullanarak `Drag` ile bir dikdörtgen çizin. Dikdörtgen içinde taşıma veya kenar/köşe sürükleyerek yeniden boyutlandırma yapın.
* Blok, seçilen dikdörtgenin piksel koordinatlarını hesaplar ve çıktı olarak:
  * Bu koordinatlardan çıkarılan kırpılmış görüntüyü `Image Any` üzerinden,
  * Dikdörtgen koordinatlarını `Rectangle` olarak verir.
* Önizleme bindirmesi, ROI oluştururken veya düzenlerken canlı olarak güncellenir.

## 📝 Kullanım Talimatları

1. Önizlemeyi doldurmak için bir görüntü üreten bloğu `Image Any` girişine bağlayın ve bir kez çalıştırın.
2. Önizleme üzerinde tıklayıp sürükleyerek ROI'yi çizin.
3. Gerekirse ROI'yi taşıyın veya yeniden boyutlandırın.
4. Yeni bir dikdörtgen oluşturmak için sürüklerken `Ctrl` tuşunu basılı tutun.
5. Kırpılmış görüntüyü veya dikdörtgen koordinatlarını downstream bloklara vermek için çıktıları kullanın.

## 💡 İpuçları ve Püf Noktaları

* Kırpılmış sonucu daha büyük bir görüntüleyicide incelemek için `Show Image` ile birleştirin.
* Birden fazla düzenlenebilir ROI gerekiyorsa, bu bloğun yerine `Image ROI Select Multi` kullanın.
* Tespit veya analiz çalıştırmadan önce kırpma boyutlarını normalize etmek için bu bloğun ardından `Image Resize` kullanın.
* Şablon eşleştirmeyi sadece seçili alan içinde çalıştırmak isterseniz, kırpılmış çıktıyı `Find Object` bloğuna verin — bu yanlış eşleşmeleri azaltır ve işlemi hızlandırır.
* Önemli kırpmaları kaydetmek için `Image Logger` veya `Image Write` kullanarak örnekleri kayıt altına alın.
* Tespitleri veya koordinatları orijinal görüntü üzerinde görselleştirmek için downstream'da `Draw Rectangle` ile `Rectangle` çıktısını kullanın.

## 🛠️ Sorun Giderme

* Önizleme boşsa, üreten bloğun bağlı olduğundan ve görüntü verisini yüklemek için pipeline'ı bir kez çalıştırdığınızdan emin olun.
* Seçim görüntünün dışında görünüyorsa, giriş görüntüsünün boyutlarını doğrulayın ve ROI'yi önizleme alanı içinde yeniden çizin.
* Son işlem için kırpılmış görüntü çözünürlüğünün downstream bloklar için uygun olduğundan emin olun (gerekirse `Image Resize` kullanın).