تفتح مشروعاً جديداً ثلاثي الأبعاد في Godot بعد أن أنهيت لعبتك الأولى ثنائية الأبعاد، فتضيف كرة، وتعطيها لوناً ذهبياً لامعاً، وتضع كاميرا أمامها، ثم تضغط زر التشغيل. وفي المحرر كانت الكرة ذهبية تحت سماء زرقاء، أما في النافذة التي فتحت فهي دائرة سوداء تماماً على خلفية رمادية. وهذا ليس خطأ في جهازك ولا في المحرك، وإنما أول درس في الرسم ثلاثي الأبعاد: الصورة التي تراها ليست لون الشيء، وإنما نتيجة حساب يجمع شكله وخامته والضوء الذي يصل إليه والكاميرا التي تنظر إليه والبيئة التي تحيط به، فإذا غاب واحد منها تغيرت النتيجة كلها. والكرة السوداء التي ذكرتها ليست مثالاً من خيالنا، فهي من أول إطار رسمه المختبر في هذا المقال، كما سترى في قسم الإضاءة.
وفي المرحلة السابقة بنينا لعبة «جني التمر» ثنائية الأبعاد، وكان كل شيء فيها صورة مسطحة Sprite لها موضع على الشاشة. وفي هذه المرحلة ننتقل إلى العالم ثلاثي الأبعاد، وأول ما نحتاجه أن نفهم مكوناته الخمسة: المجسم Mesh الذي يحدد الشكل، والخامة Material التي تحدد كيف يرد السطح الضوء، والأضواء Lights والظلال Shadows، والكاميرا Camera التي تحول العالم إلى صورة، والبيئة Environment التي تعطي السماء والضوء العام. وسوف نبني فناءً صغيراً بالكود فقط، دون أي ملف من خارج المشروع، ونرسمه في Godot 4.7.2 إطاراً حقيقياً، ونقرأ من المحرك نفسه كم جسماً رسم، وكم مثلثاً، وكم أمر رسم Draw Call أرسل، ثم نصنع الأخطاء التي يقع فيها كل مبتدئ تقريباً، ونرى شكلها في الصورة وسببها في الأرقام.
وسوف نتناول في هذا المقال ما يلي:
- كيف تتحول قائمة أرقام إلى صورة: مسار الرسم Rendering Pipeline، والإحداثيات في Godot.
- المجسم Mesh من الداخل: الرؤوس Vertices والمثلثات والعمودي Normal وإحداثيات الخامة UV، وبناء مجسم بيدك بالأداة SurfaceTool.
- أخطاء العمودي واتجاه الوجه، وأخطاء UV، مصنوعة عن قصد ومرسومة في إطار حقيقي.
- الخامة StandardMaterial3D وطريقة PBR: المعدنية Metallic والخشونة Roughness.
- الأضواء الثلاثة في Godot، وماذا تكلف الظلال من أوامر الرسم.
- الكاميرا Camera3D: زاوية الرؤية والإسقاط المتعامد، والسطحان المتداخلان Z-fighting.
- البيئة WorldEnvironment: السماء والضوء المحيط وتحويل الألوان Tonemapping والضباب.
- العارضات الثلاث Forward+ وMobile وCompatibility، وكيف تقرأ عدادات المحرك.
كيف تتحول الأرقام إلى صورة؟ مسار الرسم Rendering Pipeline
كل ما في المشهد ثلاثي الأبعاد قائمة من النقاط في الفضاء، وكل ثلاث نقاط منها تكون مثلثاً، والمثلث هو الوحدة الوحيدة التي يرسمها كرت الشاشة GPU. فالمكعب اثنا عشر مثلثاً، والكرة آلاف المثلثات الصغيرة، وشخصية اللعبة عشرات الآلاف. وفي كل إطار يمر كل مثلث بالمراحل نفسها تقريباً، والشكل التالي يبينها كما تحدث في الفناء الذي سنبنيه:

