# Record Video

Bu fonksiyon bloğu, gelen görüntü karelerini bir video dosyasına kaydeder. Kaydı başlatıp durdurmak için boolean tetikleyici kullanabilir veya yerleşik Spacebar tetikleyicisini kullanabilirsiniz. Yüksek sıkıştırma gerektiren bir seçenek varsa ffmpeg yüklüyse bu mod kullanılabilir.

## 📥 Girdiler

* `Frame` — Kaydedilecek giriş görüntü kareleri.
* `Record` — Kaydı başlat/durdur için kullanılan boolean kontrol (seçilen tetikleme moduna bağlı olarak kullanılır).
* `Folder Path` — Kaydedilen videoların saklanacağı klasör yolu.
* `File Name (no extension)` — İsteğe bağlı dosya adı temeli. Boş bırakılırsa zaman damgası kullanılır.

## 📤 Çıktılar

* Bu fonksiyon bloğu herhangi bir çıktı sağlamaz.

## 🕹️ Kontroller

* `Video Quality` — Kalite modunu seçin:
  * `Compressed` — Daha küçük dosyalar, hızlı.
  * `High Quality` — Daha az sıkıştırma, daha iyi görsel kalite.
  * `High-Compress(requires ffmpeg)` — En yüksek sıkıştırma, fakat sistemde ffmpeg bulunması gerekir.
* `Trigger Mode` — Kaydın nasıl başlatılıp durdurulacağını seçin:
  * `Spacebar` — Başlat/durdur için boşluk tuşuna basın (işletim sisteminizde klavye hook izinleri gerektirebilir).
  * `Continuous` — Kaydı başlatmak için TRUE, durdurmak için FALSE sağlayın.
  * `Once` — Yükselen TRUE kaydı başlatır; sonraki TRUE kaydı durdurur ve kaydeder.
* `Recording` — Kaydın aktif olup olmadığını gösteren LED görsel göstergesi.

## 🎯 Temel Özellikler

* Üç tetikleme modu ile başlat/durdur (Spacebar, Continuous, Once).
* İsteğe bağlı ffmpeg tabanlı yüksek sıkıştırma dahil olmak üzere birden fazla kalite modu.
* Taşınabilirlik için mevcut video codec ve container türlerini otomatik seçme.
* Kayıt sırasında video dosyasının başka uygulamalar tarafından açılmasını engeller (dosya çakışmalarını önlemek için).
* High-compress modu için arka plan dönüştürmesi; sıkıştırma gerçek zamanlı yakalamayı engellemez (ffmpeg gerekir).

## 📝 Nasıl kullanılır

1. Görüntü karelerini `Frame` girişine sağlayın (ör. `Camera USB`, `Camera IP (ONVIF)` veya `Stream Reader`).
2. Videoların kaydedileceği `Folder Path`i ayarlayın.
3. İsteğe bağlı olarak `File Name (no extension)`i belirleyin veya zaman damgası kullanmak için boş bırakın.
4. İstediğiniz `Video Quality` modunu seçin. En küçük dosyalar için `High-Compress(requires ffmpeg)` seçeneğini ve sistemde ffmpeg kurulu olduğundan emin olun.
5. `Trigger Mode` seçin:
   * Hızlı klavye kontrolü için `Spacebar` (işletim sisteminiz izin veriyorsa).
   * Programatik kontrol için `Continuous` veya `Once` kullanın ve boolean değerleri `Record` girişine gönderin.
6. Seçilen tetiklemeye göre kaydı başlatın. Kaydederken `Recording` LED'i yanacaktır.
7. Kaydı durdurun ve bloğun videoyu finalize etmesine izin verin. Eğer high-compress modu seçildiyse, son sıkıştırma arka planda çalışabilir.

## 📊 Çalışma sırasında davranış

* Kayıt aktif olduğunda, `Frame` girişinden gelen kareler açık video dosyasına eklenir.
* Durdurulduğunda dosya kapatılır. High-compress seçilmiş ve ffmpeg mevcutsa, arka planda daha küçük, yüksek sıkıştırılmış bir dosya oluşturmak için dönüşüm başlatılabilir.
* Spacebar tetikleyicisi kullanımına izin verilmezse (ör. bazı Linux kurulumlarında root yetkisi olmadan), blok uyarı verecek ve `Continuous` veya `Once` modlarını kullanmanız önerilecektir.

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

* Yerel bir kameradan kaydetmek için `Camera USB` veya `Camera USB External` kaynaklarını `Frame` girişine bağlayın.
* Ağ kameraları için daha düzgün arka plan kare çekimi sağlamak adına `Camera IP (ONVIF)` veya `Stream Reader` kullanın.
* Aynı kaynağı bu blok ile birlikte canlı önizleme için `Show Image` bloğuna da gönderin.
* Kayıt sırasında bireysel kareleri paralel inceleme için `Image Logger` veya `Image Write` ile kaydedin.
* Bir şey önemli olduğunda otomatik tetikleme istiyorsanız, algılama bloklarını (ör. `Object Detection` veya `Mask Detection`) `Record` girişini sürücüleyecek mantık akışına bağlayın.
* Daha karmaşık klavye veya harici tetikleyiciler gerekiyorsa, `Keyboard/Barcode Reader` kullanarak bunları `Record` girişine yönlendirin.
* Daha küçük depolama alanı istiyor ancak kabul edilebilir kalite de istiyorsanız, `High-Compress(requires ffmpeg)` seçin ve ffmpeg'i sistem PATH'ine kurun.

## 🛠️ Sorun Giderme

* Spacebar tetikleyicisi Linux'ta çalışmıyorsa: Studio'yu yükseltilmiş ayrıcalıklarla çalıştırın veya `Continuous`/`Once` modlarını kullanın.
* Sıkıştırma kullanılamıyorsa: high-compress seçeneğini etkinleştirmek için ffmpeg'in kurulu ve sistem PATH'inde olduğundan emin olun. ffmpeg yoksa blok ffmpeg dışı moda geri döner ve uyarı verir.
* Kayıt sırasında dosya kullanımda hatası: Video dosyası kayıt sırasında diğer uygulamalar tarafından açılamaz. Kaydın bitmesini bekleyin.
* Kareler kaydedilmiyorsa: `Frame` girişine bağlı kaynağın geçerli görüntü sağladığını doğrulayın (önizleme için `Show Image` yardımcı olur).


---

# 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/outputs-exports/record-video.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.
