Troubleshooting

My application will not launch or it crashes.

  • Maybe your system doesn't support the toolkit. You'll need a computer with accelerated graphics no more than 4 or 5 years old.
  • We have also had recent issues with brand new mac laptops with integrated graphics cards. 
  • Make sure you have not moved the data/ folder in relationship to the DepthKitCapture or DepthKitVisualize applications.

My depth camera feed is not showing up in the Calibrate Lenses tab.

  • Try disconnecting and reconnecting your depth camera, then restarting the application.
  • Occasionally fully restarting the computer has helped with sensors that fail to pick up.
  • Confirm that you're using the correct version of the app for your sensor – beta is designed to be used with the Kinect v2 on a Windows machine.
  • If you're using a USB extender, remove it and plug the sensor in directly.

My depth camera's FoV/principal point don't match the figures given in the video. Or I can't calibrate the Depth Camera.

  • If they are only slightly different, don't worry!
  • Try the process again from scratch by disconnecting devices and relaunching the application.
  • Make sure there is information in the scene that falls within the range visible to the sensor (~3'-12').
  • Check that there is variation in the scene; information in the foreground, middle and background.

I'm getting high error numbers on the calibrate lenses page.

  • High error may occur when the checkerboard is too close or too far away.
  • Make sure there is no glare on the checkerboard from lights. Even one hot spot from a nearby light could throw off the reading.
  • Make sure that the exposure is set properly on the camera - if the whites of the checkerboards are too bright sometimes you need to shoot it again at a slightly darker exposure.
  • Make sure you refocused on the checkerboard at every stage and that your aperture is no too low, making the depth of field shallow.

While calibrating, my correspondences are not detecting or are way off.

  • Confirm that you have a low error on the first stage.
  • Make sure that your set up is totally stable when capturing the correspondence images. A wobbling checkerboard or camera tripod will throw things off.
  • Often this will happen if there is not enough ambient IR light, get closer to a window
  • Conversely if there is too much or uneven lighting it'll also blow out your checkerboard
  • Try different depths from the camera, being wary moving it too close or too far.

My recordings are dropping frames.

  • Close any other apps.
  • Make sure you are plugged into wall power
  • If writing to an external hard drive make sure it's USB 3.0 or FireWire 800.
  • This can be caused by using a USB extender for the Kinect that is too long without an inline repeater. Remove the USB extender or use an active USB 3.0 extender.

The application crashes when I try to load movie files from the HD camera.

  • Make sure your video files are compatible with the toolkit, H.264 or ProRes MOV's.
  • Make sure you have the latest version of Quicktime installed. If you just ran a fresh install of Windows, it's likely that you don't have Quicktime. Download the latest version here.
  • Make sure you are running the application from a location where you have write access

I'm having some errors with needing Quicktime.

  • Modern installations and fresh installs of Windows don't natively package Quicktime 7, so you'll need to download the latest version of codec here.

My video doesn't show up in the Visualizer (either the thumbnails or synch preview) or otherwise acts strangely, or the console shows an error referring to "static framerate."

This is usually caused by issues with your source videos. Generally there's no issue with simply dropping your files straight into the /color folders, but occasionally you'll need to transcode the videos. We recommend transcoding your full resolution videos to Apple ProRes and your low resolution proxies using Quicktime>MJPEG-A. Replace the videos in the .../color folder with your transcoded videos, close the Visualizer and relaunch it. If you're looking for a tool to transcode your videos you can use Adapter (free), MPEG Streamclip (free) or Quicktime Pro (paid). We also offer an Adobe Media Encoder preset you can download here.

My texture alignment is way off.

  • Try using the X & Y Rotate, Shift or Scale in the Texture Alignment tab to accommodate for slight inaccuracies.
  • You may want to recalibrate, which is fine to do after you've shot as long as the relationship between camera and sensor is still fixed.

My time alignment/synch is way off.

  • Delete any markers on the 3rd "Alignment" track on the timeline to start over.
  • Look for a very decisive temporal moment to align to, meaning that there is a specific fast movement which allows for precisely selecting a depth and video frame from close times. Because the cameras have different frame rates and clocks, the alignment will never be perfect but should not drift over time.

The preview in my Capture application seems to stutter a bit, freezing for brief moments every few seconds.

  • This is usually caused by using a USB extender for the Kinect that is too long without an inline repeater. If this is happening, either remove the USB extender or use an active USB 3.0 extender.

I'm unable to drag in my clips for the Calibrate RGB Intrinsics step or the Calibrate Correspondence step.

  • There is an issue where launching DepthKit Capture "As an administrator" will make it so dropping in clips isn't possible. If you're running into this error, try starting DepthKit normally, without selecting "Run as administrator."
  • You also need to make sure your clips are the proper codec — XAVC, .R3D, and other file formats will likely not work. You may need to transcode your calibration videos to h264 in order to import them.

Visualize will not let me track/seek depth frames, and the frame number is stuck at 0 in the depth track.

  • If you have verified that the depth frames are indeed in the /depth folder, there is likely a problem with your drive permissions and you'll need to change the permissions to allow you to both read and write from the drive. Otherwise move your Take and calibration file to your main drive and try again.

My renders stop always stop at a given frame, no matter what my in/out frames are.

  • DepthKit Visualize has some problems playing back MJPEG codec videos, and if your video is of this type it's worth trying to rewrap it as h264/mp4.
  • If you try to rewrap your video and it still doesn't work, you may have a problem with the timecode encoding in your video. Try to re-render your video with fresh timecode, which should then fix the issue.

I get an error that states "The program can’t start because MSVCP110.dll is missing from your computer"