Replay Utility Tool

The Replay Utility tool (ReplayUtils.exe) is a console application that lets you do the following conversions with scan data. You can run it from a command line using Windows Command Prompt or Windows PowerShell.

• .gprec <=> .srf/.sur/.pcd (valid for surface recording data)
• .gprec <=> .pro (valid for profile recording data)
• .gprec <=> .csv (valid for profile/surface recording data)
• folder of .gprec files <=> .gprec file (valid for surface/profile/image/video data)

Intensity information is included when converting to and from .pcd and .srf files. Intensity is not supported when converting to and from the .sur format.

You can get the tool in the utilities package (14631-x.x.x.x_SOFTWARE_GoPxL_Utilities.zip) from the downloads area of the LMI Technologies website: https://lmi3d.com/product-downloads/.

After downloading the utilities package, unzip the file. Then, open a command prompt or PowerShell instance in the folder containing the utility. To open a command line quickly, in File Explorer go to the folder containing the tool, hold Shift, right-click in empty area, and choose "Open command window here" or "Open PowerShell window here."

Run ReplayUtils.exe (under Tools\ReplayUtils). You must either copy the .gprec file into the folder containing the utility, or include its entire path in the call to the utility, for example, ReplayUtils.exe -i \path\to\file\myData.gprec -f 0 -o myOutput.sur.

The tool provides the following parameters:

Parameters

Name	Description
--help	Show the help.
-i --input	Specify the file name of the input file or the input directory. Required.
-f --frame	Specify the zero-based index of the frame to be exported in the recording data. For example, to export the first frame in the scan data, use "-i 0"; for the second frame, use "-i 1". (Default is 0.)
-w --width	Specify the width of the exported surface. (Only valid for importing .pcd files.)
-h --height	Specify the height of the exported surface. (Only valid for importing .pcd files.)
-sxz --swapXZ	Whether to swap the X and Z coordinates. (Only valid for importing .pcd files.)
-syz --swapYZ	Whether to swap the Y and Z coordinates. (Only valid for importing .pcd files.)
-z --zoom	Specify the zooming factor of the exported surface. (Only valid for importing .pcd files.)
-r --remove	Remove the specific point. (Only valid for importing .pcd files.)
-a --all	Export all the frames if the import is recording data.
-o --output	Specify the file name of the output file. If the imported file isn't recording data and the exported file name isn't specified, the utility uses the imported file name as the exported file name.