TerraGear: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
m (Small update, TerraGear.org is down for a while.)
(major revise)
Line 1: Line 1:
'''TerraGear''' is a collection of open-source tools and rendering libraries which can transform publically available GIS data in 3D representations (i.e. 3D models or 3D maps) of the earth for use in real time rendering projects. Terragear can import 3D data sets such as DEM terrain grids, 2D polygon data sets such as coastlines, city outlines, lake outlines, and 2D raster data sets such as the 1km NAOO land use/land cover data. It also has tools for generating realistic airports, runways, and lighting based on available FAA data.  
'''TerraGear''' is a collection of open-source tools and rendering libraries which can transform publically available GIS data in 3D representations (i.e. 3D models or 3D maps) of the earth for use in real time rendering projects. Terragear can import 3D data sets such as DEM terrain grids, 2D polygon data sets such as coastlines, city outlines, lake outlines, and 2D raster data sets such as the 1 km NAOO land use/land cover data. It also has tools for generating realistic airports, runways, and lighting based on available FAA data.  


TerraGear is the primary tool used to generate the [http://www.flightgear.org/Downloads/scenery.html world wide scenery] for the [[FlightGear]] project.  
TerraGear is the primary tool used to generate the [[Scenery]] for the [[FlightGear]] project.
 
 
== Introduction ==
For a variety of reasons you might want to build terrain yourself, rather than downloading it from the available Scenery on FlightGear. For instance, if you use [[TaxiDraw]] to create or modify an airport layout, you might wish to see how that modified airport would look in the Scenery before deciding you're happy with the results. And normally, to see and use the airport in the Scenery, it's necessary to submit the modifications to the FlighGear Scenery staff and then wait untill the next update of the Scenery of that area is available via [[TerraSync]] or in the [http://www.flightgear.org/Downloads/scenery.html official FlightGear Scenery] build. If you can build terrain yourself, you can start using it right away. <BR>
Maybe the official Scenery is too detailed for your slow machine, and you'd like to build terrain using a digital elevation model (DEM) with poorer resolution, to decrease the number of polygons and thus improve your framerates. Or maybe you've got a fantastically fast machine, and you want to build your own terrain using higher resultion vector data (vmap1, Tiger) to get better roads/rivers. For all these reasons learning how to use TerraGear is a good idea.  


== GUI Tool ==
A [[TerraGear GUI]] is available for those that would like to use TerraGear without knowing/using the command line options.


== Download ==
== Getting TerraGear ==
===Pre-compiled builds===
=== Pre-compiled builds ===
* [ftp://ftp.ihg.uni-duisburg.de/FlightGear/Win32 Windows builds]
* [ftp://ftp.ihg.uni-duisburg.de/FlightGear/Win32 Windows builds]


=== Sources ===
=== Source ===
* Repository containing the [http://mapserver.flightgear.org/git/gitweb.pl?p=terragear-cs latest source code].
The source is hold in a [[git]] repository on the [http://mapserver.flightgear.org/git/ mapserver].
** Prerequisite: [http://plib.sourceforge.net/ plib] - portability libraries and scene graph. You need plib-1.8.5 to build TerraGear. (see also [[PLIB]])
git clone git://mapserver.flightgear.org/terragear-cs
** Prerequisite: [http://www.simgear.org/ SimGear] - simulation construction tools. You need [http://mapserver.flightgear.org/git/gitweb.pl?p=simgear-cs SimGear-CS] to build TerraGear. (see also [[SimGear]])
 
 
== Compilation ==
=== Dependencies ===
* TerraGear
** [[SimGear]] - '''Not''' simgear-cs!
** [[OpenSceneGraph]]
** [[plib]]
** libnewmat - at least version newmat11 (which is beta at the time of writing) <BR>See [http://mapserver.flightgear.org/git/?p=terragear-cs;a=blob;f=README.newmat;h=95570b6b279d3d00bd7664cd4f00d6c4802aed1b;hb=HEAD README.newmat] for info on how to obtain and install it.
** gpc - See [http://mapserver.flightgear.org/git/?p=terragear-cs;a=blob;f=README.gpc;h=226e185b1ce1d1578006b48bb426e35848cce93b;hb=HEAD README.gpc] for info on how to obtain and install it.
** libgdal
** libproj
** libogdi
** Feel free to add more required libs here!
 
=== Building ===
Please, have a look at [http://mapserver.flightgear.org/git/?p=terragear-cs;a=blob;f=README;h=7dae654283ca0b1447aeb3aa398287219f4b57df;hb=HEAD README] and/or [http://mapserver.flightgear.org/git/?p=terragear-cs;a=blob;f=README.cygwin;h=d0436ec0371dd9fa255a8a560a388818432600d6;hb=HEAD README.cygwin] of the terragear-cs sources.
./autogen.sh
./configure [options]  
sed s/-O2// -i src/Lib/TriangleJRS/Makefile
make install
<tt>./configure</tt> options:
--prefix=/path/to/install-dir
I am missing reliable data here. Please, revise/complete the list if you have more info!
--with-gdal=/path/to/gdal-config
--with-gpc=/path/to/libgenpolyclip.a
--with-newmat=/path/to/libnewmat.a
--with-plib=/path/to/libplib*.a
--with-simgear=/path/to/libsg*.a
 
=== Plattform specific ===
* Debian: [[Building FlightGear - Debian#TerraGear]]
* Ubuntu: [[Building terragear-cs in Ubuntu_64]]
 
 
== GUI Tool ==
A [[TerraGear GUI]] is available for those that would like to use TerraGear without knowing/using the command line options.


=== Development ===
* Tarball of the latest [http://mapserver.flightgear.org/git/gitweb.pl?p=terragear-cs;a=snapshot;sf=tgz Bleeding edge GIT snapshot].


== Related content ==
== Related content ==
* [[Using Terragear]]
* [[Using Terragear]]
* [[Building Terragear]] from source
* [[Terragear Corine]]
* [[Terragear Corine]]


{{Terra}}
{{Terra}}
[[Category:Scenery enhancement]]
[[Category:Scenery enhancement]]

Revision as of 21:32, 3 June 2011

TerraGear is a collection of open-source tools and rendering libraries which can transform publically available GIS data in 3D representations (i.e. 3D models or 3D maps) of the earth for use in real time rendering projects. Terragear can import 3D data sets such as DEM terrain grids, 2D polygon data sets such as coastlines, city outlines, lake outlines, and 2D raster data sets such as the 1 km NAOO land use/land cover data. It also has tools for generating realistic airports, runways, and lighting based on available FAA data.

TerraGear is the primary tool used to generate the Scenery for the FlightGear project.


Introduction

For a variety of reasons you might want to build terrain yourself, rather than downloading it from the available Scenery on FlightGear. For instance, if you use TaxiDraw to create or modify an airport layout, you might wish to see how that modified airport would look in the Scenery before deciding you're happy with the results. And normally, to see and use the airport in the Scenery, it's necessary to submit the modifications to the FlighGear Scenery staff and then wait untill the next update of the Scenery of that area is available via TerraSync or in the official FlightGear Scenery build. If you can build terrain yourself, you can start using it right away.
Maybe the official Scenery is too detailed for your slow machine, and you'd like to build terrain using a digital elevation model (DEM) with poorer resolution, to decrease the number of polygons and thus improve your framerates. Or maybe you've got a fantastically fast machine, and you want to build your own terrain using higher resultion vector data (vmap1, Tiger) to get better roads/rivers. For all these reasons learning how to use TerraGear is a good idea.


Getting TerraGear

Pre-compiled builds

Source

The source is hold in a git repository on the mapserver.

git clone git://mapserver.flightgear.org/terragear-cs


Compilation

Dependencies

  • TerraGear
    • SimGear - Not simgear-cs!
    • OpenSceneGraph
    • plib
    • libnewmat - at least version newmat11 (which is beta at the time of writing)
      See README.newmat for info on how to obtain and install it.
    • gpc - See README.gpc for info on how to obtain and install it.
    • libgdal
    • libproj
    • libogdi
    • Feel free to add more required libs here!

Building

Please, have a look at README and/or README.cygwin of the terragear-cs sources.

./autogen.sh
./configure [options] 
sed s/-O2// -i src/Lib/TriangleJRS/Makefile
make install

./configure options:

--prefix=/path/to/install-dir
I am missing reliable data here. Please, revise/complete the list if you have more info!
--with-gdal=/path/to/gdal-config
--with-gpc=/path/to/libgenpolyclip.a
--with-newmat=/path/to/libnewmat.a
--with-plib=/path/to/libplib*.a
--with-simgear=/path/to/libsg*.a

Plattform specific


GUI Tool

A TerraGear GUI is available for those that would like to use TerraGear without knowing/using the command line options.


Related content