باختصار
- تجمع Collection العناصر والمجموعات الفرعية معًا.
- تدير Layer Collection حالة Collection داخل View Layer.
- لكل من Exclude وholdout وindirect_only وظيفة مختلفة.
- توفّر View Layer API إعدادات لطبقات المشهد ومرّرات التصيير.
ما الذي ستتعلمه في هذا الدليل؟
قد يجعل جمع البنية والأثاث والعناصر المحيطة والإضاءة في مجموعة واحدة ضمن مشهد معماري في Blender قراءة تنظيم المشهد وإدارة احتياجات العرض المختلفة أكثر صعوبة. تتيح Collection تجميع العناصر والمجموعات الفرعية. أما View Layer فتساعد على التحكم في كيفية التعامل مع هذه المجموعات ضمن طبقة عرض محددة في المشهد.
في هذا الدليل، ستتعرف إلى الفرق بين Collection وLayer Collection، ونطاق إعدادات الرؤية، وكيفية فحص التسلسل الهرمي للمشهد عبر Python API. أُعدّت الأمثلة باستخدام أسماء مجموعات مناسبة لملف معماري، ولا تضمن نتيجة تصيير محددة.
المتطلبات
يجب تثبيت Blender وإمكانية الوصول إلى Python API.
المصادر هي وثائق API الحالية في Blender. ولأن الوثائق لا تحدد رقم إصدار بعينه، فلن نذكر رقم إصدار هنا أيضًا.
لا توضّح المصادر متطلبات الحساب أو الاشتراك أو الخدمات عبر الإنترنت أو الأجهزة أو الإضافات. الوثائق مرخّصة بموجب CC BY-SA 4.0.
احفظ نسخة من الملف قبل تشغيل أي تعليمات برمجية تغيّر بنية المشهد. فقد تؤثر التغييرات في خصائص View Layer على محتوى الطبقة النشطة.
خطوة بخطوة: استخدام Collection وView Layer
1. افهم الفرق بين Collection وLayer Collection
Collection هي بنية مشهد تجمع العناصر والمجموعات الفرعية. تشمل خاصية objects في Collection العناصر الموجودة مباشرةً في تلك المجموعة، بينما تشمل خاصية all_objects عناصرها وعناصر المجموعات الفرعية التابعة لها. لذلك، قد يؤدي الاكتفاء بفحص المجموعة العليا عند مراجعة التسلسل الهرمي إلى إغفال عناصر المجموعات الفرعية.
Layer Collection هي المقابل لـ Collection محددة داخل View Layer معينة. فالمجموعة التي تُحفظ فيها العناصر مسألة، وكيفية تصرف هذه المجموعة في View Layer المعنية مسألة أخرى. وتوجد إعدادات مثل exclude وhide_viewport وholdout وindirect_only ضمن Layer Collection.
2. أنشئ Collection جديدة واربطها بالمشهد
ينشئ المثال التالي Collection باسم Mobilya ويضيفها إلى المجموعات الفرعية في Collection الرئيسية للمشهد. تنشئ هذه العملية المجموعة، لكنها لا تنقل العناصر الموجودة إليها تلقائيًا. استخدم أسماء متسقة وملائمة للغرض في المشروع.
import bpy
collection = bpy.data.collections.new('Mobilya')
bpy.context.scene.collection.children.link(collection)بعد إنشاء المجموعة، يظل نقل العناصر إلى المجموعة المناسبة وإنشاء تسلسل هرمي باستخدام المجموعات الفرعية عمليتين منفصلتين. وتعرض وثائق API وظائف إنشاء المجموعات وربط المجموعات الفرعية كلًّا على حدة. لذلك، لا ينظّم هذا الكود بقية المشهد تلقائيًا.
3. افحص التسلسل الهرمي لـ View Layer النشطة
يبدأ المثال التالي من Layer Collection الجذر في View Layer النشطة، ثم يمر على المجموعات الفرعية. ويعرض في كل سطر اسم Collection وقيم exclude وhide_viewport وis_visible. يتيح لك ذلك فحص مواضع المجموعات في التسلسل الهرمي وحالة ظهورها.
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 حالة المجموعات العليا في الحسبان أيضًا. لذلك، قد لا يكفي تفسير إعداد المجموعة الفرعية بمعزل عن غيره. وتعرّف الوثائق أيضًا visible_get() على أنها استعلام عن الرؤية يراعي التسلسل الهرمي الأعلى وحالة نافذة العرض. ومن الأفضل فحص السلسلة بأكملها أثناء التحقق.
4. استبعد Collection من View Layer النشطة
عند الحاجة إلى استبعاد مجموعة من View Layer النشطة وحدها، يمكن استخدام خاصية exclude في Layer Collection. يبحث المثال عن المجموعة المحددة بالاسم ضمن التسلسل الهرمي، ويغيّر قيمة الخاصية إذا عثر عليها.
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ı.')تستبعد القيمة True في المثال Layer Collection المطابقة من View Layer. ولإعادة تضمينها، استخدم القيمة False. ويسهّل توحيد أسماء المجموعات العثور على المجموعة المطلوبة.
5. اختر إعدادات الرؤية والتصيير وفقًا للغرض
إخفاء مجموعة مؤقتًا في نافذة العرض ليس العملية نفسها التي تعطلها عمومًا في عمليات التصيير. تؤثر hide_viewport في Layer Collection مؤقتًا على الرؤية في نافذة العرض. أما hide_viewport في Collection فتعطّل المجموعة عمومًا في نوافذ العرض. وتُعرّف خاصية hide_render في Collection لتعطيلها في عمليات التصيير، بينما تستبعد exclude في Layer Collection المجموعة من View Layer المعنية.
تختلف أغراض خيارات Layer Collection الأخرى أيضًا:
تُستخدم
holdoutلإخفاء عناصر المجموعة كقناع في View Layer.تتيح
indirect_onlyللعناصر تقديم مساهمة غير مباشرة فقط عبر الظلال والانعكاسات.تُبقي
excludeالمجموعة خارج View Layer المعنية.تؤثر
hide_viewportفي ظهور المجموعة في نافذة العرض.
تتيح خاصية use في View Layer تشغيل تصيير الطبقة المعنية أو إيقافه. كما تتوفر تجاوزات المواد والعالم وخيارات مختلفة لمرّات التصيير على مستوى الطبقة. وتساعد هذه الخصائص على إدارة بيانات المشهد نفسها بما يلائم احتياجات بصرية مختلفة، لكنها لا تضمن وحدها نتيجة صورة محددة.
ما الذي يتغير في سير عمل العمارة والتصور؟
يمكن للمعماريين ومصممي الديكور الداخلي جعل التسلسل الهرمي للملف أوضح عبر حفظ عناصر البناء والأثاث وتنسيق الموقع في Collections منفصلة. ويمكن لفناني التصور التحكم، باستخدام إعدادات Layer Collection، في المجموعات التي تظهر في View Layer محددة والمجموعات التي تسهم بصورة غير مباشرة. وقد يسهّل هذا الأسلوب إدارة محتوى المشهد بما يتناسب مع احتياجات العرض.
تكتسب تسمية المجموعات وإنشاء علاقات متسقة بين المجموعات العليا والفرعية أهمية خاصة في المشاهد الكبيرة. لا توضّح المصادر أي متطلبات محددة للأجهزة أو الإضافات. وبما أنها لا تذكر رقم إصدار، فتحقّق من أمثلة API على نسخة صغيرة من الملف ضمن تثبيت Blender المستخدم، قبل نقلها إلى المشروع.
أخطاء شائعة
اعتبار Collection وLayer Collection شيئًا واحدًا: تمثل الأولى مجموعات العناصر، بينما تمثل الثانية حالة تلك المجموعات داخل View Layer.
اعتبار
hide_renderوexcludeإعدادين متكافئين: الأول على مستوى Collection، والثاني على مستوى Layer Collection.الاكتفاء بالنظر إلى قيمة
objects: تعرض هذه الخاصية العناصر الموجودة مباشرةً في المجموعة، بينما تشملall_objectsالمجموعات الفرعية أيضًا.تفسير قيمة الرؤية بمعزل عن التسلسل الهرمي: قد تؤثر حالة المجموعات العليا في ظهور المجموعة الفرعية.
استخدام الكود دون التحقق من تطابق اسم المجموعة: يعرض المثال رسالة منفصلة إذا لم يعثر على الاسم.
تغيير الإعدادات من دون حفظ نسخة احتياطية من الملف: قد تؤثر أمثلة الكود في حالة المشهد النشط وView Layer.
الخطوات التالية
أنشئ أولًا تسلسلًا هرميًا لـ Collection في ملف تجريبي صغير، وشغّل كود الفحص للتحقق من الأسماء في المخرجات. بعد ذلك، جرّب مثال exclude باستخدام أسماء مجموعاتك، ولاحظ تأثير التغيير في View Layer النشطة. وللتعمق أكثر، يمكنك مراجعة خصائص AOV ومرّات التصيير وعدد العينات وتجاوزات المواد أو العالم في وثائق View Layer. يساعد العمل على نسخة من الملف في كل خطوة على الحفاظ على تنظيم المشروع.
المصدر والترخيص
أُعدّ هذا الدليل باللغة التركية بالاستناد إلى المعلومات الواردة في وثائق API الخاصة بـ Blender Collection وLayerCollection وViewLayer. المصادر الثلاثة مرخّصة بموجب CC BY-SA 4.0. كُتبت أمثلة الكود لهذا الدليل باستخدام خصائص API الموثّقة.
المصادر
3 مصادرلا نعيد نشر نصوص المصادر؛ الاقتباسات القصيرة مشار إليها، وما تبقى ملخص وتعليق من إعدادنا.
يمكن أن يجعل التمييز الصحيح بين Collection وView Layer الملفات المعمارية التي تضم عددًا كبيرًا من قطع الأثاث والعناصر المحيطة وخيارات العرض أكثر وضوحًا. كما أن فحص التسلسل الهرمي باستخدام Python API يوفر نقطة انطلاق مفيدة لفرق التصور التي تجري عمليات تحقق متكررة.
بالنسبة إلى المكاتب والطلاب في تركيا، لا تذكر المصادر متطلبات إضافية للأجهزة؛ ومع ذلك، من المهم تجربة الكود على تثبيت Blender المستخدم قبل نقله إلى ملف إنتاج. وقد يفيد توحيد تسمية المجموعات داخل الفريق والتحقق من الفرق بين `hide_render` و`exclude` قبل التسليم عمليًا.
الأسئلة الشائعة
ما الفرق بين Blender Collection وLayer Collection؟
تجمع Collection العناصر والمجموعات الفرعية. أما Layer Collection فتدير حالة هذه المجموعة ضمن View Layer محددة.
ما الإعداد الذي يُستخدم لاستبعاد Collection من View Layer واحدة فقط في Blender؟
تُستخدم خاصية `exclude` في Layer Collection. أما خاصية `hide_render` في Collection فهي مخصصة لتعطيلها عمومًا في عمليات التصيير.
هل يمكن فحص التسلسل الهرمي للمجموعات باستخدام Blender API؟
نعم. يمكن البدء من Layer Collection الجذر في View Layer والمرور عبر `children` لفحص أسماء المجموعات وقيم الرؤية.



