This information is for Vicon Shogun 1.2. For up-to-date help, see the latest Shogun documentation.

Shogun PDFs

Vicon Shogun Live enables you to go straight from live capture to post processing. Data is saved as a mocap file (.mcp), which contains a copy of the current calibration, active subject, and real-time data, along with paths to the .x2d (an XML file, which contains 2D camera data) and any video cameras in the system. As soon as you’ve captured takes (.mcp files), you can replay and review them without leaving Live. For cleanup, you open the .mcp file in Shogun Post.

In addition to the following information about capturing with Shogun Live, see also the Vicon video: 7 - Shogun Live - Capture Direct to Disk and Realtime Settings‌.



To find out about streaming real-time data from Shogun Live into Autodesk MotionBuilder, Unity, or Unreal Engine 4, see the Vicon video: 8 - Shogun Live - Streaming to Game Engines‌.


Tip

If cameras are bumped after they have been calibrated, or if any other issue with your system is detected, Shogun displays warning icons. For more information, see Understand the system health icons.

To capture a take:

Note that for capturing takes, you may find it easiest to use the Capture Data layout to display the views and panels that you will use for motion capture. To do this, in the Load Saved View list at the top right of the menu bar, click Capture Data.

 

  1. Ensure you have completed the necessary preparations, described in Create subjects and props.
  2. At the top of the Processing panel, in the General section, make sure the Processing Output level is set to Solve (this is its default setting) and Occlusion Fixing is selected.

     

    Important

    To ensure you record the required data, always check the Processing Output level before capturing. Normally, make sure it is set to Solve. If you set it to Reconstruct, the system will save only reconstructed data, and you will not see any labels or a solving skeleton when you open the data in Shogun Post. Similarly, if you select Label, you will not see a solving skeleton in Post. 

  3. In the Tools panel on the right of the Shogun Live window, ensure the Capture tab is selected.

  4. In the Take Info section, click the folder icon to the right of the Capture Folder field and select the Session folder that you created as described in Create a folder hierarchy to store takes. Anything you capture from now on will be saved inside the database you created.
  5. In the Capture Name field, enter a suitable name that will enable you to identify the take.
  6. If you will be capturing multiple takes, you will probably want to select Auto-increment capture name to append a number at the end of the capture name for each take in the sequence.
  7. If required, add text to the Description field. Note that if preferred, you can add comments after capture in the Eclipse database (also accessible in Shogun Post in the Data Management panel).
  8. In the Capture section, notice that there are options to capture processed data and video data. The option selected by default is Capture Processed Data. If the Solve option is selected in Step 2 above, this includes 3D labels and solving bones. To capture video from Vicon video cameras, select Capture Video. This will enable you to view a video overlay to check your 3D data in Shogun Post.

    Note

    A fast SSD is required to capture large datasets to disk. If you’re using live video, a second SSD is recommended.

    The Capture Buffer Size is also displayed. This represents the amount of memory allocated to Shogun Live’s capture. By default, this is set to 2 GB, which should be enough for most situations. For multiple video cameras, you may need to set it higher. You are recommended to always record your data onto a fast SSD drive.

  9. Before capturing any data, you may want to reposition and/or resize the Data Capture panel as required (to move it, drag its title bar).

  10. In the Data Capture panel (by default at the bottom right of the Shogun Live window), click Start Capture.
    In both the panel and in the menu bar at the top of the view pane, a flashing red circle and Capture Active are displayed.

    Tip

    If possible, begin and end each take with the performer(s) in a T-pose. This can help with labeling and retargeting.

    Data is captured to disk at your source frame rate.

    If you are using an external timecode generator, in the Data Capture panel you can see the current timecode being received, and green icons, indicating that the system is running at genlock at the specified standard. This panel also displays any issues with the capture.

    The bar at the bottom of the Workspace displays red marks when the real-time system cannot keep up with the target frame rate and has to drop a frame. The percentage of dropped frames is also shown. Unless this number becomes very high (above 30%), you can continue to capture. If it is above 30%, this normally indicates that your system is out of calibration, and can’t keep up with amount of data currently being processed. In this case, you may need to re-calibrate or even upgrade your PC.

    The .x2d data from the cameras is also recorded. When you load the .mcp file in Post, .x2d data can be used to fix dropped frames (for more information, see Load mocap data files into Shogun Post).

  11. When you have captured the required take, click Stop Capture.
    Shogun Live saves the necessary files to the folder specified in the Take Info section (see Step 4 above).

  12. Depending on whether you want to remain in Shogun Live to continue capturing or move to Shogun Post for cleanup and further processing, you can now do one of the following:

MCP review in Shogun Live

Shogun Live enables you to replay takes as soon as you’ve captured them. MCP review enables you to review a take (.mcp file), update your notes on a take, or investigate technical issues, all without having to leave Live. When you’ve finished reviewing the take, you can immediately resume capturing.

To review takes in Live:

  1. Ensure that you have at least one take in the Session folder.
  2. On the Capture Tools pane, in the Review section, click the required row.
  3. If required, you can change the Description and Notes fields. 
  4. To review the selected take, double-click the row.
    At the top of the Shogun Live window, in the center of the menu bar, the word Review is displayed, followed by the title of the selected take.
    At the bottom of the screen a time bar displays information about the selected take. It shows you the current frame, current timecode and duration.
  5. To play through the take, you can use the Play/Stop button and the Go to beginning and Go to end buttons to the right of the time bar. You can also press the default A and S hot keys to scrub back and forward one frame at a time (to change hot keys, click Manage Hot Keys on the User Preferences tab (Shift+P)).
  6. To close review mode and return to capturing, click the exit button to the right of the take title in the menu bar.

Note

Shogun Live is either in capture mode (ie live) or in review mode for a single take. You cannot view both live and captured data simultaneously, or compare two takes.

Streaming via Vicon DataStream SDK

The current data in Shogun Live is served to Vicon DataStream SDK clients over port 801, so that MotionBuilder and Unreal show the reviewed clip when Shogun Live is not capturing.

For clients that require uninterrupted live, an additional DataStream SDK server sends the current live data over port 804.