> 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/detectors/detect-reference.md).

# Detect Reference

Bu fonksiyon bloğu, bir referans görüntüye dayalı olarak giriş görüntüsündeki nesneleri otomatik olarak tanımlamak için kullanılır. Tespit sürecini ince ayar yapmak için çeşitli seçenekler destekler.

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

`Image` Referans nesnenin tespit edilmesi gereken ana görüntü.

`Reference` Eşleştirilmesi gereken nesnenin referans görüntüsü.

`Mask` Tespit sürecinde dikkate alınacak alanları izole edebilen isteğe bağlı bir maske görüntüsü.

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

`Image Any` Eşleşen bölgeler vurgulanmış tespit edilen nesneleri gösteren çıktı görüntüsü.

`Rectangle Coordinates` Tespit edilen referansları sınırlayan dikdörtgenlerin koordinatlarını, birden fazla tespiti destekleyerek sağlar.

`Match Percentage` Her tespit edilen nesne için eşleşme yüzdesi.

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

`Match Threshold %` Eşleşmelerin kabul edilebilirlik eşiğini belirleyen bir kaydırıcı. Bu değeri ayarlayarak yanlış pozitifleri minimize edebilirsiniz.

`Down-size` İşlem hızını artırmak için referans görüntüsünün boyutunu küçülten bir kaydırıcı, böylece daha hızlı tespit sağlar.

`Rotations` Farklı yönlendirmelerde nesnelerin tespit edilmesi için döndürme dilimlerinin sayısını ayarlamak için bir kaydırıcı.

`Sweep Angle` Nesne tespiti sırasında döndürme açısını tanımlayan bir kaydırıcı aralığı.

`Horizontal Flip Search` Referans görüntüsünün ters çevrilmiş versiyonlarını dikkate alarak belirli koşullar altında tespiti kolaylaştıran bir onay kutusu.

`Estimation Method` Nesne eşleştirmesi için tahmin yöntemini seçmek amacıyla bir açılır menü.

`Color Mode` Görüntüleri gri tonlamalı veya renk (BGR) olarak işlemek için bir açılır menü; renkli işleme genellikle doğruluğu artırır.

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

`Rotational Detection` Farklı döndürme açılarından nesneleri etkili bir şekilde tespit ederek tespit yeteneklerini güçlendirir.

`Mask Support` Bir maske kullanma seçeneği, ana görüntünün kritik alanlarına odaklanarak tespit verimliliğini artırır.

`Visual Feedback` Sonuç görüntüsü, eşleşen alanları açıkça gösterir ve tespit sonuçlarına yönelik gerçek zamanlı geri bildirim sağlar.

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

1. **Connect Input Images**: Giriş görüntüsünü `Image` girişine, referans görüntüsünü `Reference` girişine bağlayın. İstediğiniz takdirde, bir maskeyi `Mask` girişine bağlayabilirsiniz.
2. **Set Parameters**: İstenilen eşleşme eşiğini, boyut küçültmeyi, döndürmeleri ve renk modunu tanımlamak için kaydırıcıları ve açılır menüleri kullanın.
3. **Evaluate**: Nesne tespitini gerçekleştirmek için bloğu çalıştırın. Ortaya çıkan çıktı, görüntüde bulunan eşleşmeleri gösterecektir.

## 📊 Değerlendirme <a href="#evaluation" id="evaluation"></a>

Çalıştırıldığında, bu fonksiyon bloğu sağlanan referansa dayalı olarak giriş görüntüsünü etkili bir şekilde analiz eder ve eşleşen görüntüyü, koordinatları ve eşleşme yüzdelerini çıkarır.

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

<details>

<summary>Tespiti İyileştirme</summary>

Tespit işlemi sırasında, referans görüntüsünün net ve iyi aydınlatıldığına emin olun. `Match Threshold %` değerini ayarlamak, tespitlerin doğruluğunu artırmaya yardımcı olabilir.

</details>

<details>

<summary>Maskeleri Kullanma</summary>

Eğer yalnızca giriş görüntüsünün belirli kısımlarıyla ilgileniyorsanız, `Mask` girişini kullanarak tespit işlemi için dikkate alınacak alanları kısıtlayın, bu da hem hız hem de doğruluğu artırır.

</details>

<details>

<summary>Döndürme Ayarları</summary>

Farklı yönlendirmelerde görülebilecek nesneleri tespit etmek için `Rotations` ve `Sweep Angle` kontrolleriyle en iyi ayarları bulmak için deneme yapın.

</details>

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

<details>

<summary>Eşleşme Bulunamadı</summary>

Eğer eşleşme bulamıyorsanız, referans görüntüsünün giriş görüntüsündeki nesneyi doğru bir şekilde temsil ettiğinden emin olun ve daha esnek bir eşleşme için `Match Threshold %` değerini daha düşük bir değere ayarlayın.

</details>

<details>

<summary>Performans Sorunları</summary>

Eğer performans düşüklüğü yaşıyorsanız, `Down-size` ayarını düşürmeyi düşünün; bu, tespit sürecinin daha küçük bir görüntü üzerinde çalışmasına olanak tanır, böylece hesaplama hızlanır.

</details>

<details>

<summary>Tespit Edilemeyen Alanlar</summary>

Eğer giriş görüntüsünün belirli bölgeleri sonuç vermiyorsa, `Mask` girişinde potansiyel engeller olup olmadığını kontrol edin veya belirli tespit beklediğiniz durumlara karşı referans görüntüsünü iyileştirin.

</details>