# Blender Python ile sahne, kamera ve render ayarları nasıl yönetilir?

Kaynak: https://3dsinifi.com/haber/blender-python-ile-sahne-kamera-ve-render-ayarlari-nasil · Kategori: Eğitimler · Yayın: 16 Kasım 2026

> Blender Python API, sahne zaman aralığından aktif kameraya ve render çözünürlüğüne kadar pek çok ayarı yönetmeye imkân veriyor. Bu rehber, mimari görselleştirme için temel özellikleri örneklerle açıklıyor.

## Kısaca
- Sahne aralığı, geçerli kare ve simülasyon aralığı Scene özellikleriyle düzenlenebiliyor.
- Aktif kamera, lens değeri ve kompozisyon kılavuzları Camera özellikleri arasında yer alıyor.
- Render çözünürlüğü, kare hızı ve çıktı davranışı RenderSettings üzerinden ayarlanabiliyor.
- Eski compositing özelliklerinden bazıları güncel API belgelerinde kullanımdan kaldırılacak olarak işaretleniyor.

## Bu rehberde neler öğreneceksiniz?

Blender Python API, bir sahnenin zaman aralığı ve aktif kamerası gibi verileri kod üzerinden düzenlemeye yarar. Render ayarları da aynı sahnenin render verisi üzerinden kontrol edilebilir. Bu rehberde, mimari görselleştirme ve iç mekân sunumlarında tekrar kullanılabilecek temel ayarları ele alıyoruz: sahne ve simülasyon kareleri, kamera lensi ve kadraj kılavuzları, çıktı çözünürlüğü ve kare hızı.

Örnekler, mevcut bir Scene veri bloğunun `scene`, mevcut bir kamera veri bloğunun da `camera` değişkeninde bulunduğunu varsayar. Kod parçaları, değişkenleri hazırlayan bir kurulum betiği değil; belirtilen özelliklere uygulanacak atamalardır. API belgelerinde özellik adları ve kabul edilen değer aralıkları açıklanır. Bu nedenle değişiklikleri proje dosyasının bir kopyasında denemek, sahneye uygun olmayan ayarların sonuçlarını karşılaştırmayı kolaylaştırır.

## Gereksinimler

Blender ve Python API belgelerinde yer alan Scene, RenderSettings ve Camera özellikleri gerekir. Kaynaklar belirli bir Blender uygulama sürümü, hesap türü veya ücret koşulu belirtmiyor. Kod örnekleri, Scene ve Camera referanslarına erişilebildiği bir Python bağlamında uygulanmalıdır; bu rehberde referansların nasıl elde edileceğine dair belgelenmemiş bir menü yolu ya da kurulum adımı varsayılmıyor.

Ayarların her biri aynı amaca hizmet etmez. Scene özellikleri sahnenin kare aralığını ve aktif kamerasını tanımlarken, RenderSettings çıktı ve render davranışını düzenler. Kamera özellikleri ise lens ve kadraj kılavuzları gibi kamera verilerini tutar. Önce hangi veri bloğunun değiştirileceğini belirlemek, yanlış özelliğe müdahale etme riskini azaltır.

## Adım 1: Sahnenin kare aralığını düzenleyin

Scene veri bloğunda `frame_start` ve `frame_end`, oynatma ve render aralığının başlangıç ve bitiş karelerini belirtir. `frame_current` geçerli kareyi gösterir. Animasyon ya da aşamalı bir mimari sunum için bu değerleri açıkça belirlemek, sahne zamanlamasını betik içinde görünür kılar.

Aşağıdaki örnekte sahne aralığı 1 ile 120 arasında tanımlanıyor. Bu değerler, belgelerde verilen izinli aralık içindeki örnek ayarlardır; belirli bir proje için zorunlu kare sayısı değildir.

```python
scene.frame_start = 1
scene.frame_end = 120
scene.frame_current = 1
```

