Blender Python API ile mesh bevel ve texture bake işlemleri

Bu rehberde ne öğreneceksiniz?

Blender Python API’sindeki mesh ve object operatörleri, geometri düzenleme ve nesne işlemlerini parametrelerle kontrol etmeyi sağlıyor. Bu rehberde bevel ile kenar yumuşatmanın nasıl yapılandırılabileceği, nesnelerin hangi referansa göre hizalanabildiği ve texture bake ayarlarının nasıl planlanacağı ele alınıyor. Amaç, tüm seçenekleri ezberlemek değil; ihtiyaç duyulan sonucu belirleyip ilgili parametreleri bilinçli seçmek.

Kaynak belgeler, operatörlerin isimlerini ve parametrelerini listeliyor; ancak her operatörün çalıştırılacağı bağlamı veya baştan sona bir proje kurulumunu açıklamıyor. Bu nedenle aşağıdaki adımlar, parametre seçimi için bir çalışma rehberi olarak değerlendirilmeli. Bir operatörü gerçek sahnede kullanmadan önce ilgili API belgesindeki güncel imza ve seçenekler kontrol edilmeli.

Gereksinimler

• Yazılım: Blender’ın Python API’si. Kaynaklar güncel API belgeleridir; sağlanan metinde belirli bir Blender sürüm numarası yer almıyor.

Özellikle bake işleminde çıktı hedefinin ve kaydetme biçiminin önceden düşünülmesi gerekir. Belge, bake sonucunun dahili ya da harici kaydetme seçenekleri olduğunu; harici çıktı için dosya yolu ile genişlik ve yükseklik değerlerinin kullanılabildiğini belirtiyor.

Adım adım: operatör seçeneklerini planlama

1. Bevel uygulanacak geometriyi ve hedefi belirleyin

bpy.ops.mesh.bevel operatörü, seçili öğelerde bevel veya pah oluşturmak için kullanılır. İlk karar, işlemin kenarlara mı yoksa köşelere mi uygulanacağıdır. affect parametresi EDGES veya VERTICES değerlerini kabul eder; belgelenen varsayılan değer EDGES’tir.

İkinci karar, genişliğin nasıl tanımlanacağıdır. offset_type seçenekleri OFFSET, WIDTH, DEPTH, PERCENT ve ABSOLUTE olarak listelenir. Bu seçim, offset değerinin nasıl yorumlanacağını belirler. Örneğin PERCENT yöntemi için ayrıca offset_pct bulunur; bu parametrenin belgelenen aralığı 0 ile 100 arasındadır. Kullanılan yöntemi belirlemeden yalnızca genişlik sayısını değiştirmek, beklenen sonucu vermeyebilir.

2. Kenar profilini ve kesit yoğunluğunu ayarlayın

segments, eğri kenar için kullanılacak segment sayısını belirler ve belgede 1 ile 1000 aralığında gösterilir. Daha fazla segment seçmek, geometriyi daha fazla parçaya böler; bu nedenle hedeflenen görünüm ile modelin gereksiz yere yoğunlaşmaması arasında denge kurun.

profile değeri kesitin biçimini kontrol eder. Belgede 0,5 değerinin yuvarlak profile karşılık geldiği ve parametrenin 0 ile 1 aralığında olduğu belirtiliyor. profile_type ise SUPERELLIPSE veya CUSTOM seçeneklerini sunuyor. Geometri birbiriyle çakışabilecek bevel alanları içeriyorsa clamp_overlap seçeneği değerlendirilebilir; bu ayar, bevel edilmiş kenar veya köşelerin birbiriyle örtüşmesine izin verilmemesi için belgelenmiştir.

3. Nesneleri bir referansa göre hizalayın

Sahnedeki nesneleri hizalamak için bpy.ops.object.align operatörünün seçeneklerini inceleyin. align_axis ile X, Y ve Z eksenleri belirtilir. relative_to, hizalama için hangi konumun referans alınacağını seçer: sahne kökeni, 3D imleç, seçim veya etkin nesne.

Karmaşık şekilli mesh’lerde döndürme ya da ölçek nedeniyle sınırlayıcı kutunun hesaplanması önem taşıyorsa bb_quality seçeneği de gözden geçirilebilir. Belgeler bu seçeneği daha yüksek kaliteli fakat yavaş bir hesaplama olarak tanımlar. Dolayısıyla çok sayıda nesnede işlem yaparken doğruluk ihtiyacı ile hesaplama süresini birlikte değerlendirin.

4. Bake çıktısını ve harita ayarlarını seçin

