What sensor drivers should I install?
Check the sensor section of the download page.
Skanect displays a white screen, what should I do?
If using an NVIDIA video card this is commonly caused by an outdated video card device driver or CUDA installation. Skanect 1.9.x, for example, requires CUDA 9+ which you can download from here.
My Kinect for Xbox 360 sensor works for a few seconds then shuts-off
There are two basic power adapters for the Kinect for Xbox 360. One designed for the Xbox only and one designed for the Xbox or a PC. If you have the former power adapter you may need to replace it with a power adapter designed for connecting a Kinect to a PC (instead of an Xbox).
The Ad Hoc Network instructions for Uplink do not work on my Windows 10 machine!
Do you have a, relatively, recent Intel WiFi adapter? If so, please review this article as to why it may not work: https://www.intel.com/content/www/us/en/support/articles/000023257/network-and-i-o/wireless-networking.html
If you feel that describes your hardware configuration try creating a Mobile Hot Spot instead. Here are the instructions for turning your PC into a mobile hot spot: https://support.microsoft.com/en-us/help/4027762/windows-use-your-pc-as-a-mobile-hotspot
Please note that a mobile hot spot may be used by other devices, possibly without your knowledge, to connect to your PC or through your PC to the internet over a WiFi channel. This may affect the very demanding bandwidth and latency requirements for a successful Uplink connection. If you notice that Uplink is mostly working but unreliable consider adding a password so you can control access to the WiFi channel.
Where do I find Skanect’s log file?
You can open the log file for the current session by pressing the “Log File” button on Skanect’s Prepare > Settings panel.
Finding a log file from a previous session, however, depends on which operating system you are using: Windows or Mac OS X.
Under Windows, the Notepad app (by default) is used to open the current log file. To find the default directory for log files just open the current log file, which launches Notepad, select the “Save As. . .” item under the File menu then click on the path field (circled in orange in screenshot below). On my machine, for example, the path is “C:\Users\Scott\AppData\Local\ManCTL\Skanect\logs”
Under Mac OS X, the Console app (by default) is used to open the current log file. To find the default directory for log files just press the “Reveal” button on the toolbar near the top of the window. On my machine, for example, the path is “/Users/scottthorne/Library/Application Support/ManCTL/Skanect/logs”
How can I use Structure Sensor and Skanect?
Do you support the Kinect for Xbox One (Kinect V2)?
Unfortunately, we have chosen to not support the Kinect for Xbox One (Kinect V2), as during our tests, the resulting 3D scans did not meet our standards for quality. This thread on Skanect’s Google Groups explains our decision in more detail.
You can find a complete list of supported devices on our download page: https://skanect.occipital.com/download/#sensors
Bad License Key Error – Why doesn’t my license key work?
Please ensure there are no “blank spaces” before or after the email and key when you enter them. Typically a blank space will generate a bad license key error message. A Skanect Pro license key starts with “SKN” and a Skanect Pro order number starts with “SKA”
The license key authentication process requires a live internet connection to complete.
If you still receive an error message let us know by emailing us firstname.lastname@example.org
What sensor should I buy?
Each sensor has its pro and cons. If you are an occasional user on a budget, and do not plan to scan for commercial applications, then Kinect for Xbox is the cheapest alternative. Kinect for Windows has better driver support, can be used for commercial applications and has a growing list of additional features (gain control, near mode, etc.). If you don’t need a motor and would like a device without an external power supply, then the Asus Xtion Pro Live or Primesense Carmine 08 is a good alternative. For close range applications (35cm – 2 meters), the Primesense Carmine 09 is the best choice, with lower minimal distance and more precision. For wireless mobility and high-quality color texturing, we recommend using the new Structure Sensor using Uplink in conjunction with an Apple iPad.
My Kinect for XBox sensor cannot be detected!
Since Skanect 1.5, you need to install the full Microsoft Kinect SDK, the latest link is provided in our download page. OpenNI drivers for Xbox Kinect may interfere, so it is recommended to uninstall them first.
What graphics cards are supported?
In general, any NVidia graphics card with more than 1Gb or memory and compatible with CUDA 2.0 should work. However, to ensure a good framerate, the GTX serie is highly recommended, both for laptop and desktop configurations.
We develop Skanect using an Asus laptop with a GTX 560M, an Alienware laptop with a GTX 580M, and an Alienware X51 desktop with a GTX 660.
My GPU should be supported, but GPU fusion is disabled, why?
Make sure you have the latest NVidia drivers for your graphics card. If it does not solve the issue, please send us your log file (Settings / Open log file).
Why does the camera keep losing track?
If you are using the GPU reconstruction, then the following tricks can help:
- Avoid flat walls and empty regions during the scan. Make sure you include part of the floor or some furniture to keep the tracking precise and stable.
- When scanning small objects, using a turntable and keeping the camera fixed is usually better.
- Also, if the object to be scanned is small or has few geometry, you can help the tracking by adding other objects around it. You will be able to crop the object of interest afterwards.
Also, make sure you move slowly and smoothly during the scan. Big gaps between frames can lead to tracking failure. If your FPS is too low (e.g. < 10 FPS), then you should probably consider getting a better graphics card.
What are the different scene types?
We have defined a number of presets that we have found to work best for different kind of scenes. Currently you can choose between 5 different scanning modes:
- Body: This is the ideal setup to scan the bust of a person, with a bounding box of more of less 1x1x1m. You can increase the bounding box size to scan the whole body. It also performs well for mid-sized furniture.
- Object: This mode is best for smaller objects, with a default bounding box of 0.6×0.6×0.6m. It can capture finer details, at the risk of loosing camera tracking more easily.
- Room: This mode is designed to capture a 360º small room. The initial sensor position will be it the center of the bounding box.
- Half Room: This mode is better for scanning only a part of a room, with an initial sensor position near the back of the bounding box.
How can I tune the bounding box size and the initial height of the camera?
In the Prepare->New scan menu, you can specify a config file. This is aimed at advanced users who want to configure Skanect is a more precise way. It follows the .ini file format, and it can be used to adjust the initial camera height, for example to start a full body scan with the face of the subject. Here is an example of
config.ini file that sets the initial position at 80% of the bounding box height:
center-y-as-height-percent = 0.8
This can be combined with the
Height x 2 option for the
Aspect Ratio setting. You can also specify the bounding box size, here is an example that also sets an optimized size for a full body scan:
center-y-as-height-percent = 0.8
size-x = 1.2 ; x is the width in meters
size-y = 2.2 ; y is the height in meters
size-z = 1.2 ; z is the depth in meters
If you need even more control on the bounding box, be sure to check this FAQ entry.
How can I fully customize the bounding box?
Note: if you just want to adjust the bounding box size and initial camera height, please see this simpler FAQ entry instead.
In the Prepare->New scan menu, you can specify a config file. This is aimed at advanced users who want to configure Skanect is a more precise way. It follows the .ini file format, and it can be used to specify an arbitrary bounding box size, orientation, and initial position. The best way to document it is through a sample
;; Size of the bounding box, in meters
size-x = 2.5
size-y = 2.5
size-z = 4.5
;; The offset can adjust the initial position of the bounding box
;; The reference point is the bottom-left-back corner of the box.
;; The camera is always at 0,0,0 looking towards -Z (usual OpenGL convention)
offset-x = -1.25 ; half of size-x, horizontally centered
offset-y = -1.25 ; half of size-y, vertically centered
offset-z = -5.0 ; initial camera will be 50 cm in front of the box
;; An initial rotation of the bounding box can also be specified, in degrees.
;; The rotation is around the bounding box center.
rx = 0
ry = 0
rz = 0
Here we are defining a large bounding box for a corridor-like room, centering the initial position horizontally and vertically, and starting outside of the room. Below is a graphics showing the coordinate system conventions and explaining the various parameters.