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

# Método ILampInfo::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](/pt-BR/reference/lighting/lamparray/structs/lamparrayposition)

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:

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/lampinfoposition.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=96636e1a82b7fe5ef0e091cfa3993147" alt="Posição da lâmpada do teclado" width="802" height="698" data-path="images/gdk/reference/lampinfoposition.png" />

## 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](/pt-BR/build/core-features/common/lighting/gc-lighting-toc)\
[ILampArray::GetBoundingBox](/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox)\
[ILampInfo](/pt-BR/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo)


## Related topics

- [Método ILampInfo::GetIndex](/pt-BR/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getindex.md)
- [Método ILampInfo::GetPurposes](/pt-BR/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getpurposes.md)
- [Método ILampInfo::GetNearestSupportedColor](/pt-BR/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getnearestsupportedcolor.md)
- [Método ILampInfo::GetScanCode](/pt-BR/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getscancode.md)
- [Método ILampInfo::GetFixedColor](/pt-BR/reference/lighting/lamparray/interfaces/ilampinfo/methods/ilampinfo_getfixedcolor.md)