> ## 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

> Returns the 3D position of a Lamp relative to the origin of its LampArray bounding box, used to arrange Lamps spatially for lighting effects.

Returns the 3D position of the Lamp relative to the origin of the LampArray's bounding box.

## Syntax

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

### Parameters

This method has no parameters.

### Return value

Type: [LampArrayPosition](https://docs.xbox.com/reference/lighting/lamparray/structs/lamparrayposition.md)

The position of the Lamp.

## Remarks

The origin (zero) point of the bounding box is the upmost, farthest, left-hand corner of the box.

X corresponds to Width, ascending from left to right.\
Y corresponds to Height, ascending from farthest to closest.\
Z corresponds to Depth, ascending from top to bottom.

Position values are measured in meters.

The following is an example of the position of a branding Lamp on a keyboard:

![Keyboard lamp position](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/lampinfoposition.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=96636e1a82b7fe5ef0e091cfa3993147)

## Requirements

**Header:** LampArray.h

**Library:** xgameplatform.lib

**Supported platforms:** XBOX One family consoles and XBOX Series consoles

## See also

[Lighting API Overview](https://docs.xbox.com/build/core-features/common/lighting/gc-lighting-toc.md)\
[ILampArray::GetBoundingBox](https://docs.xbox.com/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)\
[ILampInfo](https://docs.xbox.com/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)


## Related topics

- [LampArrayPosition](https://docs.xbox.com/reference/lighting/lamparray/structs/lamparrayposition.md)
- [LampArray Effects](https://docs.xbox.com/build/core-features/common/lighting/lighting-effects.md)
- [GetBoundingBox](https://docs.xbox.com/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getboundingbox.md)
- [ILampInfo (Interface contents)](https://docs.xbox.com/reference/lighting/lamparray/interfaces/ilampinfo/ilampinfo.md)
- [GetXmaDecodePositionForSample](https://docs.xbox.com/reference/audio/xma2defs/functions/getxmadecodepositionforsample.md)