OpenFollow Preview

Manual / How To

Move lights with grandMA3

Refer to the official MA Lighting documentation for the up-to-date setup steps on your console version: MA Lighting grandMA3 Help – XYZ Marker (covers receiving PSN tracker data into XYZ markers). See also the general XYZ overview.

Setup

  1. In OpenFollow, leave PSN at its defaults (multicast 236.10.10.10, system name OpenFollow).
  2. On the MA3, go to Menu → Settings → Network Protocols → PSN. Enable PSN reception. Confirm the multicast IP matches.
  3. In the MA3 fixture sheet, assign a tracked fixture’s position to the corresponding PSN tracker / marker ID.
  4. Give each tracked moving light its real position and rotation in the 3D stage, fastest with Position Calibration (Menu "PositionCalibration").
  5. For moving lights, activate XYZ Mode on the fixture – see below.
  6. Move the marker in OpenFollow. The fixture on MA3 follows.

XYZ Mode is required for moving lights

A moving light on MA3 will not respond to PSN positions until XYZ Mode is active on the fixture. Static-position fixtures (LED panels, projectors patched as fixtures, etc.) do not need it; pan/tilt heads do.

XYZ Mode lets MA3 drive a moving light using stage-space X/Y/Z coordinates instead of pan/tilt encoder values, which is what PSN tracker positions are. Without it, PSN data lands on the fixture but no pan/tilt is calculated. The pan/tilt is calculated from the fixture’s own position and rotation in the 3D stage, so a moving light that is not at its real rig position aims at the wrong spot – see Fixture position.

Only fixture types with the right fixture file can have XYZ Mode enabled. The fixture file must declare the geometry and attribute mapping required for the inverse-kinematics solver. Ready-made fixture files from the MA3 fixture library generally include this for current-generation moving heads. Older imported or hand-built fixture files may not – in which case XYZ Mode will be greyed out, and you’ll need to update or rebuild the fixture file from a supported template.

How to activate XYZ Mode

The full step-by-step activation procedure is in the official MA documentation: grandMA3 Help – Activate XYZ. The high-level flow:

  1. Select the moving-light fixture(s).
  2. Open the fixture’s Stage properties.
  3. Toggle XYZ Mode on.

Fixture position in the 3D stage

grandMA3 aims each moving light from its position and rotation in the 3D stage. A moving light that is not at its real rig position misses the performer.

Enter each tracked moving light’s position and rotation by hand in the Live Patch or in the 3D Viewer’s Setup mode, or let the console calculate both with Position Calibration. See grandMA3 Help – Position Fixtures in the 3D Space.

The stage origin must be the OpenFollow Reference Point, or every marker lands offset – see Positions offset between systems.

Position Calibration

Position Calibration calculates each moving light’s position and rotation from the pan/tilt needed to hit four stage points with known coordinates. The corners of the OpenFollow grid work well: they are taped on stage and measured from the Reference Point. Official procedure: grandMA3 Help – Position Fixtures Using Position Calibration.

Open it from the command line:

Menu "PositionCalibration"

Or on screen: tap Setup in a 3D Viewer’s title bar, then Calibrate Position on the encoder bar.

  1. Select the moving lights to calibrate.
  2. For each fixture, enter X, Y, and Z of the calibration points P1 to P4, measured from the Reference Point. Each fixture can have its own points.
  3. Aim each fixture at P1 with pan and tilt and tap Store P1. Repeat for P2 to P4. Call Px recalls a stored point to refine it.
  4. Tap Solve and close the pop-up. The fixtures move and rotate in the 3D Viewer to their real rig position.

Use all four points; three work, with less accuracy. Storing, calling, and solving also run from the command line with the Action keyword, for example:

Action "StoreCalibrationPoint1"
Action "CallCalibrationPoint1"
Action "SolveCalibration"

Notes

  • The marker ID you assign in OpenFollow is the PSN tracker number MA3 sees.
  • PSN data fps in OpenFollow is 60 Hz; MA3 has no problem keeping up.
  • XYZ Mode works per fixture, so a rig can mix tracked moving heads (XYZ on) and conventional heads (XYZ off) on the same console.

Troubleshooting

  • PSN visible in MA3 but movers don’t aim. XYZ Mode isn’t active on the fixture.
  • Movers aim, but miss the performer. The moving light’s position or rotation in the 3D stage doesn’t match the rig, or the stage origin isn’t the OpenFollow Reference Point. Run Position Calibration (Menu "PositionCalibration"), then check the origin – see Positions offset between systems.
  • XYZ Mode greyed out. The fixture file doesn’t support it. Replace it with a current MA3 library fixture or rebuild from a supported template.
  • No PSN at all. Almost always multicast not crossing the switch. See Troubleshooting and the Networking & Security notes on IGMP snooping.