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

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

التنسيق

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

حدود التعبئة

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

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

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

عناصر قابلة للإنشاء لتحديد الموضع

offset

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

rotate

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

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

تغيير مظهر العناصر القابلة للإنشاء

alpha

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

scale

يؤدي المعدِّل scale إلى تغيير حجم محتوى العنصر القابل للإنشاء على المحاور الأفقية والعمودية والعمق.

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

semantics

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

testTag

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