Eve library

Dialogue Presentation Guide

Guide

Revision 1

On this page

The dialogue subsystem now exposes renderer-neutral presentation data for cinematic conversations and accessible dialogue UI.

Cinematic Plans#

  • createDialogueCameraPlan builds over-the-shoulder, shot-reverse-shot, close-up, extreme close-up, medium, and wide shots, then selects the active shot from dialogue tags and node type.
  • createDialogueStagingPlan positions speakers and listeners with idle speaking/listening animation hints and facing targets.
  • createDialogueCinematicBlendPlan describes the transition from gameplay camera to dialogue shot and back.

Performance Cues#

  • createDialogueLipSyncPlan maps dialogue text and voice-over assets to phoneme timing cues.
  • createDialogueFacialExpressionPlan turns emotion metadata and tags into facial blend weights.
  • createDialogueGesturePlan turns tags such as [nod], [point], and [important] into actor gesture cues.
  • createDialogueAmbientAnimationPlan supplies looped breathing, fidget, and look-around cues for participants.

UI, Audio, and Accessibility#

  • createDialogueAudioPlaybackPlan resolves voice-over clips, sound cues, subtitle timing, and music/ambient ducking.
  • createDialogueUIViewModel exposes speaker, portrait, text, choices, and continue/auto-advance state for dialogue UI.
  • createDialogueSubtitleCues emits speaker subtitles and non-verbal captions.
  • skipDialogue supports skipping the current line, skipping to the next choice, or ending the conversation.
  • createDialogueLog creates a scrollable conversation history from dialogue history entries.
  • createDialogueEditorGraph exports a visual node graph for editor previews.
  • createDialogueAccessibleViewModel applies text scale, background opacity, auto-advance, and TTS settings.