scale-fill-distiller

Continuous ColorBrewer fill scale.

Fill counterpart of scale-colour-distiller.

Usage

scale-fill-distiller(
  palette,
  direction,
  name,
  limits,
  oob,
  breaks,
  labels,
)

Parameters

Parameter	Default	Description
`palette`		ColorBrewer palette name (sequential or diverging works best).
`direction`		`1` for canonical order, `-1` for reversed.
`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

Spectral palette interpolated across 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-distiller(palette: "Spectral"),),
  guides: guides(fill: none),
  theme: theme-void(),
  width: 10cm,
  height: 1cm,
)

See also

scale-colour-distiller, scale-fill-gradientn, scale-fill-brewer.