92 lines
5.2 KiB
Plaintext
92 lines
5.2 KiB
Plaintext
These scripts were created by Epic Games Slovakia, who doesn't carry any liability in case issues related to the sample occur.
|
|
Epic Games Slovakia would like to thank the company PI3DSCAN (www.pi3dscan.com) for the opportunity to use their datasets Set2-a, Set2-b, Set2-c and Set-logo in this tutorial and also for the permission to distribute them.
|
|
You can download the dataset "Full-body Scan" that can be used to run this script here:
|
|
https://www.capturingreality.com/SampleDatasets
|
|
or directly here https://www.capturingreality.com/download/files/CLI-Sample-Script-FBS
|
|
|
|
In the folder Scripts you can find a set of batch files used to process several full-body scans, while the positions of cameras
|
|
for each data set are preserved with the XMP files.
|
|
|
|
All you need to do is:
|
|
|
|
1. Change the path to the source folders in the Scripts\SetVariables.bat as follows:
|
|
|
|
RealityCaptureExe - path to the installation folder where RealityCapture.exe is stored,
|
|
RootFolder - path to all source folders (where this README.txt file is located). No need to change the original path if you preserve the file structure.
|
|
|
|
2. Run Scripts\_ProcessAll.bat (doubleclick)
|
|
|
|
DESCRIPTION OF BATCH FILEs
|
|
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
|
|
SetVariables.bat
|
|
|
|
Setting the path to the RealityCapture application and the path to the folder with source data.
|
|
This batch file is called inside the ProcessDataSet.bat.
|
|
|
|
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
|
|
_ProcessAll.bat
|
|
|
|
By running this batch file, the ProcessCalibrationSetXMP.bat is called for generation of XMP files from the calibartion set (Set2-a) and the ProcessDataSet.bat is called for each data set.
|
|
|
|
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
|
|
ProcessCalibrationSetXMP.bat
|
|
|
|
In this batch file the creation of XMP files is defined.
|
|
This batch file contains:
|
|
|
|
Setting the variables (if the original data structure and naming is preserved, no need to change them):
|
|
|
|
ImagesGeometry A path to the folder which contains images used for alignment and reconstruction. These images contain a projected pattern for better model accuracy.
|
|
ImagesTexture A path to the folder which contains images used for texturing (without the projected pattern) and for automatic markers detection.
|
|
To find out more information about geometry and texture layers, search for "Image Layers" in the application help.
|
|
Metadata A path to the Metadata folder where the parametric files and the folder with XMP files are located.
|
|
DetectMarkersParams The path to an .xml file with settings used for markers detection.
|
|
GCPCoordinates The path to a .txt file containing all detected markers as ground control points.
|
|
ImportGCPParams The path to an .xml file with settings used for ground control points import.
|
|
XMPExportParams The path to an .xml file with export settings for XMP files.
|
|
|
|
Processing in RealityCapute:
|
|
- open a new scene,
|
|
- clear cache,
|
|
- loading images,
|
|
- detect markers with imported parameters,
|
|
- import ground control points,
|
|
- alignment,
|
|
- export XMP files,
|
|
- save the project,
|
|
- close RC.
|
|
|
|
Move created XMP files from current folder into XMP files folder located in the Metadata folder.
|
|
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
|
|
ProcessDataSet.bat
|
|
|
|
In this batch file the actual processing inside RealityCapture is defined.
|
|
This batch file contains:
|
|
|
|
Setting the variables (if the original data structure and naming is preserved, no need to change them):
|
|
|
|
ImagesGeometry A path to the folder which contains images used for alignment and reconstruction. These images contain a projected pattern for better model accuracy.
|
|
ImagesTexture A path to the folder which contains images used for texturing (without the projected pattern).
|
|
To find out more information about geometry and texture layers, search for "Image Layers" in the application help.
|
|
Metadata A path to the Metadata folder where the parametric files and the folder with XMP files are located.
|
|
XMPMetadata Folder with files necessary to run this batch file. It contains a file defining reconstruction region, model export settings file, and a subfolder with XMP files.
|
|
ReconstructionRegion The path to a reconstruction region file found in the Metadata folder.
|
|
ModelExportParams The path to an .xml file with the parameters defining the model export.
|
|
|
|
Next step is copying the XMP metadata files into the geometry folder to preserve the camera positions.
|
|
The XMP files are automatically loaded into the application with images (if the names correspond to the image names) and used in the alignment process.
|
|
|
|
Processing in RealityCapute:
|
|
- loading images for creating both geometry (alignment and meshing) and texture,
|
|
- enabling camera prior information from XMP files,
|
|
- setting the layer which is going to be used for texturing,
|
|
- alignment,
|
|
- loading the reconstruction region,
|
|
- reconstruction in normal detail,
|
|
- simplification to 1M triangles,
|
|
- texturing the simplified model using the set texturing layer,
|
|
- exporting textured model,
|
|
- saving the project,
|
|
- closing the application.
|
|
|