Camera diagnostics
Before you start working with the Motioncube software, make sure that you have access to the video signal for the selected camera from the level of other applications (optimally system applications, and not necessarily the camera manufacturer's software, which may have proprietary image transfer mechanisms).
Simplified
If the video signal works in other programs, it should also work in Motioncube. If it isn’t recognized elsewhere, there’s only a small chance it will be available in Motioncube.USB Cameras
Recommended test programs:
- Windows 10/11 -
Windows Camera
(view in Windows Store). - Linux Ubuntu 24.04 -
guvcview
(available in the package repository). - You can also test your camera using a web browser by visiting https://webcamtests.com/.
Depth Sensors
Orbbec Astra 1
- Visit the OpenNI SDK page on orbbec.com and download OpenNI SDK 2.3.0.86 for Windows.
- After downloading, unpack the archive and navigate to
OpenNI_2.3.0.86_beta6_windows\samples\bin
directory (or similar). - Connect the Orbbec Astra 1 camera directly to your computer (avoid using an extension cable).
- Launch
SimpleViewer
and verify if the image preview is visible. - If the image preview does not appear, additional drivers may be required. You can download them from https://www.orbbec.com/developers/openni-sdk/ (click on Orbbec Camera Driver for Windows).
- Once the preview works, test the camera again with an extension cable (if you plan to use one).
- If you have any problems, please refer to the documentation https://astra-wiki.readthedocs.io/en/latest/.
Orbbec Astra 2
- Visit the OrbbecSDK_v2 releases page on GitHub and download the latest stable version of OrbbecViewer for Windows (look in the Assets section).
- After downloading, install the software and run it.
- Connect the Orbbec Astra 2 camera directly to your computer (avoid using an extension cable).
- Launch
OrbbecViewer
and verify if the image preview is visible. - If the image preview does not appear in
OrbbecViewer
, additional drivers may be required. You can download them from https://www.orbbec.com/developers/orbbec-sdk/ (click on Orbbec Camera Driver for Windows). - Once the preview works, test the camera again with an extension cable (if you plan to use one).
Intel Realsense V2
- Visit the Intel RealSense SDK 2.0 releases page on GitHub and download the latest version of Intel RealSense Viewer for your operating system (check the Assets section for the installer).
- After downloading, install the software and launch the RealSense Viewer.
- Connect your Intel RealSense camera directly to your computer using a USB 3.0 port (avoid using an extension cable for initial testing).
- Open the
RealSense Viewer
and ensure the live streams (RGB, depth, or both) are visible. - If you cannot see the streams, ensure that the proper drivers are installed. Drivers are included in the Intel RealSense SDK installation package or can be downloaded from the Intel RealSense website.
- Once the camera is working properly, test it again with an extension cable (if you plan to use one) to ensure it maintains functionality.
Microsoft Kinect V2
Download the Kinect for Windows SDK:
Visit the Kinect for Windows SDK page and download the latest version of Kinect for Windows SDK 2.0.Install the SDK:
Run the downloaded installer and follow the instructions to install the Kinect SDK on your computer.Connect the Kinect to Your Computer:
- Use the Kinect Adapter for Windows to connect the Kinect sensor to your PC via USB 3.0.
- Ensure the adapter is connected to a power outlet.
Launch Kinect Configuration Verifier:
After installing the SDK, open the Kinect Configuration Verifier tool (included in the SDK installation). This will check whether your Kinect is properly connected and functioning.Test the Sensor:
- Open the Kinect Studio application, included with the SDK.
- Verify if the RGB and depth streams are visible in real-time.
- Test hand/body tracking if you plan to use these features.
Troubleshooting:
- If the Kinect is not recognized, ensure that the USB 3.0 port is functional and try restarting your computer.
- Check the power connection to the Kinect Adapter.
- Refer to the troubleshooting section in the Kinect for Windows SDK documentation if the problem persists.
Test with an Extension Cable (Optional):
If you plan to use an extension cable, test the Kinect again to ensure it works properly without signal loss.