![]() |
SCENE C++ API
2.0.31
|
Functions and types related to the processing functionality. More...
Functions | |
LSResult::Result | processScan (LSScan &scan, bool forceProcessing=false) |
Processes the scan with some default processing settings. More... | |
LSResult::Result | processScan (LSScan &scan, const ref_ptr< LSProcessSettings > &settings, bool forceProcessing=false) |
Processes the scan with some default processing settings. More... | |
LSResult::Result | preprocessObject (LSObject &objectToPreprocess) |
Preprocess an object. More... | |
LSResult::Result | createCompensatedPanormaImage (LSScan &scan, const LSString &outputPath=L".\\", const bool fullColorDetail=false, const bool createLDRImages=false, const bool doNotCreateHDRImage=false, const LSString &format=L"jpg", const uint32_t backgroundColor=0xFFFFFF) |
Creates a panorama image that can be larger than the resolution of the scan. More... | |
LSResult::Result | colorizeScan (LSScan &scan, const bool laserIlluminatedHDR=false) |
Colorizes the scan. More... | |
Functions and types related to the processing functionality.
LSResult::Result SCENE_API::processScan | ( | LSScan & | scan, |
bool | forceProcessing = false |
||
) |
Processes the scan with some default processing settings.
This will colorize the scan and create a scan point cloud.
scan | The scan to process. |
forceProcessing | Flag to force processing even if already processed |
LSResult::Result SCENE_API::processScan | ( | LSScan & | scan, |
const ref_ptr< LSProcessSettings > & | settings, | ||
bool | forceProcessing = false |
||
) |
Processes the scan with some default processing settings.
This will colorize the scan and create a scan point cloud.
scan | The scan to process. |
settings | Processing options |
forceProcessing | Flag to force processing even if already processed |
LSResult::Result SCENE_API::preprocessObject | ( | LSObject & | objectToPreprocess | ) |
Preprocess an object.
Preprocess is required for some tree objects before they can be properly used. Two examples are Swift Sequences which need trajectory calculation and internal registration before they become usable, and PanoCam scans which first need a calibration to be calculated before colorization can be performed. If any non-Swift Sequence is provided, including the root object, it and all of its children are searched for PanoCam scans and all those found will be preprocessed as such.
objectToPreprocess | The object which needs preprocessing. |
LSResult::Result SCENE_API::createCompensatedPanormaImage | ( | LSScan & | scan, |
const LSString & | outputPath = L".\\" , |
||
const bool | fullColorDetail = false , |
||
const bool | createLDRImages = false , |
||
const bool | doNotCreateHDRImage = false , |
||
const LSString & | format = L"jpg" , |
||
const uint32_t | backgroundColor = 0xFFFFFF |
||
) |
Creates a panorama image that can be larger than the resolution of the scan.
The pixels in the panorama image have equal angular distance to each other. Pixel top left pixels equals 0 degrees both vertically to horizontally. Bottom right Pixel equals 360 degrees horizontally and 180 degrees vertically. The area with more than 150 vertical degrees will be empty for FARO laser scans. The resulting image file will be written to the specified output folder. The filename will be {scanname}.{format} (e.g. "scan123.jpg"). Make sure the scan is loaded before calling this method.
scan | The scan the image should be created for. |
outputPath | The output folder for the generated image file. |
fullColorDetail | Create a panorama that uses the full color data independent of the scan's resolution. |
createLDRImages | Also creates a panorama image for each exposure time if the scan has HDR. The filenames will look like scan123_LDR_1.jpg, scan123_LDR_2.jpg, ... Currently this option only works if fullColorDetail is set to true. |
doNotCreateHDRImage | Skip generation of the tone mapped HDR panorama. This is useful to save time if you are only interested in the LDR images. |
format | The output format as string. Supported formats are "png", "bmp" and "jpg". |
backgroundColor | The background color is used to fill areas where there is no scan data. It is a hex color code in RGB order. E.g. 0xFF0000 is red. Alpha channel is not supported. |
LSResult::Result SCENE_API::colorizeScan | ( | LSScan & | scan, |
const bool | laserIlluminatedHDR = false |
||
) |
Colorizes the scan.
Colorization is normally done during the processing of a scan. However, this method permits to colorize the scan without having to process it. Only FARO scans are supported.
scan | The scan to colorize |
laserIlluminatedHDR | Will enable colorization using Laser Illuminated HDR if set to true and the scan supports this feature. |