# Blender’da Python betiklerini güvenle yönetme: ayarlar ve API

Kaynak: https://3dsinifi.com/haber/blenderda-python-betiklerini-guvenle-yonetme-ayarlar-ve-api · Kategori: Eğitimler · Yayın: 26 Ekim 2026

> Blender dosyalarındaki Python betikleri rigleme ve otomasyon için kullanılabilir, ancak güvenlik riski de taşır. Bu rehber otomatik çalıştırma ayarlarını ve koleksiyon API’sinin temelini anlatıyor.

## Kısaca
- Blender’da .blend dosyalarının betiklerini otomatik çalıştırma varsayılan olarak kapalıdır.
- Dosya Tarayıcısı’ndaki Trusted Source seçeneği, otomatik çalıştırma iznini dosya bazında yönetir.
- Komut satırında -y veya --enable-autoexec çalıştırmayı etkinleştirirken -Y veya --disable-autoexec devre dışı bırakır.
- Collection.objects.link() nesneyi koleksiyona ekler; unlink() koleksiyondan çıkarır.

## Bu rehberde ne öğreneceksiniz?

Blender dosyalarının içine Python betikleri eklemek rigleme ve otomasyon gibi ileri düzey işler için kullanışlı olabilir. Rigleme, bir karakterin ya da nesnenin hareket ve kontrol düzeneklerini kurmayı ifade eder. Ancak Python betikleri, dosyanın içinde ne yapabileceği bakımından sınırlı değildir; bu nedenle kaynağı bilinmeyen bir betiği çalıştırmak güvenlik riski oluşturabilir.

Bu eğitimde bir .blend dosyası açılırken çıkan betik uyarısını nasıl değerlendireceğinizi, dosya ve genel ayar düzeyinde otomatik çalıştırmayı nasıl yöneteceğinizi, komut satırı seçeneklerinin ne işe yaradığını öğreneceksiniz. Son bölümde Blender Python API’sindeki koleksiyon ve nesne ilişkisini ele alacağız. Bu adımlar betiğin güvenli olduğunu kanıtlamaz; dosyanın kaynağını ve çalıştırma iznini dikkatle değerlendirmek gerekir.

## Gereksinimler ve hazırlık

Rehber, Blender’ın betik güvenliği belgesi ve Blender Python API belgelerine dayanıyor. API belgelerinin bir sayfası Blender 5.2 Python API Documentation başlığını taşıyor. Kaynaklarda donanım gereksinimi veya kullanıcı hesabı şartı belirtilmiyor. Başka bir Blender sürümüyle çalışılıyorsa, API kullanımını ilgili sürümün belgeleriyle karşılaştırın.

İşleme başlamadan önce dosyanın nereden geldiğini ve içindeki betikleri çalıştırmanın gerekli olup olmadığını değerlendirin. Blender’ın güvenlik belgeleri, yalnızca kaynağı bilinen ve güvenilen betiklerin çalıştırılmasını öneriyor. Otomatik çalıştırmayı kapalı tutmak, dosyanın kod içermediği ya da hiçbir kodun kullanıcı etkileşimiyle çalıştırılamayacağı anlamına gelmez.

## Adım adım: betik çalıştırma izinlerini yönetme

1. **Dosya açılırken gösterilen uyarıyı inceleyin.** Blender, çalıştırılmasına izin verilmeyen bir betik içeren dosya açıldığında bir iletişim penceresi gösterebilir. Uyarıda betiklerin çalışmasına izin veren Allow Execution ve bunları yok sayan Ignore seçenekleri bulunur. Dosyanın kaynağı güvenilir değilse çalıştırma izni vermeyin.

2. **Dosya bazında Trusted Source seçeneğini kullanın.** Blender Dosya Tarayıcısı’ndaki Trusted Source seçeneği, otomatik çalıştırma kararını dosya özelinde vermeye yarar. Bu, her dosya için ayrı değerlendirme yapmayı sağlar. Dosya Tarayıcısı kullanılmadan açılan dosyalar içinse genel varsayılan tercihi gözden geçirmek önemlidir.

