1f53dd1357
Closes https://github.com/KittyCAD/modeling-app/issues/6805. Enables users to programatically construct colors, which will be helpful for - Applying color to visualize program execution and help debugging - Doing weird cool shit
65 lines
176 KiB
Markdown
65 lines
176 KiB
Markdown
---
|
|
title: "appearance::rgb"
|
|
subtitle: "Function in std::appearance"
|
|
excerpt: ""
|
|
layout: manual
|
|
---
|
|
|
|
|
|
|
|
```kcl
|
|
appearance::rgb(@rgb: [number(_); 3]): string
|
|
```
|
|
|
|
Build a color from its red, green and blue components.
|
|
These must be between 0 and 255.
|
|
|
|
### Arguments
|
|
|
|
| Name | Type | Description | Required |
|
|
|----------|------|-------------|----------|
|
|
| `rgb` | [`[number(_); 3]`](/docs/kcl-std/types/std-types-number) | | Yes |
|
|
|
|
### Returns
|
|
|
|
[`string`](/docs/kcl-std/types/std-types-string) - A sequence of characters
|
|
|
|
|
|
### Examples
|
|
|
|
```kcl
|
|
startSketchOn(-XZ)
|
|
|> circle(center = [0, 0], radius = 10)
|
|
|> extrude(length = 4)
|
|
|> appearance(color = appearance::rgb([50, 160, 160]))
|
|
```
|
|
|
|
|
|
|
|
```kcl
|
|
sideLen = 30
|
|
n = 10
|
|
|
|
// The cubes become more green and less blue with each instance.
|
|
fn cube(i, center) {
|
|
g = 255 / n * i
|
|
b = 255 / n * (n - i)
|
|
return startSketchOn(XY)
|
|
|> polygon(radius = sideLen / 2, numSides = 4, center = [center, 0])
|
|
|> extrude(length = sideLen)
|
|
|> appearance(color = appearance::rgb([0, g, b]), metalness = 80, roughness = 20)
|
|
}
|
|
|
|
// Create n cubes, shifting each one over in a line.
|
|
map(
|
|
[0..n],
|
|
f = fn(@i) {
|
|
return cube(i, center = sideLen * i * 1.5)
|
|
},
|
|
)
|
|
```
|
|
|
|
|
|
|
|
|