Troubleshooting
From iPiSoft Wiki
Contents |
Tracking errors caused by wrongly configured background
This is a very common problem. It can be the source of most dramatic tracking errors.
First few seconds of your action video should have clear background (no actor in view of cameras). Failure to provide clear background will result in wrong operation of tracking algorithm.
You can quickly check your background by pushing and holding "Background" button at the top of iPiStudio window. If you see the actor in background then your background is wrong.
To fix this issue, you may need to re-shoot the video. If you have clear background at the end of your action video (or in some other part of your action video, for example, in the middle), you can fix the problem by moving the "Background" region on timeline.
Video codec problems
Potential problem: cannot open Kinect video in iPiStudio.
Possible cause: a broken Microsoft AVI Splitter installation.
One of the symptoms of this problem: unable to play Kinect video with Microsoft Media Player.
Usually this happens when users install third-party (non-Microsoft) video codecs.
At least a few users users reported this problem.
Solution:
1) For Windows XP - install (or re-install) Microsoft Media Player version 9.
2) For all platforms - the following command run with Admin rights should repair the default Microsoft AVI splitter installation:
regsvr32 quartz.dll
(On Windows7 use it like this: Start -> All programs -> Accessories -> Command Prompt -> (right click and select "Run as administrator") -> regsvr32 quartz.dll).
3) Installing XP Codec Pack may help.
We are working on a more reliable solution for this problem but it may take some time to implement.
Installation problems
Potential problem: after installation, iPiStudio crashes on first start.
Possible cause: very often, this is caused by incompatible video card. Another possible reason is broken .NET Framework installation of broken DirectX installation.
Solution: check system requirements and make sure your operating system and .NET Framework is up to date.
Two Kinects don't work together
Potential problem: two Kinect sensors do not work togethter.
Possible cause: Most probably, both Kinects were plugged into one USB controller. In this case 1 USB controller bandwidth is not enough to handle video from 2 Kinects.
Solution: Each Kinect should be plugged into separate USB controller. Please refer to documentation User_Guide_for_Dual_Kinect_Sensor_Configuration#Software_Installation
Low framerate and/or abnormally high CPU usage with Kinect
Potential problem: Low framerate and/or abnormally high CPU usage when recording a Kinect video with iPiRecorder.
Possible cause: bad USB cable or outdated Kinect driver.
Solution:
Attach Kinect directly to computer USB port. Try different ports. Make sure Kinect power supply is not broken.
Check driver information for Kinect in Device Manager (make sure the Kinect sensor is attached to USB port because otherwise the Driver Manager won't display the info). The correct driver should be named "psdrv3.sys". If you have a different driver you may need to uninstall and delete it, then uninstall and then re-install iPiRecorder.
How to report bugs and issues
When reporting bugs and issues, please specify the following info:
- exact version of your operating system;
- exact model of your video card (you can use GPU-Z to find out the model of your video card);
- the number and models of your cameras.
You can post your bug reports on our User Forum or send them to iPiSoft tech support email.
How to send a video to iPiSoft tech support
Sending your videos to iPiSoft tech support can be helpful if you experience a problem with iPiSoft's system. iPiSoft promises to use your video only for debugging and not to disclose it to third parties.
To send a video, please compress it with a suitable codec (to reduce the size), upload it to some file sharing server like filefactory.com and send us the link. For example, you can use Xvid codec and Virtual Dub for compression (Xvid and Virtual Dub are free).
IMPORTANT: When sending Kinect depth video, please do not compress it with traditional video codecs. Instead, please compress it with ZIP. Kinect depth video is very different from traditional video, and compressing it with a traditional lossy video codec distorts depth information. That's why you should use lossless compression (e.g. ZIP) with depth video.
If you cannot send a video because of its huge size, consider sending screenshots. Screenshots are less informative then video but still they are helpful for diagnosing various problems with tracking.
