scale-fill-gradientn

Continuous n-stop fill gradient.

Fill counterpart of scale-colour-gradientn.

Usage

scale-fill-gradientn(
  colours,
  name,
  limits,
  oob,
  breaks,
  labels,
)

Parameters

Parameter Default Description
colours Array of two or more colours.
name Legend title. Overrides any name set via labels when both are present.
limits Pair (lo, hi) clipping the trained domain, or none.
oob Out-of-range policy: "drop" (default) removes rows whose value falls outside limits; "squish" clamps continuous values to the nearest endpoint.
breaks Array of break values for the legend, or auto.
labels Array of legend labels aligned with breaks, or auto.

Returns

Scale object consumed by plot.

Examples

Three-stop ramp shown as a continuous swatch via geom-rect.

#let d = range(0, 16).map(i => (
  xmin: i, xmax: i + 1, ymin: 0, ymax: 1, z: i,
))
#plot(
  data: d,
  mapping: aes(xmin: "xmin", xmax: "xmax", ymin: "ymin", ymax: "ymax", fill: "z"),
  layers: (geom-rect(),),
  scales: (scale-fill-gradientn(colours: (
    rgb("#1a9850"), rgb("#ffffbf"), rgb("#d73027"),
  )),),
  guides: guides(fill: none),
  theme: theme-void(),
  width: 10cm,
  height: 1cm,
)

Colour-bar swatch of sixteen rectangles displaying an n-stop fill gradient passing green through pale yellow to red across the bar.

Colour-bar swatch of sixteen rectangles displaying an n-stop fill gradient passing green through pale yellow to red across the bar.

See also

scale-colour-gradientn, scale-fill-gradient, scale-fill-gradient2.

Back to top