Simülasyonların zaman aralığı sahnenin genel aralığından ayrı tutulabilir. `simulation_frame_start` ve `simulation_frame_end` simülasyonun başlangıç ve bitiş karelerini belirler. `use_custom_simulation_range` ise sahne aralığından farklı bir simülasyon aralığı kullanılıp kullanılmayacağını kontrol eder. Bu seçenek, farklı sürelerde çalışan sahne ve simülasyon aralıklarını ayırt etmek gerektiğinde önem taşır.

```python
scene.use_custom_simulation_range = True
scene.simulation_frame_start = 1
scene.simulation_frame_end = 120
```

Bu değerleri değiştirmek simülasyonun görsel sonucunu tek başına garanti etmez. Projedeki simülasyon düğümlerinin kendi kare aralığını geçersiz kılıp kılmadığı da dikkate alınmalıdır; API açıklaması, özel aralığın bu tür düğümlerin aralığı kendilerince değiştirmediği durumlarda kullanıldığını belirtiyor.

## Adım 2: Aktif kamerayı ve kompozisyonu kontrol edin

Sahnedeki `camera` özelliği render için kullanılacak aktif kamerayı tutar. Kamera veri bloğundaki `lens` perspektif kameranın odak uzaklığını milimetre cinsinden belirler. `lens_unit` ile arayüzde odak uzaklığının milimetre ya da görüş açısı üzerinden düzenlenmesi seçilebilir. Aşağıdaki örnek, kamera verisinin değişken olarak hazır olduğunu varsayar.

```python
camera.lens_unit = 'MILLIMETERS'
camera.lens = 35.0
```

Kamera görünümünde kompozisyon kılavuzları gösterilebilir. Örneğin üçler kılavuzu `show_composition_thirds`, altın oran kılavuzu ise `show_composition_golden` özelliğiyle açılıp kapatılır. Bu kılavuzlar kadrajı değerlendirmeye yardımcı olur; sahne geometrisini ya da kamera konumunu kendiliğinden değiştirmez.

```python
camera.show_composition_thirds = True
```

Mimari iç mekânlarda kadrajı değerlendirirken görüntü oranı ve kamera görüş alanı birlikte incelenmelidir. Camera API’sinde yatay ve dikey görüş açısı özellikleri de bulunur. Ayrıca ortografik ölçek ve panorama türleri gibi seçenekler mevcuttur; ancak bunlar farklı kamera türleri ve kullanım amaçlarıyla ilişkili olduğundan, perspektif bir iç mekân kamerasına uygulanacak varsayılan ayarlar gibi değerlendirilmemelidir.

## Adım 3: Render çıktısı ve performansla ilgili tercihleri ayarlayın

RenderSettings, yatay ve dikey çözünürlük ile çözünürlük yüzdesini içerir. Kare hızı `fps` özelliğiyle tanımlanır. Aşağıdaki örnek, belgelerde verilen varsayılan çözünürlük ve kare hızı değerlerini açıkça yazar. Proje tesliminde hedeflenen görüntü boyutu ve animasyon ayarları farklıysa değerler buna göre seçilmelidir.

```python
scene.render.resolution_x = 1920
scene.render.resolution_y = 1080
scene.render.resolution_percentage = 100
scene.render.fps = 24
```

Daha hızlı bir önizleme için `resolution_percentage` düşürülebilir; nihai çıktı öncesinde bunun tekrar kontrol edilmesi gerekir. Belgeler bu özelliği render çözünürlüğünün yüzdesi olarak tanımlar. Render bölgesi kullanımı için `use_border` ve sınır koordinatları bulunur; `use_crop_to_border` ise çıktının tanımlanan bölgeye göre kırpılmasını kontrol eder.

