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
sdk:geoconvert [2017/07/22 17:18] aeroflysdk:geoconvert [2017/11/12 17:30] (current) jh
Line 6: Line 6:
  
 ====How Aerofly renders aerial images==== ====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.+Aerofly FS 2 uses images 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 1 meter 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. 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 1 meter 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.
Line 31: Line 31:
  
 ====General steps==== ====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. As a convenience function, GeoConvert will automatically convert TFW and INF files to AIC files, but it's strongly recommended to check the AIC files after conversion. INF files are not standardized and TFW files do not support enough options for all cases. So please get used to the AIC file format, here is a sample <code cpp
-<code> +<[file][][] 
-  <[file][][] +  <[tm_aerial_image_definition][][] 
-      <[tm_aerial_image_definition][][] +    <[string8][image][your_aerial_image.bmp]>          // the image this configuration file refers to 
-          <[string8][image][your_aerial_image.bmp]> +      <[string8][mask][]>                              // optional alpha mask / GeoConvert also 
-          <[string8][mask][]>                                // optional alpha mask / GeoConvert also supports Tiff images with alpha channel +                                                       // supports Tiff images with alpha channel 
-          <[vector2_float64][steps_per_pixel][3.57627868652344e-06 -2.68220901489258e-06]> +      <[string8][coordinate_system][lonlat]>           // the coordinate system of the image, currently 
-          <[vector2_float64][top_left][-81.8330883979797 24.5659098029137]> +                                                       // only lonlat is supported 
-          <[string8][coordinate_system][lonlat]> +      <[vector2_float64][top_left][-81.8330883979797 24.5659098029137]>  // the coordinates of the top 
-          <[bool][flip_vertical][false]>                     // set to true if image is saved bottom to top +                                                       // left corner of this image 
-      >+      <[vector2_float64][steps_per_pixel][3.57627868652344e-06 -2.68220901489258e-06]> // this tells 
 +                                                       // GeoConvert the pixel size in the x and y direction 
 +      <[bool][flip_vertical][false]>                   // set to true if image is saved bottom to top 
 +    >
   >   >
 +>
 </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**. +  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> 
-  * 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: +<[file][][] 
-<code> +  <[tmcolormap_regions][][] 
-  <[file][][] +    <[bool]   [write_ttc_files][true]> 
-      <[tmcolormap_regions][][] +    <[string8][folder_destination_ttc][./scenery/images/]> 
-          <[bool]   [write_ttc_files][true]> +    <[bool]   [always_overwrite][true]> 
-          <[string8][folder_destination_ttc][./scenery/images/]> +    <[list][region_list][] 
-          <[bool]   [always_overwrite][true]> +      <[tmcolormap_region][element][0] 
-          <[list][region_list][] +        <[uint32]              [level]  [9]> 
-              <[tmcolormap_region][element][0] +        <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> 
-                  <[uint32]              [level]  [9]> +        <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> 
-                  <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> +      
-                  <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> +      <[tmcolormap_region][element][0] 
-              +        <[uint32]              [level]  [11]> 
-              <[tmcolormap_region][element][0] +        <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> 
-                  <[uint32]              [level]  [11]> +        <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> 
-                  <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> +      
-                  <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> +      <[tmcolormap_region][element][0] 
-              +        <[uint32]              [level]  [12]> 
-              <[tmcolormap_region][element][0] +        <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> 
-                  <[uint32]              [level]  [12]> +        <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> 
-                  <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> +      
-                  <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> +      <[tmcolormap_region][element][0] 
-              +        <[uint32]              [level]  [13]> 
-              <[tmcolormap_region][element][0] +        <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> 
-                  <[uint32]              [level]  [13]> +        <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> 
-                  <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> +      
-                  <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> +      <[tmcolormap_region][element][0] 
-              +        <[uint32]              [level]  [14]> 
-              <[tmcolormap_region][element][0] +        <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> 
-                  <[uint32]              [level]  [14]> +        <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> 
-                  <[vector2_float64]     [lonlat_min]   [-81.84 24.52]> +      
-                  <[vector2_float64]     [lonlat_max]   [-81.71 24.60]> +    >
-              +
-          > +
-      >  +
   >   >
 +>  
 </code> </code>
-  * For aerial images to appear at larger distances and to keep texture usage low, +  - Once you have the input images along with their AIC files in the folder input_aerial_images and your TMC file you can start up GeoConvert either using the shell or a batch file as mentioned above. 
sdk/geoconvert.txt · Last modified: 2017/11/12 17:30 by jh