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.

• --e57MatchImageResolution - Enables ReCap to use the image resolution for the RealView construction instead of the point cloud resolution.

• --e57LevelImage - Enables ReCap to apply upright adjustment using E57 poses so the horizon looks level. Recommended for SLAM / handheld scans.

  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