User Tools

Site Tools


sdk:geoconvert

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
sdk:geoconvert [2017/07/21 18:23] aeroflysdk:geoconvert [2017/07/22 14:55] aerofly
Line 1: Line 1:
 =====Introduction to the GeoConvert tool===== =====Introduction to the GeoConvert tool=====
  
-The Aerofly FS 2 GeoConvert tool allows you to convert aerial images in WGS84 coordinates and PNG, TIF and BMP image format to Aerofly FS 2 compatible aerial images.+The GeoConvert tool allows you to get your own aerial images into Aerofly FS 2. GeoConvert so far supports aerial images in WGS84 coordinates and PNG, TIF and BMP image format.
  
 **Important note:** This tool is not a simple plug and play solution, it requires some work on your side and you need some basic understanding on how earth coordinates work. It's also your responsibility to obtain aerial images, GeoConvert does not perform this step for you. We have added some tutorials however that show you some ways on obtaining aerial images. **Important note:** This tool is not a simple plug and play solution, it requires some work on your side and you need some basic understanding on how earth coordinates work. It's also your responsibility to obtain aerial images, GeoConvert does not perform this step for you. We have added some tutorials however that show you some ways on obtaining aerial images.
  
-====General procedure====+====How Aerofly renders aerial images==== 
 +Aerofly FS 2 uses textures with a varying coverage to render the earth. For this Aerofly FS 2 uses a level technique with different resolutions per level to render aerial images. At the base there is level 0. Level 0 consists of a single square image that covers the whole earth. This image would be used if viewing earth from very far away. Next is level 1. Level 1 consists of 2x2 images covering the whole earth. Then for level 2 we have 4x4 textures and so on. Aerofly FS 2 currently supports the maximum level of 15 which gives you roughly a resolution of 50cm per pixel. 
 +Its recommended that your aerial images are converted to level 9, 11, 12, 13 and 14 to give a good coverage. Level 14 corresponds to roughly 1m per pixel. Please do not go below level 9 unless you convert a really large area with your images as Aerofly already includes those levels.
  
 +====General steps====
   * All your input aerial images have to be in the folder 'input_aerial_images'. Currently, the image formats TIF, PNG and BMP are supported.   * All your input aerial images have to be in the folder 'input_aerial_images'. Currently, the image formats TIF, PNG and BMP are supported.
   * Each aerial image must have an accompanying configuration file with the extension AIC that tells GeoConvert how to source this image. Here is a sample   * Each aerial image must have an accompanying configuration file with the extension AIC that tells GeoConvert how to source this image. Here is a sample
- 
 <code> <code>
   <[file][][]   <[file][][]
Line 22: Line 24:
   >   >
 </code> </code>
- +  * GeoConvert will automatically convert TFW and INF files to AIC files, but it's strongly recommended to check the AIC files after conversion. **This is just for convenience, we strongly encourage to get used to the AIC file format**.
-  * GeoConvert will automatically convert TFW and INF files to AIC files, but it's strongly recommended to check the AIC files after conversion.+
   * aerofly_fs_2_geoconvert.exe is a command line tool that expects another configuration file that tells where to generate aerial images and in what resolution. Here is a sample that generates aerial images for the Key West Florida region:   * aerofly_fs_2_geoconvert.exe is a command line tool that expects another configuration file that tells where to generate aerial images and in what resolution. Here is a sample that generates aerial images for the Key West Florida region:
-</code>+<code>
   <[file][][]   <[file][][]
       <[tmcolormap_regions][][]       <[tmcolormap_regions][][]
Line 31: Line 32:
           <[string8][folder_destination_ttc][./scenery/images/]>           <[string8][folder_destination_ttc][./scenery/images/]>
           <[bool]   [always_overwrite][true]>           <[bool]   [always_overwrite][true]>
- 
           <[list][region_list][]           <[list][region_list][]
- 
               <[tmcolormap_region][element][0]               <[tmcolormap_region][element][0]
                   <[uint32]              [level]  [9]>                   <[uint32]              [level]  [9]>
Line 39: Line 38:
                   <[vector2_float64]     [lonlat_max]   [-81.71 24.60]>                   <[vector2_float64]     [lonlat_max]   [-81.71 24.60]>
               >               >
- 
               <[tmcolormap_region][element][0]               <[tmcolormap_region][element][0]
                   <[uint32]              [level]  [11]>                   <[uint32]              [level]  [11]>
Line 45: Line 43:
                   <[vector2_float64]     [lonlat_max]   [-81.71 24.60]>                   <[vector2_float64]     [lonlat_max]   [-81.71 24.60]>
               >               >
- 
               <[tmcolormap_region][element][0]               <[tmcolormap_region][element][0]
                   <[uint32]              [level]  [12]>                   <[uint32]              [level]  [12]>
Line 51: Line 48:
                   <[vector2_float64]     [lonlat_max]   [-81.71 24.60]>                   <[vector2_float64]     [lonlat_max]   [-81.71 24.60]>
               >               >
- 
               <[tmcolormap_region][element][0]               <[tmcolormap_region][element][0]
                   <[uint32]              [level]  [13]>                   <[uint32]              [level]  [13]>
Line 57: Line 53:
                   <[vector2_float64]     [lonlat_max]   [-81.71 24.60]>                   <[vector2_float64]     [lonlat_max]   [-81.71 24.60]>
               >               >
- 
               <[tmcolormap_region][element][0]               <[tmcolormap_region][element][0]
                   <[uint32]              [level]  [14]>                   <[uint32]              [level]  [14]>
Line 67: Line 62:
   >   >
 </code> </code>
- +  * For aerial images to appear at larger distances and to keep texture usage low, 
-  For aerial images to appear at larger distances and to keep texture usage low, +
-  Aerofly FS 2 uses textures with a varying coverage. At the base the whole earth +
-  is covered by a single texture, we call that level 0. As a next step the whole +
-  earth is covered by 2x2 level 1 textures, then 4x4 level 2 textures and so on. +
-  Its recommended that your aerial images are converted to level 9, 11, 12, 13 and +
-  14 to give a good coverage. Level 14 is roughly 1m per pixel.+
sdk/geoconvert.txt · Last modified: 2017/11/12 17:30 by jh