Pengubah subruang

SubspaceModifier mirip dengan pengubah Compose untuk composable dalam Subspace. SubspaceModifier memungkinkan Anda memanipulasi composable dalam ruang 3D, membantu Anda memosisikan, memutar, dan menambahkan perilaku ke node tata letak 3D.

Tata Letak

Secara default, Subspace dibatasi oleh ruang yang direkomendasikan untuk melihat aplikasi. Batas ini digunakan saat mengukur tata letak komponen subruang, mirip dengan batas dalam tata letak Compose 2D.

Batas isi

Pengubah fillMaxSize, fillMaxWidth, fillMaxHeight, dan fillMaxDepth membuat konten (sebagian) mengisi batas induknya. Menggunakan pengubah isi membantu konten tata letak aplikasi Anda yang tidak bergantung pada karakteristik layar perangkat XR.

Menetapkan ukuran dan ukuran yang diperlukan

Pengubah size, width, height, dan depth mendeklarasikan ukuran konten yang diinginkan. Untuk mendeklarasikan ukuran konten yang tepat, gunakan requiredSize, requiredWidth, requiredHeight, dan requiredDepth. Unit ini harus ditentukan dalam dp; untuk mengonversi dari meter ke dp, gunakan Meter.toDp().

Composable posisi

offset

Pengubah offset memindahkan composable dalam ruang 3D di sepanjang sumbu x, y, dan z. Unit ini harus ditentukan dalam dp; untuk mengonversi dari meter ke dp, gunakan Meter.toDp().

rotate

Pengubah rotate memutar composable yang diberikan dalam ruang. Anda dapat menentukan arah dan jumlah rotasi dengan berbagai cara:

  • Menggunakan pitch, yaw, dan roll, yang menentukan rotasi di sekitar sumbu x, y, dan z,
  • Menggunakan axisAngle, yang merupakan Vector3 yang mewakili sumbu rotasi, dan jumlah derajat yang harus diputar,
  • Menggunakan Quaternion yang mewakili rotasi.

Mengubah tampilan composable

alpha

Pengubah alpha menetapkan opasitas elemen dan turunannya, dengan 0f mewakili sepenuhnya transparan dan 1.0f mewakili sepenuhnya buram.

scale

Pengubah scale menskalakan konten composable di sepanjang sumbu horizontal, vertikal, dan kedalaman.

Menambahkan perilaku ke composable

resizable

Saat pengubah resizable diaktifkan, kontrol UI yang dapat ditarik akan ditampilkan yang memungkinkan pengguna mengubah ukuran elemen. Hal ini mirip dengan menggunakan ResizableComponent di Entity.

movable

Saat pengubah movable diaktifkan, kontrol UI akan ditambahkan ke komponen yang memungkinkan pengguna memindahkan elemen dalam ruang 3D. Hal ini mirip dengan menggunakan MovableComponent di Entity.

Pengujian dan aksesibilitas

semantics

Pengubah semantics menambahkan semantik ke node tata letak, untuk digunakan dalam pengujian dan aksesibilitas. Lihat Semantik di Jetpack Compose dan SemanticsModifier.

testTag

Pengubah testTag adalah singkatan untuk SemanticsPropertyReceiver.testTag, yang memungkinkan framework pengujian menemukan elemen dalam pengujian.