Capture - 2023
Capture 2023 is a platform native macOS and Windows application designed to save time with lighting design, documentation and visualisation software that is both easy to learn and rewarding to use! Capture is lets you work with lighting, video, laser, moving scenery and water effects.
This Ctrl Suite module provides integration with Captures OSC API to control camera position, ambient lighting and more from an interface. Recall scenes with multiple OSC strings at the touch of a button.
Ideal for visualisation studios who want to put control of the virtual world into the hands of their client when previewing stage designs using user interfaces.
This Ctrl Suite Module implements all key outgoing commands of the Capture 2023 OSC API.
| Module Rating | |
|---|---|
| Quality of API | 3/3 |
| Implementation | 2/3 |
| Status | Complete |
See the Modules Overview article for information about how Module Ratings are calculated.
Module Settings
- Capture 2023 Patch - Select an OSC patch (IP address) from the Module Settings.
Process Block
After creating a Capture 2023 module, a block will be generated for it within Ctrl Suite's Process Editor for integration as part of a process flow.
Add a Process node or edit an existing one to use the block's full functionality.
Endpoints
View Properties
These methods change the corresponding view properties.
Indexes reference the Alpha, Beta and Gamma views within Capture 2023. The Live variants of each command are a convenience for addressing the first (lowest index) view in live mode.
For example: Set Bloom Live "0.3" - sets bloom to 30% in the first view currently in live mode.
| Endpoints | Option 1 | Option 2 |
|---|---|---|
| Set Ambient Lighting Level | Index [Alpha/Beta/Gamma] | Light Level [0..1] |
| Set Ambient Lighting Level Live | Light Level [0..1] | - |
| Set Automatic Exposure | Index [Alpha/Beta/Gamma] | Status [Off/On] |
| Set Automatic Exposure Live | Status [Off/On] | - |
| Set Bloom | Index [Alpha/Beta/Gamma] | Bloom Level [0..1] |
| Set Bloom Live | Bloom Level [0..1] | - |
| Set Exposure Adjustment | Index [Alpha/Beta/Gamma] | Adjustment [-3..3] |
| Set Exposure Adjustment Live | Adjustment [-3..3] | - |
| Set Fill Lighting Level | Index [Alpha/Beta/Gamma] | Fill Light Level [0..1] |
| Set Fill Lighting Level Live | Fill Light Level [0..1] | - |
| Set Hue Clamp | Index [Alpha/Beta/Gamma] | Level [0..1] |
| Set Hue Clamp Live | Level [0..1] | - |
| Laser Flicker Effect | Index [Alpha/Beta/Gamma] | Status [Off/On] |
| Laser Flicker Effect Live | Status [Off/On] | - |
| Set White Balance | Index [Alpha/Beta/Gamma] | White Balance [2500..10000] |
| Set White Balance Live | White Balance [2500..10000] | - |
Camera Position
These methods trigger a camera position change for a view.
Set Time, Dampening and Curvature to [0] for an instant transition.
Indexes [0] to [2] correspond to the Alpha, Beta and Gamma views. The live notation is a convenience for addressing the first (lowest index) view in live mode.
| Endpoints | Option 1 | Option 2 | Option 3 | Option 4 | Option 5 | Option 6 |
|---|---|---|---|---|---|---|
| Set Camera Position | Index [Alpha/Beta/Gamma] | Catalog Number [1..255] | Position Number [1..255] | Time (Seconds) [0..600] | Dampening [0..1] | Curvature [0..1] |
| Set Camera Position Live | Catalog Number [1..255] | Position Number [1..255] | Time (Seconds) [0..600] | Dampening [0..1] | Curvature [0..1] | - |
Note: The implementation of the Capture 2023 API is currently one way only.
Troubleshooting:
- Ensure that your OSC Patch references the correct IP address and that the port number is set to 4004.
- If running Capture 2023 on a seperate computer, make sure that a Firewall exception is made to allow OSC packets to flow into Capture from Ctrl Suite.
- When using OSC, ON LX reccomends the use of a wired network as opposed to WiFi wherever possible, for further advice surrounding UDP based protocols see this article.