Skip to content

wezterm.gradient_colors(gradient, num_colors)

Since: Version 20210814-124438-54e29167

The functionality described in this section requires version 20210814-124438-54e29167 of wezterm, or a more recent version.

Given a gradient spec and a number of colors, returns a table holding that many colors spaced evenly across the range of the gradient.

This is useful for example to generate colors for tabs, or to do something fancy like interpolate colors across a gradient based on the time of the day.

gradient is any gradient allowed by the window_background_gradient option.

This example is what you'd see if you opened up the debug overlay to try this out in the repl:

> wezterm.gradient_colors({preset="Rainbow"}, 4)
["#6e40aa", "#ff8c38", "#5dea8d", "#6e40aa"]
Since: Version 20220807-113146-c2fee766

The functionality described in this section requires version 20220807-113146-c2fee766 of wezterm, or a more recent version.

This function has moved to wezterm.color.gradient and that name should be used instead of this name.

In addition, the returned colors are now Color objects.