مُعدِّلات المساحات الفرعية

يشبه SubspaceModifier مفتاح تعديل الإنشاء للعناصر القابلة للتجميع في Subspace. يتيح لك SubspaceModifier معالجة العناصر القابلة للتجميع في الفضاء الثلاثي الأبعاد، ما يساعدك في تحديد موضع عناصر تنسيق ثلاثي الأبعاد وتدويرها وإضافة سلوكيات إليها.

التنسيق

يكون Subspace محدودًا تلقائيًا بالمساحة المقترَحة لعرض التطبيق. وتُستخدَم هذه الحدود عند قياس تنسيق مكونات المساحة الفرعية ، تمامًا مثل الحدود في تنسيقات Compose ثنائية الأبعاد.

حدود التعبئة

تجعل المُعدِّلات fillMaxSize وfillMaxWidth وfillMaxHeight و fillMaxDepth المحتوى يملأ حدود العنصر الرئيسي (جزئيًا). يساعد استخدام عوامل تعديل التعبئة تطبيقك في تصميم محتوى مستقل عن خصائص شاشة جهاز XR.

ضبط الحجم والحجم المطلوب

تُستخدَم المُعدِّلات size وwidth وheight وdepth لتحديد الحجم المفضّل للمحتوى. لتحديد الحجم الدقيق للمحتوى، استخدِم requiredSize وrequiredWidth requiredHeight وrequiredDepth. يجب تحديد هذه الوحدات باستخدام dp. ولتحويل القيمة من متر إلى dp، استخدِم Meter.toDp().

وضع العناصر القابلة للتجميع

offset

ينقل المُعدِّل offset العنصر القابل للتجميع في الفضاء الثلاثي الأبعاد على طول محاور x وy وz. يجب تحديد هذه الوحدات باستخدام dp. ولتحويل القيم من متر إلى dp، استخدِم Meter.toDp().

rotate

يُدير المُعدِّل rotate العنصر القابل للتجميع المحدَّد في المساحة. يمكنك تحديد الاتجاه ومقدار الدوران بطرق مختلفة:

• باستخدام الزاوية الرأسية والانحراف والانحناء، التي تحدّد الدوران حول المحاور x وy وz على التوالي،
• باستخدام axisAngle، وهو Vector3 يمثّل محور الدوران وعدد الدرجات التي يجب الدوران حولها،
• باستخدام Quaternion الذي يمثّل التناوب

تغيير مظهر العناصر القابلة للتجميع

alpha

يضبط المُعدِّل alpha مستوى التعتيم للعنصر وعناصره الفرعية، حيث يمثّل 0f شفافية كاملة ويمثّل 1.0f مستوى التعتيم الكامل.

scale

يغيّر المُعدِّل scale حجم محتوى العنصر المُركّب على طول محوري الالتفاف والارتفاع والعمق.

إضافة سلوكيات إلى العناصر القابلة للتجميع

resizable

عند تفعيل المُعدِّل resizable، سيتم عرض عناصر تحكّم قابلة للسحب في واجهة المستخدم تتيح للمستخدم تغيير حجم العنصر. يشبه ذلك استخدام ResizableComponent على Entity.

movable

عند تفعيل المُعدِّل movable، ستتم إضافة عناصر التحكّم في واجهة المستخدم إلى العنصر التي تسمح للمستخدم بتحريك العنصر في الفضاء الثلاثي الأبعاد. يشبه ذلك استخدام MovableComponent على Entity.

الاختبار وإمكانية الاستخدام

semantics

يضيف المُعدِّل semantics دلالات إلى عقدة التنسيق، لاستخدامها في الاختبار وإمكانية الوصول. اطّلِع على الدلالات في Jetpack Compose و SemanticsModifier.

testTag

المُعدِّل testTag هو اختصار لعبارة SemanticsPropertyReceiver.testTag، ما يسمح لإطارات العمل للاختبار بالعثور على العنصر في الاختبارات.