NEW! Version 3 of iPi Motion Capture is available. iPi Motion Capture 3 delivers new features for improved workflow including support of Kinect 2, improved arms tracking, simplified calibration and others. Read more >>
This documentation corresponds to version 2 of iPi Motion Capture. The latest documentation for version 3 can be found at https://docs.ipisoft.com/
Quick Start Guide for Dual Depth Sensor Configuration
BETA STATUS |
Contents |
Prerequisites
- Computer (desktop or laptop):
- CPU: x86 compatible (Intel Pentium 4 or higher, AMD Athlon or higher), dual- or quad- core is preferable
- Operating system: Windows 7 (x86 or x64), Windows Vista (x86 or x64), Windows XP SP3 (x86 or x64)
- Video card: Direct3D 10-capable (Shader Model 4.0) gaming-class graphics card
- for more info see Cameras and accessories#Video_Card
- USB: at least two USB 2.0 or USB 3.0 controllers
- for more info see USB controllers
- Storage system: HDD or SSD or RAID with write speed at least 55 Mb/sec
- iPi Recorder 1.6.0.121 or later
- see Quick Start Guide with MS Kinect Sensor#iPi_Recorder for installation instructions
- iPi Studio 1.3.0.79 or later (Free Trial or Basic or Standard edition)
- see Quick Start Guide with MS Kinect Sensor#iPi_Studio for installation instructions
- Two Microsoft Kinect Sensors with separate power adapters
- If you bought "XBox 360 + Kinect" bundle then you need to order power adapter
- Optional: active USB 2.0 extension cables
- Optional: Kinect Adjustable Tripod Stands
- Minimum required space: 3m by 3m (10 by 10 feet)
Note that before you start working with two Kinects it's highly recommended to get appropriate results with single Kinect solution: Quick Start Guide with MS Kinect Sensor.
Drivers Update
If you have used previous version of iPi Recorder (1.5.0.x) with Microsoft Kinect Sensor, then it is highly recommended to update PrimeSense drivers for Kinect. To do it, please, download and run the following MSI-installation package:
- PSensor_iPi-x86.msi for 32bit Windows
- PSensor_iPi-x64.msi for 64bit Windows
You’ll be asked about License Agreement for “PrimeSensor Driver (psdrv3) Registration for MS Kinect”:
Note that there is no need to manually uninstall the previous version of the driver - the installation package will do it by itself. The only thing which is desirable is to unplug Kinect Sensors from computer during installation.
Recording with 2 Kinects
Important! Each Kinect Sensor must be plugged in through separate USB controllers. If both Kinects are plugged in through one USB controller then the second Kinect will not work. How it looks in the Device Manager:
![]() |
![]() | |
Make sure that you can see correct colored “depth video” from both sensors and
- that you can change motor position for each sensor using appropriate slider and “Motor of” combobox
- that you can switch between RGB and “depth” video using “View RGB/Depth” button
- that actual frame rate is 30 fps (or 29.9) and frames drop is in range from 0 to 5 for each sensor
Note that you can turn off RGB streaming using appropriate checkbox in the Advanced Options section of Camera Selector dialog. Also you can change the position of cameras output and motor controls in the interface in case they are positioned in the wrong order:
Calibration
Preparations
There are two possible arrangements of the two sensors:
- angle between sensors is between 60 and 90 degrees;
- angle between sensors in near to 180 degrees that means that sensors are placed opposite to each other.
For current version we strongly recommend to use the first configuration:
For calibration purposes flat rectangular veneer/plywood/cardboard/pasteboard is used:
- horizontal size should be at least 0.5m (1m - 1.3m is recommended);
- vertical size should be at least 0.7m (1m - 1.5m is recommended);
- hold it vertically in front of yourself on outstretched arms;
- make sure that this calibration plane is good visible in both sensors (the amount of yellow is low in the area of the veneer/plywood/cardboard/pasteboard).
![]() |
![]() | |
good depth data | too small too close to human body |
Important! Yellow color in the depth map means "depth here is unknown". Thus it is important to minimize the amount of yellow points using appropriate materials and clothes.
Recording
After you finished preparations and sensors setup you're ready to record the calibration video:
- Start recording by pressing the "Start Video Recording" button.
- Initial two seconds of video should contain only background and static objects. Presence of actor or any moving objects in the initial two seconds of recorded video is unacceptable.
- Go to the capture area with prepared calibration plane (flat rectangular veneer/plywood/cardboard/pasteboard).
- Turn the veneer/plywood/cardboard/pasteboard to the left and to the right thus view angle is changing but the veneer/plywood/cardboard/pasteboard is still visible in both sensors.
- Stop the recording by pressing the "Stop Video Recording" button.
Note that is important to have variety in angles from one hand and good visibility of the calibration plane in each camera from the other hand. It is not so easy to reach good results for 90 degrees angle thus 60-80 degrees angles could be more practical.
Please open the captured video in the iPi Studio and check the following:
- At least two initial seconds of video contains only background and static objects (no actor, no calibration plane)
- The floor (ground) is good visible on the depth maps from both sensors
- The calibration plane is good visible on the depth maps most the time
- The calibration plane is moving and has at least 30 degrees variety in the horizontal view angle
- The amount of yellow points is relatively small
Processing
- Make sure that ground plane is determined correctly for both sensor after calibration video opening in the iPi Studio (to switch between sensors use buttons "Camera 1" and "Camera 2" in the top toolbar).
- After that it is convenient to turn off visualization of background points (View -> Hide Background).
- Set the beginning of Region of Interest (ROI) to the point where calibration plane is good visible in the both sensors.
- Adjust the end of ROI:
- the length of ROI should be at leat 5 sec (150 frames)
- ROI should contain good variety of horizontal view angles for the calibration plane
- Go to the Calibration tab, select "Angle between sensors is 30 - 90 degrees" option and click "Calibrate Based on 3D Plane" button
- Wait for the end of calculations
- Evaluate the result:
- turn on "Show Depth From All Sensors" option in the "View" menu
- rotate the scene and check how 3D-points from different sensors fit with each other
- Save the result:
- go to the Scene tab
- click "Save scene..." button
- choose file name for your scene parameters
Tracking
Recording and processing of performance video is mostly like ones for single Kinect solution: Quick Start Guide with MS Kinect Sensor#Processing Video from Depth Sensor.
The main difference is that after loading of performance video into iPi Studio you should load your scene parameters:
- switch to the Scene tab
- click "Load scene..." button
- select file with scene parameters which was saved during calibration process
That's all. After that you're ready for the processing:
- Position timeline slider to the frame where actor is in T-pose
- Adjust actor height using appropriate slider on tab “Actor”
- Select “Move” tool on toolbar.
- Move actor model to left or right to match roughly actor silhouette on video.
- etc.