والمراحل بالترتيب كما يلي:
- المجسم Mesh: قوائم أرقام، أهمها مواضع الرؤوس، وبجانب كل رأس عموديه واتجاهه، وإحداثياته على الخامة UV، وقد تكون معها قائمة فهارس Indices تقول أي ثلاثة رؤوس تكون كل مثلث.
- معالج الرؤوس Vertex Shader: برنامج صغير يعمل على كل رأس، فينقله من إحداثيات الجسم إلى إحداثيات العالم بحسب موضع العقدة ودورانها وحجمها، ثم إلى إحداثيات الكاميرا، ثم يسقطه على مستوى الشاشة. وهذه التحويلات هي ضرب مصفوفات Matrices، وهي امتداد لما شرحناه عن المتجهات في رياضيات الألعاب.
- التحويل إلى بكسلات Rasterization: يحدد كرت الشاشة البكسلات التي يغطيها كل مثلث على الشاشة، ويهمل المثلثات التي يرى ظهرها، وهذا ما يسمى حذف الوجوه الخلفية Backface Culling، وسوف نرى أثره بعد قليل.
- معالج البكسل Fragment Shader: برنامج آخر يعمل على كل بكسل، فيحسب لونه من الخامة، ومن العمودي في تلك النقطة، ومن كل ضوء يصلها، ومن البيئة حولها.
- اختبار العمق Depth Test: إذا وقع مثلثان على البكسل نفسه، يبقى الأقرب إلى الكاميرا بحسب ذاكرة العمق Depth Buffer، وهذه الذاكرة دقتها محدودة كما سنرى في قسم الكاميرا.
ولا تكتب أنت هذه البرامج في الغالب، لأن الخامة StandardMaterial3D تولد معالج الرؤوس ومعالج البكسل نيابة عنك من الإعدادات التي تختارها. ولكن فهم المراحل هو ما يجعلك تعرف أين تبحث عندما تخرج الصورة خاطئة: شكل خاطئ يعني مشكلة في المجسم أو في التحويل، ولون خاطئ يعني مشكلة في الخامة أو الضوء أو البيئة، ووميض بين سطحين يعني مشكلة في العمق.
وأما الإحداثيات فيذكر توثيق مقدمة 3D في Godot أن المحرك يستخدم المتر وحدةً لكل شيء، فالوحدة الواحدة متر، وأن الفيزياء وغيرها مضبوطة على هذا المقياس، ولذلك ينصح أن يعمل الفنانون بالمقياس الصحيح من البداية. والمحور Y هو الأعلى، والمحوران X وZ أفقيان في نظام يميني Right-handed، أي أن X يمين ويسار، وY أعلى وأسفل، وZ أمام وخلف، والكاميرا تنظر في اتجاه -Z. وهذه التفاصيل تبدو مملة الآن، ولكنها سبب أغلب مشاكل استيراد النماذج من Blender، وهو موضوع المقال التالي في هذه المرحلة.
المختبر: فناء صغير مبني بالكود
المشهد الذي سنعمل عليه فناء مساحته 12 في 12 متراً: أرضية من بلاط رملي، وجداران من الجص، وصندوق خشبي، وعمود، وكرة نحاسية، وخيمة حمراء على شكل هرم بنيناها رأساً رأساً، وفانوس صغير مضيء معلق على الجدار. ولا يوجد في المشروع أي ملف صورة أو نموذج، فكل شيء ينشئه السكربت lab.gd عند التشغيل، حتى خامة البلاط يرسمها بكسلاً بكسلاً. والسبب أن تقرأ المشهد كله في ملف واحد، وأن تغير أي سطر فيه وترى أثره. وهذا جزء من الدالة التي تبني الفناء:
func courtyard() -> void:
var floor_mat := mat(Color.WHITE, 0.0, 0.9)
floor_mat.albedo_texture = tiles
floor_mat.uv1_scale = Vector3(6, 6, 1) # 12 m floor, one texture every 2 m
var floor_mesh := PlaneMesh.new()
floor_mesh.size = Vector2(12, 12)
add_mesh(floor_mesh, floor_mat, Vector3.ZERO).name = "Floor"
var plaster := mat(Color(0.93, 0.89, 0.82), 0.0, 0.95)
var wall := BoxMesh.new()
wall.size = Vector3(12, 3, 0.4)
add_mesh(wall, plaster, Vector3(0, 1.5, -6)).name = "BackWall"
add_mesh(wall, plaster, Vector3(-6, 1.5, 0)).rotation_degrees.y = 90
var crate := BoxMesh.new()
add_mesh(crate, mat(Color(0.55, 0.36, 0.2), 0.0, 0.85), Vector3(2.2, 0.5, 1.2)).name = "Crate"
var column := CylinderMesh.new()
column.top_radius = 0.3
column.bottom_radius = 0.3
column.height = 3.0
add_mesh(column, plaster, Vector3(-3.5, 1.5, -3.5)).name = "Column"
var ball := SphereMesh.new()
add_mesh(ball, mat(Color(0.95, 0.7, 0.3), 1.0, 0.25), Vector3(0.8, 0.5, 2.6)).name = "BrassBall"
add_mesh(pyramid(), mat(Color(0.75, 0.2, 0.15), 0.0, 0.7), Vector3(-1.5, 0, 0.5)).name = "Tent"في الكود أعلاه لاحظ التالي:
- كل شيء في المشهد ثلاثة أجزاء: مجسم مثل
BoxMeshأوSphereMesh، وخامة تصنعها الدالةmatمن لون ومعدنية وخشونة، وعقدة MeshInstance3D تجمعهما وتضعهما في مكان من العالم بالدالةadd_mesh. والمجسم نفسه لا موضع له، ولذلك استخدمنا مجسم الجدار مرتين، مرة في الخلف ومرة على اليسار بعد تدويره 90 درجة. - المقاسات بالمتر: الجدار 12 متراً طولاً و3 أمتار ارتفاعاً، والصندوق متر في متر، ومركزه على ارتفاع نصف متر حتى يقف على الأرض لا أن يغوص فيها، لأن نقطة الأصل في المجسمات الجاهزة في مركزها.
- البلاط: الخامة تكرر صورة البلاط ست مرات في كل اتجاه بالخاصية
uv1_scale، فتغطي الصورة الواحدة مترين من الأرضية، وسوف نعود إلى ذلك في قسم UV.
والمختبر يعمل في Docker على صورة Godot 4.7.2 الرسمية نفسها التي استخدمناها في المرحلة السابقة، وأضفنا إليها حزمة mesa-vulkan-drivers. والسبب أن العارض الافتراضي للمشاريع ثلاثية الأبعاد Forward+ يحتاج Vulkan، والـ Container لا يوجد فيه كرت شاشة، فترسم مكتبة Mesa بالمعالج نفسه: الجزء المسمى lavapipe ينفذ Vulkan، والجزء المسمى llvmpipe ينفذ OpenGL للعارض Compatibility. وهذا أول سطر يطبعه المختبر:
Vulkan 1.3.230 - Forward+ - Using Device #0: Unknown - llvmpipe (LLVM 15.0.6, 256 bits)
Godot 4.7.2-stable (official) | renderer: forward_plus | llvmpipe (LLVM 15.0.6, 256 bits) 1.3.230 | display: X11والصور في هذا المقال إطارات رسمها المحرك فعلاً بهذه الطريقة، ثم حفظها السكربت بالدالة get_viewport().get_texture().get_image()، فهي ما يراه اللاعب بالضبط، لا لقطة من المحرر. ولأن الرسم يحدث على المعالج، فإن رسم الإطار الأول يأخذ ثواني بدل أجزاء من الثانية، وأغلبها في ترجمة برامج الرسم Shaders لأول مرة، ولكن هذا لا يغير ما يرسم ولا العدادات التي سنقرؤها، فعدد المثلثات وأوامر الرسم هو نفسه على أي كرت شاشة. وهذا هو الفناء كاملاً بالشمس وظلها والفانوس:

