Simple Cam Path (Flowgraph Node)

Overview

• Node Name: Simple Cam Path
• Category: once_f_duration
• File: extensions/flowgraph/nodes/scene/camera/cameraPath.lua
• Icon: Camera icon
• Color: Camera color

Plays back a camera path defined by a .camPath.json file. Supports looping and reports completion.

Pin Schema

Input Pins

Output Pins

Legacy Pin Names

• finished → complete (output)
• stopped → inactive (output)
• start → flow (input)

Internals

• self.activatedFlag - used to produce a single-frame impulse for activated.
• self.durationState - 'inactive' → 'started' → 'finished'.
• Uses self.mgr.modules.camera for path management.
• postInit() configures the file picker to filter .camPath.json files.
• _onDeserialized() restores the loop hardcoded value from saved data.

How It Works

1. Start (workOnce) - Finds the camera path by name via modules.camera:findPath(), starts it with modules.camera:startPath(), and fires the activated impulse.
2. Running (work, state started):
   • Clears the activated impulse after one frame.
   • Checks if the path is still active via modules.camera.activePathId.
   • If the path is complete (isPathComplete), transitions to finished.
   • Outputs the path duration via getPathDuration.
   • If the path is no longer active, outputs inactive = true.
3. Duration node - Uses once_f_duration category, so the flowgraph duration system tracks start/finish automatically.

Lua Code Example

-- Play a cinematic camera path:
-- cameraPath (pathName = "cinematics/intro.camPath.json", loop = false)
--   .id → store for later reference
--   duration complete → next scene

-- Loop a showcase orbit:
-- cameraPath (pathName = "showcase/orbit.camPath.json", loop = true)

Key Dependencies

• self.mgr.modules.camera - findPath(), startPath(), activePathId, isPathComplete(), getPathDuration()
• .camPath.json files - camera path data format

Additional Methods

C:_executionStarted()

Called when graph execution starts. Used for initialization/reset.

C:drawMiddle(builder, style)

Custom ImGui drawing in the middle section of the node in the editor.

Parameters:

• builder
• style

C:init()

Initializes the node, setting up pins and default properties.

C:onNodeReset()

Called when the node is reset.

See Also

• Camera Transform (Flowgraph Node) - Related reference
• Camera Look at Position (Flowgraph Node) - Related reference
• Camera Auto Circle (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide