Rolling a Camera Past 180° or 360° — Singularities, Backrun Cable Issues, and Solutions¶
Summary¶
Rolling a camera past 180° — or doing a full 360° roll — in Flair requires careful keyframe strategy to avoid two major failure modes: (1) Flair treating ±180° as equivalent endpoints and choosing the short-path route (spinning the camera the wrong way, tangling cables), and (2) on backrun, the rig performing an unexpected 360° GOTO rotation at the start of the back-run to "unwind" before executing the return path. The correct approach depends on which roll mode is active: Roll Relative (add intermediate keyframes to guide direction), End Mount / Roll Moves (use Roll as an independent axis), or Roll Orbital (best for top-down 360° in end mount). Roll limits should be widened to ±3600° via the Staubli pendant.
Symptoms¶
- Camera snaps the wrong way through a roll (takes the short path, tangling cables).
- On backrun, robot does an unexpected 360° GOTO spin before moving.
- Roll value above ±180° jumps to its equivalent (e.g., 315° appears as −45°).
- At exactly ±180°, the robot trips or disengages (mathematical singularity).
- 360° roll does nothing — start and end positions are mathematically identical.
Community Guidance¶
[RESOLVED] The 180° Singularity — Use 179.99° and Intermediate Keyframes¶
Community — Tom D, Timothy Heys Cerchio — December 2020
Tom D: "Issues with programming rolls in Roll Relative mode with positions above ±180. The green roll value would shift 360 closer to zero (i.e., green 315° roll value would just change to −45°). This would result in all sorts of nasty cable tangles — had to stay on top of it to manually add or subtract 360 back to the roll value."
Tom D (on backrun issue): "We run the move forwards — great. But when we backrun the move to bring the camera home safely along path, Flair makes the camera roll 360° before running the move backwards, thus getting cables all caught up. The uninvited 360° GOTO roll at the start of the backrun was mm's away from ripping the cables out of the UltiBox."
Solutions:
- Avoid exactly ±180° — use 179.99° instead of 180°. The singularity occurs at the exact boundary.
- Add an intermediate keyframe at 90° to tell Flair which way to rotate past 90° on the way to 180°.
Timothy Heys Cerchio: "If you are going from 0 to 180 in Roll Relative it will also help if you put a mid keyframe at 90 — to tell it which side of the turn to go round."
- Watch for ±360 shifts — after setting a keyframe above 180°, check the green roll value in Flair. If it has subtracted 360 (e.g., 315° → −45°), manually add 360 back.
confidence_score: 0.90
[RESOLVED] Widening Roll Limits — ±3600° via Pendant¶
Community — Simon Wakley — 2021
By default the Staubli pendant has roll limits set to ±360°. Flair's internal soft limits can be set to ±3600°, but if the Staubli pendant limits are narrower, the robot will trip when Flair tries to go beyond them.
Simon Wakley: "The standard Bolt can be modified via the pendant to allow roll of much more than ±360, and then the Flair soft limits can be changed. Mine are set to ±3600."
Simon Wakley: "If you run the pan over its limit it is best to use the pendant to move the axis away from the limit. You can also extend the roll limits to ±3600 if you haven't already."
Procedure: Access the Staubli pendant → Robot Parameters → Axis Limits → Roll axis → change from ±360° to ±3600°. Then update Flair's soft limits to match.
confidence_score: 0.88
[RESOLVED] 360° Roll in End Mount — Use Roll Orbital¶
Community — Josh Ellis-Tufts — January 2026
For a top-down 360° roll in End Mount (e.g., rotating a camera that is looking straight down), Roll Orbital provides the cleanest result:
Josh Ellis-Tufts: "I was just testing a top-down 360-degree roll move in End Mount and discovered that Roll Orbital works wonders in that situation. First add the amount of push-in required and add 360 degrees of roll to the end position, then add a middle point with 180-degree roll to guide it around — and it gives you a perfectly consistent roll throughout the move."
Keyframes: - Frame 0: roll = 0° - Frame (midpoint): roll = 180° - Frame (end): roll = 360°
confidence_score: 0.88
[RESOLVED] End Mount — Use Roll Moves as Independent Axis¶
Community — Timothy Heys Cerchio — 2021–2023
In End Mount with the camera physically centred on the roll axis (all offsets at zero), the Roll axis can be treated as a fully independent axis using the Roll Moves option:
Timothy Heys Cerchio: "Yes, Roll Moves is the solution, but only if your lens is in line with the Roll Axis."
Timothy Heys Cerchio: "With Flair, keeping things as simple as possible is often the best solution. When in End Mount you can actually use Roll Moves as a totally independent Axis."
Warning: If nodal offsets are non-zero in End Mount, using Roll Moves or Roll Relative can create mathematical singularities that cause the rig to trip.
Timothy Heys Cerchio: "When you use End Mount with Nodal Offsets and Roll Level or Relative, this might introduce a (mathematical) singularity that causes the rig to trip/disengage."
confidence_score: 0.88
[RESOLVED] Multiple Full Rotations (720°, 1080°)¶
Community — Indrek, IanH — February 2023
For moves requiring multiple complete rotations (e.g., 720° or 1080° roll):
IanH: "Which roll mode are you using? My suggestion would be to use drop keys to figure out where your roll is at in the middle of the move, then adding 359 to those numbers for however many spins you want. If you do two middle keyframes it should give you 1080°."
Method: - Insert intermediate keyframes at each 360° boundary. - Add 360° (or 359° for safety) to the roll value at each pass to accumulate full rotations. - Example for 1080°: keyframes at 0°, ~360°, ~720°, ~1080° with each guided by intermediate keyframes.
confidence_score: 0.83
[RESOLVED] Roll Up Mode — Intermediate Keyframes Required¶
Community — Julian Hermannsen, Simon Wakley — October 2020
In Roll Up mode, the "up-node" is driven as a separate point. If no intermediate keyframe guides it, the up-node will pass directly through the camera during a roll, causing a one-frame flip:
Julian Hermannsen: "You need at least 1 middle keyframe with roll at 90, otherwise your up-node will pass right through the camera and flip on 1 frame in the middle of the move. Look at it in targets view to understand what the up-node is doing."
Simon Wakley: "Roll Up generated a point above the camera for each waypoint and then drives the 'up' point through the move — so look at the targets view to see what it is doing."
Requirement: For any roll move in Roll Up mode, add at least one intermediate keyframe at 90° (and potentially more at 45°, 135°, etc., for smoother rolls).
confidence_score: 0.90
[INFORMATIONAL] Roll Orbital — Over-the-Top Moves¶
Community — Simon Wakley — 2024–2025
Roll Orbital is an advanced mode for "over-the-top" moves where the camera orbits past vertical:
Simon Wakley: "Roll Orbital is a little different and is an advanced form of Roll Up. The Roll Point that tells the system which way is up in frame is not driven along a path per se, but is driven much like the camera based on a distance, elevation, and azimuth. It does make some 'over the top' type moves a little easier, but it is advanced."
Simon Wakley: "If you want to execute an orbital 'going over the top' type of move when you are in Roll Up and go through looking straight down, go into Target Tracking Setup and choose 'Flip Both' in the Orbital Handling selection."
confidence_score: 0.85
[INFORMATIONAL] Roll Adaptive — Mixing Roll Up and Roll Relative Per Keyframe¶
Community — Ben Myers — April 2024
Ben Myers: "You can also try Roll Adaptive. It allows you to enjoy the benefits of Roll Up and Roll Relative at different points during the same move. You can set up an axis to drive the switch between Roll Up and Roll Relative — just type in either a 0 or a 1 in that axis for each keyframe. You'll have to select that axis as your Roll Control in your Kinematics as well."
This is an advanced mode for moves that require different roll behaviour in different sections.
confidence_score: 0.80
[INFORMATIONAL] Use Goto Frame, Not Goto Position¶
Community — Timothy Heys Cerchio — December 2020
Timothy Heys Cerchio: "When you have a move keyed in and you are in Target Tracking with Roll Controlled mode, it is always wisest to use Goto Frame NOT Goto Position — so the 'calculated' Roll positions will be respected!"
Using Goto Position with roll moves can cause the robot to take an unintended path. Goto Frame respects the programmed keyframe roll values.
confidence_score: 0.88
Quick Reference: Which Roll Mode to Use¶
| Scenario | Recommended Mode |
|---|---|
| End mount, camera centred on roll axis | Roll Moves (independent axis) |
| Roll Relative with >180° | Add keyframes at 90° intervals; watch for ±360 shifts |
| 360° roll, top-down end mount | Roll Orbital with midpoint at 180° |
| Over-the-top orbital move | Roll Up + Flip Both in TT Setup |
| Multiple full rotations | Roll Relative + intermediate keyframes +359 per rotation |
| Simple tilting / tilted camera | Roll Up (with midpoint keyframes) |
Related Issues¶
- See also: Roll Orbital — Flip Both Setting
- See also: Camera Orbital + Roll Up Incompatible
- See also: 360-Degree Orbit in Roll Up Mode
- See also: Init Scaling — End Mount Dual Solution
- See also: Unexpected GOTO on Back Run
- See also: Tracker App Roll Gimbal Lock