1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61
|
# Color
*Module*: `terminaltexteffects.utils.graphics`
## Basic Usage
Color objects are used to represent colors throughout TTE. However, they can be instantiated and printed directly.
### Supports Multiple Specification Formats
```python
from terminaltexteffects.utils.graphics import Color
red = Color('ff0000')
xterm_red = Color(9)
rgb_red_again = Color('#ff0000')
```
### Printing Colors
Colors can be printed to show the code and resulting color appearance.
```python
from terminaltexteffects.utils.graphics import Color
red = Color("#ff0000")
print(red)
```

### Using Colors to build a Gradient
```python
from terminaltexteffects.utils.graphics import Gradient, Color
rgb = Gradient(Color("#ff0000"), Color("#00ff00"), Color("#0000ff"), steps=5)
for color in rgb:
# color is a hex string
...
```
### Passing Colors to effect configurations
```python
text = ("EXAMPLE" * 10 + "\n") * 10
red = Color("#ff0000")
green = Color("#00ff00")
blue = Color("#0000ff")
effect = ColorShift(text)
effect.effect_config.gradient_stops = (red, green, blue)
with effect.terminal_output() as terminal:
for frame in effect:
terminal.print(frame)
```
---
## Color Reference
::: terminaltexteffects.utils.graphics.Color
|