آخر الأخبار
إعدادات Unreal Engine Lumen: دليل الإضاءة والانعكاسات الداخليةIntel Nova Lake-S, testte 28 çekirdek ve 5,2 GHz ile görüldüإعداد فيديو معماري باستخدام Veo 3.1: من الطلب إلى بناء المشهدإعداد UV لخريطة الإضاءة من Blender إلى Unreal Engine: دليل خطوة بخطوةإطلاق النسخة التجريبية من CADQuader: تحويل ملفات STEP وIGES إلى شبكات رباعيةإعداد اللوحات المعمارية في Rhino 8: دليل Layout وDetail وإخراج PDFإنشاء صور معمارية باستخدام Images 2.6: من المطالبة إلى التعديل المنضبطاكتمال Théâtre Royal de Rabat: تصميم مستوحى من ضفاف Bouregregنقل مشهد USD من Blender إلى Unreal Engine: دليل خطوة بخطوةInkling 2 Mini يصدر ببنية حلقية تركز على التشغيل المحلي
دروس تعليميةBlenderOMAMari

مقدمة إلى Blender Python API: أولى عمليات الأتمتة للمشاهد المعمارية

تتيح Python API في Blender فحص بيانات المشهد وإضافة خصائص مخصصة إلى العناصر وإعداد أدوات بسيطة. يوضح هذا الدليل التمهيدي الخطوات الأولى للأتمتة في مشاهد التصور المعماري.

مكتب في استوديو تصميم يعمل على نموذج داخلي معماريصورة بالذكاء الاصطناعي
صورة تعبيرية مولّدة بالذكاء الاصطناعي.الصورة: 3dsınıfı / FCA AI

باختصار

  1. يمكن استخدام Python Console لتجربة الأوامر القصيرة واستكشاف API بمساعدة الإكمال التلقائي.
  2. تتيح bpy.data الوصول إلى بيانات العناصر والمشاهد والخامات في ملف Blender المفتوح.
  3. يمكن إضافة خصائص مخصصة إلى العناصر، وتُحفظ مع ملف blend.
  4. يمكن تسجيل عامل (operator) في Blender وتشغيله من قائمة البحث.

ما الذي ستتعلمه في هذا الدليل؟

تتيح Blender Python API الوصول عبر Python إلى كثير من البيانات التي يمكن تعديلها من خلال الواجهة، وتغييرها. وفي النمذجة والتصور المعماريين، قد يعني ذلك فحص عناصر المشهد، أو إضافة معلومات المشروع إلى العناصر، أو تحويل المهام المتكررة إلى أداة. في هذا الدليل، ستقرأ أولًا بيانات المشهد، ثم تضيف خاصية مخصصة إلى العنصر النشط، وأخيرًا تُعد عاملًا بسيطًا.

تستند الأمثلة هنا إلى أساليب واردة في دليل البدء السريع الرسمي للتعرّف إلى Python API في Blender. توصف API عمومًا بأنها مستقرة، لكن يُشار إلى أن بعض أجزاء التوثيق ما تزال قيد التطوير. لذلك، من الأفضل تجربة أي ميزة في مشهد اختبار صغير قبل استخدامها في ملفات الإنتاج.

المتطلبات

  • يجب تثبيت Blender. ولأن المصدر لا يحدد رقمًا لإصدار معين من Blender، لا نذكر هنا رقمًا محددًا للتوافق بين الإصدارات.

  • لا حاجة إلى تثبيت Python بشكل منفصل؛ إذ تُشغَّل الأمثلة عبر Python Console أو Text Editor داخل Blender.

  • لا تذكر المصادر متطلبات تتعلق بحساب أو ترخيص مدفوع.

  • من المفيد تفعيل خياري Developer Extras وPython Tooltips في تفضيلات Blender لاستكشاف API. ويمكن لتلميحات الأزرار أن تساعد في العثور على سمات Python وأسماء العوامل ذات الصلة.

يمكن استخدام Python Console للأوامر والتجارب القصيرة. أما لتحرير البرامج النصية متعددة الأسطر وحفظها، فمساحة عمل Scripting وText Editor في Blender أنسب. ويمكن الوصول إلى مساحة العمل هذه من علامات التبويب في الشريط العلوي.

خطوة بخطوة: الوصول إلى بيانات المشهد وإنشاء أول أداة

1. اعرض قائمة عناصر المشهد باستخدام Python

افتح مساحة عمل Scripting وانتقل إلى Python Console. وتفيد وحدة التحكم أيضًا في استكشاف أسماء البيانات والخصائص داخل bpy، بفضل ميزة الإكمال التلقائي. شغّل الشيفرة التالية لطباعة عناصر المشهد المفتوح واحدًا تلو الآخر:

python
import bpy

for ob in bpy.context.scene.objects:
    print(ob)

