How Text Studio Thinks

Source, Live Preview, and backends

Source is the text you author, including effect and action tags. Live Preview is the player-facing result after Text Studio resolves tags, profiles, external sources, and the active renderer. Edit in Raw and judge the experience in Live.

Text Studio automatically uses an attached compatible backend such as UniText 3 and falls back to TextMeshPro when needed. Raw mirrors direct component edits as authoring input. In Live Preview and Play Mode, direct backend writes warn and are rejected by default so rendered plain text cannot silently replace tagged source. The Expert Direct Backend Writes setting can deliberately Import or Ignore those writes; editor imports participate in Undo.

Reveal, Active, and Hide

Reveal controls how text enters. Active controls what continues after the text is readable. Hide controls how it leaves. A treatment can use one phase or move smoothly through all three. Reveal-to-Active Blend prevents a hard visual jump when an entrance becomes a looping effect.

Area and Sequence

An effect can act on each glyph, grouped glyphs, words, lines, paragraphs, authored ranges, or spatial fields. Sequence controls the order: forward, reverse, center-out, edges-in, all at once, or repeatable random.

The same Bounce effect grouped by glyphs, pairs, words, and the whole range.

Motion policy

Project settings and each text object can choose Full, Reduced, or No Motion. Reduced Motion keeps the meaning while lowering displacement, rotation, flashing, or depth travel. No Motion keeps a stable readable result. Warnings appear when authored flashing can exceed three flashes per second.

Read the inspector as a workflow

The main inspector follows the order in which most text is built. Its preview stays available above the workflow tabs, so you can change one decision and immediately judge the complete player-facing result.

• Content owns Source, Raw and Live authoring, the active backend, the + Tag workflow, Behavior Profile assignment, default effects, and markup diagnostics.
• Typewriter owns the explicit None, Built-In, Custom, or Inline source, reveal unit, cadence, motion, loop, skip, waits, and hide behavior.
• Placement owns the baseline, orientation, extension providers, and the Shared Spatial Target used by target-aware effects.
• Events owns lifecycle callbacks, glyph callbacks, waits, markers, relays, and dialogue handoff.
• Debug explains resolved text, semantic ranges, active bindings, action markers, renderer capabilities, source ownership, timing, and current state.

Use the preview transport

Reveal, Active, and Hide select the lifecycle segment you are examining. Drag the scrubber to evaluate an exact state; scrubbing pauses playback so the frame remains stable while you inspect it. Play or Pause resumes or freezes the complete preview, including reveal, actions, substitutions, effects, placement, and renderer time.

Use 0.25x, 0.5x, 1x, 2x, or 4x speed to study timing without rewriting the authored recipe. For Active effects, the x1, x2, x4, and x8 duration multiplier gives long loops more room in the scrubber and remains preview-only. Repeat is also transient. Restart returns the preview to the beginning and resets lifecycle state, visibility, waits, and actions before playing again.

Preview is a transport, not an authoring source. Speed, repeat, segment choice, active-duration range, and the current scrub position never rewrite Source, a Behavior Profile, a Typewriter Preset, or effect timing.

Glyphs, groups, ranges, and sequences

A glyph is one visible semantic text unit. It is not necessarily one UTF-16 character, because shaping, ligatures, surrogate pairs, combining marks, and fallback fonts can change how source characters become visible glyphs. Effects and reveal operate on visible glyph identity while Text Studio retains source mappings for diagnostics, markers, and integrations.

Area chooses the unit that receives one effect evaluation. Glyph treats every glyph independently. Word, Line, and Paragraph share one state across the corresponding semantic group. Range uses the authored tag range. Group Size combines consecutive units. Sequence then chooses the order in which those resolved units receive progress.

• Forward follows the source order. Reverse starts from the end.
• Center Out starts near the middle. Edges In starts at both ends.
• All At Once gives every unit the same progress.
• Seeded Random produces a stable shuffled order for the same source and seed.

The three visual phases

Reveal describes how a range enters, Active describes what continues after it becomes readable, and Hide describes how it leaves. A layer can participate in any combination. A reveal treatment should normally settle to the authored layout before an Active loop takes over, and a Hide treatment should begin from the current visible state.

Reveal-to-Active Blend crossfades the outgoing reveal contribution and incoming Active contribution for 0 to 5 seconds. Use a short blend when an entrance and a loop affect the same channel. Set it to zero only when an immediate handoff is intentional.

Time, playback, and motion policy

Timing answers when a unit receives progress. A curve answers how that progress changes. Playback answers whether an effect runs once, loops, ping-pongs, follows an external weight, or holds a final value. These choices are independent of area and sequence.

Full Motion uses the authored treatment. Reduced Motion retains meaning while lowering travel, rotation, depth, flashing, or procedural instability. No Motion keeps a stable readable result. Author every production recipe with a restrained fallback, especially subtitles, warnings, and interactive UI.

Accessibility rule: first reduce displacement, rotation, depth travel, flashing, and rapid color contrast. Do not remove timing, semantic emphasis, or readable state changes unless they are also unnecessary.