How vaaghu/natron works
Natron is a node-based video compositor. Users build a compositing graph, bring in footage, apply effects and animation, preview the result, and render frames or sequences. Its engine owns nodes, projects, image processing, and rendering; the GUI exposes graph editing, parameters, timelines, and viewers. The README documents broad capabilities and workflows, while the sampled source chiefly shows application-manager setup and selected integration points; edges below rely on README-documented relationships rather than claiming unsampled calls were inspected.
Main entry points: Gui.h Desktop interface · GuiApplicationManager.cpp GUI application manager · OutputSchedulerThread.cpp Render scheduling · Node.h Composition nodes
Components 24
Application
- Desktop interface
Gui/Gui.h - GUI application manager
Gui/GuiApplicationManager.cpp - GUI manager state
Gui/GuiApplicationManagerPrivate.cpp - GUI application instance
Gui/GuiAppInstance.h - Documentation service
Gui/DocumentationManager.cpp - Application manager
Engine/AppManager.h - Application settings
Engine/Settings.h - Parameter widgets
Gui/KnobGuiFactory.h
Composition
- Project state
Engine/Project.h - Node creation arguments
Engine/CreateNodeArgs.h - Composition nodes
Engine/Node.h - Parameters and keyframes
Engine/Knob.h - Curve and dope sheet
Gui/CurveEditor.cpp - Roto and tracking
Engine/RotoContext.cpp
Image and render
- Footage input
Engine/ReadNode.cpp - Image effects
Engine/EffectInstance.cpp - Render scheduling
Engine/OutputSchedulerThread.cpp - RAM and disk cache
Engine/Cache.cpp - Interactive viewer
Engine/ViewerInstance.cpp - Frame output
Engine/WriteNode.cpp
Extensions and scripting
- Media and color support
Engine/OfxHost.cpp - OpenFX plugins
- Python scripting
Engine/PyAppInstance.cpp
Other components
- Compositor
Connections 25
- Compositor → Desktop interface: edits composition
- Desktop interface → GUI application manager: uses interface
Gui/GuiApplicationManager.cpp - GUI application manager → GUI application instance: manages instances
Gui/GuiApplicationManager.cpp - GUI application manager → GUI manager state: uses private state
Gui/GuiApplicationManager.cpp - GUI application manager → Documentation service: starts service
Gui/GuiApplicationManager.cpp - GUI application manager → Application manager: extends manager
- GUI application manager → Application settings: uses settings
Gui/GuiApplicationManager.cpp - Desktop interface → Project state: edits project
- Desktop interface → Node creation arguments: creates nodes
Gui/GuiApplicationManager10.cpp - Node creation arguments → Composition nodes: configures node
Engine/CreateNodeArgs.h - Project state → Composition nodes: stores graph
Engine/Project.h - Desktop interface → Parameters and keyframes: edits parameters
- Desktop interface → Curve and dope sheet: edits keyframes
- Desktop interface → Roto and tracking: creates roto and tracks
- Composition nodes → Footage input: includes footage input
- Composition nodes → Image effects: composes effects
- Image effects → Render scheduling: renders frames
- Render scheduling → RAM and disk cache: uses frame cache
- Render scheduling → Interactive viewer: feeds preview
- Render scheduling → Frame output: renders output
- Footage input → Media and color support: supports media and color
- Image effects → OpenFX plugins: hosts plugins
- Desktop interface → Parameter widgets: builds parameter UI
Gui/GuiApplicationManagerPrivate.cpp - Compositor → Python scripting: scripts application
- Python scripting → Project state: controls project