يمر هذا المثال على مجموعة عناصر المشهد الحالي ويرسل كل عنصر إلى مخرجات وحدة التحكم. وفي ملف معماري، تُعد هذه الطريقة بداية بسيطة للتحقق بسرعة من العناصر الموجودة في المشهد. ويمكن لاحقًا إضافة عمليات داخل الحلقة لفحص الاسم أو البيانات أو سمات أخرى، بالاستفادة من طرق الوصول الموثقة في المصدر.

2. اعثر على البيانات باستخدام bpy.data

يمكن الوصول إلى كتل البيانات في ملف Blender عبر bpy.data. ويعرض الدليل أمثلة على مجموعات مثل العناصر والمشاهد والخامات. ويمكن الوصول إلى أحد عناصر المجموعة باستخدام اسمه:

python
bpy.data.objects["Cube"]

يمكن أيضًا الوصول إلى المجموعة نفسها باستخدام فهرس رقمي، لكن الدليل يحذر من أن فهرس أحد العناصر قد يتغير أثناء العمل. لذلك، عند البحث عن عنصر محدد في المشهد، يكون الوصول إليه باسمه أوضح من افتراض ثبات قيمة الفهرس. وانتبه أيضًا إلى احتمال اختلاف الاسم في الملف؛ فـCube في المثال ليس سوى اسم العنصر المستخدم في الدليل.

3. أضف معلومات مخصصة إلى العنصر النشط

يمكن الاستفادة من الخصائص المخصصة في Python API لإضافة خصائص إلى عنصر أو مشهد أو مجموعة. يحفظ المثال التالي قيمة نصية في العنصر النشط، إن وُجد:

python
import bpy

obj = bpy.context.object
if obj is not None:
    obj["project_note"] = "interior study"

يعيد bpy.context.object العنصر النشط بحسب السياق. ويضمن الشرط عدم تنفيذ العملية إذا لم يكن هناك عنصر نشط. ووفقًا للدليل، تُحفظ هذه الخصائص المخصصة مع ملف blend وتنتقل مع العناصر عند نسخها. لذا يمكن استخدامها لإضافة ملاحظة عن المشروع أو معلومة بسيطة يحددها الفريق إلى عنصر. كما أن اختيار أسماء متسقة للخصائص يسهل العثور على البيانات عند العمل عبر عدة ملفات وبرامج نصية.

لا يمكن إسناد سوى أنواع Python الأساسية إلى الخصائص المخصصة: الأعداد الصحيحة، والأعداد العشرية، والنصوص، ومصفوفات الأعداد، والقواميس التي تستوفي شروطًا معينة. ويحدد الدليل حدًا أقصى قدره 1024 مستوى للقواميس المتداخلة؛ وقد يؤدي تجاوز هذا العمق إلى أخطاء وفقدان البيانات. لا يحتوي هذا المثال على بنية متداخلة من هذا النوع، لأنه يستخدم قيمة نصية بسيطة.

4. حوّل المهمة المتكررة إلى عامل

يمكن تعريف عامل لإعادة تشغيل مقطع برمجي من داخل Blender. ينشئ المثال التالي عاملًا بسيطًا يطبع عناصر المشهد، ولا يسمح بتشغيله إذا لم يوجد عنصر نشط:

python
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، اختر Text Editor، وافتح كتلة نصية جديدة باستخدام زر New، ثم الصق الشيفرة واضغط Run Script. ويذكر المثال في الدليل أنه بعد تسجيل العامل، يمكن البحث عن Simple عبر Operator Search. يمنع فحص poll() تشغيل العامل عند عدم وجود عنصر نشط. وتكتسب هذه النقطة أهمية عندما يعتمد البرنامج النصي على سياق المستخدم.

5. راعِ سياق وحدة التحكم والواجهة

قد يختلف محتوى bpy.context بحسب المنطقة التي تُشغّل فيها الشيفرة. وقد لا تتطابق عناصر السياق في Python Console و3D Viewport. كذلك لا يمكن تغيير قيم السياق مباشرة؛ إذ يوضح المصدر أن تعيين العنصر النشط مباشرة يؤدي إلى خطأ، وأنه يمكن بدلًا من ذلك استخدام المسار bpy.context.view_layer.objects.active. إذا لم يعمل عامل على النحو المتوقع، فتحقق أولًا من المنطقة والوضع اللذين شُغّل فيهما.

