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

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 ، محتویات کامپوزیبل را در امتداد محورهای افقی، عمودی و عمق مقیاس می کند.

رفتارها را به ترکیب‌پذیرها اضافه کنید

resizable

هنگامی که اصلاح کننده resizable فعال است، کنترل های رابط کاربری قابل کشیدن نشان داده می شوند که به کاربر اجازه می دهد اندازه عنصر را تغییر دهد. این شبیه به استفاده از ResizableComponent در یک Entity است.

movable

هنگامی که تغییر دهنده movable فعال است، کنترل‌های رابط کاربری به مؤلفه اضافه می‌شوند که به کاربر اجازه می‌دهد عنصر را در فضای سه‌بعدی جابجا کند. این شبیه به استفاده از MovableComponent در یک Entity است.

تست و دسترسی

semantics

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

testTag

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