Qısaca
- Python Console qısa əmrləri sınamaq və API-ni avtomatik tamamlama köməyi ilə araşdırmaq üçün istifadə oluna bilər.
- bpy.data açıq Blender faylındakı obyekt, səhnə və material məlumatlarına giriş verir.
- Xüsusi xüsusiyyətləri obyektlərə əlavə etmək və onları blend faylı ilə birlikdə saxlamaq mümkündür.
- Operator Blender-də qeydiyyata alınıb axtarış menyusundan işə salına bilər.
Bu bələdçidə nə öyrənəcəksiniz?
Blender Python API-si interfeysdə dəyişdirilə bilən bir çox məlumata Python vasitəsilə daxil olmağa və onları redaktə etməyə imkan verir. Memarlıq modelləşdirməsi və vizuallaşdırmasında bunun qarşılığı səhnə elementlərini araşdırmaq, obyektlərə layihə məlumatı əlavə etmək və ya tez-tez təkrarlanan işləri alətə çevirmək ola bilər. Bu bələdçidə əvvəlcə səhnə məlumatlarını oxuyacaq, sonra aktiv obyektə xüsusi xüsusiyyət əlavə edəcək və sonda sadə operator hazırlayacaqsınız.
Buradakı nümunələr Blender Python API-sinə giriş üçün hazırlanmış rəsmi sürətli başlanğıc sənədindəki üsullara əsaslanır. API ümumilikdə stabil kimi təqdim olunsa da, sənədin bəzi bölmələrinin hazırlanmaqda davam etdiyi qeyd olunur. Buna görə hansısa xüsusiyyəti istehsal fayllarında istifadə etməzdən əvvəl kiçik sınaq səhnəsində yoxlamaq yaxşı vərdişdir.
Tələblər
Blender quraşdırılmış olmalıdır. Mənbə sənəd konkret Blender versiya nömrəsi göstərmədiyi üçün burada versiya uyğunluğu barədə dəqiq nömrə qeyd etmirik.
Python-u ayrıca quraşdırmaq lazım deyil; nümunələr Blender daxilindəki Python Console və ya Text Editor vasitəsilə işlədilir.
Hesab və ya ödənişli lisenziya tələbləri mənbələrdə göstərilmir.
API-ni araşdırmaq üçün Blender parametrlərində Developer Extras və Python Tooltips seçimlərini aktivləşdirmək faydalıdır. Düymə ipucları müvafiq Python atributlarını və operator adlarını tapmağa kömək edə bilər.
Qısa əmrlər və sınaqlar üçün Python Console-dan istifadə etmək olar. Bir neçə sətirdən ibarət skriptləri redaktə edib saxlamaq üçün Blender-in Scripting iş sahəsi və Text Editor daha əlverişlidir. Bu iş sahəsinə yuxarı paneldəki vərəqlərdən keçmək mümkündür.
Addım-addım: səhnə məlumatlarına giriş və ilk alət
1. Səhnədəki obyektləri Python ilə siyahıya alın
Scripting iş sahəsini açın və Python Console-a keçin. Konsol avtomatik tamamlama təklif etdiyi üçün bpy daxilindəki məlumat və xüsusiyyət adlarını araşdırmaq üçün də əlverişlidir. Açıq səhnədəki obyektləri ardıcıllıqla çap etmək üçün bu kodu işə salın:
import bpy
for ob in bpy.context.scene.objects:
print(ob)Bu nümunə cari səhnənin obyektlər kolleksiyasını dövr edir və hər obyekti konsol çıxışına göndərir. Memarlıq faylında bu üsul səhnədə hansı obyektlərin olduğunu tez yoxlamaq üçün əsas başlanğıc nöqtəsidir. Daha sonra dövrün içinə mənbədə sənədləşdirilmiş giriş üsullarından istifadə edərək ad, məlumat və ya digər atributları araşdıran əməliyyatlar əlavə etmək olar.
2. Məlumatları bpy.data vasitəsilə tapın
Blender faylındakı məlumat bloklarına bpy.data vasitəsilə daxil olunur. Sənəddə obyektlər, səhnələr və materiallar kimi kolleksiyalar nümunə göstərilir. Kolleksiya elementinə adı ilə müraciət etmək mümkündür:
bpy.data.objects["Cube"]Eyni kolleksiyaya rəqəmsal indekslə də daxil olmaq olar; ancaq sənəd iş zamanı elementin indeksinin dəyişə biləcəyi barədə xəbərdarlıq edir. Buna görə konkret səhnə elementini axtararkən adına görə müraciət etmək, indeks dəyərini sabit qəbul etməkdən daha aydın seçimdir. Fayldakı adın fərqli ola biləcəyini də nəzərə alın; nümunədəki Cube adı yalnız sənəddə istifadə olunan obyekt adıdır.
3. Aktiv obyektə xüsusi məlumat əlavə edin
Obyektə, səhnəyə və ya kolleksiyaya xüsusi xüsusiyyət əlavə etmək üçün Python API-nin xüsusi xüsusiyyətlərindən yararlanmaq olar. Aşağıdakı nümunə aktiv obyekt varsa, ona mətn dəyəri yazır:
import bpy
obj = bpy.context.object
if obj is not None:
obj["project_note"] = "interior study"Buradakı bpy.context.object kontekstdən asılı olaraq aktiv obyekti qaytarır. Aktiv obyekt olmadıqda əməliyyatın icra edilməməsi üçün şərtdən istifadə olunur. Mənbə sənədə əsasən, bu cür xüsusi xüsusiyyətlər blend faylı ilə saxlanılır və obyektlər kopyalandıqda onlarla birlikdə köçürülür. Beləliklə, obyektə layihə qeydi və ya komanda daxilində müəyyənləşdirilmiş sadə məlumat əlavə etmək üçün istifadə oluna bilər. Xüsusiyyət adlarını ardıcıl seçmək bir neçə skript və faylla işləyərkən məlumatı tapmağı asanlaşdırır.
Xüsusi xüsusiyyətlərə yalnız əsas Python növləri təyin edilə bilər: tam ədəd, onluq ədəd, mətn, ədəd ardıcıllıqları və müəyyən qaydalara uyğun lüğətlər. İç-içə lüğətlər üçün sənəddə 1024 səviyyəlik yuxarı hədd göstərilir; bu dərinliyin aşılması xəta və məlumat itkisinə səbəb ola bilər. Bu nümunədə sadə mətn dəyərindən istifadə olunduğu üçün belə iç-içə struktur yoxdur.
4. Təkrarlanan işi operatora çevirin
Kod parçasını Blender daxilindən təkrar işə salmaq üçün operator təyin etmək olar. Aşağıdakı nümunə səhnədəki obyektləri çap edən və aktiv obyekt olmadıqda işə salınmasına icazə verməyən sadə operator yaradır:
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 iş sahəsində Text Editor-ı seçin, New düyməsi ilə yeni mətn məlumat bloku açın, kodu yapışdırın və Run Script düyməsinə basın. Mənbə sənəddəki nümunədə operator qeydiyyata alındıqdan sonra Operator Search vasitəsilə Simple axtarışı aparmaq mümkündür. poll() yoxlaması aktiv obyekt olmadıqda operatorun işə düşməsinin qarşısını alır. Bu məqam skriptin istifadəçi kontekstindən asılı olduğu hallarda əhəmiyyətlidir.
5. Konsol və interfeys kontekstini nəzərə alın
bpy.context-in məzmunu kodun işə salındığı sahədən asılı olaraq dəyişə bilər. Python Console və 3D Viewport eyni kontekst üzvlərinə malik olmaya bilər. Həmçinin context dəyərlərini birbaşa dəyişmək mümkün deyil; mənbədə aktiv obyekti birbaşa təyin etməyin xəta verdiyi, bunun əvəzinə bpy.context.view_layer.objects.active yolundan istifadə oluna bildiyi izah olunur. Operator gözlənilmədən işləmirsə, əvvəlcə onun hansı sahədə və hansı rejimdə işə salındığını yoxlayın.
Tez-tez edilən səhvlər
İndeksi daimi identifikator kimi istifadə etmək: Kolleksiya indeksləri iş zamanı dəyişə bilər. Konkret elementi seçərkən adına görə müraciət etmək daha aydındır; faylda həmin adın həqiqətən mövcud olduğunu yoxlayın.
Hər operatorun hər yerdə işləyəcəyini düşünmək: Bəzi operatorlar düzgün sahə, rejim və ya seçim tələb edir.
poll()şərti bu uyğunluğu yoxlayır; uyğun olmayan kontekstdə çağırış xəta yarada bilər.Context-i birbaşa dəyişməyə çalışmaq:
bpy.contextyalnız oxumaq üçün nəzərdə tutulub. Dəyişiklik tələb olunarsa, sənədləşdirilmiş məlumat API-sindən və ya uyğun API funksiyasından istifadə edin.Xüsusi xüsusiyyətlərə mürəkkəb məlumatlar yükləmək: Dəstəklənən növlər məhduddur; lüğət dəyərləri də əsas növlərdən ibarət olmalıdır. Sadə və aydın xüsusiyyətlərə üstünlük verin.
Skript çıxışını yanlış yerdə axtarmaq: Nümunədəki
printçıxışı terminala göndərilir. İşə salmanın nəticəsini görmürsünüzsə, Blender terminalını yoxlayın.
Növbəti addımlar: memarlıq və vizuallaşdırma iş axınları
Bu əsas üsullar səhnə quruluşunu yoxlamaq və ya obyektlərə əlavə məlumat bağlamaq istəyən memarlar, interyer dizaynerləri və vizuallaşdırma mütəxəssisləri üçün başlanğıc nöqtəsi ola bilər. Məsələn, fayldakı obyektləri siyahıya almaq böyük səhnələrdə məzmun yoxlamasını asanlaşdıra bilər; xüsusi xüsusiyyətlər isə komanda daxilində müəyyən edilmiş sadə etiketləri faylda saxlamağa yaraya bilər. Bunlar özlüyündə konkret BIM standartı və ya avtomatik layihə idarəetmə həlli təqdim etmir; əhatə dairəsini yazılmış skript və istifadə olunan məlumatlar müəyyən edir.
İlk sınaqları blend faylının surətində edin. Sonra Python Tooltips və konsolun avtomatik tamamlama funksiyası ilə axtardığınız məlumat yolunu araşdırın; atributun nə etdiyini təsdiqləmədən onu istehsal skriptinə əlavə etməyin. Daha sonra operatoru real, təkrarlanan işə uyğunlaşdırın və müxtəlif seçim, aktiv obyekt və kontekst şərtlərində sınaqdan keçirin. Ofislərdə paylaşılacaq skriptlərdə Blender versiyası ilə uyğunluğu ayrıca yoxlamaq lazımdır; mənbələr konkret uyğunluq matrisi təqdim etmir.
Mənbə və lisenziya
Bu bələdçi Blender Python API sürətli başlanğıc sənədindəki nümunələr və izahlar uyğunlaşdırılaraq hazırlanıb. Sənəd CC BY-SA 4.0 lisenziyalıdır. Blender-in 2011-ci il tarixli tərtibatçı bloqu API sənədlərinin genişləndirilməsinə dair tarixi kontekst təqdim edir; bu yazı cari API istifadəsini əvəz etmir.
Mənbələr
2 mənbəMənbə mətnləri yenidən dərc edilmir; qısa sitatlar işarələnir, qalanı bizim xülasə və şərhimizdir.
Blender Python API Türkiyədəki memarlıq ofisləri və vizuallaşdırma komandaları üçün xüsusilə təkrarlanan kiçik yoxlamaları və fayldaxili məlumat nizamını avtomatlaşdırmaq baxımından faydalı ola bilər. Pulsuz istifadə olunan Blender daxilində işləməsi, sınağa başlamaq üçün əlavə proqram xərci tələb etməməsi baxımından praktikdir.
Bununla belə, avtomatlaşdırmanın dəyəri skriptin komandanın fayl quruluşuna və Blender versiyasına uyğunlaşdırılmasından asılıdır. Əvvəlcə surət səhnədə sınaq aparmaq, API-də hazırlanmaqda davam edən bölmələri nəzərə almaq və xüsusi xüsusiyyətləri sadə saxlamaq vacibdir. Tələbələr üçün də API-ni öyrənərkən səhnə məlumatlarının necə təşkil olunduğunu görməyin konkret yoludur.
Tez-tez verilən suallar
Blender Python API kodları harada işə salınır?
Qısa əmrləri Python Console-da sınamaq olar. Skriptlər Blender-in Scripting iş sahəsindəki Text Editor vasitəsilə işə salına bilər.
Blender-də obyektə xüsusi məlumatı necə əlavə etmək olar?
API xüsusi xüsusiyyətləri obyektlərə əlavə etməyi dəstəkləyir. Bu xüsusiyyətlər blend faylı ilə saxlanıla və obyekt kopyalandıqda onunla birlikdə köçürülə bilər.
Blender Python API konkret versiya tələb edirmi?
İstifadə olunan mənbə sənəddə konkret versiya nömrəsi göstərilmir. API ümumilikdə stabil kimi təqdim olunur, eyni zamanda bəzi bölmələrin hazırlanmaqda davam etdiyi qeyd edilir.



