الرندر من سطر الأوامر وأتمتة Python في Blender 5.2 LTS

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

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

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

المتطلبات

• يجب تثبيت Blender. تستند أمثلة الأوامر إلى وثائق سطر الأوامر الخاصة بـ Blender 5.2 LTS.

• يلزم وجود ملف .blend المراد رندره وإمكانية الوصول إلى موقعه.

• لاستخدام سطر الأوامر، تحتاج إلى الطرفية في نظام التشغيل. ويمكن استخدام مساحة عمل Scripting أو محرر النصوص أو Python Console في Blender لتجربة أمثلة Python.

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

خطوة بخطوة: الرندر في الخلفية

1. رندر إطار واحد

يشغّل الخيار -b أو --background Blender من دون واجهة المستخدم. ويمكن تحديد رقم الإطار المراد رندره باستخدام -f، ومسار الإخراج واسم الملف باستخدام -o، وصيغة الإخراج باستخدام -F. يرندر المثال التالي الإطار 20 من الملف sahne.blend بصيغة PNG:

blender -b sahne.blend -o //render_ -F PNG -f 20

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

2. رندر الرسوم المتحركة ضمن نطاق إطارات المشهد

يرندر الخيار -a أو --render-anim الرسوم المتحركة بين إطاري البداية والنهاية، ويشمل الإطارين الطرفيين. في الأمر التالي، مسار الإخراج نسبي والصيغة المحددة هي PNG:

blender -b sahne.blend -o //animasyon_## -F PNG -a

يمكن استخدام الخيارين -s و-e لتحديد إطاري البداية والنهاية على نحو مستقل. أما -j فيحدد عدد الإطارات التي يتقدمها Blender بين الإطارات المراد رندرها. عند استخدام هذه الخيارات، تحقّق من نطاق المشهد ونمط أخذ عينات الإطارات المطلوب؛ إذ يسهل حصر الرندر في الإطارات اللازمة متابعة ملفات الإخراج.

يحدد الخيار -x أو --use-extension ما إذا كان امتداد الملف سيُضاف إلى الإخراج. ولطلب إضافة الامتداد صراحةً، يمكن استخدام -x 1 كما في المثال الوارد في الوثائق. وتشمل الصيغ المذكورة JPEG وPNG وTIFF وHDR؛ وقد يعتمد توفر بعض الصيغ على إصدار Blender المستخدم في عملية البناء.

3. اختيار محرك الرندر وعدد الخيوط وجهاز Cycles

يمكن تحديد محرك الرندر باستخدام -E، كما يمكن استخدام -E help لعرض المحركات المتاحة. ويضبط الخيار -t عدد الخيوط المستخدمة في الرندر والعمليات الأخرى. عند ضبط القيمة على 0، يستخدم Blender عدد معالجات النظام.

يُكتب خيار جهاز Cycles بعد خيارات سطر الأوامر العادية في Blender، مع فصله عنها بشرطتين. تذكر الوثائق الخيارات CPU وCUDA وOPTIX وHIP وONEAPI وMETAL. لا تفترض أن هذه الخيارات ستعمل على كل جهاز مستهدف؛ تحقّق من اختيارك على النظام وضمن تثبيت Blender المستخدمين.

blender -b sahne.blend -f 20 -- --cycles-device OPTIX --cycles-print-stats

يختار هذا المثال جهاز OPTIX في Cycles، ويطلب تسجيل إحصاءات استخدام الذاكرة ومدة الرندر. وإضافة +CPU إلى اسم جهاز GPU تشير إلى استخدام GPU وCPU معًا. إذا كان محرك الرندر المستخدم غير Cycles، فتحقّق من خيارات المحرك نفسه بدلًا من إضافة خيار جهاز خاص بـ Cycles.

4. قراءة بيانات المشهد باستخدام Blender Python

تتيح Python API في Blender التعامل مع بيانات المشهد والكائنات المتاحة في الواجهة. يكفي للبدء نص برمجي صغير يطبع أسماء الكائنات الموجودة في المشهد:

import bpy

for obj in bpy.data.objects:
    print(obj.name)

يمكنك تشغيل هذا النص البرمجي في Blender بالانتقال إلى مساحة عمل Scripting وفتح كتلة بيانات نصية جديدة في محرر النصوص. بعد لصق الشيفرة في المحرر، نفّذها باستخدام Run Script. ويمكن أيضًا استخدام Python Console لتجربة أوامر قصيرة واستكشاف API عبر الإكمال التلقائي.

يمكن تشغيل ملف النص البرمجي نفسه من سطر الأوامر باستخدام الخيار --python:

blender -b sahne.blend --python rapor.py

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

أخطاء شائعة

• تفسير مسار الإخراج على نحو خاطئ: يربط المسار النسبي الذي يبدأ بـ // موقع الإخراج بملف .blend. وقد يؤدي البحث عن الإخراج في مجلد مختلف إلى الاعتقاد بأن الرندر لم يُحفظ.

• الخلط بين رقم الإطار ونطاقه: يرندر -f إطارًا واحدًا، بينما يعالج -a الرسوم المتحركة بين إطاري البداية والنهاية في المشهد. تحقّق من قيمتي -s و-e للنطاق المطلوب.

• كتابة خيار Cycles في موضع غير صحيح: يجب وضع خيارات Cycles مثل --cycles-device بعد الفاصل -- في سطر الأوامر.

• اختيار جهاز غير متوفر على العتاد: لا يعني ورود أسماء الأجهزة في الوثائق أن كل تثبيت يدعمها جميعًا. ابدأ بتجربة رندر قصيرة على الجهاز المستهدف.

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

أثر ذلك في سير عمل العمارة والتصوّر

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

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

الخطوات التالية

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

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

استند هذا الدليل إلى صفحة “Command Line Arguments” في Blender Manual، وصفحتي “Quickstart” و“API Overview” في Blender Python API. المصادر الثلاثة مرخّصة بموجب CC BY-SA 4.0؛ وقد جرى تكييف المحتوى وإعادة صياغته باللغة التركية. أُعدّت أمثلة الأوامر ونص Python القصير لهذا الدليل بالاستناد إلى الخيارات الموثّقة واستخدام API.