> 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/shape-analysis/translate-shape.md).

# Translate Shape

Bu fonksiyon bloğu, geometrik şekilleri belirtilen yatay ve dikey ötelemeler kadar taşır. Görüntü koordinat sisteminiz içinde nokta, dikdörtgen, daire veya konturları kaydırmanız gerektiğinde kullanın.

## 📥 Girdiler

`Shape`\
Bir çevrilmesi istenen şekil. Kabul edilen tipler:

* Tek nokta (`x, y`)
* İki köşe noktasıyla tanımlanmış dikdörtgen
* Merkez ve yarıçap ile tanımlı daire (`center_x, center_y, radius`)
* Kontur (sıralı bir `(x,y)` noktalar dizisi)

`X`\
Yatay çeviri değeri (isteğe bağlı). Şekli X ekseni boyunca taşımak için tam sayı (piksel). Sağlanmazsa varsayılan 0'dır.

`Y`\
Dikey çeviri değeri (isteğe bağlı). Şekli Y ekseni boyunca taşımak için tam sayı (piksel). Sağlanmazsa varsayılan 0'dır.

(Tüm yukarıdakiler giriş soketleridir.)

## 📤 Çıktılar

`Shape`\
Aynı formatta (nokta, dikdörtgen, daire veya kontur) döndürülen çevrilmiş şekil.

(Bu bir çıktı soketidir.)

## 🕹️ Kontroller

Bu fonksiyon bloğunun ek bir kontrolü veya widget'ı yoktur. Çeviri değerlerini giriş soketleri aracılığıyla sağlayın.

## ⚙️ Çalışma mekanizması

* Çalıştırıldığında, blok verilen `Shape` ve isteğe bağlı `X` ile `Y` çeviri değerlerini okur.
* Çeviriler tam sayı piksel ofsetleri olarak uygulanır. Pozitif değerler şekli sağa/aşağı, negatif değerler sola/yukarı taşır.
* Blok, verilen ofsetlerle aynı şekil tipini geri döndürür. Konturlar için her köşe aynı `(X, Y)` ofseti kadar kaydırılır.
* Desteklenmeyen bir şekil tipi veya geçersiz veri sağlanırsa, blok bir yapılandırma hatası bildirir — şekil girişinin kabul edilen formatlardan biriyle eşleştiğinden emin olun.

## ✨ Özellikler

* Yaygın şekil tiplerini destekler: `point`, `rectangle`, `circle` ve `contour`.
* Zincirleme kullanım için çıktı formatını giriş formatıyla tutarlı tutar.
* Belirlenebilir konumlama için basit, tam sayı tabanlı çeviri.
* Tekil şekiller veya kontur dizileriyle toplu geometri dönüşümleri yapabilir.

## 📝 Kullanım talimatları

1. `Shape` soketine bir şekil sağlayın (ör. bir dedektörden dönen kontur).
2. `X` soketine yatay kaydırmayı girin (isteğe bağlı).
3. `Y` soketine dikey kaydırmayı girin (isteğe bağlı).
4. Çevrilmiş şekli çıktı `Shape` soketinden okuyun ve çizim, ölçüm veya sonraki işleme adımları için kullanın.

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

* Dedektör ve ROI blokları ile birleştirin:
  * `Find Contour`, `Find Object` veya `Approximate Contour` ile şekiller elde edip, hizalama veya ofset uygulamak için bu bloğa gönderin.
  * Koordinatların tutarlı kalması için çeviriden önce `Image ROI`, `Image ROI Select` veya `Get ROI` ile bölgeyi kırpın veya odaklayın.
* Çoklu şekiller veya listeler ile çalışma:
  * Bir şekil listesi üzerinde yinelemeli çeviri yapmak için `Batch Processing`, `Debatch` veya `Batch Concatenation` kullanın.
  * Görsel doğrulama için çevrilmiş sonuçları çizdirmek isterseniz, çıktıyı `Draw Point`, `Draw Rectangle` veya `Draw Result On Image` bloklarına gönderin.
* Ölçüm iş akışları için:
  * Şekilleri çevirdikten sonra taşınan ve referans pozisyonlar arasındaki mesafeyi hesaplamak için `Measure Position Distance` kullanın.
  * Çeviri sonrası geometric özetleri dönüştürüp karşılaştırmak için `Minimum Rectangle`, `Hull Convex` veya `Contour to Image` kullanın.
* Görselleştirme ve hata ayıklama:
  * Çevrilmiş konturları veya dikdörtgenleri görüntü üzerinde görmek için çevrilmiş şekli `Draw Rectangle` veya `Draw Result On Image` içine yönlendirip `Show Image` ile önizleyin.

## 🛠️ Sorun Giderme

* Çeviri sonrası değişiklik görünmüyor:
  * `X` veya `Y` için sıfır olmayan değerler girildiğini doğrulayın.
  * Çizim/görüntüleme bloğunun (ör. `Show Image` veya `Draw Rectangle`) çevrilmiş şekli alıp almadığını ve aynı koordinat sistemini kullandığını kontrol edin.
* Beklenmeyen şekil format hataları:
  * Giriş şeklinin desteklenen formatlardan biriyle uyumlu olduğunu doğrulayın (`point`, `rectangle`, `circle`, `contour`).
  * Listelerle çalışıyorsanız, bunların toplu veya liste uyumlu akışla sağlandığından emin olun (gerektiğinde `Batch Processing` / `Debatch` kullanın).
* Görüntü dışına taşma:
  * Çeviriler şekilleri görüntü alanının dışına taşıyabilir. Bu durum endişe veriyorsa, koordinatları sınırlandırmak veya çeviriden önce ROI'yi kırpmak gibi aşağı akış kontrolleri uygulayın.