Fade From Black (Flowgraph Node)

Overview

• Node Name: Fade From Black
• Category: once_f_duration
• File: extensions/flowgraph/nodes/ui/fadeFromBlack.lua

Fades the screen from black back to normal view. Uses the duration-based node pattern with complete output flow when finished.

Pin Schema

Input Pins

Output Pins (inherited from once_f_duration)

Internals

Key Methods

Duration States

Uses the standard duration node pattern: inactive → started → finished.

How It Works

1. When triggered, workOnce() sets duration state to started.
2. If the game is currently in a loading state (core_gamestate.loading()), it calls server.fadeoutLoadingScreen() and finishes immediately.
3. Otherwise, calls ui_fadeScreen.fadeFromBlack(duration).
4. When the fade completes, onScreenFadeState(3) fires and sets the duration to finished, activating the complete output.

Usage Example

-- Typical flowgraph pattern:
-- [Some Action] → [Fade From Black (duration=0.75)] → [Next Action]
--
-- The node calls:
ui_fadeScreen.fadeFromBlack(0.75)
-- and waits for onScreenFadeState(3) before passing flow.

Key Dependencies

• ui_fadeScreen.fadeFromBlack() - performs the actual screen fade
• core_gamestate.loading() - checks if game is in loading state
• server.fadeoutLoadingScreen() - fades out loading screen if active

See Also

• Medal / Auto Medal (Flowgraph Node) - Related reference
• Clear Messages (Flowgraph Node) - Related reference
• Context Translation (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide