# Blender Python API’ye giriş: Mimari sahneler için ilk otomasyonlar

Kaynak: https://3dsinifi.com/haber/blender-python-apiye-giris-mimari-sahneler-icin-ilk · Kategori: Eğitimler · Yayın: 21 Kasım 2026

> Blender’ın Python API’siyle sahne verilerini incelemek, nesnelere özel özellikler eklemek ve basit araçlar hazırlamak mümkün. Bu başlangıç rehberi, mimari görselleştirme sahnelerinde ilk otomasyon adımlarını gösteriyor.

## Kısaca
- Python Console, kısa komutları denemek ve API’yi otomatik tamamlama yardımıyla keşfetmek için kullanılabiliyor.
- bpy.data, açık Blender dosyasındaki nesne, sahne ve materyal verilerine erişim sağlıyor.
- Özel özellikler nesnelere eklenebiliyor ve blend dosyasıyla birlikte saklanıyor.
- Bir operatör, Blender’a kaydedilip arama menüsünden çalıştırılabilir.

## Bu rehberde ne öğreneceksiniz?

Blender Python API, arayüzde değiştirilebilen pek çok veriye Python üzerinden erişmeye ve bunları düzenlemeye imkân tanıyor. Mimari modelleme ve görselleştirmede bunun karşılığı; sahnedeki elemanları incelemek, nesnelere proje bilgisi eklemek veya sık tekrarlanan işleri bir araca dönüştürmek olabilir. Bu rehberde önce sahne verisini okuyacak, ardından aktif nesneye özel bir özellik ekleyecek ve son olarak basit bir operatör hazırlayacaksınız.

Buradaki örnekler, Blender’ın Python API’sine giriş için hazırlanmış resmi hızlı başlangıç belgesindeki yöntemlere dayanıyor. API genel olarak kararlı olarak tanımlansa da belgenin bazı bölümlerinin geliştirilmeye devam ettiği belirtiliyor. Bu nedenle bir özelliği üretim dosyalarında kullanmadan önce küçük bir test sahnesinde denemek iyi bir alışkanlık.

## Gereksinimler

- Blender kurulu olmalı. Kaynak belge belirli bir Blender sürüm numarası vermediği için burada sürüm uyumluluğu hakkında kesin bir numara belirtmiyoruz.
- Python’ı ayrıca kurmak gerekmiyor; örnekler Blender’ın içindeki Python Console veya Text Editor üzerinden çalıştırılıyor.
- Hesap ya da ücretli lisans gereksinimi kaynaklarda belirtilmiyor.
- API’yi keşfetmek için Blender tercihlerinde Developer Extras ve Python Tooltips seçeneklerini etkinleştirmek faydalı. Düğme ipuçları, ilgili Python özniteliklerini ve operatör adlarını bulmaya yardımcı olabiliyor.

Kısa komutlar ve denemeler için Python Console kullanılabilir. Birden fazla satır içeren betikleri düzenleyip saklamak için Blender’ın Scripting çalışma alanı ve Text Editor daha elverişli. Bu çalışma alanına üst çubuktaki sekmelerden ulaşılabiliyor.

## Adım adım: sahne verisine erişim ve ilk araç

### 1. Sahnedeki nesneleri Python ile listeleyin

Scripting çalışma alanını açın ve Python Console’a geçin. Konsol, otomatik tamamlama sunduğu için `bpy` içindeki veri ve özellik adlarını araştırırken de kullanışlıdır. Açık sahnedeki nesneleri sırayla yazdırmak için şu kodu çalıştırın:

```python
import bpy

for ob in bpy.context.scene.objects:
    print(ob)
```

Bu örnek, geçerli sahnenin nesne koleksiyonunu dolaşır ve her nesneyi konsol çıktısına gönderir. Mimari bir dosyada bu yöntem, sahnede hangi nesnelerin bulunduğunu hızlıca kontrol etmek için temel bir başlangıçtır. Daha sonra döngünün içine, kaynakta belgelenen erişim biçimlerinden yararlanarak ad, veri veya başka öznitelikleri inceleyen işlemler eklenebilir.

### 2. Veriyi bpy.data üzerinden bulun

Blender dosyasındaki veri bloklarına `bpy.data` üzerinden erişilir. Belge; nesneler, sahneler ve materyaller gibi koleksiyonları örnekliyor. Bir koleksiyon elemanına adıyla ulaşmak mümkündür:

```python
bpy.data.objects["Cube"]
```

Aynı koleksiyona sayısal indeksle de erişilebilir; ancak belge, çalışırken bir elemanın indeksinin değişebileceği uyarısını yapıyor. Bu nedenle belirli bir sahne elemanını ararken adıyla erişmek, indeks değerini sabit kabul etmekten daha anlaşılır bir tercihtir. Dosyadaki adın farklı olabileceğini de hesaba katın; örnekteki `Cube` adı yalnızca belgede kullanılan örnek nesne adıdır.

### 3. Aktif nesneye özel bilgi ekleyin

Bir nesneye, sahneye veya koleksiyona özel özellik eklemek için Python API’sinin özel özelliklerinden yararlanılabilir. Aşağıdaki örnek, aktif nesne varsa ona bir metin değeri kaydeder:

```python
import bpy

obj = bpy.context.object
if obj is not None:
    obj["project_note"] = "interior study"
```

Buradaki `bpy.context.object`, bağlama göre aktif nesneyi verir. Aktif nesne yoksa işlem yapılmaması için koşul kullanılır. Kaynak belgeye göre bu tür özel özellikler blend dosyasıyla saklanır ve nesneler kopyalandığında onlarla birlikte taşınır. Dolayısıyla bir nesneye proje notu veya ekip içinde tanımlanmış basit bir bilgi eklemek için kullanılabilir. Özellik adlarını tutarlı seçmek, birden fazla betik ve dosyada çalışırken veriyi bulmayı kolaylaştırır.

Özel özelliklere yalnızca temel Python türleri atanabilir: tam sayı, ondalıklı sayı, metin, sayı dizileri ve belirli kurallara uyan sözlükler. İç içe sözlükler için belgede 1024 seviyelik bir üst sınır veriliyor; bu derinliği aşmak hata ve veri kaybına yol açabilir. Bu örnekte basit bir metin değeri kullanıldığı için böyle bir iç içe yapı söz konusu değil.

### 4. Tekrarlanabilir işi operatöre dönüştürün

Bir kod parçasını Blender içinden tekrar çalıştırmak için operatör tanımlanabilir. Aşağıdaki örnek, sahnedeki nesneleri yazdıran ve aktif nesne yoksa çalıştırılmasına izin vermeyen basit bir operatör oluşturur:

```python
import bpy

def main(context):
    for ob in context.scene.objects:
        print(ob)

class SimpleOperator(bpy.types.Operator):
    """Tooltip"""
    bl_idname = "object.simple_operator"
    bl_label = "Simple Object Operator"

    @classmethod
    def poll(cls, context):
        return context.active_object is not None

    def execute(self, context):
        main(context)
        return {'FINISHED'}

def menu_func(self, context):
    self.layout.operator(
        SimpleOperator.bl_idname,
        text=SimpleOperator.bl_label
    )

def register():
    bpy.utils.register_class(SimpleOperator)
    bpy.types.VIEW3D_MT_object.append(menu_func)

def unregister():
    bpy.utils.unregister_class(SimpleOperator)
    bpy.types.VIEW3D_MT_object.remove(menu_func)

if __name__ == "__main__":
    register()
```

Scripting çalışma alanında Text Editor’ı seçin, `New` düğmesiyle yeni bir metin veri bloğu açın, kodu yapıştırın ve `Run Script` düğmesine basın. Kaynak belgedeki örnekte operatör kaydedildikten sonra Operator Search üzerinden `Simple` araması yapılabiliyor. `poll()` denetimi, aktif nesne olmadığında operatörün çalışmasını önler. Bu ayrıntı, betiğin kullanıcı bağlamına bağlı olduğu durumlarda önem taşır.

### 5. Konsol ve arayüz bağlamını göz önünde bulundurun

`bpy.context` içeriği, kodun çalıştırıldığı alana göre değişebilir. Python Console ile 3D Viewport aynı bağlam üyelerine sahip olmayabilir. Ayrıca context değerleri doğrudan değiştirilemez; kaynakta aktif nesneyi doğrudan atamanın hata verdiği, bunun yerine `bpy.context.view_layer.objects.active` yolunun kullanılabildiği açıklanıyor. Bir operatör beklenmedik biçimde çalışmıyorsa önce hangi alanda ve hangi modda çalıştırıldığını kontrol edin.

