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

# PIX_COLOR

> PIX_COLOR

# PIX\_COLOR

Specifies a particular color for an event.

## Syntax

```cpp theme={null}
UINT PIX_COLOR(  
         BYTE r,  
         BYTE g,  
         BYTE b  
)  
```

### Parameters

*r*   \
Type: BYTE

The red component of the color.

*g*   \
Type: BYTE

The green component of the color.

*b*   \
Type: BYTE

The blue component of the color.

### Return value

Type: UINT

Returns a UINT containing the specified color.

## Remarks

Use the PIX\_COLOR\* functions to specify colors to pass as metadata to a PIX event/marker API.
Use `PIX_COLOR` to specify a particular color for an event. Or, use [PIX\_COLOR\_INDEX](/reference/tools/pix3/functions/pix_color_index) to specify a set of unique event categories and let PIX choose the colors to represent each category.

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 [PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent), [PIXScopedEvent](/reference/tools/pix3/functions/pixscopedevent), and [PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker).

## Requirements

**Header:** pix3.h

**Library:** pixevt.lib

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

## See also

[PIX\_COLOR\_INDEX](/reference/tools/pix3/functions/pix_color_index)\
[PIXBeginEvent](/reference/tools/pix3/functions/pixbeginevent)\
[PIXScopedEvent](/reference/tools/pix3/functions/pixscopedevent)\
[PIXSetMarker](/reference/tools/pix3/functions/pixsetmarker)\
[PIX (NDA topic)](/tools/tools-console/pix/pix)\
[PIX3](/reference/tools/pix3/pix3_members)


## Related topics

- [PIX_COLOR_INDEX](/reference/tools/pix3/functions/pix_color_index.md)
- [PIXSetMarker function](/reference/tools/pix3/functions/pixsetmarker.md)
- [PIXBeginEvent function](/reference/tools/pix3/functions/pixbeginevent.md)
- [PIXSetMarker reference](/reference/tools/pix3/functions/pixsetmarker_2.md)
- [PIXBeginEvent function reference](/reference/tools/pix3/functions/pixbeginevent_2.md)