تنظيف Spline وإنشاء Spline Mesh باستخدام Unreal Engine PCG

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

يتناول هذا الدليل خيارات تنظيم بيانات Spline وإنشاء Mesh على امتدادها باستخدام أدوات Procedural Content Generation (PCG) في Unreal Engine. في القسم الأول، سنستعرض إعدادات PCGCleanSplineSettings المخصصة لإزالة نقاط التحكم المتداخلة أو غير الضرورية على المقاطع الواقعة على خط واحد. ثم سنشرح طريقة الصنف PCGSpawnSplineMeshSettings في إنشاء مكوّنات Mesh لمقاطع Spline.

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

المتطلبات وملاحظات الإصدار

تخص صفحتا API في المصادر إصدارين مختلفين من Unreal Engine: يظهر صنف تنظيف Spline في وثائق Python التجريبية لـ Unreal Engine 5.7، بينما يظهر صنف إنشاء Spline Mesh في وثائق Python التجريبية لـ Unreal Engine 5.5. وهذا لا يعني أن الميزات متاحة بالطريقة نفسها في الإصدار ذاته، أو أن الصنفين جاهزان للاختبار معًا. تحقّق أيضًا من وثائق API الخاصة بإصدار المشروع الذي تستخدمه.

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

خطوات التنفيذ

1. حدّد بيانات Spline والهدف. ابدأ بتحديد المهمة الهندسية التي يمثّلها Spline ونوع Mesh المراد إنشاؤه على امتداده. يمكن، مثلًا، وصف حدّ لمنطقة تنسيق أو حافة طريق أو عنصر معماري خطي باستخدام Spline؛ لكن هذه الوثائق لا تحدد Mesh المطلوب أو تنظيم المشروع. في هذه المرحلة، قيّم النقاط أو المقاطع التي تؤثر فعليًا في الشكل قبل تعديل Spline.

2. اختر سلوك التنظيف. يتعامل PCGCleanSplineSettings مع حالتين أساسيتين لإزالة نقاط التحكم غير الضرورية على امتداد Spline: النقاط الموجودة في الموقع نفسه، والنقاط الواقعة على مقطع خطي بين النقطة السابقة والتالية. تتحكم remove_collinear_control_points في إزالة النقاط الواقعة على مقاطع خطية والتي لا تؤثر في الحساب النهائي لـ Spline. أما fuse_colocated_control_points فتتيح دمج النقاط التي تقع ضمن حدّ مسافة محدد في فضاء العالم.

3. اضبط الحدود بعناية. تحدد colocation_distance_threshold حدّ المسافة الذي تُعدّ ضمنه نقطتا تحكم في الموقع نفسه. أما collinear_angle_threshold فهو حدّ الزاوية المستخدم لتحديد ما إذا كانت النقطة خطية بالنسبة إلى المقطع الواصل بين النقطتين السابقة والتالية. توضح الوثائق نوع هذه الخصائص ووظيفتها، لكنها لا توصي بقيم محددة لمشروع بعينه. لذلك ينبغي اختبار الحدود على بيانات المشهد بما يحافظ على شكل Spline.

4. تحقّق من فضاء القياس ووحدة الزاوية. يختار use_spline_local_space استخدام الفضاء المحلي لـ Spline بدلًا من فضاء العالم عند حساب المسافة. وعند تفعيل use_radians، يُستخدم حدّ الزاوية بالراديان مباشرةً؛ كما تُحوّل قيمة CollinearAngleThreshold الحالية تلقائيًا عند تغيير الخاصية. راعِ هذا التغيير في الوحدة عند نقل القيم يدويًا.

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

6. راجع خصائص Mesh والتحميل. يوفّر spline_mesh_descriptor واصف مكوّن Mesh، بينما يوفّر spline_mesh_params معلمات Spline Mesh. وعند تفعيل synchronous_load، يُفرض التحميل المتزامن لـ Mesh والمواد. قيّم أثر هذا الخيار في سلوك التحميل بالمشروع؛ فالوثائق لا تحدد نتائج الأداء ولا الحالات التي يُفضّل استخدامه فيها.

7. انتبه إلى قيود التجاوزات والمعالجة اللاحقة. يحدد spline_mesh_override_descriptions التجاوزات الخاصة بواصف Spline Mesh. وتذكر الوثائق صراحةً أن هذه التجاوزات تدعم حاليًا السمات على مستوى البيانات فقط، وأن التجاوزات لكل نقطة تحكم لا تعمل. أما post_process_function_names فيتلقى قائمة بالدوال التي ستُستدعى على الممثل المستهدف بعد إنشاء Mesh. ويجب أن تكون هذه الدوال بلا معلمات وأن تحمل وسم CallInEditor.

أخطاء شائعة

• اعتبار وثائق 5.5 و5.7 ضمانًا لإصدار واحد: وُثّق الصنفان في وثائق تخص إصدارين مختلفين. تحقّق من الخصائص كلٌّ على حدة في الإصدار الذي تستخدمه.

• زيادة قيم الحدود بلا تدقيق: تؤثر حدود المسافة والزاوية في قرارات التنظيف. لا تحدد المصادر قيمة مثالية عامة؛ لذا تحقّق من الحفاظ على شكل Spline.

• توقع تجاوزات لكل نقطة تحكم: يوضح وصف تجاوزات Mesh أن هذا الاستخدام غير مدعوم. خذ هذا القيد على مستوى البيانات في الحسبان عند تصميم متطلباتك.

• إغفال تغيير use_radians: عند تغيير وحدة الزاوية، تُحوّل قيمة الحد الحالية تلقائيًا. تحقّق من الوحدة المستخدمة عند نقل قيمة من إعداد أو سير عمل آخر.

• افتراض خطوات غير موثقة في المحرر: هذه المصادر أوصاف للأصناف والخصائص، ولا تقدم تخطيطًا محددًا للعُقد أو مثالًا قابلًا للتنفيذ بلغة Python.

ما الفائدة في سير عمل العمارة والتصميم الداخلي والتصور المعماري؟

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

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

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

ابدأ بفتح وثائق PCG Python API الخاصة بإصدار Unreal Engine الذي اخترته، وقارن خصائص الصنفين في ذلك الإصدار. ثم غيّر إعدادات تنظيف نقاط التحكم على Spline تجريبي صغير، ولاحظ أثرها في الشكل. أما في جانب إنشاء Mesh، فتحقّق من الواصف والمعلمات وقيود التجاوزات على مستوى البيانات. وقبل الانتقال إلى مشهد الإنتاج، تأكد من توفر الوظائف في الإصدار الذي يستخدمه فريق المشروع ومن أنها تحقق النتيجة المتوقعة.

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

أُعد هذا الدليل باللغة التركية بالاستناد إلى وصف PCGCleanSplineSettings في وثائق Python API التجريبية لـ Unreal Engine 5.7 من Epic Games، وإلى وصف PCGSpawnSplineMeshSettings في وثائق Python API التجريبية لـ Unreal Engine 5.5. وكلا المصدرين من الوثائق الرسمية، ويُشار إلى الترخيص في سجلات المصدر بأنه serbest.