Parametric Files of Orthographic Projections

*.rcortho for Calculation of Orthographic Projections

When using the command -calculateOrthoProjection, the application loads the parameters from a specified params.rcortho file. The file can be generated in a suitable format by creating an orthographic projection manually, exporting it into any format, and setting exportProjectionParametersFile to True during the export.
An example of the .rcortho file content for calculation of an orthographic projection:

<OrthoProjection width="10011" height="8076" name="Ortho projection 1" modelName="Model 1"
    colorType="texturing" boxSideConerIndex="13" bEmpty="0" backFaceColorType="1" backFaceColor="2130706687">
    <Header magic="5787472" version="1"/>
</OrthoProjection>
<ReconstructionRegion globalCoordinateSystem="NONE" globalCoordinateSystemName="NONE" isGeoreferenced="0"
    isLatLon="0" yawPitchRoll="0 -0 -0">
    <widthHeightDepth>29.8926887512207 29.9313926696777 24.1154346466064</widthHeightDepth>
    <Header magic="5395016" version="2"/>
    <CentreEuclid>
        <centre>-0.098011314868927 0.0846212208271027 12.4095182418823</centre>
    </CentreEuclid>
    <Residual R="1 0 0 0 1 0 0 0 1" t="0 0 0" s="1"/>
</ReconstructionRegion>
<DTMParams classificationLayerId="-1">
  <ClassificationParams modelType="nature" postprocessType="soft_edges" sensitivity="0.5"/>
  <Header magic="1480868688" version="1"/>
</DTMParams>

We can generate the file in a suitable format by creating an orthographic projection manually, exporting it into any format and setting exportProjectionParametersFile to True when exporting.
The first part of the file indicates the parameters needed to create a projection.

Parameters:

• width/height - a width/height of a projection
• name - a name of a projection
• modelName - a name of the model which we want to calculate the projection for
• boxSideConerIndex - a number from 0 to 23; it defines which side of the reconstruction region will be the projected plane, and which will be the upper-left corner of the final projection; this number is not defined definitely because it depends on the rotation of the reconstruction region; the best procedure, how to obtain this number, is to create one orthographic projection manually and export it with the projection parameters' file; when making further projections, the use of the number from the boxSideConerIndex will suffice
• colorType - alternatives: texturing, coloring
• bEmpty - alternatives: 0 - an orthographic projection will be calculated; an equivalent to pressing the Render button in the Ortho Projection Tool settings. 1 - an orthographic projection will not be calculated; an equivalent to pressing the Add to batch button in the Ortho Projection Tool settings. We recommend you to leave this parameter set to 0
• backFaceColorType - alternatives: 0 - None - the inner parts of a model projection are not colored differently from the outer ones. 1 - FixedColor - the inner parts of a model projection are colored differently from the outer ones; the color is defined in the backFaceColor.
• backFaceColor - the color of the inner parts of a model

The second part describes parameters of a reconstruction region whose one side represents a projected plane. This part can be obtained by setting the reconstruction region manually and then exporting it.

The third part (between "DTMParams" tags) contains the parameters needed to create a digital terrain model (DTM).

Parameters:

• classificationLayerId - ID of a classification layer from which the DTM is created. "-1" means that a new classification is calculated during rendering. In such case, the user needs to define also ClassificationParams (see below).
• modelType - type of a classification based on the nature of the scene. Alternatives: "industrial_complex", "mixed", "city", "nature", "meadows", "countryside", "mountains".
• postprocessType - type of the postprocessor that will execute a process after classification to clean a model. Alternatives: "none", "soft_edges", "hard_edges".
• sensitivity - value between 0 and 1. If set to 0, everything will be classified as "Artificial object", if set to 1, everything will be classified as "Ground".

To learn more about the point cloud classification, visit this page.