Sources
Sources are the visual pattern generators that create the base visual content in FXCanvas. They produce animated colors and patterns that form the foundation of your lighting design, which can then be enhanced with effects and mapped to your fixtures.
What are Sources?
A source is a GPU-accelerated shader that generates animated visual patterns. Each source type produces a distinct visual style, from smooth flowing gradients to rhythmic pulsing rings.
Sources are designed specifically for lighting applications:
- Color palette integration — Sources use the active color palette rather than fixed colors
- BPM sync ready — Parameters like Speed can sync to the beat for music-reactive visuals
- Low resolution optimized — Patterns are designed to look great even at LED fixture resolutions
Think of sources as your visual starting point. You select a source, adjust its parameters, and the output feeds into your effects chain before being mapped to fixtures.
Using the Source Presets Panel
The Source Presets panel is your library of available sources and saved configurations.
Browsing Sources
Sources are organized in a hierarchical tree view grouped by type:
- Type headers — Click the arrow to expand/collapse a source type
- Preset list — Individual presets appear under each type
- Icons — A cube icon indicates built-in presets, a user icon indicates your custom presets
Loading a Source
There are two ways to load a source:
- Double-click the type header — Loads the source with default parameter values. This is the quickest way to try a new source type.
- Double-click a preset — Loads the source with the preset's saved parameter values. Use this when you want a specific look.
Hover over any type header or preset to see a tooltip with more information.
View Mode Filters
At the top of the panel, toggle buttons filter which presets are shown:
| Icon | Filter | Description |
|---|---|---|
| Cube | Built-In | Factory presets that ship with FXCanvas |
| User | My Presets | Custom presets you've created |
| Theater masks | In Show | Presets saved to the current show file |
You can enable multiple filters at once to see presets from different categories.
Type Filter
Use the dropdown to filter by source type:
- All Sources — Show every available source type
- Individual types — Select a specific type to focus on one category
Source Parameters Panel
The Source Parameters panel displays controls for the currently active source.
Panel Header
The header shows:
- Preset indicator — Shows "Preset: [Name]" when a preset is loaded, or "Preset: Not Saved*" when parameters have been modified
- Source type — The underlying source type displayed as "Type: [name]"
When a preset has unsaved changes, the preset label displays in orange text with an asterisk (*) appended. The panel tab also shows an orange overline to indicate unsaved content.
Common Parameters
While each source has its own parameters, many share these common ones:
| Parameter | Description |
|---|---|
| Speed | Controls how fast the pattern animates. Higher values create more energetic movement. |
| Softness | Controls edge hardness. Lower values create sharp edges, higher values create smooth transitions. |
Other parameters vary by source type. Select a source to see its specific parameters in the panel.
BPM Sync for Parameters
Any numeric parameter can be synced to the beat:
- Right-click a parameter to access BPM sync options
- When synced, the parameter oscillates between a min and max range in time with the beat
- The sync indicator pulses to show the current beat phase
Speed is especially powerful when synced to the beat — patterns surge and relax with the music.
Saving Changes
- Save — Updates the current preset with your changes (only for user presets, not built-in)
- Save As... — Creates a new preset with a custom name
Built-in presets cannot be overwritten. Use Save As to create your own version.
Available Sources
FXCanvas includes 9 built-in source types:
| Source | Category | Description |
|---|---|---|
| Bars | Pattern | Scrolling bar patterns, great for fixtures arranged in rows |
| Drift | Ambient | Slowly drifting organic patterns |
| Flow | Ambient | Flowing, fluid-like animations |
| Gradient | Ambient | Smooth color gradient transitions |
| Plasma | Ambient | Classic plasma effect with organic movement |
| Pulse | Ambient | Radial pulsing rings from a configurable center point |
| Scanner | Pattern | Scanning beam effects |
| Spiral | Pattern | Rotating spiral patterns |
| Wave | Pattern | Sinusoidal waves with configurable direction |
Working with Source Presets
Creating Custom Presets
To save your current source configuration:
- Adjust source parameters to your liking
- Click Save As... in the Source Parameters panel
- Enter a name for your preset
- Click Save
Your preset appears in the Source Presets panel under My Presets.
Managing Presets
Right-click any preset to access the context menu:
| Action | Description |
|---|---|
| Load | Apply this preset to the current source |
| Rename | Change the preset name (user presets only) |
| Add to Show | Copy the preset to your current show file |
| Delete | Remove the preset (user presets only) |
Built-in presets cannot be renamed or deleted.
Preset Storage Locations
FXCanvas stores presets in different locations:
- Built-in presets — Ship with the application, read-only
- User presets — Stored in your user profile, available across all shows
- Show presets — Saved within a show file, travel with the show
Use Add to Show to include a preset in your show file for portability.
Tips and Best Practices
Choosing Sources for Different Scenarios
Ambient / Background
- Use Ambient category sources (Drift, Flow, Gradient, Plasma, Pulse) for calm atmospheres
- Lower speed values create peaceful, meditative moods
- Enable BPM sync with wide ranges for subtle musical response
High Energy / Drops
- Use Pattern category sources (Bars, Scanner, Spiral, Wave) for punchy, rhythmic looks
- Higher speeds and lower softness values increase intensity
- BPM sync with tight ranges creates strong beat-locked movement
Performance Considerations
Sources are GPU-accelerated and generally lightweight. If experiencing performance issues with complex shows, consider reducing the number of stacked effects rather than simplifying sources.
Related Topics
- Video Inputs — Use external video feeds (webcams, NDI, Spout/Syphon, DeckLink) as sources
- Sources Reference — Complete parameter reference for all source types
- BPM Sync — Synchronize source parameters to the beat
- Getting Started — Overview of FXCanvas basics