دليل Scene Explorer في 3ds Max: إنشاء أعمدة مخصصة باستخدام MAXScript

تشرح وثائق MAXScript من Autodesk كيفية إدارة Scene Explorer باستخدام البرامج النصية، من خلال واجهة SceneExplorerManager وأساليب إنشاء الأعمدة المخصصة. يستعرض هذا الدليل، بالاستناد إلى الوثائق الرسمية، خطوات إنشاء Explorer في مشاهد 3ds Max، واختيار الأعمدة الظاهرة، وعرض خصائص الكائنات كأعمدة، وإعادة استخدام الإعدادات. تتوفر واجهة SceneExplorerManager في إصدارات 3ds Max 2008 وما بعدها، لكن بعض الأساليب تتطلب إصدارات أحدث.

تستند أمثلة التعليمات البرمجية أدناه إلى أساليب MAXScript الواردة في وثائق Autodesk. قبل تشغيل أي برنامج نصي في مشهد إنتاجي، تحقّق من أن إصدار 3ds Max المستهدف يدعم الأسلوب المعني، وأن أسماء الأعمدة تطابق الخصائص الموجودة في المشهد.

1. تحقّق من دعم الإصدار وحدّد المطلوب

ابدأ بتحديد المهمة التي تريد أتمتتها: هل تريد إعداد ترتيب أعمدة موجود، أم إظهار خصائص الكائنات، أم حفظ إعدادات Explorer وإعادة تحميلها؟ تختلف متطلبات الإصدارات بين الأساليب. فعلى سبيل المثال، توثّق Autodesk الأسلوبين CreateExplorer وSetExplorerVisibleColumns للإصدارات 3ds Max 2010 وما بعدها. أما GetExplorer، فيتوفر في إصدارات 3ds Max 2015 وما بعدها.

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

2. أنشئ Explorer واضبط الأعمدة الظاهرة

1. استخدم الأسلوب CreateADefaultExplorer لإنشاء Explorer بالإعدادات الافتراضية. يعيد الأسلوب True عند نجاح العملية وFalse عند فشلها.

2. بعد ذلك، حدّد الأعمدة المطلوب عرضها على هيئة مصفوفة أسماء باستخدام SetExplorerVisibleColumns. في مثال Autodesk، تظهر أعمدة الاسم والنوع واللون في Explorer باسم “Object Colors”.

3. لإنشاء Explorer جديد بأعمدة محددة، استخدم الأسلوب CreateExplorer. يتلقى هذا الأسلوب اسم Explorer ومصفوفة بأسماء الأعمدة؛ ولا ينبغي افتراض أنه ينشئ Explorer بالإعدادات الافتراضية.

SceneExplorerManager.CreateADefaultExplorer "Object Colors"
SceneExplorerManager.SetExplorerVisibleColumns "Object Colors" #("Name","Type","Color")

SceneExplorerManager.CreateExplorer "Geometry Counts" #("Name","Type","Faces")

ترد القيم التالية في أمثلة وثائق Autodesk. وهي ليست ترتيبًا إلزاميًا لكل مشهد، بل أمثلة توضح كيفية استخدام الأساليب.

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

3. حوّل الخصائص المخصصة إلى أعمدة في Scene Explorer

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

تكتسب عملية التحقق من isProperty أهمية عند احتمال عدم وجود الخاصية في كل كائن. لا يصل المثال التالي إلى قيمة Radius إلا إذا كانت الخاصية موجودة في الكائن المعني:

fn getRad theNode = (
    if isProperty theNode "Radius" then theNode.Radius
)

fn setRad theNode theValue = (
    if isProperty theNode "Radius" then theNode.Radius = theValue
)

SceneExplorerManager.addProperty "Radius" getRad setRad

إذا كان المطلوب عرض المعلومات فقط، من دون تغيير القيم عبر Explorer، فيمكن استخدام addReadOnlyProperty. ينشئ مثال الوثائق فلترًا للقراءة فقط باسم “Class”، ويعيد فئة الكائن باستخدام classof:

fn getClass theNode = (classof theNode)
SceneExplorerManager.addReadOnlyProperty "Class" getClass

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

4. احفظ إعدادات Explorer وأدِرها

يمكن حفظ إعدادات Explorer في ملف محدد باستخدام SaveExplorerConfiguration، ثم تحميل إعدادات محفوظة مسبقًا باستخدام LoadExplorerConfiguration. ينبغي تعديل مسار الملف في المثال التالي ليتوافق مع بيئة العمل على الجهاز المعني:

SceneExplorerManager.SaveExplorerConfiguration "Geometry Counts" "C:\\SceneExplorerConfig"
SceneExplorerManager.LoadExplorerConfiguration "C:\\SceneExplorerConfig"

يتوفر الأسلوبان OpenExplorer وCloseExplorer لفتح Explorer أو إغلاقه. يتحقق ExplorerExists من وجود Explorer بالاسم المحدد، بينما يستعلم ExplorerIsOpen عمّا إذا كان مفتوحًا. يعيد GetExplorer واجهة Explorer إذا وُجد بالاسم المحدد؛ وإذا لم يوجد، تكون النتيجة undefined.

لإتاحة فلاتر الخصائص المخصصة في جلسات 3ds Max اللاحقة أيضًا، يمكن حفظ تعريفات الفلاتر في ملف برنامج نصي ووضعه في مجلد Scripts\Startup. ولعرض قائمة بعدة Explorers، يعيد GetExplorerCount العدد الإجمالي، بينما يعيد GetExplorerName الأسماء للفهارس من 1 حتى ذلك العدد. يغلق ClearAllExplorers جميع Explorers ويمسح قائمة Tools>Saved Scene Explorers> في القائمة. لذلك، لا ينبغي استخدامه عند العمل على Explorer واحد فقط.

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

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

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

أخطاء شائعة

• إضافة اسم فلتر غير موجود إلى قائمة الأعمدة الظاهرة: قد يُتجاهل العمود المعني من دون ظهور خطأ.

• افتراض أن العمود سيظهر تلقائيًا بعد تعريف عمود مخصص: يجب سحبه من Column Chooser إلى Scene Explorer.

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

• توقّع أن يعيد استدعاء GetExplorer كائن Explorer في كل مرة: إذا لم يُعثر على الاسم، تكون النتيجة undefined.

• استخدام ClearAllExplorers لإغلاق Explorer واحد: يغلق هذا الأسلوب جميع Explorers ويمسح قائمة القائمة المحفوظة.