FolioTier 1
transition
Apply a transition at the current point in the scene.
Parameters
| Parameter | Kind | Required | Default | Notes |
|---|---|---|---|---|
| name | identifier | yes | — | Identifier of the transition to apply. Built-in transitions include `fade`, `dissolve`, `pixellate`, `hpunch`, `vpunch`. Project-defined transitions resolve to the same name once registered. |
Canonical example
bg bg-kitchen-morning
show emma-happy
transition dissolvescene bg kitchen_morning
show emma happy
with dissolvetransition is the standalone form — apply a named transition at
this exact point in the scene. The pending stage operations on the
preceding lines (the scene and show in the example above) all
play under the named transition. It's the Folio analogue of Ren'Py's
bare with <name> line.
Notes
Prefer the inline with <name> clause on scene / show / hide
when a single line stages an image and the transition is part of
that single staging step. Use the standalone transition verb when
multiple stage lines should play under one transition, or when the
transition runs without a stage change (e.g. a transition flash to
punctuate dialogue).
The transition name is a bare identifier resolved against the
project's transition registry. v1 ships the Ren'Py-aligned built-in
set — fade, dissolve, pixellate, hpunch, vpunch — plus any
project-defined transitions surfaced by the importer's deterministic
pass. Effect-grammar transitions like @shake are not what this
verb takes; those are stage effects, applied by the effects catalog
verbs documented under Effects.