Popup (Flowgraph Node)

Overview

• Node Name: Popup
• Category: (once, singleActive)
• File: extensions/flowgraph/nodes/ui/missionPopup.lua

Shows a modal popup that can only be dismissed by pressing a button. Commonly used for mission intro popups. Multiple popups queue sequentially.

Pin Schema

Input Pins

Output Pins

Internals

How It Works

1. work() - Main loop:
   • If reset impulse is active: closes dialogue, resets all state and output pins.
   • If not done and flow is active: calls openDialogue().
   • If already done: returns early (once behaviour).
2. openDialogue() - Builds popup data with title, text, and a single button. Triggers guihooks.trigger('introPopupMission', data).
3. started() - Called from the UI button's Lua command. Closes dialogue, sets flow output to true, marks as done.
4. closeDialogue() - Resets open and _active flags.
5. _executionStopped() - Closes dialogue if open and resets state.

The button's click handler is a Lua string that calls back into the node:

core_flowgraphManager.getManagerGraphNode(mgrId, graphId, nodeId):started()

Lua Code Example

-- Equivalent guihooks call:
guihooks.trigger('introPopupMission', {
  title = "Welcome to the Race",
  text = "Complete 3 laps to win!",
  buttons = {
    {
      default = true,
      class = "main",
      label = "ui.scenarios.start.start",
      clickLua = 'core_flowgraphManager.getManagerGraphNode(1, 2, 3):started()'
    }
  }
})

Key Dependencies

• guihooks.trigger('introPopupMission', data) - Mission intro popup UI
• core_flowgraphManager.getManagerGraphNode() - Node callback from UI
• core_input_bindings - Listed dependency

Previously Undocumented (Added by Audit)

• C:buttonPushed(action) - Function handling buttonPushed logic
• C:getCmd(action) - Function handling getCmd logic
• C:onFilteredInputChanged(devName, action, value) - Function handling onFilteredInputChanged logic

See Also

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