## Sık yapılan hatalar

- **İndeksi kalıcı kimlik gibi kullanmak:** Koleksiyon indeksleri çalışma sırasında değişebilir. Belirli bir elemanı seçerken adıyla erişmek daha anlaşılırdır; dosyada bu adın gerçekten bulunduğunu doğrulayın.
- **Her operatörün her yerde çalışacağını varsaymak:** Bazı operatörler doğru alanı, modu veya seçimi gerektirir. `poll()` koşulu bu uygunluğu kontrol eder; geçersiz bağlamda çağrı hata üretebilir.
- **Context’i doğrudan değiştirmeye çalışmak:** `bpy.context` salt okunur olarak tanımlanır. Değişiklik gerekiyorsa belgelenen veri API’sini veya uygun API işlevini kullanın.
- **Özel özelliklere karmaşık veri yığmak:** Desteklenen türler sınırlıdır; sözlük değerleri de temel türlerden oluşmalıdır. Basit ve açık özellikler tercih edin.
- **Betik çıktısını yanlış yerde aramak:** Örnekteki `print` çıktısı terminale gönderilir. Çalıştırma sonucunu göremiyorsanız Blender’ın terminalini kontrol edin.

## Sonraki adımlar: mimari ve görselleştirme iş akışları

Bu temel yöntemler, sahne düzenini denetlemek veya nesnelere ek bilgi bağlamak isteyen mimarlar, iç mimarlar ve görselleştirme sanatçıları için başlangıç noktası olabilir. Örneğin bir dosyadaki nesneleri listelemek, büyük sahnelerde içerik kontrolünü kolaylaştırabilir; özel özellikler ise ekip içinde belirlenen basit etiketleri dosyada saklamaya yarayabilir. Bunlar, tek başına belirli bir BIM standardı veya otomatik proje yönetimi çözümü sunmaz; kapsamı, yazılan betiğin ve kullanılan verinin sınırları belirler.

İlk denemeleri kopya bir blend dosyasında yapın. Ardından Python Tooltips ve konsol otomatik tamamlamasıyla aradığınız veri yolunu inceleyin; bir özniteliğin ne yaptığını doğrulamadan üretim betiğine eklemeyin. Daha sonra operatörü gerçek bir tekrarlı göreve uyarlayın ve farklı seçim, aktif nesne ve bağlam koşullarında test edin. Ofislerde paylaşılacak betiklerde ise Blender sürümüyle uyumluluğu ayrıca kontrol etmek gerekir; kaynaklar belirli bir uyumluluk matrisi sunmuyor.

## Kaynak ve lisans

Bu rehber, Blender Python API hızlı başlangıç belgesindeki örnekler ve açıklamalar uyarlanarak hazırlandı. Belge CC BY-SA 4.0 lisanslıdır. Blender’ın 2011 tarihli geliştirici blogu, API belgelerinin genişletilmesine ilişkin tarihsel bağlam sağlar; bu yazı güncel API kullanımının yerine geçmez.

## Pro ipucu
Bir operatörü sahne üzerinde kullanmadan önce küçük bir kopya dosyada deneyin ve `poll()` koşuluyla gerekli bağlamı kontrol edin.

## 3dsınıfı yorumu
Blender Python API, Türkiye’deki mimarlık ofisleri ve görselleştirme ekipleri için özellikle tekrar eden küçük kontrolleri ve dosya içi bilgi düzenini otomatikleştirmede işe yarayabilir. Ücretsiz olarak kullanılabilen Blender içinde çalışması, denemeye başlamak için ek bir yazılım maliyeti gerektirmemesi açısından pratik.

Bununla birlikte otomasyonun değeri, betiğin ekipteki dosya düzenine ve Blender sürümüne uyarlanmasına bağlı. Önce kopya sahnede test yapmak, API’de gelişmeye devam eden bölümleri hesaba katmak ve özel özellikleri basit tutmak önemli. Öğrenciler için de API’yi öğrenirken sahne verisinin nasıl düzenlendiğini görmenin somut bir yolu.

## Kaynaklar
- [code.blender.org](https://code.blender.org/2011/02/blenderpython-api-docs/) (yorum)
- [docs.blender.org (CC BY-SA 4.0)](https://docs.blender.org/api/current/info_quickstart.html) (özet)

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