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

# PIX_COLOR_INDEX

> PIX_COLOR_INDEX

Specifies a set of unique event categories and lets PIX choose the colors to represent each category.

## Syntax

```cpp theme={null}
UINT PIX_COLOR_INDEX(  
         BYTE i  
)  
```

### Parameters

*i*   \
Type: BYTE

The index of the color.

### Return value

Type: UINT

Returns a UINT containing the color representing the category.

## Remarks

Use the PIX\_COLOR\* functions to specify colors to pass as metadata to a PIX event/marker API. Use [PIX\_COLOR](https://docs.xbox.com/reference/tools/pix3/functions/pix_color.md) to specify a particular color for an event. Or, use `PIX_COLOR_INDEX` to specify a set of unique event categories, and let PIX choose the colors to represent each category. `PIX_COLOR_INDEX` allows for eight distinct color indexes to be used. The function will wrap the index values using *i* % 8 to choose the index that will determine the appropriate color.\
The PIX\_COLOR\* functions can be used to determine the color parameter for a number of functions to represent how they will be displayed in a PIX chart. Those functions include the overloaded methods [PIXBeginEvent](https://docs.xbox.com/reference/tools/pix3/functions/pixbeginevent-overloads.md) and [PIXSetMarker](https://docs.xbox.com/reference/tools/pix3/functions/pixsetmarker-overloads.md).

## Requirements

**Header:** pix3.h

**Library:** pixevt.lib

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

## See also

[PIX\_COLOR](https://docs.xbox.com/reference/tools/pix3/functions/pix_color.md)\
[PIXBeginEvent](https://docs.xbox.com/reference/tools/pix3/functions/pixbeginevent.md)\
[PIXSetMarker](https://docs.xbox.com/reference/tools/pix3/functions/pixsetmarker.md)\
[PIX3](https://docs.xbox.com/reference/tools/pix3/pix3_members.md)\
[PIX (NDA topic)](https://docs.xbox.com/tools/tools-console/pix/pix.md)


## Related topics

- [PIX_COLOR](https://docs.xbox.com/reference/tools/pix3/functions/pix_color.md)
- [PIXSetMarker(UINT64, PCSTR, ...)](https://docs.xbox.com/reference/tools/pix3/functions/pixsetmarker.md)
- [PIXBeginEvent(UINT64, PCSTR, ...)](https://docs.xbox.com/reference/tools/pix3/functions/pixbeginevent.md)
- [PIXBeginEvent(UINT64, PCWSTR, ...)](https://docs.xbox.com/reference/tools/pix3/functions/pixbeginevent_2.md)
- [PIXSetMarker(UINT64, PCWSTR, ...)](https://docs.xbox.com/reference/tools/pix3/functions/pixsetmarker_2.md)