Render iş akışında kompozisyon da gözden geçirilmelidir. RenderSettings içindeki `use_compositing`, render sonucunun sahneye atanmış bir compositor düğüm grubundan geçirilmesini kontrol eder. Belgeler, eski `Scene.use_nodes` özelliğinin artık etkisiz olduğunu ve kompozisyonu açıp kapatmak için `scene.render.use_compositing` kullanılmasını söylüyor. `compositing_node_group` özelliği de 5.0 sürümünden itibaren kullanımdan kaldırılacak olarak işaretlenmiş; belgelerde kaldırılma planı 6.0 sürümü olarak belirtilmiştir. Bu nedenle eski betiklerdeki özellik adlarını güncel API açıklamasıyla karşılaştırmak gerekir.

## Yaygın hatalar ve sonraki adımlar

En sık karşılaşılan sorunlardan biri, sahne aralığı ile simülasyon aralığını aynı ayar sanmaktır. Bir diğeri, aktif kamera yerine başka bir kamera veri bloğunun özelliklerini değiştirmektir. Render çözünürlüğü yüzdesi, boyutlar ve kare hızı da son çıktıdan önce birlikte kontrol edilmelidir. `use_persistent_data` daha hızlı yeniden render ve animasyon render’ı için veriyi bellekte tutabilir; ancak API açıklamasına göre bunun karşılığında bellek kullanımı artar.

Sonraki adım olarak her ayar grubunu ayrı bir betik parçasında deneyin: önce kare aralığı, sonra kamera kadrajı, en son çıktı ayarları. Her değişiklikten sonra kısa bir önizleme alıp sonuçları karşılaştırın. Birden fazla projede aynı değerleri kullanmak gerekiyorsa atamaları tek bir düzenli betik akışında toplamak tekrarlanabilirliği artırabilir; yine de aktif sahne ve kamera referanslarının doğru olduğundan emin olun. Render ayarlarında GPU seçeneği görünse bile, kaynaklar belirli donanım uyumluluğu veya performans sonucu vaat etmiyor; mevcut sistemde test yapılmalı.

## Kaynak ve lisans

Bu rehber, Blender API belgelerindeki Scene, RenderSettings ve Camera açıklamalarından çevrilip uyarlanmıştır. Kaynak belgeler CC BY-SA 4.0 lisansıyla sunulmaktadır: Blender API’nin Scene, RenderSettings ve Camera sayfaları.

## Pro ipucu
Render’dan önce `frame_start`, `frame_end`, `resolution_x`, `resolution_y` ve `resolution_percentage` değerlerini aynı kontrol betiğinde gözden geçirin.

## 3dsınıfı yorumu
Türkiye’deki mimarlık ofisleri ve görselleştirme ekipleri için bu özelliklerin pratik değeri, sık tekrarlanan sahne ve çıktı ayarlarını daha tutarlı hâle getirebilmesinde. Özellikle animasyon aralığı, çözünürlük ve kamera kadrajını betikle yönetmek, proje devrinde ayarların izlenmesini kolaylaştırabilir.

Bununla birlikte API kullanımı tek başına render süresini düşürmez; kalıcı render verisi belleği artırabilir ve GPU seçeneğinin faydası mevcut sisteme bağlıdır. Ofisler, betikleri kendi sahne yapılarıyla test etmeli; eski `use_nodes` kullanımını da güncel özelliklerle karşılaştırmalıdır. Kaynaklarda ürün fiyatı veya donanım uyumluluğu belirtilmediğinden, satın alma ya da performans kararı için bu rehber tek başına yeterli değildir.

## Kaynaklar
- [docs.blender.org (CC BY-SA 4.0)](https://docs.blender.org/api/current/bpy.types.Scene.html) (özet)
- [docs.blender.org (CC BY-SA 4.0)](https://docs.blender.org/api/current/bpy.types.RenderSettings.html) (özet)
- [docs.blender.org (CC BY-SA 4.0)](https://docs.blender.org/api/current/bpy.types.Camera.html) (özet)

_Yapay zekâ ile yazıldı, kaynaklarla doğrulandı. © 3dsınıfı_