3. **Genel otomatik çalıştırma ayarını kontrol edin.** Preferences içindeki Auto Run Python Scripts seçeneği etkinleştirildiğinde, Dosya Tarayıcısı’ndaki Trusted Source tercihi varsayılan olarak açılır. Bu ayar, dosyalar Dosya Tarayıcısı kullanılmadan yüklendiğinde de betiklerin çalışmasına izin verebilir. Belirli dizinleri bu kapsamın dışında bırakma olanağı vardır. Belgelerde örneklenen bir düzen, indirme dizini dışındaki yolları güvenilir saymaktır; bunu her çalışma ortamına uygun genel bir kural olarak değerlendirmeyin.

4. **Betiklerin hangi yollarla çalışabileceğini hesaba katın.** Blender belgelerinde otomatik çalıştırma yolları arasında Register seçeneği etkin Text veri blokları ve Python ifadeleriyle değerleri yöneten animasyon sürücüleri sayılıyor. Bunun yanında, otomatik çalıştırma kapalı olsa bile kullanıcının etkileşimini gerektiren yollar bulunur: Text Editor’da bir betiği elle çalıştırmak ve çizgi stillerini betiklerle kontrol eden Freestyle ile render almak. Dolayısıyla yalnızca otomatik çalıştırma ayarına bakarak dosyadaki bütün kod davranışlarını anlamak mümkün değildir.

5. **Koleksiyon API’sindeki nesne ilişkisini ayırt edin.** Blender Python API’sinde Collection.objects, doğrudan ilgili koleksiyonda bulunan nesneleri gösterir. Bu arayüzdeki link işlemi nesneyi koleksiyona ekler; unlink ise nesneyi koleksiyondan çıkarır. Collection.all_objects, ilgili koleksiyonun yanı sıra alt koleksiyonlarındaki nesneleri de kapsar ve salt okunur olarak tanımlanır. Betiklerin neyi değiştirdiğini incelerken bu iki kapsamı birbirine karıştırmayın.

6. **Arka plan çalıştırmada seçeneği bilinçli belirleyin.** Komut satırı seçenekleri Blender Preferences ayarlarını geçersiz kılabilir. Resmî belgelerde, arka plan modunda animasyon render ederken sürücülerin ve diğer betiklerin çalışmasına izin veren örnek şu şekilde veriliyor:

```bash
blender --background --enable-autoexec my_movie.blend --render-anim
```

`--enable-autoexec` seçeneği yerine `-y` kullanılabilir. Otomatik çalıştırmayı kapatmak için `--disable-autoexec` veya `-Y` seçeneği vardır. Bu seçenekler, çalıştırılacak dosyanın güvenilirliğini değerlendirme gereğini ortadan kaldırmaz. Özellikle otomatik işlem akışlarında hangi dosyanın hangi izinle açıldığını kontrol edin.

## Sık yapılan hatalar

İlk hata, otomatik çalıştırmanın kapalı olmasını dosyada hiçbir kodun çalışamayacağı şeklinde yorumlamaktır. Blender belgeleri, Text Editor’da betiği elle çalıştırma ve Freestyle ile render alma gibi kullanıcı etkileşimi gerektiren yolları da açıklıyor. İkinci hata, her dizini güvenilir kabul edip Auto Run Python Scripts ayarını düşünmeden etkinleştirmektir. Güven kararını dosyanın kaynağına göre verin.

Komut satırında etkinleştirme ve devre dışı bırakma seçeneklerini de karıştırmayın: `-y` ile `--enable-autoexec` otomatik çalıştırmaya izin verir; `-Y` ile `--disable-autoexec` bunu kapatır. Bir dosyaya çalıştırma izni verilmesi, içindeki kodun güvenilir olduğunu göstermez.

Koleksiyonlarla çalışırken de doğrudan bağlı nesneleri, alt koleksiyonlardaki nesneleri kapsayan listeden ayırın. Collection.objects ile Collection.all_objects aynı kapsamı ifade etmez. Bir betiğin etkisini incelerken API belgelerindeki bu farkı kontrol etmek, hangi nesnelerin işleme dâhil olacağını anlamaya yardımcı olur.

