عرض مصدر Godot/3d/3d text

<noinclude>{{DISPLAYTITLE:النص ثلاثي الأبعاد في جودو}}</noinclude>
تحتاج في بعض المرات أن يُنشأ النص كجزء من المشهد ثلاثي البعد وليس فقط واجهة اللاعب. تقدم جودو طريقتين لعمل ذلك: عقدة <code>Label3D</code> ومورد شبكة النص من أجل عقدة <code>MeshInstance3D</code>.

تسمح جودو أيضًا بتحديد عقد التحكم حسب موقع النقطة ثلاثية البعد على الكاميرا. يمكن استخدام ذلك كطريقة بديلة للنص ثلاثي البعد "الحقيقي" في الحالات حيث <code>Label3D</code> وشبكة النص ليسوا مرنين كفاية.<blockquote>راجع أيضًا: يمكن رؤية النص ثلاثي البعد أثناء الاستخدام مع [https://github.com/godotengine/godot-demo-projects/tree/master/3d/labels_and_texts المشروع التجريبي العناوين ثلاثية البعد والنصوص].

لا تغطي هذه الصفحة كيفية إظهار مشهد واجهة المستخدم الرسومية في البيئة ثلاثية البعد. من أجل معلومات عن تحقيق ذلك راجع [https://github.com/godotengine/godot-demo-projects/tree/master/viewport/gui_in_3d المشروع التجريبي لواجهة المستخدم الرسومية ثلاثية الأبعاد].</blockquote>

== Label3D ==
[[ملف:label 3d.png|مركز|لاإطار]]


تتصرف <code>Label3D</code> مثل عقدة العنوان ولمن في الفضاء ثلاثي البعد، وعلى عكس عقدة العنوان لا ترث عقدة <code>Label3D</code> خاصيات سمة واجهة المستخدم الرسومية. ولكن مظهرها يبقى قابل للتعديل ويستخدم نفس المورد الفرعي نوع الخط وعقدة التحكم (بما فيه دعم تصيير الخط Multi-Channel Signed Distance Font أو اختصارًا MSDF).

=== الميزات ===

* إن <code>Label3D</code> أسرع في الإنشاء من شبكة النص <code>TextMesh</code>. على الرغم من كونهما يستخدمان طرق التخزين المؤقت لتصيير الحروف الجديدة مرة واحدة، تكون <code>Label3D</code> أسرع في إعادة الإنشاء خاصة للنصوص الطويلة. لتفادي التشويش أثناء اللعب على المعالجات الضعيفة أو الهواتف.
* يمكن أن يستخدم <code>Label3D</code> الخطوط الديناميكية وخطوط الخارطة النقطية bitmap (مع أو بدون MSDF أو mipmaps). هذا يجعلها أكثر مرونة في هذه الناحية مقارنة بشبكة النص، خاصة لتصيير الخطوط مع الحدود المتقاطعة.

<blockquote>راجع أيضًا: راجع [[Godot/ui/gui using fonts|استخدام الخطوط]] لقواعد عن ضبط استيرادات الخطوط.</blockquote>

=== المحدوديات ===
لدى <code>Label3D</code> تفاعل محدود مع البيئة ثلاثية البعد افتراضيًا. إذ يمكن حجبها من الأشكال الهندسية وإنارتها باستخدام منابع ضوئية إذا تم تفعيل خاصية تظليل. ولكنها لا تنشر ظلال حتى لو كان خيار نشر الظل مفعلًا في خاصيات <code>GeometryInstance3D</code> الخاص بالعقدة <code>Label3D</code>. لأن العقدة تُنشئ داخليًا شبكة رباعية quad mesh (رمز glyph واحد لكل رباعي) مع ملمس شفاف ولديها نفس محدوديات <code>Sprite3D</code>. تظهر مشاكل ترتيب الشفافية عندما تتراكب عدة <code>Label3D</code> فوق بعضها خاصة إذا كان لديها حدود خارجية.

يمكن تفادي ذلك عن طريق ضبط نمط شفافية <code>Label3D</code> إلى '''Alpha Cut'''، على حساب تصيير نص أقل سلاسة. يحفظ نمط الشفافية '''Opaque Pre-Pass''' سلاسة النص مع السماح للعقدة <code>Label3D</code> بنشر الظلال، ولكن بعض مشاكل ترتيب الشفافية ستبقى موجودة.

راجع قسم [[Godot/3d/3d rendering limitations|ترتيب الشفافية]] في محدوديات التصيير ثلاثي البعد لمزيد من المعلومات.

== TextMesh ==
[[ملف:text mesh.png|مركز|لاإطار]]


لدى شبكة النص <code>TextMesh</code> بعض أوجه التشابه مع <code>Label3D</code>. كلاهما يظهر النص في المشهد ثلاثي البعد ويستعملان نفس مصدر الخط الفرعي. ولكن، بدلًا من إنشاء رباعيات شفافة، تُنشئ شبكة النص أشكال هندسية ثلاثية البعد تمثل حدود الحرف ولديها خاصيات الشبكة. نتيجة لذلك، يتم تظليل شبكة النص افتراضيًا وتنشر ظلالها على البيئة. لدى شبكة النص مواد مطبقة عليها (إضافة إلى تظليل مخصص)

هذا مثال عن ملمس وكيفية تطبيقه على الشبكة. يمكنك استخدام الملمس التالي كمرجع لإنشاء خريطة UV الخاصة بالشبكة:
[[ملف:text mesh texture.png|مركز|لاإطار]]
[[ملف:text mesh textured.png|مركز|لاإطار]]

=== الميزات ===
لدى شبكة النص بعض الميزات أكثر من <code>Label3D</code>

* تستخدم شبكة النص الملمس texture لتعديل لون النص لكل طرف
* يكون للأشكال الهندسية لشبكة النص عمق حقيقي مما يعطي الأحرف شكل ثلاثي البعد.
* يمكن أن يكون لشبكة النص ظلال shaders مخصصة على عكس <code>Label3D</code>  

=== المحدوديات ===
هناك بعض المحدوديات لشبكة النص

* لا يوجد دعم للحدود الخارجية على عكس <code>Label3D</code>، ويمكن محاكاة هذا الأمر باستخدام ظلال shaders مخصصة.

* الخطوط الديناميكية هي المدعومة فقط (<code>ttf</code>, <code>otf</code>, <code>woff</code>, <code>woff2</code>). أنماط خطوط خريطة النقط <code>fnt</code> و<code>font</code> ليست مدعومة
* لا تُصير الخطوط ذات الحدود المتقاطعة بشكل صحيح. جرب تنزيل نمط الخط من الموقع الرسمي لصانع النمط إذا واجهت مشاكل تصيير للنص بدلا من المواقع الأخرى مثل Google Fonts.

== عقدة العنوان المُسقطة (أو أي عقدة تحكم أخرى) ==
الحل الأخير الأعقد في الضبط ولكنه يقدم مرونة أكثر هو إسقاط عقدة ثنائية البعد على الفضاء ثلاثي البعد. يمكن الحصول على ذلك عن طريق استخدام القيمة المرجعة للتابع <code>[https://docs.godotengine.org/en/stable/classes/class_camera3d.html#class-camera3d-method-unproject-position unproject_position]</code> على عقدة <code>Camera3D</code> في سكربت الدالة <code>‎_process()</code>‎. يجب استخدام القيمة المُعادة لضبط خاصية <code>position</code> على عقدة التحكم.

شاهد [https://github.com/godotengine/godot-demo-projects/tree/master/3d/waypoints العرض التجريبي لنقاط الطريق ثلاثية البعد] لمثال عن ذلك.

=== ميزات ===

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

=== المحدوديات ===

* لا يمكن حجب لوحة التحكم المُسقطة بأي طريقة بالأشكال ثلاثية البعد. يمكن استخدام نشر الشعاع لإخفاء التحكم كليًا إذا كان المكان المطلوب محجوبًا بصادم، ولكن لا يسمح بإخفاء التحكم جزئيًا خلف جدار.
* يمكن تغيير حجم الخط اعتمادًا على المسافة عن طريق خاصية <code>scale</code> الخاصة بالتحكم ولكن يجب القيام بذلك يدويًا. تقوم شبكة النص و<code>Label3D</code> بذلك تلقائيًا، على حساب كونها أقل مرونة (لا يمكن ضبط حجم الخط الأكبر/الأصغر بالبيكسل).
* يجب الأخذ بعين الاعتبار الدقة ونسبة القياس في السكربت، وهي عملية صعبة.

== هل يجب علي أن استخدم Label3D أو TextMesh أو التحكم المُسقط؟ ==
يُفضل استخدام <code>Label3D</code> في معظم الحالات كونه أسهل للضبط ويقدم نوعية تصيير أفضل (خاصة إذا تم تعطيل تنعيم التشويش).

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

استخدم عقدة عنوان النص الغني <code>RichTextLabel</code> مُسقطة إذا كنت بحاجة ميزات مثل BBCode أو دعم التحكم بالسمة. 
== مصادر ==
* [https://docs.godotengine.org/en/stable/tutorials/3d/3d_text.html صفحة 3D Text في توثيق جودو الرسمي.]
[[تصنيف:Godot|{{SUBPAGENAME}}]]
[[تصنيف:Godot 3D|{{SUBPAGENAME}}]]