دليل RealityScan لسطر الأوامر: سير العمل من الصور إلى نموذج 3D

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

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

لا تضمن هذه الطريقة أتمتة كل عملية. فعلى سبيل المثال، ينفّذ الأمر -start العمليات التي سبق إعدادها لزر Start داخل RealityScan. لذلك ينبغي مراعاة إعدادات التطبيق وخطوات سطر الأوامر معًا.

المتطلبات

تشرح الوثائق الرسمية أمثلة سطر الأوامر عبر RealityScan.exe. والخطوات التالية مخصصة لموجّه أوامر Windows وملفات .bat. لا تحدد الوثائق إصدارًا بعينه أو مستوى للأجهزة أو نوعًا للحساب أو معلومات عن الأسعار؛ لذا يجب التحقق بشكل مستقل من التثبيت المستخدم وشروط الترخيص قبل بدء المشروع.

يستخدم المثال المسارين C:\RS\Images وC:\RS\Interior.rsproj لمجلد الصور وملف المشروع. أنشئ هذه المجلدات على جهازك وضع الصور في الموقع المناسب. إذا استخدمت مسارات ملفات تتضمن مسافات في الأوامر، فتحقق من طريقة تحليل المعاملات في تثبيتك؛ فالأمثلة تفضّل المسارات الخالية من المسافات.

إضافة مجلد RealityScan إلى متغير PATH في النظام تقلل الحاجة إلى كتابة المسار الكامل للتطبيق في كل أمر. وتشير الوثائق الرسمية إلى أن سطر PATH أدناه يظل ساريًا لجلسة سطر الأوامر المفتوحة فقط.

خطوات التطبيق المرقّمة

1. حاذِ الصور في وضع المسودة

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

set PATH=%PATH%;C:\Program Files\Epic Games\RealityScan\
RealityScan.exe -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

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

2. أدرج المجلدات الفرعية عند الحاجة

إذا كانت الصور موزعة على مجلدات فرعية داخل المجلد الرئيسي، فعّل إعداد فحص المجلدات الفرعية قبل عملية الإضافة:

RealityScan.exe -set "appIncSubdirs=true" -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

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

3. نفّذ المحاذاة الكاملة

بعد مراجعة نتيجة المسودة، أعد تحميل المشروع المحفوظ وابدأ المحاذاة الكاملة:

RealityScan.exe -load C:\RS\Interior.rsproj -align -save C:\RS\Interior.rsproj -quit

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

4. شغّل سير العمل المحدد في التطبيق

بعد المحاذاة، اضبط العمليات اللازمة في زر Start داخل RealityScan لإنشاء النموذج. ووفقًا للوثيقة الرسمية، ينفّذ -start العمليات المعدّة لذلك الزر؛ لذا لا تفترض خطوات النمذجة التي ستُنفّذ بمجرد إضافة الأمر.

RealityScan.exe -load C:\RS\Interior.rsproj -start -save C:\RS\Interior.rsproj -quit

ينبغي التحقق من الخيارات المستخدمة أثناء العملية في التطبيق، بحسب المشروع والهدف. يسهّل سطر الأوامر إعادة تشغيل سير العمل المحدد مسبقًا، لكنه لا يضمن تلقائيًا ملاءمة الإعدادات.

5. بسّط النموذج وصدّره

إذا كنت تعرف اسم النموذج داخل المشروع، فيمكنك تحديده باستخدام -selectModel، وتعيين عدد المثلثات المستهدف باستخدام -simplify، ثم تصديره باستخدام -exportSelectedModel. يستخدم المثال أدناه الاسم Model1 والعدد المستهدف 1.000.000 مثلث؛ وهذا الرقم مثال على استخدام الأمر وليس توصية للجودة.

RealityScan.exe -load C:\RS\Interior.rsproj -selectModel Model1 -simplify 1000000 -exportSelectedModel C:\RS\Interior.obj -save C:\RS\Interior.rsproj -quit

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

أخطاء شائعة

• قد يؤدي استدعاء RealityScan.exe من دون تشغيل الأوامر في مجلد تثبيت التطبيق إلى تعذّر العثور على الملف التنفيذي. استخدم المسار الكامل للتطبيق أو أضف سطر PATH إلى جلسة الأوامر النشطة.

• لا تفترض أن الصور الموجودة في المجلدات الفرعية ستُضاف تلقائيًا. استخدم إعداد appIncSubdirs إذا كانت هذه هي النتيجة المطلوبة.

• لا تعتبر محاذاة المسودة نتيجة مكتملة. فالأمران -draft و-align مختلفان؛ تحقق من المشروع بعد مرحلة المسودة.

• لا تتوقع العمليات التي سيبدأها الأمر -start. اضبط إعدادات زر Start مسبقًا في التطبيق.

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

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

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

من المهم في المشاريع التي يعمل عليها أكثر من شخص داخل المكاتب الحفاظ على اتساق بنية المجلدات وأسماء المشاريع وإعدادات العمليات في التطبيق. لا تقدم وثائق RealityScan معلومات عن التوافق مع برنامج archviz محدد أو متطلبات الأجهزة أو تكلفة الترخيص. لذلك ينبغي اختبار كيفية استخدام الملف المُصدّر في التطبيق المستهدف، وتأثير الأجهزة في مدة المعالجة، وشروط الترخيص، باستخدام بيانات مشروع فعلي.

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

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

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

يستند هذا الدليل إلى أقسام أوامر المشاريع والصور، وأوامر المحاذاة، وأدوات النماذج في وثائق سطر الأوامر التي نشرتها Epic Games لـRealityScan. وقد أُشير إلى المصادر على أنها مرخّصة بحرية؛ وصيغ المحتوى باللغة التركية، وأُعدّت الأمثلة لهذا الدليل.