API ReferenceGE Extensionsflowgraphnodesui
On Bigmap Poi (Flowgraph Node)
- **Node Name:** `On Bigmap Poi`
Overview
- Node Name:
On Bigmap Poi - Category:
repeat_instant - File:
extensions/flowgraph/nodes/ui/onBigmapPoiSelected.lua
Detects when a POI (Point of Interest) is selected or navigated to on the bigmap. Provides impulse outputs for selection/deselection and navigation events.
Pin Schema
Output Pins
| Pin | Type | Impulse | Description |
|---|---|---|---|
selected | flow | yes | Fires once when a POI is selected |
deselected | flow | yes | Fires once when a POI is deselected |
poiId | string | no | ID of the currently selected POI |
navigated | flow | yes | Fires once when a location is navigated to |
denavigated | flow | yes | Fires once when navigation is reset |
pos | vec3 | no | Position that was navigated to |
Internals
| Field | Purpose |
|---|---|
self.flags | Table of pending flag events to process next frame |
self.navPos | vec3 of the navigation target position |
self.poiId | Currently selected POI ID |
How It Works
work()- Called every frame:- Resets all impulse outputs to
false. - Applies any pending flags from
self.flagsto the output pins. - Outputs the current
poiIdandnavPos(as table viatoTable()). - Clears the flags table.
- Resets all impulse outputs to
onPoiSelectedFromBigmap(poiId)- Hook callback:- If
poiIdis truthy, setsselectedflag; otherwise setsdeselectedflag. - Stores the POI ID.
- If
onSetBigmapNavFocus(pos)- Hook callback:- If
posis truthy, setsnavigatedflag; otherwise setsdenavigatedflag. - Stores the position (defaults to
vec3()if nil).
- If
The node uses a flags-based pattern: hooks set flags, and the next work() call converts them to output pin values, ensuring impulse outputs fire for exactly one frame.
Lua Code Example
-- These are the hooks the node listens to:
-- Called when user selects a POI on the bigmap:
extensions.hook("onPoiSelectedFromBigmap", "poi_gasStation_01")
-- Called when user sets navigation target:
extensions.hook("onSetBigmapNavFocus", vec3(100, 200, 50))
-- Called when navigation is cleared:
extensions.hook("onSetBigmapNavFocus", nil)Key Dependencies
onPoiSelectedFromBigmaphook - Fired by the bigmap UI on POI selectiononSetBigmapNavFocushook - Fired by the bigmap UI on navigation target change
See Also
- Medal / Auto Medal (Flowgraph Node) - Related reference
- Clear Messages (Flowgraph Node) - Related reference
- Context Translation (Flowgraph Node) - Related reference
- FlowGraph Guide - Guide