====== Convert Data ======

This pages describes the desktop additional tool "Convert Data". 

{{orbit_desktop:how_to_find.png?25&nolink  |}} [[170:desktop:tools:index|Tools]] > ... > Convert 

===== Concepts =====

"Convert Data" converts any [[180:technology:supported_formats:index|supported resources file]] into another supported resource file, one on one. \\ 
"[[170:desktop:tools:optimize_data|Optimize Data]]" optimizes one or more supported resource files into an Orbit native, single resource file.

===== Sidebar =====

{{  :170:desktop:tools:tools_convert_pointcloud.png?nolink|}}

=== Data Type ===

One and the same sidebar is used to convert Image, Vector and Point Cloud resources. \\ 
Select the appropriated Data Type for conversion. 

=== Source ===

Set the source file or the source directory. \\
When selecting a source directory, all supported resource files of the specified data type inside the selected source directory and, optionally, all its subfolders will be converted.

Note for Point Cloud data. \\
The source CRS must be set. If the CRS cannot be derived from the resource headers or accompanied [[180:technology:supported_formats:other:ord|Ord file]] the [[180:technology:core:crs|Map CRS]] will be used.

===Target===

Set the target file or, when converting a source directory, the target directory. \\
By default source name and location will be used as target. 

  * Reorganize subfolders : Option available when converting a source directory including all its subfolders to re-create the source directory tree inside the target directory. 
  * Overwrite existing files : Option to overwrite existing files. 
  * Add results to dataset list : Option to add the converted result files directly to the [[170:desktop:dataset:index|Dataset List]].

Note for Point Cloud data. \\
The target CRS must be set, by default the source CRS will be used as target. 

=== Options ===

  * Format : Target resource file storage format. 

** Point Cloud ** 

Options for Point Cloud data only.

  * Strip Attributes : Options to remove some source attributes in target.
  * Filter points : Option to filter point cloud to avoid extreme point density peaks and to obtain an overall homogeneous maximum point density.
  * Density : Option available for OPC only, see [[180:technology:supported_formats:pointcloud:opc|]].

** Image data **  

Options for Image data only. 

BMP : Bitmap Image \\
See [[https://en.wikipedia.org/wiki/BMP_file_format|Wikipedia, BMP file format]].
  * Pixel Size : Number of bits to store one pixel. 8-bit pixel to display 256 colors, 24 to display true colors (16,7 million colors).

GIF :  Graphics Interchange Format \\
See [[http://en.wikipedia.org/wiki/Graphics_Interchange_Format|Wikipedia, GIF]].
  * Interlace : See wikipedia page above > Interlacing.

JPG, JPEG : Joint Photographic Experts Group \\
See [[https://en.wikipedia.org/wiki/JPEG|Wikipedia, JPEG]].
  * Quality : Set JPG compression quality poor (25), average (50), good (75), excellent (90) or custom. \\ It makes no sense to set target quality higher than quality of source. 

OMI : Orbit MultiResolution Image \\
See [[180:technology:supported_formats:image:omi|]]

TIFF : Tagged Image File Format \\
See [[http://en.wikipedia.org/wiki/Tagged_Image_File_Format|Wikipedia, Tagged Image File Format]].
  * Image Type : 
    * Monochrome image : 1 bit/pixel, black or white.
    * Grayscale image : 8 bits/pixel, 256 shades of gray.
    * Truecolor image : 24 bits/pixel, 16M colors.
  * Image Compression : Uncompressed / JPEG
  * File Structure : 
    * Striped : Baseline tiff image file by Strips, slower reading but higher compatibility.
    * Tiled :  Tiff image file by Tiles, faster reading but lower compatibility compatible. 
  * Multiresolution : Option to add multi resolution sub-levels to improve image reading performance. 

=== Convert ===

Start convert or cancel ongoing process. \\
Converted images are not removed when cancelling.