İçeriğe atla
Son haberler
Unreal Engine Lumen ayarları: Mimari iç mekânlarda ışık ve yansıma rehberiIntel Nova Lake-S, testte 28 çekirdek ve 5,2 GHz ile görüldüVeo 3.1 ile mimari video hazırlama: İstemden sahne kurgusunaBlender’dan Unreal Engine’e lightmap UV hazırlama: adım adım rehberCADQuader beta çıktı: STEP ve IGES dosyalarını quad mesh’e dönüştürüyorRhino 8’de mimari pafta hazırlama: Layout, Detail ve PDF çıktısı rehberiImages 2.6 ile mimari görsel üretimi: istemden kontrollü revizyonaThéâtre Royal de Rabat tamamlandı: Bouregreg kıyısından esinlenen tasarımBlender’dan Unreal Engine’e USD sahnesi aktarma: adım adım rehberInkling 2 Mini yayımlandı: Döngülü mimarisiyle yerel kullanıma odaklanıyor
EğitimlerBlenderOMAMari

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

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.

Mimari iç mekân modeli üzerinde çalışan bir tasarım stüdyosu masasıAI görsel
Temsilî görsel; yapay zekâ ile üretildi.Görsel: 3dsınıfı / FCA AI
KaydetPaylaş0

Kısaca

  1. Python Console, kısa komutları denemek ve API’yi otomatik tamamlama yardımıyla keşfetmek için kullanılabiliyor.
  2. bpy.data, açık Blender dosyasındaki nesne, sahne ve materyal verilerine erişim sağlıyor.
  3. Özel özellikler nesnelere eklenebiliyor ve blend dosyasıyla birlikte saklanıyor.
  4. 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.

    Sık sorulan sorular

    Blender Python API kodları nerede çalıştırılır?

    Kısa komutlar Python Console’da denenebilir. Betikler Blender’ın Scripting çalışma alanındaki Text Editor üzerinden çalıştırılabilir.

    Blender’da nesneye özel bilgi nasıl eklenir?

    API, özel özellikleri nesnelere eklemeyi destekliyor. Bu özellikler blend dosyasıyla saklanabiliyor ve nesne kopyalandığında onunla taşınabiliyor.

    Blender Python API belirli bir sürüm gerektiriyor mu?

    Kullanılan kaynak belge belirli bir sürüm numarası belirtmiyor. API genel olarak kararlı olarak tanımlanırken bazı bölümlerin geliştirilmeye devam ettiği not ediliyor.

    Kaynaklar

    2 kaynak
    C
    code.blender.orgcode.blender.org/2011/02/blenderpython-api-docs
    Yorum
    D(
    docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/info_quickstart.html
    Özet

    Kaynak metinler yeniden yayımlanmaz; kısa alıntılar tırnak içinde verilir, geri kalanı özgün özet ve yorumdur.

    3dsınıfı yorumu
    3dEditörün değerlendirmesi

    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.

    Bu habere tepkin ne?

    Yorumlar 0

    İlk yorumu sen yazKendi test sonuçlarını ya da sorunu paylaş.
    +

    İlgili haberler