FolioTier 2

@dissolve

Cross-fade from the prior stage state to the pending one.

Demo

@dissolve

Hello.

A triangular opacity dip on the stage layer — backdrop and sprites fade through black to the player surface and return. The textbox stays at full opacity throughout.

Parameters

ParameterKindRequiredDefaultNotes
durationnumberno0.5Seconds the cross-fade takes. Range `0.05`–`3.0`. Shorter values feel like cuts with a softened edge; longer values feel like time passing.

Canonical example

Folio
bg bg-kitchen-morning
@dissolve duration=0.5
say "Emma": "Morning, already?"
Ren'Py
scene bg kitchen_morning
with Dissolve(0.5)
e "Morning, already?"

@dissolve applies after one or more pending stage operations (scene, show, hide) on the preceding lines. The pending state fades in over the duration while the prior state fades out, then the next line runs.

Notes

@dissolve and transition dissolve overlap in intent. The distinction is parameter access:

  • transition dissolve — Ren'Py-aligned named transition. No parameters; the runtime applies the project's registered defaults.
  • @dissolve duration=N — effects-catalog form. Duration is an explicit slot.

The importer's deterministic pass keeps bare with dissolve as transition dissolve to preserve the no-parameters reading. It upgrades parameterized with Dissolve(N) calls to @dissolve duration=N. Either form is valid Folio; reach for whichever matches authorial intent.

Dissolve is the most-used transition in the corpus — 8502 hits across the-question + Acting Lessons alone. Defaulting duration to 0.5s matches Ren'Py's Dissolve() default and reads cleanly in both narrative beats and montages.

See also

  • @fade — fade-out through a color, then fade-in (different shape, similar role)
  • transition — the bare named-transition verb (transition dissolve is the no-parameters form of this effect)
  • scene — the verb most often paired with @dissolve