Installation
This page describes how to install ScannedReality Studio. Please refer to the instructions for your operating system below.
Windows
Up-to-date versions of Windows 10 and later are supported.
Prerequisite: Graphics driver
Since ScannedReality Studio makes strong use of GPU computing, we recommend making sure that a recent version of Nvidia’s graphics driver is installed.
Drivers can be downloaded from Nvidia’s website.
Installation
To install ScannedReality Studio, download its installer file from the downloads page and run it, following the instructions in the installer.
Running
If you installed start menu or desktop shortcuts for ScannedReality Studio, then these are the easiest ways to start the application.
Otherwise, open the folder where you installed ScannedReality Studio in the Windows Explorer, and run ScannedRealityStudio.exe.
Troubleshooting: If the program fails to start due to a missing DLL, then please install this Microsoft Visual C++ Redistributable package and try again.
Internet connection: If Windows Defender (or a similar tool) shows a popup, asking you whether to allow network connections for ScannedReality Studio, then please allow them. An Internet connection is necessary for license activation; furthermore, the program uses network sockets internally.
Uninstalling
To uninstall ScannedReality Studio, click the Windows start menu button and start typing “Add or remove programs” to search for this entry. Once the entry appears, click it to open the corresponding page of the system settings.
In the search box of this page, enter “ScannedReality Studio” to find the corresponding entry. Click this entry to select it, and then click its “Uninstall” button that appears after selecting it.
Linux
Only the Linux distribution Ubuntu 22.04 LTS is supported. Basic familiarity with the use of the terminal is assumed in the following instructions.
Prerequisite: Graphics driver
Since ScannedReality Studio makes strong use of GPU computing, Nvidia’s proprietary graphics driver must be installed. The “nouveau” driver is not expected to work. If the proprietary driver is already installed, we recommend to check for whether it is the latest version, and if not, consider updating it.
The exact steps to do this may depend on the flavor of Ubuntu that you use.
For example, on Kubuntu, the driver can be installed by going to the System Settings,
then to Driver Manager, and under “Additional Drivers”, selecting the “NVIDIA driver metapackage”.
As of the time of writing this, this installs the nvidia-driver-535
package.
After installing the driver, restart the PC.
Prerequisite: libk4a
As a prerequisite, libk4a
(the software library for accessing Azure Kinect cameras) must be installed on the system.
To do this, open a terminal and run the following commands:
# If not installed yet, install curl
sudo apt install curl
# Use curl to download the libk4a package
curl -sSL https://packages.microsoft.com/ubuntu/18.04/prod/pool/main/libk/libk4a1.4/libk4a1.4_1.4.1_amd64.deb > /tmp/libk4a1.4_1.4.1_amd64.deb
# Install the libk4a package. Read and accept the license terms when prompted.
sudo dpkg -i /tmp/libk4a1.4_1.4.1_amd64.deb
# Clean up
rm /tmp/libk4a1.4_1.4.1_amd64.deb
Camera setup steps
While not being a necessary prerequisite for running ScannedReality Studio itself,
at this point we recommend checking whether any camera-specific setup steps are required
to use your cameras under Linux. Typically, as a minimum, udev
rules must be set up
to allow non-root programs to access a camera.
The required setup steps for Azure Kinect cameras are described here.
Installation
To install ScannedReality Studio, download its installer file from the downloads page. Then, open a terminal, change to the downloaded file’s directory, and run the file after making it executable:
# Change to installer directory
cd /path/to/ScannedRealityStudioInstaller-<version>.sh
# Make the installer executable
chmod +x ScannedRealityStudioInstaller-<version>.sh
# Run the installer
./ScannedRealityStudioInstaller-<version>.sh
After starting the script, the directory to install the application in can be chosen. Once the installation finished, the install script may be deleted.
Running
To run ScannedReality Studio, execute the file ScannedRealityStudio
in the folder where you installed the application.
Uninstalling
To uninstall ScannedReality Studio, delete the folder where you installed the application.