> 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/perspective-transform.md).

# Perspective Transform

Bu fonksiyon bloğu, bir görüntü üzerinde dörtgen bir bölge tanımlamanıza ve o bölgenin düzeltilmiş, tepeden görünüş (perspektif olarak dönüştürülmüş) halini oluşturmanıza olanak tanır. Etkileşime açıktır — görüntü üzerinde dört nokta seçin, sürükleyerek düzeltin ve seçimizi düzenlemek için klavye kısayollarını kullanın.

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

* `Image` — Nokta seçimi için blok içinde gösterilen kaynak görüntü.

## 📤 Outputs <a href="#outputs" id="outputs"></a>

* `Image` — Seçilen dörtgenin perspektif dönüşümü uygulanmış (warp edilmiş) görüntüsü.
* `Transform Matrix` — Perspektif dönüşüm matrisi (perspective veya homography matrisi gerektiren diğer bloklara beslemek için kullanışlı).

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

* `Interactive Image Area` — Görüntüye tıklayarak noktalar ekleyin. Noktalar eklendikçe üst üste binen bir çokgen olarak gösterilir.
* `Drag Points` — Bir noktayı tıklayıp sürükleyerek konumunu ayarlayın.
* `C` — Seçili tüm noktaları temizle.
* `U` — Son eklenen noktayı geri al.
* `Help Text` — Blok üzerinde noktaların nasıl ekleneceği, sürükleneceği, temizleneceği ve geri alınacağına dair kısa talimatlar.

Not: Üst üste binen katman, çokgenin tamamlanıp tamamlanmadığını gösterecek ve fare altındaki köşeyi vurgulayarak ayarlamayı kolaylaştırır.

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

* Blok, etkileşimli olarak dört nokta seçebilmeniz için bağlı görüntüyü gösterir.
* Dörtten az nokta tanımlanırsa blok, dönüşümün hazır olmadığını downstream bloklarının bilmesi için boş çıktılar döndürür.
* Dört nokta sağlandığında blok bunları sıralar, seçilen noktalardan çıktı dikdörtgen boyutunu hesaplar, perspektif dönüşümü oluşturur ve warp edilmiş görüntüyü `Transform Matrix` ile birlikte verir.
* Blok, aynı görüntü ve nokta kümesi için son hesaplanan dönüşümü önbelleğe alır; böylece senaryonun diğer kısımları ayarlanırken gereksiz yeniden hesaplamalardan kaçınılır.

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

* Tıklayıp sürükleyerek düzenlenebilen etkileşimli, görsel ROI seçimi.
* Hızlı düzenleme için klavye kısayolları.
* Görsel üst üste binen katman, çokgeni, köşe vurgusunu ve tamamlama durumunu gösterir.
* Düzgünleştirilmiş görüntü ile birlikte dönüşüm matrisini de çıktı olarak verir, böylece tekrar kullanılabilir.
* Seçilen noktalara göre uygun bir çıktı dikdörtgeni otomatik olarak seçer.

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

1. `Image` girişine bir görüntü üreten blok bağlayın.
2. Blok içindeki görüntü alanına tıklayarak en fazla dört köşe noktası belirleyin (herhangi bir sıra ile).
3. Noktaların konumlarını hassaslaştırmak için sürükleyin.
4. Son noktayı geri almak için `U`, tüm noktaları temizlemek için `C` kullanın.
5. Dört nokta girildiğinde blok, düzeltilmiş görüntüyü ve `Transform Matrix` çıktısını sağlayacaktır.

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

* Noktaları hassaslaştırırken kaynak veya dönüştürülmüş görüntüyü daha büyük bir görüntüleyicide önizlemek için `Show Image` kullanın.
* Önce alanı kırpmak isterseniz, bu bloğa `Image ROI Select` veya `Image ROI` ekleyerek daha küçük bir bölgede çalışın.
* Kaynak görüntünüz çok büyükse, etkileşimi hızlandırmak ve bellek kullanımını azaltmak için bu bloktan önce `Image Resizer` ekleyin.
* Üretilen `Transform Matrix`, warp edilmiş görünümden gerçek dünya mesafe ölçümleri almak için gerekli `Perspective Matrix` girişine sahip `Social Distance Detector` bloğuna beslenebilir.
* Düzeltmiş görüntüleri saklamak isterseniz `Image Write` ile çıktıları kaydedin.

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

* Çıktı görünmüyorsa, dört noktanın tanımlandığından emin olun — blok dörtgen tamamlanana kadar dönüşüm üretmez.
* Warp edilmiş görüntü bozuk görünüyorsa, köşe noktalarını sürükleyerek ayarlayın; ayar yaparken detayları incelemek için `Show Image` kullanın.
* Büyük görüntülerde etkileşim yavaşsa, bu bloktan önce `Image Resizer` ekleyin veya `Image ROI Select` ile kırpılmış bir bölge üzerinde çalışın.
* Yanlış bir noktayı eklediyseniz, son noktayı kaldırmak için `U` tuşuna basın veya yeniden başlamak için `C` kullanın.