Blender 5.2 LTS’te komut satırından render ve Python otomasyonu

Bu rehberde neler öğreneceksiniz?

Blender’da her işi arayüz üzerinden yapmak gerekmiyor. Komut satırı, arka planda render almak ve aynı işlemi tekrar edilebilir bir komutla başlatmak için kullanılabilir. Blender’ın Python API’si ise açık dosyadaki nesnelere ve diğer verilere erişip basit raporlar hazırlamayı mümkün kılar.

Bu rehberde Blender 5.2 LTS komut satırı belgelerindeki render seçeneklerini kullanarak tek kare ve animasyon çıktısı alacağız. Ardından, Blender’ın yerleşik Python ortamıyla basit bir sahne raporu oluşturup betiği komut satırından çalıştıracağız. Örnekler, gerçek bir sahne dosyasındaki ayarları veya donanım uyumluluğunu varsaymaz; komutları kendi dosya ve render gereksinimlerine göre düzenlemek gerekir.

Gereksinimler

• Blender kurulu olmalı. Komut örnekleri Blender 5.2 LTS komut satırı belgelerine dayanıyor.

Adım adım: arka planda render alma

1. Tek bir kareyi render edin

-b veya --background, Blender’ı kullanıcı arayüzü olmadan çalıştırır. -f ile render edilecek kare numarası; -o ile çıktı yolu ve dosya adı; -F ile çıktı biçimi belirlenebilir. Aşağıdaki örnek, sahne.blend dosyasının 20. karesini PNG olarak render eder:

blender -b sahne.blend -o //render_ -F PNG -f 20

// ile başlayan çıktı yolu, .blend dosyasına göreli bir konum belirtir. Dosya adında # bulunmadığında Blender kare numarası için dosya adına otomatik olarak bir numaralandırma eki ekler. Birden fazla kare üretilecekse dosya adında # karakterleri kullanarak kare numarasının yerini ve sıfır dolgulu biçimini tanımlamak mümkündür.

2. Animasyonu sahnenin kare aralığında render edin

-a veya --render-anim, başlangıç ve bitiş kareleri arasındaki animasyonu render eder; iki uç kare de aralığa dahildir. Aşağıdaki komut örneğinde çıktı yolu göreli, biçim PNG olarak seçilmiştir:

blender -b sahne.blend -o //animasyon_## -F PNG -a

Başlangıç ve bitiş karelerini ayrıca belirtmek için -s ve -e seçenekleri kullanılabilir. -j ise render edilecek kareler arasında kaç kare ilerleme olacağını belirler. Bu seçeneklerle çalışırken sahne aralığını ve hedef kare örnekleme düzenini kontrol edin; yalnızca gereken kareleri almak, çıktı dizinini takip etmeyi kolaylaştırır.

-x veya --use-extension, dosya uzantısının çıktıya eklenip eklenmeyeceğini belirler. Uzantı eklenmesini açıkça istemek için belgelerdeki örnekte olduğu gibi -x 1 kullanılabilir. JPEG, PNG, TIFF ve HDR, listelenen biçimler arasındadır; bazı biçimlerin kullanılabilirliği Blender’ın derlenmiş sürümüne bağlı olabilir.

3. Render motoru, iş parçacığı ve Cycles aygıtını seçin

-E ile render motoru belirtilebilir; -E help kullanılabilir motorları listeler. -t render ve diğer işlemler için iş parçacığı sayısını ayarlar. Değer olarak 0 verilmesi, sistemin işlemci sayısının kullanılmasını sağlar.

Cycles aygıt seçeneği, Blender’ın normal komut satırı seçeneklerinden sonra çift tire ile ayrılır. Belgelerde CPU, CUDA, OPTIX, HIP, ONEAPI ve METAL seçenekleri listeleniyor. Bu seçeneklerin hedef bilgisayarda çalışacağı varsayılmamalı; seçimi kullanılan sistem ve Blender kurulumu üzerinde doğrulayın.

blender -b sahne.blend -f 20 -- --cycles-device OPTIX --cycles-print-stats

Bu örnek, Cycles için OPTIX aygıtını seçer ve bellek kullanımı ile render süresine ilişkin istatistiklerin kaydedilmesini ister. GPU aygıt adına +CPU eklenmesi, GPU ve CPU’nun birlikte kullanılmasını belirtir. Render motoru Cycles değilse Cycles’a özgü aygıt seçeneğini eklemek yerine o motorun kendi seçenekleri incelenmelidir.

4. Blender Python ile sahne verisini okuyun

Blender’ın Python API’si, arayüzde erişilebilen sahne ve nesne verileri üzerinde çalışabilir. İlk deneme için sahnedeki nesne adlarını yazdıran küçük bir betik yeterlidir:

