Documentation
  • VYV Documentation
  • ❗What's New in V11
    • What's New in V11.3?
    • PHOTON - V11.1 Release Note
    • XENON - V11.1 Release Note
    • TACHYON - V11.1 Release Note
  • 📍Get To Know PHOTON
    • Get Started - A Quick Start Guide
    • UI Basics
    • PHOTON Shortcuts
  • User Guide
    • 1. Prerequisites
      • 1. Before Starting PHOTON
      • 2. Fundamentals of PHOTON and its User Interface
    • 2. Setting-Up a Show
      • 1. Settings
      • 2. 3D Scene
        • Hierarchy Rendering
    • 3. Importing Content
      • 1. File Manager
      • 2. Imports
      • 3. Conversions
      • 4. Files Management and Display
      • 5. Playlists
      • 6. File Versioning
    • 4. Programming a Show
      • 1. Cue Editor
      • 2. Timeline
      • 3. Shared Clip Properties
      • 4. Color Correction
  • Modules Overview
    • Settings
    • 3D Scene
    • Timeline
    • Keyframe Editor
    • Color Correction
    • Preview
    • File Manager
    • FX Graph
    • I/O Manager
    • Cue Editor
    • Mapping Manager
    • Network Monitor
    • Output Control
    • Timecode
    • Rendering
    • Shadow
  • Step-by-Step Tutorials
    • Navigation & UI
      • Drag and Drop in PHOTON
      • Find in...
      • Frame and Reset View in PHOTON
    • ALBION
      • ALBION & Lighting consoles integration (guide)
        • PHOTON | grandMA Project Link
          • 1. Create and Define the ALBION Preset Type and its Attributes in the grandMA
          • 2. DMX Universes Merge
          • 3. Export Fixture Types and GrandMA Patch
          • 4. Import Fixture Type and grandMA Patch into PHOTON
          • 5. Light Fixture Calibration
          • 6. Interactive Lighting Fixture Control
          • 7. ALBION Attributes Descriptions
      • ALBION & Lighting consoles integration (video)
    • Programming
      • Create Regions and Jump Between them with a Cue
    • 3D Scene
      • Projection Study Guide
      • Camera Calibration Based on 3D Plane
      • Make a Fly Through of the 3D Scene
      • Automatic Calibration and Real Time Alignment Guide
      • Primitives Tracking
      • Create a 3D Animation Curve
    • File Managment
      • File Manager: Playlists
      • File Manger: Manage Files
      • File Manager: Display Files
      • File Manager: Import and Convert
      • File Manager: Advanced Topics
      • Audio Multichannel Export
      • Export Multichannel Audio from DaVinci Resolve
    • I/O
      • Midi
        • Map a MIDI Slider in Photon
      • Projector Control
        • Control Projectors with Cues
      • Network Messages & External Control
        • Connect PHOTON and QLab Through UDP
        • External TCP/UDP Control Specifications
    • FX
      • Notch Integration
      • Use A Graph Asset to Create a FX
      • Controlling an addressable LED strip using the Art-Net Mapping node
      • Interactive Floor with One OptiTrack Camera
    • Rendering
      • 2D Video Rendering
      • 3D Video Rendering
    • Timecode
      • Use Timecode in PHOTON
    • Legacy
      • Updating a System’s Baseline
      • External TCP/UDP Control Specifications (legacy)
  • Older versions
    • What’s New in PXTAC 10.5 ?
    • What's New in PHOTON 10.5
    • Download Documentation - Version 1.2, Product version 9
    • V8.1 Release Note
    • V7.9 Release Note
Powered by GitBook
On this page
  • Description
  • Step-by-step tutorial
  • Send UDP from PHOTON
  • Receive UDP in PHOTON

Was this helpful?

  1. Step-by-Step Tutorials
  2. I/O
  3. Network Messages & External Control

Connect PHOTON and QLab Through UDP

PreviousNetwork Messages & External ControlNextExternal TCP/UDP Control Specifications

Last updated 2 years ago

Was this helpful?

Description

PHOTON has the capacity to send and listen to messages written in the UDP protocol. This means that PHOTON can trigger or be triggered by other UDP compatible devices on a network.

This guide presents the steps involved into configuring QLab and PHOTON correctly so they can send basic commands to each other, such as pause and play.

The communicating computers first need to be set on the same network. For example, PHOTON’s IP address could be set at 172.17.1.11 and QLab’ IP address at 172.17.1.111, both having subnet mask set to 255.255.255.0.

  • Once the network settings are ok for both parties, go to the OSC tab of the preferences menu [CMD+,] in QLab.

  • In an empty patch slot, add PHOTON as a destination and correctly set the IP address and port.

The default communication port to send UDP commands to PHOTON is 55503.

  • Next, in PHOTON, configure the destination you want to send cues to. Open to the I\O manager [ALT+i] and click of the Network Protocol tab.