bpy.ops.object.bake, seçili nesnelerin görüntü dokularını bake etmek için listelenmiştir. İşlemden önce çıktı türünü ve kayıt hedefini planlayın. target, bake sonucunun nereye aktarılacağını; save_mode ise görüntü dokularının nasıl kaydedileceğini belirleyen seçeneklerdir. Harici kayıt tercih edildiğinde filepath, width ve height parametreleri kullanılabilir. Genişlik ve yükseklik, harici çıktı için piksel boyutlarını belirtir.

margin, bake sonucunun kenar payını genişletir. margin_type bu payı üretmek için kullanılacak algoritmayı seçer. Seçili nesneden etkin nesneye bake yapılacaksa use_selected_to_active parametresi belgelenmiştir. Eşleşen noktalar için max_ray_distance, kafes kullanımı içinse use_cage, cage_extrusion ve cage_object seçenekleri bulunur.

Normal haritası çıktısında normal_space ile normal uzayı; normal_r, normal_g ve normal_b ile kanallara atanacak yönler belirlenebilir. Bu ayarlar, teslim edilecek haritanın beklenen formatına göre seçilmelidir. Kaynak kesit, her render motorunun bütün bake türlerini desteklemeyebileceğini de not ediyor.

Sık yapılan hatalar

• Parametreleri birbirinden bağımsız sanmak: Bevel genişliği, seçilen offset_type yöntemine göre yorumlanır. Yöntem ile değer birlikte kontrol edilmelidir.

• Segment sayısını gereksiz artırmak: segments, eğri kenarın bölümlenmesini belirler. Görsel ihtiyacı karşılayan değeri seçin; her kenarda aynı yoğunluğun gerekli olduğunu varsaymayın.

• Bake çözünürlüğünü her kayıt türüne uygulamak: Belgede genişlik ve yükseklik, harici çıktı için tanımlanıyor. Çıktı yolunu ve kayıt yöntemini birlikte inceleyin.

• Normal haritası kanallarını gözden kaçırmak: R, G ve B yönleri ayrı parametrelerle seçilir. Teslim beklentisiyle bu eşlemenin tutarlı olması gerekir.

• API özetini eksiksiz uygulama talimatı saymak: Sunulan belgeler operatör imzalarını ve seçenekleri veriyor; her çalışma bağlamının nasıl hazırlanacağını açıklamıyor. Sahne üzerinde kullanmadan önce ilgili operatörün güncel belgesini ve kendi proje koşullarınızı kontrol edin.

Mimari ve görselleştirme iş akışında kullanım

Mimarlar, iç mimarlar ve görselleştirme ekipleri bevel parametreleriyle mobilya, doğrama veya ürün geometrilerindeki kenar geçişlerini kontrol edebilir. Nesne hizalama seçenekleri, sahne öğelerini belirli bir eksene ve ortak referansa göre düzenlemek için kullanılabilir. Texture bake ise seçili nesnelerin görüntü dokularını hedeflenen kayıt biçimine aktarmaya yönelik bir adımdır.

Bu seçenekler özellikle tekrarlanan modelleme ve sahne hazırlama işlerinde fayda sağlayabilir; ancak gerçek kazanım sahne yapısına ve kullanılan yönteme bağlıdır. Kaynaklarda donanım gereksinimi, belirli bir render motoruyla uyumluluk matrisi veya performans ölçümü bulunmuyor. Bake türlerinin bazıları mevcut render motorunda desteklenmeyebileceğinden, üretim öncesinde hedef motorla deneme yapılmalı; çıktı boyutu, kayıt konumu ve normal haritası ayarları proje teslim şartlarına göre doğrulanmalıdır.

Sonraki adımlar

Önce tek bir temsilî mesh üzerinde bevel seçeneklerini deneyin ve ihtiyaç duyulan kenar profiliyle segment yoğunluğunu belirleyin. Ardından hizalama işlemlerinde sahne kökeni, etkin nesne veya 3D imleçten hangisinin doğru referans olduğunu netleştirin. Bake aşamasına geçmeden önce çıktı hedefini, harici dosya gerekip gerekmediğini ve harita ayarlarını kontrol edin. Böylece parametrelerin etkisi üretim sahnesine taşınmadan önce daha küçük ve denetlenebilir bir örnekte görülebilir.

Kaynak ve lisans

Bu rehber, Blender Python API’nin Mesh Operators ve Object Operators belgelerindeki bilgilerden uyarlanmıştır. Her iki kaynak da CC BY-SA 4.0 lisansıyla sunulmuştur; içerik Türkçeye uyarlanmış ve yeni cümlelerle açıklanmıştır.