أخطاء شائعة

  • استخدام الفهرس كما لو كان معرّفًا دائمًا: قد تتغير فهارس المجموعات أثناء العمل. والوصول إلى عنصر محدد باسمه أوضح؛ لكن تحقّق من وجود هذا الاسم في الملف.

  • افتراض أن كل عامل سيعمل في أي مكان: تتطلب بعض العوامل منطقة أو وضعًا أو تحديدًا مناسبًا. يتحقق شرط poll() من ملاءمة السياق؛ وقد يؤدي استدعاء العامل في سياق غير صالح إلى خطأ.

  • محاولة تغيير Context مباشرة: يُعرّف bpy.context بأنه للقراءة فقط. إذا لزم إجراء تغيير، فاستخدم واجهة البيانات الموثقة أو وظيفة API مناسبة.

  • إضافة بيانات معقدة إلى الخصائص المخصصة: الأنواع المدعومة محدودة، كما يجب أن تتكون قيم القواميس من أنواع أساسية. اختر خصائص بسيطة وواضحة.

  • البحث عن مخرجات البرنامج النصي في المكان الخطأ: تُرسل مخرجات print في المثال إلى الطرفية. إذا لم تظهر نتيجة التشغيل، فتحقق من طرفية Blender.

الخطوات التالية: سير العمل المعماري والتصور

قد تكون هذه الأساليب الأساسية نقطة انطلاق للمعماريين ومصممي الديكور الداخلي وفناني التصور الذين يرغبون في التحقق من تنظيم المشهد أو إرفاق معلومات إضافية بالعناصر. فمثلًا، قد يساعد عرض قائمة عناصر ملف ما في التحقق من محتوى المشاهد الكبيرة، بينما تتيح الخصائص المخصصة حفظ وسوم بسيطة يحددها الفريق داخل الملف. لكن هذه الأساليب لا توفر بحد ذاتها معيار BIM محددًا أو حلًا آليًا لإدارة المشاريع؛ إذ يحد نطاقها ما يكتبه المستخدم من برامج نصية وما يستخدمه من بيانات.

أجرِ التجارب الأولى على نسخة من ملف blend. بعد ذلك، استعن بـPython Tooltips والإكمال التلقائي في وحدة التحكم لفحص مسار البيانات المطلوب، ولا تضف سمة إلى برنامج إنتاج قبل التحقق من وظيفتها. ثم عدّل العامل ليناسب مهمة متكررة فعلية واختبره مع حالات مختلفة من التحديد والعنصر النشط والسياق. أما البرامج النصية التي ستُشارك داخل المكاتب، فينبغي التحقق من توافقها مع إصدار Blender المستخدم؛ فالمصادر لا تقدم مصفوفة توافق محددة.

المصدر والترخيص

أُعد هذا الدليل بتكييف الأمثلة والشروحات الواردة في دليل البدء السريع لـBlender Python API. الدليل مرخص بموجب CC BY-SA 4.0. وتوفر مدونة مطوري Blender لعام 2011 سياقًا تاريخيًا حول توسيع توثيق API؛ لكنها لا تحل محل الإرشادات الحالية لاستخدام API.

المصادر

2 مصادر
C
code.blender.orgcode.blender.org/2011/02/blenderpython-api-docs
سياق
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/info_quickstart.html
ملخص

لا نعيد نشر نصوص المصادر؛ الاقتباسات القصيرة مشار إليها، وما تبقى ملخص وتعليق من إعدادنا.

رأي 3dsınıfı
3dتقييم المحرر

قد تكون Blender Python API مفيدة خصوصًا لمكاتب الهندسة المعمارية وفرق التصور في تركيا لأتمتة عمليات التحقق الصغيرة المتكررة وتنظيم المعلومات داخل الملفات. كما أن عملها داخل Blender، المتاح للاستخدام مجانًا، يجعل بدء التجربة عمليًا من دون الحاجة إلى تكلفة برنامج إضافي.

ومع ذلك، تعتمد قيمة الأتمتة على تكييف البرنامج النصي مع تنظيم الملفات وإصدار Blender المستخدمين في الفريق. ومن المهم اختباره أولًا على مشهد منسوخ، ومراعاة أن بعض أجزاء API ما تزال قيد التطوير، وإبقاء الخصائص المخصصة بسيطة. كما يتيح ذلك للطلاب طريقة عملية لفهم كيفية تنظيم بيانات المشهد أثناء تعلم API.

الأسئلة الشائعة

أين يمكن تشغيل شيفرات Blender Python API؟

يمكن تجربة الأوامر القصيرة في Python Console، وتشغيل البرامج النصية عبر Text Editor في مساحة عمل Scripting في Blender.

كيف يمكن إضافة معلومات مخصصة إلى عنصر في Blender؟

تدعم API إضافة خصائص مخصصة إلى العناصر. ويمكن حفظ هذه الخصائص مع ملف blend، كما تنتقل مع العنصر عند نسخه.

هل تتطلب Blender Python API إصدارًا محددًا؟

لا يحدد المصدر المستخدم رقم إصدار بعينه. وتوصف API بأنها مستقرة عمومًا، مع الإشارة إلى أن بعض أجزائها ما تزال قيد التطوير.

التعليقات والمنتدى باللغة التركية.شارك في النقاش
+

أخبار ذات صلة