> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetPosition

> Retorna a posição 3D de uma Lamp em relação à origem da caixa delimitadora do LampArray, usada para organizar as Lamps espacialmente para efeitos de iluminação.

# ILampInfo::GetPosition

Retorna a posição 3D da Lamp em relação à origem da caixa delimitadora do LampArray.

## Sintaxe

```cpp theme={null}
LampArrayPosition GetPosition(
)
```

### Parâmetros

Este método não tem parâmetros.

### Valor retornado

Tipo: [LampArrayPosition](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/structs/lamparrayposition.md)

A posição da Lamp.

## Comentários

O ponto de origem (zero) da caixa delimitadora é o canto superior, mais distante e à esquerda da caixa.

X corresponde à largura, crescendo da esquerda para a direita.\
Y corresponde à altura, crescendo do mais distante para o mais próximo.\
Z corresponde à profundidade, crescendo de cima para baixo.

Os valores de posição são medidos em metros.

Veja a seguir um exemplo da posição de uma Lamp de identidade visual em um teclado:

![Posição da lâmpada do teclado](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/lampinfoposition.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=96636e1a82b7fe5ef0e091cfa3993147)

## Requisitos

**Cabeçalho:** LampArray.h

**Biblioteca:** xgameplatform.lib

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral da API de iluminação](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/gc-lighting-toc.md)\
[ILampArray::GetBoundingBox](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)\
[ILampInfo](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)


## Related topics

- [LampArrayPosition](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/structs/lamparrayposition.md)
- [Efeitos de LampArray](https://docs.xbox.com/pt-BR/build/core-features/common/lighting/lighting-effects.md)
- [GetBoundingBox](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)
- [ILampInfo (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [GetXmaDecodePositionForSample](https://docs.xbox.com/pt-BR/reference/audio/xma2defs/functions/getxmadecodepositionforsample.md)