The cue must match QLab’s IP address and communication port.

The default port to send UDP to QLab is 53535.

The syntax QLab is using. If the user wishes to launch cue number1 the syntax should be as follow: /cue/{number}/start. The same applies for a stop except you use the Stop command; /cue/{number}/stop. It is important to add a space before the slash in the command line for QLab.

To send cues from Qlab to PHOTON, the user needs to drop an OSC cue in the cue list. Then, in the Settings tab, at the bottom of the workspace, the destination needs to be set to PHOTON. The message type should be changed to Raw UDP string (instead of OSC). Finally, the proper command shall be entered in the message box with the correct syntax.

Step-by-step tutorial

Send UDP from PHOTON

This portion of the step-by-step shows how to use PHOTON to trigger an audio cue in QLab.

QLab

  1. Create a new audio cue. Select {Cues > Audio} or press [Cmd+1].

  2. Make sure the Basics tab is selected.

  3. Enter a cue Number in the Number field.

  4. Select an audio file as the cue Target.

PHOTON

  1. Open the I/O Manager module. Select {System > I/O Manager} or press [Alt+I].

  2. Select the Network Protocol tab.

  3. Add a new message by clicking on the [+] button.

  4. Select UDP as Message type.

  5. Configure the IP address and port of the computer running QLab. The default communication port to send UDP commands to QLab is 53535.

  6. Enter the message to trigger a cue in QLab. To start a cue : /cue/{number}/start

  7. Press on the [Send] button

  8. To create a Send UDP cue on the Timeline, open the Cue Editor module. Select {Show > Cue Editor} or press [Alt+Q].

  9. To view the full cue list, select {View > View Full}.

  10. Create a new cue by clicking on the [+] button.

  11. Click on the [Record] button to record your action.

  12. Navigate back to the I/O Manager module. Select {System > I/O Manager} or press [Alt+I].

  13. Click on the [Send] button.

  14. Navigate back to the Cue Editor module. Select {Show > Cue Editor} or press [Alt+Q].

  15. Click on the [Record] button again to stop recording your action.

  16. Open the Timeline module. Select {Show>Timeline} or press [Alt+T].

  17. Create a new Cue Clip on the Timeline. Right-click on a layer track to open a contextual menu and select {Add Cue} or press [Ctrl+U].

  18. Navigate to Cue Properties and select your Cue as its source.

  19. Click-drag the Playhead to position it before the Cue Clip on the Timeline then press the [spacebar] to resume playback.

  20. The Cue will be executed when the Playhead intersects the Cue Clip.

Receive UDP in PHOTON

This portion of the step-by-step shows how to use QLab to send a UDP message to PHOTON.

QLab

  1. Open the Settings menu. Click on the gear icon at the lower right corner of the window.

  2. Select the Network tab.

  3. Add a new network patch. Click on the [New Patch] button or press [CMD+N]

  4. Add PHOTON as a destination and set its IP address and port. The default communication port to send UDP commands to PHOTON is 55503.

  5. Add a new network cue. Select {Cues > Network} or press [CMD+8].

  6. In the Settings tab, enter PHOTON’s IP address and port as the destination.

  7. Select UDP message from the Type dropdown menu.

  8. Entered the command in the message box with the correct syntax.

  9. In this example, we will use QLab Network Cue to trigger Cue ID 1 set in Photon. Enter <photon> CUE_EXEC_ID 1 </photon> in the message box.

PHOTON

  1. Open the Timeline module. Select {Show>Timeline} or press [Alt+T].

  2. Locate Regions Editing in the Timeline window and click on the [+] button to create a new Region.

  3. Set the In-point at 00:00:00:00.

  4. Set Out-point at 00:02:00:00.

  5. Open the Cue Editor module. Select {Show>Cue Editor} or press [Alt+Q].

  6. To view the full cue list, select {View > View Full}.

  7. Create a new cue. Click on the [+] button.

  8. Set the Cue ID to 1.

  9. Press the [Record] button.

  10. Navigate back to the Timeline module. Select {Show>Timeline} or press [Alt+T].

  11. Select region 1.

  12. Navigate back to the Cue Editor module. Select {Show > Cue Editor} or press [Alt+Q].

  13. Click on the [Record] button again to stop recording your action.

  14. To make sure the communication between QLab and Photon is set up correctly, open the Logs module. Select {System > Tools > Monitoring > Logs} or press [Alt+L].

QLab

  1. Select the network cue in your workspace.

  2. Select the Settings tab.

  3. Click on the [Send] button.

PHOTON

If the communication between computers and your UDP message string are set up correctly the Logs will display: SHOW CONTROL : {your UDP message}.

Connect Photon and QLab throught UDP (Receive UDP in PHOTON)
639KB
Connect_PHOTON_and_QLab_Through_UDP.pdf
pdf
Download step-by-step