# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/turkish/fonksiyon-bloklari/detections-shapes/shape-analysis/translate-shape.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.