المجسم Mesh من الداخل: رؤوس ومثلثات
المجسم في Godot مورد Resource يحتوي سطحاً Surface واحداً أو أكثر، وكل سطح مجموعة مصفوفات Arrays بالطول نفسه، والعنصر رقم 5 في كل مصفوفة يخص الرأس رقم 5. والمصفوفات التي ستقابلها دائماً أربع:
- المواضع ARRAY_VERTEX: نقطة لكل رأس، بالمتر، في إحداثيات الجسم نفسه.
- العموديات ARRAY_NORMAL: متجه طوله واحد لكل رأس، يقول في أي اتجاه ينظر السطح عند هذا الرأس، والضوء يحسب منه، فالسطح الذي ينظر نحو الشمس مضيء والذي يعطيها ظهره مظلم.
- إحداثيات الخامة ARRAY_TEX_UV: نقطة ثنائية الأبعاد لكل رأس بين 0 و1 غالباً، تقول أي نقطة من الصورة تلصق على هذا الرأس.
- الفهارس ARRAY_INDEX: اختيارية، وهي أرقام الرؤوس ثلاثة ثلاثة، وكل ثلاثة منها مثلث. ودونها يكون كل ثلاثة رؤوس متتالية مثلثاً.
والتجربة mesh تطبع هذه المصفوفات لأول وجه من الخيمة، ثم تعد الرؤوس والمثلثات في الخيمة وفي المجسمات الجاهزة في Godot بإعداداتها الافتراضية، والمخرج كان كما يلي:
the tent, face 1 (three vertices: position | normal | uv):
v0 (-1.0, 0.0, 1.0) | (0.0, 0.555, 0.832) | (0.0, 1.0)
v1 (0.0, 1.5, 0.0) | (0.0, 0.555, 0.832) | (0.5, 0.0)
v2 (1.0, 0.0, 1.0) | (0.0, 0.555, 0.832) | (1.0, 1.0)
tent (SurfaceTool, 6 faces) vertices 18 indices 0 triangles 6 normals yes uv yes
tent with index() vertices 18 indices 18 triangles 6 normals yes uv yes
the same face with generate_normals() default smoothing:
v0 normal (-0.704, 0.093, 0.704)
v1 normal (0.0, 1.0, 0.0)
v2 normal (0.564, -0.604, 0.564)
BoxMesh (default) vertices 24 indices 36 triangles 12 normals yes uv yes
PlaneMesh (default) vertices 4 indices 6 triangles 2 normals yes uv yes
CylinderMesh (default) vertices 522 indices 2304 triangles 768 normals yes uv yes
SphereMesh (default 64x32) vertices 2210 indices 12672 triangles 4224 normals yes uv yes
SphereMesh (16x8) vertices 170 indices 864 triangles 288 normals yes uv yes
AABB of the tent: [P: (-1.0, 0.0, -1.0), S: (2.0, 1.5, 2.0)]والقراءة كما يلي:
- الوجه الأول من الخيمة: ثلاثة رؤوس، اثنان على الأرض عند z=1 والثالث في القمة على ارتفاع 1.5 متر، والثلاثة لها العمودي نفسه (0, 0.555, 0.832)، أي أن هذا الوجه ينظر إلى الأمام (+Z) ويميل إلى الأعلى. وإحداثيات UV تأخذ مثلثاً من الصورة: الزاويتان السفليتان والمنتصف الأعلى.
- 18 رأساً لستة مثلثات: للخيمة خمس نقاط فقط، أربع زوايا وقمة، فلماذا 18؟ لأن الرأس في المجسم ليس نقطة في الفضاء فقط، وإنما نقطة مع عمودي ومع UV، والقمة تشترك فيها أربعة وجوه لكل منها عمودي مختلف، فهي أربعة رؤوس لا رأس واحد. ولذلك لم يوفر الأمر
index()أي رأس هنا، فكل الرؤوس مختلفة بعموديها، وإنما أضاف قائمة فهارس فقط. - المكعب 24 رأساً لا 8: للسبب نفسه، فكل زاوية تشترك فيها ثلاثة أوجه بثلاثة عموديات، و8 في 3 تساوي 24. والحواف الحادة في أي نموذج تكلف رؤوساً إضافية، وهذا مهم عندما تقرأ عدد الرؤوس في نموذج من Blender فتجده في Godot أكبر مما توقعت.
- الكرة الافتراضية 4,224 مثلثاً: وهي 64 قطعة حول المحور و32 حلقة، وتكفي لكرة تملأ الشاشة. أما كرة صغيرة بعيدة فتكفيها 16 في 8، أي 288 مثلثاً، وهو أقل بخمس عشرة مرة. والعمود الافتراضي 768 مثلثاً لأسطوانة لا يرى أحد تفاصيلها. ولذلك لا تترك الإعدادات الافتراضية للمجسمات الجاهزة عندما تكررها مئات المرات، وهو ما سنقيسه في مقال الأداء.
- الصندوق المحيط AABB: أصغر صندوق يحيط بالمجسم، يبدأ عند (-1, 0, -1) وحجمه 2 في 1.5 في 2. والمحرك يستخدمه ليعرف بسرعة هل الجسم داخل نظر الكاميرا أم لا، قبل أن ينظر إلى أي مثلث فيه.
بناء مجسم بيدك: SurfaceTool
الخيمة ليست مجسماً جاهزاً، وإنما بنيناها بالأداة SurfaceTool، وهي بحسب توثيق SurfaceTool مساعد لبناء المجسمات رأساً رأساً، تحدد فيه خصائص الرأس التالي ثم تضيف موضعه، ومعه دوال لتوليد العموديات والفهارس. والتوثيق ينبه إلى نقطة مهمة: Godot يعتبر الوجه أمامياً إذا كانت رؤوسه بترتيب عقارب الساعة Clockwise كما تراها من الأمام. وهذه الدالة كما هي في المختبر:
func pyramid(mode := "ok") -> ArrayMesh:
var a := Vector3(-1, 0, -1)
var b := Vector3(1, 0, -1)
var c := Vector3(1, 0, 1)
var d := Vector3(-1, 0, 1)
var top := Vector3(0, 1.5, 0)
var faces := [[d, top, c], [c, top, b], [b, top, a], [a, top, d], [a, d, c], [a, c, b]] # clockwise seen from outside
var st := SurfaceTool.new()
st.begin(Mesh.PRIMITIVE_TRIANGLES)
if mode != "smooth":
st.set_smooth_group(-1) # -1 = flat: every face keeps its own normal. Without this line generate_normals() averages them.
for f in faces:
var tri: Array = f.duplicate()
if mode == "reversed":
tri.reverse()
var uvs := [Vector2(0, 1), Vector2(0.5, 0), Vector2(1, 1)]
for i in 3:
if mode != "no-uv":
st.set_uv(uvs[i])
st.add_vertex(tri[i])
if mode == "indexed":
st.index() # merge identical vertices (same position, normal and uv), so faces share them
if mode != "no-normals":
st.generate_normals() # one normal per vertex, from the faces that use it
return st.commit()في الكود أعلاه لاحظ التالي:
- ستة وجوه: أربعة جوانب مثلثة، والقاعدة المربعة مثلثان. وكل وجه مكتوب بترتيب عقارب الساعة كما تراه من خارج الخيمة.
- الدالة
set_uvقبلadd_vertex: الخصائص تحدد أولاً، ثم يضاف الموضع فيأخذ آخر خصائص حددتها، وهذا ترتيب SurfaceTool في كل شيء. - المعامل
mode: نفس الدالة تصنع الخيمة الصحيحة، أو خيمة بلا عموديات، أو بوجوه معكوسة، أو بعموديات منعمة، أو بلا UV، وهذا ما نحتاجه للتجارب التالية. - السطر
set_smooth_group(-1): لم يكن في النسخة الأولى من الدالة، وسوف ترى في القسم التالي ماذا حدث دونه.
والتوثيق ينبه أيضاً إلى أن بناء المجسمات بالكود مناسب للأشكال الثابتة التي لا تتغير كثيراً، لأن إنشاء مصفوفات الرؤوس وإرسالها إلى كرت الشاشة له تكلفة كبيرة، فلا تبني مجسماً من جديد في كل إطار. وفي الألعاب الحقيقية تأتي أغلب المجسمات من برنامج نمذجة مثل Blender، وأما SurfaceTool فلشيء تولده اللعبة نفسها: أرض من خريطة ارتفاعات، أو طريق يتبع منحنى، أو مثل هنا، شكل بسيط تريد أن تفهم مكوناته.
العمودي Normal واتجاه الوجه: أربع خيام
في أول تشغيل للدالة لم يكن فيها السطر set_smooth_group(-1)، وكانت الخيمة «الصحيحة» تبدو كأنها مصنوعة من القماش المنفوخ، بحواف ناعمة لا تشبه الهرم. وعندما طبعنا العموديات وجدنا أن رأس القاعدة الأيمن في الوجه الأمامي عموديه (0.564, -0.604, 0.564)، أي أنه ينظر إلى الأسفل، وهذا مستحيل لوجه يميل إلى الأعلى. والسبب كما يشرح التوثيق أن generate_normals() تأخذ مجموعات التنعيم Smooth Groups في حسابها، وكل رأس يأخذ افتراضياً المجموعة 0، فتتجمع الرؤوس التي في الموضع نفسه ويأخذ كل منها متوسط عموديات الوجوه التي تلتقي عنده، ومنها القاعدة التي تنظر إلى الأسفل. وهذا مناسب للكرة، وخاطئ تماماً للهرم والصندوق، ولذلك تحتاج القيمة -1 قبل إضافة الرؤوس لتحصل على عموديات مسطحة Flat.
ثم جعلنا من هذا الخطأ تجربة: التجربة normals ترسم أربع خيام بالخامة الحمراء نفسها والضوء نفسه، والفرق بينها في المجسم فقط:

