API ReferenceGE Extensionsflowgraphnodesscene
Single Marker (Flowgraph Node)
- **Node Name:** `Single Marker`
Overview
- Node Name:
Single Marker - Category: (default, no explicit category)
- File:
extensions/flowgraph/nodes/scene/singleMarker.lua
Displays a single race-style marker at a given position. Must be manually reset when no longer needed. Supports multiple marker types and distance-based fading.
Pin Schema
Input Pins
| Pin | Type | Description |
|---|---|---|
flow | flow | Standard inflow |
reset | flow (impulse) | Removes the marker |
position | vec3 | Marker position |
radius | number or vec3 | Marker radius |
markerType | string | (Hidden) Marker visual type |
color | color | (Hidden) Marker color (default white) |
fadeNearDist | number | (Hidden) Near fade distance |
fadeFarDist | number | (Hidden) Far fade distance |
Output Pins
| Pin | Type | Description |
|---|---|---|
flow | flow | Outflow when marker is active |
Internals
| Field | Purpose |
|---|---|
self.marker | The race marker object (from scenario/race_marker) |
self.data.zOffset | Vertical offset applied to the position |
Available Marker Types
overhead, ringMarker, sideColumnMarker, sideMarker, cylinderMarker, attention, sideHologramMarker, singleHologramMarker
Behavior
work()- Each frame:- On
resetimpulse, hides and destroys the marker. - On flow, creates the marker if needed using
scenario/race_marker.createRaceMarker(). - Updates position/radius when inputs change (optimized to skip unchanged frames).
- Updates color and calls
marker:update()each frame.
- On
fillFields()- Caches position/radius/color and applies z-offset. Returns whether values changed.onDrawOnMinimap()- Draws a simple circle on the minimap when the marker exists.
How It Works
- On first flow, creates a race marker via
scenario/race_marker.createRaceMarker(true, markerType). - Configures the marker as a checkpoint with position, radius, and optional fade distances.
- Each frame, updates the marker's color and calls its
update()method for animation. - The marker persists until
resetis triggered or execution stops.
Key Dependencies
require("scenario/race_marker").createRaceMarker()- marker factorymarker:setToCheckpoint()- configures position and radiusui_apps_minimap_utils.simpleCircleWithEdgePointer()- minimap integration
Additional Methods
C:_afterTrigger()
Called after the node's trigger logic executes.
C:_executionStarted()
Called when graph execution starts. Used for initialization/reset.
C:_executionStopped()
Called when graph execution stops. Used for cleanup.
C:blend()
Node method.
C:hideMarker()
Node method.
C:init(mgr, ...)
Initializes the node, setting up pins and default properties.
Parameters:
mgr...
C:onClientEndMission()
Cleanup callback when the mission/level ends.
C:postInit()
Called after initialization is complete for additional setup.
See Also
- Collection Marker (Flowgraph Node) - Related reference
- Custom Lua Command (Flowgraph Node) - Related reference
- Get Object Field (Flowgraph Node) - Related reference
- FlowGraph Guide - Guide