> 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/image-transformations/operations/image-translate.md).

# Image Translate

Bu fonksiyon bloğu, bir görüntüyü yatay ve/veya dikey olarak belirtilen piksel kadar kaydırır. Boşalan alan seçilen bir arka plan rengi ile doldurulur. `X displacement`, `Y displacement` ve `Background Color` girişleri isteğe bağlıdır — boş bırakıldığında görüntü değişmeden kalır veya varsayılanlar kullanılır.

## 📥 Girdiler

`Input Image`\
Taşınacak gri tonlu veya renkli ana görüntü (image soket).

`X displacement`\
Yatay kaydırma (piksel cinsinden) (number soket). Pozitif değerler görüntüyü sağa, negatif değerler sola kaydırır. İsteğe bağlı — boşsa 0 olarak değerlendirilir.

`Y displacement`\
Dikey kaydırma (piksel cinsinden) (number soket). Pozitif değerler görüntüyü aşağı, negatif değerler yukarı kaydırır. İsteğe bağlı — boşsa 0 olarak değerlendirilir.

`Background Color`\
Açığa çıkan arka plan alanlarını doldurmak için kullanılacak renk (pixel soket). İsteğe bağlı — verilmezse siyah olarak varsayılır.

## 📤 Çıktılar

`Translated Image`\
Kaydırma uygulandıktan sonraki sonuç görüntü (image soket). Çıktı görüntüsü girişle aynı boyutlarda olur; içerik kaydırılmış ve kenarlar seçilen renk ile doldurulmuştur.

## 🕹️ Kontroller

`X displacement`\
Yatay kaydırmayı piksel olarak girin. Sola kaydırmak için negatif değer kullanın.

`Y displacement`\
Dikey kaydırmayı piksel olarak girin. Yukarı kaydırmak için negatif değer kullanın.

`Background Color`\
Yeni oluşan boş bölgeleri dolduracak arka plan rengini seçin (`Pixel` stilinde giriş veya renk üreten bir blok kullanın).

## ✨ Özellikler

* İsteğe bağlı girişler: `X displacement` veya `Y displacement` boş bırakılabilir; o eksen değişmeden kalır.
* Giriş görüntü boyutunu korur; kaydırılmış içerik orijinal tuvale kırpılır.
* Hem gri tonlu hem de RGB görüntülerle çalışır.
* Arka plan doldurma, giriş görüntüsünün kanal sayısına göre tek kanal veya RGB değerleri kabul eder.

## 📝 Kullanım Talimatları

1. Bir görüntü üreten bloğu `Input Image` girişine bağlayın.
2. Görüntüyü hareket ettirmek için `X displacement` ve/veya `Y displacement` değerlerini sağlayın.
3. İsteğe bağlı olarak `Background Color` girerek açığa çıkan alanların doldurulmasını kontrol edin.
4. Sonuçları görüntüleme, analiz veya kaydetme için `Translated Image` çıktısını sonraki bloklara bağlayın.

Örnekler:

* Görüntüyü sağa 50 ve aşağı 20 piksel kaydırmak için `X displacement` = 50 ve `Y displacement` = 20 girin.
* Sadece dikey kaydırma yapmak için `Y displacement` değerini verin, `X displacement` boş bırakın.

## 📊 Çalışma Davranışı

Bloğu çalıştırdığınızda giriş görüntüsü ve kaydırma değerleri okunur, pikseller istenen miktarda kaydırılır, açığa çıkan bölgeler seçilen renk ile doldurulur ve `Translated Image` soketinde sonuç döndürülür. Boş bırakılan kaydırma değerleri sıfır olarak değerlendirilir.

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

* Önemli görüntü içeriğinin çarpılmasını veya kırpılmasını önlemek için önce `Image Padding` ile kenar boşluğu ekleyin veya `Image Resize` / `Make Image` ile daha büyük bir tuval oluşturun, sonra içinde kaydırma yapın.
* Kesin bir arka plan rengi gerekiyorsa `Pixel` veya küçük bir `Make Image` bloğu ile doğru rengi oluşturup `Background Color` girişine verin.
* Sadece kırpılmış bir alanı kaydırmak istiyorsanız `Image ROI` veya `Image ROI Select` ile bölgeyi seçip kaydırdıktan sonra `Image Concatenate` veya `Collage Images` ile birleştirin.
* Kaydırma sonrası görüntüyü çevirmek veya döndürmek isterseniz bu bloğun ardından `Flip Image` veya `Rotate Image Angle` bloklarını zincirleyin.
* Döşenmiş düzenler ya da kompozisyonlar için birden fazla dilimi kaydırıp `Image Concatenate` veya `Merge Channels` ile geri birleştirin.

## 🛠️ Sorun Giderme

* Sorun: Kaydırma sonrası görüntünün önemli kısmı kesildi.\
  Çözüm: Kaydırmadan önce `Image Padding` ile kenar ekleyin veya tuvali `Image Resize` / `Make Image` ile büyütün, sonra kaydırın.
* Sorun: Arka plan rengi beklenenden farklı.\
  Çözüm: `Background Color` girişinin kanal formatının doğru olduğundan emin olun (gri görüntü için tek değer, renkli görüntü için RGB üçlü). Kesin renk için `Pixel` kullanın.
* Sorun: Kaydırma değerleri verildiği halde değişiklik yok.\
  Çözüm: Kaydırma girişlerinin bağlı ve boş olmadığını kontrol edin; boş değerler sıfır kabul edilir.
* Sorun: Çok fazla piksel kaydırılırken kalite korunamıyor.\
  Çözüm: Önce daha büyük bir tuval üzerinde kaydırma yapmayı düşünün ve ardışık kırpmalardan kaçının; sonuçları doğrulamak için `Show Image` gibi bloklarla kontrol edin.