About the DeCap Command-Line Tool

As of version 3.0.1, ReCap includes the ability to create ReCap projects from raw source files in an automated, background fashion. These features are accessible through a command-line executable import tool called DeCap.exe, located in the ReCap install folder. The source files can be specified directly on the command line or provided in a control file.

DeCap is authorized using the same license as ReCap Pro. It does not, however, provide an interface for activating such a license. As a result, you need to first have a valid, activated license for ReCap Pro before using DeCap.exe.

To create a project by specifying scans on the command line, run the following command:

    Decap.exe --importWithLicense <output folder> <project name> [options] <input scan 1>  [input scan 2] … [input scan N]

Where the < input scan > arguments are full or relative paths to the input scans.

To create a project by specifying a list of scans in a control file:

    DeCap.exe --importWithLicense <output folder> <project name> [options] --controlFile <control file path>

Where the < control file path > argument is a full or relative path to a text file that contains the list of scans (one per line, full or relative paths).

Both versions have the same arguments:

• < output folder > - path to a folder in which to create the project
• < project name > - name for the new project

The [options] argument represents the ability to provide 0 or more optional settings:

• --minRangeClipping - sets the distance from the scanner under which points are ignored

• --maxRangeClipping - sets the distance from the scanner past which points are ignored

• --decimation - sets the minimum distance between 3D points in millimeters. Points closer than this distance may be unified to a single point.

• --unify - Enables unification of input scans into a single output scan.

• --normalizeIntensity < 0|1 > - Turn intensity normalization on/off (off = 0, on = 1).

• --currentCoordinateSystem < cs > - Coordinate system of raw data to be imported (default is no coordinate system)

• --targetCoordinateSystem < cs > - Desired coordinate system of resulting project (defaults to currentCoordinateSystem if not specified)

• --inputUnitType < 0|1|2|3|4|5 > - Unit type of raw data to be imported (0: mm, 1: cm, 2: m, 3: in, 4: International ft, 5: US ft, default is meter)

• --e57EnableImageImport - Enables the use of e57 image data for constructing RealViews.

• --e57CreateScanPerImage - Enables the creation of one RealView for each panorama image.

  The following table describes the e57 DeCap commands in reference to the e57 scan setting options. The options are as follows:

  • Option 1. Import the point cloud “as is” and create a RealView from each image.
  • Option 2. Import the point cloud and map an image to it and create a RealView from each image.
  • Option 3. Import the point cloud and map an image to it.

  Import Image Disabled	Option 1	Option 2	Option 3
  No option available	--e57CreateScanPerImage	--e57CreateScanPerImage --e57EnableImageImport	--e57EnableImageImport

Sample Command

    DeCap.exe --importWithLicense C:\ReCapProjects\Factory GroundFloor.rcp --minRangeClipping 2 --maxRangeClipping 10 C:\RawScans\Factory\Scan001.fls C:\RawScans\Factory\Scan002.fls C:\RawScans\Factory\Scan003.fls