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
  • UDP/TCP Default Port
  • UDP/TCP Network Syntax
  • Network Control
  • Media Types
  • Media Mix Modes
  • Special Codes
  • Syntax Rules
  • Examples
  • Set Media Layer 3 opacity to 50%
  • Set Photon in Sleep Mode
  • Querying System State

Was this helpful?

  1. Step-by-Step Tutorials
  2. Legacy

External TCP/UDP Control Specifications (legacy)

PreviousUpdating a System’s BaselineNextWhat’s New in PXTAC 10.5 ?

Last updated 1 year ago

Was this helpful?

UDP/TCP Default Port

Unless overridden, PHOTON’s default TCP and UDP control port is: 55503

Once commands are received, TCP servers will reply back to each connected client for acknowledgement. UDP commands will be replied to as a broadcast on the main network interface using the same UDP port as configured for reception.

UDP/TCP Network Syntax

[OpCode] [parameters] [layer_id] [OpCode] [parameter]

Spaces above are mandatory, each <tag> must be followed by a space character and each </tag> must be preceded by a space character.

Network Control

COMMAND

OPCODE

PARAMETERS

TYPES

RANGES

Select layer

SET_LAYER

layer_id

[unsigned int32]

[0 ; N]

TimeLine Speed

SET_TIME_SPEED

Speed

[float32]

[-5 ; 5]

TimeLine Seek

SET_TIME_SEEK

Frame #

[unsigned int32]

[0 ; N]

Timeline FreeRun

SET_TIME_FR

FreeRun

on/off

[unsigned int32]

[0 ; 1]

TimeLine LTC

SET_TIME_LTC

Time-Code

on/off

[unsigned int32]

[0 ; 1]

Media Opacity

MEDIA_BLEND

Opacity

[float32]

[0 ; 1]

Media Mix mode

MEDIA_MIX_MODE

Mix mode

[unsigned int32]

[0 ; 6]

Media Frame Blending

MEDIA_FB

Frame Blending

on/off

[unsigned int32]

[0 ; 1]

Media Position

MEDIA_POS

Position X Y

[float32] [float32]

[-2 ; 2]

Media Size

MEDIA_SIZE

Size X Y

[float32] [float32]

[-1 ; 3]

Media Audio Volume

MEDIA_VOL

Volume

[float32]

[-1 ; 3]

Select Media Type

SEL_MEDIA_TYPE

Media type

[unsigned int32]

[0 ; 10]

Select Media ID

SEL_MEDIA_ID

Media #

[unsigned int32]

[0 ; N]

Video Speed

VIDEO_SPEED

Speed

[float32]

[-5 ; 5]

Video FreeRun

VIDEO_FR

FreeRun

on/off

[unsigned int32]

[0 ; 1]

Video-in-time

VIDEO_IN_TIME

Frame #

[unsigned int32]

[0 ; N]

Video-out-time

VIDEO_OUT_TIME

Frame #

[unsigned int32]

[0 ; N]

Execute Cue

CUE_EXEC

Cue # by Index

[unsigned int32]

[0 ; N]

Execute Cue ID

CUE_EXEC_ID

Cue # by ID

[unsigned int32]

[0 ; N]

Special Codes

90BC9E48_6D84_4F8C_ AA23_72E3379AC71C

special_code

[unsigned int]

[0 ; N]

Query sytem state

GET_SYSTEM_STATE

No parameters

Media Types

MEDIA TYPE

FUNCTION

ID

No Media

Nothing in the keyframe

0

Media File

Video file or picture

1

Media Input

DirectShow compatible media input device

2

Light FX

Photon FX.

3

Graphic FX

Unused

4

Cue Control

Predefined Macro in Cue List

5

VNC Input

Remote VNC server screen.

6

PGR Flea

PointGrey Research Flea camera device.

7

Media Sequence

Predefined sequence from Sequence list

8

Media Input Manger

Input device configured in Media_input_manager

9

Media Mix Modes

MIX MODES

FUNCTION

ID

Mix

C1 x a + C2 (1 - a)

0

Add

C1 x a + C2

1

Sub

C1 x a - C2

2

Sub Reverse

C2 - C1 x a

3

Minimum

Minimum (C1 x a, C2)

4

Maximum

Maximum (c1 x a, C2)

5

Special Codes

CODE CONTROL

ID

Normal Mode

0

Sleep Mode

1

Fire Alarm

2

Fire Alarm 2

3

Restart PHOTON

4

Reboot Server

5

Quit PHOTON

6

Shutdown Server

7

PHOTON Offline Mode ON

8

PHOTON Offline Mode OFF

9

PHOTON Toggle UI Visibility

10

Syntax Rules

  • Capitalization must be respected.

  • Spaces between each word are mandatory.

Examples

Set Media Layer 3 opacity to 50%

<photon_layer> 3 MEDIA_BLEND 0.5 </photon_layer>

Set Photon in Sleep Mode

<photon> 90BC9E48_6D84_4F8C_AA23_72E3379AC71C 1 </photon>

Querying System State

<vyv> GET_SYSTEM_STATE </vyv>

When querying system state using the above command, Photon will reply using its internal XML-like syntax. Below is an example of the system-state syntax:

<computer_data> <host_name> Photon-1 </host_name> <cpu_usage> 9.30233 </ cpu_usage> <memory_usage> 23 </memory_usage> <vram_usage> 19.7842 </ vram_usage> <disk_usage> 0.950111 </disk_usage> <opengl_transfer> 110.063 </ opengl_transfer> <gpu_temperature> 77 </gpu_temperature> <fps> 60.0375 </fps> <raid> N/A </raid> <version> 6.1.4798 </version> </computer_data>

HOSTNAME

NAME OF THE SERVER

Cpu usage

Total Percentage of CPU being used

Memory usage

Total percentage of the system memory currently in use

VRAM usage

Total percentage of GPU memory currently in use

Disk usage

Total ratio of HDD usage currently in use (1 means 100%)

OpenGL transfer

Bandwidth of data transferred between System Memory (RAM) & GPU Memory (VRAM) expressed in Mbps.

GPU Temperature

Current temperature of the GPU expressed in Celcius

FPS

System's Current frame-rate.

RAID

RAID system current state (only supported for ERECA controllers at the time of this writing.

Version

Current running system version.

940KB
External_TCP_UDP_Control_Specifications.pdf
pdf
Download step-by-step