والقراءة من اليمين كما يلي:
- بلا عموديات: الخيمة لون واحد مسطح، كأنها قص من ورق، لأن المحرك لا يعرف اتجاه أي وجه فيحسب الضوء كأن كل الوجوه تنظر في الاتجاه نفسه. وهذا ما تراه عندما يصدر نموذج من برنامج نمذجة دون عموديات، أو عندما تبني مجسماً بالكود وتنسى
generate_normals(). - بوجوه معكوسة: الوجه الأمامي اختفى، وترى من خلاله ظهر الوجه الخلفي من الداخل. والسبب أن ترتيب الرؤوس عكس عقارب الساعة، فأصبح كل وجه «ظهراً» في نظر المحرك، وحذفه كرت الشاشة في مرحلة حذف الوجوه الخلفية. ولاحظ أن العموديات نفسها انعكست، لأن
generate_normals()تحسبها من ترتيب الرؤوس، فهي تنظر إلى داخل الخيمة. وهذا الخطأ يظهر في النماذج المستوردة عندما تعكس الحجم بقيمة سالبة، مثل -1 على محور واحد، ولا تطبقه. - بعموديات منعمة: الشكل صحيح، ولكن الضوء ينزلق على الحواف كأنها منحنية، وعلى الخيمة لمعة في غير مكانها. وهي الخيمة التي ظهرت لنا في أول تشغيل.
- الصحيحة: كل وجه بلون واحد، والحافة بين وجهين حادة، لأن لكل وجه عموديه.
cull_mode على Disabled مؤقتاً: إذا ظهرت الأجزاء المفقودة فالمشكلة في ترتيب الرؤوس أو في حجم سالب، لا في المجسم نفسه. ثم أعده إلى Back بعد الإصلاح، لأن رسم الوجهين يضاعف عمل كرت الشاشة على كل مثلث.إحداثيات الخامة UV: الصورة على السطح
الصورة التي تلصقها على المجسم مستطيل ثنائي الأبعاد، والمجسم ثلاثي الأبعاد، والجسر بينهما هو UV: لكل رأس نقطة على الصورة، والمحرك يملأ المثلث بما بين النقاط الثلاث من الصورة. واسم UV جاء لأن X وY مستخدمان للموضع، فاختاروا حرفين آخرين. والتجربة uv تستخدم صورة البلاط نفسها على ثلاثة أشياء، وصورة البلاط فيها علامة حمراء في الزاوية العليا اليسرى من الصورة عن قصد، حتى ترى أين وقعت الزاوية وهل تمدد البلاط:

ومخرج التجربة كان كما يلي:
tent without UV vertices 18 indices 0 triangles 6 normals yes uv no
BoxMesh 4 x 1.2 x 0.4 m: UV range of the six faces together (0.0, 0.0) .. (1.0, 1.0)
3 objects objects 3 primitives 30 draw calls 3 | shadow pass: objects 0 primitives 0 draw calls 0والقراءة كما يلي:
- الخيمة بلا UV: لا توجد مصفوفة UV، فكل الرؤوس تقرأ النقطة (0, 0) من الصورة، أي بكسلاً واحداً، فيصبح المجسم كله بلونه. وهذا ما تراه عندما يصدر نموذج لم يفك له أحد إحداثياته في Blender، والعلاج هناك بفك الإحداثيات UV Unwrapping، لا في Godot.
- الجدار بإحداثيات BoxMesh الافتراضية: كل الأوجه الستة معاً تأخذ المدى من 0 إلى 1، والمجسم الجاهز يوزعها على الصورة في شبكة من ثلاثة في اثنين، فكل وجه يأخذ جزءاً من الصورة مهما كان طوله. وجدار طوله 4 أمتار وارتفاعه 1.2 متر يأخذ القطعة نفسها التي يأخذها مكعب صغير، فتتمدد البلاطات وتتضخم العلامة الحمراء.
- الجدار بإسقاط Triplanar: الخامة تتجاهل UV المجسم، وتسقط الصورة من المحاور الثلاثة على حسب اتجاه كل وجه، ومع الإعداد
uv1_world_triplanarتحسب من إحداثيات العالم لا من إحداثيات الجسم، فتبقى البلاطة مترين مهما طال الجدار أو كبر حجمه. وهذا هو الحل المعتاد للجدران والأرضيات والصخور التي لا تريد أن تفك لها UV بيدك، وثمنه حساب أكثر في معالج البكسل، لأن كل بكسل يقرأ الصورة ثلاث مرات.
ولاحظ أن الأرضية في الفناء حلت مشكلتها بطريقة ثالثة، وهي uv1_scale: الأرضية مستوى واحد، فضربنا UV في 6 فتكررت الصورة ست مرات في كل اتجاه. وهذا يكفي للأسطح المسطحة، ولكنه لا يصلح للجدار المستطيل، لأن الضرب في رقم واحد لا يصلح الفرق بين طوله وارتفاعه. ولذلك القاعدة: إذا كان المجسم من Blender ففك UV هناك بالمقياس الذي تريده، وإذا كان مجسماً جاهزاً بسيطاً فاستخدم uv1_scale للمستوى، وTriplanar لما سواه.
الخامة Material وطريقة PBR
الخامة تخبر معالج البكسل كيف يتعامل السطح مع الضوء. والخامة التي تستخدمها في أغلب الأحوال في Godot هي StandardMaterial3D، وهي تتبع طريقة الرسم المبني على الفيزياء Physically Based Rendering واختصاراً PBR، أي أنها تصف المادة بخصائص فيزيائية، وتترك للمحرك أن يحسب شكلها تحت أي ضوء. والفائدة العملية أن الخامة التي ضبطتها في النهار تبقى صحيحة في الليل وتحت الفانوس، دون أن تعدلها لكل مشهد. والخصائص الأساسية ثلاث:
- اللون الأساسي Albedo: لون السطح دون أي ضوء أو انعكاس، لوناً واحداً أو صورة.
- المعدنية Metallic: بحسب توثيق StandardMaterial3D هي مقدار ما يعكسه السطح، وكلما زادت قل أثر الضوء المنتشر والضوء المحيط وزاد الانعكاس، والتوثيق يذكر أن أقل انعكاس داخلي 0.04، فلا توجد مادة لا تعكس شيئاً كما في الواقع. وفي العمل اليومي تكون القيمة إما 0 للخشب والجص والقماش والبلاستيك، أو 1 للمعادن، والقيم بينهما نادرة.
- الخشونة Roughness: القيمة 0 مرآة كاملة، و1 تنشر الانعكاس تماماً، وأغلب المواد بين 0.3 و0.9.
والتجربة pbr ترسم 25 كرة باللون البرتقالي نفسه، كل صف بمعدنية مختلفة من 0 في الأعلى إلى 1 في الأسفل، وكل عمود بخشونة مختلفة من 0 على اليسار إلى 1 على اليمين:

ولاحظ في الصورة أمرين. الأول أن الكرات المعدنية في الصف الأسفل ليست برتقالية، وإنما داكنة بلون ما تعكسه من الأرض والسماء، ولونها الأساسي يلون الانعكاس فقط. وهذا يشرح الكرة النحاسية السوداء في أول المقال: المعدن لا يضيء بالضوء المنتشر، وإنما بما يعكسه، فإذا لم يكن حوله شيء يعكسه، لا سماء ولا ضوء، كان أسود. والثاني أن الخشونة تحول نقطة الضوء الحادة على اليسار إلى بقعة واسعة باهتة على اليمين، ثم تختفي.
وطبعت التجربة عدادات الرسم مرتين، مرة وكل كرة لها خامتها، ومرة بعد أن أعطينا الكرات الخمس والعشرين خامة واحدة مشتركة:
25 spheres, 25 materials objects 25 primitives 105600 draw calls 25 | shadow pass: objects 0 primitives 0 draw calls 0
25 spheres, 1 material objects 25 primitives 105600 draw calls 1 | shadow pass: objects 0 primitives 0 draw calls 0الأجسام 25 في الحالتين، والمثلثات 105,600، أي 25 في 4,224، ولكن أوامر الرسم Draw Calls نزلت من 25 إلى 1. وأمر الرسم هو طلب يرسله المعالج إلى كرت الشاشة: ارسم هذا المجسم بهذه الخامة، ولكل أمر تكلفة على المعالج قبل أن يبدأ كرت الشاشة عمله. والسبب في النزول أن العارض Forward+ يجمع تلقائياً العقد التي تستخدم المجسم نفسه والخامة نفسها في أمر رسم واحد، ويسمي توثيق أداء 3D ذلك التكرار التلقائي Automatic Instancing، ويذكر أنه في Forward+ فقط، وأنه لا يعمل مع الخامات الشفافة بالمزج Alpha Blending. فإذا كان عندك مئة صندوق متشابه، فلا تنشئ لكل صندوق خامة جديدة بالكود كما فعلنا في الكرات، وإنما اجعل الخامة موردا واحداً تشترك فيه.
وفي StandardMaterial3D خصائص أخرى ستحتاجها قريباً: صورة العموديات Normal Map التي تضيف تفاصيل صغيرة دون مثلثات إضافية، والانبعاث Emission الذي جعل زجاج الفانوس يضيء في الفناء، والشفافية Transparency، والإعداد cull_mode الذي ذكرناه. وإذا احتجت شيئاً لا تقدمه، مثل أوراق نخل تتحرك مع الريح، فتكتب معالجاً خاصاً بك في ShaderMaterial، كما سنفعل في مقال الأداء.
الأضواء Lights والظلال Shadows
في Godot ثلاثة أنواع من الأضواء، ويشرحها توثيق الأضواء والظلال:
- الضوء الاتجاهي DirectionalLight3D: الشمس أو القمر: أشعة متوازية تصل إلى كل مكان في المشهد بالقوة نفسها، وموضع العقدة لا يهم، وإنما دورانها.
- الضوء النقطي OmniLight3D: مصباح أو فانوس: ينتشر في كل الاتجاهات من نقطة، ويضعف مع المسافة حتى المدى
omni_range. - الضوء الموجه SpotLight3D: كشاف أو ضوء سيارة: مخروط من نقطة في اتجاه واحد.
والتجربة lights ترسم الفناء أربع مرات: بلا أي ضوء ولا بيئة، ثم بشمس وسماء دون ظلال، ثم بالظلال، ثم في المغرب بشمس منخفضة برتقالية وسماء خافتة وضوء الفانوس بظلاله:

