cue

Presence on the timeline: what it wraps fades in at in: and out at out:.

On this page
Three frames of a fade: four grey readings alone, then a teal fitted line half faded in, then the line in full.Three frames of a fade: four grey readings alone, then a teal fitted line half faded in, then the line in full.

#Attributes

inImplicit
When the content arrives: a step (1), a time on the scene's clock (1.5s) or a step with an offset (1 + 500ms). none, the default, has it there from the start.
Can be written as shorthand: cue:value
Defaultnone
out
When it leaves, in the same forms. none, the default, keeps it to the end of the scene.
Defaultnone
in-duration
How long the fade in takes, with its unit.
Also written: duration
Default500ms
out-duration
How long the fade out takes, with its unit.
Default500ms
easing
smooth or linear.
linearsmooth
Defaultsmooth
sequential
Gives each element of the body a turn, top to bottom: each fades in when the one before has finished, and at out: they leave in the same order.
Defaultfalse

#Allowed content

#Allowed in

#Examples

Three frames of the third step: the point at (1, 2) that faded in on the first, half faded out, then gone.Three frames of the third step: the point at (1, 2) that faded in on the first, half faded out, then gone.
graph{
    cue{
        point(x: 1; y: 2)
    }(
        in: 1
        out: 3
    )
}(
    x-domain: [-1, 3]
    y-domain: [0, 3]
)
Three frames of a sequential cue: an empty plot, then the first of three readings whole and the second half faded in, then all three.Three frames of a sequential cue: an empty plot, then the first of three readings whole and the second half faded in, then all three.
graph{
    cue{
        point(x: 1; y: 1)
        point(x: 2; y: 3)
        point(x: 3; y: 4)
    }(
        in: 1
        sequential
    )
}(
    x-domain: [0, 4]
    y-domain: [0, 5]
)

#Notes

  • It cannot wrap an environment or a table.
  • cue.highlight, cue.spotlight and cue.trace nest inside it to act on what it brought in.
  • An anchor past the scene's last step marker is refused inside an environment: 'cue.in' anchors to step 2, but the scene has 1 step (valid: 0–1). In a scene's detail, outside an environment, the same message is a warning.

#Writing guidance

  • Steps, timers, sweeps & parameters — New content on the step that introduces it, timers for timed motion, sweeps for a change the prose describes, and parameters where one sentence holds across the range.

Last updated