Output points action can be used to write points into a new file. A typical example is a macro that:
- classifies model keypoints.
- writes only model keypoints into one output file for all block binary files.
- does not affect the original block binary files in any way.
The action can also be used to write points blockwise into new files that may have a different format than the original block binary files, for example for delivery purposes.
|Points||Points for output: All points which would include neighbor points or Active block.|
|Class||Point class(es) that are included in the output file(s).|
|Opens the Select classes dialog which contains the list of active classes in TerraScan. You can select multiple source classes from the list that are then used in the Class field.|
|Transform||Coordinate transformation to apply when computing output coordinates for a point.|
|Inside fence only||If on, only points inside fence or selected polygon are included in the output file(s).|
|To file||Storage location and name of the output file. If it does not include a directory, the project directory is used. If there should be one output file for each block binary file, the file name must include a Variable, such as the block name. Add the extension of the output file manually at the end of the file name according to the selected output Format.|
Add a variable to the output file name:
•#bnumber – block number.
•#block – block name or block binary file name without extension.
•#bpath – path of the block binary file. This includes the binary file name and its extension.
•#bemin – minimum easting value of block boundary vertices.
•#bnmin – minimum northing value of block boundary vertices.
•#bemax – maximum easting value of block boundary vertices.
•#bnmax – maximum northing value of block boundary vertices.
•#pdir – path of the storage directory of the block binary file. This does not include the name of the binary file.
•#name – active file name. Use this to replace the file name component when running a macro on selected files.
|Format||Format of the output file(s).|
|Delimiter||Character that separates different fields in an implemented text file format: Space, Tabulator, or Comma. This is only active if Format is set to a text file format that does not explicitly define the delimiter itself.|
|Xyz decimals||Number of decimals stored for coordinate values. This is only active if Format is set to any text file format.|
|Append if file exists||
If on, input files are written into one output file if the output file name is the same If the output file name does not contain a variable, all input files are written into a single output file.
If off, input files are written into individual output file(s) if the output file name contains a variable. If no variable is used that makes an output file name unique, the process might overwrite existing files of the same name.
|+ve number||Number of points that were written into the output file|
|-1||The process failed due to a missing fence|
|-2||The output file(s) could not be written into the given directory|
|-3||The process failed due to invalid parameters|
|-4||The process failed due to a missing transformation|