cue.spotlight
A cue that dims everything else in the environment and leaves what it wraps lit. On a graph the grid and the rules axis.label draws dim with the unlit marks, and the axes, their numbers, captions and the named values themselves stay: they are what the lit marks are read against.


#Attributes
atWhen the dimming starts, for a spotlight timed by a
duration:: a step (1), a time on the scene's clock (1.5s) or a step with an offset (1 + 500ms). Unwritten, with no in: either, step 0. Not written with in: or out:.Can be written as shorthand:
cue.spotlight:valueinWhen a HELD spotlight comes on, in place of
at: and duration:: the rest of the environment stays down from here until out: — in: 2; out: 3 keeps the content lit for the whole of step 2, however long the reader stays on it.outWhen a held spotlight lets go: after its
in:. Left out, it holds to the end of the scene.in-durationHow long a held spotlight takes to dim the rest.
Default
400msout-durationHow long a held spotlight takes to let go.
Default
400msdurationHow long the environment is dimmed, the first and last fifth of it spent dimming and letting go.
Default
3seasingAccepted, and not read: the dimming comes on and goes off smoothly whatever it is set to.
linearsmoothDefault
smoothsequentialLights each element of the body in turn, top to bottom, each when the one before's
duration has run.Default
false#Allowed content
Body { }
sliderselectorcue.slidercue.selectorlinepolygoncurvecirclesquarerectangletrianglestardiamondhexagonvectorsegmentbraceanglepointtextaxis.labelaxis.braceaxis.bandaxis.breakscatterhistogramareapictographbarlollipopboxplotdensityviolinheatmapfitintegralcontoursurfacefieldpolyhedronsectionrevolutionshelllineschoroplethmarkerarcboxarrowswitchclockgatemuxaluflipfloplampwirevertexedgeverticesedgespathcellbatteryresistorbulbbreakerammetervoltmetercapacitorseriesparallellead#Allowed in
#Examples


graph{
curve(expression: 2 * x + 3; colour: grey)
cue.spotlight{
curve(expression: x^2)
}(
at: 1
)
}(
x-domain: [-3, 4]
y-domain: [0, 10]
)

graph{
curve(expression: x^2)
cue.spotlight{
point(x: 2; y: 4)
}(
at: 2
duration: 4s
)
}(
x-domain: [-3, 3]
y-domain: [0, 9]
)#Notes
- The other marks, the grid and the axes are dimmed, then let back up.
- Nothing is drawn on the content itself; pair it with a
cue.highlightfor a ring as well. - On a code environment's
linesit is a wash over them, as a highlight is.
#Writing guidance
- Framing a readable graph — When to write a domain, the defaults left alone, naming a series, the ticks the prose reads, and one meaning per hue.