Contours

9. Recording Motion

Recording captures live position data from one or more connected motors while you move them by hand (or with a game controller). Contours samples position, speed, and torque at a fixed interval you choose.

Recording.drawio.png

Figure 5. The Recording view. Choose which profiles to capture, set the sampling interval, then use Record, Pause, and Stop to capture motion. The live chart lets you see position, speed, and torque as they arrive.

Preparing to record

  1. Confirm the motors are connected. The status bar should show Connect All Axes checked.

  2. Select the show you want to record into, in the Shows tab.

  3. Click Record on the toolbar or right-click the show/profile and choose Record. The Recording view opens.

  4. Set the Recording Interval — the time between samples, in milliseconds. The default is 100 ms. Lower intervals give smoother data; higher intervals produce less data and faster playback of the same sequence.

Tip. Start at 100 ms for your first recording. If the result feels coarse, drop to 50 ms. If the file becomes unwieldy, go up to 200 ms. Very fine intervals (below 20 ms) rarely help and make editing slower.

Tip. To record with a game controller, choose Controller Position Control or Controller Speed Control in the Recording view's control type list. Each axis's ranges, direction and Responsiveness Gain are set on its Controller tab (see chapter 6).

Capturing a performance

  1. Click Record to begin capture.

  2. Move the motors through the motion you want — with a game controller, by hand (if the motor is back-drivable), or with an external command.

  3. Click Pause to stop capturing temporarily without ending the take; click Record again to resume.

  4. Click Stop when the performance is complete.

  5. Click Save to store the recording into the profile, or Cancel to throw it away.

Watching the show video while you record

If the show has media attached (see chapter 8), its video panel appears in the Recording view. Click Pop out to watch the video full size — for example on a second monitor — while you move the motors. The video follows the recording controls:

  • Record on a new take starts the video from the beginning, in step with the chart.

  • Pause pauses the video; Record again resumes it from the same point.

  • Stop, Save, and Cancel stop the video and return it to the start.

While a take is in progress, the video panel's own Play and Pause buttons are disabled.

Reviewing the recording

The Recording view lets you choose which series to watch live on the chart — position, speed, and torque. These toggles only affect the chart; all three are always recorded.

After saving, the new data replaces any existing recorded sample on that profile. The fixed-interval sample (if any) is unaffected — the profile remembers both and can switch between them.