اصلاح کننده های فضای فرعی

SubspaceModifier شبیه به Compose Modifier برای Composable ها در یک Subspace است. یک SubspaceModifier به شما امکان می‌دهد تا در فضای سه‌بعدی، قابلیت‌های ترکیبی را دستکاری کنید، به شما کمک می‌کند موقعیت، چرخش، و اضافه کردن رفتارها به گره‌های طرح‌بندی سه‌بعدی را انجام دهید.

طرح بندی

به طور پیش‌فرض، یک Subspace با فضای توصیه‌شده برای مشاهده یک برنامه محدود می‌شود. این کرانها هنگام اندازه‌گیری چیدمان اجزای فضای فرعی شما، مشابه کران‌ها در طرح‌بندی‌های 2D 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 ، ترکیب بندی داده شده را در فضا می چرخاند. می توانید جهت و میزان چرخش را به روش های مختلف مشخص کنید:

  • با استفاده از pitch، yaw و roll، که چرخش را به ترتیب حول محورهای x ، y و z مشخص می‌کنند.
  • با استفاده از یک axisAngle که یک Vector3 است که محور چرخش را نشان می دهد و مقدار درجه هایی که باید به دور آن بچرخد،
  • با استفاده از یک Quaternion که چرخش را نشان می دهد.

تغییر ظاهر ترکیبات

alpha

اصلاح کننده alpha کدورت عنصر و فرزندان آن را تنظیم می کند، جایی که 0f نشان دهنده کاملاً شفاف و 1.0f نشان دهنده کاملاً مات است.

scale

اصلاح کننده scale ، محتویات کامپوزیبل را در امتداد محورهای افقی، عمودی و عمق مقیاس می کند.

تست و دسترسی

semantics

تعدیل‌کننده semantics ، معناشناسی را به گره طرح‌بندی اضافه می‌کند تا در آزمایش و دسترسی استفاده شود. Semantics را در Jetpack Compose و SemanticsModifier ببینید.

testTag

اصلاح‌کننده testTag مخفف SemanticsPropertyReceiver.testTag است که به چارچوب‌های تست اجازه می‌دهد عنصر را در تست‌ها پیدا کنند.