import bpy

for obj in bpy.data.objects:
    print(obj.name)

Bu betiği Blender’da Scripting çalışma alanına geçip metin düzenleyicisinde yeni bir metin veri bloğu açarak çalıştırabilirsiniz. Kod metin düzenleyicisine yapıştırıldıktan sonra Run Script ile yürütülür. Kısa komutları denemek ve API’yi otomatik tamamlamayla incelemek için Python Console da kullanılabilir.

Aynı betik dosyası komut satırından --python seçeneğiyle çalıştırılabilir:

blender -b sahne.blend --python rapor.py

Bu yöntem, arayüz açmadan bir dosyadaki veriyi inceleyen raporların tekrarlanabilir biçimde çalıştırılmasına yardımcı olur. Komut satırından yürütülen betiklerde Python hatası oluştuğunda belirli bir çıkış koduyla sonlanmak için --python-exit-code seçeneği de belgelenmiştir. Çıkış kodunu ayarlamak, betiği otomatik iş akışına ekleyenlerin başarısız çalışmaları fark etmesine katkı sağlayabilir.

Sık yapılan hatalar

• Çıktı yolunu yanlış yorumlamak: // göreli yolu .blend dosyasına bağlar. Dosyanın başka bir klasörde olduğu varsayımıyla çıktı aramak, render’ın kaybolduğu izlenimini yaratabilir.

• Kare numarasını veya aralığı karıştırmak: -f tek kareyi render eder; -a animasyonu sahnenin başlangıç ve bitiş kareleri arasında işler. İstenen aralık için -s ve -e değerlerini kontrol edin.

• Cycles seçeneğini yanlış yerde yazmak: --cycles-device gibi Cycles seçenekleri, komut satırında -- ayırıcısından sonra gelmelidir.

• Donanımda mevcut olmayan aygıtı seçmek: Belgelerde listelenen aygıt adları, her kurulumun hepsini destekleyeceği anlamına gelmez. Önce hedef bilgisayarda kısa bir deneme render’ı alın.

• Python betiğinden gelen çıktıyı yanlış yerde aramak: Blender API belgelerine göre bazı örneklerin çıktısı terminale gider. Betik tamamlandığı hâlde çıktı görünmüyorsa, Blender’ın çalıştırıldığı terminali kontrol edin.

Mimarlık ve görselleştirme iş akışına etkisi

Arka plan render’ı, özellikle tekrarlanan kareleri veya animasyonları komutla başlatmak isteyen görselleştirme ekipleri için yararlı olabilir. Python betikleri de sahnedeki verileri inceleme ve basit raporlar üretme işlerini destekler. Bu yaklaşım, modelleme ya da tasarım kararlarının yerini almaz; üretim sürecindeki bazı işlemleri standartlaştırır.

İşe başlamadan önce Blender sürümünü, kullanılan render motorunu, çıktı biçimini ve hedef bilgisayardaki Cycles aygıt desteğini doğrulayın. Komut satırındaki seçenekler render’ı başlatmayı kolaylaştırsa da tek başına sahnenin doğru sonuç vereceğini garanti etmez. Önce tek kareyle yolu, biçimi ve aygıtı sınamak; ardından animasyona geçmek daha kontrollü bir yöntemdir. Lisans veya hesap koşulları bu belgelerde açıklanmıyor; ekip ortamında kurulum ve kullanım gereklilikleri ayrıca kontrol edilmelidir.

Sonraki adımlar

Tek kare örneğini kendi dosyanızda doğruladıktan sonra animasyon seçeneğine ve çıktı adlandırmasına geçin. Python tarafında önce salt okunur bir rapor betiği kullanın; nesne adlarını listelemek, sahneye erişimin çalıştığını görmek için basit bir başlangıçtır. Daha sonra komut seçeneklerini ve API referansını kontrol ederek ihtiyaca uygun işleri ekleyebilirsiniz. Python API belgeleri, bağlamın hangi alanda kullanıldığına göre değişebileceği ve bazı operatörlerin geçerli bir bağlam gerektirdiği konusunda uyarıyor. Dolayısıyla betiği, çalıştırılacağı Blender sürümü ve sahne bağlamında sınamak önemlidir.

Kaynak ve lisans

Blender Manual’ın “Command Line Arguments” sayfası ile Blender Python API’nin “Quickstart” ve “API Overview” sayfaları temel alınmıştır. Kaynakların üçü de CC BY-SA 4.0 lisanslıdır; içerik Türkçeye uyarlanıp yeniden anlatılmıştır. Örnek komutlar ve kısa Python betiği, belgelenen seçenekler ve API kullanımı temel alınarak bu rehber için hazırlanmıştır.