---
title: "system.gui.color"
description: "Creates a new color object, either by parsing a string or by having the RGB[A] channels specified explicitly."
---

# system.gui.color

> Creates a new color object, either by parsing a string or by having the RGB[A] channels specified explicitly.

This function is used in **Python Scripting**.

## Description
Creates a new color object, either by parsing a string or by having the RGB[A] channels specified explicitly. See [toColor](appendix\expression-functions\type-casting\toColor.md) to see a list of available color names.

## Client Permission Restrictions
This scripting function has no [Client Permission](projects\project-properties\project-properties.md#client---permissions) restrictions.

## Syntax (String)
`system.gui.color(color)`

### Parameters

|Type|Parameter|Description|
|--|--|--|
|String |`color` | A string that will be coerced into a color. Can accept many formats, such as "red" or "#FF0000" or "255,0,0".|
### Returns
**Color** - The newly created color.
### Scope
Client

## Syntax (int)
`system.gui.color(red, green, blue [, alpha])`

### Parameters

|Type|Parameter|Description|
|--|--|--|
|int| `red` | The red component of the color, an integer 0-255.|
|int |`green` | The green component of the color, an integer 0-255.|
|int |`blue` | The blue component of the color, an integer 0-255.|
|int |`alpha`| The alpha component of the color, an integer 0-255. [optional]|
### Returns
**Color** - The newly created color.
### Scope
Client

## Code Examples
```python title="Example #1"
# This example changes the background color of a component to red.
  
myComponent = event.source
myComponent.background = system.gui.color(255,0,0) # turn the component red
```