## Mimarlık, iç mekân ve görselleştirme iş akışına etkisi

Blender’ın belgeleri betik güvenliği konusunu belirli bir mimarlık veya iç mekân kullanımına bağlamıyor. Yine de bu başlık, Blender dosyalarının ekipler arasında paylaşıldığı görselleştirme iş akışlarında dikkate alınabilir: dosyanın kaynağını kontrol etmek, otomatik çalıştırma iznini bilinçli vermek ve sahneyi düzenleyen betiklerin kapsamını anlamak, dosyalarla çalışırken izlenebilecek temkinli bir yaklaşımdır.

Koleksiyon API’si, nesneleri gruplara göre düzenleyen otomasyon kodlarını incelerken temel bir ayrım sunar. Fakat kaynaklar belirli bir proje şablonunu, eklenti uyumluluğunu, donanım performansını veya lisans koşullarını açıklamıyor. Bu nedenle betikleri bir iş akışına dâhil etmeden önce kullanılan Blender sürümünün API belgelerini kontrol edin ve kodu yalnızca güvenilir kaynaklardan çalıştırın.

## Sonraki adımlar

Önce Auto Run Python Scripts varsayılanını ve dosya bazındaki Trusted Source kararını mevcut çalışma düzeninize göre gözden geçirin. Sonra üzerinde çalıştığınız dosyada otomatik çalıştırma uyarısı olup olmadığını ve betiklerin hangi yolla devreye girebileceğini değerlendirin. Yalnızca uyarıyı aşmayı değil, dosyanın kaynağını anlamayı da sürecin parçası hâline getirin.

Koleksiyonları kullanan bir betiği incelerken doğrudan bağlı nesnelerle alt koleksiyonlardakileri ayırın; gerekli işlemi API referansından doğrulayın. Blender’ın Python API belgelerinde Quickstart, API Overview ve Best Practice bölümleri bulunuyor. Belgeler çevrimdışı kullanılmak üzere indirilebiliyor. Komut satırında otomatik çalıştırma seçeneğini ise dosyanın güvenilirliğini değerlendirdikten sonra belirleyin.

## Kaynak ve lisans

Bu eğitim, Blender’ın resmî Scripting & Security belgesi, CollectionObjects ve Collection API referansları ile Blender Python API dokümantasyonundan Türkçeye çevrilip uyarlanmıştır. Kaynakların lisansı CC BY-SA 4.0’tır.

## Pro ipucu
Bilinmeyen kaynaklardan gelen .blend dosyalarında otomatik çalıştırmaya izin vermeyin; arka plan renderında da --enable-autoexec seçeneğini yalnızca güvenilir dosyalar için kullanın.

## 3dsınıfı yorumu
Türkiye’de mimarlık ofisleri ve görselleştirme ekipleri için bu eğitimin en pratik katkısı, dosya güvenliğini otomasyon kararının yanına koyması. Ekip içinde paylaşılan Blender dosyalarında kaynağı kontrol etmek ve otomatik çalıştırma iznini dosya bazında değerlendirmek, iş akışında uygulanabilir bir temkin adımıdır.

Kaynaklar fiyat, donanım gereksinimi veya performans artışı belirtmiyor; bu yüzden eğitimden maliyet ya da hız kazancı çıkarmak mümkün değil. Öğrenciler ve betik kullanan ekipler koleksiyon API’sini temel düzeyde anlamak için rehberden yararlanabilir; betiği projede kullanmadan önce güvenilirliğini ve sürüm uyumluluğunu ayrıca kontrol etmelidir.

## Kaynaklar
- [docs.blender.org (CC BY-SA 4.0)](https://docs.blender.org/manual/en/latest/advanced/scripting/security.html) (özet)
- [docs.blender.org (CC BY-SA 4.0)](https://docs.blender.org/api/current/bpy.types.CollectionObjects.html) (özet)
- [docs.blender.org (CC BY-SA 4.0)](https://docs.blender.org/api/current/bpy.types.Collection.html) (özet)

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