Modificadores de subespaço

Um SubspaceModifier é semelhante a um modificador do Compose para elementos combináveis em um Subspace. Um SubspaceModifier permite manipular elementos combináveis no espaço 3D, ajudando a posicionar, girar e adicionar comportamentos aos nós de layout 3D.

Layout

Por padrão, um Subspace é limitado pelo espaço recomendado para visualizar um app. Esses limites são usados ao medir o layout dos componentes de subespaço, de forma semelhante aos limites em layouts 2D do Compose.

Preencher limites

Os modificadores fillMaxSize, fillMaxWidth, fillMaxHeight e fillMaxDepth fazem com que o conteúdo (parcialmente) preencha os limites do elemento pai. O uso de modificadores de preenchimento ajuda o conteúdo do layout do app a ser independente das características de exibição do dispositivo XR.

Definir o tamanho e o tamanho obrigatório

Os modificadores size, width, height e depth declaram o tamanho preferencial do conteúdo. Para declarar o tamanho exato do conteúdo, use requiredSize, requiredWidth, requiredHeight e requiredDepth. Essas unidades precisam ser especificadas em dp. Para converter de metros para dp, use Meter.toDp().

Posicionar elementos combináveis

offset

O modificador offset move o elemento combinável no espaço 3D ao longo dos eixos x, y e z. Essas unidades precisam ser especificadas em dp. Para converter de metros para dp, use Meter.toDp().

rotate

O modificador rotate gira o elemento combinável especificado no espaço. É possível especificar a direção e a quantidade de rotação de diferentes maneiras:

  • Usando pitch, yaw e roll, que especificam a rotação em torno dos eixos x, y e z, respectivamente,
  • Usando um axisAngle, que é um Vector3 representando o eixo de rotação e a quantidade de graus em que ele precisa ser girado,
  • Usando um Quaternion que representa a rotação.

Mudar a aparência dos elementos combináveis

alpha

O modificador alpha define a opacidade do elemento e dos filhos dele, em que 0f representa totalmente transparente e 1.0f representa completamente opaco.

scale

O modificador scale dimensiona o conteúdo do combinável ao longo dos eixos horizontal, vertical e de profundidade.

Adicionar comportamentos a elementos combináveis

resizable

Quando o modificador resizable está ativado, controles de interface arrastáveis são mostrados para permitir que o usuário redimensione o elemento. Isso é semelhante a usar ResizableComponent em um Entity.

movable

Quando o modificador movable está ativado, controles de IU são adicionados ao componente, permitindo que o usuário mova o elemento no espaço 3D. Isso é semelhante a usar MovableComponent em um Entity.

Testes e acessibilidade

semantics

O modificador semantics adiciona semântica ao nó de layout para uso em testes e acessibilidade. Consulte Semântica no Jetpack Compose e SemanticsModifier.

testTag

O modificador testTag é uma abreviação de SemanticsPropertyReceiver.testTag, que permite que frameworks de teste encontrem o elemento nos testes.