# Play Folder

Bu fonksiyon bloğu, seçili bir klasörden görüntüleri oynatır ve her değerlendirmede bir dosya döndürür. Görüntü veri setlerinde adım adım ilerlemek, dizileri önizlemek veya görüntüleri sonraki işlem bloklarına beslemek için kullanın. Varsayılan klasörü `Select folder` düğmesi ile seçebilir, çalışma zamanında bunu `Folder Path` girişi ile geçersiz kılabilir, dosyaları bir glob paterniyle filtreleyebilir ve oynatmayı `Mode` ve `Order` kontrolleriyle yönetebilirsiniz.

## 📥 Girdiler

* `Folder Path`\
  Varsayılan klasörü, `Select folder` düğmesiyle belirlenen değerin yerine geçecek isteğe bağlı bir string giriştir. Kaynağı çalışma zamanında değiştirmek için tam klasör yolu sağlayın.
* `Restart`\
  İsteğe bağlı boolean girdi. `True` olduğunda blok, mevcut `Mode` için oynatmayı sıfırlar ve o değerlendirmede sıfırlanmış (kenar) görüntüyü döndürür.

Not: Bunlar giriş soketleridir.

## 📤 Çıktılar

* `Image`\
  Klasörden okunan mevcut görüntü dosyası. Bu bir görüntü çıkış soketidir.
* `File Path`\
  Mevcut görüntü dosyasının mutlak yolu. Bu bir string çıkış soketidir.
* `Restarted`\
  Bu değerlendirmede blok sarmalanmış veya sıfırlanmış bir kenar görüntüsü döndürdüyse `True` olan boolean değeri. Bu da bir çıkış soketidir.

Not: Bunlar çıkış soketleridir.

## 🕹️ Kontroller

* `Select folder`\
  `Folder Path` boş olduğunda kullanılacak varsayılan klasörü seçmek için düğme.
* `Glob pattern`\
  Python glob sözdizimi kullanarak dosyaları filtrelemek için metin alanı (örnekler: `*`, `*.png`, `**/*`).
* `Mode`\
  Oynatma yönünü kontrol eden açılır menü: `Forward`, `Backward` veya `Stop`.
* `Order`\
  Dosya sıralamasını seçen açılır menü: `Name` (doğal dosya adı sıralaması) veya `Time` (dosya değiştirme zamanı).

Not: Bunlar, bloğun dosyaları seçme ve döndürme şeklini etkileyen görünür widgetlardır.

## 🎨 Özellikler

* Oynatma listesi yönetimi: seçilen klasör, glob paterni ve sıralama ile eşleşen görüntü dosyalarının listesini oluşturur ve önbelleğe alır.
* Esnek oynatma: ileri, geri ve durdurulmuş modlarıyla sarmalama davranışını destekler.
* Klasör geçersiz kılma: kaydedilmiş varsayılanı değiştirmeden çalışma zamanında `Folder Path` ile kaynağı değiştirme olanağı.
* Restart işlemi: açık `Restart` girişi oynatmayı sıfırlar ve o değerlendirmede kenar görüntüyü döndürür.
* Dosya meta verisi çıktısı: günlükleme veya sonraki işlemler için mutlak yolu döndürür.
* Opsiyonel eşzamansız kare yükleme: mevcutsa kareler arka planda uzak günlükleme için yüklenebilir.

## ⚙️ Çalıştırma mekanizması

Her değerlendirmede blok, etkin klasörü (varsayılan veya geçersiz kılınmış) belirler, `Glob pattern` ve `Order` ayarlarını kontrol eder ve gerektiğinde dahili oynatma listesini yeniler. Mevcut indeksi takip eder ve o indeksdeki görüntüyü, dosya yolunu ve `Restarted` bayrağını döndürür. Mevcut görüntüyü döndürdükten sonra, seçili `Mode`a (forward/backward/stop) göre bir sonraki indeksi hazırlar ve gerekiyorsa başa veya sona sarar.

## 📝 Kullanım talimatları

1. Varsayılan klasörü seçmek için `Select folder` düğmesine tıklayın veya boş bırakıp çalışma zamanında `Folder Path` girdisiyle bir yol sağlayın.
2. Dosyaları filtrelemek için bir `Glob pattern` girin (`*` ile hepsini seçebilir veya `*.jpg` / `**/*.png` gibi türleri belirtebilirsiniz).
3. Değerlendirmeler arasında ilerlemek, geri almak veya aynı görüntüyü tutmak için `Mode` seçin.
4. Dosyaları isim veya değiştirme zamanına göre sıralamak için `Order` seçeneğini belirleyin.
5. İsteğe bağlı olarak oynatmayı sıfırlamak için `Restart` = True gönderin; bu, mevcut modun kenar görüntüsünü döndürecektir.

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

* `Image` çıkışını `Show Image` bloğuna bağlayarak klasörde gezinirken görseli daha büyük pencerede önizleyin.
* İlginizi çeken kareleri `Image Write` ile kaydedin veya örnekleri toplu olarak dışa aktarmak için `Image Logger` kullanın.
* Görüntüler sonraki AI blokları için çok büyükse, `Image` çıkışından sonra `Image Resize` veya `Image Resizer` bağlayarak işlem süresini azaltın.
* Her görüntünün belirli bir alanına odaklanmak istiyorsanız, bu bloktan sonra `Image ROI Select` (veya `Image ROI`) kullanıp kırpılmış sonucu `Find Object` veya `Mask Detection` gibi dedektörlere verin.
* Görsel raporlar veya birleştirilmiş görünümler oluşturmak için birden fazla kareyi toplayıp `Collage Images` veya `Image Concatenate` bloklarına iletin.
* Veri seti odaklı iş akışları kurarken, `File Path` çıktısını kullanarak görüntü verileriyle birlikte günlükler veya CSV dosyaları oluşturun.

(İpucu: yalnızca ortamınızdaki listelenen fonksiyon bloklarıyla kombinasyon yapın.)

## 🛠️ Sorun Giderme

* Dosya bulunamıyor: Seçili klasörün desteklenen görüntü uzantılarını içerdiğini ve `Glob pattern`in dosya adlarınızla eşleştiğini kontrol edin.
* Geçersiz klasör geçersiz kılma: `Folder Path` girişinin boş olmayan bir string olduğundan ve var olan bir dizine işaret ettiğinden emin olun.
* Beklenmeyen sıralama: Değiştirme zamanına göre sıralama için `Order` = `Time`, dosya adıyla öngörülebilir sıralama için `Order` = `Name` kullanın (doğal sıralama sayısal parçaları doğru ele alır).
* Oynatma ilerlemiyor: `Mode` ayarının `Stop` olmadığını ve bloğun değerlendirmeler aldığına dikkat edin (bazı çalışma modları yalnızca senaryo yürütüldüğünde değerlendirme yapar).


---

# 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/input-output/image-inputs/play-folder.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.