scene
A body of narrative and an optional detail that declares its canvas.
#Attributes
durationHow long one playback of a step lasts, where the step animates: a duration with its unit (
6s, 800ms) or auto, as long as the step's cues take. Never shorter than the cues, so a longer one adds a hold on the finished picture before Replay is offered or loop goes round. The implicit attribute: scene:6s{…}.Can be written as shorthand:
scene:valueDefault
autoautoplay!autoplay makes every step that animates at all arrive paused at its start, with a play control in the canvas toolbar, until the reader presses play. A step that animates nothing goes ahead.Default
trueloopWhen a step's playback ends, it plays again.
duration sets how long each time round lasts. With !autoplay, it waits for the first press of play.Default
falsedirectionHow two environments in the detail are arranged:
auto stacks them while the internote is read beside its narrative and sets them side by side in presentation; horizontal sets them side by side and vertical stacks them, in both. Anything but auto on a scene with fewer than two environments draws a warning.horizontalverticalDefault
autoratioThe first environment's share of a two-environment split over the second's:
3/2, 3:2 or a positive number. Left out, the shares are equal. Written on a scene with fewer than two environments, it draws a warning.print-at#Allowed content
#Examples
scene{
# Free fall
A stone dropped from rest falls $4.9t^2$ metres in $t$ seconds.
}scene{
A stone dropped from rest falls $4.9t^2$ metres in $t$ seconds.
===
After two seconds it has fallen 19.6 m.
}[
graph{
curve(expression: 4.9x^2; domain: [0, 3])
cue{
point(x: 2; y: 19.6; label: 19.6 m)
}(
in: 1
)
}
]scene{
The curve and the code that computes it.
}[
graph{
curve(expression: 4.9x^2; domain: [0, 3])
}
code{
lines{
def fallen(t):
return 4.9 * t ** 2
}
}(
language: python
)
](
ratio: 3/2
)#Notes
- A document holds scenes and
citedeclarations; an internote is its scenes, read in the order they are written. - A detail holds at most two environments of its own; a third is refused with
A scene detail holds at most two canvas environments; found 3 — a grid holds up to nine. - Content outside the slot that takes it is refused with the list of what is allowed, as in
nodenoteis not allowed here (allowed: paragraph, h1, …). - The colour micronodes,
highlight,symboland the inline!cue.highlightare refused in the body:'!red' is not allowed in the narrative; colour, highlighting and symbols belong in the canvas.
#Writing guidance
- What a document covers — One topic, named by the title, with the constructs and the length that topic needs.
- Scenes and what each shows — A canvas makes one point at a time, a second idea is a second scene, and a detail is optional.
- Prose & canvas state — Prose describes the state the canvas is in and names what it shows, never the controls or where things sit.
- Writing for print — How an internote is set as a printed document — its designs, canvases as figures, citations, pages and contents — and how to write one that reads well both ways.
- The final pass — What the compiler checks, with its diagnostics, and the judgements nothing checks, each linked to its reason.