Qısaca
- Collection obyektləri və alt kolleksiyaları bir yerdə saxlayır.
- Layer Collection bir Collection-ın View Layer daxilindəki vəziyyətini idarə edir.
- Exclude, holdout və indirect_only fərqli funksiyalara malikdir.
- View Layer API-si səhnə qatları və render pass-ləri üçün parametrlər təqdim edir.
Bu bələdçidə nə öyrənəcəksiniz?
Memarlıq layihəsi üçün Blender səhnəsində konstruksiyaları, mebelləri, ətraf mühit elementlərini və işıqları bir qrupda toplamaq səhnənin strukturunu başa düşməyi və müxtəlif təqdimat ehtiyaclarını idarə etməyi çətinləşdirə bilər. Collection-lar obyektləri və alt kolleksiyaları qruplaşdırmağa imkan verir. View Layer isə səhnədəki bu qrupların müəyyən görünüş qatında necə işlənəcəyini idarə etməyə kömək edir.
Bu bələdçidə Collection ilə Layer Collection arasındakı fərqi, görünürlük parametrlərinin əhatə dairəsini və səhnə iyerarxiyasını Python API vasitəsilə araşdırmağı öyrənəcəksiniz. Nümunələr memarlıq layihəsində istifadə oluna biləcək kolleksiya adları ilə hazırlanıb; konkret render nəticəsinə zəmanət vermir.
Tələblər
Blender quraşdırılmalı və Python API-yə giriş mümkün olmalıdır.
Mənbələr Blender-in aktual API sənədləridir. Sənədlərdə konkret Blender versiyasının nömrəsi göstərilmədiyindən burada da versiya nömrəsi qeyd olunmur.
Mənbələrdə hesab, abunəlik, onlayn xidmət, avadanlıq və ya plagin tələbləri açıqlanmır. Sənədlər CC BY-SA 4.0 lisenziyası ilə yayımlanır.
Səhnə strukturunu dəyişən kodları işlətməzdən əvvəl faylın surətini saxlayın. View Layer parametrlərindəki dəyişikliklər aktiv qatın məzmununa təsir edə bilər.
Addım-addım: Collection və View Layer-dan istifadə
1. Collection ilə Layer Collection arasındakı fərqi anlayın
Collection obyektləri və alt kolleksiyaları bir yerdə saxlayan səhnə strukturudur. Collection-ın objects xüsusiyyəti birbaşa həmin qrupdakı obyektləri, all_objects xüsusiyyəti isə həm özündəki, həm də alt kolleksiyalardakı obyektləri əhatə edir. Buna görə iyerarxiyanı yoxlayarkən yalnız üst qrupa baxmaq alt kolleksiyalardakı obyektlərin gözdən qaçmasına səbəb ola bilər.
Layer Collection müəyyən View Layer daxilindəki Collection qarşılığıdır. Obyektlərin hansı qrupda saxlanılması ilə həmin qrupun müvafiq View Layer-da necə davranacağı ayrı məsələlərdir. exclude, hide_viewport, holdout və indirect_only kimi parametrlər Layer Collection üzərində olur.
2. Yeni Collection yaradıb səhnəyə qoşun
Aşağıdakı nümunə Mobilya adlı Collection yaradır və onu səhnənin əsas kolleksiyasının uşaqları sırasına əlavə edir. Bu əməliyyat qrupu yaradır, mövcud obyektləri avtomatik olaraq onun içinə köçürmür. Layihə boyunca məqsədəuyğun və ardıcıl adlardan istifadə edin.
import bpy
collection = bpy.data.collections.new('Mobilya')
bpy.context.scene.collection.children.link(collection)Kolleksiya yaradıldıqdan sonra obyektləri uyğun qrupa yerləşdirmək və alt kolleksiyalarla iyerarxiya qurmaq ayrıca əməliyyatlardır. API sənədlərində kolleksiya yaratmaq və kolleksiya uşaqlarını qoşmaq funksiyaları ayrıca göstərilir. Beləliklə, bu kod səhnənin qalan hissəsini öz-özünə təşkil etmir.
3. Aktiv View Layer iyerarxiyasını araşdırın
Aşağıdakı nümunə aktiv View Layer-ın kök Layer Collection-ından başlayaraq alt qrupları gəzir. Hər sətirdə Collection adını, eləcə də exclude, hide_viewport və is_visible dəyərlərini göstərir. Bununla qrupların iyerarxiyadakı yerini və görünürlük vəziyyətini yoxlaya bilərsiniz.
import bpy
def print_layer(layer, depth=0):
collection = layer.collection
indent = ' ' * depth
print(
indent + collection.name,
'exclude=', layer.exclude,
'viewport=', layer.hide_viewport,
'visible=', layer.is_visible,
)
for child in layer.children:
print_layer(child, depth + 1)
print_layer(bpy.context.view_layer.layer_collection)is_visible üst kolleksiyaların vəziyyətini də nəzərə alır. Buna görə alt qrupdakı parametri təkbaşına şərh etmək kifayət etməyə bilər. Sənədlərdə visible_get() də üst iyerarxiyanı və viewport vəziyyətini nəzərə alan görünürlük sorğusu kimi təsvir olunur. Yoxlama zamanı bütün zənciri araşdırmaq daha sağlam nəticə verir.
4. Collection-ı aktiv View Layer-dan çıxarın
Qrupu yalnız aktiv View Layer-dan çıxarmaq lazım olduqda Layer Collection-ın exclude xüsusiyyətindən istifadə etmək olar. Nümunə adı verilmiş kolleksiyanı iyerarxiyada axtarır və taparsa bu xüsusiyyətin dəyərini dəyişir.
import bpy
hedef_ad = 'Mobilya'
root = bpy.context.view_layer.layer_collection
def set_excluded(layer, name, value):
if layer.collection.name == name:
layer.exclude = value
return True
for child in layer.children:
if set_excluded(child, name, value):
return True
return False
if set_excluded(root, hedef_ad, True):
print('Collection etkin View Layer\'dan hariç tutuldu.')
else:
print('Adı eşleşen Collection bulunamadı.')Nümunədəki True uyğun gələn Layer Collection-ı View Layer-dan çıxarır. Yenidən daxil etmək üçün dəyəri False olaraq təyin edin. Kolleksiya adlarının ardıcıl olması axtarışın istənilən qrupu tapmasını asanlaşdırır.
5. Görünürlük və render parametrlərini məqsədə uyğun seçin
Kolleksiyanı viewport-da müvəqqəti gizlətmək ilə renderlərdə ümumi şəkildə deaktiv etmək eyni əməliyyat deyil. Layer Collection üzərindəki hide_viewport viewport görünürlüğünə müvəqqəti təsir edir. Collection üzərindəki hide_viewport isə kolleksiyanı viewport-larda ümumi şəkildə deaktiv edir. Collection-ın hide_render xüsusiyyəti renderlərdə deaktiv etmək üçün nəzərdə tutulub, Layer Collection-dakı exclude isə müvafiq View Layer-dan çıxarmağa xidmət edir.
Digər Layer Collection seçimlərinin də məqsədi fərqlidir:
holdoutkolleksiyadakı obyektləri View Layer-da maskalamağa imkan verir.indirect_onlyobyektlərin yalnız kölgələr və əksolunmalar vasitəsilə dolayı töhfə verməsini təmin edir.excludekolleksiyanı müvafiq View Layer-dan kənarda saxlayır.hide_viewportkolleksiyanın viewport görünürlüğünə təsir edir.
View Layer-ın use xüsusiyyəti müvafiq qatın render edilməsini aktivləşdirir və ya söndürür. Qat səviyyəsində material və dünya üçün override parametrləri, eləcə də müxtəlif render pass seçimləri də mövcuddur. Bu xüsusiyyətlər eyni səhnə məlumatlarını müxtəlif vizual ehtiyaclara uyğun idarə etməyə kömək edir; lakin özlüyündə konkret görüntü nəticəsinə zəmanət vermir.
Memarlıq və vizuallaşdırma iş axınında nə dəyişir?
Memarlar və interyer dizaynerləri konstruksiya elementlərini, mebelləri və ətraf mühiti ayrı Collection-larda saxlayaraq faylın iyerarxiyasını daha anlaşıqlı edə bilərlər. Vizuallaşdırma mütəxəssisləri Layer Collection parametrləri ilə müəyyən View Layer-da hansı qrupların olacağını və hansılarının dolayı töhfə verəcəyini idarə edə bilərlər. Bu yanaşma təqdimat ehtiyaclarına uyğun səhnə məzmununu idarə etməyi asanlaşdıra bilər.
Xüsusilə böyük səhnələrdə qrupların adlandırılması və üst-alt əlaqələrinin ardıcıl qurulması vacibdir. Mənbələrdə konkret avadanlıq və ya plagin tələbi açıqlanmır. Versiya nömrəsi də göstərilmədiyindən API nümunələrini layihəyə tətbiq etməzdən əvvəl istifadə etdiyiniz Blender quraşdırmasında kiçik bir surət faylı ilə yoxlayın.
Tez-tez edilən səhvlər
Collection ilə Layer Collection-ı eyni hesab etmək: Biri obyekt qruplarını, digəri isə həmin qrupların View Layer daxilindəki vəziyyətini təmsil edir.
hide_rendervəexcludeparametrlərini eyni qəbul etmək: Birincisi Collection, ikincisi Layer Collection səviyyəsindədir.Yalnız
objectsdəyərinə baxmaq: Bu xüsusiyyət birbaşa qrupdakı obyektləri verir;all_objectsisə alt kolleksiyaları da əhatə edir.Görünürlük dəyərini iyerarxiyadan asılı olmayaraq şərh etmək: Üst qrupların vəziyyəti alt kolleksiyanın görünürlüyünə təsir edə bilər.
Kolleksiya adının uyğunluğunu yoxlamadan koddan istifadə etmək: Nümunədə uyğun ad tapılmadıqda ayrıca mesaj göstərilir.
Faylın ehtiyat nüsxəsini saxlamadan parametrləri dəyişmək: Kod nümunələri aktiv səhnənin və View Layer-ın vəziyyətinə təsir edə bilər.
Növbəti addımlar
Əvvəlcə kiçik bir sınaq faylında Collection iyerarxiyası yaradın və çıxışdakı adları yoxlamaq üçün araşdırma kodunu işlədin. Sonra öz kolleksiya adlarınızla exclude nümunəsini sınayın və dəyişikliyin aktiv View Layer-a təsirini müşahidə edin. Daha irəli getmək üçün View Layer sənədlərindəki AOV, render pass, nümunə sayı və material və ya dünya override xüsusiyyətlərini araşdıra bilərsiniz. Hər addımda faylın surətində işləmək layihənin strukturunu qorumağa kömək edir.
Mənbə və lisenziya
Bu bələdçi Blender-in Collection, LayerCollection və ViewLayer API sənədlərindəki məlumatlar əsasında Azərbaycan dilinə uyğunlaşdırılıb. Hər üç mənbə CC BY-SA 4.0 lisenziyası ilə yayımlanır. Kod nümunələri sənədləşdirilmiş API xüsusiyyətlərindən istifadə etməklə bu bələdçi üçün yazılıb.
Mənbələr
3 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.
Collection və View Layer fərqini düzgün qurmaq çoxsaylı mebel, ətraf mühit elementləri və təqdimat seçimləri olan memarlıq fayllarını daha anlaşıqlı edə bilər. İyerarxiyanı Python API ilə araşdırmaq yanaşması təkrarlanan yoxlamalar aparan vizuallaşdırma komandaları üçün də faydalı başlanğıcdır.
Türkiyədəki ofislər və tələbələr baxımından mənbələr əlavə avadanlıq tələbi göstərmir; bununla belə, kodu istehsalat faylına tətbiq etməzdən əvvəl istifadə etdiyiniz Blender quraşdırmasında sınaqdan keçirmək vacibdir. Komanda daxilində kolleksiyaların adlandırılmasını standartlaşdırmaq və təhvil verməzdən əvvəl `hide_render` ilə `exclude` arasındakı fərqi yoxlamaq praktik fayda verə bilər.
Tez-tez verilən suallar
Blender Collection ilə Layer Collection arasındakı fərq nədir?
Collection obyektləri və alt kolleksiyaları qruplaşdırır. Layer Collection isə bu qrupun konkret View Layer daxilindəki vəziyyətini idarə edir.
Blender-də Collection-ı yalnız bir View Layer-dan çıxarmaq üçün hansı parametrdən istifadə olunur?
Layer Collection üzərindəki `exclude` xüsusiyyətindən istifadə olunur. Collection-ın `hide_render` xüsusiyyəti renderlərdə ümumi deaktivləşdirmə üçün nəzərdə tutulub.
Blender API ilə kolleksiya iyerarxiyasını araşdırmaq mümkündürmü?
Bəli. View Layer-ın kök Layer Collection-ından başlayıb `children` vasitəsilə irəliləyərək kolleksiya adlarını və görünürlük dəyərlərini araşdırmaq olar.