وهذه عدادات المحرك لكل حالة، وفيها قسمان: ما رسم للكاميرا، وما رسم لخرائط الظلال Shadow Maps:
no-light objects 8 primitives 9260 draw calls 7 | shadow pass: objects 0 primitives 0 draw calls 0
sun objects 8 primitives 9260 draw calls 7 | shadow pass: objects 0 primitives 0 draw calls 0
sun-shadow objects 8 primitives 9260 draw calls 7 | shadow pass: objects 18 primitives 18534 draw calls 18
dusk objects 8 primitives 9260 draw calls 7 | shadow pass: objects 11 primitives 9280 draw calls 11في المخرج أعلاه لاحظ التالي:
- ثمانية أجسام وسبعة أوامر رسم: الجداران يستخدمان المجسم نفسه والخامة نفسها، فجمعهما التكرار التلقائي في أمر واحد كما رأينا في الكرات.
- بلا ضوء: لم يتغير شيء في العدادات، ولكن الصورة باهتة والكرة النحاسية سوداء. والسبب أن المشهد ليس فيه WorldEnvironment ولا ضوء، ويوضح توثيق البيئة أن المحرر في هذه الحالة يعرض سماء وشمساً للمعاينة فقط، وأنها لا تظهر في اللعبة عند تشغيلها. وهذا بالضبط سبب الكرة التي كانت ذهبية في المحرر وسوداء في اللعبة: المحرر كان يجمل لك المشهد بسماء غير موجودة فيه.
- الظلال لها ثمن: تفعيل ظل الشمس لم يغير ما يرسم للكاميرا، ولكنه أضاف 18 أمر رسم و18,534 مثلثاً في رسم الظلال، أي ضعف مثلثات المشهد كله. والسبب أن ظل الشمس افتراضياً مقسم إلى أربعة أجزاء بحسب البعد عن الكاميرا، ويسمى ذلك PSSM، والتوثيق يذكر أن الجسم الكبير الذي يقع في الأجزاء الأربعة يرسم خمس مرات: مرة لكل جزء ومرة للصورة النهائية. والأرضية والجداران تمتد في الأجزاء كلها، فرسمت في كل جزء.
- المغرب: رسم الظلال 11 أمراً، أقل من الشمس وحدها رغم أن في المشهد ضوءين بظلال. والعدد لا يتبع عدد الأضواء، وإنما عدد الأجسام التي تقع داخل كل خريطة ظل: الشمس هنا في زاوية أخرى فتقع الأجسام في أجزاء أقل، والفانوس مداه سبعة أمتار فقط، فلا يدخل في ظله إلا ما حوله. ولذلك لا تحكم على تكلفة الظل من الإعدادات، وإنما من العداد.
والدرس العملي من هذه الأرقام: كل ضوء بظل يرسم جزءاً من المشهد مرة أخرى على الأقل، ولذلك لا تفعل الظلال في كل ضوء. والقاعدة التي يتبعها أغلب المطورين: الشمس بظلها، والأضواء الصغيرة بلا ظلال إلا القريب منها والمهم للمشهد، ومدى الظل في الشمس بأقصر مسافة يقبلها المشهد من الخاصية directional_shadow_max_distance، فكلما قصرت كانت الظلال القريبة أوضح والأجسام الداخلة فيها أقل.
shadow_bias وshadow_normal_bias في الضوء نفسه بخطوات صغيرة، فالأولى تقلل الخطوط وكثيرها يفصل الظل، والثانية تعالج الأسطح المائلة.الكاميرا Camera3D: زاوية الرؤية والإسقاط
الكاميرا هي التي تحدد أي جزء من العالم يصبح صورة، ولها في توثيق Camera3D خصائص كثيرة، وأهمها أربع:
- زاوية الرؤية
fov: بالدرجات، وهي في Godot الزاوية العمودية افتراضياً، وقيمتها 75. كلما كبرت رأيت أكثر من العالم، وصغرت الأجسام وتشوهت أطراف الصورة. - نوع الإسقاط
projection: منظوري Perspective، وفيه يصغر البعيد كما في العين، أو متعامد Orthogonal، وفيه يبقى الحجم واحداً مهما بعد الجسم، كما في ألعاب الإستراتيجية والمخططات الهندسية. - أقرب مسافة
nearوأبعد مسافةfar: ما هو أقرب من الأولى أو أبعد من الثانية لا يرسم، والقيمتان تحددان دقة ذاكرة العمق كما سنرى.
والتجربة camera ترسم الفناء من الموضع نفسه بثلاث زوايا رؤية، ثم بإسقاط متعامد:

وهذه العدادات لكل حالة:
fov 35 objects 8 primitives 9260 draw calls 7 | shadow pass: objects 15 primitives 14292 draw calls 15
fov 75 objects 8 primitives 9260 draw calls 7 | shadow pass: objects 18 primitives 18534 draw calls 18
fov 110 objects 8 primitives 9260 draw calls 7 | shadow pass: objects 28 primitives 32030 draw calls 27
orthogonal size 10 objects 8 primitives 9260 draw calls 7 | shadow pass: objects 8 primitives 9260 draw calls 7ما يرسم للكاميرا لم يتغير، فالفناء كله داخل الصورة في الحالات الأربع، ولكن رسم الظلال تغير من 15 أمراً إلى 27. والسبب أن أجزاء ظل الشمس الأربعة تقسم المنطقة التي تراها الكاميرا، فكلما اتسعت الزاوية اتسعت المنطقة، ووقعت أجسام أكثر في أكثر من جزء. ولذلك لا تختر زاوية رؤية واسعة لأنها تبدو أجمل في المحرر، فهي تكلف في الظلال قبل أي شيء آخر. وفي الإسقاط المتعامد انخفض رسم الظلال إلى 7، ولكن ظهرت على الأرضية قرب الجدار خطوط ظل متكررة، وهي ظاهرة Shadow Acne التي ذكرناها، لأن إعدادات الظل الافتراضية مضبوطة للإسقاط المنظوري، فإذا اخترت المتعامد للعبتك فاضبط shadow_bias في الشمس معه.
سطحان في المكان نفسه: Z-fighting
ذاكرة العمق Depth Buffer تحفظ لكل بكسل بعد أقرب سطح رسم فيه، ويذكر توثيق حدود الرسم 3D أن دقتها محدودة، 32 بت على سطح المكتب و24 على الجوال، وأنه إذا وقع سطحان على القيمة نفسها حدث ما يسمى Z-fighting: يتناوب السطحان على البكسل، فترى خطوطاً وتمزقاً يرتجف كلما تحركت الكاميرا. والمثال الكلاسيكي سجادة على أرضية، أو ملصق على جدار، أو طريق على أرض. والتجربة zfight تضع سجادة حمراء طولها 18 متراً على أرضية كبيرة بأربع طرق: على الأرضية تماماً، ثم مرفوعة سنتيمتراً، ثم مرفوعة سنتيمتراً مع كاميرا near فيها جزء من الألف من المتر وfar مئة كيلومتر، ثم مرفوعة مليمتراً واحداً. وشغلناها بالعارضين Forward+ وCompatibility:

