Settings' Commands

With these commands you can alter the application settings and behaviour directly from the command line.

Command Name Required Parameter Optional Parameter Description
set "key=value" Set an application state variable.
preset "key=value" Change an application setting during the setup phase. Ideal for changes that require a reset of the application. Learn more about how to use this command here.
reset ui | cfg | cfgui | all Reset the user interface, settings, or both. It is also possible to make RealityScan like a clean install. This command works only when used in a batch file, and it won't work with delegation commands. What is going to be reset is determined by the chosen parameter: ui - reset user interface, cfg - reset application settings, cfgui - reset both interface and settings, all - make it like a clean install.
silent crashReportPath Set a location for storing crash reports. The application will store the reports here instead of showing the upload wizard.
writeProgress fileName timeout Write any new progress change into a specified file (fileName including the path). Optional timeout parameter will also output during a defined period of time (timeout in seconds). More about the file structure can be found in the section Error-handling Commands.
printProgress timeout Print progress change into the Windows Command Prompt for any new change. Optional timeout parameter will also output during a defined period of time (timeout in seconds).
tag Writes out a tag into the Windows Command Prompt. It respects the order of the used commands and will be run after the process ran before it finishes.
stdConsole Enables console redirection to the application standard output. When used, you will see the application console content mirrored also in the standard Windows console. This also enables further redirections for CLI purposes.
disableOnlineCommunication Disable any online communication.
importGlobalSettings settings.rsconfig Import application global settings from the settings.rsconfig file.
exportGlobalSettings settings.rsconfig Export application global settings to the settings.rsconfig file.
setProjectCoordinateSystem authority:id Set a project coordinate system defined by an authority, and its ID (can be found in a specific database, e.g. epsg.xml and local.xml).
setOutputCoordinateSystem authority:id Set an output coordinate system defined by an authority, and its ID (can be found in a specific database, e.g. epsg.xml and local.xml).

Examples of the Settings

RealityScan.exe -set "sfmDistortionModel=Brown3" ^
-set "unwrapMaximalTexCount=1" ^
-set "unwrapStyle=1"

With the following commands, you can set the local Euclidean coordinate system as a project coordinate system, and the GPS (WGS84) with EPSG code 4326 as an output coordinate system:

RealityScan.exe -setProjectCoordinateSystem Local:1 ^
-setOutputCoordinateSystem epsg:4326

Project and Image Commands

Manage the current project, the application itself and add images via CLI

Commands Outside Command Prompt

Using CLI with an .rscmd file

Delegation of Commands

On delegating commands into an opened instance of RealityScan

Alignment Commands

Commands for alignment and component handling

Reconstruction Commands

Model calculation via the command line

Model Tools' Commands

Further model processing via the command line

Continue

Commands for handling potential errors

See also: