Command line mode

2019-02-18T21:56:01Z

Foobarbecue: /* Available options (version 2.10.1) */ Add PCV command

Since version 2.3, CloudCompare can be used in "command line" mode.

By default, this mode only opens a small console window, applies the requested actions, and eventually saves the result in a file in the same directory(ies) as the input file(s). Commands are applied in the order they are written (like a ''state machine'').

=Available options (version 2.10.1) =

{| cellpadding="10" style="text-align:left; border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #000"
!style="border-style: solid; border-width: 1px" ! scope="col" width="200" | Command
!style="border-style: solid; border-width: 1px"| Description
|-
|style="border-style: solid; border-width: 1px"| <code>-SILENT</code>
|style="border-style: solid; border-width: 1px"| ''enables silent mode (no console will appear)''
Warning: must be first if required.
|-
|style="border-style: solid; border-width: 1px"| <code>-O {filename}</code>
|style="border-style: solid; border-width: 1px"| ''opens a file''

If the file format is ASCII, optional settings are:
* <code>-SKIP {number of lines to skip}</code> If set, CC will automatically skip the specified number of lines
For all formats, optional settings are (version 2.5.6 and above):
* <code>-GLOBAL_SHIFT {AUTO} or {x y z}</code> If set, CC will either handle big coordinates automatically (AUTO) or apply the specified Global Shift vector (x,y,z)

Note: file type is automatically guessed from its extension.
|-
|style="border-style: solid; border-width: 1px"| <code>-OCTREE_NORMALS {radius}</code>
|style="border-style: solid; border-width: 1px"| ''Computes the [[Normals%5CCompute | normals]] for all loaded clouds with the specified radius.''

Notes:
* for now the local model is 'Height Function' and no default orientation is specified
* if you have files containing structured clouds (e.g. PTX, FARO, DP, etc.), it may be more efficient to use the 'COMPUTE_NORMALS' option (see below)
|-
|style="border-style: solid; border-width: 1px"| <code>-COMPUTE_NORMALS</code>
|style="border-style: solid; border-width: 1px"| ''forces CC to compute normals at loading time (which is generally more robust) when importing files containing structured clouds (i.e. PTX, FARO and DP file for now). Normals are not computed by default.''

Note: must be placed before the '-O' option.
|-
|style="border-style: solid; border-width: 1px"| <code>-CLEAR_NORMALS</code>
|style="border-style: solid; border-width: 1px"| ''Removes all normals from the loaded entities.''
|-
|style="border-style: solid; border-width: 1px"| <code>-ORIENT_NORMS_MST {number of neighbors}</code>
|style="border-style: solid; border-width: 1px"| ''[[Normals%5COrient_Normals_With_Minimum_Spanning_Tree | (Re)orient the normals]] of the loaded clouds with a Minimum Spanning Tree.''

Note: Clouds without normals are simply ignored.

|-
|style="border-style: solid; border-width: 1px"| <code>-MERGE_CLOUDS</code>
|style="border-style: solid; border-width: 1px"| ''merges all loaded/generated clouds as one unique cloud.''

Note: result is automatically saved by default (see the AUTO_SAVE command to change this).
|-
|style="border-style: solid; border-width: 1px"| <code>-MERGE_MESHES</code>
|style="border-style: solid; border-width: 1px"| ''merges all loaded/generated meshes as one unique mesh.''

Note: result is automatically saved by default (see the AUTO_SAVE command to change this). This option is available since version 2.9.
|-
|style="border-style: solid; border-width: 1px"| <code>-SS {algorithm} {parameter}</code>
|style="border-style: solid; border-width: 1px"| ''applies a [[Edit%5CSubsample | subsampling]] {algorithm} on the currently opened/generated cloud(s).''
{algorithm} can be RANDOM, SPATIAL or OCTREE. Expected parameter is:
* RANDOM: number of randomly selected points
* SPATIAL: minimum distance between two points
* OCTREE: subdivision level (between 1 and 10 in the standard version)

Notes:
* result is automatically saved by default (see the AUTO_SAVE command to change this).
* input clouds are now replaced by their subsampled version (since version 2.6.1)
|-
|style="border-style: solid; border-width: 1px"| <code>-EXTRACT_CC {octree level} {minimum number of points per component}</code>
|style="border-style: solid; border-width: 1px"| ''extracts the [[Label_Connected_Components | connected components]] from the currently opened/generated cloud(s).''
{octree level} should be between 1 and 21.

Notes:
* extracted components are automatically saved by default (see the AUTO_SAVE command to change this).
* input clouds are replaced by the extracted components
|-
|style="border-style: solid; border-width: 1px"| <code>-SAMPLE_MESH {method} {parameter}</code>
|style="border-style: solid; border-width: 1px"| ''[[Mesh%5CSample_points | samples points]] on the loaded mesh(es).''
For each mesh, a cloud will be generated (and will be added to the current loaded cloud set - i.e. further processing can be applied to this cloud).

{method} can be POINTS or DENSITY. Expected parameter is:
* POINTS: the corresponding number of points
* DENSITY: the corresponding surface density

Notes:
* result is automatically saved by default (see the AUTO_SAVE command to change this)
* this cloud can be used as input for cloud-to-cloud or cloud-to-mesh distances computation for instance.
|-
|style="border-style: solid; border-width: 1px"| <code>-EXTRACT_VERTICES</code>
|style="border-style: solid; border-width: 1px"| ''Extract the vertices of all loaded meshes as standalone point clouds. Note that this option is not yet activated! (sorry about that)''

Notes:
* result is automatically saved by default (see the AUTO_SAVE command to change this)
* the source mesh is discarded
* since version 2.10 only
|-
|style="border-style: solid; border-width: 1px"| <code>-C2C_DIST</code>
|style="border-style: solid; border-width: 1px"| ''computes [[Cloud-to-Cloud_Distance | cloud-to-cloud distances]] on the two first loaded/generated clouds (1st = compared / 2nd = reference).''

Optional settings are:
* <code>-SPLIT_XYZ</code> If set, 3 additional scalar fields will be generated (displacement along the 3 dimensions)
* <code>-MAX_DIST {value}</code> to set a max distance above which CC won't have to search for a nearest neighbor (faster)
* <code>-OCTREE_LEVEL {value}</code> to manually set the octree subdivision level at which the computation will be performed
* <code>-MODEL {local_model_type} {neighborhood_type} {neighborhood_size}</code> to specify a local model:
** {local_model_type} = LS / TRI / HF
** {neighborhood_type} = KNN / SPHERE
** {neighborhood_size} = neighbor count (if KNN) or sphere radius (if SPHERE)
* <code>-MAX_TCOUNT {thread count}</code> to set the maximum number of threads to use

Notes:
* result is automatically saved by default (see the AUTO_SAVE command to change this)
* see below for more details
|-
|style="border-style: solid; border-width: 1px"| <code>-C2M_DIST</code>
|style="border-style: solid; border-width: 1px"| ''computes [[Cloud-to-Mesh_Distance | Cloud-to-Mesh distances]] between the first loaded/generated cloud (compared) and the first loaded mesh (reference).''

Optional settings are:
* <code>-FLIP_NORMS</code> to consider that normal vectors point inside the matter and not outside
* <code>-MAX_DIST {value}</code> to set a max distance above which CC won't have to search for a nearest neighbor (faster)
* <code>-OCTREE_LEVEL {value}</code> to manually set the octree subdivision level at which the computation will be performed
* <code>-MAX_TCOUNT {thread count}</code> to set the maximum number of threads to use

Notes:
* result is automatically saved by default (see the AUTO_SAVE command to change this)
* see below for more details
|-
|style="border-style: solid; border-width: 1px"| <code>-RASTERIZE -GRID_STEP {value}</code>
|style="border-style: solid; border-width: 1px"| ''[[Rasterize | Rasterizes]] the loaded clouds by projecting them inside a regular grid.''

Optional settings are:
* <code>-VERT_DIR {0/1/2}</code> to specify the projection dimension (0=X / 1=Y / 2=Z) - default is 2 (Z)
* <code>-PROJ {MIN/AVG/MAX}</code> to specify how the altitude of each cell is computed (minimum, average or maximum altitude of the projected points). Default is AVG (average)
* <code>-SF_PROJ {MIN/AVG/MAX}</code> to specify how the SF value(s) of each cell are computed (minimum, average or maximum altitude of the projected points SF value(s)). Default is AVG (average)
* <code>-EMPTY_FILL {MIN_H/MAX_H/CUSTOM_H/INTERP}</code> to specify how empty cells should be filled (MIN_H = min height / MAX_H = max height / CUSTOM_H = custom value - see CUSTOM_HEIGHT option below / INTERP = interpolate). Default behavior is 'leave cells empty'
* <code>-CUSTOM_HEIGHT {value}</code> to define the custom height filling value (if the 'CUSTOM_H' strategy is used (see above)
* <code>-OUTPUT_CLOUD</code> to output the result as a cloud (this is the default option if no other output format is defined)
* <code>-OUTPUT_MESH</code> to output the result as a mesh
* <code>-OUTPUT_RASTER_Z</code> to output the result as a geotiff raster (altitudes + all SFs by default, no RGB)
* <code>-OUTPUT_RASTER_RGB</code> to output the result as a geotiff raster (RGB)
Notes:
* if OUTPUT_CLOUD or OUTPUT_MESH is selected, the resulting entity will replace the original cloud in memory
|-
|style="border-style: solid; border-width: 1px"| <code>-VOLUME -GRID_STEP {grid step}</code>
|style="border-style: solid; border-width: 1px"| ''[[2.5D_Volume | 2.5D estimation of the volume]] between two point clouds (the first is the ceiling, the second is the ground by default).''

This tool outputs two files:
* the volume calculation report (named VolumeCalculationReport.txt and saved next to the first file)
* the 2.5D grid points with the 'height difference' as a scalar field and also as RGB colors (colors are generated with the default color scale of CC). The file is saved next to the previous one, and it has the same base name as the first file with '_HEIGHT_DIFFERENCE' appended at the end.

Optional settings are:
* <code>-VERT_DIR {0/1/2}</code> to specify the projection dimension (0=X / 1=Y / 2=Z) - default is 2 (Z)
* <code>-CONST_HEIGHT {value}</code> to use a constant height instead of the second cloud
* <code>-GROUND_IS_FIRST</code> to invert the clouds order
* <code>-OUTPUT_MESH</code> to output a mesh instead of a cloud

Notes:
* result is automatically saved by default (see the AUTO_SAVE command to change this)
* see below for more details
|-
|style="border-style: solid; border-width: 1px"| <code>-STAT_TEST {distrib} {distrib parameters} {p-value} {neighbors count}</code>
|style="border-style: solid; border-width: 1px"| ''applies a [[Local_Statistical_Test | local statistical test]] based on the active scalar field all the of loaded/generated clouds.''
{distrib} can be GAUSS or WEIBULL. Expected distribution parameters are:
* GAUSS: the mean value and sigma
* WEIBULL: a, b and the shift value

Note: result is automatically saved by default (see the AUTO_SAVE command to change this).
|-
|style="border-style: solid; border-width: 1px"| <code>-COORD_TO_SF {dimension: X, Y or Z}</code>
|style="border-style: solid; border-width: 1px"| ''[[Scalar_fields%5CExport_coordinate(s)_to_SF(s) | exports the specified coordinate]] (dimension) to a scalar field.''

Note: creates a new scalar field (or overwrite any existing one with the same name) and sets it active.
|-
|style="border-style: solid; border-width: 1px"| <code>-FILTER_SF {minVal} {maxVal}</code>
|style="border-style: solid; border-width: 1px"| ''[[Scalar_fields%5CFilter_by_Value | filters]] all the loaded/generated clouds based on their active scalar field values.''

A new cloud is created each time with only the points falling in the [minVal maxVal] interval.

Notes:
* result is automatically saved by default (see the AUTO_SAVE command to change this).
* input clouds are now replaced by their filteterd version (since version 2.6.1)

You can use special words in place of numbers that CC will replace by the actual SF values:
* 'MIN' = min value
* 'DISP_MIN' = min displayed value
* 'SAT_MIN' = min saturation value
* 'MAX' = max value
* 'DISP_MAX' = max displayed value
* 'SAT_MAX' = max saturation value
|-
|style="border-style: solid; border-width: 1px"| <code>-DENSITY {sphere radius}</code>
|style="border-style: solid; border-width: 1px"| ''computes the [[Density | density]] (inside a sphere around each point) on the currently opened/generated cloud(s).''

Optional setting:
* -TYPE {density_type}: to specify the type of density to compute. {density_type} can be KNN (nearest neighbors count), SURFACE (surface density) or VOLUME (volume density).

Notes:
* a new scalar field is created on each cloud
* result is automatically saved by default (see the AUTO_SAVE command to change this)
|-
|style="border-style: solid; border-width: 1px"| <code>-APPROX_DENSITY</code>
|style="border-style: solid; border-width: 1px"| ''computes [[Density | approximate density]] on the currently opened/generated cloud(s).''

Optional setting:
* -TYPE {density_type}: to specify the type of density to compute. {density_type} can be KNN (nearest neighbors count), SURFACE (surface density) or VOLUME (volume density).

Notes:
* a new scalar field is created on each cloud.
* result is automatically saved.
|-
|style="border-style: solid; border-width: 1px"| <code>-ROUGH {kernel size}</code>
|style="border-style: solid; border-width: 1px"| ''computes the [[Roughness | roughness]] with a given kernel size on the currently opened/generated cloud(s).''

Notes:
* a new scalar field is created on each cloud
* result is automatically saved by default (see the AUTO_SAVE command to change this)
|-
|style="border-style: solid; border-width: 1px"| <code>-CURV {type} {kernel size}</code>
|style="border-style: solid; border-width: 1px"| ''computes [[Curvature | local curvature]] with a given kernel size on the currently opened/generated cloud(s).''
{type} can be MEAN, GAUSS or NORMAL_CHANGE (this last option stands for 'Normal change rate' and is only available in version 2.10 or later).

Notes:
* a new scalar field is created on each cloud
* result is automatically saved by default (see the AUTO_SAVE command to change this)
|-
|style="border-style: solid; border-width: 1px"| <code>-SF_GRAD {euclidian}</code>
|style="border-style: solid; border-width: 1px"| ''computes the [[Scalar_fields%5CGradient | gradient]] of the active scalar field (or the first one if none is active) on the currently opened/generated cloud(s).''
The {euclidian} option specifies whether the scalar field is 'euclidian' (TRUE) - typically like a distance field - or not (FALSE).

Notes:
* a new scalar field is created on each cloud
* result is automatically saved by default (see the AUTO_SAVE command to change this)
|-
|style="border-style: solid; border-width: 1px"| <code>-BEST_FIT_PLANE</code>
|style="border-style: solid; border-width: 1px"| ''computes the [[Fit_Plane | best fitting plane]] on all loaded clouds.''

Optional settings are:
* -MAKE_HORIZ: will actually transform the loaded cloud(s) so as to make them 'horizontal'
* -KEEP_LOADED: to keep the resulting plane(s) in memory as mesh(es)

Notes:
* resulting planes are automatically saved
* if MAKE_HORIZ is defined, result is automatically saved by default (see the AUTO_SAVE command to change this)
|-
|style="border-style: solid; border-width: 1px"| <code>-APPLY_TRANS {filename}</code>
|style="border-style: solid; border-width: 1px"| ''applies a 4x4 transformation matrix on the loaded entities (clouds or meshes). The matrix is read from a simple text file with the matrix rows on each line (4 values per lines, 4 lines).''

Notes:
* each entity will be replaced in memory by its transformed version
* resulting entities are automatically saved by default (see the AUTO_SAVE command to change this)
|-
|style="border-style: solid; border-width: 1px"| <code>-MATCH_CENTERS</code>
|style="border-style: solid; border-width: 1px"| ''makes all the (bounding-box) centers of the loaded entities match. All the entities will move relatively to the first one (clouds are always considered first if clouds and meshes are loaded).''

Note: result is automatically saved by default (see the AUTO_SAVE command to change this).
|-
|style="border-style: solid; border-width: 1px"| <code>-DELAUNAY</code>
|style="border-style: solid; border-width: 1px"| ''[[Mesh%5CDelaunay_2.5D_(XY_plane) | Triangulates]] the loaded clouds with 2.5D Delaunay triangulation. The triangulation is done in the (XY) plane by default.''

Optional settings are:
* -AA: to triangulate the points in the (XY) plane (default behavior).
* -BEST_FIT: to [[Mesh%5CDelaunay_2.5D_(best_fit_plane) | triangulate the points in their best fit plane]]
* -MAX_EDGE_LENGTH {length}: to remove the triangles with edges longer than a given threshold

Notes:
* the resulting 'mesh' entity is automatically saved (see the AUTO_SAVE command to change this).
* the clouds are automatically removed (from the 'loaded clouds' set).
|-
|style="border-style: solid; border-width: 1px"| <code>-ICP</code>
|style="border-style: solid; border-width: 1px"| ''[[ICP | Iterative Closest Point]] registration procedure.''

Optional settings are:
* -REFERENCE_IS_FIRST: by default the ICP registration process will take the first loaded entity as 'data' and the second as 'model' (clouds are always considered first). If you use this option their respective role will be inverted.
* -MIN_ERROR_DIFF: to specify the min. error difference between two steps (default = 1e-6)
* -ITER: to specify the number of iterations (in which case the 'MIN_ERROR_DIFF' option will be ignored)
* -OVERLAP: to specify the percentage of (final) overlap (integer number between 10 and 100 - default = 100)
* -ADJUST_SCALE: to enable the ICP registration with adaptive scale
* -RANDOM_SAMPLING_LIMIT: to specify the number of points randomly sampled at each iteration (default = 20 000)
* -FARTHEST_REMOVAL: to enable the ''research'' option that ignores points with the highest distances at each iteration
* -DATA_SF_AS_WEIGHTS + {SF index}: to use a given scalar field as weights on the 'data' entity (index starts from 0 - the 'LAST' keyword can be used)
* -MODEL_SF_AS_WEIGHTS + {SF index}: to use a given scalar field as weights on the 'model' entity (index starts from 0 - the 'LAST' keyword can be used)

Notes:
* the 'data' entity in its final position is automatically saved (see the AUTO_SAVE command to change this).
* the corresponding transformation matrix is automatically saved in a separate text file (always).
|-
|style="border-style: solid; border-width: 1px"| <code>-CROP {Xmin:Ymin:Zmin:Xmax:Ymax:Zmax}</code>
|style="border-style: solid; border-width: 1px"| ''[[Crop | Crops]] all loaded clouds inside or outside a given box.''

Optional settings are:
* -OUTSIDE: if defined only the points falling outside the input box will be kept (instead of inside by default).

Notes:
* result is automatically saved by default (see the AUTO_SAVE command to change this)
* each cloud will be replaced in memory by its cropped version
|-
|style="border-style: solid; border-width: 1px"| <code>-CROP2D {ortho_dim} {n:number of vertices} X1 Y1 X2 Y2 ... Xn Yn</code>
|style="border-style: solid; border-width: 1px"| ''Crops all loaded clouds inside or outisde a given 2D polyline. Cropping is done in a plane defined by its orthogonal dimension: X, Y or Z (i.e. coordinates along this dimension will be ignored).''

Optional settings are:
* -OUTSIDE: if defined only the points falling outside the input polyline will be kept (instead of inside by default).

Note:
* result is automatically saved by default (see the AUTO_SAVE command to change this)
* each cloud will be replaced in memory by its cropped version

|-
|style="border-style: solid; border-width: 1px"| <code>-CROSS_SECTION {XML parameters file}</code>
|style="border-style: solid; border-width: 1px"| ''[[Cross_Section | Extracts one or multiple sections]] from the clouds or meshes.''

Either the loaded clouds and/or meshes (see the -O option) can be used otherwise CC can load one or several files from a specified folder (use the 'FilePath' key).

See [http://www.cloudcompare.org/doc/cross_section_params.xml] for an example of XML parameter file.

Note:
* output sections for meshes are 'clean' (i.e. triangles on the cutting borders are re-meshed)
* output sections are automatically saved in sub-folders (they are not kept in memory)

|-
|style="border-style: solid; border-width: 1px"| <code>-SOR {number of neighbors} {sigma multiplier}</code>
|style="border-style: solid; border-width: 1px"| ''applies the [[SOR_filter | SOR (Statistical Outlier Removal) filter]] on the loaded cloud(s).''
For each cloud, a new one will be generated (and will replace the origin cloud).

Notes:
* result is automatically saved by default (see the AUTO_SAVE command to change this)
|-
|style="border-style: solid; border-width: 1px"| <code>-SF_ARITHMETIC {SF index} {operation}</code>
|style="border-style: solid; border-width: 1px"| ''applies [[Scalar_fields%5CArithmetic | operations]] on a given scalar field of the loaded cloud/mesh.''

SF2 = operation(SF)

The scalar-field index starts from 0. The user can use the keyword 'LAST' to designate the last scalar field.

Supported operations are:
* sqrt (square root)
* pow2
* pow3
* exp
* log
* log10
* cos
* sin
* tan
* acos
* asin
* atan
* int (integer part)
* inverse

Notes:
* the updated cloud/mesh is automatically saved (see the AUTO_SAVE command to change this)
* a new scalar field is created
|-
|style="border-style: solid; border-width: 1px"| <code>-SF_OP {SF index} {operation} {value} </code>
|style="border-style: solid; border-width: 1px"| ''applies an [[Scalar_fields%5CArithmetic | arithmetic operation]] on a given scalar field of the loaded cloud/mesh and with a given scalar value.''

SF = SF (+,-,*,/) VALUE

The scalar-field index starts from 0. The user can use the keyword 'LAST' to designate the last scalar field.

Supported operations are:
* add
* sub
* mult
* div

Notes:
* the updated cloud/mesh is automatically saved (see the AUTO_SAVE command to change this)
* the modification is done in place (i.e. the scalar field is directly modified)
|-
|style="border-style: solid; border-width: 1px"| <code>-CBANDING {dim} {freq}</code>
|style="border-style: solid; border-width: 1px"| ''Applies [[Colors%5CHeight_Ramp | color banding]] to all loaded entities (clouds and meshes). The user must specify the dimension (dim = X, Y or Z) and the frequency (in Hz, as an integer).''

Note:
* result is automatically saved by default (see the AUTO_SAVE command to change this)
|-
|style="border-style: solid; border-width: 1px"| <code>-SF_COLOR_SCALE {filename}</code>
|style="border-style: solid; border-width: 1px"| ''Loads a color scale from a XML file (generated with the [[Scalar_fields%5CColor_Scales_Manager | Color Scales Manager]]). The loaded color scale is then applied to the active scalar field.''

Note:
* it may be necessary to explicitly set the active scalar field with the SET_ACTIVE_SF command
* since version 2.10 only
|-
|style="border-style: solid; border-width: 1px"| <code>-SF_CONVERT_TO_RGB {TRUE/FALSE}</code>
|style="border-style: solid; border-width: 1px"| ''Converts the active scalar field to RGB colors. The user must explicitly specify whether the previously existing colors (if any) should be mixed with the new ones (TRUE) or overwritten (FALSE).''

Note:
* it may be necessary to explicitly set the active scalar field with the SET_ACTIVE_SF command
* since version 2.10 only
|-
|style="border-style: solid; border-width: 1px"| <code>-C_EXPORT_FMT {format}</code>
|style="border-style: solid; border-width: 1px"| ''Specifies the default output format for clouds. Format can be one of the following: ASC, BIN, PLY, LAS, E57, VTK, PCD, SOI, PN, PV.''

Optional settings are:
* -PREC [precision]: to specify the numerical output precision (for ASCII files only). ''precision'' is a positive integer (default = 12).
* -SEP [separator]: to specify the separator character (for ASCII files only). ''separator'' can be one of the following string: SPACE, SEMICOLON, COMMA or TAB (default = SPACE).
* -ADD_HEADER: to add a header with each column's name to the saved file (for ASCII files only).
* -ADD_PTS_COUNT: to add the number of points at the beginning of the saved file (for ASCII files only).
* -EXT [extension]: to specify the file extension (typically different from the default one for the chosen format)

'''WARNING: the ADD_HEADER and ADD_PTS_COUNT options are broken in the 2.6.2 version. Use the latest [http://www.cloudcompare.org/release/CloudCompare_v2.6.3.beta_bin_x64.zip 2.6.3 beta version] instead.'''
|-
|style="border-style: solid; border-width: 1px"| <code>-M_EXPORT_FMT {format}</code>
|style="border-style: solid; border-width: 1px"| ''Specifies the default output format for meshes. Format can be one of the following: BIN, OBJ, PLY, STL, VTK, MA, FBX.''

Optional settings are:
* -EXT [extension]: to specify the file extension (typically different from the default one for the chosen format)
|-
|style="border-style: solid; border-width: 1px"| <code>-FBX_EXPORT_FMT {format}</code>
|style="border-style: solid; border-width: 1px"| ''Specifies the default output format for FBX meshes. Must be specified in addition to M_EXPORT_FMT if FBX format is chosen. Format can be one of the following: FBX_binary, FBX_ascii, FBX_encrypted, FBX_6.0_binary, FBX_6.0_ascii, FBX_6.0_encrypted.''

Note: if the input format is not supported by the current implementation, a list of available formats will be output in the console.
|-
|style="border-style: solid; border-width: 1px"| <code>-PLY_EXPORT_FMT {format}</code>
|style="border-style: solid; border-width: 1px"| ''Specifies the default output format for PLY files. Format can be one of the following: ASCII, BINARY_BE (big endian) or BINARY_LE (little endian).''

Note: default output format is binary (LE/BE depending on the current OS)
|-
|style="border-style: solid; border-width: 1px"| <code>-NO_TIMESTAMP</code>
|style="border-style: solid; border-width: 1px"| ''to prevent CC from generating an automatic suffix (timestamp) for output file name (warning: this make the name of an output file predictable but if the file already exists it will be overwritten).''
|-
|style="border-style: solid; border-width: 1px"| <code>-BUNDLER_IMPORT {filename}</code>
|style="border-style: solid; border-width: 1px"| ''imports a Snavely's Bundler file.''

Bundler import through the command line is mainly meant to generate ortho-rectified versions of input images directly on disk.
Optional settings are:
* -ALT_KEYPOINTS [filename]: load alternative keypoints from file ''filename''
* -SCALE_FACTOR [value]: sets image scale factor that has been used during keypoints generation
* -COLOR_DTM [vertices count]: generates colored vertices of a pseudo-DTM with approximately 'vertices count' elements (in command line mode, vertices are automatically saved to 'colored_dtm_vertices.bin' next to ortho-rectified images)
* -UNDISTORT: enables images undistortion

Note: see below for more details.
|-
|style="border-style: solid; border-width: 1px"| <code>-DROP_GLOBAL_SHIFT</code>
|style="border-style: solid; border-width: 1px"| ''Removes the Global Shift information from all loaded entities.''
|-
|style="border-style: solid; border-width: 1px"| <code>-SET_ACTIVE_SF {index}</code>
|style="border-style: solid; border-width: 1px"| ''Sets the active scalar field index (for all loaded clouds).''

Note:
* scalar field indexes start at 0 ('-1' means 'no SF enabled')
|-
|style="border-style: solid; border-width: 1px"| <code>-REMOVE_ALL_SFS</code>
|style="border-style: solid; border-width: 1px"| ''Removes all scalar fields (from all loaded clouds or meshes).

Note:
* entities are not automatically saved after this command (you can use -SAVE_CLOUDS or -SAVE_MESHES explicitly)
|-
|style="border-style: solid; border-width: 1px"| <code>-REMOVE_SCAN_GRIDS</code>
|style="border-style: solid; border-width: 1px"| ''Removes all scan grids (from all loaded clouds or meshes).

Note:
* entities are not automatically saved after this command (you can use -SAVE_CLOUDS or -SAVE_MESHES explicitly)
* available since version 2.10 only
|-
|style="border-style: solid; border-width: 1px"| <code>-AUTO_SAVE {''ON/OFF''}</code>
|style="border-style: solid; border-width: 1px"| ''Enables (''ON'') or disables (''OFF'') automatic backup of clouds and meshes at each step (you'll have to manually call ''-SAVE_CLOUDS'' or ''-SAVE_MESHES'' at the right time/position in your command).''
|-
|style="border-style: solid; border-width: 1px"| <code>-SAVE_CLOUDS</code>
|style="border-style: solid; border-width: 1px"| ''Saves all currently loaded clouds (note that this is not necessary by default as all modified or newly generated cloud are automatically saved).''
Optional settings are:
* ALL_AT_ONCE: saves all clouds in a single file (the current output format must support it!)
* FILE "file1.xxx file2.yyy ..." : to specify the output filename(s) of the clouds (use quotes if multiple names or names with space characters) [since version 2.10]
|-
|style="border-style: solid; border-width: 1px"| <code>-SAVE_MESHES</code>
|style="border-style: solid; border-width: 1px"| ''Saves all currently loaded meshes (note that this is not necessary by default as all modified or newly generated meshes are automatically saved).''
Optional settings are:
* ALL_AT_ONCE: saves all meshes in a single file (the current output format must support it!)
* FILE "file1.xxx file2.yyy ..." : to specify the output filename(s) of the clouds (use quotes if multiple names or names with space characters) [since version 2.10]
|-
|style="border-style: solid; border-width: 1px"| <code>-CLEAR</code>
|style="border-style: solid; border-width: 1px"| ''closes all currently loaded entities.''
|-
|style="border-style: solid; border-width: 1px"| <code>-CLEAR_CLOUDS</code>
|style="border-style: solid; border-width: 1px"| ''closes all currently loaded clouds.''
|-
|style="border-style: solid; border-width: 1px"| <code>-CLEAR_MESHES</code>
|style="border-style: solid; border-width: 1px"| ''closes all currently loaded meshes.''
|-
|style="border-style: solid; border-width: 1px"| <code>-POP_CLOUDS</code>
|style="border-style: solid; border-width: 1px"| ''removes the last loaded cloud.''
|-
|style="border-style: solid; border-width: 1px"| <code>-POP_MESHES</code>
|style="border-style: solid; border-width: 1px"| ''removes the last loaded mesh.''
|-
|style="border-style: solid; border-width: 1px"| <code>-LOG_FILE {filename}</code>
|style="border-style: solid; border-width: 1px"| ''logs all command output messages in a given file.''
|-
|style="border-style: solid; border-width: 1px"| <code>-PCV</code>
|style="border-style: solid; border-width: 1px"| ''Runs the [[ ShadeVis (plugin) | PCV plugin]] (also known as ambient occlusion or ShadeVis)''

Optional settings are:
* -N_RAYS [value]: number of rays
* -IS_CLOSED: Tells PCV that the mesh is watertight. This accelerates processing.
* -180: Rays only come from the "northern hemisphere" (northern means +Z)
* -RESOLUTION: OpenGL context resolution

|}

=Example 1=

:<code>CloudCompare -O ''myhugecloud.bin'' -SS SPATIAL 0.1</code>
This will open file ''myhugecloud.bin'' then apply spatial subsampling with a 0.1 step (e.g. in meters). The output file will be ''myhugecloud_SPATIAL_SUBSAMPLED_YYYY-MM-DD_HHhMM.bin''.

=Example 2=
:<code>CloudCompare -O ''myhugecloud1.bin'' -SS SPATIAL 0.1 -O 'myhugecloud2.bin' -SS RANDOM 1000000 -CLEAR_ALL -O 'myhugecloud3.bin' -SS OCTREE 9</code>
This will open file ''myhugecloud1.bin'' then apply spatial subsampling with a 0.1 step (e.g. in meters).<br>
Then it will open file ''myhugecloud2.bin'' and apply to '''both files''' random subsampling (1 000 000 points each).<br>
Then it will close the two first files.<br>
Eventually it will open file ''myhugecloud3.bin'' and apply octree based subsampling (level 9).

The output files will be: ''myhugecloud1_SPATIAL_SUBSAMPLED_YYYY-MM-DD_HHhMM.bin'', ''myhugecloud1_RANDOM_SUBSAMPLED_YYYY-MM-DD_HHhMM.bin'', ''myhugecloud2_RANDOM_SUBSAMPLED_YYYY-MM-DD_HHhMM.bin'' and ''myhugecloud3_OCTREE_level_9_SUBSAMPLED_YYYY-MM-DD_HHhMM.bin''

=Cloud-to-cloud distance=

:<code>CloudCompare -o cloud1.bin -o cloud2.asc -c2c_dist -split_xyz -model HF SPHERE 50.0</code>
CC will load ''cloud1.bin'' and ''cloud2.asc'', then compute the distance from cloud1 (''compared'') relatively to cloud2 (''reference'') with a height function (''quadric'') computed on all the neighbors falling in a sphere of radius 50.0 around each point of ''cloud1''. On output a file ''cloud1_C2C_DIST_YYYY-MM-DD_HHhMM.bin'' will be generated (with the resulting distances as first scalar field and the 3 components of the corresponding displacement vector along X, Y and Z as additional scalar fields).

Note: this cloud stays in memory and can be processed further (with -FILTER_SF for instance).

=Cloud-to-mesh distance=

:<code>CloudCompare -o cloud1.bin -o mesh.obj -c2m_dist</code>
CC will load ''cloud1.bin'' and ''mesh.obj'', then compute the distance from cloud1 (''compared'') relatively to mesh (''reference''). On output a file ''cloud1_C2M_DIST_YYYY-MM-DD_HHhMM.bin'' will be generated (with the resulting distances as scalar field).

Note: this cloud stays in memory and can be processed further (with -FILTER_SF for instance).

=Bundler import=

:<code>CloudCompare -BUNDLER_IMPORT bundle.out -COLOR_DTM 1000000</code>
This will generate all ortho-rectified versions of the images declared in 'bundle.out', as well as the colored vertices of a pseudo-DTM constructed from the keypoints.

=(Mesh) format conversion=

:<code>CloudCompare -M_EXPORT_FMT FBX -FBX_EXPORT_FMT FBX_Binary -O Foot.ply -NO_TIMESTAMP -SAVE_MESHES</code>
This will open the file named 'Foot.ply' then save it in FBX binary format (same base filename, without any decoration: i.e. ''Foot.fbx'')

CloudCompare wiki - User contributions [en]

Command line mode