Config Reference

`Background / Gesso`

Compositor background renderer: solid fill, classic image, or spatial field shader.

Defaults

Defaults shown here are the effective builtin defaults from RuntimeTuning::builtin_defaults().

Default Config Shape

Use this as the section shape when editing halley.rune.

background:
  mode "field-shader"
  shader "space"
  path ""
  fit "cover"
  colour "#181a26"
  accent-colour "#8fa8d8"
  intensity 1.0
  animated true
end

Option	Type	Default	Notes
`mode`	string	`field-shader`	Background renderer. Accepted values: none, classic, field-shader. Alias section name: gesso.
`shader`	string	`space`	Field-shader source. space uses the builtin animated space shader; a path can load a custom fragment shader.
`path`	string		Classic image path for mode classic. Empty means no image path is loaded.
`fit`	string	`cover`	Classic image fit mode. Accepted values: cover, contain, stretch.
`colour`	hex color	`#181a26`	Base color for builtin shaders. Alias: color.
`accent-colour`	hex color	`#8fa8d8`	Accent color for builtin shaders. Aliases: accent-color, accent_color.
`intensity`	f32	`1.0`	Overall brightness/intensity multiplier for shader and image backgrounds.
`animated`	bool	`true`	Keeps animated field shaders repainting for subtle twinkle and pulse motion.