والقراءة كما يلي:
- على الأرضية تماماً: في Forward+ ظهر تمزق قطري في السجادة يظهر منه لون الأرضية، وخطوط متقطعة قرب حافتها. وفي Compatibility بدت السجادة سليمة في هذا الإطار بالذات، ولا تعتمد على ذلك، فالنتيجة تتغير مع زاوية الكاميرا وكرت الشاشة، والسطحان في المكان نفسه خطأ في المشهد لا في العارض.
- مرفوعة سنتيمتراً أو حتى مليمتراً: اختفى التداخل في العارضين، على مسافة تصل إلى أكثر من عشرين متراً من الكاميرا. وهذا هو الحل الذي يقترحه التوثيق: أبعد السطحين قليلاً بقدر لا يلاحظه اللاعب. وللملصقات على الجدران والأرضيات في Godot عقدة خاصة اسمها Decal ترسم الصورة على السطح الذي تحتها دون سطح ثان أصلاً.
- مع
nearصغيرة جداً وfarكبيرة جداً: لم ترسم الأرضية ولا السجادة في العارضين، وطبع المحرك أربع مرات الخطأCondition "!res" is trueدون أي شرح. والنسبة بين المسافتين هنا مئة مليون، وهذا أبعد كثيراً مما تحتمله الحسابات. ويوضح التوثيق أن رفعnearهو أهم ما يحسن دقة العمق، أكثر من خفضfar، ولذلك القيمة الافتراضية 0.05 متر مناسبة لأغلب الألعاب، ولا تخفضها إلا إذا رأيت الكاميرا تقص جسماً قريباً منها.
البيئة Environment: السماء والضوء المحيط وتحويل الألوان
العقدة WorldEnvironment تحمل مورداً من نوع Environment، وهو كل ما يحيط بالمشهد ولا يخص جسماً بعينه: الخلفية، والضوء المحيط Ambient Light الذي يصل إلى الظل فلا يصبح أسود، والانعكاسات التي تأخذها المعادن من السماء، وتحويل الألوان Tonemapping، والضباب Fog والتوهج Glow. ويشرحها توثيق البيئة والمعالجة اللاحقة. والسماء في المختبر من نوع ProceduralSkyMaterial، أي سماء يحسبها المحرك من ألوان وزوايا دون صورة، وهذه الدالة التي تضيفها:
func sky_env(tonemap := Environment.TONE_MAPPER_AGX, energy := 1.0) -> WorldEnvironment:
var sky_mat := ProceduralSkyMaterial.new()
var sky := Sky.new()
sky.sky_material = sky_mat
var env := Environment.new()
env.background_mode = Environment.BG_SKY
env.sky = sky
env.ambient_light_source = Environment.AMBIENT_SOURCE_SKY
env.reflected_light_source = Environment.REFLECTION_SOURCE_SKY
env.tonemap_mode = tonemap
env.background_energy_multiplier = energy
var we := WorldEnvironment.new()
we.environment = env
world.add_child(we)
return weوالتجربة env ترسم الفناء بالشمس وظلها أربع مرات: دون بيئة، ثم بسماء مع تحويل ألوان خطي Linear، ثم بسماء مع AgX، ثم مع الضباب والتوهج:

والعدادات في الحالات الأربع واحدة: 7 أوامر رسم للكاميرا و18 للظلال، فالبيئة لا تضيف أجساماً، وإنما عملاً على كل بكسل. وفي الصور لاحظ التالي:
- دون بيئة: الكرة النحاسية سوداء مرة أخرى رغم وجود الشمس، لأن المعدن يأخذ لونه من الانعكاس، ولا توجد سماء يعكسها، والظلال قاتمة لأنه لا يوجد ضوء محيط يصلها. وهذا هو الإطار الذي يراه اللاعب إذا اعتمدت على سماء المعاينة في المحرر.
- Linear مقابل AgX: تحويل الألوان يقرر كيف تتحول القيم الكبيرة من الضوء إلى ألوان تستطيع الشاشة عرضها. والخطي لا يغير شيئاً، فتظهر الأجزاء الساطعة مشبعة أو بيضاء تماماً، ويصف التوثيق AgX بأنه منحنى يشبه الأفلام، يخفف تشبع الألوان الساطعة ويحافظ على درجتها أفضل من غيره، مع ملاحظة أنه أبطأ الخيارات. والفرق في الصورة واضح في الجدار الأيمن.
- الضباب والتوهج: كثافة الضباب 0.02 كافية لتخفي السماء خلف 50 متراً تقريباً، وهذا كثير لفناء صغير، ومفيد لعالم مفتوح تريد أن تخفي فيه حدود الرسم البعيدة.
ثلاث طرق للرسم: Forward+ وMobile وCompatibility
في Godot 4 ثلاث عارضات Renderers، ويشرحها توثيق العارضات: Forward+ الأكثر تقدماً، وهو لسطح المكتب فقط ويحتاج Vulkan أو Direct3D 12 أو Metal، وMobile بميزات أقل وأسرع في المشاهد البسيطة، وهو الافتراضي على الجوال، وCompatibility الأقل ميزات، ويعمل على OpenGL ويدعم أكبر عدد من الأجهزة، وهو الخيار الوحيد للويب، كما رأينا في مقال التصدير إلى الويب والجوال وسطح المكتب. والتوثيق يذكر أن الانتقال بين Forward+ وMobile يحتاج تعديلات أقل من الانتقال بين أي منهما وCompatibility. ورسم المختبر الفناء نفسه بالعارضين Forward+ وCompatibility، والعدادات كانت كما يلي:
Godot 4.7.2-stable (official) | renderer: forward_plus | llvmpipe (LLVM 15.0.6, 256 bits) 1.3.230 | display: X11
courtyard objects 8 primitives 9260 draw calls 7 | shadow pass: objects 18 primitives 18534 draw calls 18
mesh instances: 8, lights: sun + lantern (both with shadows)
video memory used: 132.6 MB
Godot 4.7.2-stable (official) | renderer: gl_compatibility | llvmpipe (LLVM 15.0.6, 256 bits) 4.5 (Core Profile) Mesa 22.3.6 | display: X11
courtyard objects 26 primitives 9260 draw calls 32 | shadow pass: objects 0 primitives 18534 draw calls 0
mesh instances: 8, lights: sun + lantern (both with shadows)
video memory used: 11.4 MBفي المخرج أعلاه لاحظ التالي:
- أوامر الرسم: 7 في Forward+ و32 في Compatibility للمشهد نفسه. والسبب أن Compatibility لا يجمع الأجسام المتشابهة تلقائياً، وأنه يرسم الجسم الذي يصله أكثر من ضوء مرة لكل ضوء إضافي، فالجسم الذي يضيئه الفانوس والشمس يرسم مرتين، ولذلك عد 26 جسماً بدل 8.
- رسم الظلال: عد Compatibility المثلثات نفسها، 18,534، ولكنه لا يملأ عدادات الأجسام والأوامر لهذا القسم، فلا تقارن العارضين بهذه الأرقام وحدها.
- ذاكرة الرسم: 132.6 ميجابايت في Forward+ مقابل 11.4 في Compatibility، لأن الأول يحجز مخازن لمؤثراته المتقدمة حتى لو لم تستخدمها.
وفي الصورة فرق آخر أهم: ضوء الفانوس في Compatibility أقوى بكثير، يغمر الجدار الأيمن والأرضية بلون أصفر، بينما هو في Forward+ هالة صغيرة. والإعدادات واحدة، ولكن العارضين لا يحسبان الضوء والألوان بالطريقة نفسها. ولذلك اختر العارض في أول يوم من مشروعك، واضبط الإضاءة عليه، لأن تغييره لاحقاً يعني أن تعيد ضبط كل مشهد.

