> For the complete documentation index, see [llms.txt](https://osl.mistium.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://osl.mistium.com/packages/media/colors.md).

# colors

> Build colour values (used by image-producing packages)

Use `colors` to construct color values for image, canvas, QR, PDF, and window drawing APIs.

```javascript
import "osl/colors"
```

## Example

```javascript
import "osl/colors"

auto red = colors.rgb(255, 0, 0)
auto transparent = colors.RGBA(0, 0, 0, 128)
```

## API reference

### `colors`

| Method                                         | Returns       | Description               |
| ---------------------------------------------- | ------------- | ------------------------- |
| `colors.RGBA(r: any, g: any, b: any, a: any)`  | `color.RGBA`  | Runs the rgba operation.  |
| `colors.rgb(r: any, g: any, b: any)`           | `color.RGBA`  | Runs the rgb operation.   |
| `colors.gray(v: any)`                          | `color.Gray`  | Runs the gray operation.  |
| `colors.nrgba(r: any, g: any, b: any, a: any)` | `color.NRGBA` | Runs the nrgba operation. |
| `colors.hex(hex: any)`                         | `color.RGBA`  | Runs the hex operation.   |

## Notes

* Standard-library imports accept both `import "osl/colors"` and `import "colors"`.
* Return values such as `array` and `object` are regular OSL values unless a returned object section says otherwise.