اقرأ ما يقوله المحرك: عدادات الرسم
كل الأرقام في هذا المقال جاءت من مكانين في المحرك، وتستطيع أن تقرأهما في لعبتك أنت. الأول الدالة get_render_info في كل Viewport، وهي بحسب توثيق Viewport تعطي عدد الأجسام والمثلثات وأوامر الرسم في آخر إطار، لكل نوع من المرور: ما رسم للكاميرا، وما رسم للظلال، وما رسم للواجهة ثنائية الأبعاد. وهذه الدالة التي طبعت كل الأسطر التي رأيتها:
func info(tag: String) -> void:
var vp := get_viewport()
var v := func(t: int, w: int) -> int: return vp.get_render_info(t, w)
print("%-22s objects %3d primitives %6d draw calls %3d | shadow pass: objects %3d primitives %6d draw calls %3d" % [tag,
v.call(Viewport.RENDER_INFO_TYPE_VISIBLE, Viewport.RENDER_INFO_OBJECTS_IN_FRAME),
v.call(Viewport.RENDER_INFO_TYPE_VISIBLE, Viewport.RENDER_INFO_PRIMITIVES_IN_FRAME),
v.call(Viewport.RENDER_INFO_TYPE_VISIBLE, Viewport.RENDER_INFO_DRAW_CALLS_IN_FRAME),
v.call(Viewport.RENDER_INFO_TYPE_SHADOW, Viewport.RENDER_INFO_OBJECTS_IN_FRAME),
v.call(Viewport.RENDER_INFO_TYPE_SHADOW, Viewport.RENDER_INFO_PRIMITIVES_IN_FRAME),
v.call(Viewport.RENDER_INFO_TYPE_SHADOW, Viewport.RENDER_INFO_DRAW_CALLS_IN_FRAME)])والمكان الثاني هو المفرد Performance، وفيه المجاميع نفسها لكل النوافذ مع أرقام الزمن والذاكرة، مثل Performance.RENDER_VIDEO_MEM_USED الذي طبع ذاكرة الرسم. وفي المحرر تجد هذه الأرقام نفسها في لوحة Debugger ثم Monitors وأنت تشغل اللعبة، ورسماً بيانياً لكل منها. والقاعدة: عندما يبطئ مشهد ثلاثي الأبعاد، انظر إلى هذه الأرقام قبل أن تغير أي شيء، فهي تقول لك هل المشكلة في عدد الأجسام، أو في عدد المثلثات، أو في الظلال. وهذا بالضبط موضوع مقال الأداء في هذه المرحلة، حيث نبني بستاناً من آلاف النخيل بطيئاً عن قصد، ثم نصلحه خطوة خطوة بهذه الأرقام.
ملفات المختبر وتشغيله
المختبر كله في مجلد lab: الملف Dockerfile ينزل Godot 4.7.2 الرسمي من صفحة الإصدار ويتحقق منه بالبصمة SHA512، ويضيف Xvfb ومكتبة Mesa بجزأيها، والمجلد game فيه المشروع: project.godot، والمشهد الرئيسي الذي يضيف عقدة المختبر، والسكربت lab.gd الذي يبني كل شيء. والملف run.sh يشغل التجارب بالترتيب ويحفظ مخرج كل منها في ملف out-*.txt والإطارات في shots، وهذه الدالة التي يشغل بها كل تجربة:
# --init: Godot runs under a small init process, so the container stops cleanly when Godot quits.
lab() { MSYS_NO_PATHCONV=1 timeout 600 docker run --init --rm --name $N-$RANDOM -v "$W/game:/game" -v "$W/shots:/shots" "$IMG" bash -c \
"Xvfb :99 -screen 0 960x540x24 > /dev/null 2>&1 & sleep 2; DISPLAY=:99 godot ${2:---rendering-driver vulkan} --path /game -- --lab $1 --shot /shots" 2>&1 \
| grep -vE '^(ALSA|Godot Engine|WARNING: All audio|ERROR: Condition "status|libxkb| at| at|\s*$)'; }في الدالة أعلاه لاحظ التالي:
- الشاشة الوهمية: Xvfb يعمل في الخلفية على الشاشة رقم 99، ثم يشغل Godot بنافذة عليها. ولم نستخدم الأداة
xvfb-run، لأنها علقت دون أي مخرج في مقال الصوت، فشغلنا Xvfb بأنفسنا كما فعلنا هناك. - الخيار
--init: يضع في الـ Container عملية صغيرة أولى تستقبل الإشارات وتنهي ما بقي من العمليات، فيتوقف الـ Container عندما ينتهي Godot، حتى لو بقي Xvfb يعمل في الخلفية. - العارض: الافتراضي
--rendering-driver vulkanللعارض Forward+، والتجارب التي تقارن العارضين تمرر--rendering-driver opengl3 --rendering-method gl_compatibility. - الفلتر: يحذف رسائل بطاقة الصوت التي لا توجد في الـ Container، وتحذيراً واحداً متكرراً عنها، ويترك كل خطأ آخر.
وتشغله كله من مجلد lab بالأمر bash run.sh. والتجارب التي فيها ظلال تأخذ بضع دقائق، أغلبها في ترجمة برامج الرسم في أول إطار، لأن Mesa تترجمها للمعالج. وإذا أردت أن تعدل الفناء وترى النتيجة، فعدل lab.gd وشغل التجربة وحدها، مثل lab lights بعد تعريف الدالة، أو افتح مجلد game في محرر Godot على جهازك، وشغل المشهد مع -- --lab lights في إعدادات التشغيل.
أخطاء شائعة وكيف تقرأ أعراضها
- المشهد جميل في المحرر ومظلم في اللعبة: لا توجد WorldEnvironment ولا ضوء في المشهد، والمحرر كان يعرض سماء وشمساً للمعاينة فقط. أضفهما إلى المشهد من الأزرار أعلى نافذة 3D التي تنقل سماء المعاينة إلى المشهد.
- جسم معدني أسود: المعدن يعكس ما حوله، ولا شيء حوله. أضف سماء أو مسبار انعكاس ReflectionProbe، أو اخفض المعدنية إذا لم يكن معدناً أصلاً.
- وجوه مفقودة ترى من خلالها داخل الجسم: ترتيب الرؤوس معكوس أو مقياس سالب على محور واحد. أصلحه في برنامج النمذجة، ولا تكتف بتعطيل حذف الوجوه.
- صندوق أو هرم يبدو منتفخاً بحواف ناعمة: عموديات منعمة على شكل حاد. في الكود
set_smooth_group(-1)قبل الرؤوس، وفي Blender Shade Flat أو Auto Smooth. - جسم بلون واحد رغم أن خامته صورة: المجسم بلا UV. فك إحداثياته في Blender، أو استخدم Triplanar للأشكال البسيطة.
- بلاط ممطوط على جدار طويل: UV الافتراضي في BoxMesh يعطي كل وجه قطعة ثابتة من الصورة. استخدم Triplanar على إحداثيات العالم.
- وميض وتمزق بين سطحين متلاصقين: Z-fighting. أبعد أحدهما سنتيمتراً، أو استخدم Decal، ولا تخفض
nearفي الكاميرا. - الأرض كلها اختفت وطبع المحرك
Condition "!res" is true: قيمnearوfarبعيدة جداً عن بعضهما. أعدnearإلى 0.05 وقصرfar. - أوامر الرسم أكثر بكثير من عدد الأجسام: ظلال على أضواء كثيرة، أو زاوية رؤية واسعة جداً مع ظل الشمس، أو العارض Compatibility مع أكثر من ضوء على الجسم نفسه.
- مئة جسم متشابه بمئة أمر رسم: لكل جسم خامة مختلفة، ولو باللون نفسه. اجعلها خامة واحدة مشتركة ليجمعها Forward+.
قائمة فحص لأول مشهد ثلاثي الأبعاد
| السؤال | الإجابة الصحيحة غالباً | والسبب |
|---|---|---|
| أي عارض؟ | Forward+ لسطح المكتب، وCompatibility إذا كان الويب أو الأجهزة الضعيفة هدفاً | تغيير العارض لاحقاً يغير الإضاءة والألوان، كما رأينا في الفانوس |
| هل في المشهد WorldEnvironment؟ | نعم، بسماء وضوء محيط | دونها المعادن سوداء والظلال قاتمة، وسماء المحرر لا تظهر في اللعبة |
| أي تحويل ألوان؟ | AgX أو Filmic | Linear يحرق الأجزاء الساطعة |
| كم ضوءاً بظل؟ | الشمس، وقليل من الأضواء القريبة المهمة | كل ظل يرسم جزءاً من المشهد مرة أخرى |
| كم زاوية الرؤية؟ | بين 60 و75 لأغلب الألعاب | الزاوية الواسعة رفعت رسم الظلال من 15 إلى 27 أمراً |
كم near؟ | 0.05 الافتراضية | القيم الصغيرة جداً تفسد العمق أو تمنع الرسم |
| كم تفصيلاً في المجسمات الجاهزة؟ | أقل ما يكفي للحجم على الشاشة | الكرة الافتراضية 4,224 مثلثاً، و16 في 8 تعطي 288 |
| خامة لكل جسم أم مشتركة؟ | مشتركة كلما أمكن | 25 كرة: 25 أمر رسم بخامات منفصلة، وأمر واحد بخامة مشتركة |
تطبيق عملي
- في التجربة
lightsأضف SpotLight3D يضيء الخيمة من أعلى بظل، وانظر كم أمراً يضيف إلى رسم الظلال، ثم عطل ظل الفانوس وقارن. - غير الدالة
pyramidلتبني بيتاً بسقف مائل: صندوقاً وفوقه منشوراً، بعموديات مسطحة، واطبع عدد رؤوسه ومثلثاته قبل أن ترسمه وتوقع الرقم. - غير خشونة الكرة النحاسية من 0.25 إلى 0.05 ثم إلى 0.8، واحفظ الإطار في كل مرة، ثم افعل الشيء نفسه دون WorldEnvironment، وفسر الفرق.
- شغل التجربة
zfightبعد أن تغير السجادة لتكون مرفوعة 0.1 مليمتر، وابحث عن أبعد مسافة تبقى عندها سليمة.
حذف المختبر Cleanup
docker image rm godot-lab:4.7.2-3d
rm -rf shots game/.godot out-*.txtالخلاصة Summary
- الصورة ثلاثية الأبعاد نتيجة خمسة أشياء معاً: المجسم والخامة والضوء والكاميرا والبيئة، وإذا خرجت خاطئة فابحث في المرحلة التي تخصها من مسار الرسم.
- الرأس في المحرك موضع مع عمودي ومع UV، ولذلك المكعب 24 رأساً لا 8، والخيمة 18 رأساً لخمس نقاط، والكرة الافتراضية 4,224 مثلثاً.
- العموديات تقرر الإضاءة: دونها لون مسطح، ومعكوسة تختفي الوجوه، ومنعمة على شكل حاد تنتفخ الحواف، و
generate_normals()تنعم افتراضياً ما لم تضعset_smooth_group(-1). - المعدن يأخذ لونه مما يعكسه، فالكرة النحاسية كانت سوداء دون سماء، والخامة المشتركة جعلت 25 كرة أمر رسم واحداً في Forward+.
- ظل الشمس أضاف 18 أمر رسم و18,534 مثلثاً لفناء فيه 9,260 مثلثاً، وزاوية الرؤية الواسعة رفعته إلى 27.
- سطحان في المكان نفسه يتداخلان، ومليمتر واحد كفى لإصلاحهما، و
nearصغيرة جداً معfarكبيرة جداً منعت رسم الأرضية كلها. - المشهد نفسه كلف 7 أوامر رسم في Forward+ و32 في Compatibility، وضوء الفانوس اختلف بينهما، فاختر العارض في أول يوم.
وبهذا عندك فناء تفهم كل رقم فيه، والخطوة التالية بإذن الله أن نأتي بنماذج حقيقية من Blender بهياكلها العظمية وحركاتها، ثم أن نقيس أداء مشهد كبير ونصلحه:
دليلمن Blender إلى Godot: تجهيز النماذج والحركات Animationsنصنع نخلة أصلية بهيكل عظمي وحركتين في Blender دون واجهة، ونصدرها بصيغة glTF 2.0 إلى Godot، ثم نصنع أخطاء المقياس والمحاور والموضع وأسماء الحركات ودورانها عن قصد ونقيس أثر كل منها ونصلحه.
دليلأداء اللعبة: قياس الإطارات Profiling وتحسينهانبني في Godot 4 بستاناً من 2,500 نخلة بطيئاً عن قصد، ثم نقيسه بأدوات المحرك ونصلحه في ست خطوات، ونعرف بالأرقام كم وفرت كل خطوة ومن أين، وما الثمن الذي دفعناه في رقم آخر.
دليلرياضيات الألعاب: المتجهات Vectors والحركة والتصادمالمتجهات والحركة وحاصل الضرب النقطي واختبارات التصادم والارتداد والنفق، بلعبة صغيرة ومختبر Python يصنع الأخطاء الشائعة ثم يصلحها.
دليلأول لعبة مع Godot: المشاهد والعقد وGDScriptنبني لعبة صغيرة كاملة في Godot 4 من ثلاثة مشاهد وأربعة سكربتات، ونفهم بها العقد والمشاهد والإشارات وحلقة اللعبة، ثم نشغلها في مختبر يلعبها فيه روبوت حتى تنتهي.
دليلتصدير اللعبة من Godot إلى الويب والجوال وسطح المكتبماذا يحدث فعلاً عند تصدير لعبة Godot، ولماذا تحتاج نسخة الويب Headers خاصة أحياناً، وما تطلبه كل منصة ومتجر، مع مختبر يصدر لعبة واحدة إلى خمس منصات.سجل التحديثات Changelog
- 18 نوفمبر 2026: كتابة المقال، وبناء الفناء بالكود وتشغيل التجارب على Godot 4.7.2 في Docker، ورسم الإطارات بالعارضين Forward+ على Vulkan وCompatibility على OpenGL بمكتبة Mesa 22.3.6.