https://wiki.flightgear.org/w/api.php?action=feedcontributions&feedformat=atom&user=PuchaczFlightGear wiki - User contributions [en]2026-04-10T18:01:44ZUser contributionsMediaWiki 1.39.6https://wiki.flightgear.org/w/index.php?title=Fr/Altitude&diff=127159Fr/Altitude2020-08-30T12:24:42Z<p>Puchacz: </p>
<hr />
<div>En aviation, l'altitude est la hauteur à laquelle vole un avion. Exprimée en pieds, l'altitude d'un avion est mesurée avec un [[altimeter|altimètre]]. La base de l'altimètre est la même que celle d'un baromètre anéroïde: un tambour hermétique qui changera de forme en fonction de la pression de l'air ambiant. Plus l'avion est haut, plus le tambour est grand. L'altimètre est un instrument très sensible, et en tant que tel, la pression de l'air qui agit sur lui influence grandement la lecture de l'altimètre.<br />
<br />
En revanche, le radar au sol est idéal pour mesurer l'altitude au-dessus du sol sans être influencé par la météo. Le radar au sol est souvent utilisé pour les systèmes d'alerte au sol.<br />
<br />
En communication avec [[ATC]], deux termes d'altitude sont utilisés. Dans l'espace aérien inférieur, le terme [[#Altitude vraie|altitude vraie]], ou simplement '' "altitude" '', est utilisé. Dans l'espace aérien supérieur, le terme [[#Niveau de vol|niveau de vol]] (souvent abrégé en FL) est préféré.<br />
<br />
==Altitude indiquée==<br />
* Lecture de l'[[altimeter|altimètre]].<br />
<br />
L'altimètre peut être calé sur '''trois''' références possibles :<br />
# au [[#QNH|QNH]], ce qui entraîne que l'altitude indiquée "correspond" à l'altitude vraie (voir ci-dessous) ;<br />
# à la pression standard (29,92" Hg ou 1013,25 hPa) faisant indiquer à l'altimètre l'[[#Altitude pression|altitude pression]]. Cette configuration ne doit être utilisée que pour les altitudes élevées.<br />
#à la hauteur au-dessus de l'aérodrome. Sur la piste, l'altitude indiquée lirait zéro. A proximité de l'aérodrome, l'altitude indiquée devrait être l'[[#Altitude absolue|altitude absolue]] ([[Fr/AGL|au-dessus du niveau du sol]]).<br />
<br />
Ce que vous devez utiliser dépend des [[flight rules|règles de vol]] locales.<br />
<br />
===QNH===<br />
Le [http://fr.wikipedia.org/wiki/QNH QNH] est un code court pour "la pression atmosphérique au niveau de la mer". Il est nécessaire lors du décollage ou de l'atterrissage d'un avion, quand il est important d'avoir l'[[#Altitude indiquée|altitude indiquée]] aussi précise que possible.<br />
<br />
Le code QNH est utilisé:<br />
*quand les pilotes demandent la "pression atmosphérique au niveau de la mer". Dans sa réponse, l'[[ATC]] répète QNH suivi de la pression.<br />
*dans les rapports météorologiques automatiques via l'[[ATIS]].<br />
<br />
S'il n'y a ni [[ATIS]], ni [[ATC]] disponible, vous pouvez trouver la valeur QNH dans Environment=>Global Weather.<br />
<br />
Si QNH n'est pas disponible, mais l'[[#Elévation|élévation]] de l'aérodrome de départ est connu, régler l'[[altimeter|altimètre]] à cette valeur. Le QNH qui en résulte est le bon. Il est également possible d'utiliser le QNH d'un aérodrome situé à proximité.<br />
<br />
Pour utiliser un baromètre (c'est à dire votre [[altimeter|altimètre]]) comme un outil pour mesurer l'altitude, il doit être corrigé en fonction des conditions météorologiques. Pour cette tâche, chaque aérodrome est équipé d'un baromètre précis. En combinant cette valeur avec l'[[#Altitude vraie|altitude vraie]] de l'aérodrome, ils peuvent calculer la pression barométrique au [[Fr/MSL|niveau moyen de la mer]], le QNH. Le QNH sera transmis par l'[[ATC]] et l'[[ATIS]] et, avec cet élément d'information, l'altimètre de l'avion peut être corrigé en fonction des conditions météorologiques et afficher une altitude proche de l'[[#Altitude vraie|altitude vraie]] de l'avion. De cette façon, l'[[#Altitude indiquée|altitude indiquée]] sera assez précise pour une certaine zone autour de l'aérodrome aussi longtemps que le temps reste stable. Lorsque l'avion est sur le terrain d'aviation, l'altimètre devrait indiquer l'altitude de l'aérodrome.<br />
<br />
Il est essentiel de caler l'altimètre au QNH lorsque vous utilisez une carte de hauteur, de tel sorte que l'[[#Altitude indiquée|altitude indiquée]] peut être comparée aux [[#Elévation|élévations]] sur la carte, ce qui particulièrement important lors de l'approche d'un aérodrome. Il y a eu des accidents dramatiques où les pilotes volaient en utilisant l'[[#Altitude pression|altitude pression]] pendant la descente au lieu de l'[[#Altitude vraie|altitude vraie]], ce qui rend la carte de hauteur de la région à peu près inutile. Avec une mauvaise visibilité, les montagnes n'ont pas été vues et le sol était plus élevé que prévu.<br />
<br />
==Altitude pression==<br />
<br />
*L'altitude pression est la pression barométrique exprimée en pieds (ce qui signifie que votre équipement coûteux a été réduit à un baromètre).<br />
*L'altimètre indique l'altitude pression, s'il est calé sur la pression standard: 29.92" Hg = 1013,25 hPa.<br />
<br />
Ceci a le grand avantage que tous les avions utilisent le même calage altimétrique, ainsi différents avions dans une même région ayant la même [[#Altitude indiquée|altitude indiquée]] auront la même [[#Altitude vraie|altitude vraie]].<br />
<br />
Le problème avec l'altitude pression est que les conditions météorologiques changeantes font varier la pression de l'air. Donc, vous ne savez jamais exactement à quelle [[#Altitude vraie|altitude vraie]] vous volez. Cela rend l'altitude pression très dangereux à utiliser à basse altitude!<br />
<br />
Comme tous les avions dans la même région éprouvent le même effet, ils voleront tous à la même altitude les uns par rapport aux autres.<br />
<br />
===Niveau de vol===<br />
<br />
*L'[[#Altitude pression|altitude pression]] divisée par 100 est appelée le niveau de vol.<br />
<br />
L'altitude pression est utilisée au dessus de l'altitude de transition (18.000 pieds (5.500 m) aux États-Unis, mais peut être aussi basse que 3000 pieds (910 m) dans d'autres pays s'ils n'ont pas de montagnes plus hautes). Lorsque l'[[altimeter|altimètre]] calé sur la pression standard indique 18.000 pieds, l'avion est dit être au "niveau de vol 180" ou FL180.<br />
<br />
Pour assurer une séparation verticale, les pilotes [[IFR]] sont tenus d'utiliser l'altimètre. Il n'est pas permis d'utiliser l'altitude mesurée par les systèmes GPS.<br />
<br />
==Altitude densité==<br />
<br />
*L'altitude en fonction de la densité de l'air.<br />
<br />
C'est la seule altitude qui n'est pas utilisée pour déterminer la position de l'avion. Cependant, elle est un facteur important afin de connaître la puissance que votre avion/hélicoptère est capable de développer dans la situation actuelle.<br />
<br />
Des températures élevées génèrent un air moins dense. La faible densité de l'air provoque moins de traînée (frottement), moins de portance, de plus faible performances du moteur (les pales du rotor ont moins d'effet et le moteur reçoit moins d'oxygène). Mais moins de friction vous permet également de voler plus vite et de manière plus efficace, car moins d'énergie est perdue dans le frottement.<br />
<br />
De basses températures génèrent un air plus dense. Donc, vous avez plus de traînée, plus de portance et de meilleures performances du moteur (les pales du rotor ont plus d'effet et le moteur reçoit plus d'oxygène) pour le prix d'être plus lent et consomme plus de carburant car plus d'énergie est nécessaire pour vaincre le frottement.<br />
<br />
Dans FlightGear, la densité de l'air est simulée en empêchant un hélicoptère de décoller du sol par une chaude journée ou en rendant impossible le départ près de la ville de Mexico d'un Antanov lourdement chargé. L'altitude densité est calculée à partir de la pression barométrique et la température. Plus la température est élevée, plus la densité est faible, plus l'altitude densité est élevée (en référence à l'[[#Altitude vraie|altitude vraie]]). ([http://en.wikipedia.org/wiki/Density_altitude wikipedia])<br />
<br />
==Définitions générales==<br />
===Hauteur===<br />
La hauteur de quelque chose est la distance verticale jusqu'à un certain point.<br />
<br />
===Altitude vraie===<br />
L'altitude vraie est la [[#Hauteur|hauteur]] au-dessus du niveau moyen de la mer ([[Fr/AMSL|AMSL]]).<br />
<br />
Après avoir calé l'[[altimeter|altimètre]] au [[QNH]], l'[[#Altitude indiquée|altitude indiquée]] est proche de l'altitude vraie.<br />
<br />
===Altitude absolue===<br />
L'altitude absolue est la [[#Hauteur|hauteur]] par rapport au sol directement en dessous ([[Fr/AGL|AGL]]: au-dessus du niveau du sol).<br />
<br />
Un radar au sol et des systèmes avertisseurs de proximité du sol affichent l'altitude absolue. Si l'[[altimeter|altimètre]] est réglé sur zéro, tout en étant sur le terrain d'aviation, l'[[#Altitude indiquée|altitude indiquée]] sera l'altitude absolue aussi longtemps que l'[[#Elévation|élévation]] du terrain en dessous ne change pas.<br />
<br />
Dans FlightGear il y a un «système» d'altitude, cette altitude est [[Fr/AMSL|AMSL]]. Certains se réfèrent à cette altitude comme l'[[#Altitude absolue|altitude absolue]], ce qui est théoriquement incorrect.<br />
<br />
===Elévation===<br />
L'[[#Altitude vraie|altitude vraie]] d'une position au sol est désignée comme l'élévation. En aviation, ces positions sont généralement des pistes ou des pics montagneux.<br />
<br />
Il est essentiel de connaître l'élévation de la piste avant de descendre vers elle. Les meilleures sources de données d'élévation sont les suivantes:<br />
*[[Fr/Atlas|Atlas]] fournit une carte de hauteur précise. Il faut interpréter les couleurs de la carte pour connaître l'élévation. Pour les vols IFR et de planification des vols, Atlas n'est pas adapté.<br />
*[[Fr/MPMap|MPMap]] est un outil en ligne pour FlightGear qui fournit des informations précises sur les pistes y compris l'élévation.<br />
*[[Airport Diagram Generator]] va créer un fichier PDF, une carte précise de l'aérodrome. Il comprend l'élévation.<br />
*Les sites Web qui sont utilisés pour la planification de vols réels. Quelques problèmes, la piste réel n'est pas toujours à 100% la même que la piste de FlightGear, toutes les pistes de FlightGear ne se trouvent pas sur ces sites (La base de données de FlightGear est plus complète).<br />
<br />
Il est très regrettable que [[Kelpie]] ne fournisse pas cette information.<br />
<br />
==Informations complémentaires==<br />
*QFE: Pression atmosphérique de l'aéroport, peut être utilisé pour indiquer des [[#Altitude absolue|altitudes absolues]].<br />
*QNE: Elévation de l'aérodrome au-dessus de [[Fr/AMSL|AMSL]].<br />
*QFF: Pression atmosphérique calculée par rapport à [[Fr/AMSL|AMSL]] dans des conditions standard, ce code n'est pas utilisé.<br />
*ISA-1: International Standard Atmosphere: modèle atmosphérique des différentes couches de l'atmosphère terrestre. Chaque couche a une température, une pression, de la viscosité et de la densité. Elle est basée sur un modèle moyen de l'atmosphère terrestre. Publication ISO 2533:1975. Il s'agit d'un modèle US qui est synchronisé avec cette norme, mais est plus élevée.<br />
*ISA-2: ICAO Standard Atmosphere: Identique à ISA-1, mais plus élevé et avec des valeurs légèrement différentes. En aviation, c'est la norme à utiliser. Publication Doc 7488-CD.<br />
*Attitude: Le plus souvent, le "Pitch" d'un avion, l'angle que fait le nez en référence au sol, mais il y a d'autres définitions.<br />
*Ascend = montée = aller plus haut.<br />
*Descente: aller plus bas.<br />
<br />
==Liens externes==<br />
*http://fr.wikipedia.org/wiki/Altitude<br />
*http://fr.wikipedia.org/wiki/QNE<br />
*http://fr.wikipedia.org/wiki/Niveau_de_vol<br />
*http://fr.wikipedia.org/wiki/QNH<br />
*http://www.altitude.nu/ (en)<br />
<br />
{{Understanding}}<br />
[[Category:Aviation]]<br />
[[ca:Altitud]]<br />
[[de:Flughöhe]]<br />
[[en:Altitude]]<br />
[[es:Altitud]]<br />
[[fr:Altitude]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Fr/MSL&diff=127158Fr/MSL2020-08-30T11:45:06Z<p>Puchacz: </p>
<hr />
<div>{{Stub}}<br />
<br />
Le [http://fr.wikipedia.org/wiki/Niveau_de_la_mer niveau moyen de la mer (MSL)] est une mesure de la hauteur moyenne de la surface de l'océan (comme le point à mi-chemin entre la marée haute moyenne et la marée basse moyenne). Il joue un rôle extrêmement important dans l'aviation, où la pression standard au niveau de la mer est utilisée comme la mesure de référence pour l'[[Fr/Altitude|altitude]] des [[Fr/Altitude#Niveau_de_vol|niveaux de vol]].<br />
<br />
==Hauteur au-dessus du niveau moyen de la mer (AMSL)==<br />
{{Distinguish|Fr/AGL}}<br />
Hauteur '''au-dessus du niveau moyen de la mer (AMSL)''' fait référence à l'élévation d'un objet par rapport au niveau moyen de la mer.<br />
<br />
[[Category:Aviation]]<br />
[[en:Mean Sea Level]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Mean_Sea_Level&diff=127157Mean Sea Level2020-08-30T11:44:31Z<p>Puchacz: </p>
<hr />
<div>{{Stub}}<br />
<br />
[http://en.wikipedia.org/wiki/Sea_level Mean sea level ('''MSL''')] is a measure of the average height of the ocean's surface (such as the halfway point between the mean high and low tide). It plays an extremely important role in aviation, where standard sea level pressure is used as the measurement reference of [[altitude]] at [[Altitude#Flight_level | flight levels]].<br />
<br />
== Height above mean sea level ==<br />
{{Distinguish|AGL}}<br />
Height '''above mean sea level (AMSL)''' refers to the elevation of an object relative to the mean sea level.<br />
<br />
[[Category:Aviation]]<br />
[[fr:MSL]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Aircraft_tester_list&diff=126157Aircraft tester list2020-07-09T15:30:24Z<p>Puchacz: </p>
<hr />
<div>This is a list of '''aircraft testers''' using using the procedures laid out in [[Aircraft testing checklist]] to validate that aircraft below are compatible with a FlightGear version.<br />
<br />
{| class="wikitable sortable"<br />
|-<br />
! Aircraft !! Tester(s) !! Remarks<br />
|-<br />
| 737NGs || James Turner || <br />
|-<br />
| 757 || James Turner|| <br />
|-<br />
| A300 || Jonathan Redpath|| <br />
|-<br />
| A320-200 || Jonathan Redpath|| [NB - upstream github repo for issues]<br />
|-<br />
| A340-600 || Jonathan Redpath|| <br />
|-<br />
| A380 || Jonathan Redpath|| <br />
|-<br />
| Aerostar-700 || James Turner || <br />
|-<br />
| B1900D || James Turner || <br />
|-<br />
| CH-53E || Richard H. || <br />
|-<br />
| CRJ700 family || Henning, Daniel || <br />
|-<br />
| Cap 10C || Scott || <br />
|-<br />
| Cessna 208B Caravan || James Turner || <br />
|-<br />
| DR400 || Scott || <br />
|-<br />
| DaSH || Wayne Bragg|| <br />
|-<br />
| F-14 || Richard H. || Willing to reassign upon request to those with experience of this aircraft<br />
|-<br />
| F-15 || Richard H. || Willing to reassign upon request to those with experience of this aircraft<br />
|-<br />
| F6F - Hellcat || Keith || <br />
|-<br />
| F-86 || Jonathan Redpath || <br />
|-<br />
| Fokker 100 || Jonathan Redpath || <br />
|-<br />
| Grob || Scott || <br />
|-<br />
| Jaguar || Richard || <br />
|-<br />
| Junkers JU-52 || James Turner || <br />
|-<br />
| hunter || Stuart || <br />
|-<br />
| J3Cub || Wayne Bragg|| <br />
|-<br />
| Lionceau || Scott || <br />
|-<br />
| p51d || Stuart || <br />
|-<br />
| SUMPAC || Wayne Bragg|| <br />
|-<br />
| Skyvan || Keith || <br />
|-<br />
| Socata || Scott || <br />
|-<br />
| seahawk || Stuart || <br />
|-<br />
| wrightFlyer || Stuart || <br />
|-<br />
| tu154b || Gaétan Allaert || <br />
|-<br />
|}<br />
<br />
[[Category:Aircraft enhancement]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=126154Building FlightGear - Linux2020-07-09T09:17:48Z<p>Puchacz: /* Simgear */</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have FlightGear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Ubuntu users can follow these instructions to build FlightGear on [[Building Flightgear - Ubuntu | Ubuntu 20.04]].<br />
* Raspbian users can follow these instructions to build FlightGear on [[Building Flightgear - Raspbian | Raspbian Buster]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the FlightGear installation. For example: <code>FGFS_PREFIX=${HOME}/FlightGear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo</code> can be replaced by <code>cmake -DCMAKE_BUILD_TYPE=Release</code> for better performances.<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== SimGear ==<br />
The source code of SimGear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of SimGear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the SimGear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the SimGear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of SimGear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== FlightGear ==<br />
The data for FlightGear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the FlightGear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the FlightGear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of FlightGear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of SimGear and FlightGear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of FlightGear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the FlightGear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the FlightGear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of FlightGear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE \<br />
-DENABLE_FGQCANVAS=ON<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/FlightGear make --jobs=${NR_JOBS} -- test_suite<br />
FG_ROOT=${FGFS_PREFIX_LIB}/FlightGear make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=126153Building FlightGear - Linux2020-07-09T09:14:29Z<p>Puchacz: /* Flightgear */</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have FlightGear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Ubuntu users can follow these instructions to build FlightGear on [[Building Flightgear - Ubuntu | Ubuntu 20.04]].<br />
* Raspbian users can follow these instructions to build FlightGear on [[Building Flightgear - Raspbian | Raspbian Buster]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the FlightGear installation. For example: <code>FGFS_PREFIX=${HOME}/FlightGear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo</code> can be replaced by <code>cmake -DCMAKE_BUILD_TYPE=Release</code> for better performances.<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== FlightGear ==<br />
The data for FlightGear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the FlightGear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the FlightGear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of FlightGear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of SimGear and FlightGear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of FlightGear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the FlightGear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the FlightGear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of FlightGear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE \<br />
-DENABLE_FGQCANVAS=ON<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/FlightGear make --jobs=${NR_JOBS} -- test_suite<br />
FG_ROOT=${FGFS_PREFIX_LIB}/FlightGear make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=126152Building FlightGear - Linux2020-07-09T09:08:30Z<p>Puchacz: /* Definitions */</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have FlightGear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Ubuntu users can follow these instructions to build FlightGear on [[Building Flightgear - Ubuntu | Ubuntu 20.04]].<br />
* Raspbian users can follow these instructions to build FlightGear on [[Building Flightgear - Raspbian | Raspbian Buster]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the FlightGear installation. For example: <code>FGFS_PREFIX=${HOME}/FlightGear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo</code> can be replaced by <code>cmake -DCMAKE_BUILD_TYPE=Release</code> for better performances.<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== Flightgear ==<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE \<br />
-DENABLE_FGQCANVAS=ON<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make --jobs=${NR_JOBS} -- test_suite<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=126151Building FlightGear - Linux2020-07-09T09:07:14Z<p>Puchacz: /* Debian/Ubuntu */</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have FlightGear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Ubuntu users can follow these instructions to build FlightGear on [[Building Flightgear - Ubuntu | Ubuntu 20.04]].<br />
* Raspbian users can follow these instructions to build FlightGear on [[Building Flightgear - Raspbian | Raspbian Buster]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo</code> can be replaced by <code>cmake -DCMAKE_BUILD_TYPE=Release</code> for better performances.<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== Flightgear ==<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE \<br />
-DENABLE_FGQCANVAS=ON<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make --jobs=${NR_JOBS} -- test_suite<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=126150Building FlightGear - Linux2020-07-09T09:02:48Z<p>Puchacz: /* Compiling */</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have Flightgear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Ubuntu users can follow these instructions to build FlightGear on [[Building Flightgear - Ubuntu | Ubuntu 20.04]].<br />
* Raspbian users can follow these instructions to build FlightGear on [[Building Flightgear - Raspbian | Raspbian Buster]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo</code> can be replaced by <code>cmake -DCMAKE_BUILD_TYPE=Release</code> for better performances.<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== Flightgear ==<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE \<br />
-DENABLE_FGQCANVAS=ON<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make --jobs=${NR_JOBS} -- test_suite<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=126106Building Flightgear - CentOS2020-07-07T16:24:07Z<p>Puchacz: </p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64 qt5-qtdeclarative-devel.x86_64 qt5-qtsvg-devel.x86_64 qt5-linguist.x86_64 qt5-qttools-devel.x86_64 qt5-qtwebsockets-devel.x86_64 \<br />
qt5-qtbase-private-devel.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib64</code>,...<br />
* <code>FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64</code> in the specific case of CentOS.<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.5</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DLIB_POSTFIX=64 \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
<br />
= Start Flightgear =<br />
<br />
cd -- "${FGFS_PREFIX}"<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX}/lib64/<br />
./bin/fgfs<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_Raspbian&diff=124419Building Flightgear - Raspbian2020-04-30T18:22:05Z<p>Puchacz: </p>
<hr />
<div>= Preparation =<br />
An installation of '''Raspbian Buster Lite''' is needed<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal <code>pi</code> user (not <code>root</code>). The <code>pi</code> user needs <code>sudo</code> access to install packages.<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>apt</code> command:<br />
sudo apt install libplib-dev cmake g++ libboost-all-dev libopenal-dev libglew-dev \<br />
libcurl4-openssl-dev libfreetype6-dev \<br />
libqt5svg5-dev qttools5-dev qtdeclarative5-private-dev qtbase5-private-dev libqt5websockets5-dev qml-module-qtquick2<br />
<br />
= Setup <code>pbuilder</code> =<br />
First, <code>pbuilder</code> has to be installed:<br />
sudo apt install pbuilder quilt<br />
<br />
Create a base chroot image tar-ball if it has not been created before:<br />
sudo pbuilder create \<br />
--distribution "buster" \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz" \<br />
--debootstrapopts --keyring=/usr/share/keyrings/raspbian-archive-keyring.gpg<br />
<br />
If the base chroot image tar-ball has been created before, update it:<br />
sudo pbuilder \<br />
--update \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz"<br />
<br />
= libcollada-dom2.4 =<br />
libcollada-dom2.4-dp0 has been build for Raspbian 9 not 10. The package has still dependencies to libboost-filesystem1.58.0 and libboost-system1.58.0 [https://github.com/RPi-Distro/repo/issues/162].<br />
<br />
The package needs to be rebuild using for example <code>pbuilder</code>:<br />
<br />
apt source libcollada-dom2.4-dp0<br />
pushd -- collada-dom-2.4.4+ds1<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- collada-dom-2.4.4+ds1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz collada-dom_2.4.4+ds1-2.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install /var/cache/pbuilder/result/libcollada-dom2.4-dp0_2.4.4+ds1-2_armhf.deb \<br />
/var/cache/pbuilder/result/libcollada-dom2.4-dp-dev_2.4.4+ds1-2_armhf.deb<br />
<br />
= OpenSceneGraph =<br />
The osgPlugins-3.4.1/osgdb_png.so is not compiled on ARM due to the flag OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF. The package needs to be rebuild using for example <code>pbuilder</code> after changing OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=947790]:<br />
apt source openscenegraph-3.4<br />
pushd -- openscenegraph-3.4-3.4.1+dfsg1<br />
<br />
Now modify the <code>debian/rules</code> file:<br />
nano debian/rules<br />
<br />
and change <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF</code> by <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON</code>. To prevent to run out of memory during the build (4 cores for only 1 Gb of memory in the case of the Raspberry Pi 2/3/3+), <code>--parallel</code> can be replaced by <code>--parallel 1</code> or <code>--parallel 2</code>.<br />
<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- openscenegraph-3.4-3.4.1+dfsg1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz openscenegraph-3.4_3.4.1+dfsg1-5.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install /var/cache/pbuilder/result/libopenscenegraph-3.4-131_3.4.1+dfsg1-5_armhf.deb \<br />
/var/cache/pbuilder/result/openscenegraph-3.4_3.4.1+dfsg1-5_armhf.deb \<br />
/var/cache/pbuilder/result/openscenegraph-3.4-examples_3.4.1+dfsg1-5_all.deb \<br />
/var/cache/pbuilder/result/libopenscenegraph-3.4-dev_3.4.1+dfsg1-5_armhf.deb<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
The Raspberry Pi 1/2/3/3+ only supports OpenGL ES 2.0. Simgear still contains some OpenGL 1 instructions (fixed pipeline, not shaders). On Raspbian, the Mesa package uses the accelerated KMS back-end that only supports, as expected, OpenGL ES 2.0. The graphical part of Simgear fails to compile on Raspbian when an OpenGL 1 instruction is used. For this reason, the following flag has to be added to <code>cmake</code> when compiling Simgear:<br />
-DSIMGEAR_HEADLESS=ON</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_Raspbian&diff=124391Building Flightgear - Raspbian2020-04-29T08:50:16Z<p>Puchacz: /* OpenSceneGraph */</p>
<hr />
<div>= Preparation =<br />
An installation of '''Raspbian Buster Lite''' is needed<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal <code>pi</code> user (not <code>root</code>). The <code>pi</code> user needs <code>sudo</code> access to install packages.<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>apt</code> command:<br />
sudo apt install libplib-dev cmake g++ libboost-all-dev libopenal-dev libglew-dev \<br />
libcurl4-openssl-dev libfreetype6-dev \<br />
libqt5svg5-dev qttools5-dev qtdeclarative5-private-dev qtbase5-private-dev libqt5websockets5-dev qml-module-qtquick2<br />
<br />
= Setup <code>pbuilder</code> =<br />
First, <code>pbuilder</code> has to be installed:<br />
sudo apt install pbuilder quilt<br />
<br />
Create a base chroot image tar-ball if it has not been created before:<br />
sudo pbuilder create \<br />
--distribution "buster" \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz" \<br />
--debootstrapopts --keyring=/usr/share/keyrings/raspbian-archive-keyring.gpg<br />
<br />
If the base chroot image tar-ball has been created before, update it:<br />
sudo pbuilder \<br />
--update \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz"<br />
<br />
= libcollada-dom2.4 =<br />
libcollada-dom2.4-dp0 has been build for Raspbian 9 not 10. The package has still dependencies to libboost-filesystem1.58.0 and libboost-system1.58.0 [https://github.com/RPi-Distro/repo/issues/162].<br />
<br />
The package needs to be rebuild using for example <code>pbuilder</code>:<br />
<br />
apt source libcollada-dom2.4-dp0<br />
pushd -- collada-dom-2.4.4+ds1<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- collada-dom-2.4.4+ds1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz collada-dom_2.4.4+ds1-2.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install /var/cache/pbuilder/result/libcollada-dom2.4-dp0_2.4.4+ds1-2_armhf.deb \<br />
/var/cache/pbuilder/result/libcollada-dom2.4-dp-dev_2.4.4+ds1-2_armhf.deb<br />
<br />
= OpenSceneGraph =<br />
The osgPlugins-3.4.1/osgdb_png.so is not compiled on ARM due to the flag OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF. The package needs to be rebuild using for example <code>pbuilder</code> after changing OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=947790]:<br />
apt source openscenegraph-3.4<br />
pushd -- openscenegraph-3.4-3.4.1+dfsg1<br />
<br />
Now modify the <code>debian/rules</code> file:<br />
nano debian/rules<br />
<br />
and change <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF</code> by <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON</code>. To prevent to run out of memory during the build (4 cores for only 1 Gb of memory in the case of the Raspberry Pi 2/3/3+), <code>--parallel</code> can be replaced by <code>--parallel 1</code> or <code>--parallel 2</code>.<br />
<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- openscenegraph-3.4-3.4.1+dfsg1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz openscenegraph-3.4_3.4.1+dfsg1-5.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install libopenscenegraph-3.4-131_3.4.1+dfsg1-5_armhf.deb \<br />
openscenegraph-3.4_3.4.1+dfsg1-5_armhf.deb \<br />
openscenegraph-3.4-examples_3.4.1+dfsg1-5_all.deb \<br />
libopenscenegraph-3.4-dev_3.4.1+dfsg1-5_armhf.deb<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
The Raspberry Pi 1/2/3/3+ only supports OpenGL ES 2.0. Simgear still contains some OpenGL 1 instructions (fixed pipeline, not shaders). On Raspbian, the Mesa package uses the accelerated KMS back-end that only supports, as expected, OpenGL ES 2.0. The graphical part of Simgear fails to compile on Raspbian when an OpenGL 1 instruction is used. For this reason, the following flag has to be added to <code>cmake</code> when compiling Simgear:<br />
-DSIMGEAR_HEADLESS=ON</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_Raspbian&diff=124377Building Flightgear - Raspbian2020-04-28T09:08:19Z<p>Puchacz: </p>
<hr />
<div>= Preparation =<br />
An installation of '''Raspbian Buster Lite''' is needed<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal <code>pi</code> user (not <code>root</code>). The <code>pi</code> user needs <code>sudo</code> access to install packages.<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>apt</code> command:<br />
sudo apt install libplib-dev cmake g++ libboost-all-dev libopenal-dev libglew-dev \<br />
libcurl4-openssl-dev libfreetype6-dev \<br />
libqt5svg5-dev qttools5-dev qtdeclarative5-private-dev qtbase5-private-dev libqt5websockets5-dev qml-module-qtquick2<br />
<br />
= Setup <code>pbuilder</code> =<br />
First, <code>pbuilder</code> has to be installed:<br />
sudo apt install pbuilder quilt<br />
<br />
Create a base chroot image tar-ball if it has not been created before:<br />
sudo pbuilder create \<br />
--distribution "buster" \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz" \<br />
--debootstrapopts --keyring=/usr/share/keyrings/raspbian-archive-keyring.gpg<br />
<br />
If the base chroot image tar-ball has been created before, update it:<br />
sudo pbuilder \<br />
--update \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz"<br />
<br />
= libcollada-dom2.4 =<br />
libcollada-dom2.4-dp0 has been build for Raspbian 9 not 10. The package has still dependencies to libboost-filesystem1.58.0 and libboost-system1.58.0 [https://github.com/RPi-Distro/repo/issues/162].<br />
<br />
The package needs to be rebuild using for example <code>pbuilder</code>:<br />
<br />
apt source libcollada-dom2.4-dp0<br />
pushd -- collada-dom-2.4.4+ds1<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- collada-dom-2.4.4+ds1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz collada-dom_2.4.4+ds1-2.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install /var/cache/pbuilder/result/libcollada-dom2.4-dp0_2.4.4+ds1-2_armhf.deb \<br />
/var/cache/pbuilder/result/libcollada-dom2.4-dp-dev_2.4.4+ds1-2_armhf.deb<br />
<br />
= OpenSceneGraph =<br />
The osgPlugins-3.4.1/osgdb_png.so is not compiled on ARM due to the flag OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF. The package needs to be rebuild using for example <code>pbuilder</code> after changing OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=947790]:<br />
apt-get source openscenegraph-3.4<br />
pushd -- openscenegraph-3.4-3.4.1+dfsg1<br />
<br />
Now modify the <code>debian/rules</code> file:<br />
nano debian/rules<br />
<br />
and change <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF</code> by <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON</code>.<br />
<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- openscenegraph-3.4-3.4.1+dfsg1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz openscenegraph-3.4_3.4.1+dfsg1-5.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install libopenscenegraph-3.4-131_3.4.1+dfsg1-5_armhf.deb \<br />
openscenegraph-3.4_3.4.1+dfsg1-5_armhf.deb \<br />
openscenegraph-3.4-examples_3.4.1+dfsg1-5_all.deb \<br />
libopenscenegraph-3.4-dev_3.4.1+dfsg1-5_armhf.deb<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
The Raspberry Pi 1/2/3/3+ only supports OpenGL ES 2.0. Simgear still contains some OpenGL 1 instructions (fixed pipeline, not shaders). On Raspbian, the Mesa package uses the accelerated KMS back-end that only supports, as expected, OpenGL ES 2.0. The graphical part of Simgear fails to compile on Raspbian when an OpenGL 1 instruction is used. For this reason, the following flag has to be added to <code>cmake</code> when compiling Simgear:<br />
-DSIMGEAR_HEADLESS=ON</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_Raspbian&diff=124376Building Flightgear - Raspbian2020-04-28T08:59:34Z<p>Puchacz: /* Compiling */</p>
<hr />
<div>= Preparation =<br />
An installation of '''Raspbian Buster Lite''' is needed<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal <code>pi</code> user (not <code>root</code>). The <code>pi</code> user needs <code>sudo</code> access to install packages.<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>apt</code> command:<br />
sudo apt install libplib-dev cmake g++ libboost-all-dev libopenal-dev libglew-dev \<br />
libcurl4-openssl-dev libfreetype6-dev<br />
<br />
= Setup <code>pbuilder</code> =<br />
First, <code>pbuilder</code> has to be installed:<br />
sudo apt install pbuilder quilt<br />
<br />
Create a base chroot image tar-ball if it has not been created before:<br />
sudo pbuilder create \<br />
--distribution "buster" \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz" \<br />
--debootstrapopts --keyring=/usr/share/keyrings/raspbian-archive-keyring.gpg<br />
<br />
If the base chroot image tar-ball has been created before, update it:<br />
sudo pbuilder \<br />
--update \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz"<br />
<br />
= libcollada-dom2.4 =<br />
libcollada-dom2.4-dp0 has been build for Raspbian 9 not 10. The package has still dependencies to libboost-filesystem1.58.0 and libboost-system1.58.0 [https://github.com/RPi-Distro/repo/issues/162].<br />
<br />
The package needs to be rebuild using for example <code>pbuilder</code>:<br />
<br />
apt source libcollada-dom2.4-dp0<br />
pushd -- collada-dom-2.4.4+ds1<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- collada-dom-2.4.4+ds1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz collada-dom_2.4.4+ds1-2.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install /var/cache/pbuilder/result/libcollada-dom2.4-dp0_2.4.4+ds1-2_armhf.deb \<br />
/var/cache/pbuilder/result/libcollada-dom2.4-dp-dev_2.4.4+ds1-2_armhf.deb<br />
<br />
= OpenSceneGraph =<br />
The osgPlugins-3.4.1/osgdb_png.so is not compiled on ARM due to the flag OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF. The package needs to be rebuild using for example <code>pbuilder</code> after changing OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=947790]:<br />
apt-get source openscenegraph-3.4<br />
pushd -- openscenegraph-3.4-3.4.1+dfsg1<br />
<br />
Now modify the <code>debian/rules</code> file:<br />
nano debian/rules<br />
<br />
and change <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF</code> by <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON</code>.<br />
<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- openscenegraph-3.4-3.4.1+dfsg1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz openscenegraph-3.4_3.4.1+dfsg1-5.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install libopenscenegraph-3.4-131_3.4.1+dfsg1-5_armhf.deb \<br />
openscenegraph-3.4_3.4.1+dfsg1-5_armhf.deb \<br />
openscenegraph-3.4-examples_3.4.1+dfsg1-5_all.deb \<br />
libopenscenegraph-3.4-dev_3.4.1+dfsg1-5_armhf.deb<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
The Raspberry Pi 1/2/3/3+ only supports OpenGL ES 2.0. Simgear still contains some OpenGL 1 instructions (fixed pipeline, not the shaders). On Raspbian, the Mesa package uses the accelerated KMS back-end that only supports, as expected, OpenGL ES 2.0. The graphical part of Simgear fails to compile on Raspbian when a OpenGL 1 instruction is used. For this reason, the following flag has to be added to <code>cmake</code> when compiling Simgear:<br />
-DSIMGEAR_HEADLESS=ON</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_Raspbian&diff=124367Building Flightgear - Raspbian2020-04-27T21:48:42Z<p>Puchacz: Created page with "= Preparation = An installation of '''Raspbian Buster Lite''' is needed = Requirements = All the commands are run in <code>bash</code> as normal <code>pi</code> user (not <co..."</p>
<hr />
<div>= Preparation =<br />
An installation of '''Raspbian Buster Lite''' is needed<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal <code>pi</code> user (not <code>root</code>). The <code>pi</code> user needs <code>sudo</code> access to install packages.<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>apt</code> command:<br />
sudo apt install libplib-dev cmake g++ libboost-all-dev libopenal-dev libglew-dev \<br />
libcurl4-openssl-dev libfreetype6-dev<br />
<br />
= Setup <code>pbuilder</code> =<br />
First, <code>pbuilder</code> has to be installed:<br />
sudo apt install pbuilder quilt<br />
<br />
Create a base chroot image tar-ball if it has not been created before:<br />
sudo pbuilder create \<br />
--distribution "buster" \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz" \<br />
--debootstrapopts --keyring=/usr/share/keyrings/raspbian-archive-keyring.gpg<br />
<br />
If the base chroot image tar-ball has been created before, update it:<br />
sudo pbuilder \<br />
--update \<br />
--basetgz "/var/cache/pbuilder/base-buster-armhf.tgz"<br />
<br />
= libcollada-dom2.4 =<br />
libcollada-dom2.4-dp0 has been build for Raspbian 9 not 10. The package has still dependencies to libboost-filesystem1.58.0 and libboost-system1.58.0 [https://github.com/RPi-Distro/repo/issues/162].<br />
<br />
The package needs to be rebuild using for example <code>pbuilder</code>:<br />
<br />
apt source libcollada-dom2.4-dp0<br />
pushd -- collada-dom-2.4.4+ds1<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- collada-dom-2.4.4+ds1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz collada-dom_2.4.4+ds1-2.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install /var/cache/pbuilder/result/libcollada-dom2.4-dp0_2.4.4+ds1-2_armhf.deb \<br />
/var/cache/pbuilder/result/libcollada-dom2.4-dp-dev_2.4.4+ds1-2_armhf.deb<br />
<br />
= OpenSceneGraph =<br />
The osgPlugins-3.4.1/osgdb_png.so is not compiled on ARM due to the flag OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF. The package needs to be rebuild using for example <code>pbuilder</code> after changing OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=947790]:<br />
apt-get source openscenegraph-3.4<br />
pushd -- openscenegraph-3.4-3.4.1+dfsg1<br />
<br />
Now modify the <code>debian/rules</code> file:<br />
nano debian/rules<br />
<br />
and change <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=OFF</code> by <code>OSG_CPP_EXCEPTIONS_AVAILABLE:BOOL=ON</code>.<br />
<br />
dpkg-buildpackage -S -d -us -uc<br />
popd<br />
rm -Rf -- openscenegraph-3.4-3.4.1+dfsg1<br />
sudo pbuilder --build --basetgz /var/cache/pbuilder/base-buster-armhf.tgz openscenegraph-3.4_3.4.1+dfsg1-5.dsc<br />
<br />
and then installed:<br />
sudo dpkg --install libopenscenegraph-3.4-131_3.4.1+dfsg1-5_armhf.deb \<br />
openscenegraph-3.4_3.4.1+dfsg1-5_armhf.deb \<br />
openscenegraph-3.4-examples_3.4.1+dfsg1-5_all.deb \<br />
libopenscenegraph-3.4-dev_3.4.1+dfsg1-5_armhf.deb<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
When compiling Simgear, the following flag has to be added to <code>cmake</code>:<br />
-DSIMGEAR_HEADLESS=ON</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_Ubuntu&diff=124366Building Flightgear - Ubuntu2020-04-27T20:44:35Z<p>Puchacz: </p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of Ubuntu 20.04 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user needs <code>sudo</code> access to install packages.<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>apt</code> command:<br />
<br />
sudo apt install libplib-dev libopenscenegraph-dev cmake g++ libboost-all-dev libopenal-dev libglew-dev \<br />
libcurl4-openssl-dev libfreetype-dev \<br />
libqt5svg5-dev qttools5-dev libqt5websockets5-dev qtbase5-private-dev qtdeclarative5-private-dev qml-module-qtquick2<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib</code> in the specific case of Ubuntu.<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=124363Building FlightGear - Linux2020-04-27T17:57:31Z<p>Puchacz: /* Debian/Ubuntu */ Add Raspbian</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have Flightgear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Ubuntu users can follow these instructions to build FlightGear on [[Building Flightgear - Ubuntu | Ubuntu 20.04]].<br />
* Raspbian users can follow these instructions to build FlightGear on [[Building Flightgear - Raspbian | Raspbian Buster]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== Flightgear ==<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make --jobs=${NR_JOBS} -- test_suite<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=123994Building FlightGear - Linux2020-04-21T13:33:01Z<p>Puchacz: /* Definitions */</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have Flightgear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Ubuntu users can follow these instructions to build FlightGear on [[Building Flightgear - Ubuntu | Ubuntu 20.04]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== Flightgear ==<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make --jobs=${NR_JOBS} -- test_suite<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=123974Building FlightGear - Linux2020-04-20T10:06:11Z<p>Puchacz: /* Flightgear */ Fix test</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have Flightgear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Ubuntu users can follow these instructions to build FlightGear on [[Building Flightgear - Ubuntu | Ubuntu 20.04]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distribution<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== Flightgear ==<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make --jobs=${NR_JOBS} -- test_suite<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=123944Building Flightgear - CentOS2020-04-18T22:33:15Z<p>Puchacz: Add packages for FGQCanvas</p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64 qt5-qtdeclarative-devel.x86_64 qt5-qtsvg-devel.x86_64 qt5-linguist.x86_64 qt5-qttools-devel.x86_64 qt5-qtwebsockets-devel.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib64</code>,...<br />
* <code>FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64</code> in the specific case of CentOS.<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.5</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DLIB_POSTFIX=64 \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
<br />
= Start Flightgear =<br />
<br />
cd -- "${FGFS_PREFIX}"<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX}/lib64/<br />
./bin/fgfs<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_Ubuntu&diff=123939Building Flightgear - Ubuntu2020-04-18T19:15:07Z<p>Puchacz: Add packages for FGQCanvas</p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of Ubuntu 20.04 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages.<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>apt</code> command:<br />
<br />
sudo apt install libplib-dev libopenscenegraph-dev cmake g++ libboost1.71-all-dev libopenal-dev libglew-dev \<br />
libcurl4-openssl-dev libfreetype-dev \<br />
libqt5svg5-dev qttools5-dev libqt5websockets5-dev qtbase5-private-dev qtdeclarative5-private-dev qml-module-qtquick2<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib</code> in the specific case of Ubuntu.<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_Ubuntu&diff=123518Building Flightgear - Ubuntu2020-04-13T20:36:54Z<p>Puchacz: /* Requirements */</p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of Ubuntu 20.04 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages.<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>apt</code> command:<br />
<br />
sudo apt install libplib-dev libopenscenegraph-dev cmake g++ libboost1.71-all-dev libopenal-dev libglew-dev \<br />
libcurl4-openssl-dev libudev-dev libfreetype-dev qtdeclarative5-dev libqt5svg5-dev qttools5-dev<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib</code> in the specific case of Ubuntu.<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_Ubuntu&diff=123514Building Flightgear - Ubuntu2020-04-13T20:09:15Z<p>Puchacz: Initial version</p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of Ubuntu 20.04 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages.<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>apt</code> command:<br />
<br />
sudo apt install libplib-dev libopenscenegraph-dev cmake g++ libboost1.71-all-dev libopenal-dev freeglut3-dev libglew-dev \<br />
libcurl4-openssl-dev libudev-dev libpng-dev libfreetype-dev qtdeclarative5-dev libqt5svg5-dev qttools5-dev<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib</code> in the specific case of Ubuntu.<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=123508Building FlightGear - Linux2020-04-13T20:02:58Z<p>Puchacz: /* Distro-specific instructions */</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have Flightgear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Ubuntu users can follow these instructions to build FlightGear on [[Building Flightgear - Ubuntu | Ubuntu 20.04]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distribution<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== Flightgear ==<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make --jobs=${NR_JOBS} -- test_suite<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=123503Building Flightgear - CentOS2020-04-13T19:56:35Z<p>Puchacz: /* Definitions */</p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64 qt5-qtdeclarative-devel.x86_64 qt5-qtsvg-devel.x86_64 qt5-linguist.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib64</code>,...<br />
* <code>FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64</code> in the specific case of CentOS.<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.5</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DLIB_POSTFIX=64 \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
<br />
= Start Flightgear =<br />
<br />
cd -- "${FGFS_PREFIX}"<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX}/lib64/<br />
./bin/fgfs<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=123455Building Flightgear - CentOS2020-04-13T17:34:35Z<p>Puchacz: </p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64 qt5-qtdeclarative-devel.x86_64 qt5-qtsvg-devel.x86_64 qt5-linguist.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.5</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DLIB_POSTFIX=64 \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= [[Building FlightGear - Linux#Compiling | Compiling]] =<br />
<br />
= Start Flightgear =<br />
<br />
cd -- "${FGFS_PREFIX}"<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX}/lib64/<br />
./bin/fgfs<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=123447Building FlightGear - Linux2020-04-13T17:26:22Z<p>Puchacz: </p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have Flightgear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distribution<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== Flightgear ==<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make --jobs=${NR_JOBS} -- test_suite<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=123444Building FlightGear - Linux2020-04-13T17:21:09Z<p>Puchacz: Update build for CMake</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
{{WIP}}<br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
= Distro-specific instructions =<br />
== Debian/Ubuntu ==<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have Flightgear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
== Gentoo ==<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
== CentOS ==<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
= Requirements =<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''CMake''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
= Dependencies =<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
= Compiling =<br />
<br />
== Definitions ==<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>FGFS_PREFIX_LIB</code>: The default <code>lib</code> directory is different between RedHat and Debian based distributions. Usually on Debian based distributions<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib<br />
Usually on RedHat based distribution<br />
FGFS_PREFIX_LIB=${FGFS_PREFIX}/lib64<br />
<br />
== Simgear ==<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
== Flightgear ==<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX_LIB}/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX_LIB}/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX_LIB}/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX_LIB}/<br />
FG_ROOT=${FGFS_PREFIX_LIB}/Flightgear make --jobs=${NR_JOBS} -- test_suite || true<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
= External links =<br />
== Instructions ==<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
= Important note for GIT users =<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=123439Building Flightgear - CentOS2020-04-13T16:43:12Z<p>Puchacz: </p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64 qt5-qtdeclarative-devel.x86_64 qt5-qtsvg-devel.x86_64 qt5-linguist.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.5</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DLIB_POSTFIX=64 \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= Simgear =<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
= Flightgear =<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX}/lib64/<br />
FG_ROOT=${FGFS_PREFIX}/lib64/Flightgear make --jobs=${NR_JOBS} -- test_suite || true<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX}/lib/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX}/lib/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX}/lib/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX}/lib/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX}/lib64/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX}/lib64/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX}/lib64/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
= Start Flightgear =<br />
<br />
cd -- "${FGFS_PREFIX}"<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX}/lib64/<br />
./bin/fgfs<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=121349Building Flightgear - CentOS2020-01-19T15:37:49Z<p>Puchacz: </p>
<hr />
<div>{{Under Construction}}<br />
<br />
= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64 qt5-qtdeclarative-devel.x86_64 qt5-qtsvg-devel.x86_64 qt5-linguist.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.4</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DLIB_POSTFIX=64 \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= Simgear =<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
= Flightgear =<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX}/lib/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX}/lib/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX}/lib/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX}/lib/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX}/lib/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX}/lib64/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX}/lib64/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
= Start Flightgear =<br />
<br />
cd -- "${FGFS_PREFIX}"<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX}/lib64<br />
./bin/fgfs<br />
<br />
[[Category:Building from source]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=121348Building Flightgear - CentOS2020-01-19T12:49:43Z<p>Puchacz: Add data</p>
<hr />
<div>{{Under Construction}}<br />
<br />
= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64 qt5-qtdeclarative-devel.x86_64 qt5-qtsvg-devel.x86_64 qt5-linguist.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.4</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DLIB_POSTFIX=64 \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= Simgear =<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
= Flightgear =<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
<br />
The data for Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here].<br />
rm -f -- "${FGFS_PREFIX}/lib/FlightGear"<br />
rm -Rf -- "${FGFS_PREFIX}/lib/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
mkdir --parents -- "${FGFS_PREFIX}/lib/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
pushd -- "${FGFS_PREFIX}/lib/FlightGear-${FLIGHTGEAR_VERSION}/"<br />
tar axvf "${FGFS_PREFIX}/src/FlightGear-${FLIGHTGEAR_VERSION}-data.tar.bz2"<br />
popd<br />
pushd -- "${FGFS_PREFIX}/lib/"<br />
ln --symbolic -- "FlightGear-${FLIGHTGEAR_VERSION}/fgdata/" FlightGear<br />
popd<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX}/lib64/"<br />
git clone --depth 1 https://git.code.sf.net/p/flightgear/fgdata flightgear-fgdata<br />
ln --symbolic -- "flightgear-fgdata/" FlightGear<br />
popd<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
pushd -- "${FGFS_PREFIX}/lib64/flightgear-fgdata/"<br />
git pull<br />
popd<br />
<br />
= Start Flightgear =<br />
<br />
cd -- "${FGFS_PREFIX}"<br />
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${FGFS_PREFIX}/lib64<br />
./bin/fgfs</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=121346Building Flightgear - CentOS2020-01-18T22:38:44Z<p>Puchacz: Add Qt5</p>
<hr />
<div>{{Under Construction}}<br />
<br />
= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64 qt5-qtdeclarative-devel.x86_64 qt5-qtsvg-devel.x86_64 qt5-linguist.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.4</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DLIB_POSTFIX=64 \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= Simgear =<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
= Flightgear =<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=121345Building Flightgear - CentOS2020-01-18T17:46:04Z<p>Puchacz: Fix OSG build: lib64</p>
<hr />
<div>{{Under Construction}}<br />
<br />
= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.4</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DLIB_POSTFIX=64 \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= Simgear =<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
= Flightgear =<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=121344Building Flightgear - CentOS2020-01-18T11:38:31Z<p>Puchacz: </p>
<hr />
<div>{{Under Construction}}<br />
<br />
= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code>.<br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code>. All the source code must be located under the directory <code>${FGFS_PREFIX}/src</code> and the installation will be done under the directory <code>${FGFS_PREFIX}</code> as <code>${FGFS_PREFIX}/bin</code>, <code>${FGFS_PREFIX}/include</code>, <code>${FGFS_PREFIX}/lib</code>,...<br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.4</code>.<br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to be build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here]. The downloaded file must be placed under the directory <code>${FGFS_PREFIX}/src</code> such that the full path of the file will be <code>${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}</code>.<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= Simgear =<br />
The source code of Simgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The environment variable <code>SIMGEAR_VERSION</code> must be set to the relevant version of Simgear, for example <code>SIMGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}<br />
rm -Rf -- "${SIMGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/simgear-${SIMGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Simgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/simgear flightgear-simgear<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
<br />
* if you have already a clone of the Simgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
SIMGEAR_SRC=${FGFS_PREFIX}/src/flightgear-simgear<br />
pushd -- "${SIMGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Simgear is available under the directory <code>${SIMGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
= Flightgear =<br />
The source code of Flightgear can be provided:<br />
* as an official release that can be downloaded from [https://sourceforge.net/projects/flightgear/files/ here]. The version of Simgear and Flightgear must match. The environment variable <code>FLIGHTGEAR_VERSION</code> must be set to the relevant version of Flightgear, for example <code>FLIGHTGEAR_VERSION=2019.1.1</code> and then using the following commands to extract the source code:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}<br />
rm -Rf -- "${FLIGHTGEAR_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/flightgear-${FLIGHTGEAR_VERSION}.tar.bz2"<br />
<br />
* as a clone of the Flightgear Git repo by using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
git clone https://git.code.sf.net/p/flightgear/flightgear flightgear-flightgear<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
<br />
* if you have already a clone of the Flightgear Git repo, the local copy can be updated using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
FLIGHTGEAR_SRC=${FGFS_PREFIX}/src/flightgear-flightgear<br />
pushd -- "${FLIGHTGEAR_SRC}/"<br />
git pull<br />
popd<br />
<br />
Now that the source code of Flightgear is available under the directory <code>${FLIGHTGEAR_SRC}</code>, the build can be started using the following commands:<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=121343Building Flightgear - CentOS2020-01-18T10:46:39Z<p>Puchacz: Under construction</p>
<hr />
<div>{{Under Construction}}<br />
<br />
= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code><br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code><br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.4</code><br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here].<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= Simgear =<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
= Flightgear =<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_Flightgear_-_CentOS&diff=121339Building Flightgear - CentOS2020-01-17T23:10:52Z<p>Puchacz: Initial version</p>
<hr />
<div>= Preparation =<br />
A "Minimal Install" of CentOS 8 (64 bits) is needed.<br />
<br />
= Requirements =<br />
All the commands are run in <code>bash</code> as normal user (not <code>root</code>). The user need <code>sudo</code> access to install packages and add some repos.<br />
<br />
The following repos need to be added and enabled:<br />
<br />
sudo dnf config-manager --set-enabled PowerTools<br />
sudo dnf install epel-release<br />
<br />
The following packages need to be install on the the system before starting the build of FlightGear. The packages can be install using the <code>dnf</code> command:<br />
<br />
sudo dnf install freeglut-devel.x86_64 openal-soft.x86_64 freetype-devel.x86_64 libjpeg-turbo-devel.x86_64 jasper-libs.x86_64 libxml2-devel.x86_64 libcurl-devel.x86_64 \<br />
cairo-devel.x86_64 poppler-glib.x86_64 librsvg2-devel.x86_64 gtk2-devel.x86_64 lua-libs.x86_64 lua.x86_64 fltk.x86_64 libpng-devel.x86_64 libtiff-devel.x86_64 \<br />
libXrandr-devel.x86_64 libXinerama-devel.x86_64 zlib-devel.x86_64 expat-devel.x86_64 boost.x86_64 openal-soft-devel.x86_64 cmake.x86_64 \<br />
mesa-libEGL-devel.x86_64 jasper-devel.x86_64 gstreamer1-devel.x86_64 SDL2-devel.x86_64 poppler-glib-devel.x86_64 lua-devel.x86_64 fltk-devel.x86_64 boost-devel.x86_64 \<br />
dbus-devel.x86_64 libevent-devel.x86_64 glew-devel.x86_64<br />
<br />
The <code>plib</code> package is not available for CentOS 8. The package from CentOS 7 can be used instead. After downloading the following packages:<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-1.8.5-15.el7.x86_64.rpm.html plib-1.8.5-15.el7.x86_64.rpm]<br />
* [https://centos.pkgs.org/7/epel-x86_64/plib-devel-1.8.5-15.el7.x86_64.rpm.html plib-devel-1.8.5-15.el7.x86_64.rpm]<br />
<br />
The 2 packages can be installed manually using the following command:<br />
<br />
sudo rpm --install plib-1.8.5-15.el7.x86_64.rpm <br />
sudo rpm --install plib-devel-1.8.5-15.el7.x86_64.rpm<br />
<br />
= Definitions =<br />
The following environment variables must be set because they will be used in shell commands:<br />
* <code>NR_JOBS</code>: Number of jobs for parallel compilation. For example: <code>NR_JOBS=$(/usr/bin/nproc)</code><br />
* <code>FGFS_PREFIX</code>: Prefix of the Flightgear installation. For example: <code>FGFS_PREFIX=${HOME}/Flightgear</code><br />
* <code>OPENSCENEGRAPH_VERSION</code>: Version of OpenSceneGraph. For example: <code>OPENSCENEGRAPH_VERSION=3.6.4</code><br />
<br />
= OpenSceneGraph =<br />
OpenSceneGraph is not available as a RPM for CentOS 8 and, for this reason, needs to build from sources. The latest stable version of OpenSceneGraph can be downloaded from [http://www.openscenegraph.org/index.php/download-section/stable-releases here].<br />
<br />
The following commands can be used to build OpenSceneGraph:<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
OPENSCENEGRAPH_SRC=${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
tar axvf "${FGFS_PREFIX}/src/OpenSceneGraph-OpenSceneGraph-${OPENSCENEGRAPH_VERSION}.tar.gz"<br />
pushd -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
cmake "${OPENSCENEGRAPH_SRC}" \<br />
-DCMAKE_BUILD_TYPE=Release \<br />
-DBUILD_OSG_EXAMPLES:BOOL=ON \<br />
-DOSG_USE_LOCAL_LUA_SOURCE:BOOL=OFF \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- install<br />
popd<br />
rm -Rf -- "${OPENSCENEGRAPH_SRC}/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/OpenSceneGraph_build/"<br />
<br />
= Simgear =<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/sg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/sg_build/"<br />
cmake "${SIMGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/sg_build/"<br />
<br />
= Flightgear =<br />
<br />
cd -- "${FGFS_PREFIX}/src/"<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"<br />
mkdir -- "${FGFS_PREFIX}/src/fg_build/"<br />
pushd -- "${FGFS_PREFIX}/src/fg_build/"<br />
cmake "${FLIGHTGEAR_SRC}" \<br />
-DCMAKE_BUILD_TYPE=RelWithDebInfo \<br />
-DCMAKE_INSTALL_PREFIX="${FGFS_PREFIX}" \<br />
-DCMAKE_VERBOSE_MAKEFILE=TRUE<br />
make --jobs=${NR_JOBS}<br />
make -- test<br />
make -- install<br />
popd<br />
rm -Rf -- "${FGFS_PREFIX}/src/fg_build/"</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Building_FlightGear_-_Linux&diff=121338Building FlightGear - Linux2020-01-17T22:08:28Z<p>Puchacz: Add CentOS</p>
<hr />
<div>{{Main article|Building Flightgear}} <br />
<br />
{{WIP}}<br />
<br />
This section describes how to build [[FlightGear]] on Linux system.<br />
<br />
Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.<br />
<br />
openSUSE also provides binary packages of the latest development version, which are continuously updated.<br />
Follow [http://software.opensuse.org/download.html?lang=en&project=games:FlightGear:Unstable&package=fgrun this link] to select your openSUSE version and install, or manually add ''games:FlightGear:Unstable'' to your ''YaST Software Repositories''.<br />
<br />
For Ubuntu, there is a PPA that provides the latest development version of FlightGear and SimGear and a recent version of FlightGear data. See [https://launchpad.net/~saiarcot895/+archive/flightgear-edge this page] for more info. To add the PPA, run <tt>sudo apt-add-repository ppa:saiarcot895/flightgear-edge</tt>.<br />
<br />
Or if you develop on Ubuntu or Debian, consider trying the script described in [[Scripted Compilation on Linux Debian/Ubuntu]].<br />
<br />
== Distro-specific instructions ==<br />
=== Debian/Ubuntu ===<br />
* You can use the [[Scripted Compilation on Linux Debian/Ubuntu]] script to have Flightgear compiled in one shot under both Ubuntu and Debian systems.<br />
* Debian users who prefer to build it without script may look at [[Building Flightgear - Debian]].<br />
* Hints for [[Ubuntu]] users.<br />
<br />
=== Gentoo ===<br />
* Gentoo users can also use overlays to build FlightGear without much hassle: [[Building Flightgear - Gentoo]].<br />
<br />
=== CentOS ===<br />
CentOS users can follow these instructions to build FlightGear on [[Building Flightgear - CentOS | CentOS 8]].<br />
<br />
== Requirements ==<br />
{{Note|as of 12/2017, people may have to build using at least OSG 3.4 due to some compilation issues -for details, refer to [[Howto:Building FlightGear without HiDPI support]]}}<br />
Edit 12/9/15 - These instructions are out of date! Do not use for compiling.<br />
<br />
Before you can compile FlightGear, you need to have the following installed on your computer:<br />
<br />
'''C++ compiler'''<br />
<br />
These are: c++, cpp, gcc, g++ found under the <code>/usr/bin</code> directory. You will also need to have the tools '''autoconf''' and '''automake1.9''' installed.<br />
<br />
'''GIT'''<br />
<br />
See [[FlightGear and Git]].<br />
<br />
'''[[OpenGL]] support'''<br />
<br />
More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running the following in a [[command line]]:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ glxinfo | grep direct<br />
</syntaxhighlight><br />
<br />
Note: To run the above command, you need to have the tool '''mesa-utils''' installed.<br />
<br />
You should then see:<br />
<br />
direct rendering: Yes<br />
<br />
This means you are good to go as far as OpenGL support is concerned.<br />
<br />
If you see:<br />
<br />
direct rendering: No<br />
<br />
Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing '''plib 1.8.5''' and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.<br />
<br />
== Dependencies ==<br />
<br />
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package <tt>plib1.8.5</tt> is <tt>plib1.8.5</tt>'''-dev'''.<br />
<br />
The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.<br />
<br />
* <tt>FlightGear</tt><br />
** [http://kcat.strangesoft.net/openal.html <tt>OpenAL</tt>]<br />
** <tt>SimGear</tt><br />
*** [http://plib.sourceforge.net/ <tt>PLIB</tt>]. Since March 2008, you will need version 1.8.5 - your distro probably supplies 1.8.4 still.<br />
**** For versions pre March 2008: (Free)<tt>GLUT</tt> or <tt>SDL</tt> (We recommend the use of <tt>SDL</tt> over <tt>Free/GLUT</tt>, [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16153.html however since March 2008, <tt>FreeGLUT</tt> as well as <tt>SDL</tt> are both considered deprecated], please only use <code>--enable-osgviewer</code> during configuration instead) <br />
*** <tt>[[OpenSceneGraph]]</tt> (check link for compatible versions)<br />
*** You also need the development files for several basic libraries to build the software, among them the following (the package names are for Debian and derivatives(?)):<br />
**** <tt>libfreetype6-dev</tt><br />
**** <tt>libjpeg62-dev</tt><br />
**** <tt>libungif4-dev</tt><br />
**** <tt>libtiff4-dev</tt><br />
**** <tt>libpng12-dev</tt><br />
**** <tt>libxmu-dev</tt><br />
**** <tt>libxi-dev</tt><br />
**** <tt>zlib1g-dev</tt><br />
**** <tt>libglut3-dev</tt><br />
<br />
If you attack the above dependencies in the order listed below, you should be good:<br />
<br />
# <tt>glut</tt> Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the <tt>glut</tt> and <tt>glut-devel</tt> packages, otherwise FlightGear may be able to compile but won't run correctly.<br />
# <tt>zlib</tt> Most distributions install the basic <tt>zlib</tt> libraries by default, but not the development portions. If you don't have <tt>zlib.h</tt>, you probably need to install the <tt>zlib-devel</tt> package for your distribution. <br />
# <tt>plib</tt> Portability libraries and scene graph. <br />
# <tt>[[OpenSceneGraph]]</tt> <br />
# <tt>simgear</tt> Simulation support libraries. If you are building FlightGear from Git, you need the Git version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.<br />
<br />
== Compiling ==<br />
Assuming you are root, do:<br />
<br />
<syntaxhighlight lang="bash"><br />
# cd /usr/local/src<br />
</syntaxhighlight><br />
<br />
'''Note:''' When tracking a fast changing software like FlightGear/Git it is highly advisable to install it in a separate directory. That way one can also easily build and reinstall without being root, which greatly reduces the risk of messing up one's system.<br />
To install in a directory of your choice add the <tt>--prefix</tt> argument to configure. E.g. <tt>./configure --prefix=$HOME/FlightGear</tt>. I would recommend installing all of OSG, plib, SimGear and FlightGear with the same prefix.<br />
<br />
=== Getting and compiling SimGear ===<br />
<br />
'''Step 1:'''<br />
<br />
Clone the SimGear git repository and set it up to track the 'next' branch.<br />
<br />
<syntaxhighlight lang="bash"><br />
$ git clone git://git.code.sf.net/p/flightgear/simgear simgear<br />
</syntaxhighlight><br />
<br />
or if the git port is firewalled on you network, use the http transport<br />
<br />
<syntaxhighlight lang="bash"><br />
$ git clone http://git.code.sf.net/p/flightgear/simgear simgear<br />
</syntaxhighlight><br />
<br />
By default after cloning you should have a local next branch that tracks the master next branch. It can be updated it with <code>git pull</code>.<br />
<br />
'''Step 2:'''<br />
<br />
The source code will be downloaded into a directory called '''simgear'''.<br />
<br />
Next, go into the directory and make preparations for the compilation:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ cd simgear<br />
$ cmake .<br />
</syntaxhighlight><br />
<br />
'''Note''' that if you don't want to install <tt>simgear</tt> globally on the system but in a specific directory, you can do so by adding <code>-DCMAKE_INSTALL_PREFIX=/path/to/your/fgInstallation</code> to the <code>cmake</code> command<br />
<br />
'''Step 3:'''<br />
<br />
Compile and install SimGear by doing:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ make; make install<br />
</syntaxhighlight><br />
<br />
''Note:'' with <tt>gcc</tt> 4.2 or later,on some platforms, you can get compiling errors about <tt>alc.h</tt> like: <br />
<br />
'<anonymous>' has incomplete type <br />
take a look at http://bugs.gentoo.org/166723<br />
<br />
=== Getting and compiling FlightGear ===<br />
<br />
'''Step 1:'''<br />
<br />
Clone the FlightGear git repository and set it up to track the 'next' branch.<br />
<br />
<syntaxhighlight lang="bash"><br />
$ git clone git://git.code.sf.net/p/flightgear/flightgear<br />
</syntaxhighlight><br />
<br />
By default after cloning you should have a local next branch that tracks the master next branch. It can be updated it with git pull.<br />
<br />
'''Step 2:'''<br />
<br />
Next, go into the folder and make preparations for the compilation:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ cd flightgear<br />
$ ./autogen.sh<br />
$ ./configure<br />
</syntaxhighlight><br />
<br />
Note that if you don't want to install simgear globally on the system but in a specific directory, you can do so by adding --prefix=/path/to/your/fgInstallation to the ./configure command.<br />
If you didn't install OSG globally or in the same prefix as SimGear and FlightGear, you have to pass the OSG directory to the configure-command like this:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ ./configure --prefix=/path/to/fgInstallation --with-osg=/path/to/osg/installation --enable-osgviewer<br />
</syntaxhighlight><br />
<br />
In this case you have to tell your system where to find the OSG libraries before you can run flightgear:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ export LD_LIBRARY_PATH=/path/to/osgInstallation/lib:$LD_LIBRARY_PATH<br />
</syntaxhighlight><br />
<br />
'''Step 3:'''<br />
<br />
Now you can compile and install Flightgear by:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ make; make install<br />
</syntaxhighlight><br />
<br />
'''Step 4:'''<br />
<br />
Clone the data directory:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ git clone git://git.code.sf.net/p/flightgear/fgdata<br />
</syntaxhighlight><br />
<br />
The data directory is large (almost 2.5GB) so it will take considerable time to download.<br />
There mirror of fgdata that might be faster to download from:<br />
<br />
<syntaxhighlight lang="bash"><br />
$ git clone git://mapserver.flightgear.org/fgdata<br />
</syntaxhighlight><br />
<br />
The mirror is synchronized with the master so either will do.<br />
<br />
And install it in (or as) /usr/local/share/FlightGear<br />
<br />
<syntaxhighlight lang="bash"><br />
$ mv fgdata /usr/local/share/flightgear<br />
</syntaxhighlight><br />
<br />
== External links ==<br />
=== Instructions ===<br />
* [[MSYS]] <br />
* [[MinGW/cross-compiler]] <br />
* [[CodeBlocks IDE]] <br />
* [[OpenSUSE 10.1 10.2]] <br />
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]<br />
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]<br />
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X]<br />
== Important note for GIT users ==<br />
As of latest development in GIT, only cmake is now required for building both SimGear and FlightGear. So if you build GIT (for what any reason) please don't try to use autogen.sh as it is removed from repository.<br />
<br />
For detailed instructions, see page [[Building_using_CMake|Building using cmake]].<br />
<br />
{{Building}}<br />
<br />
[[fr:Compiler FlightGear sous GNU/Linux]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=FGPanel&diff=107699FGPanel2017-04-28T18:49:30Z<p>Puchacz: Add FGPanel for Raspberry Pi</p>
<hr />
<div>[[File:FGPanel_SenecaII.png|thumb|300px|The 2D panel of a [[SenecaII]].]]<br />
'''FGPanel''' is designed as a standalone lightweight panel rendering engine to draw 2D panels on a low-cost computer/graphic card without 3D acceleration at reasonable frame rates.<br />
<br />
FGPanel was not part of the FlightGear 2.4.0 release for Windows. Windows users can get the executable from [http://flightgear.simpits.org:8080/job/FlightGear-Win-Cmake/lastSuccessfulBuild/artifact/install/msvc100/FlightGear/bin/fgpanel.exe Jenkins].<br />
<br />
== FGPanel Live System ==<br />
[[File:C172MiniCockpit1.jpg|thumb|200px|right|A complete display setup for the [[Cessna C172P]] using FGPanel.]]<br />
FGPanel is now available as a ''Live System'', a complete, stand-alone software setup, including FGPanel, (partial) FGData, Linux operating system and necessary start-up scripts. The ISO image (350MB download) needs to be programmed on a CD/DVD, USB flash or hard disk drive. Just insert the CD/DVD or connect the USB/HDD drive to your (old) PC, add an (old) graphics card, and an (old) TFT or monitor - and you've made the first step to your own cockpit home setup! The PC boots the image, immediately starts FGPanel and displays C172p cockpit instruments. Run the FlightGear Simulator on your main PC and enable the C172 FGPanel Protocol to transmit data to your cockpit panel PC.<br />
<br />
The live CD is a freely available SUSE Studio project. It can also be cloned/modified/adapted to personal needs via SUSE Studio (web interface). Operating system is based on OpenSuSE Linux 12.1. FlightGear binaries (fgpanel) are directly pulled from the OpenSuSE build service (OBS).<br />
<br />
More information available at the [http://susestudio.com/a/sBTdmU/flightgear-fgpanel SUSEStudio FGPanel] project.<br />
<br />
== FGPanel on Raspberry Pi ==<br />
<br />
FGPanel has been ported to run on a Raspberry Pi. All what you need is:<br />
* a Raspberry Pi;<br />
* a network to connect the Raspberry Pi with an instance of FlightGear Simulator;<br />
* Raspbian installed on the Raspberry Pi;<br />
* follow the procedure described in <tt>utils/fgpanel/README.RPi</tt> to build FGPanel.<br />
<br />
This FGPanel on Raspberry Pi makes it easy and cheap to build a panel for your own procedure trainer.<br />
<br />
== Related content ==<br />
* [[ Howto: Build your own procedure trainer]], describes how you can create a "cheap" procedure trainer, making use of FGPanel to draw the instruments.<br />
<br />
== External link ==<br />
* {{flightgear source|utils/fgpanel|text=Source}}<br />
* {{flightgear source|utils/fgpanel/README|text=README}}<br />
* {{flightgear source|utils/fgpanel/README.RPi|text=README.RPi}}<br />
<br />
[[Category: Software]]<br />
[[Category:Cockpit building]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Talk:Using_TerraGear&diff=106347Talk:Using TerraGear2016-12-13T13:29:01Z<p>Puchacz: </p>
<hr />
<div>--[[User:Hamster|Hamster]] ([[User talk:Hamster|talk]]) 17:46, 21 October 2016 (EDT)<br />
I think ogr-decode should be updated to poly-decode. Are there other differences between the tools despite the name?<br />
<br />
[[User:Puchacz|Puchacz]] ([[User talk:Puchacz|talk]]) 08:28, 13 December 2016 (EST)<br />
* Poly-decode is only available from the master branch. The scenery/ws2.0 branch should be used instead with ogr-decode.<br />
* TerraGogrear looks like a typo for TerraGear in the last edit. Can someone confirm?<br />
* http://mapserver.flightgear.org/ is not responding any more. Should the page be updated to use http://gis-lab.info/qa/vmap0-eng.html instead?</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Fr/Utiliser_TerraGear&diff=106324Fr/Utiliser TerraGear2016-12-11T13:14:16Z<p>Puchacz: ogr-decode => poly-decode</p>
<hr />
<div>[[File:Terragearprocesschart.png|thumb|Organigramme de TerraGear]]<br />
Le projet logiciel [[Fr/TerraGear|TerraGear]] participe au projet [[Fr/FlightGear|FlightGear]] en créant les fichiers utilisés par celui-ci pour représenter le relief et la texture de la Terre, ce qui comprend les aéroports, villes, champs, forêts, rivières, routes, etc. Le logiciel TerraGear lit des fichiers de données contenant l'élévation du sol, le positionnement et l'agencement des aéroports, les données géographiques d'occupation du sol, entre autres et produit les fichiers de scènes utilisés par Flightgear pour représenter la surface de la planète.<br />
<br />
Par simplicité et commodité, la plupart des utilisateurs de FlightGear téléchargent simplement les fichiers plug-and-play des scènes à partir du serveur de scènes de FlightGear, ou utilisent [[Fr/TerraSync|TerraSync]] pour télécharger automatiquement les scènes à la demande. Mais il peut y avoir des cas où vous voudriez utiliser TerraGear pour générer vos propres fichiers terrain, plutôt que de télécharger les scènes standard de FlightGear.<br />
<br />
Par exemple, si vous utilisez [[WorldEditor]] pour modifier/améliorer les information concernant un taxiway/une aire de trafic d'un [[:Category:Airports|aéroport]], vous pourriez avoir envie de visualiser à quoi ressemblerait cet aéroport modifié dans les scènes avant de décider que les résultats vous conviennent. Peut-être que les scènes officielles sont trop détaillées pour votre machine un peu ancienne, et que vous voudriez construire un terrain avec un modèle numérique de d'élévation (DEM) de plus faible résolution, afin de diminuer le nombre de polygones et ainsi augmenter votre taux de rafraîchissement d'image. Soit vous avez une machine ultra-rapide, et vous voulez construire votre propre terrain avec des données vectorielles de plus haute résolution (vmap1, Tiger, osm) pour obtenir de meilleures routes/rivières. Pour toutes ces raisons, apprendre à utiliser TerraGear est une bonne idée.<br />
<br />
== Obtenir TerraGear ==<br />
Vous pouvez soit compiler TerraGear vous-même, ou bien télécharger un binaire pré-compilé, cette dernière démarche étant plus aisée et donc recommandée pour les débutants.<br />
<br />
* '''Option 1 - Télécharger TerraGear pré-compilé (recommandé aux débutants) sur Windows'''<br />
*# Téléchargez la dernière version de TerraGear sur le [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip Serveur de compilation de FlightGear].<br />
*# Créez ou choisissez un répertoire pour contenir les outils TerraGear. <br />
*# Dé-zippez le paquetage et déplacez les fichiers de <tt>archive/install/msvc100/TerraGear/bin</tt> dans un sous-répertoire nommé <tt>Terragear/</tt> dans le répertoire de base.<br />
<br />
* '''Option 1b - Télécharger les paquetages ppa pour Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compiler TerraGear à partir du code source, comme expliqué dans [[Fr/TerraGear#Compilation|cet article]].<br />
<br />
{{note|1=Vous pourriez avoir besoin du fichier <code>default_priorities.txt</code> qui peut être obtenu à partir du {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=dépôt Git}} ou à partir de l'archive téléchargée à partir du serveur de compilation (dans le sous-répertoire <code>archive/install/msvc100/TerraGear/share</code>). Voir [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 ce lien du forum] pour les détails.}}<br />
<br />
=== Interface graphique ===<br />
L'interface graphique [[TerraGear GUI]] est disponible pour ceux voudraient utiliser TerraGear sans avoir à connaître/utiliser les options de ligne de commande.<br />
<br />
== Utilisation de TerraGear ==<br />
Tout d'abord, choisissez les limites de la zone de scène que vous voulez construire, en termes de latitude et de longitude. Plus la zone à générer sera restreinte, plus la quantité de données et le temps CPU nécessaire seront limités. Par exemple, si vous voulez juste générer une nouvelle disposition d'aéroport à la position 12°3 Ouest et 34°4 Nord, la génération des scènes entre 34°N 12°O et 35°N 13°O sera suffisante. <br />
<br />
Notez la boîte de délimitation (longitudes et latitudes minimum et maximum) pour la scène que vous voulez générer. Rappelez-vous que Ouest et Sud sont négatifs - c'est-à-dire que 4° Ouest 10° Sud doit être -4, -10. Essayez de ne pas vous mélanger les pinceaux, sinon la scène ou l'aéroport que vous créez se retrouvera de l'autre côté de la planète !<br />
<br />
Vous aurez affaire avec différents types de données utilisant des formats variés. Créez un nouveau répertoire pour votre travail de scène. A l'intérieur de ce répertoire, créez les sous-répertoires suivants: <br />
<br />
; <code>data/</code>: Pour les données brutes et pré-calculées (par exemple, les fichiers d'élévation)<br />
; <code>output/</code>: Pour les fichiers de scènes que vous créerez<br />
; <code>work/</code>: Pour les données qui ont été calculez (par exemple par shape-decode) et qui sont prêtes à être intégrées dans la scène<br />
<br />
=== Obtenir et traiter les données ===<br />
Terragear utilise trois sortes d'informations différentes pour générer une scène :<br />
<br />
# L'élévation du terrain (fournie par SRTM)<br />
# L'emplacement et la disposition des aéroports (fournis par apt.dat ou un fichier .dat personnalisé) <br />
# Si une lat/lon donnée correspond à la mer, la terre, une ville, une forêt, un village, une route, un chemin de fer (fourni par VMAP0, [[CORINE]], etc. ou par des fichiers personnalisés de formes)<br />
<br />
Cet article décrit comment obtenir et traiter chacun de ces types de données dans l'ordre, et les fournir ensemble, pour que FlightGear les utilise. L'ordre de ces étapes est important. Par exemple, l'étape des données d'un aéroport a besoin des données d'élévation pour déterminer l'élévation des aéroports. Ainsi, vous commencerez par préparer les données d'élévation.<br />
<br />
{{caution|Pour l'inclusion dans les scènes officielles de FlightGear, toutes les données ''doivent'' provenir de sources compatibles avec la licence [[GNU GPL]]!}}<br />
<br />
==== Données d'élévation ====<br />
Les meilleures données d'élévation actuellement disponibles proviennent du projet Shuttle Radar Topography Mission (SRTM). Il y a deux types de données SRTM :<br />
* Données de haute précision (résolution 1-arc seconde), ou SRTM-1, pour les USA<br />
* Données de précision moindre (résolution 3-arc second), ou SRTM-3, pour le reste du monde.<br />
<br />
A partir de maintenant, nous supposerons que vous utilisez les données SRTM-3. Sauf mention contraire, le processus est identique pour SRTM-1.<br />
<br />
Vous pouvez télécharger les données appropriées à partir du site http://dds.cr.usgs.gov/srtm/version2_1/. Vous devrez récupérer tous les fichiers .hgt.zip couvrant la région qui vous intéresse. Selon la taille de votre scène, cela peut représenter un grand nombre de fichiers. Téléchargez les vers l'emplacement <tt>data/SRTM-1/</tt> (ou SRTM-3/SRTM-30 en fonction du type de données que vous téléchargez) dans votre répertoire de base. (Genapts recherche les données d'élévation parmi un ensemble de noms de répertoires prédéfinis dans son répertoire de travail. SRTM-30 est l'un d'eux, c'est le moins déroutant dans cette liste. Notez que, à compter du 31 juillet 2010, l'outil genapts prend également en compte l'existence de répertoires SRTM-1/SRTM-3. Si vous utilisez une version plus ancienne, pensez à fournir les répertoires en utilisant --dem-path).<br />
<br />
Maintenant que nous avons les données, nous devons les convertir pour qu'elles puissent servir à TerraGear. Tout d'abord, dézippez chacun des fichiers .hgt. Ensuite, ouvrez la ligne de commande (Sous Windows: Démarrer > Exécuter > <code>cmd.exe</code>) et placez-vous dans le répertoire de base (<code>cd .../.../TerraGear</code>).<br />
<br />
{{note|Selon [[TerraGear_Documentation]], hgtchop est remplacé par gdalchop.}}<br />
{{note|Pour les données SRTM-1, remplacez le <code>3</code> par un <code>1</code> dans le premier argument fourni à hgtchop}}<br />
{{tip|Si vous voulez créer un fichier batch, remplacez <code>%f</code> avec <code>%%f</code>, voir à ce sujet : [http://technet.microsoft.com/en-us/library/bb490909.aspx]}}<br />
<br />
Pour Windows :<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
ou<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
Pour Linux :<br />
for f in ${PWD}/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 "${f}" "${PWD}/work/SRTM-3"; done<br />
<br />
Maintenant, vous allez obtenir une quantité importante de fichiers .arr.gz dans votre répertoire work/SRTM-3/. Il nous faut les convertir au format .fit.gz. Utilisez à nouveau la ligne de commande avec<br />
{{note|L'espace et le point à la fin sont importants!}}<br />
<br />
Pour Windows :<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
Pour Linux :<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Données d'aéroports ====<br />
Maintenant que nous avons les données d'élévation, nous pouvons générer nos aéroports. Tout d'abord, créons un répertoire <code>data/airports/</code> et copions-y votre fichier apt.dat. Celui-ci peut-être soit directement celui de votre paquetage de donnés FlightGear (bien que vous devrez le dé-zipper), soit un fichier que vous auriez modifié avec [[WorldEditor]].<br />
<br />
La commande pour créer les aéroports est "genapts850". Lancez-la sans aucun arguments afin de visualiser les différentes options de ligne de commande.<br />
<br />
Si elle est simplement lancée avec un fichier apt.dat spécifié et le répertoire de travail, elle générera les agencements d'aéroports pour chaque aéroport contenu dans le fichier, ce qui peut être long. Vérifiez que l'entrée n'est pas le fichier apt.dat.gz, mais le fichier décompressé. Sinon genapts850 bloquera et ne produira aucune sortie.<br />
<br />
Si vous créez juste un seul aéroport, et que vous connaissez son identifiant OACI (par exemple [[Fr/Aéroport international de San Francisco|KSFO]], EGPH, EG32), utilisez le comme suit à partir du répertoire racine des scènes (c'est à dire à partir du répertoire parent de vos répertoires data, work et output). Si vous utilisez un fichier apt.dat contenant un seul aéroport, vous pouvez omettre le paramètre <code>--airport</code>. <br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --airport=<IDENTIFIANT_OACI_AEROPORT><br />
<br />
ou, si vous avez les données d'élévation disponible:<br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --dem-path=SRTM-3<br />
<br />
Si vous générez des scènes plus grandes, alors vous pouvez spécifier les longitudes et latitudes minimum et maximum.<br />
<br />
Genapts va créer deux sous-répertoires dans votre répertoire work:<br />
<br />
* <code>AirportArea/</code><br />
* <code>AirportObj/</code><br />
<br />
Ils contiennent les définitions des agencement de l'aéroport, et de tous les objets présents (par exemple les manches à air et balises).<br />
<br />
==== Données d'utilisation du sol ====<br />
Les dernières données que nous avons besoin de générer sont celles correspondant au type d'utilisation du sol. En général, elles proviennent du lot de données VMAP0 en tant que fichiers de formes en provenance du serveur de carte de la base de données des scènes, mais d'autres sources peuvent aussi être utilisées.<br />
<br />
Les données d'utilisation du sol peuvent être séparées en différents types :<br />
<br />
; Landmass: Sépare la terre de la mer. Ces données peuvent être utilisées comme un masque pour toutes les autres données. Les plus couramment utilisées sont le Landmass VMAP0, mais GSHHS peut également être utilisé. Pendant l'exécution de tg-construct avec l'argument <code>--ignore-landmass</code>, toutes les entrées des fichiers de formes seront tenues en compte, ainsi le masque de Landmass n'est alors plus nécessaire.<br />
; Land use data: Définit si une portion de terrain correspond à une forêt, une zone urbaine, du sable, de la lave, des glaciers, etc. Ce sont généralement des données VMAP0, définies en tant que polygones.<br />
; Line data: Comprend les lignes de chemins de fer, les rivières, les routes. Typiquement VMAP0, mais aussi OpenStreetMap pour les routes.<br />
; Point data: Est actuellement uniquement utilisé pour définir les villes.<br />
<br />
De loin, le moyen le plus facile pour obtenir ces données est de télécharger les fichiers de formes à partir du magnifique [http://mapserver.flightgear.org MapServer]. Le MapServer vous permet de télécharger les fichiers de formes pour chaque région de scènes sélectionnée. Cliquez sur le lien "Download Shapefiles" (ou allez directement à : http://mapserver.flightgear.org/download.psp). Entrez dans la boîte de délimitation de la scène que vous désirez générer, sélectionnez le type de données de fichier de formes que vous voulez, et cliquez sur download.<br />
<br />
==== Layers ====<br />
<br />
; <code>v0</code>: Couverture globale, faible niveau de détails. C'est "la dernière chance", mais malheureusement c'est la seul couche qui couvre le monde entier.<br />
; <code>cs</code>: C'est v0 avec la contribution d'un certain nombre de personnes dans le passé. Utilisez la au lieu de v0.<br />
; <code>v1</code>: Seulement des parties de certains pays sont disponibles, plus haut niveau de détails que v0.<br />
; <code>clc06</code>: Européen '''seulement'''. Très haut niveau de détails, c'est le choix préféré pour les pays européens.<br />
; <code>osm</code>: Couverture globale, haute résolution mais très bas niveau de détails.<br />
: Cela signifie: si vous êtes intéressés par une région en dehors de l'Europe et que les forêts sont définies dans OpenStreetMaps pour cette région, cela sera la meilleure source de données. Si les forêts ne sont pas définies, vous obtiendrez un terne, interminable DEFAULT landclass. OSM fournit le meilleur littoral et je vous encourage à utiliser ce littoral même en Europe. [http://forum.flightgear.org/viewtopic.php?f=5&t=25549&sid=d501cb651ef9e34ca9dc8fae429d51ab&p=234002#p234002]<br />
<br />
Téléchargez chaque fichier-forme dans un répertoire séparé (!) <tt>data/shapefiles/...</tt>. Ainsi, pour v0_landmass, vous obtiendriez <tt>data/shapefiles/v0_landmass/v0_landmass.shp</tt>, etc.<br />
<br />
Vous pouvez charger ces fichiers-formes dans un éditeur SIG tel que [[QGIS]] ou GRASS pour les visualiser et les éditer. C'est une bonne idée pour vérifier que vous avez bien les bons fichiers ! Plus tard, vous pourrez expérimenter en remplaçant divers fichiers-formes avec d'autres versions (GSHHS pour la côte, OSM pour les routes, etc.).<br />
<br />
L'étape suivante décode les fichiers-formes vers le format TerraGear en utilisant la commande '''ogr-decode''' (renommée '''poly-decode''' dans les versions récentes de TerraGear). <br />
<br />
Il y a trois arguments de ligne de commande importants pour ogr-decode :<br />
* le répertoire de destination pour les données décodées,<br />
* la localisation du répertoire de fichiers-formes,<br />
* le type de matériau.<br />
<br />
Chaque fichier-forme correspond avec un des types de matériau défini dans les fichiers materials.xml. La correspondance est assez évidente. Par exemple, v0_mixedcroppasturecover correspond à MixedCropPastureCover. Notez que les types de matériau sont sensibles à la casse, donc il est bon de se référer au fichier <tt>[[$FG ROOT]]/materials.xml</tt> pour vérifier. L'exception est v0_landmass, qui DOIT correspondre au type Default.<br />
<br />
En complément, il existe de nombreux arguments optionnels pour indiquer la largeur des données linéaires (pour les routes, les rivières, les voies de chemin de fer), quelle largeur utiliser pour les données de type point (pour les villes) et quelle est la plus grande longueur acceptable pour une ligne droite.<br />
<br />
Par exemple, pour décoder le fichier-forme v0_landmass, vous entrez la commande suivante :<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Landmass data/shapefiles/v0_landmass<br />
<br />
Pour créer des rivières de 10 mètres de large :<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
Pour générer des villes d'environ 1 kilomètre de diagonale :<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Lancez cette commande pour chaque fichier-forme du lot de données.<br />
<br />
== Générer les scènes ==<br />
Vous avez maintenant un répertoire de travail, avec des sous-répertoires comme :<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Landmass<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Nous pouvons maintenant générer les scènes en utilisant la commande fgfs-construct. Lancez la commande avec <code>--help</code> pour obtenir les informations d'utilisation. <br />
<br />
Nous devons définir :<br />
* Les répertoires de travail (--work-dir) et de sortie (--output-dir) .<br />
** '''Notez''', au sujet du répertoire de sortie : il doit pointer vers le répertoire <tt>Terrain/</tt>, sinon, les versions récentes FlightGear seront incapables de charger le terrain.<br />
* Le centre de la scène que nous voulons générer (--lat, --lon).<br />
* Le rayon (--xdist, --ydist) à partir duquel on génère.<br />
* Tous les répertoires de travail à inclure dans la scène.<br />
<br />
Par exemple :<br />
{{Pre2|<nowiki>fgfs-construct --work-dir=./work --output-dir=./output/Terrain --lon=55 --lat=60 --xdist=3 --ydist=3 AirportArea SRTM-3 AirportObj Stream Bog IrrCropPastureCover Town Lake Urban Landmass Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
Lorsque cette commande se termine, le répertoire de sortie contiendra un sous-répertoire scenery. Pointez vers lui en paramétrant [[$FG_SCENERY]] ou en utilisant l'option de ligne de commande --fg-scenery à fgfs, et testez votre nouvelle scène !<br />
<br />
== Un soucis ? ==<br />
Vous trouverez ci-dessous une liste de problèmes courants et leur solutions. Dans le doute, copiez/collez votre erreur dans Google. La plupart des problèmes (en particulier lors de la compilation de TerraGear) ont déjà été évoqués :<br />
<br />
* Crash de genapts. Quelquefois, genapts plante avec certains aéroports. Dans ce cas, essayez de le relancer avec l'argument --start-id pour démarrer à l'aéroport sur lequel il a planté, et l'argument --nudge pour essayer de remettre les calculs dans la bonne voie.<br />
* fgfs-construct tué. Le processus fgfs-construct peut se suicider s'il consomme trop de ressources système. L'augmentation des valeurs pour setrlimit dans src/BuildTiles/Main/main.cxx est la meilleure solution.<br />
* Les aéroports apparaissent au fond de trous, ou il y a des espaces entre les aéroports et la scène. Ceci arrive lorsque genapts est incapable de trouver la donnée d'élévation correcte, ou alors la donnée d'élévation a changé entre le lancement de genapts et celui de shape-decode. Essayez de générer un seul aéroport dans votre zone de scène en utilisant genapts, et visualisez la sortie. En particulier, soyez sûr que le répertoire work/SRTM-3 existe. <br />
* Seuls les aéroports apparaissent dans la scène. Il existe trois explications typiques :<br />
** vous n'avez pas téléchargé les fichiers-formes corrects de la zone;<br />
** vous n'avez pas lancé shape-decode sur le fichier-forme v0_landmass comme Default <br />
** vous n'avez pas inclus les répertoires corrects dans fgfs-construct. <br />
* La scène générée contient des données effacées des fichiers-formes. Si vous éditez des fichiers-formes, vous devez effacer le sous-répertoire work approprié avant de lancer shape-decode. Sinon, vos changements s'ajouteront à ceux qui existent déjà.<br />
* La scène entière est plate et au niveau de la mer. C'est généralement dû au fait que vous n'avez pas inclus les données d'élévation dans votre commande fgfs-construct. Assurez-vous qu'il existe un répertoire STRM-3 précisé dans la ligne de commande. <br />
* Tout terrain copie le matériel d'un fichier-forme. Vous avez probablement oublié de mettre chacun des fichiers-formes téléchargés dans un répertoire séparé à l'intérieur du répertoire Data/shapefiles. <br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement]]<br />
[[en:Using TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Fr/Utiliser_TerraGear&diff=106033Fr/Utiliser TerraGear2016-11-21T23:44:06Z<p>Puchacz: /* Données d'utilisation du sol */</p>
<hr />
<div>[[File:Terragearprocesschart.png|thumb|Organigramme de TerraGear]]<br />
Le projet logiciel [[Fr/TerraGear|TerraGear]] participe au projet [[Fr/FlightGear|FlightGear]] en créant les fichiers utilisés par celui-ci pour représenter le relief et la texture de la Terre, ce qui comprend les aéroports, villes, champs, forêts, rivières, routes, etc. Le logiciel TerraGear lit des fichiers de données contenant l'élévation du sol, le positionnement et l'agencement des aéroports, les données géographiques d'occupation du sol, entre autres et produit les fichiers de scènes utilisés par Flightgear pour représenter la surface de la planète.<br />
<br />
Par simplicité et commodité, la plupart des utilisateurs de FlightGear téléchargent simplement les fichiers plug-and-play des scènes à partir du serveur de scènes de FlightGear, ou utilisent [[Fr/TerraSync|TerraSync]] pour télécharger automatiquement les scènes à la demande. Mais il peut y avoir des cas où vous voudriez utiliser TerraGear pour générer vos propres fichiers terrain, plutôt que de télécharger les scènes standard de FlightGear.<br />
<br />
Par exemple, si vous utilisez [[WorldEditor]] pour modifier/améliorer les information concernant un taxiway/une aire de trafic d'un [[:Category:Airports|aéroport]], vous pourriez avoir envie de visualiser à quoi ressemblerait cet aéroport modifié dans les scènes avant de décider que les résultats vous conviennent. Peut-être que les scènes officielles sont trop détaillées pour votre machine un peu ancienne, et que vous voudriez construire un terrain avec un modèle numérique de d'élévation (DEM) de plus faible résolution, afin de diminuer le nombre de polygones et ainsi augmenter votre taux de rafraîchissement d'image. Soit vous avez une machine ultra-rapide, et vous voulez construire votre propre terrain avec des données vectorielles de plus haute résolution (vmap1, Tiger, osm) pour obtenir de meilleures routes/rivières. Pour toutes ces raisons, apprendre à utiliser TerraGear est une bonne idée.<br />
<br />
== Obtenir TerraGear ==<br />
Vous pouvez soit compiler TerraGear vous-même, ou bien télécharger un binaire pré-compilé, cette dernière démarche étant plus aisée et donc recommandée pour les débutants.<br />
<br />
* '''Option 1 - Télécharger TerraGear pré-compilé (recommandé aux débutants) sur Windows'''<br />
*# Téléchargez la dernière version de TerraGear sur le [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip Serveur de compilation de FlightGear].<br />
*# Créez ou choisissez un répertoire pour contenir les outils TerraGear. <br />
*# Dé-zippez le paquetage et déplacez les fichiers de <tt>archive/install/msvc100/TerraGear/bin</tt> dans un sous-répertoire nommé <tt>Terragear/</tt> dans le répertoire de base.<br />
<br />
* '''Option 1b - Télécharger les paquetages ppa pour Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compiler TerraGear à partir du code source, comme expliqué dans [[Fr/TerraGear#Compilation|cet article]].<br />
<br />
{{note|1=Vous pourriez avoir besoin du fichier <code>default_priorities.txt</code> qui peut être obtenu à partir du {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=dépôt Git}} ou à partir de l'archive téléchargée à partir du serveur de compilation (dans le sous-répertoire <code>archive/install/msvc100/TerraGear/share</code>). Voir [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 ce lien du forum] pour les détails.}}<br />
<br />
=== Interface graphique ===<br />
L'interface graphique [[TerraGear GUI]] est disponible pour ceux voudraient utiliser TerraGear sans avoir à connaître/utiliser les options de ligne de commande.<br />
<br />
== Utilisation de TerraGear ==<br />
Tout d'abord, choisissez les limites de la zone de scène que vous voulez construire, en termes de latitude et de longitude. Plus la zone à générer sera restreinte, plus la quantité de données et le temps CPU nécessaire seront limités. Par exemple, si vous voulez juste générer une nouvelle disposition d'aéroport à la position 12°3 Ouest et 34°4 Nord, la génération des scènes entre 34°N 12°O et 35°N 13°O sera suffisante. <br />
<br />
Notez la boîte de délimitation (longitudes et latitudes minimum et maximum) pour la scène que vous voulez générer. Rappelez-vous que Ouest et Sud sont négatifs - c'est-à-dire que 4° Ouest 10° Sud doit être -4, -10. Essayez de ne pas vous mélanger les pinceaux, sinon la scène ou l'aéroport que vous créez se retrouvera de l'autre côté de la planète !<br />
<br />
Vous aurez affaire avec différents types de données utilisant des formats variés. Créez un nouveau répertoire pour votre travail de scène. A l'intérieur de ce répertoire, créez les sous-répertoires suivants: <br />
<br />
; <code>data/</code>: Pour les données brutes et pré-calculées (par exemple, les fichiers d'élévation)<br />
; <code>output/</code>: Pour les fichiers de scènes que vous créerez<br />
; <code>work/</code>: Pour les données qui ont été calculez (par exemple par shape-decode) et qui sont prêtes à être intégrées dans la scène<br />
<br />
=== Obtenir et traiter les données ===<br />
Terragear utilise trois sortes d'informations différentes pour générer une scène :<br />
<br />
# L'élévation du terrain (fournie par SRTM)<br />
# L'emplacement et la disposition des aéroports (fournis par apt.dat ou un fichier .dat personnalisé) <br />
# Si une lat/lon donnée correspond à la mer, la terre, une ville, une forêt, un village, une route, un chemin de fer (fourni par VMAP0, [[CORINE]], etc. ou par des fichiers personnalisés de formes)<br />
<br />
Cet article décrit comment obtenir et traiter chacun de ces types de données dans l'ordre, et les fournir ensemble, pour que FlightGear les utilise. L'ordre de ces étapes est important. Par exemple, l'étape des données d'un aéroport a besoin des données d'élévation pour déterminer l'élévation des aéroports. Ainsi, vous commencerez par préparer les données d'élévation.<br />
<br />
{{caution|Pour l'inclusion dans les scènes officielles de FlightGear, toutes les données ''doivent'' provenir de sources compatibles avec la licence [[GNU GPL]]!}}<br />
<br />
==== Données d'élévation ====<br />
Les meilleures données d'élévation actuellement disponibles proviennent du projet Shuttle Radar Topography Mission (SRTM). Il y a deux types de données SRTM :<br />
* Données de haute précision (résolution 1-arc seconde), ou SRTM-1, pour les USA<br />
* Données de précision moindre (résolution 3-arc second), ou SRTM-3, pour le reste du monde.<br />
<br />
A partir de maintenant, nous supposerons que vous utilisez les données SRTM-3. Sauf mention contraire, le processus est identique pour SRTM-1.<br />
<br />
Vous pouvez télécharger les données appropriées à partir du site http://dds.cr.usgs.gov/srtm/version2_1/. Vous devrez récupérer tous les fichiers .hgt.zip couvrant la région qui vous intéresse. Selon la taille de votre scène, cela peut représenter un grand nombre de fichiers. Téléchargez les vers l'emplacement <tt>data/SRTM-1/</tt> (ou SRTM-3/SRTM-30 en fonction du type de données que vous téléchargez) dans votre répertoire de base. (Genapts recherche les données d'élévation parmi un ensemble de noms de répertoires prédéfinis dans son répertoire de travail. SRTM-30 est l'un d'eux, c'est le moins déroutant dans cette liste. Notez que, à compter du 31 juillet 2010, l'outil genapts prend également en compte l'existence de répertoires SRTM-1/SRTM-3. Si vous utilisez une version plus ancienne, pensez à fournir les répertoires en utilisant --dem-path).<br />
<br />
Maintenant que nous avons les données, nous devons les convertir pour qu'elles puissent servir à TerraGear. Tout d'abord, dézippez chacun des fichiers .hgt. Ensuite, ouvrez la ligne de commande (Sous Windows: Démarrer > Exécuter > <code>cmd.exe</code>) et placez-vous dans le répertoire de base (<code>cd .../.../TerraGear</code>).<br />
<br />
{{note|Selon [[TerraGear_Documentation]], hgtchop est remplacé par gdalchop.}}<br />
{{note|Pour les données SRTM-1, remplacez le <code>3</code> par un <code>1</code> dans le premier argument fourni à hgtchop}}<br />
{{tip|Si vous voulez créer un fichier batch, remplacez <code>%f</code> avec <code>%%f</code>, voir à ce sujet : [http://technet.microsoft.com/en-us/library/bb490909.aspx]}}<br />
<br />
Pour Windows :<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
ou<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
Pour Linux :<br />
for f in ${PWD}/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 "${f}" "${PWD}/work/SRTM-3"; done<br />
<br />
Maintenant, vous allez obtenir une quantité importante de fichiers .arr.gz dans votre répertoire work/SRTM-3/. Il nous faut les convertir au format .fit.gz. Utilisez à nouveau la ligne de commande avec<br />
{{note|L'espace et le point à la fin sont importants!}}<br />
<br />
Pour Windows :<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
Pour Linux :<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Données d'aéroports ====<br />
Maintenant que nous avons les données d'élévation, nous pouvons générer nos aéroports. Tout d'abord, créons un répertoire <code>data/airports/</code> et copions-y votre fichier apt.dat. Celui-ci peut-être soit directement celui de votre paquetage de donnés FlightGear (bien que vous devrez le dé-zipper), soit un fichier que vous auriez modifié avec [[WorldEditor]].<br />
<br />
La commande pour créer les aéroports est "genapts850". Lancez-la sans aucun arguments afin de visualiser les différentes options de ligne de commande.<br />
<br />
Si elle est simplement lancée avec un fichier apt.dat spécifié et le répertoire de travail, elle générera les agencements d'aéroports pour chaque aéroport contenu dans le fichier, ce qui peut être long. Vérifiez que l'entrée n'est pas le fichier apt.dat.gz, mais le fichier décompressé. Sinon genapts850 bloquera et ne produira aucune sortie.<br />
<br />
Si vous créez juste un seul aéroport, et que vous connaissez son identifiant OACI (par exemple [[Fr/Aéroport international de San Francisco|KSFO]], EGPH, EG32), utilisez le comme suit à partir du répertoire racine des scènes (c'est à dire à partir du répertoire parent de vos répertoires data, work et output). Si vous utilisez un fichier apt.dat contenant un seul aéroport, vous pouvez omettre le paramètre <code>--airport</code>. <br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --airport=<IDENTIFIANT_OACI_AEROPORT><br />
<br />
ou, si vous avez les données d'élévation disponible:<br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --dem-path=SRTM-3<br />
<br />
Si vous générez des scènes plus grandes, alors vous pouvez spécifier les longitudes et latitudes minimum et maximum.<br />
<br />
Genapts va créer deux sous-répertoires dans votre répertoire work:<br />
<br />
* <code>AirportArea/</code><br />
* <code>AirportObj/</code><br />
<br />
Ils contiennent les définitions des agencement de l'aéroport, et de tous les objets présents (par exemple les manches à air et balises).<br />
<br />
==== Données d'utilisation du sol ====<br />
Les dernières données que nous avons besoin de générer sont celles correspondant au type d'utilisation du sol. En général, elles proviennent du lot de données VMAP0 en tant que fichiers de formes en provenance du serveur de carte de la base de données des scènes, mais d'autres sources peuvent aussi être utilisées.<br />
<br />
Les données d'utilisation du sol peuvent être séparées en différents types :<br />
<br />
; Landmass: Sépare la terre de la mer. Ces données peuvent être utilisées comme un masque pour toutes les autres données. Les plus couramment utilisées sont le Landmass VMAP0, mais GSHHS peut également être utilisé. Pendant l'exécution de tg-construct avec l'argument <code>--ignore-landmass</code>, toutes les entrées des fichiers de formes seront tenues en compte, ainsi le masque de Landmass n'est alors plus nécessaire.<br />
; Land use data: Définit si une portion de terrain correspond à une forêt, une zone urbaine, du sable, de la lave, des glaciers, etc. Ce sont généralement des données VMAP0, définies en tant que polygones.<br />
; Line data: Comprend les lignes de chemins de fer, les rivières, les routes. Typiquement VMAP0, mais aussi OpenStreetMap pour les routes.<br />
; Point data: Est actuellement uniquement utilisé pour définir les villes.<br />
<br />
De loin, le moyen le plus facile pour obtenir ces données est de télécharger les fichiers de formes à partir du magnifique [http://mapserver.flightgear.org MapServer]. Le MapServer vous permet de télécharger les fichiers de formes pour chaque région de scènes sélectionnée. Cliquez sur le lien "Download Shapefiles" (ou allez directement à : http://mapserver.flightgear.org/download.psp). Entrez dans la boîte de délimitation de la scène que vous désirez générer, sélectionnez le type de données de fichier de formes que vous voulez, et cliquez sur download.<br />
<br />
==== Layers ====<br />
<br />
; <code>v0</code>: Couverture globale, faible niveau de détails. C'est "la dernière chance", mais malheureusement c'est la seul couche qui couvre le monde entier.<br />
; <code>cs</code>: C'est v0 avec la contribution d'un certain nombre de personnes dans le passé. Utilisez la au lieu de v0.<br />
; <code>v1</code>: Seulement des parties de certains pays sont disponibles, plus haut niveau de détails que v0.<br />
; <code>clc06</code>: Européen '''seulement'''. Très haut niveau de détails, c'est le choix préféré pour les pays européens.<br />
; <code>osm</code>: Couverture globale, haute résolution mais très bas niveau de détails.<br />
: Cela signifie: si vous êtes intéressés par une région en dehors de l'Europe et que les forêts sont définies dans OpenStreetMaps pour cette région, cela sera la meilleure source de données. Si les forêts ne sont pas définies, vous obtiendrez un terne, interminable DEFAULT landclass. OSM fournit le meilleur littoral et je vous encourage à utiliser ce littoral même en Europe. [http://forum.flightgear.org/viewtopic.php?f=5&t=25549&sid=d501cb651ef9e34ca9dc8fae429d51ab&p=234002#p234002]<br />
<br />
Téléchargez chaque fichier-forme dans un répertoire séparé (!) <tt>data/shapefiles/...</tt>. Ainsi, pour v0_landmass, vous obtiendriez <tt>data/shapefiles/v0_landmass/v0_landmass.shp</tt>, etc.<br />
<br />
Vous pouvez charger ces fichiers-formes dans un éditeur SIG tel que [[QGIS]] ou GRASS pour les visualiser et les éditer. C'est une bonne idée pour vérifier que vous avez bien les bons fichiers ! Plus tard, vous pourrez expérimenter en remplaçant divers fichiers-formes avec d'autres versions (GSHHS pour la côte, OSM pour les routes, etc.).<br />
<br />
L'étape suivante décode les fichiers-formes vers le format TerraGear en utilisant la commande '''ogr-decode''' . <br />
<br />
Il y a trois arguments de ligne de commande importants pour ogr-decode :<br />
* le répertoire de destination pour les données décodées,<br />
* la localisation du répertoire de fichiers-formes,<br />
* le type de matériau.<br />
<br />
Chaque fichier-forme correspond avec un des types de matériau défini dans les fichiers materials.xml. La correspondance est assez évidente. Par exemple, v0_mixedcroppasturecover correspond à MixedCropPastureCover. Notez que les types de matériau sont sensibles à la casse, donc il est bon de se référer au fichier <tt>[[$FG ROOT]]/materials.xml</tt> pour vérifier. L'exception est v0_landmass, qui DOIT correspondre au type Default.<br />
<br />
En complément, il existe de nombreux arguments optionnels pour indiquer la largeur des données linéaires (pour les routes, les rivières, les voies de chemin de fer), quelle largeur utiliser pour les données de type point (pour les villes) et quelle est la plus grande longueur acceptable pour une ligne droite.<br />
<br />
Par exemple, pour décoder le fichier-forme v0_landmass, vous entrez la commande suivante :<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Landmass data/shapefiles/v0_landmass<br />
<br />
Pour créer des rivières de 10 mètres de large :<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
Pour générer des villes d'environ 1 kilomètre de diagonale :<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Lancez cette commande pour chaque fichier-forme du lot de données.<br />
<br />
== Générer les scènes ==<br />
Vous avez maintenant un répertoire de travail, avec des sous-répertoires comme :<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Landmass<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Nous pouvons maintenant générer les scènes en utilisant la commande fgfs-construct. Lancez la commande avec <code>--help</code> pour obtenir les informations d'utilisation. <br />
<br />
Nous devons définir :<br />
* Les répertoires de travail (--work-dir) et de sortie (--output-dir) .<br />
** '''Notez''', au sujet du répertoire de sortie : il doit pointer vers le répertoire <tt>Terrain/</tt>, sinon, les versions récentes FlightGear seront incapables de charger le terrain.<br />
* Le centre de la scène que nous voulons générer (--lat, --lon).<br />
* Le rayon (--xdist, --ydist) à partir duquel on génère.<br />
* Tous les répertoires de travail à inclure dans la scène.<br />
<br />
Par exemple :<br />
{{Pre2|<nowiki>fgfs-construct --work-dir=./work --output-dir=./output/Terrain --lon=55 --lat=60 --xdist=3 --ydist=3 AirportArea SRTM-3 AirportObj Stream Bog IrrCropPastureCover Town Lake Urban Landmass Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
Lorsque cette commande se termine, le répertoire de sortie contiendra un sous-répertoire scenery. Pointez vers lui en paramétrant [[$FG_SCENERY]] ou en utilisant l'option de ligne de commande --fg-scenery à fgfs, et testez votre nouvelle scène !<br />
<br />
== Un soucis ? ==<br />
Vous trouverez ci-dessous une liste de problèmes courants et leur solutions. Dans le doute, copiez/collez votre erreur dans Google. La plupart des problèmes (en particulier lors de la compilation de TerraGear) ont déjà été évoqués :<br />
<br />
* Crash de genapts. Quelquefois, genapts plante avec certains aéroports. Dans ce cas, essayez de le relancer avec l'argument --start-id pour démarrer à l'aéroport sur lequel il a planté, et l'argument --nudge pour essayer de remettre les calculs dans la bonne voie.<br />
* fgfs-construct tué. Le processus fgfs-construct peut se suicider s'il consomme trop de ressources système. L'augmentation des valeurs pour setrlimit dans src/BuildTiles/Main/main.cxx est la meilleure solution.<br />
* Les aéroports apparaissent au fond de trous, ou il y a des espaces entre les aéroports et la scène. Ceci arrive lorsque genapts est incapable de trouver la donnée d'élévation correcte, ou alors la donnée d'élévation a changé entre le lancement de genapts et celui de shape-decode. Essayez de générer un seul aéroport dans votre zone de scène en utilisant genapts, et visualisez la sortie. En particulier, soyez sûr que le répertoire work/SRTM-3 existe. <br />
* Seuls les aéroports apparaissent dans la scène. Il existe trois explications typiques :<br />
** vous n'avez pas téléchargé les fichiers-formes corrects de la zone;<br />
** vous n'avez pas lancé shape-decode sur le fichier-forme v0_landmass comme Default <br />
** vous n'avez pas inclus les répertoires corrects dans fgfs-construct. <br />
* La scène générée contient des données effacées des fichiers-formes. Si vous éditez des fichiers-formes, vous devez effacer le sous-répertoire work approprié avant de lancer shape-decode. Sinon, vos changements s'ajouteront à ceux qui existent déjà.<br />
* La scène entière est plate et au niveau de la mer. C'est généralement dû au fait que vous n'avez pas inclus les données d'élévation dans votre commande fgfs-construct. Assurez-vous qu'il existe un répertoire STRM-3 précisé dans la ligne de commande. <br />
* Tout terrain copie le matériel d'un fichier-forme. Vous avez probablement oublié de mettre chacun des fichiers-formes téléchargés dans un répertoire séparé à l'intérieur du répertoire Data/shapefiles. <br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement]]<br />
[[en:Using TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Using_TerraGear&diff=106032Using TerraGear2016-11-21T23:43:46Z<p>Puchacz: /* Landuse data */</p>
<hr />
<div>{{Out of date}}<br />
<br />
[[File:Terragearprocesschart.png|thumb|TerraGear Process Flow Chart]]<br />
The [[TerraGear]] software project supports [[FlightGear]] by creating the files used by FlightGear to represent the elevation and texture of the earth, including airports, cities, fields, forests, rivers, roads and so on. The TerraGear software reads data files containing ground elevation, airport locations and layouts, geographical land-cover data, and more, and produces the scenery files used by FlightGear to represent the terrain of the world.<br />
<br />
For simplicity and convenience, most FlightGear users simply download the plug-and-play scenery files from the FlightGear scenery server, or use [[TerraSync]] to automatically download scenery as needed. But there is a variety of reasons you might want to use TerraGear to produce your own terrain files, rather than downloading the standard FlightGear scenery. <br />
<br />
For instance, if you use [[WorldEditor]] to modify/improve information about an [[:Category:Airports|airport]]'s taxiway/apron layout, you might wish to see how that modified airport would look in the scenery before deciding you're happy with the results. 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-resolution vector data (vmap1, Tiger, osm) to get better roads/streams. For all these reasons, learning how to use TerraGear is a good idea.<br />
<br />
== Obtaining TerraGear ==<br />
You can either build TerraGear yourself, or download a pre-compiled binary. The later is the easiest and advised for starters.<br />
<br />
* '''Option 1a - Download TerraGear pre-compiled (recommended for beginners) on Windows'''<br />
*# Download the latest TerraGear build from the [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip FlightGear Build Server].<br />
*# Create or choose a directory to hold the TerraGear tools. <br />
*# Unzip the package and move the files from <code>archive/install/msvc100/TerraGear/bin</code> into a sub-directory named <code>Terragear/</code> in the base directory.<br />
<br />
* '''Option 1b - Download ppa packages for Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compile TerraGear from source code''' as explained in [[Building TerraGear|this article]].<br />
<br />
{{note|1=You might need <code>default_priorities.txt</code> from the {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=git repository}} or from the archive downloaded from the build server (in the <code>archive/install/msvc100/TerraGear/share</code> subdirectory). See [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 this forum thread] for details.}}<br />
<br />
=== GUI tool ===<br />
A [[TerraGear GUI]] is available for those that would like to use TerraGear without knowing/using the command line options.<br />
<br />
== Using TerraGear ==<br />
First, choose the boundaries for the area of scenery you want to build, in terms of latitude and longitude. The smaller the area of scenery you generate, the smaller the amount of data you will need, and the less CPU time it will take. For example, if you are just interested in generating a new airport layout at 12.3W 34.4N, then simply generating the scenery between 12W 34N and 13W 35N would be sufficient. <br />
<br />
Write down the bounding box (minimum and maximum longitude and latitude) for the scenery you want to generate. Remember that West and South are negative - in essence 4W 10S would be -4, -10. Try not to get mixed up, otherwise you'll end up generating scenery or airports on the other side of the planet! <br />
<br />
You'll be dealing with multiple different types of data in various formats. Create a new directory for your scenery work. Within that directory, create the following sub-directories: <br />
<br />
; <code>data/</code>: For raw and pre-processed data (eg elevation files) <br />
; <code>output/</code>: For the scenery files you will create <br />
; <code>work/</code>: For data that has been processed (eg by shape-decode) and is ready to be munged into scenery <br />
<br />
=== Obtaining and processing data ===<br />
TerraGear uses three different kinds of information to generate scenery:<br />
<br />
# The elevation of the land (provided by SRTM) <br />
# The location and layout of airports (provided by apt.dat or a custom .dat) <br />
# Whether a given lat/lon is sea, land, city, forest, town, road, railway (provided by VMAP0, [[CORINE]] etc. or custom shapefiles) <br />
<br />
This article describes how obtain and process each of these types of data in order, and bring it together for use by FlightGear. The order of these steps is important. For example, the airport data step needs the elevation data to determine the elevation of the airports and thus you should start with preparing elevation data.<br />
<br />
{{caution|For inclusion in the official FlightGear scenery, all data '''must''' come from [[GNU GPL]] compatible sources!}}<br />
<br />
==== Elevation data ====<br />
The best worldwide elevation data currently available is from the Shuttle Radar Topography Mission (SRTM). There are two types of SRTM data: <br />
* Highly accurate 1-arcsecond resolution data, known as SRTM-1, for the USA <br />
* Less accurate 3-arcsecond resolution data, known as SRTM-3, for the rest of the world. <br />
From now on, we'll assume you are using SRTM-3 data. Unless otherwise noted, the process for SRTM-1 is identical.<br />
<br />
You can download the appropriate data from http://dds.cr.usgs.gov/srtm/version2_1/. You want all .hgt.zip files covering your region of interest. Depending on the size of your scenery, there may be quite a few. Download them to <code>data/SRTM-1/</code> (or SRTM-3/SRTM-30 depending on the type you downloaded) in your base directory. (Genapts looks for a few known, hardcoded elevation data directories in its working directory. SRTM-30 is one of them and this is the least confusing in that list. Note: W.E.F. 31st July 2010, the genapts tool now also looks for SRTM-1/SRTM-3 directories. If you are using an older version, please supply the directories using --dem-path).<br />
<br />
Now we've got the data, we need to convert it into something of use to TerraGear. First, you need to unzip each of the .hgt files. After that, open the commandline (Windows: Start > Run > <code>cmd.exe</code>) and change into the base directory (<code>cd .../.../TerraGear</code>).<br />
<br />
{{note|According to [[TerraGear_Documentation]], hgtchop is superseded by gdalchop.}}<br />
{{note|For SRTM-1 data, replace the <code>3</code> by a <code>1</code> in the first argument to hgtchop}}<br />
{{tip|If you want to create a batch-file, replace <code>%f</code> with <code>%%f</code>, see [http://technet.microsoft.com/en-us/library/bb490909.aspx]}}<br />
<br />
For Windows:<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
or<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
For Linux:<br />
for f in ${PWD}/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 "${f}" "${PWD}/work/SRTM-3"; done<br />
<br />
Now you will get a lot of .arr.gz files in your work/SRTM-3/ directory. We need to convert these to the .fit.gz format. Run the commandline again with<br />
<br />
{{note|The space and dot at the and are important!}}<br />
<br />
For Windows:<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
For Linux:<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Airport data ====<br />
Now we've got elevation data, we can generate our airports. First, create a <code>data/airports/</code> directory and copy in your apt.dat file. This may be direct from your FlightGear data package (though you'll need to unzip it), or it may be one that you've modified with [[WorldEditor]]. <br />
<br />
The command to create airports is "genapts850". Run it without any arguments to see the various command-line options. <br />
<br />
If it is simply run with a specified apt.dat and work directory, it will generate airport layouts for every airport in the file, which can take a long time. Make sure the input is not the apt.dat.gz, but an uncompressed file. Otherwise genapts850 will block and not produce any output.<br />
<br />
If you are just creating a single airport and you know the ICAO ID (for example [[San Francisco International Airport|KSFO]], EGPH or EG32), use it as follows from your root scenery directory (in essence the directory above your data, work and output directories). If you use an apt.dat file with one single airport in it you should omit the <code>--airport</code> parameter. <br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --airport=<AIRPORT_ID><br />
<br />
or, if you have elevation data available:<br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --dem-path=SRTM-3<br />
<br />
If you are generating a larger set of scenery, then you can specify the minimum and maximum longitude and latitude. <br />
<br />
Genapts will create two sub-directories in your work directory:<br />
<br />
* <code>AirportArea/</code><br />
* <code>AirportObj/</code><br />
<br />
These contain the definitions of the airport layout and any objects present (e.g. windsocks and beacons).<br />
<br />
==== Landuse data ====<br />
The final piece of data we need to generate is the landuse data. In general, this is taken from the VMAP0 dataset as shapefiles from the scenery database mapserver, but other sources can also be used.<br />
<br />
The landuse data can be split into a number of different types:<br />
<br />
; Landmass: Separates the land from the sea. It can be used as a mask for all other data. The most commonly used is the VMAP0 Landmass, but GSHHS can also be used. When running tg-construct with <code>--ignore-landmass</code>, all input shapefiles will be taken into consideration, so no landmass mask is required then.<br />
; Land use data: Defines whether a piece of land is forest, urban, sand, lava, glacier etc. These are usually VMAP0 data, defined as polygons.<br />
; Line data: Includes railroads, streams, roads. Typically VMAP0, but also OpenStreetMap for roads.<br />
; Point data: Is currently only used for defining towns.<br />
<br />
By far the easiest way to get this data is to download shapefiles from the wonderful [http://mapserver.flightgear.org MapServer]. The MapServer lets you download the shapefiles for any selected scenery area. Click on the "Download Shapefiles" link (or go direct: http://mapserver.flightgear.org/download.psp). Enter in the bounding box of the scenery you want to generate, select the type of shapefile data you want, and click download.<br />
<br />
==== Layers ====<br />
<br />
; <code>v0</code>: Global coverage, low detail. This is "the last resort", but unfortunately it is the only layer that covers the entire world.<br />
; <code>cs</code>: It is v0 with some contributions someone did in the past. Get this instead of v0.<br />
; <code>v1</code>: Only parts of some countries available, higher detail than v0.<br />
; <code>clc06</code>: European '''only'''. Very high detail, this is the preferred choice for an European country.<br />
; <code>osm</code>: Global coverage, high resolution but very low detail.<br />
: This means: if you are interested in an area out of Europe and forests are defined in OpenStreetMaps for your area, this is going to be the best data source. If forests are not defined, you will get a dull, neverending DEFAULT landclass. OSM provides the best coastline and I encourage you to use this coastline even in Europe. [http://forum.flightgear.org/viewtopic.php?f=5&t=25549&sid=d501cb651ef9e34ca9dc8fae429d51ab&p=234002#p234002]<br />
<br />
{{caution|Make sure each shape file is in its own directory whether you download shape files or create your own otherwise the ogrDecode step will fail.}}<br />
Download each shapefile into a seperate (!) <code>data/shapefiles/...</code> directory. So, for v0_landmass, you would end up with <code>data/shapefiles/v0_landmass/v0_landmass.shp</code> etc.<br />
<br />
You can load these shapefiles into a GIS editor such as [[QGIS]] or GRASS to view and edit. This is a good idea to verify you have the correct files! Later on, you can experiment with replacing various shapefiles with other versions (GSHHS for coastline, OSM for roads etc.).<br />
<br />
The next step is to decode the shape-files into TerraGear format using the '''ogr-decode''' command. <br />
<br />
There are three important command-line arguments for ogr-decode:<br />
* the destination directory for the decoded data<br />
* the location of the shapefile's directory<br />
* the material type<br />
<br />
Each shape-file corresponds with one of the material types defined in the materials.xml files. The mapping is pretty obvious. For example, <code>v0_mixedcroppasturecover</code> maps to <code>MixedCropPastureCover</code>. Note that the material types are case-sensitive, so it is a good idea to refer to the <code>[[$FG_ROOT]]/Materials/default/materials.xml</code> file (<code>[[$FG ROOT]]/materials.xml</code> in FlightGear 2.6.0 and older) to hand so you can check. The exception is landmass, which - when used - MUST be mapped onto the type Default.<br />
<br />
Additionally, there are a number of optional arguments, to indicate the width of line data (for roads, streams, railways), how large to make point data (for towns) and how long the longest straight line is allowed to be.<br />
<br />
For example, to decode the <code>v0_landmass</code> shapefile, you use the following command:<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Default data/shapefiles/v0_landmass<br />
<br />
To create streams of width 10 metres<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
To generate some towns about 1km across<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Run this command for each shapefile in the set.<br />
<br />
== Generating scenery ==<br />
You will now have a work directory, with subdirectories like:<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: Default<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Now we can actually generate the scenery. This is done by the tg-construct command. Run the command with <code>--help</code> to get usage information. <br />
<br />
We need to define:<br />
* The work (<code>--work-dir</code>) and output (<code>--output-dir</code>) directories.<br />
* The center of the scenery we want to generate (<code>--lat</code> and <code>--lon</code>).<br />
* The radius (<code>--xdist</code> and <code>--ydist</code>) from which to generate.<br />
* All the work directories to include in the scenery.<br />
<br />
{{note|The output directory must point to a <code>Terrain/</code> directory, else recent FlightGear versions will be unable to load the terrain.}}<br />
<br />
For example:<br />
{{Pre2|<nowiki>tg-construct --work-dir=./work --output-dir=./output/Terrain --min-lon=55 --max-lon=57 --min-lat=60 --max-lat=62 AirportArea SRTM-3 AirportObj Default Stream Bog IrrCropPastureCover Town Lake Urban Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
When this finishes, the output directory will contain a scenery sub-tree. Point to it by setting either [[$FG_SCENERY]] or by using the <code>--fg-scenery</code> command-line option to fgfs, and give your new scenery a try!<br />
<br />
== Troubleshooting ==<br />
Below is a list of common problems and solutions. If in doubt - Google it. Many problems (particularly when compiling TerraGear) have been hit before: <br />
<br />
* Crashes in genapts. Sometimes genapts will crash when dealing with a particular airport. In that case, try running it again with the <code>--start-id</code> argument to start at the airport it failed on, and the <code>--nudge</code> argument which tries to nudge the calculations in the right direction. <br />
* tg-construct killed. The tg-construct process may kill itself if it is using too many system resources. Increasing the values for <code>setrlimit</code> in <code>src/BuildTiles/Main/main.cxx</code> is the best solution. <br />
* tg-construct silently stops immediately without an error and nothing goes to the "output" directory: make sure that lon/lat values correspond to tiles boundaries. See [[Tile Index Scheme]]<br />
* Airports appear in the bottom of holes, or there are spaces between the airports and the scenery. This typically happens when genapts is unable to find the correct elevation data, or the elevation data changed between running genapts and shape-decode. Try generating a single airport in your scenery area using genapts, and look at the output. In particular, make sure there is a work/SRTM-3 directory. <br />
* Only the airports appear in the scenery. There are three typical causes for this: <br />
** You didn't download the correct shapefiles for the area. <br />
** You haven't run shape-decode on the <code>v0_landmass</code> shapefile as Default <br />
** You didn't include the correct directories in tg-construct. <br />
* Generate scenery includes data removed from the shapefiles. If you are editing shapefiles, you need to delete the appropriate work subdirectory before running shape-decode. Otherwise your changes will be in addition to those already present. <br />
* All the scenery is flat and at sea-level. Typically this is because you didn't include any elevation data in your tg-construct command. Make sure there's a STRM-3 directory included in the command-line. <br />
* All terrain copies the material of a certain shapefile. You have probably forgotten to put each of the downloaded shapefiles in a seperate directory inside the Data/shapefiles directory.<br />
* genapts850 never passes the stage "Adding airport <ICAO> to parse list": did you unzip <code>apt.dat.gz</code>?<br />
<br />
== General comments from forum discussion ==<br />
{{cquote|f-ojac, you are right, the parameters used in scenery 2.0 were "-e 5 -x 20000" according to the wiki. I don't know why I had the impression these parameters were not public. In any case, it does not matter because using the same parameters will create closer results, but they are not guaranteed to be the same.<br />
<br />
The parameters used to create scenery 2,0 seem to be:<br />
<br />
-m ??: the minimum number of vertices in a tile. In FG, any number bellow 100 (and probably, any number below 1000) will do. I don't think there is any surface on the world perfectly flat for several kilometers. The default value is 50 and I'm sure is ok for any normal use.<br />
-e 5: the max allowed error for elevation, in meters. That is: if terrafit calculates a simplification of the terrain where all points are at most this distance from the real elevation, no more vertices are created. The default value is 40 meters: a point may have an elevation error up to 40m (~100ft) High values for this parameter create less detailed mountains and smaller (in disk size) and more efficient (in FPS) terrain.<br />
-x 20000: the max number of vertices in a tile. If this number of vertices is reached, terrafit stop regardless the max error of the vertices. The default value is 1000<br />
<br />
Keep in mind you can set values that do not make sense:<br />
<br />
* "-e 1 -x 100" does not make sense because it is going to be impossible to calculate errors less than 1 meters using only 100 vertices. The max number of vertices will be reached always and the max error will be probably ignored.<br />
* "-e 300 -x 20000" does not make sense, tiles are going to use for sure much less vertices than 20,000 because you are allowing huge elevation errors.<br />
<br />
If you want an efficient scenery (less vertices), use the default values "-e 40 -x 1000". If you want more accurate elevation at the cost of disk space and FPS, use values similar to scenery 2.0 ("-e 5 -x 20000") Anything in the middle will produce performance and disk use in the middle.<ref>{{cite web |url=http://forum.flightgear.org/viewtopic.php?f=5&t=24681#p225363 <br />
|title=Re: Terrasync Help (surprinsingly!) :)<br />
|author=ludomotico |date= Mon Nov 24, 2014 4:28 am}}</ref>|ludomotico}}<br />
<br />
<references/><br />
<br />
== Related content ==<br />
* [[Howto:Create custom terrain]], editing/making terrain data.<br />
* [[TerraGear CORINE]], building terrain from CORINE data.<br />
* [[TerraGear Documentation]], using TerraGear details.<br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement|TerraGear, Using]]<br />
<br />
[[fr:Utiliser TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Fr/Utiliser_TerraGear&diff=106019Fr/Utiliser TerraGear2016-11-20T20:28:25Z<p>Puchacz: </p>
<hr />
<div>[[File:Terragearprocesschart.png|thumb|Organigramme de TerraGear]]<br />
Le projet logiciel [[Fr/TerraGear|TerraGear]] participe au projet [[Fr/FlightGear|FlightGear]] en créant les fichiers utilisés par celui-ci pour représenter le relief et la texture de la Terre, ce qui comprend les aéroports, villes, champs, forêts, rivières, routes, etc. Le logiciel TerraGear lit des fichiers de données contenant l'élévation du sol, le positionnement et l'agencement des aéroports, les données géographiques d'occupation du sol, entre autres et produit les fichiers de scènes utilisés par Flightgear pour représenter la surface de la planète.<br />
<br />
Par simplicité et commodité, la plupart des utilisateurs de FlightGear téléchargent simplement les fichiers plug-and-play des scènes à partir du serveur de scènes de FlightGear, ou utilisent [[Fr/TerraSync|TerraSync]] pour télécharger automatiquement les scènes à la demande. Mais il peut y avoir des cas où vous voudriez utiliser TerraGear pour générer vos propres fichiers terrain, plutôt que de télécharger les scènes standard de FlightGear.<br />
<br />
Par exemple, si vous utilisez [[WorldEditor]] pour modifier/améliorer les information concernant un taxiway/une aire de trafic d'un [[:Category:Airports|aéroport]], vous pourriez avoir envie de visualiser à quoi ressemblerait cet aéroport modifié dans les scènes avant de décider que les résultats vous conviennent. Peut-être que les scènes officielles sont trop détaillées pour votre machine un peu ancienne, et que vous voudriez construire un terrain avec un modèle numérique de d'élévation (DEM) de plus faible résolution, afin de diminuer le nombre de polygones et ainsi augmenter votre taux de rafraîchissement d'image. Soit vous avez une machine ultra-rapide, et vous voulez construire votre propre terrain avec des données vectorielles de plus haute résolution (vmap1, Tiger, osm) pour obtenir de meilleures routes/rivières. Pour toutes ces raisons, apprendre à utiliser TerraGear est une bonne idée.<br />
<br />
== Obtenir TerraGear ==<br />
Vous pouvez soit compiler TerraGear vous-même, ou bien télécharger un binaire pré-compilé, cette dernière démarche étant plus aisée et donc recommandée pour les débutants.<br />
<br />
* '''Option 1 - Télécharger TerraGear pré-compilé (recommandé aux débutants) sur Windows'''<br />
*# Téléchargez la dernière version de TerraGear sur le [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip Serveur de compilation de FlightGear].<br />
*# Créez ou choisissez un répertoire pour contenir les outils TerraGear. <br />
*# Dé-zippez le paquetage et déplacez les fichiers de <tt>archive/install/msvc100/TerraGear/bin</tt> dans un sous-répertoire nommé <tt>Terragear/</tt> dans le répertoire de base.<br />
<br />
* '''Option 1b - Télécharger les paquetages ppa pour Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compiler TerraGear à partir du code source, comme expliqué dans [[Fr/TerraGear#Compilation|cet article]].<br />
<br />
{{note|1=Vous pourriez avoir besoin du fichier <code>default_priorities.txt</code> qui peut être obtenu à partir du {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=dépôt Git}} ou à partir de l'archive téléchargée à partir du serveur de compilation (dans le sous-répertoire <code>archive/install/msvc100/TerraGear/share</code>). Voir [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 ce lien du forum] pour les détails.}}<br />
<br />
=== Interface graphique ===<br />
L'interface graphique [[TerraGear GUI]] est disponible pour ceux voudraient utiliser TerraGear sans avoir à connaître/utiliser les options de ligne de commande.<br />
<br />
== Utilisation de TerraGear ==<br />
Tout d'abord, choisissez les limites de la zone de scène que vous voulez construire, en termes de latitude et de longitude. Plus la zone à générer sera restreinte, plus la quantité de données et le temps CPU nécessaire seront limités. Par exemple, si vous voulez juste générer une nouvelle disposition d'aéroport à la position 12°3 Ouest et 34°4 Nord, la génération des scènes entre 34°N 12°O et 35°N 13°O sera suffisante. <br />
<br />
Notez la boîte de délimitation (longitudes et latitudes minimum et maximum) pour la scène que vous voulez générer. Rappelez-vous que Ouest et Sud sont négatifs - c'est-à-dire que 4° Ouest 10° Sud doit être -4, -10. Essayez de ne pas vous mélanger les pinceaux, sinon la scène ou l'aéroport que vous créez se retrouvera de l'autre côté de la planète !<br />
<br />
Vous aurez affaire avec différents types de données utilisant des formats variés. Créez un nouveau répertoire pour votre travail de scène. A l'intérieur de ce répertoire, créez les sous-répertoires suivants: <br />
<br />
; <code>data/</code>: Pour les données brutes et pré-calculées (par exemple, les fichiers d'élévation)<br />
; <code>output/</code>: Pour les fichiers de scènes que vous créerez<br />
; <code>work/</code>: Pour les données qui ont été calculez (par exemple par shape-decode) et qui sont prêtes à être intégrées dans la scène<br />
<br />
=== Obtenir et traiter les données ===<br />
Terragear utilise trois sortes d'informations différentes pour générer une scène :<br />
<br />
# L'élévation du terrain (fournie par SRTM)<br />
# L'emplacement et la disposition des aéroports (fournis par apt.dat ou un fichier .dat personnalisé) <br />
# Si une lat/lon donnée correspond à la mer, la terre, une ville, une forêt, un village, une route, un chemin de fer (fourni par VMAP0, [[CORINE]], etc. ou par des fichiers personnalisés de formes)<br />
<br />
Cet article décrit comment obtenir et traiter chacun de ces types de données dans l'ordre, et les fournir ensemble, pour que FlightGear les utilise. L'ordre de ces étapes est important. Par exemple, l'étape des données d'un aéroport a besoin des données d'élévation pour déterminer l'élévation des aéroports. Ainsi, vous commencerez par préparer les données d'élévation.<br />
<br />
{{caution|Pour l'inclusion dans les scènes officielles de FlightGear, toutes les données ''doivent'' provenir de sources compatibles avec la licence [[GNU GPL]]!}}<br />
<br />
==== Données d'élévation ====<br />
Les meilleures données d'élévation actuellement disponibles proviennent du projet Shuttle Radar Topography Mission (SRTM). Il y a deux types de données SRTM :<br />
* Données de haute précision (résolution 1-arc seconde), ou SRTM-1, pour les USA<br />
* Données de précision moindre (résolution 3-arc second), ou SRTM-3, pour le reste du monde.<br />
<br />
A partir de maintenant, nous supposerons que vous utilisez les données SRTM-3. Sauf mention contraire, le processus est identique pour SRTM-1.<br />
<br />
Vous pouvez télécharger les données appropriées à partir du site http://dds.cr.usgs.gov/srtm/version2_1/. Vous devrez récupérer tous les fichiers .hgt.zip couvrant la région qui vous intéresse. Selon la taille de votre scène, cela peut représenter un grand nombre de fichiers. Téléchargez les vers l'emplacement <tt>data/SRTM-1/</tt> (ou SRTM-3/SRTM-30 en fonction du type de données que vous téléchargez) dans votre répertoire de base. (Genapts recherche les données d'élévation parmi un ensemble de noms de répertoires prédéfinis dans son répertoire de travail. SRTM-30 est l'un d'eux, c'est le moins déroutant dans cette liste. Notez que, à compter du 31 juillet 2010, l'outil genapts prend également en compte l'existence de répertoires SRTM-1/SRTM-3. Si vous utilisez une version plus ancienne, pensez à fournir les répertoires en utilisant --dem-path).<br />
<br />
Maintenant que nous avons les données, nous devons les convertir pour qu'elles puissent servir à TerraGear. Tout d'abord, dézippez chacun des fichiers .hgt. Ensuite, ouvrez la ligne de commande (Sous Windows: Démarrer > Exécuter > <code>cmd.exe</code>) et placez-vous dans le répertoire de base (<code>cd .../.../TerraGear</code>).<br />
<br />
{{note|Selon [[TerraGear_Documentation]], hgtchop est remplacé par gdalchop.}}<br />
{{note|Pour les données SRTM-1, remplacez le <code>3</code> par un <code>1</code> dans le premier argument fourni à hgtchop}}<br />
{{tip|Si vous voulez créer un fichier batch, remplacez <code>%f</code> avec <code>%%f</code>, voir à ce sujet : [http://technet.microsoft.com/en-us/library/bb490909.aspx]}}<br />
<br />
Pour Windows :<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
ou<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
Pour Linux :<br />
for f in ${PWD}/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 "${f}" "${PWD}/work/SRTM-3"; done<br />
<br />
Maintenant, vous allez obtenir une quantité importante de fichiers .arr.gz dans votre répertoire work/SRTM-3/. Il nous faut les convertir au format .fit.gz. Utilisez à nouveau la ligne de commande avec<br />
{{note|L'espace et le point à la fin sont importants!}}<br />
<br />
Pour Windows :<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
Pour Linux :<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Données d'aéroports ====<br />
Maintenant que nous avons les données d'élévation, nous pouvons générer nos aéroports. Tout d'abord, créons un répertoire <code>data/airports/</code> et copions-y votre fichier apt.dat. Celui-ci peut-être soit directement celui de votre paquetage de donnés FlightGear (bien que vous devrez le dé-zipper), soit un fichier que vous auriez modifié avec [[WorldEditor]].<br />
<br />
La commande pour créer les aéroports est "genapts850". Lancez-la sans aucun arguments afin de visualiser les différentes options de ligne de commande.<br />
<br />
Si elle est simplement lancée avec un fichier apt.dat spécifié et le répertoire de travail, elle générera les agencements d'aéroports pour chaque aéroport contenu dans le fichier, ce qui peut être long. Vérifiez que l'entrée n'est pas le fichier apt.dat.gz, mais le fichier décompressé. Sinon genapts850 bloquera et ne produira aucune sortie.<br />
<br />
Si vous créez juste un seul aéroport, et que vous connaissez son identifiant OACI (par exemple [[Fr/Aéroport international de San Francisco|KSFO]], EGPH, EG32), utilisez le comme suit à partir du répertoire racine des scènes (c'est à dire à partir du répertoire parent de vos répertoires data, work et output). Si vous utilisez un fichier apt.dat contenant un seul aéroport, vous pouvez omettre le paramètre <code>--airport</code>. <br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --airport=<IDENTIFIANT_OACI_AEROPORT><br />
<br />
ou, si vous avez les données d'élévation disponible:<br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --dem-path=SRTM-3<br />
<br />
Si vous générez des scènes plus grandes, alors vous pouvez spécifier les longitudes et latitudes minimum et maximum.<br />
<br />
Genapts va créer deux sous-répertoires dans votre répertoire work:<br />
<br />
* <code>AirportArea/</code><br />
* <code>AirportObj/</code><br />
<br />
Ils contiennent les définitions des agencement de l'aéroport, et de tous les objets présents (par exemple les manches à air et balises).<br />
<br />
==== Données d'utilisation du sol ====<br />
Les dernières données que nous avons besoin de générer sont celles correspondant au type d'utilisation du sol. En général, elles proviennent du lot de données VMAP0 en tant que fichiers de formes en provenance du serveur de carte de la base de données des scènes, mais d'autres sources peuvent aussi être utilisées.<br />
<br />
Les données d'utilisation du sol peuvent être séparées en différents types :<br />
<br />
; Landmass: Sépare la terre de la mer. Ces données peuvent être utilisées comme un masque pour toutes les autres données. Les plus couramment utilisées sont le Landmass VMAP0, mais GSHHS peut également être utilisé. Pendant l'exécution de tg-construct avec l'argument <code>--ignore-landmass</code>, toutes les entrées des fichiers de formes seront tenues en compte, ainsi le masque de Landmass n'est alors plus nécessaire.<br />
; Land use data: Définit si une portion de terrain correspond à une forêt, une zone urbaine, du sable, de la lave, des glaciers, etc. Ce sont généralement des données VMAP0, définies en tant que polygones.<br />
; Line data: Comprend les lignes de chemins de fer, les rivières, les routes. Typiquement VMAP0, mais aussi Open Street Map pour les routes.<br />
; Point data: Est actuellement uniquement utilisé pour définir les villes.<br />
<br />
De loin, le moyen le plus facile pour obtenir ces données est de télécharger les fichiers de formes à partir du magnifique [http://mapserver.flightgear.org MapServer]. Le MapServer vous permet de télécharger les fichiers de formes pour chaque région de scènes sélectionnée. Cliquez sur le lien "Download Shapefiles" (ou allez directement à : http://mapserver.flightgear.org/download.psp). Entrez dans la boîte de délimitation de la scène que vous désirez générer, sélectionnez le type de données de fichier de formes que vous voulez, et cliquez sur download.<br />
<br />
==== Layers ====<br />
<br />
; <code>v0</code>: Couverture globale, faible niveau de détails. C'est "la dernière chance", mais malheureusement c'est la seul couche qui couvre le monde entier.<br />
; <code>cs</code>: C'est v0 avec la contribution d'un certain nombre de personnes dans le passé. Utilisez la au lieu de v0.<br />
; <code>v1</code>: Seulement des parties de certains pays sont disponibles, plus haut niveau de détails que v0.<br />
; <code>clc06</code>: Européen '''seulement'''. Très haut niveau de détails, c'est le choix préféré pour les pays européens.<br />
; <code>osm</code>: Couverture globale, haute résolution mais très bas niveau de détails.<br />
: Cela signifie: si vous êtes intéressés par une région en dehors de l'Europe et que les forêts sont définies dans OpenStreetMaps pour cette région, cela sera la meilleure source de données. Si les forêts ne sont pas définies, vous obtiendrez un terne, interminable DEFAULT landclass. OSM fournit le meilleur littoral et je vous encourage à utiliser ce littoral même en Europe. [http://forum.flightgear.org/viewtopic.php?f=5&t=25549&sid=d501cb651ef9e34ca9dc8fae429d51ab&p=234002#p234002]<br />
<br />
Téléchargez chaque fichier-forme dans un répertoire séparé (!) <tt>data/shapefiles/...</tt>. Ainsi, pour v0_landmass, vous obtiendriez <tt>data/shapefiles/v0_landmass/v0_landmass.shp</tt>, etc.<br />
<br />
Vous pouvez charger ces fichiers-formes dans un éditeur SIG tel que [[QGIS]] ou GRASS pour les visualiser et les éditer. C'est une bonne idée pour vérifier que vous avez bien les bons fichiers ! Plus tard, vous pourrez expérimenter en remplaçant divers fichiers-formes avec d'autres versions (GSHHS pour la côte, OSM pour les routes, etc.).<br />
<br />
L'étape suivante décode les fichiers-formes vers le format TerraGear en utilisant la commande '''ogr-decode''' . <br />
<br />
Il y a trois arguments de ligne de commande importants pour ogr-decode :<br />
* le répertoire de destination pour les données décodées,<br />
* la localisation du répertoire de fichiers-formes,<br />
* le type de matériau.<br />
<br />
Chaque fichier-forme correspond avec un des types de matériau défini dans les fichiers materials.xml. La correspondance est assez évidente. Par exemple, v0_mixedcroppasturecover correspond à MixedCropPastureCover. Notez que les types de matériau sont sensibles à la casse, donc il est bon de se référer au fichier <tt>[[$FG ROOT]]/materials.xml</tt> pour vérifier. L'exception est v0_landmass, qui DOIT correspondre au type Default.<br />
<br />
En complément, il existe de nombreux arguments optionnels pour indiquer la largeur des données linéaires (pour les routes, les rivières, les voies de chemin de fer), quelle largeur utiliser pour les données de type point (pour les villes) et quelle est la plus grande longueur acceptable pour une ligne droite.<br />
<br />
Par exemple, pour décoder le fichier-forme v0_landmass, vous entrez la commande suivante :<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Landmass data/shapefiles/v0_landmass<br />
<br />
Pour créer des rivières de 10 mètres de large :<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
Pour générer des villes d'environ 1 kilomètre de diagonale :<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Lancez cette commande pour chaque fichier-forme du lot de données.<br />
<br />
== Générer les scènes ==<br />
Vous avez maintenant un répertoire de travail, avec des sous-répertoires comme :<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Landmass<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Nous pouvons maintenant générer les scènes en utilisant la commande fgfs-construct. Lancez la commande avec <code>--help</code> pour obtenir les informations d'utilisation. <br />
<br />
Nous devons définir :<br />
* Les répertoires de travail (--work-dir) et de sortie (--output-dir) .<br />
** '''Notez''', au sujet du répertoire de sortie : il doit pointer vers le répertoire <tt>Terrain/</tt>, sinon, les versions récentes FlightGear seront incapables de charger le terrain.<br />
* Le centre de la scène que nous voulons générer (--lat, --lon).<br />
* Le rayon (--xdist, --ydist) à partir duquel on génère.<br />
* Tous les répertoires de travail à inclure dans la scène.<br />
<br />
Par exemple :<br />
{{Pre2|<nowiki>fgfs-construct --work-dir=./work --output-dir=./output/Terrain --lon=55 --lat=60 --xdist=3 --ydist=3 AirportArea SRTM-3 AirportObj Stream Bog IrrCropPastureCover Town Lake Urban Landmass Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
Lorsque cette commande se termine, le répertoire de sortie contiendra un sous-répertoire scenery. Pointez vers lui en paramétrant [[$FG_SCENERY]] ou en utilisant l'option de ligne de commande --fg-scenery à fgfs, et testez votre nouvelle scène !<br />
<br />
== Un soucis ? ==<br />
Vous trouverez ci-dessous une liste de problèmes courants et leur solutions. Dans le doute, copiez/collez votre erreur dans Google. La plupart des problèmes (en particulier lors de la compilation de TerraGear) ont déjà été évoqués :<br />
<br />
* Crash de genapts. Quelquefois, genapts plante avec certains aéroports. Dans ce cas, essayez de le relancer avec l'argument --start-id pour démarrer à l'aéroport sur lequel il a planté, et l'argument --nudge pour essayer de remettre les calculs dans la bonne voie.<br />
* fgfs-construct tué. Le processus fgfs-construct peut se suicider s'il consomme trop de ressources système. L'augmentation des valeurs pour setrlimit dans src/BuildTiles/Main/main.cxx est la meilleure solution.<br />
* Les aéroports apparaissent au fond de trous, ou il y a des espaces entre les aéroports et la scène. Ceci arrive lorsque genapts est incapable de trouver la donnée d'élévation correcte, ou alors la donnée d'élévation a changé entre le lancement de genapts et celui de shape-decode. Essayez de générer un seul aéroport dans votre zone de scène en utilisant genapts, et visualisez la sortie. En particulier, soyez sûr que le répertoire work/SRTM-3 existe. <br />
* Seuls les aéroports apparaissent dans la scène. Il existe trois explications typiques :<br />
** vous n'avez pas téléchargé les fichiers-formes corrects de la zone;<br />
** vous n'avez pas lancé shape-decode sur le fichier-forme v0_landmass comme Default <br />
** vous n'avez pas inclus les répertoires corrects dans fgfs-construct. <br />
* La scène générée contient des données effacées des fichiers-formes. Si vous éditez des fichiers-formes, vous devez effacer le sous-répertoire work approprié avant de lancer shape-decode. Sinon, vos changements s'ajouteront à ceux qui existent déjà.<br />
* La scène entière est plate et au niveau de la mer. C'est généralement dû au fait que vous n'avez pas inclus les données d'élévation dans votre commande fgfs-construct. Assurez-vous qu'il existe un répertoire STRM-3 précisé dans la ligne de commande. <br />
* Tout terrain copie le matériel d'un fichier-forme. Vous avez probablement oublié de mettre chacun des fichiers-formes téléchargés dans un répertoire séparé à l'intérieur du répertoire Data/shapefiles. <br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement]]<br />
[[en:Using TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Fr/Utiliser_TerraGear&diff=106018Fr/Utiliser TerraGear2016-11-20T19:42:57Z<p>Puchacz: /* Données d'utilisation du sol */</p>
<hr />
<div>[[File:Terragearprocesschart.png|thumb|Organigramme de TerraGear]]<br />
Le projet logiciel [[Fr/TerraGear|TerraGear]] participe au projet [[Fr/FlightGear|FlightGear]] en créant les fichiers utilisés par celui-ci pour représenter le relief et la texture de la Terre, ce qui comprend les aéroports, villes, champs, forêts, rivières, routes, etc. Le logiciel TerraGear lit des fichiers de données contenant l'élévation du sol, le positionnement et l'agencement des aéroports, les données géographiques d'occupation du sol, entre autres et produit les fichiers de scènes utilisés par Flightgear pour représenter la surface de la planète.<br />
<br />
Par simplicité et commodité, la plupart des utilisateurs de FlightGear téléchargent simplement les fichiers plug-and-play des scènes à partir du serveur de scènes de FlightGear, ou utilisent [[Fr/TerraSync|TerraSync]] pour télécharger automatiquement les scènes à la demande. Mais il peut y avoir des cas où vous voudriez utiliser TerraGear pour générer vos propres fichiers terrain, plutôt que de télécharger les scènes standard de FlightGear.<br />
<br />
Par exemple, si vous utilisez [[WorldEditor]] pour modifier/améliorer les information concernant un taxiway/une aire de trafic d'un [[:Category:Airports|aéroport]], vous pourriez avoir envie de visualiser à quoi ressemblerait cet aéroport modifié dans les scènes avant de décider que les résultats vous conviennent. Peut-être que les scènes officielles sont trop détaillées pour votre machine un peu ancienne, et que vous voudriez construire un terrain avec un modèle numérique de d'élévation (DEM) de plus faible résolution, afin de diminuer le nombre de polygones et ainsi augmenter votre taux de rafraîchissement d'image. Soit vous avez une machine ultra-rapide, et vous voulez construire votre propre terrain avec des données vectorielles de plus haute résolution (vmap1, Tiger, osm) pour obtenir de meilleures routes/rivières. Pour toutes ces raisons, apprendre à utiliser TerraGear est une bonne idée.<br />
<br />
== Obtenir TerraGear ==<br />
Vous pouvez soit compiler TerraGear vous-même, ou bien télécharger un binaire pré-compilé, cette dernière démarche étant plus aisée et donc recommandée pour les débutants.<br />
<br />
* '''Option 1 - Télécharger TerraGear pré-compilé (recommandé aux débutants) sur Windows'''<br />
*# Téléchargez la dernière version de TerraGear sur le [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip Serveur de compilation de FlightGear].<br />
*# Créez ou choisissez un répertoire pour contenir les outils TerraGear. <br />
*# Dé-zippez le paquetage et déplacez les fichiers de <tt>archive/install/msvc100/TerraGear/bin</tt> dans un sous-répertoire nommé <tt>Terragear/</tt> dans le répertoire de base.<br />
<br />
* '''Option 1b - Télécharger les paquetages ppa pour Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compiler TerraGear à partir du code source, comme expliqué dans [[Fr/TerraGear#Compilation|cet article]].<br />
<br />
{{note|1=Vous pourriez avoir besoin du fichier <code>default_priorities.txt</code> qui peut être obtenu à partir du {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=dépôt Git}} ou à partir de l'archive téléchargée à partir du serveur de compilation (dans le sous-répertoire <code>archive/install/msvc100/TerraGear/share</code>). Voir [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 ce lien du forum] pour les détails.}}<br />
<br />
=== Interface graphique ===<br />
L'interface graphique [[TerraGear GUI]] est disponible pour ceux voudraient utiliser TerraGear sans avoir à connaître/utiliser les options de ligne de commande.<br />
<br />
== Utilisation de TerraGear ==<br />
Tout d'abord, choisissez les limites de la zone de scène que vous voulez construire, en termes de latitude et de longitude. Plus la zone à générer sera restreinte, plus la quantité de données et le temps CPU nécessaire seront limités. Par exemple, si vous voulez juste générer une nouvelle disposition d'aéroport à la position 12°3 Ouest et 34°4 Nord, la génération des scènes entre 34°N 12°O et 35°N 13°O sera suffisante. <br />
<br />
Notez la boîte de délimitation (longitudes et latitudes minimum et maximum) pour la scène que vous voulez générer. Rappelez-vous que Ouest et Sud sont négatifs - c'est-à-dire que 4° Ouest 10° Sud doit être -4, -10. Essayez de ne pas vous mélanger les pinceaux, sinon la scène ou l'aéroport que vous créez se retrouvera de l'autre côté de la planète !<br />
<br />
Vous aurez affaire avec différents types de données utilisant des formats variés. Créez un nouveau répertoire pour votre travail de scène. A l'intérieur de ce répertoire, créez les sous-répertoires suivants: <br />
<br />
; <code>data/</code>: Pour les données brutes et pré-calculées (par exemple, les fichiers d'élévation)<br />
; <code>output/</code>: Pour les fichiers de scènes que vous créerez<br />
; <code>work/</code>: Pour les données qui ont été calculez (par exemple par shape-decode) et qui sont prêtes à être intégrées dans la scène<br />
<br />
=== Obtenir et traiter les données ===<br />
Terragear utilise trois sortes d'informations différentes pour générer une scène :<br />
<br />
# L'élévation du terrain (fournie par SRTM)<br />
# L'emplacement et la disposition des aéroports (fournis par apt.dat ou un fichier .dat personnalisé) <br />
# Si une lat/lon donnée correspond à la mer, la terre, une ville, une forêt, un village, une route, un chemin de fer (fourni par VMAP0, [[CORINE]], etc. ou par des fichiers personnalisés de formes)<br />
<br />
Cet article décrit comment obtenir et traiter chacun de ces types de données dans l'ordre, et les fournir ensemble, pour que FlightGear les utilise. L'ordre de ces étapes est important. Par exemple, l'étape des données d'un aéroport a besoin des données d'élévation pour déterminer l'élévation des aéroports. Ainsi, vous commencerez par préparer les données d'élévation.<br />
<br />
{{caution|Pour l'inclusion dans les scènes officielles de FlightGear, toutes les données ''doivent'' provenir de sources compatibles avec la licence [[GNU GPL]]!}}<br />
<br />
==== Données d'élévation ====<br />
Les meilleures données d'élévation actuellement disponibles proviennent du projet Shuttle Radar Topography Mission (SRTM). Il y a deux types de données SRTM :<br />
* Données de haute précision (résolution 1-arc seconde), ou SRTM-1, pour les USA<br />
* Données de précision moindre (résolution 3-arc second), ou SRTM-3, pour le reste du monde.<br />
<br />
A partir de maintenant, nous supposerons que vous utilisez les données SRTM-3. Sauf mention contraire, le processus est identique pour SRTM-1.<br />
<br />
Vous pouvez télécharger les données appropriées à partir du site http://dds.cr.usgs.gov/srtm/version2_1/. Vous devrez récupérer tous les fichiers .hgt.zip couvrant la région qui vous intéresse. Selon la taille de votre scène, cela peut représenter un grand nombre de fichiers. Téléchargez les vers l'emplacement <tt>data/SRTM-1/</tt> (ou SRTM-3/SRTM-30 en fonction du type de données que vous téléchargez) dans votre répertoire de base. (Genapts recherche les données d'élévation parmi un ensemble de noms de répertoires prédéfinis dans son répertoire de travail. SRTM-30 est l'un d'eux, c'est le moins déroutant dans cette liste. Notez que, à compter du 31 juillet 2010, l'outil genapts prend également en compte l'existence de répertoires SRTM-1/SRTM-3. Si vous utilisez une version plus ancienne, pensez à fournir les répertoires en utilisant --dem-path).<br />
<br />
Maintenant que nous avons les données, nous devons les convertir pour qu'elles puissent servir à TerraGear. Tout d'abord, dézippez chacun des fichiers .hgt. Ensuite, ouvrez la ligne de commande (Sous Windows: Démarrer > Exécuter > <code>cmd.exe</code>) et placez-vous dans le répertoire de base (<code>cd .../.../TerraGear</code>).<br />
<br />
{{note|Selon [[TerraGear_Documentation]], hgtchop est remplacé par gdalchop.}}<br />
{{note|Pour les données SRTM-1, remplacez le <code>3</code> par un <code>1</code> dans le premier argument fourni à hgtchop}}<br />
{{tip|Si vous voulez créer un fichier batch, remplacez <code>%f</code> avec <code>%%f</code>, voir à ce sujet : [http://technet.microsoft.com/en-us/library/bb490909.aspx]}}<br />
<br />
Pour Windows :<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
ou<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
Pour Linux :<br />
for f in ${PWD}/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 "${f}" "${PWD}/work/SRTM-3"; done<br />
<br />
Maintenant, vous allez obtenir une quantité importante de fichiers .arr.gz dans votre répertoire work/SRTM-3/. Il nous faut les convertir au format .fit.gz. Utilisez à nouveau la ligne de commande avec<br />
{{note|L'espace et le point à la fin sont importants!}}<br />
<br />
Pour Windows :<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
Pour Linux :<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Données d'aéroports ====<br />
Maintenant que nous avons les données d'élévation, nous pouvons générer nos aéroports. Tout d'abord, créons un répertoire <code>data/airports/</code> et copions-y votre fichier apt.dat. Celui-ci peut-être soit directement celui de votre paquetage de donnés FlightGear (bien que vous devrez le dé-zipper), soit un fichier que vous auriez modifié avec [[WorldEditor]].<br />
<br />
La commande pour créer les aéroports est "genapts850". Lancez-la sans aucun arguments afin de visualiser les différentes options de ligne de commande.<br />
<br />
Si elle est simplement lancée avec un fichier apt.dat spécifié et le répertoire de travail, elle générera les agencements d'aéroports pour chaque aéroport contenu dans le fichier, ce qui peut être long. Vérifiez que l'entrée n'est pas le fichier apt.dat.gz, mais le fichier décompressé. Sinon genapts850 bloquera et ne produira aucune sortie.<br />
<br />
Si vous créez juste un seul aéroport, et que vous connaissez son identifiant OACI (par exemple [[Fr/Aéroport international de San Francisco|KSFO]], EGPH, EG32), utilisez le comme suit à partir du répertoire racine des scènes (c'est à dire à partir du répertoire parent de vos répertoires data, work et output). Si vous utilisez un fichier apt.dat contenant un seul aéroport, vous pouvez omettre le paramètre <code>--airport</code>. <br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --airport=<IDENTIFIANT_OACI_AEROPORT><br />
<br />
ou, si vous avez les données d'élévation disponible:<br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --dem-path=SRTM-3<br />
<br />
Si vous générez des scènes plus grandes, alors vous pouvez spécifier les longitudes et latitudes minimum et maximum.<br />
<br />
Genapts va créer deux sous-répertoires dans votre répertoire work:<br />
<br />
* <code>AirportArea/</code><br />
* <code>AirportObj/</code><br />
<br />
Ils contiennent les définitions des agencement de l'aéroport, et de tous les objets présents (par exemple les manches à air et balises).<br />
<br />
==== Données d'utilisation du sol ====<br />
Les dernières données que nous avons besoin de générer sont celles correspondant au type d'utilisation du sol. En général, elles proviennent du lot de données VMAP0 en tant que fichiers de formes en provenance du serveur de carte de la base de données des scènes, mais d'autres sources peuvent aussi être utilisées.<br />
<br />
Les données d'utilisation du sol peuvent être séparées en différents types :<br />
<br />
; Landmass: Sépare la terre de la mer. Ces données peuvent être utilisées comme un masque pour toutes les autres données. Les plus couramment utilisées sont le Landmass VMAP0, mais GSHHS peut également être utilisé. Pendant l'exécution de tg-construct avec l'argument <code>--ignore-landmass</code>, toutes les entrées des fichiers de formes seront tenues en compte, ainsi le masque de Landmass n'est alors plus nécessaire.<br />
; Land use data: Définit si une portion de terrain correspond à une forêt, une zone urbaine, du sable, de la lave, des glaciers, etc. Ce sont généralement des données VMAP0, définies en tant que polygones.<br />
; Line data: Comprend les lignes de chemins de fer, les rivières, les routes. Typiquement VMAP0, mais aussi Open Street Map pour les routes.<br />
; Point data: Est actuellement uniquement utilisé pour définir les villes.<br />
<br />
De loin, le moyen le plus facile pour obtenir ces données est de télécharger les fichiers de formes à partir du magnifique [http://mapserver.flightgear.org MapServer]. Le MapServer vous permet de télécharger les fichiers de formes pour chaque région de scènes sélectionnée. Cliquez sur le lien "Download Shapefiles" (ou allez directement à : http://mapserver.flightgear.org/download.psp). Entrez dans la boîte de délimitation de la scène que vous désirez générer, sélectionnez le type de données de fichier de formes que vous voulez, et cliquez sur download.<br />
<br />
Téléchargez chaque fichier-forme dans un répertoire séparé (!) <tt>data/shapefiles/...</tt>. Ainsi, pour v0_landmass, vous obtiendriez <tt>data/shapefiles/v0_landmass/v0_landmass.shp</tt>, etc.<br />
<br />
Vous pouvez charger ces fichiers-formes dans un éditeur SIG tel que [[QGIS]] ou GRASS pour les visualiser et les éditer. C'est une bonne idée pour vérifier que vous avez bien les bons fichiers ! Plus tard, vous pourrez expérimenter en remplaçant divers fichiers-formes avec d'autres versions (GSHHS pour la côte, OSM pour les routes, etc.).<br />
<br />
L'étape suivante décode les fichiers-formes vers le format TerraGear en utilisant la commande '''ogr-decode''' . <br />
<br />
Il y a trois arguments de ligne de commande importants pour ogr-decode :<br />
* le répertoire de destination pour les données décodées,<br />
* la localisation du répertoire de fichiers-formes,<br />
* le type de matériau.<br />
<br />
Chaque fichier-forme correspond avec un des types de matériau défini dans les fichiers materials.xml. La correspondance est assez évidente. Par exemple, v0_mixedcroppasturecover correspond à MixedCropPastureCover. Notez que les types de matériau sont sensibles à la casse, donc il est bon de se référer au fichier <tt>[[$FG ROOT]]/materials.xml</tt> pour vérifier. L'exception est v0_landmass, qui DOIT correspondre au type Default.<br />
<br />
En complément, il existe de nombreux arguments optionnels pour indiquer la largeur des données linéaires (pour les routes, les rivières, les voies de chemin de fer), quelle largeur utiliser pour les données de type point (pour les villes) et quelle est la plus grande longueur acceptable pour une ligne droite.<br />
<br />
Par exemple, pour décoder le fichier-forme v0_landmass, vous entrez la commande suivante :<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Landmass data/shapefiles/v0_landmass<br />
<br />
Pour créer des rivières de 10 mètres de large :<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
Pour générer des villes d'environ 1 kilomètre de diagonale :<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Lancez cette commande pour chaque fichier-forme du lot de données.<br />
<br />
== Générer les scènes ==<br />
Vous avez maintenant un répertoire de travail, avec des sous-répertoires comme :<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Landmass<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Nous pouvons maintenant générer les scènes en utilisant la commande fgfs-construct. Lancez la commande avec <code>--help</code> pour obtenir les informations d'utilisation. <br />
<br />
Nous devons définir :<br />
* Les répertoires de travail (--work-dir) et de sortie (--output-dir) .<br />
** '''Notez''', au sujet du répertoire de sortie : il doit pointer vers le répertoire <tt>Terrain/</tt>, sinon, les versions récentes FlightGear seront incapables de charger le terrain.<br />
* Le centre de la scène que nous voulons générer (--lat, --lon).<br />
* Le rayon (--xdist, --ydist) à partir duquel on génère.<br />
* Tous les répertoires de travail à inclure dans la scène.<br />
<br />
Par exemple :<br />
{{Pre2|<nowiki>fgfs-construct --work-dir=./work --output-dir=./output/Terrain --lon=55 --lat=60 --xdist=3 --ydist=3 AirportArea SRTM-3 AirportObj Stream Bog IrrCropPastureCover Town Lake Urban Landmass Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
Lorsque cette commande se termine, le répertoire de sortie contiendra un sous-répertoire scenery. Pointez vers lui en paramétrant [[$FG_SCENERY]] ou en utilisant l'option de ligne de commande --fg-scenery à fgfs, et testez votre nouvelle scène !<br />
<br />
== Un soucis ? ==<br />
Vous trouverez ci-dessous une liste de problèmes courants et leur solutions. Dans le doute, copiez/collez votre erreur dans Google. La plupart des problèmes (en particulier lors de la compilation de TerraGear) ont déjà été évoqués :<br />
<br />
* Crash de genapts. Quelquefois, genapts plante avec certains aéroports. Dans ce cas, essayez de le relancer avec l'argument --start-id pour démarrer à l'aéroport sur lequel il a planté, et l'argument --nudge pour essayer de remettre les calculs dans la bonne voie.<br />
* fgfs-construct tué. Le processus fgfs-construct peut se suicider s'il consomme trop de ressources système. L'augmentation des valeurs pour setrlimit dans src/BuildTiles/Main/main.cxx est la meilleure solution.<br />
* Les aéroports apparaissent au fond de trous, ou il y a des espaces entre les aéroports et la scène. Ceci arrive lorsque genapts est incapable de trouver la donnée d'élévation correcte, ou alors la donnée d'élévation a changé entre le lancement de genapts et celui de shape-decode. Essayez de générer un seul aéroport dans votre zone de scène en utilisant genapts, et visualisez la sortie. En particulier, soyez sûr que le répertoire work/SRTM-3 existe. <br />
* Seuls les aéroports apparaissent dans la scène. Il existe trois explications typiques :<br />
** vous n'avez pas téléchargé les fichiers-formes corrects de la zone;<br />
** vous n'avez pas lancé shape-decode sur le fichier-forme v0_landmass comme Default <br />
** vous n'avez pas inclus les répertoires corrects dans fgfs-construct. <br />
* La scène générée contient des données effacées des fichiers-formes. Si vous éditez des fichiers-formes, vous devez effacer le sous-répertoire work approprié avant de lancer shape-decode. Sinon, vos changements s'ajouteront à ceux qui existent déjà.<br />
* La scène entière est plate et au niveau de la mer. C'est généralement dû au fait que vous n'avez pas inclus les données d'élévation dans votre commande fgfs-construct. Assurez-vous qu'il existe un répertoire STRM-3 précisé dans la ligne de commande. <br />
* Tout terrain copie le matériel d'un fichier-forme. Vous avez probablement oublié de mettre chacun des fichiers-formes téléchargés dans un répertoire séparé à l'intérieur du répertoire Data/shapefiles. <br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement]]<br />
[[en:Using TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Fr/Utiliser_TerraGear&diff=106016Fr/Utiliser TerraGear2016-11-20T17:36:17Z<p>Puchacz: /* Données d'aéroports */</p>
<hr />
<div>[[File:Terragearprocesschart.png|thumb|Organigramme de TerraGear]]<br />
Le projet logiciel [[Fr/TerraGear|TerraGear]] participe au projet [[Fr/FlightGear|FlightGear]] en créant les fichiers utilisés par celui-ci pour représenter le relief et la texture de la Terre, ce qui comprend les aéroports, villes, champs, forêts, rivières, routes, etc. Le logiciel TerraGear lit des fichiers de données contenant l'élévation du sol, le positionnement et l'agencement des aéroports, les données géographiques d'occupation du sol, entre autres et produit les fichiers de scènes utilisés par Flightgear pour représenter la surface de la planète.<br />
<br />
Par simplicité et commodité, la plupart des utilisateurs de FlightGear téléchargent simplement les fichiers plug-and-play des scènes à partir du serveur de scènes de FlightGear, ou utilisent [[Fr/TerraSync|TerraSync]] pour télécharger automatiquement les scènes à la demande. Mais il peut y avoir des cas où vous voudriez utiliser TerraGear pour générer vos propres fichiers terrain, plutôt que de télécharger les scènes standard de FlightGear.<br />
<br />
Par exemple, si vous utilisez [[WorldEditor]] pour modifier/améliorer les information concernant un taxiway/une aire de trafic d'un [[:Category:Airports|aéroport]], vous pourriez avoir envie de visualiser à quoi ressemblerait cet aéroport modifié dans les scènes avant de décider que les résultats vous conviennent. Peut-être que les scènes officielles sont trop détaillées pour votre machine un peu ancienne, et que vous voudriez construire un terrain avec un modèle numérique de d'élévation (DEM) de plus faible résolution, afin de diminuer le nombre de polygones et ainsi augmenter votre taux de rafraîchissement d'image. Soit vous avez une machine ultra-rapide, et vous voulez construire votre propre terrain avec des données vectorielles de plus haute résolution (vmap1, Tiger, osm) pour obtenir de meilleures routes/rivières. Pour toutes ces raisons, apprendre à utiliser TerraGear est une bonne idée.<br />
<br />
== Obtenir TerraGear ==<br />
Vous pouvez soit compiler TerraGear vous-même, ou bien télécharger un binaire pré-compilé, cette dernière démarche étant plus aisée et donc recommandée pour les débutants.<br />
<br />
* '''Option 1 - Télécharger TerraGear pré-compilé (recommandé aux débutants) sur Windows'''<br />
*# Téléchargez la dernière version de TerraGear sur le [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip Serveur de compilation de FlightGear].<br />
*# Créez ou choisissez un répertoire pour contenir les outils TerraGear. <br />
*# Dé-zippez le paquetage et déplacez les fichiers de <tt>archive/install/msvc100/TerraGear/bin</tt> dans un sous-répertoire nommé <tt>Terragear/</tt> dans le répertoire de base.<br />
<br />
* '''Option 1b - Télécharger les paquetages ppa pour Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compiler TerraGear à partir du code source, comme expliqué dans [[Fr/TerraGear#Compilation|cet article]].<br />
<br />
{{note|1=Vous pourriez avoir besoin du fichier <code>default_priorities.txt</code> qui peut être obtenu à partir du {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=dépôt Git}} ou à partir de l'archive téléchargée à partir du serveur de compilation (dans le sous-répertoire <code>archive/install/msvc100/TerraGear/share</code>). Voir [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 ce lien du forum] pour les détails.}}<br />
<br />
=== Interface graphique ===<br />
L'interface graphique [[TerraGear GUI]] est disponible pour ceux voudraient utiliser TerraGear sans avoir à connaître/utiliser les options de ligne de commande.<br />
<br />
== Utilisation de TerraGear ==<br />
Tout d'abord, choisissez les limites de la zone de scène que vous voulez construire, en termes de latitude et de longitude. Plus la zone à générer sera restreinte, plus la quantité de données et le temps CPU nécessaire seront limités. Par exemple, si vous voulez juste générer une nouvelle disposition d'aéroport à la position 12°3 Ouest et 34°4 Nord, la génération des scènes entre 34°N 12°O et 35°N 13°O sera suffisante. <br />
<br />
Notez la boîte de délimitation (longitudes et latitudes minimum et maximum) pour la scène que vous voulez générer. Rappelez-vous que Ouest et Sud sont négatifs - c'est-à-dire que 4° Ouest 10° Sud doit être -4, -10. Essayez de ne pas vous mélanger les pinceaux, sinon la scène ou l'aéroport que vous créez se retrouvera de l'autre côté de la planète !<br />
<br />
Vous aurez affaire avec différents types de données utilisant des formats variés. Créez un nouveau répertoire pour votre travail de scène. A l'intérieur de ce répertoire, créez les sous-répertoires suivants: <br />
<br />
; <code>data/</code>: Pour les données brutes et pré-calculées (par exemple, les fichiers d'élévation)<br />
; <code>output/</code>: Pour les fichiers de scènes que vous créerez<br />
; <code>work/</code>: Pour les données qui ont été calculez (par exemple par shape-decode) et qui sont prêtes à être intégrées dans la scène<br />
<br />
=== Obtenir et traiter les données ===<br />
Terragear utilise trois sortes d'informations différentes pour générer une scène :<br />
<br />
# L'élévation du terrain (fournie par SRTM)<br />
# L'emplacement et la disposition des aéroports (fournis par apt.dat ou un fichier .dat personnalisé) <br />
# Si une lat/lon donnée correspond à la mer, la terre, une ville, une forêt, un village, une route, un chemin de fer (fourni par VMAP0, [[CORINE]], etc. ou par des fichiers personnalisés de formes)<br />
<br />
Cet article décrit comment obtenir et traiter chacun de ces types de données dans l'ordre, et les fournir ensemble, pour que FlightGear les utilise. L'ordre de ces étapes est important. Par exemple, l'étape des données d'un aéroport a besoin des données d'élévation pour déterminer l'élévation des aéroports. Ainsi, vous commencerez par préparer les données d'élévation.<br />
<br />
{{caution|Pour l'inclusion dans les scènes officielles de FlightGear, toutes les données ''doivent'' provenir de sources compatibles avec la licence [[GNU GPL]]!}}<br />
<br />
==== Données d'élévation ====<br />
Les meilleures données d'élévation actuellement disponibles proviennent du projet Shuttle Radar Topography Mission (SRTM). Il y a deux types de données SRTM :<br />
* Données de haute précision (résolution 1-arc seconde), ou SRTM-1, pour les USA<br />
* Données de précision moindre (résolution 3-arc second), ou SRTM-3, pour le reste du monde.<br />
<br />
A partir de maintenant, nous supposerons que vous utilisez les données SRTM-3. Sauf mention contraire, le processus est identique pour SRTM-1.<br />
<br />
Vous pouvez télécharger les données appropriées à partir du site http://dds.cr.usgs.gov/srtm/version2_1/. Vous devrez récupérer tous les fichiers .hgt.zip couvrant la région qui vous intéresse. Selon la taille de votre scène, cela peut représenter un grand nombre de fichiers. Téléchargez les vers l'emplacement <tt>data/SRTM-1/</tt> (ou SRTM-3/SRTM-30 en fonction du type de données que vous téléchargez) dans votre répertoire de base. (Genapts recherche les données d'élévation parmi un ensemble de noms de répertoires prédéfinis dans son répertoire de travail. SRTM-30 est l'un d'eux, c'est le moins déroutant dans cette liste. Notez que, à compter du 31 juillet 2010, l'outil genapts prend également en compte l'existence de répertoires SRTM-1/SRTM-3. Si vous utilisez une version plus ancienne, pensez à fournir les répertoires en utilisant --dem-path).<br />
<br />
Maintenant que nous avons les données, nous devons les convertir pour qu'elles puissent servir à TerraGear. Tout d'abord, dézippez chacun des fichiers .hgt. Ensuite, ouvrez la ligne de commande (Sous Windows: Démarrer > Exécuter > <code>cmd.exe</code>) et placez-vous dans le répertoire de base (<code>cd .../.../TerraGear</code>).<br />
<br />
{{note|Selon [[TerraGear_Documentation]], hgtchop est remplacé par gdalchop.}}<br />
{{note|Pour les données SRTM-1, remplacez le <code>3</code> par un <code>1</code> dans le premier argument fourni à hgtchop}}<br />
{{tip|Si vous voulez créer un fichier batch, remplacez <code>%f</code> avec <code>%%f</code>, voir à ce sujet : [http://technet.microsoft.com/en-us/library/bb490909.aspx]}}<br />
<br />
Pour Windows :<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
ou<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
Pour Linux :<br />
for f in ${PWD}/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 "${f}" "${PWD}/work/SRTM-3"; done<br />
<br />
Maintenant, vous allez obtenir une quantité importante de fichiers .arr.gz dans votre répertoire work/SRTM-3/. Il nous faut les convertir au format .fit.gz. Utilisez à nouveau la ligne de commande avec<br />
{{note|L'espace et le point à la fin sont importants!}}<br />
<br />
Pour Windows :<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
Pour Linux :<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Données d'aéroports ====<br />
Maintenant que nous avons les données d'élévation, nous pouvons générer nos aéroports. Tout d'abord, créons un répertoire <code>data/airports/</code> et copions-y votre fichier apt.dat. Celui-ci peut-être soit directement celui de votre paquetage de donnés FlightGear (bien que vous devrez le dé-zipper), soit un fichier que vous auriez modifié avec [[WorldEditor]].<br />
<br />
La commande pour créer les aéroports est "genapts850". Lancez-la sans aucun arguments afin de visualiser les différentes options de ligne de commande.<br />
<br />
Si elle est simplement lancée avec un fichier apt.dat spécifié et le répertoire de travail, elle générera les agencements d'aéroports pour chaque aéroport contenu dans le fichier, ce qui peut être long. Vérifiez que l'entrée n'est pas le fichier apt.dat.gz, mais le fichier décompressé. Sinon genapts850 bloquera et ne produira aucune sortie.<br />
<br />
Si vous créez juste un seul aéroport, et que vous connaissez son identifiant OACI (par exemple [[Fr/Aéroport international de San Francisco|KSFO]], EGPH, EG32), utilisez le comme suit à partir du répertoire racine des scènes (c'est à dire à partir du répertoire parent de vos répertoires data, work et output). Si vous utilisez un fichier apt.dat contenant un seul aéroport, vous pouvez omettre le paramètre <code>--airport</code>. <br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --airport=<IDENTIFIANT_OACI_AEROPORT><br />
<br />
ou, si vous avez les données d'élévation disponible:<br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --dem-path=SRTM-3<br />
<br />
Si vous générez des scènes plus grandes, alors vous pouvez spécifier les longitudes et latitudes minimum et maximum.<br />
<br />
Genapts va créer deux sous-répertoires dans votre répertoire work:<br />
<br />
* <code>AirportArea/</code><br />
* <code>AirportObj/</code><br />
<br />
Ils contiennent les définitions des agencement de l'aéroport, et de tous les objets présents (par exemple les manches à air et balises).<br />
<br />
==== Données d'utilisation du sol ====<br />
Les dernières données que nous avons besoin de générer sont celles correspondant au type d'utilisation du sol. En général, elles proviennent du lot de données VMAP0 en tant que fichiers de formes en provenance du serveur de carte de la base de données des scènes, mais d'autres sources peuvent aussi être utilisées.<br />
<br />
Les données d'utilisation du sol peuvent être séparées en différents types :<br />
<br />
* '''Landmass :''' sépare la terre de la mer. Ces données sont utilisées comme masque pour toutes les autres données. Les plus couramment utilisées sont le Landmass VMAP0, mais GSHHS peut également être utilisé.<br />
* '''Land use data :''' définit si une portion de terrain correspond à une forêt, une zone urbaine, du sable, de la lave, des glaciers, etc. Ce sont généralement données VMAP0 définies en tant que polygones.<br />
* '''Line data :''' comprend les lignes de chemins de fer, les rivières, les routes. Typiquement VMAP0, mais aussi OpenStreetMap pour les routes.<br />
* '''Point data :''' est actuellement uniquement utilisé pour définir les villes.<br />
<br />
De loin, le moyen le plus facile pour obtenir ces données est de télécharger à partir du magnifique [http://mapserver.flightgear.org MapServer] les fichiers formes pour une zone de scène donnée. Cliquez sur le lien "Download Shapefiles" (ou allez directement à : http://mapserver.flightgear.org/download.psp). Entrez dans la boîte de délimitation de la scène que vous désirez générer, sélectionnez le type de données de fichier-formes que vous voulez, et cliquez sur '''download'''. Pour les scènes de base, prenez tout ce qui est listé sous VMap0 (c'est-à-dire utilisant le préfixe v0_).<br />
<br />
Téléchargez chaque fichier-forme dans un répertoire séparé (!) <tt>data/shapefiles/...</tt>. Ainsi, pour v0_landmass, vous obtiendriez <tt>data/shapefiles/v0_landmass/v0_landmass.shp</tt>, etc.<br />
<br />
Vous pouvez charger ces fichiers-formes dans un éditeur SIG tel que [[QGIS]] ou GRASS pour les visualiser et les éditer. C'est une bonne idée pour vérifier que vous avez bien les bons fichiers ! Plus tard, vous pourrez expérimenter en remplaçant divers fichiers-formes avec d'autres versions (GSHHS pour la côte, OSM pour les routes, etc.).<br />
<br />
L'étape suivante décode les fichiers-formes vers le format TerraGear en utilisant la commande '''ogr-decode''' . <br />
<br />
Il y a trois arguments de ligne de commande importants pour ogr-decode :<br />
* le répertoire de destination pour les données décodées,<br />
* la localisation du répertoire de fichiers-formes,<br />
* le type de matériau.<br />
<br />
Chaque fichier-forme correspond avec un des types de matériau défini dans les fichiers materials.xml. La correspondance est assez évidente. Par exemple, v0_mixedcroppasturecover correspond à MixedCropPastureCover. Notez que les types de matériau sont sensibles à la casse, donc il est bon de se référer au fichier <tt>[[$FG ROOT]]/materials.xml</tt> pour vérifier. L'exception est v0_landmass, qui DOIT correspondre au type Default.<br />
<br />
En complément, il existe de nombreux arguments optionnels pour indiquer la largeur des données linéaires (pour les routes, les rivières, les voies de chemin de fer), quelle largeur utiliser pour les données de type point (pour les villes) et quelle est la plus grande longueur acceptable pour une ligne droite.<br />
<br />
Par exemple, pour décoder le fichier-forme v0_landmass, vous entrez la commande suivante :<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Landmass data/shapefiles/v0_landmass<br />
<br />
Pour créer des rivières de 10 mètres de large :<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
Pour générer des villes d'environ 1 kilomètre de diagonale :<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Lancez cette commande pour chaque fichier-forme du lot de données.<br />
<br />
== Générer les scènes ==<br />
Vous avez maintenant un répertoire de travail, avec des sous-répertoires comme :<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Landmass<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Nous pouvons maintenant générer les scènes en utilisant la commande fgfs-construct. Lancez la commande avec <code>--help</code> pour obtenir les informations d'utilisation. <br />
<br />
Nous devons définir :<br />
* Les répertoires de travail (--work-dir) et de sortie (--output-dir) .<br />
** '''Notez''', au sujet du répertoire de sortie : il doit pointer vers le répertoire <tt>Terrain/</tt>, sinon, les versions récentes FlightGear seront incapables de charger le terrain.<br />
* Le centre de la scène que nous voulons générer (--lat, --lon).<br />
* Le rayon (--xdist, --ydist) à partir duquel on génère.<br />
* Tous les répertoires de travail à inclure dans la scène.<br />
<br />
Par exemple :<br />
{{Pre2|<nowiki>fgfs-construct --work-dir=./work --output-dir=./output/Terrain --lon=55 --lat=60 --xdist=3 --ydist=3 AirportArea SRTM-3 AirportObj Stream Bog IrrCropPastureCover Town Lake Urban Landmass Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
Lorsque cette commande se termine, le répertoire de sortie contiendra un sous-répertoire scenery. Pointez vers lui en paramétrant [[$FG_SCENERY]] ou en utilisant l'option de ligne de commande --fg-scenery à fgfs, et testez votre nouvelle scène !<br />
<br />
== Un soucis ? ==<br />
Vous trouverez ci-dessous une liste de problèmes courants et leur solutions. Dans le doute, copiez/collez votre erreur dans Google. La plupart des problèmes (en particulier lors de la compilation de TerraGear) ont déjà été évoqués :<br />
<br />
* Crash de genapts. Quelquefois, genapts plante avec certains aéroports. Dans ce cas, essayez de le relancer avec l'argument --start-id pour démarrer à l'aéroport sur lequel il a planté, et l'argument --nudge pour essayer de remettre les calculs dans la bonne voie.<br />
* fgfs-construct tué. Le processus fgfs-construct peut se suicider s'il consomme trop de ressources système. L'augmentation des valeurs pour setrlimit dans src/BuildTiles/Main/main.cxx est la meilleure solution.<br />
* Les aéroports apparaissent au fond de trous, ou il y a des espaces entre les aéroports et la scène. Ceci arrive lorsque genapts est incapable de trouver la donnée d'élévation correcte, ou alors la donnée d'élévation a changé entre le lancement de genapts et celui de shape-decode. Essayez de générer un seul aéroport dans votre zone de scène en utilisant genapts, et visualisez la sortie. En particulier, soyez sûr que le répertoire work/SRTM-3 existe. <br />
* Seuls les aéroports apparaissent dans la scène. Il existe trois explications typiques :<br />
** vous n'avez pas téléchargé les fichiers-formes corrects de la zone;<br />
** vous n'avez pas lancé shape-decode sur le fichier-forme v0_landmass comme Default <br />
** vous n'avez pas inclus les répertoires corrects dans fgfs-construct. <br />
* La scène générée contient des données effacées des fichiers-formes. Si vous éditez des fichiers-formes, vous devez effacer le sous-répertoire work approprié avant de lancer shape-decode. Sinon, vos changements s'ajouteront à ceux qui existent déjà.<br />
* La scène entière est plate et au niveau de la mer. C'est généralement dû au fait que vous n'avez pas inclus les données d'élévation dans votre commande fgfs-construct. Assurez-vous qu'il existe un répertoire STRM-3 précisé dans la ligne de commande. <br />
* Tout terrain copie le matériel d'un fichier-forme. Vous avez probablement oublié de mettre chacun des fichiers-formes téléchargés dans un répertoire séparé à l'intérieur du répertoire Data/shapefiles. <br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement]]<br />
[[en:Using TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Using_TerraGear&diff=106015Using TerraGear2016-11-20T17:36:03Z<p>Puchacz: /* Airport data */</p>
<hr />
<div>{{Out of date}}<br />
<br />
[[File:Terragearprocesschart.png|thumb|TerraGear Process Flow Chart]]<br />
The [[TerraGear]] software project supports [[FlightGear]] by creating the files used by FlightGear to represent the elevation and texture of the earth, including airports, cities, fields, forests, rivers, roads and so on. The TerraGear software reads data files containing ground elevation, airport locations and layouts, geographical land-cover data, and more, and produces the scenery files used by FlightGear to represent the terrain of the world.<br />
<br />
For simplicity and convenience, most FlightGear users simply download the plug-and-play scenery files from the FlightGear scenery server, or use [[TerraSync]] to automatically download scenery as needed. But there is a variety of reasons you might want to use TerraGear to produce your own terrain files, rather than downloading the standard FlightGear scenery. <br />
<br />
For instance, if you use [[WorldEditor]] to modify/improve information about an [[:Category:Airports|airport]]'s taxiway/apron layout, you might wish to see how that modified airport would look in the scenery before deciding you're happy with the results. 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-resolution vector data (vmap1, Tiger, osm) to get better roads/streams. For all these reasons, learning how to use TerraGear is a good idea.<br />
<br />
== Obtaining TerraGear ==<br />
You can either build TerraGear yourself, or download a pre-compiled binary. The later is the easiest and advised for starters.<br />
<br />
* '''Option 1a - Download TerraGear pre-compiled (recommended for beginners) on Windows'''<br />
*# Download the latest TerraGear build from the [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip FlightGear Build Server].<br />
*# Create or choose a directory to hold the TerraGear tools. <br />
*# Unzip the package and move the files from <code>archive/install/msvc100/TerraGear/bin</code> into a sub-directory named <code>Terragear/</code> in the base directory.<br />
<br />
* '''Option 1b - Download ppa packages for Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compile TerraGear from source code''' as explained in [[Building TerraGear|this article]].<br />
<br />
{{note|1=You might need <code>default_priorities.txt</code> from the {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=git repository}} or from the archive downloaded from the build server (in the <code>archive/install/msvc100/TerraGear/share</code> subdirectory). See [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 this forum thread] for details.}}<br />
<br />
=== GUI tool ===<br />
A [[TerraGear GUI]] is available for those that would like to use TerraGear without knowing/using the command line options.<br />
<br />
== Using TerraGear ==<br />
First, choose the boundaries for the area of scenery you want to build, in terms of latitude and longitude. The smaller the area of scenery you generate, the smaller the amount of data you will need, and the less CPU time it will take. For example, if you are just interested in generating a new airport layout at 12.3W 34.4N, then simply generating the scenery between 12W 34N and 13W 35N would be sufficient. <br />
<br />
Write down the bounding box (minimum and maximum longitude and latitude) for the scenery you want to generate. Remember that West and South are negative - in essence 4W 10S would be -4, -10. Try not to get mixed up, otherwise you'll end up generating scenery or airports on the other side of the planet! <br />
<br />
You'll be dealing with multiple different types of data in various formats. Create a new directory for your scenery work. Within that directory, create the following sub-directories: <br />
<br />
; <code>data/</code>: For raw and pre-processed data (eg elevation files) <br />
; <code>output/</code>: For the scenery files you will create <br />
; <code>work/</code>: For data that has been processed (eg by shape-decode) and is ready to be munged into scenery <br />
<br />
=== Obtaining and processing data ===<br />
TerraGear uses three different kinds of information to generate scenery:<br />
<br />
# The elevation of the land (provided by SRTM) <br />
# The location and layout of airports (provided by apt.dat or a custom .dat) <br />
# Whether a given lat/lon is sea, land, city, forest, town, road, railway (provided by VMAP0, [[CORINE]] etc. or custom shapefiles) <br />
<br />
This article describes how obtain and process each of these types of data in order, and bring it together for use by FlightGear. The order of these steps is important. For example, the airport data step needs the elevation data to determine the elevation of the airports and thus you should start with preparing elevation data.<br />
<br />
{{caution|For inclusion in the official FlightGear scenery, all data '''must''' come from [[GNU GPL]] compatible sources!}}<br />
<br />
==== Elevation data ====<br />
The best worldwide elevation data currently available is from the Shuttle Radar Topography Mission (SRTM). There are two types of SRTM data: <br />
* Highly accurate 1-arcsecond resolution data, known as SRTM-1, for the USA <br />
* Less accurate 3-arcsecond resolution data, known as SRTM-3, for the rest of the world. <br />
From now on, we'll assume you are using SRTM-3 data. Unless otherwise noted, the process for SRTM-1 is identical.<br />
<br />
You can download the appropriate data from http://dds.cr.usgs.gov/srtm/version2_1/. You want all .hgt.zip files covering your region of interest. Depending on the size of your scenery, there may be quite a few. Download them to <code>data/SRTM-1/</code> (or SRTM-3/SRTM-30 depending on the type you downloaded) in your base directory. (Genapts looks for a few known, hardcoded elevation data directories in its working directory. SRTM-30 is one of them and this is the least confusing in that list. Note: W.E.F. 31st July 2010, the genapts tool now also looks for SRTM-1/SRTM-3 directories. If you are using an older version, please supply the directories using --dem-path).<br />
<br />
Now we've got the data, we need to convert it into something of use to TerraGear. First, you need to unzip each of the .hgt files. After that, open the commandline (Windows: Start > Run > <code>cmd.exe</code>) and change into the base directory (<code>cd .../.../TerraGear</code>).<br />
<br />
{{note|According to [[TerraGear_Documentation]], hgtchop is superseded by gdalchop.}}<br />
{{note|For SRTM-1 data, replace the <code>3</code> by a <code>1</code> in the first argument to hgtchop}}<br />
{{tip|If you want to create a batch-file, replace <code>%f</code> with <code>%%f</code>, see [http://technet.microsoft.com/en-us/library/bb490909.aspx]}}<br />
<br />
For Windows:<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
or<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
For Linux:<br />
for f in ${PWD}/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 "${f}" "${PWD}/work/SRTM-3"; done<br />
<br />
Now you will get a lot of .arr.gz files in your work/SRTM-3/ directory. We need to convert these to the .fit.gz format. Run the commandline again with<br />
<br />
{{note|The space and dot at the and are important!}}<br />
<br />
For Windows:<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
For Linux:<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Airport data ====<br />
Now we've got elevation data, we can generate our airports. First, create a <code>data/airports/</code> directory and copy in your apt.dat file. This may be direct from your FlightGear data package (though you'll need to unzip it), or it may be one that you've modified with [[WorldEditor]]. <br />
<br />
The command to create airports is "genapts850". Run it without any arguments to see the various command-line options. <br />
<br />
If it is simply run with a specified apt.dat and work directory, it will generate airport layouts for every airport in the file, which can take a long time. Make sure the input is not the apt.dat.gz, but an uncompressed file. Otherwise genapts850 will block and not produce any output.<br />
<br />
If you are just creating a single airport and you know the ICAO ID (for example [[San Francisco International Airport|KSFO]], EGPH or EG32), use it as follows from your root scenery directory (in essence the directory above your data, work and output directories). If you use an apt.dat file with one single airport in it you should omit the <code>--airport</code> parameter. <br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --airport=<AIRPORT_ID><br />
<br />
or, if you have elevation data available:<br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --dem-path=SRTM-3<br />
<br />
If you are generating a larger set of scenery, then you can specify the minimum and maximum longitude and latitude. <br />
<br />
Genapts will create two sub-directories in your work directory:<br />
<br />
* <code>AirportArea/</code><br />
* <code>AirportObj/</code><br />
<br />
These contain the definitions of the airport layout and any objects present (e.g. windsocks and beacons).<br />
<br />
==== Landuse data ====<br />
The final piece of data we need to generate is the landuse data. In general, this is taken from the VMAP0 dataset as shapefiles from the scenery database mapserver, but other sources can also be used.<br />
<br />
The landuse data can be split into a number of different types:<br />
<br />
; Landmass: Separates the land from the sea. It can be used as a mask for all other data. The most commonly used is the VMAP0 Landmass, but GSHHS can also be used. When running tg-construct with <code>--ignore-landmass</code>, all input shapefiles will be taken into consideration, so no landmass mask is required then.<br />
; Land use data: Defines whether a piece of land is forest, urban, sand, lava, glacier etc. These are usually VMAP0 data, defined as polygons.<br />
; Line data: Includes railroads, streams, roads. Typically VMAP0, but also Open Street Map for roads.<br />
; Point data: Is currently only used for defining towns.<br />
<br />
By far the easiest way to get this data is to download shapefiles from the wonderful [http://mapserver.flightgear.org MapServer]. The MapServer lets you download the shapefiles for any selected scenery area. Click on the "Download Shapefiles" link (or go direct: http://mapserver.flightgear.org/download.psp). Enter in the bounding box of the scenery you want to generate, select the type of shapefile data you want, and click download. <br />
<br />
==== Layers ====<br />
<br />
; <code>v0</code>: Global coverage, low detail. This is "the last resort", but unfortunately it is the only layer that covers the entire world.<br />
; <code>cs</code>: It is v0 with some contributions someone did in the past. Get this instead of v0.<br />
; <code>v1</code>: Only parts of some countries available, higher detail than v0.<br />
; <code>clc06</code>: European '''only'''. Very high detail, this is the preferred choice for an European country.<br />
; <code>osm</code>: Global coverage, high resolution but very low detail.<br />
: This means: if you are interested in an area out of Europe and forests are defined in OpenStreetMaps for your area, this is going to be the best data source. If forests are not defined, you will get a dull, neverending DEFAULT landclass. OSM provides the best coastline and I encourage you to use this coastline even in Europe. [http://forum.flightgear.org/viewtopic.php?f=5&t=25549&sid=d501cb651ef9e34ca9dc8fae429d51ab&p=234002#p234002]<br />
<br />
{{caution|Make sure each shape file is in its own directory whether you download shape files or create your own otherwise the ogrDecode step will fail.}}<br />
Download each shapefile into a seperate (!) <code>data/shapefiles/...</code> directory. So, for v0_landmass, you would end up with <code>data/shapefiles/v0_landmass/v0_landmass.shp</code> etc.<br />
<br />
You can load these shapefiles into a GIS editor such as [[QGIS]] or GRASS to view and edit. This is a good idea to verify you have the correct files! Later on, you can experiment with replacing various shapefiles with other versions (GSHHS for coastline, OSM for roads etc.).<br />
<br />
The next step is to decode the shape-files into TerraGear format using the '''ogr-decode''' command. <br />
<br />
There are three important command-line arguments for ogr-decode:<br />
* the destination directory for the decoded data<br />
* the location of the shapefile's directory<br />
* the material type<br />
<br />
Each shape-file corresponds with one of the material types defined in the materials.xml files. The mapping is pretty obvious. For example, <code>v0_mixedcroppasturecover</code> maps to <code>MixedCropPastureCover</code>. Note that the material types are case-sensitive, so it is a good idea to refer to the <code>[[$FG_ROOT]]/Materials/default/materials.xml</code> file (<code>[[$FG ROOT]]/materials.xml</code> in FlightGear 2.6.0 and older) to hand so you can check. The exception is landmass, which - when used - MUST be mapped onto the type Default.<br />
<br />
Additionally, there are a number of optional arguments, to indicate the width of line data (for roads, streams, railways), how large to make point data (for towns) and how long the longest straight line is allowed to be.<br />
<br />
For example, to decode the <code>v0_landmass</code> shapefile, you use the following command:<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Default data/shapefiles/v0_landmass<br />
<br />
To create streams of width 10 metres<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
To generate some towns about 1km across<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Run this command for each shapefile in the set.<br />
<br />
== Generating scenery ==<br />
You will now have a work directory, with subdirectories like:<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: Default<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Now we can actually generate the scenery. This is done by the tg-construct command. Run the command with <code>--help</code> to get usage information. <br />
<br />
We need to define:<br />
* The work (<code>--work-dir</code>) and output (<code>--output-dir</code>) directories.<br />
* The center of the scenery we want to generate (<code>--lat</code> and <code>--lon</code>).<br />
* The radius (<code>--xdist</code> and <code>--ydist</code>) from which to generate.<br />
* All the work directories to include in the scenery.<br />
<br />
{{note|The output directory must point to a <code>Terrain/</code> directory, else recent FlightGear versions will be unable to load the terrain.}}<br />
<br />
For example:<br />
{{Pre2|<nowiki>tg-construct --work-dir=./work --output-dir=./output/Terrain --min-lon=55 --max-lon=57 --min-lat=60 --max-lat=62 AirportArea SRTM-3 AirportObj Default Stream Bog IrrCropPastureCover Town Lake Urban Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
When this finishes, the output directory will contain a scenery sub-tree. Point to it by setting either [[$FG_SCENERY]] or by using the <code>--fg-scenery</code> command-line option to fgfs, and give your new scenery a try!<br />
<br />
== Troubleshooting ==<br />
Below is a list of common problems and solutions. If in doubt - Google it. Many problems (particularly when compiling TerraGear) have been hit before: <br />
<br />
* Crashes in genapts. Sometimes genapts will crash when dealing with a particular airport. In that case, try running it again with the <code>--start-id</code> argument to start at the airport it failed on, and the <code>--nudge</code> argument which tries to nudge the calculations in the right direction. <br />
* tg-construct killed. The tg-construct process may kill itself if it is using too many system resources. Increasing the values for <code>setrlimit</code> in <code>src/BuildTiles/Main/main.cxx</code> is the best solution. <br />
* tg-construct silently stops immediately without an error and nothing goes to the "output" directory: make sure that lon/lat values correspond to tiles boundaries. See [[Tile Index Scheme]]<br />
* Airports appear in the bottom of holes, or there are spaces between the airports and the scenery. This typically happens when genapts is unable to find the correct elevation data, or the elevation data changed between running genapts and shape-decode. Try generating a single airport in your scenery area using genapts, and look at the output. In particular, make sure there is a work/SRTM-3 directory. <br />
* Only the airports appear in the scenery. There are three typical causes for this: <br />
** You didn't download the correct shapefiles for the area. <br />
** You haven't run shape-decode on the <code>v0_landmass</code> shapefile as Default <br />
** You didn't include the correct directories in tg-construct. <br />
* Generate scenery includes data removed from the shapefiles. If you are editing shapefiles, you need to delete the appropriate work subdirectory before running shape-decode. Otherwise your changes will be in addition to those already present. <br />
* All the scenery is flat and at sea-level. Typically this is because you didn't include any elevation data in your tg-construct command. Make sure there's a STRM-3 directory included in the command-line. <br />
* All terrain copies the material of a certain shapefile. You have probably forgotten to put each of the downloaded shapefiles in a seperate directory inside the Data/shapefiles directory.<br />
* genapts850 never passes the stage "Adding airport <ICAO> to parse list": did you unzip <code>apt.dat.gz</code>?<br />
<br />
== General comments from forum discussion ==<br />
{{cquote|f-ojac, you are right, the parameters used in scenery 2.0 were "-e 5 -x 20000" according to the wiki. I don't know why I had the impression these parameters were not public. In any case, it does not matter because using the same parameters will create closer results, but they are not guaranteed to be the same.<br />
<br />
The parameters used to create scenery 2,0 seem to be:<br />
<br />
-m ??: the minimum number of vertices in a tile. In FG, any number bellow 100 (and probably, any number below 1000) will do. I don't think there is any surface on the world perfectly flat for several kilometers. The default value is 50 and I'm sure is ok for any normal use.<br />
-e 5: the max allowed error for elevation, in meters. That is: if terrafit calculates a simplification of the terrain where all points are at most this distance from the real elevation, no more vertices are created. The default value is 40 meters: a point may have an elevation error up to 40m (~100ft) High values for this parameter create less detailed mountains and smaller (in disk size) and more efficient (in FPS) terrain.<br />
-x 20000: the max number of vertices in a tile. If this number of vertices is reached, terrafit stop regardless the max error of the vertices. The default value is 1000<br />
<br />
Keep in mind you can set values that do not make sense:<br />
<br />
* "-e 1 -x 100" does not make sense because it is going to be impossible to calculate errors less than 1 meters using only 100 vertices. The max number of vertices will be reached always and the max error will be probably ignored.<br />
* "-e 300 -x 20000" does not make sense, tiles are going to use for sure much less vertices than 20,000 because you are allowing huge elevation errors.<br />
<br />
If you want an efficient scenery (less vertices), use the default values "-e 40 -x 1000". If you want more accurate elevation at the cost of disk space and FPS, use values similar to scenery 2.0 ("-e 5 -x 20000") Anything in the middle will produce performance and disk use in the middle.<ref>{{cite web |url=http://forum.flightgear.org/viewtopic.php?f=5&t=24681#p225363 <br />
|title=Re: Terrasync Help (surprinsingly!) :)<br />
|author=ludomotico |date= Mon Nov 24, 2014 4:28 am}}</ref>|ludomotico}}<br />
<br />
<references/><br />
<br />
== Related content ==<br />
* [[Howto:Create custom terrain]], editing/making terrain data.<br />
* [[TerraGear CORINE]], building terrain from CORINE data.<br />
* [[TerraGear Documentation]], using TerraGear details.<br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement|TerraGear, Using]]<br />
<br />
[[fr:Utiliser TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Fr/Utiliser_TerraGear&diff=105994Fr/Utiliser TerraGear2016-11-19T12:57:31Z<p>Puchacz: </p>
<hr />
<div>[[File:Terragearprocesschart.png|thumb|Organigramme de TerraGear]]<br />
Le projet logiciel [[Fr/TerraGear|TerraGear]] participe au projet [[Fr/FlightGear|FlightGear]] en créant les fichiers utilisés par celui-ci pour représenter le relief et la texture de la Terre, ce qui comprend les aéroports, villes, champs, forêts, rivières, routes, etc. Le logiciel TerraGear lit des fichiers de données contenant l'élévation du sol, le positionnement et l'agencement des aéroports, les données géographiques d'occupation du sol, entre autres et produit les fichiers de scènes utilisés par Flightgear pour représenter la surface de la planète.<br />
<br />
Par simplicité et commodité, la plupart des utilisateurs de FlightGear téléchargent simplement les fichiers plug-and-play des scènes à partir du serveur de scènes de FlightGear, ou utilisent [[Fr/TerraSync|TerraSync]] pour télécharger automatiquement les scènes à la demande. Mais il peut y avoir des cas où vous voudriez utiliser TerraGear pour générer vos propres fichiers terrain, plutôt que de télécharger les scènes standard de FlightGear.<br />
<br />
Par exemple, si vous utilisez [[WorldEditor]] pour modifier/améliorer les information concernant un taxiway/une aire de trafic d'un [[:Category:Airports|aéroport]], vous pourriez avoir envie de visualiser à quoi ressemblerait cet aéroport modifié dans les scènes avant de décider que les résultats vous conviennent. Peut-être que les scènes officielles sont trop détaillées pour votre machine un peu ancienne, et que vous voudriez construire un terrain avec un modèle numérique de d'élévation (DEM) de plus faible résolution, afin de diminuer le nombre de polygones et ainsi augmenter votre taux de rafraîchissement d'image. Soit vous avez une machine ultra-rapide, et vous voulez construire votre propre terrain avec des données vectorielles de plus haute résolution (vmap1, Tiger, osm) pour obtenir de meilleures routes/rivières. Pour toutes ces raisons, apprendre à utiliser TerraGear est une bonne idée.<br />
<br />
== Obtenir TerraGear ==<br />
Vous pouvez soit compiler TerraGear vous-même, ou bien télécharger un binaire pré-compilé, cette dernière démarche étant plus aisée et donc recommandée pour les débutants.<br />
<br />
* '''Option 1 - Télécharger TerraGear pré-compilé (recommandé aux débutants) sur Windows'''<br />
*# Téléchargez la dernière version de TerraGear sur le [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip Serveur de compilation de FlightGear].<br />
*# Créez ou choisissez un répertoire pour contenir les outils TerraGear. <br />
*# Dé-zippez le paquetage et déplacez les fichiers de <tt>archive/install/msvc100/TerraGear/bin</tt> dans un sous-répertoire nommé <tt>Terragear/</tt> dans le répertoire de base.<br />
<br />
* '''Option 1b - Télécharger les paquetages ppa pour Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compiler TerraGear à partir du code source, comme expliqué dans [[Fr/TerraGear#Compilation|cet article]].<br />
<br />
{{note|1=Vous pourriez avoir besoin du fichier <code>default_priorities.txt</code> qui peut être obtenu à partir du {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=dépôt Git}} ou à partir de l'archive téléchargée à partir du serveur de compilation (dans le sous-répertoire <code>archive/install/msvc100/TerraGear/share</code>). Voir [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 ce lien du forum] pour les détails.}}<br />
<br />
=== Interface graphique ===<br />
L'interface graphique [[TerraGear GUI]] est disponible pour ceux voudraient utiliser TerraGear sans avoir à connaître/utiliser les options de ligne de commande.<br />
<br />
== Utilisation de TerraGear ==<br />
Tout d'abord, choisissez les limites de la zone de scène que vous voulez construire, en termes de latitude et de longitude. Plus la zone à générer sera restreinte, plus la quantité de données et le temps CPU nécessaire seront limités. Par exemple, si vous voulez juste générer une nouvelle disposition d'aéroport à la position 12°3 Ouest et 34°4 Nord, la génération des scènes entre 34°N 12°O et 35°N 13°O sera suffisante. <br />
<br />
Notez la boîte de délimitation (longitudes et latitudes minimum et maximum) pour la scène que vous voulez générer. Rappelez-vous que Ouest et Sud sont négatifs - c'est-à-dire que 4° Ouest 10° Sud doit être -4, -10. Essayez de ne pas vous mélanger les pinceaux, sinon la scène ou l'aéroport que vous créez se retrouvera de l'autre côté de la planète !<br />
<br />
Vous aurez affaire avec différents types de données utilisant des formats variés. Créez un nouveau répertoire pour votre travail de scène. A l'intérieur de ce répertoire, créez les sous-répertoires suivants: <br />
<br />
; <code>data/</code>: Pour les données brutes et pré-calculées (par exemple, les fichiers d'élévation)<br />
; <code>output/</code>: Pour les fichiers de scènes que vous créerez<br />
; <code>work/</code>: Pour les données qui ont été calculez (par exemple par shape-decode) et qui sont prêtes à être intégrées dans la scène<br />
<br />
=== Obtenir et traiter les données ===<br />
Terragear utilise trois sortes d'informations différentes pour générer une scène :<br />
<br />
# L'élévation du terrain (fournie par SRTM)<br />
# L'emplacement et la disposition des aéroports (fournis par apt.dat ou un fichier .dat personnalisé) <br />
# Si une lat/lon donnée correspond à la mer, la terre, une ville, une forêt, un village, une route, un chemin de fer (fourni par VMAP0, [[CORINE]], etc. ou par des fichiers personnalisés de formes)<br />
<br />
Cet article décrit comment obtenir et traiter chacun de ces types de données dans l'ordre, et les fournir ensemble, pour que FlightGear les utilise. L'ordre de ces étapes est important. Par exemple, l'étape des données d'un aéroport a besoin des données d'élévation pour déterminer l'élévation des aéroports. Ainsi, vous commencerez par préparer les données d'élévation.<br />
<br />
{{caution|Pour l'inclusion dans les scènes officielles de FlightGear, toutes les données ''doivent'' provenir de sources compatibles avec la licence [[GNU GPL]]!}}<br />
<br />
==== Données d'élévation ====<br />
Les meilleures données d'élévation actuellement disponibles proviennent du projet Shuttle Radar Topography Mission (SRTM). Il y a deux types de données SRTM :<br />
* Données de haute précision (résolution 1-arc seconde), ou SRTM-1, pour les USA<br />
* Données de précision moindre (résolution 3-arc second), ou SRTM-3, pour le reste du monde.<br />
<br />
A partir de maintenant, nous supposerons que vous utilisez les données SRTM-3. Sauf mention contraire, le processus est identique pour SRTM-1.<br />
<br />
Vous pouvez télécharger les données appropriées à partir du site http://dds.cr.usgs.gov/srtm/version2_1/. Vous devrez récupérer tous les fichiers .hgt.zip couvrant la région qui vous intéresse. Selon la taille de votre scène, cela peut représenter un grand nombre de fichiers. Téléchargez les vers l'emplacement <tt>data/SRTM-1/</tt> (ou SRTM-3/SRTM-30 en fonction du type de données que vous téléchargez) dans votre répertoire de base. (Genapts recherche les données d'élévation parmi un ensemble de noms de répertoires prédéfinis dans son répertoire de travail. SRTM-30 est l'un d'eux, c'est le moins déroutant dans cette liste. Notez que, à compter du 31 juillet 2010, l'outil genapts prend également en compte l'existence de répertoires SRTM-1/SRTM-3. Si vous utilisez une version plus ancienne, pensez à fournir les répertoires en utilisant --dem-path).<br />
<br />
Maintenant que nous avons les données, nous devons les convertir pour qu'elles puissent servir à TerraGear. Tout d'abord, dézippez chacun des fichiers .hgt. Ensuite, ouvrez la ligne de commande (Sous Windows: Démarrer > Exécuter > <code>cmd.exe</code>) et placez-vous dans le répertoire de base (<code>cd .../.../TerraGear</code>).<br />
<br />
{{note|Selon [[TerraGear_Documentation]], hgtchop est remplacé par gdalchop.}}<br />
{{note|Pour les données SRTM-1, remplacez le <code>3</code> par un <code>1</code> dans le premier argument fourni à hgtchop}}<br />
{{tip|Si vous voulez créer un fichier batch, remplacez <code>%f</code> avec <code>%%f</code>, voir à ce sujet : [http://technet.microsoft.com/en-us/library/bb490909.aspx]}}<br />
<br />
Pour Windows :<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
ou<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
Pour Linux :<br />
for f in ${PWD}/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 "${f}" "${PWD}/work/SRTM-3"; done<br />
<br />
Maintenant, vous allez obtenir une quantité importante de fichiers .arr.gz dans votre répertoire work/SRTM-3/. Il nous faut les convertir au format .fit.gz. Utilisez à nouveau la ligne de commande avec<br />
{{note|L'espace et le point à la fin sont importants!}}<br />
<br />
Pour Windows :<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
Pour Linux :<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Données d'aéroports ====<br />
Maintenant que nous avons les données d'élévation, nous pouvons générer nos aéroports. Tout d'abord, créons un répertoire <tt>data/airports/</tt> et copions-y le fichier apt.dat. Ceci peut être effectué soit directement à partir de votre paquetage de FlightGear (bien que vous devrez le dé-zipper), soit il peut correspondre au fichier que vous auriez modifié avec [[TaxiDraw]].<br />
<br />
La commande pour créer les aéroports est "genapts". Lancez-la sans arguments, afin de visualiser les différentes options de ligne de commande.<br />
<br />
Si elle est simplement lancée avec un fichier apt.dat spécifié et le répertoire de travail, elle génèrera les agencements d'aéroports pour chaque aéroport contenu dans le fichier, ce qui peut être long. <br />
<br />
Si vous créez juste un seul aéroport, et que vous connaissez son identifiant OACI (par exemple [[KSFO]], EGPH, EG32), utilisez cet identifiant comme suit à partir du répertoire racine de vos scènes (c'est à dire à partir du répertoire parent de vos répertoires data, work et output). Si vous utilisez un fichier apt.dat contenant un seul aéroport, vous pouvez omettre le paramètre "--airport". <br />
<br />
genapts --input=data/airports/apt.dat --work=./work --airport=<IDENTIFIANT_OACI_AEROPORT><br />
<br />
Si vous générez des scènes plus grandes, alors vous pouvez spécifier les longitudes et latitudes minimum et maximum.<br />
<br />
Genapts va créer deux sous-répertoires dans votre répertoire work:<br />
* AirportArea/<br />
* AirportObj/<br />
<br />
Ils contiennent les définitions des agencement de l'aéroport, et de certains objets présents (par exemple les manches à air). <br />
<br />
==== Données d'utilisation du sol ====<br />
Les dernières données que nous avons besoin de générer sont celles correspondant au type d'utilisation du sol. En général, elles proviennent du lot de données VMAP0 en tant que fichiers de formes en provenance du serveur de carte de la base de données des scènes, mais d'autres sources peuvent aussi être utilisées.<br />
<br />
Les données d'utilisation du sol peuvent être séparées en différents types :<br />
<br />
* '''Landmass :''' sépare la terre de la mer. Ces données sont utilisées comme masque pour toutes les autres données. Les plus couramment utilisées sont le Landmass VMAP0, mais GSHHS peut également être utilisé.<br />
* '''Land use data :''' définit si une portion de terrain correspond à une forêt, une zone urbaine, du sable, de la lave, des glaciers, etc. Ce sont généralement données VMAP0 définies en tant que polygones.<br />
* '''Line data :''' comprend les lignes de chemins de fer, les rivières, les routes. Typiquement VMAP0, mais aussi OpenStreetMap pour les routes.<br />
* '''Point data :''' est actuellement uniquement utilisé pour définir les villes.<br />
<br />
De loin, le moyen le plus facile pour obtenir ces données est de télécharger à partir du magnifique [http://mapserver.flightgear.org MapServer] les fichiers formes pour une zone de scène donnée. Cliquez sur le lien "Download Shapefiles" (ou allez directement à : http://mapserver.flightgear.org/download.psp). Entrez dans la boîte de délimitation de la scène que vous désirez générer, sélectionnez le type de données de fichier-formes que vous voulez, et cliquez sur '''download'''. Pour les scènes de base, prenez tout ce qui est listé sous VMap0 (c'est-à-dire utilisant le préfixe v0_).<br />
<br />
Téléchargez chaque fichier-forme dans un répertoire séparé (!) <tt>data/shapefiles/...</tt>. Ainsi, pour v0_landmass, vous obtiendriez <tt>data/shapefiles/v0_landmass/v0_landmass.shp</tt>, etc.<br />
<br />
Vous pouvez charger ces fichiers-formes dans un éditeur SIG tel que [[QGIS]] ou GRASS pour les visualiser et les éditer. C'est une bonne idée pour vérifier que vous avez bien les bons fichiers ! Plus tard, vous pourrez expérimenter en remplaçant divers fichiers-formes avec d'autres versions (GSHHS pour la côte, OSM pour les routes, etc.).<br />
<br />
L'étape suivante décode les fichiers-formes vers le format TerraGear en utilisant la commande '''ogr-decode''' . <br />
<br />
Il y a trois arguments de ligne de commande importants pour ogr-decode :<br />
* le répertoire de destination pour les données décodées,<br />
* la localisation du répertoire de fichiers-formes,<br />
* le type de matériau.<br />
<br />
Chaque fichier-forme correspond avec un des types de matériau défini dans les fichiers materials.xml. La correspondance est assez évidente. Par exemple, v0_mixedcroppasturecover correspond à MixedCropPastureCover. Notez que les types de matériau sont sensibles à la casse, donc il est bon de se référer au fichier <tt>[[$FG ROOT]]/materials.xml</tt> pour vérifier. L'exception est v0_landmass, qui DOIT correspondre au type Default.<br />
<br />
En complément, il existe de nombreux arguments optionnels pour indiquer la largeur des données linéaires (pour les routes, les rivières, les voies de chemin de fer), quelle largeur utiliser pour les données de type point (pour les villes) et quelle est la plus grande longueur acceptable pour une ligne droite.<br />
<br />
Par exemple, pour décoder le fichier-forme v0_landmass, vous entrez la commande suivante :<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Landmass data/shapefiles/v0_landmass<br />
<br />
Pour créer des rivières de 10 mètres de large :<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
Pour générer des villes d'environ 1 kilomètre de diagonale :<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Lancez cette commande pour chaque fichier-forme du lot de données.<br />
<br />
== Générer les scènes ==<br />
Vous avez maintenant un répertoire de travail, avec des sous-répertoires comme :<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Landmass<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Nous pouvons maintenant générer les scènes en utilisant la commande fgfs-construct. Lancez la commande avec <code>--help</code> pour obtenir les informations d'utilisation. <br />
<br />
Nous devons définir :<br />
* Les répertoires de travail (--work-dir) et de sortie (--output-dir) .<br />
** '''Notez''', au sujet du répertoire de sortie : il doit pointer vers le répertoire <tt>Terrain/</tt>, sinon, les versions récentes FlightGear seront incapables de charger le terrain.<br />
* Le centre de la scène que nous voulons générer (--lat, --lon).<br />
* Le rayon (--xdist, --ydist) à partir duquel on génère.<br />
* Tous les répertoires de travail à inclure dans la scène.<br />
<br />
Par exemple :<br />
{{Pre2|<nowiki>fgfs-construct --work-dir=./work --output-dir=./output/Terrain --lon=55 --lat=60 --xdist=3 --ydist=3 AirportArea SRTM-3 AirportObj Stream Bog IrrCropPastureCover Town Lake Urban Landmass Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
Lorsque cette commande se termine, le répertoire de sortie contiendra un sous-répertoire scenery. Pointez vers lui en paramétrant [[$FG_SCENERY]] ou en utilisant l'option de ligne de commande --fg-scenery à fgfs, et testez votre nouvelle scène !<br />
<br />
== Un soucis ? ==<br />
Vous trouverez ci-dessous une liste de problèmes courants et leur solutions. Dans le doute, copiez/collez votre erreur dans Google. La plupart des problèmes (en particulier lors de la compilation de TerraGear) ont déjà été évoqués :<br />
<br />
* Crash de genapts. Quelquefois, genapts plante avec certains aéroports. Dans ce cas, essayez de le relancer avec l'argument --start-id pour démarrer à l'aéroport sur lequel il a planté, et l'argument --nudge pour essayer de remettre les calculs dans la bonne voie.<br />
* fgfs-construct tué. Le processus fgfs-construct peut se suicider s'il consomme trop de ressources système. L'augmentation des valeurs pour setrlimit dans src/BuildTiles/Main/main.cxx est la meilleure solution.<br />
* Les aéroports apparaissent au fond de trous, ou il y a des espaces entre les aéroports et la scène. Ceci arrive lorsque genapts est incapable de trouver la donnée d'élévation correcte, ou alors la donnée d'élévation a changé entre le lancement de genapts et celui de shape-decode. Essayez de générer un seul aéroport dans votre zone de scène en utilisant genapts, et visualisez la sortie. En particulier, soyez sûr que le répertoire work/SRTM-3 existe. <br />
* Seuls les aéroports apparaissent dans la scène. Il existe trois explications typiques :<br />
** vous n'avez pas téléchargé les fichiers-formes corrects de la zone;<br />
** vous n'avez pas lancé shape-decode sur le fichier-forme v0_landmass comme Default <br />
** vous n'avez pas inclus les répertoires corrects dans fgfs-construct. <br />
* La scène générée contient des données effacées des fichiers-formes. Si vous éditez des fichiers-formes, vous devez effacer le sous-répertoire work approprié avant de lancer shape-decode. Sinon, vos changements s'ajouteront à ceux qui existent déjà.<br />
* La scène entière est plate et au niveau de la mer. C'est généralement dû au fait que vous n'avez pas inclus les données d'élévation dans votre commande fgfs-construct. Assurez-vous qu'il existe un répertoire STRM-3 précisé dans la ligne de commande. <br />
* Tout terrain copie le matériel d'un fichier-forme. Vous avez probablement oublié de mettre chacun des fichiers-formes téléchargés dans un répertoire séparé à l'intérieur du répertoire Data/shapefiles. <br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement]]<br />
[[en:Using TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Using_TerraGear&diff=105993Using TerraGear2016-11-19T12:54:52Z<p>Puchacz: /* Elevation data */ : protect Bash against spaces in files and directories names</p>
<hr />
<div>{{Out of date}}<br />
<br />
[[File:Terragearprocesschart.png|thumb|TerraGear Process Flow Chart]]<br />
The [[TerraGear]] software project supports [[FlightGear]] by creating the files used by FlightGear to represent the elevation and texture of the earth, including airports, cities, fields, forests, rivers, roads and so on. The TerraGear software reads data files containing ground elevation, airport locations and layouts, geographical land-cover data, and more, and produces the scenery files used by FlightGear to represent the terrain of the world.<br />
<br />
For simplicity and convenience, most FlightGear users simply download the plug-and-play scenery files from the FlightGear scenery server, or use [[TerraSync]] to automatically download scenery as needed. But there is a variety of reasons you might want to use TerraGear to produce your own terrain files, rather than downloading the standard FlightGear scenery. <br />
<br />
For instance, if you use [[WorldEditor]] to modify/improve information about an [[:Category:Airports|airport]]'s taxiway/apron layout, you might wish to see how that modified airport would look in the scenery before deciding you're happy with the results. 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-resolution vector data (vmap1, Tiger, osm) to get better roads/streams. For all these reasons, learning how to use TerraGear is a good idea.<br />
<br />
== Obtaining TerraGear ==<br />
You can either build TerraGear yourself, or download a pre-compiled binary. The later is the easiest and advised for starters.<br />
<br />
* '''Option 1a - Download TerraGear pre-compiled (recommended for beginners) on Windows'''<br />
*# Download the latest TerraGear build from the [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip FlightGear Build Server].<br />
*# Create or choose a directory to hold the TerraGear tools. <br />
*# Unzip the package and move the files from <code>archive/install/msvc100/TerraGear/bin</code> into a sub-directory named <code>Terragear/</code> in the base directory.<br />
<br />
* '''Option 1b - Download ppa packages for Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compile TerraGear from source code''' as explained in [[Building TerraGear|this article]].<br />
<br />
{{note|1=You might need <code>default_priorities.txt</code> from the {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=git repository}} or from the archive downloaded from the build server (in the <code>archive/install/msvc100/TerraGear/share</code> subdirectory). See [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 this forum thread] for details.}}<br />
<br />
=== GUI tool ===<br />
A [[TerraGear GUI]] is available for those that would like to use TerraGear without knowing/using the command line options.<br />
<br />
== Using TerraGear ==<br />
First, choose the boundaries for the area of scenery you want to build, in terms of latitude and longitude. The smaller the area of scenery you generate, the smaller the amount of data you will need, and the less CPU time it will take. For example, if you are just interested in generating a new airport layout at 12.3W 34.4N, then simply generating the scenery between 12W 34N and 13W 35N would be sufficient. <br />
<br />
Write down the bounding box (minimum and maximum longitude and latitude) for the scenery you want to generate. Remember that West and South are negative - in essence 4W 10S would be -4, -10. Try not to get mixed up, otherwise you'll end up generating scenery or airports on the other side of the planet! <br />
<br />
You'll be dealing with multiple different types of data in various formats. Create a new directory for your scenery work. Within that directory, create the following sub-directories: <br />
<br />
; <code>data/</code>: For raw and pre-processed data (eg elevation files) <br />
; <code>output/</code>: For the scenery files you will create <br />
; <code>work/</code>: For data that has been processed (eg by shape-decode) and is ready to be munged into scenery <br />
<br />
=== Obtaining and processing data ===<br />
TerraGear uses three different kinds of information to generate scenery:<br />
<br />
# The elevation of the land (provided by SRTM) <br />
# The location and layout of airports (provided by apt.dat or a custom .dat) <br />
# Whether a given lat/lon is sea, land, city, forest, town, road, railway (provided by VMAP0, [[CORINE]] etc. or custom shapefiles) <br />
<br />
This article describes how obtain and process each of these types of data in order, and bring it together for use by FlightGear. The order of these steps is important. For example, the airport data step needs the elevation data to determine the elevation of the airports and thus you should start with preparing elevation data.<br />
<br />
{{caution|For inclusion in the official FlightGear scenery, all data '''must''' come from [[GNU GPL]] compatible sources!}}<br />
<br />
==== Elevation data ====<br />
The best worldwide elevation data currently available is from the Shuttle Radar Topography Mission (SRTM). There are two types of SRTM data: <br />
* Highly accurate 1-arcsecond resolution data, known as SRTM-1, for the USA <br />
* Less accurate 3-arcsecond resolution data, known as SRTM-3, for the rest of the world. <br />
From now on, we'll assume you are using SRTM-3 data. Unless otherwise noted, the process for SRTM-1 is identical.<br />
<br />
You can download the appropriate data from http://dds.cr.usgs.gov/srtm/version2_1/. You want all .hgt.zip files covering your region of interest. Depending on the size of your scenery, there may be quite a few. Download them to <code>data/SRTM-1/</code> (or SRTM-3/SRTM-30 depending on the type you downloaded) in your base directory. (Genapts looks for a few known, hardcoded elevation data directories in its working directory. SRTM-30 is one of them and this is the least confusing in that list. Note: W.E.F. 31st July 2010, the genapts tool now also looks for SRTM-1/SRTM-3 directories. If you are using an older version, please supply the directories using --dem-path).<br />
<br />
Now we've got the data, we need to convert it into something of use to TerraGear. First, you need to unzip each of the .hgt files. After that, open the commandline (Windows: Start > Run > <code>cmd.exe</code>) and change into the base directory (<code>cd .../.../TerraGear</code>).<br />
<br />
{{note|According to [[TerraGear_Documentation]], hgtchop is superseded by gdalchop.}}<br />
{{note|For SRTM-1 data, replace the <code>3</code> by a <code>1</code> in the first argument to hgtchop}}<br />
{{tip|If you want to create a batch-file, replace <code>%f</code> with <code>%%f</code>, see [http://technet.microsoft.com/en-us/library/bb490909.aspx]}}<br />
<br />
For Windows:<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
or<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
For Linux:<br />
for f in ${PWD}/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 "${f}" "${PWD}/work/SRTM-3"; done<br />
<br />
Now you will get a lot of .arr.gz files in your work/SRTM-3/ directory. We need to convert these to the .fit.gz format. Run the commandline again with<br />
<br />
{{note|The space and dot at the and are important!}}<br />
<br />
For Windows:<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
For Linux:<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Airport data ====<br />
Now we've got elevation data, we can generate our airports. First, create a <code>data/airports/</code> directory and copy in your apt.dat file. This may be direct from your FlightGear data package (though you'll need to unzip it), or it may be one that you've modified with [[WorldEditor]]. <br />
<br />
The command to create airports is "genapts850". Run it without any arguments to see the various command-line options. <br />
<br />
If it is simply run with a specified apt.dat and work directory, it will generate airport layouts for every airport in the file, which can take a long time. Make sure the input is not the apt.gz, but an uncompressed file. Otherwise genapts850 will block and not produce any output.<br />
<br />
If you are just creating a single airport and you know the ICAO ID (for example [[KSFO]], EGPH or EG32), use is as follows from your root scenery directory (in essence the directory above your data, work and output directories). If you use an apt.dat file with one single airport in it you should omit the <code>--airport</code> parameter. <br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --airport=<AIRPORT_ID><br />
<br />
or, if you have elevation data available:<br />
<br />
genapts850 --input=data/airports/apt.dat --work=./work --dem-path=SRTM-3<br />
<br />
If you are generating a larger set of scenery, then you can specify the minimum and maximum longitude and latitude. <br />
<br />
Genapts will create two sub-directories in your work directory:<br />
<br />
* <code>AirportArea/</code><br />
* <code>AirportObj/</code><br />
<br />
These contain the definitions of the airport layout and any objects present (e.g. windsocks and beacons). <br />
<br />
==== Landuse data ====<br />
The final piece of data we need to generate is the landuse data. In general, this is taken from the VMAP0 dataset as shapefiles from the scenery database mapserver, but other sources can also be used.<br />
<br />
The landuse data can be split into a number of different types:<br />
<br />
; Landmass: Separates the land from the sea. It can be used as a mask for all other data. The most commonly used is the VMAP0 Landmass, but GSHHS can also be used. When running tg-construct with <code>--ignore-landmass</code>, all input shapefiles will be taken into consideration, so no landmass mask is required then.<br />
; Land use data: Defines whether a piece of land is forest, urban, sand, lava, glacier etc. These are usually VMAP0 data, defined as polygons.<br />
; Line data: Includes railroads, streams, roads. Typically VMAP0, but also Open Street Map for roads.<br />
; Point data: Is currently only used for defining towns.<br />
<br />
By far the easiest way to get this data is to download shapefiles from the wonderful [http://mapserver.flightgear.org MapServer]. The MapServer lets you download the shapefiles for any selected scenery area. Click on the "Download Shapefiles" link (or go direct: http://mapserver.flightgear.org/download.psp). Enter in the bounding box of the scenery you want to generate, select the type of shapefile data you want, and click download. <br />
<br />
==== Layers ====<br />
<br />
; <code>v0</code>: Global coverage, low detail. This is "the last resort", but unfortunately it is the only layer that covers the entire world.<br />
; <code>cs</code>: It is v0 with some contributions someone did in the past. Get this instead of v0.<br />
; <code>v1</code>: Only parts of some countries available, higher detail than v0.<br />
; <code>clc06</code>: European '''only'''. Very high detail, this is the preferred choice for an European country.<br />
; <code>osm</code>: Global coverage, high resolution but very low detail.<br />
: This means: if you are interested in an area out of Europe and forests are defined in OpenStreetMaps for your area, this is going to be the best data source. If forests are not defined, you will get a dull, neverending DEFAULT landclass. OSM provides the best coastline and I encourage you to use this coastline even in Europe. [http://forum.flightgear.org/viewtopic.php?f=5&t=25549&sid=d501cb651ef9e34ca9dc8fae429d51ab&p=234002#p234002]<br />
<br />
{{caution|Make sure each shape file is in its own directory whether you download shape files or create your own otherwise the ogrDecode step will fail.}}<br />
Download each shapefile into a seperate (!) <code>data/shapefiles/...</code> directory. So, for v0_landmass, you would end up with <code>data/shapefiles/v0_landmass/v0_landmass.shp</code> etc.<br />
<br />
You can load these shapefiles into a GIS editor such as [[QGIS]] or GRASS to view and edit. This is a good idea to verify you have the correct files! Later on, you can experiment with replacing various shapefiles with other versions (GSHHS for coastline, OSM for roads etc.).<br />
<br />
The next step is to decode the shape-files into TerraGear format using the '''ogr-decode''' command. <br />
<br />
There are three important command-line arguments for ogr-decode:<br />
* the destination directory for the decoded data<br />
* the location of the shapefile's directory<br />
* the material type<br />
<br />
Each shape-file corresponds with one of the material types defined in the materials.xml files. The mapping is pretty obvious. For example, <code>v0_mixedcroppasturecover</code> maps to <code>MixedCropPastureCover</code>. Note that the material types are case-sensitive, so it is a good idea to refer to the <code>[[$FG_ROOT]]/Materials/default/materials.xml</code> file (<code>[[$FG ROOT]]/materials.xml</code> in FlightGear 2.6.0 and older) to hand so you can check. The exception is landmass, which - when used - MUST be mapped onto the type Default.<br />
<br />
Additionally, there are a number of optional arguments, to indicate the width of line data (for roads, streams, railways), how large to make point data (for towns) and how long the longest straight line is allowed to be.<br />
<br />
For example, to decode the <code>v0_landmass</code> shapefile, you use the following command:<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Default data/shapefiles/v0_landmass<br />
<br />
To create streams of width 10 metres<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
To generate some towns about 1km across<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Run this command for each shapefile in the set.<br />
<br />
== Generating scenery ==<br />
You will now have a work directory, with subdirectories like:<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: Default<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Now we can actually generate the scenery. This is done by the tg-construct command. Run the command with <code>--help</code> to get usage information. <br />
<br />
We need to define:<br />
* The work (<code>--work-dir</code>) and output (<code>--output-dir</code>) directories.<br />
* The center of the scenery we want to generate (<code>--lat</code> and <code>--lon</code>).<br />
* The radius (<code>--xdist</code> and <code>--ydist</code>) from which to generate.<br />
* All the work directories to include in the scenery.<br />
<br />
{{note|The output directory must point to a <code>Terrain/</code> directory, else recent FlightGear versions will be unable to load the terrain.}}<br />
<br />
For example:<br />
{{Pre2|<nowiki>tg-construct --work-dir=./work --output-dir=./output/Terrain --min-lon=55 --max-lon=57 --min-lat=60 --max-lat=62 AirportArea SRTM-3 AirportObj Default Stream Bog IrrCropPastureCover Town Lake Urban Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
When this finishes, the output directory will contain a scenery sub-tree. Point to it by setting either [[$FG_SCENERY]] or by using the <code>--fg-scenery</code> command-line option to fgfs, and give your new scenery a try!<br />
<br />
== Troubleshooting ==<br />
Below is a list of common problems and solutions. If in doubt - Google it. Many problems (particularly when compiling TerraGear) have been hit before: <br />
<br />
* Crashes in genapts. Sometimes genapts will crash when dealing with a particular airport. In that case, try running it again with the <code>--start-id</code> argument to start at the airport it failed on, and the <code>--nudge</code> argument which tries to nudge the calculations in the right direction. <br />
* tg-construct killed. The tg-construct process may kill itself if it is using too many system resources. Increasing the values for <code>setrlimit</code> in <code>src/BuildTiles/Main/main.cxx</code> is the best solution. <br />
* tg-construct silently stops immediately without an error and nothing goes to the "output" directory: make sure that lon/lat values correspond to tiles boundaries. See [[Tile Index Scheme]]<br />
* Airports appear in the bottom of holes, or there are spaces between the airports and the scenery. This typically happens when genapts is unable to find the correct elevation data, or the elevation data changed between running genapts and shape-decode. Try generating a single airport in your scenery area using genapts, and look at the output. In particular, make sure there is a work/SRTM-3 directory. <br />
* Only the airports appear in the scenery. There are three typical causes for this: <br />
** You didn't download the correct shapefiles for the area. <br />
** You haven't run shape-decode on the <code>v0_landmass</code> shapefile as Default <br />
** You didn't include the correct directories in tg-construct. <br />
* Generate scenery includes data removed from the shapefiles. If you are editing shapefiles, you need to delete the appropriate work subdirectory before running shape-decode. Otherwise your changes will be in addition to those already present. <br />
* All the scenery is flat and at sea-level. Typically this is because you didn't include any elevation data in your tg-construct command. Make sure there's a STRM-3 directory included in the command-line. <br />
* All terrain copies the material of a certain shapefile. You have probably forgotten to put each of the downloaded shapefiles in a seperate directory inside the Data/shapefiles directory.<br />
* genapts850 never passes the stage "Adding airport <ICAO> to parse list": did you unzip <code>apt.dat.gz</code>?<br />
<br />
== General comments from forum discussion ==<br />
{{cquote|f-ojac, you are right, the parameters used in scenery 2.0 were "-e 5 -x 20000" according to the wiki. I don't know why I had the impression these parameters were not public. In any case, it does not matter because using the same parameters will create closer results, but they are not guaranteed to be the same.<br />
<br />
The parameters used to create scenery 2,0 seem to be:<br />
<br />
-m ??: the minimum number of vertices in a tile. In FG, any number bellow 100 (and probably, any number below 1000) will do. I don't think there is any surface on the world perfectly flat for several kilometers. The default value is 50 and I'm sure is ok for any normal use.<br />
-e 5: the max allowed error for elevation, in meters. That is: if terrafit calculates a simplification of the terrain where all points are at most this distance from the real elevation, no more vertices are created. The default value is 40 meters: a point may have an elevation error up to 40m (~100ft) High values for this parameter create less detailed mountains and smaller (in disk size) and more efficient (in FPS) terrain.<br />
-x 20000: the max number of vertices in a tile. If this number of vertices is reached, terrafit stop regardless the max error of the vertices. The default value is 1000<br />
<br />
Keep in mind you can set values that do not make sense:<br />
<br />
* "-e 1 -x 100" does not make sense because it is going to be impossible to calculate errors less than 1 meters using only 100 vertices. The max number of vertices will be reached always and the max error will be probably ignored.<br />
* "-e 300 -x 20000" does not make sense, tiles are going to use for sure much less vertices than 20,000 because you are allowing huge elevation errors.<br />
<br />
If you want an efficient scenery (less vertices), use the default values "-e 40 -x 1000". If you want more accurate elevation at the cost of disk space and FPS, use values similar to scenery 2.0 ("-e 5 -x 20000") Anything in the middle will produce performance and disk use in the middle.<ref>{{cite web |url=http://forum.flightgear.org/viewtopic.php?f=5&t=24681#p225363 <br />
|title=Re: Terrasync Help (surprinsingly!) :)<br />
|author=ludomotico |date= Mon Nov 24, 2014 4:28 am}}</ref>|ludomotico}}<br />
<br />
<references/><br />
<br />
== Related content ==<br />
* [[Howto:Create custom terrain]], editing/making terrain data.<br />
* [[TerraGear CORINE]], building terrain from CORINE data.<br />
* [[TerraGear Documentation]], using TerraGear details.<br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement|TerraGear, Using]]<br />
<br />
[[fr:Utiliser TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Fr/Utiliser_TerraGear&diff=105986Fr/Utiliser TerraGear2016-11-18T21:29:25Z<p>Puchacz: /* Utilisation de TerraGear */</p>
<hr />
<div>[[File:Terragearprocesschart.png|thumb|Organigramme de TerraGear]]<br />
Le projet logiciel [[Fr/TerraGear|TerraGear]] participe au projet [[Fr/FlightGear|FlightGear]] en créant les fichiers utilisés par celui-ci pour représenter le relief et la texture de la Terre, ce qui comprend les aéroports, villes, champs, forêts, rivières, routes, etc. Le logiciel TerraGear lit des fichiers de données contenant l'élévation du sol, le positionnement et l'agencement des aéroports, les données géographiques d'occupation du sol, entre autres et produit les fichiers de scènes utilisés par Flightgear pour représenter la surface de la planète.<br />
<br />
Par simplicité et commodité, la plupart des utilisateurs de FlightGear téléchargent simplement les fichiers plug-and-play des scènes à partir du serveur de scènes de FlightGear, ou utilisent [[Fr/TerraSync|TerraSync]] pour télécharger automatiquement les scènes à la demande. Mais il peut y avoir des cas où vous voudriez utiliser TerraGear pour générer vos propres fichiers terrain, plutôt que de télécharger les scènes standard de FlightGear.<br />
<br />
Par exemple, si vous utilisez [[WorldEditor]] pour modifier/améliorer les information concernant un taxiway/une aire de trafic d'un [[:Category:Airports|aéroport]], vous pourriez avoir envie de visualiser à quoi ressemblerait cet aéroport modifié dans les scènes avant de décider que les résultats vous conviennent. Peut-être que les scènes officielles sont trop détaillées pour votre machine un peu ancienne, et que vous voudriez construire un terrain avec un modèle numérique de d'élévation (DEM) de plus faible résolution, afin de diminuer le nombre de polygones et ainsi augmenter votre taux de rafraîchissement d'image. Soit vous avez une machine ultra-rapide, et vous voulez construire votre propre terrain avec des données vectorielles de plus haute résolution (vmap1, Tiger, osm) pour obtenir de meilleures routes/rivières. Pour toutes ces raisons, apprendre à utiliser TerraGear est une bonne idée.<br />
<br />
== Obtenir TerraGear ==<br />
Vous pouvez soit compiler TerraGear vous-même, ou bien télécharger un binaire pré-compilé, cette dernière démarche étant plus aisée et donc recommandée pour les débutants.<br />
<br />
* '''Option 1 - Télécharger TerraGear pré-compilé (recommandé aux débutants) sur Windows'''<br />
*# Téléchargez la dernière version de TerraGear sur le [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip Serveur de compilation de FlightGear].<br />
*# Créez ou choisissez un répertoire pour contenir les outils TerraGear. <br />
*# Dé-zippez le paquetage et déplacez les fichiers de <tt>archive/install/msvc100/TerraGear/bin</tt> dans un sous-répertoire nommé <tt>Terragear/</tt> dans le répertoire de base.<br />
<br />
* '''Option 1b - Télécharger les paquetages ppa pour Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compiler TerraGear à partir du code source, comme expliqué dans [[Fr/TerraGear#Compilation|cet article]].<br />
<br />
{{note|1=Vous pourriez avoir besoin du fichier <code>default_priorities.txt</code> qui peut être obtenu à partir du {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=dépôt Git}} ou à partir de l'archive téléchargée à partir du serveur de compilation (dans le sous-répertoire <code>archive/install/msvc100/TerraGear/share</code>). Voir [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 ce lien du forum] pour les détails.}}<br />
<br />
=== Interface graphique ===<br />
L'interface graphique [[TerraGear GUI]] est disponible pour ceux voudraient utiliser TerraGear sans avoir à connaître/utiliser les options de ligne de commande.<br />
<br />
== Utilisation de TerraGear ==<br />
Tout d'abord, choisissez les limites de la zone de scène que vous voulez construire, en termes de latitude et de longitude. Plus la zone à générer sera restreinte, plus la quantité de données et le temps CPU nécessaire seront limités. Par exemple, si vous voulez juste générer une nouvelle disposition d'aéroport à la position 12°3 Ouest et 34°4 Nord, la génération des scènes entre 34°N 12°O et 35°N 13°O sera suffisante. <br />
<br />
Notez la boîte de délimitation (longitudes et latitudes minimum et maximum) pour la scène que vous voulez générer. Rappelez-vous que Ouest et Sud sont négatifs - c'est-à-dire que 4° Ouest 10° Sud doit être -4, -10. Essayez de ne pas vous mélanger les pinceaux, sinon la scène ou l'aéroport que vous créez se retrouvera de l'autre côté de la planète !<br />
<br />
Vous aurez affaire avec différents types de données utilisant des formats variés. Créez un nouveau répertoire pour votre travail de scène. A l'intérieur de ce répertoire, créez les sous-répertoires suivants: <br />
<br />
; <code>data/</code>: Pour les données brutes et pré-calculées (par exemple, les fichiers d'élévation)<br />
; <code>output/</code>: Pour les fichiers de scènes que vous créerez<br />
; <code>work/</code>: Pour les données qui ont été calculez (par exemple par shape-decode) et qui sont prêtes à être intégrées dans la scène<br />
<br />
=== Obtenir et traiter les données ===<br />
Terragear utilise trois sortes d'informations différentes pour générer une scène :<br />
<br />
# L'élévation du terrain (fournie par SRTM)<br />
# L'emplacement et la disposition des aéroports (fournis par apt.dat ou un fichier .dat personnalisé) <br />
# Si une lat/lon donnée correspond à la mer, la terre, une ville, une forêt, un village, une route, un chemin de fer (fourni par VMAP0, [[CORINE]], etc. ou par des fichiers personnalisés de formes)<br />
<br />
Cet article décrit comment obtenir et traiter chacun de ces types de données dans l'ordre, et les fournir ensemble, pour que FlightGear les utilise. L'ordre de ces étapes est important. Par exemple, l'étape des données d'un aéroport a besoin des données d'élévation pour déterminer l'élévation des aéroports. Ainsi, vous commencerez par préparer les données d'élévation.<br />
<br />
'''<u>Remarque :</u> pour que votre travail puisse être intégré dans les scènes officielles de FlightGear, toutes les données <u>doivent</u> provenir de sources compatibles avec la licence [[GNU GPL]] !'''<br />
<br />
==== Données d'élévation ====<br />
Les meilleures données d'élévation actuellement disponibles proviennent du projet Shuttle Radar Topography Mission (SRTM). Il y a deux types de données SRTM :<br />
* Données de haute précision (1-arc seconde), ou SRTM-1, pour les USA<br />
* Données de précision moindre (3-arc second), ou SRTM-3, pour le reste du monde<br />
A partir de maintenant, nous supposerons que vous utilisez les données SRTM-3. Sauf mention contraire, le processus est identique pour SRTM-1.<br />
<br />
Vous pouvez télécharger les données appropriées à partir du site http://dds.cr.usgs.gov/srtm/version2_1/. Vous devrez récupérer tous les fichiers .hgt.zip couvrant la région qui vous intéresse. Selon la taille de votre scène, cela peut représenter un grand nombre de fichiers. Téléchargez les vers l'emplacement <tt>data/SRTM-1/</tt>(ou SRTM-3/SRTM-30 en fonction du type de données que vous téléchargez) dans votre répertoire de base. (Genapts recherchera ses données parmi un ensemble de noms de répertoires prédéfinis dans son répertoire de travail. SRTM-30 est l'un d'eux, c'est le moins déroutant dans cette liste. Notez que, à compter du 31 juillet 2010, l'outil genapts prend également en compte l'existence de répertoires SRTM-1/SRTM-3. Si vous utilisez une version plus ancienne, pensez à fournir les répertoires en utilisant --dem-path)<br />
<br />
Maintenant que nous avons les données, nous devons les convertir pour qu'elles puissent servir à TerraGear. Tout d'abord, dézippez chacun des fichiers .hgt. Ensuite, ouvrez la ligne de commande (Sous Windows: <tt>Démarrer > Exécuter > cmd.exe</tt>) et placez-vous dans le répertoire de base (<tt>cd .../.../TerraGear</tt>). <br />
* '''NOTE :''' si vous voulez créer un fichier batch, remplacez <tt>%f</tt> avec <tt>%%f</tt>, voir à ce sujet : [http://technet.microsoft.com/en-us/library/bb490909.aspx]<br />
* '''NOTE :''' pour les données SRTM-1, remplacez le <tt>3</tt> par un <tt>1</tt> dans le premier argument fourni à hgtchop<br />
<br />
Pour Windows :<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
ou<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
Pour Linux :<br />
for i in $PWD/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 $i $PWD/work/SRTM-3; done<br />
<br />
Maintenant, vous allez obtenir une quantité importante de fichiers .arr.gz dans votre répertoire work/SRTM-3/. Il nous faut les convertir au format .fit.gz. Utilisez à nouveau la ligne de commande avec<br />
* '''NOTE:''' l'espace et le point à la fin sont importants !<br />
<br />
Pour Windows :<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
Pour Linux :<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Données d'aéroports ====<br />
Maintenant que nous avons les données d'élévation, nous pouvons générer nos aéroports. Tout d'abord, créons un répertoire <tt>data/airports/</tt> et copions-y le fichier apt.dat. Ceci peut être effectué soit directement à partir de votre paquetage de FlightGear (bien que vous devrez le dé-zipper), soit il peut correspondre au fichier que vous auriez modifié avec [[TaxiDraw]].<br />
<br />
La commande pour créer les aéroports est "genapts". Lancez-la sans arguments, afin de visualiser les différentes options de ligne de commande.<br />
<br />
Si elle est simplement lancée avec un fichier apt.dat spécifié et le répertoire de travail, elle génèrera les agencements d'aéroports pour chaque aéroport contenu dans le fichier, ce qui peut être long. <br />
<br />
Si vous créez juste un seul aéroport, et que vous connaissez son identifiant OACI (par exemple [[KSFO]], EGPH, EG32), utilisez cet identifiant comme suit à partir du répertoire racine de vos scènes (c'est à dire à partir du répertoire parent de vos répertoires data, work et output). Si vous utilisez un fichier apt.dat contenant un seul aéroport, vous pouvez omettre le paramètre "--airport". <br />
<br />
genapts --input=data/airports/apt.dat --work=./work --airport=<IDENTIFIANT_OACI_AEROPORT><br />
<br />
Si vous générez des scènes plus grandes, alors vous pouvez spécifier les longitudes et latitudes minimum et maximum.<br />
<br />
Genapts va créer deux sous-répertoires dans votre répertoire work:<br />
* AirportArea/<br />
* AirportObj/<br />
<br />
Ils contiennent les définitions des agencement de l'aéroport, et de certains objets présents (par exemple les manches à air). <br />
<br />
==== Données d'utilisation du sol ====<br />
Les dernières données que nous avons besoin de générer sont celles correspondant au type d'utilisation du sol. En général, elles proviennent du lot de données VMAP0 en tant que fichiers de formes en provenance du serveur de carte de la base de données des scènes, mais d'autres sources peuvent aussi être utilisées.<br />
<br />
Les données d'utilisation du sol peuvent être séparées en différents types :<br />
<br />
* '''Landmass :''' sépare la terre de la mer. Ces données sont utilisées comme masque pour toutes les autres données. Les plus couramment utilisées sont le Landmass VMAP0, mais GSHHS peut également être utilisé.<br />
* '''Land use data :''' définit si une portion de terrain correspond à une forêt, une zone urbaine, du sable, de la lave, des glaciers, etc. Ce sont généralement données VMAP0 définies en tant que polygones.<br />
* '''Line data :''' comprend les lignes de chemins de fer, les rivières, les routes. Typiquement VMAP0, mais aussi OpenStreetMap pour les routes.<br />
* '''Point data :''' est actuellement uniquement utilisé pour définir les villes.<br />
<br />
De loin, le moyen le plus facile pour obtenir ces données est de télécharger à partir du magnifique [http://mapserver.flightgear.org MapServer] les fichiers formes pour une zone de scène donnée. Cliquez sur le lien "Download Shapefiles" (ou allez directement à : http://mapserver.flightgear.org/download.psp). Entrez dans la boîte de délimitation de la scène que vous désirez générer, sélectionnez le type de données de fichier-formes que vous voulez, et cliquez sur '''download'''. Pour les scènes de base, prenez tout ce qui est listé sous VMap0 (c'est-à-dire utilisant le préfixe v0_).<br />
<br />
Téléchargez chaque fichier-forme dans un répertoire séparé (!) <tt>data/shapefiles/...</tt>. Ainsi, pour v0_landmass, vous obtiendriez <tt>data/shapefiles/v0_landmass/v0_landmass.shp</tt>, etc.<br />
<br />
Vous pouvez charger ces fichiers-formes dans un éditeur SIG tel que [[QGIS]] ou GRASS pour les visualiser et les éditer. C'est une bonne idée pour vérifier que vous avez bien les bons fichiers ! Plus tard, vous pourrez expérimenter en remplaçant divers fichiers-formes avec d'autres versions (GSHHS pour la côte, OSM pour les routes, etc.).<br />
<br />
L'étape suivante décode les fichiers-formes vers le format TerraGear en utilisant la commande '''ogr-decode''' . <br />
<br />
Il y a trois arguments de ligne de commande importants pour ogr-decode :<br />
* le répertoire de destination pour les données décodées,<br />
* la localisation du répertoire de fichiers-formes,<br />
* le type de matériau.<br />
<br />
Chaque fichier-forme correspond avec un des types de matériau défini dans les fichiers materials.xml. La correspondance est assez évidente. Par exemple, v0_mixedcroppasturecover correspond à MixedCropPastureCover. Notez que les types de matériau sont sensibles à la casse, donc il est bon de se référer au fichier <tt>[[$FG ROOT]]/materials.xml</tt> pour vérifier. L'exception est v0_landmass, qui DOIT correspondre au type Default.<br />
<br />
En complément, il existe de nombreux arguments optionnels pour indiquer la largeur des données linéaires (pour les routes, les rivières, les voies de chemin de fer), quelle largeur utiliser pour les données de type point (pour les villes) et quelle est la plus grande longueur acceptable pour une ligne droite.<br />
<br />
Par exemple, pour décoder le fichier-forme v0_landmass, vous entrez la commande suivante :<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Landmass data/shapefiles/v0_landmass<br />
<br />
Pour créer des rivières de 10 mètres de large :<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
Pour générer des villes d'environ 1 kilomètre de diagonale :<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Lancez cette commande pour chaque fichier-forme du lot de données.<br />
<br />
== Générer les scènes ==<br />
Vous avez maintenant un répertoire de travail, avec des sous-répertoires comme :<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Landmass<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Nous pouvons maintenant générer les scènes en utilisant la commande fgfs-construct. Lancez la commande avec <code>--help</code> pour obtenir les informations d'utilisation. <br />
<br />
Nous devons définir :<br />
* Les répertoires de travail (--work-dir) et de sortie (--output-dir) .<br />
** '''Notez''', au sujet du répertoire de sortie : il doit pointer vers le répertoire <tt>Terrain/</tt>, sinon, les versions récentes FlightGear seront incapables de charger le terrain.<br />
* Le centre de la scène que nous voulons générer (--lat, --lon).<br />
* Le rayon (--xdist, --ydist) à partir duquel on génère.<br />
* Tous les répertoires de travail à inclure dans la scène.<br />
<br />
Par exemple :<br />
{{Pre2|<nowiki>fgfs-construct --work-dir=./work --output-dir=./output/Terrain --lon=55 --lat=60 --xdist=3 --ydist=3 AirportArea SRTM-3 AirportObj Stream Bog IrrCropPastureCover Town Lake Urban Landmass Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
Lorsque cette commande se termine, le répertoire de sortie contiendra un sous-répertoire scenery. Pointez vers lui en paramétrant [[$FG_SCENERY]] ou en utilisant l'option de ligne de commande --fg-scenery à fgfs, et testez votre nouvelle scène !<br />
<br />
== Un soucis ? ==<br />
Vous trouverez ci-dessous une liste de problèmes courants et leur solutions. Dans le doute, copiez/collez votre erreur dans Google. La plupart des problèmes (en particulier lors de la compilation de TerraGear) ont déjà été évoqués :<br />
<br />
* Crash de genapts. Quelquefois, genapts plante avec certains aéroports. Dans ce cas, essayez de le relancer avec l'argument --start-id pour démarrer à l'aéroport sur lequel il a planté, et l'argument --nudge pour essayer de remettre les calculs dans la bonne voie.<br />
* fgfs-construct tué. Le processus fgfs-construct peut se suicider s'il consomme trop de ressources système. L'augmentation des valeurs pour setrlimit dans src/BuildTiles/Main/main.cxx est la meilleure solution.<br />
* Les aéroports apparaissent au fond de trous, ou il y a des espaces entre les aéroports et la scène. Ceci arrive lorsque genapts est incapable de trouver la donnée d'élévation correcte, ou alors la donnée d'élévation a changé entre le lancement de genapts et celui de shape-decode. Essayez de générer un seul aéroport dans votre zone de scène en utilisant genapts, et visualisez la sortie. En particulier, soyez sûr que le répertoire work/SRTM-3 existe. <br />
* Seuls les aéroports apparaissent dans la scène. Il existe trois explications typiques :<br />
** vous n'avez pas téléchargé les fichiers-formes corrects de la zone;<br />
** vous n'avez pas lancé shape-decode sur le fichier-forme v0_landmass comme Default <br />
** vous n'avez pas inclus les répertoires corrects dans fgfs-construct. <br />
* La scène générée contient des données effacées des fichiers-formes. Si vous éditez des fichiers-formes, vous devez effacer le sous-répertoire work approprié avant de lancer shape-decode. Sinon, vos changements s'ajouteront à ceux qui existent déjà.<br />
* La scène entière est plate et au niveau de la mer. C'est généralement dû au fait que vous n'avez pas inclus les données d'élévation dans votre commande fgfs-construct. Assurez-vous qu'il existe un répertoire STRM-3 précisé dans la ligne de commande. <br />
* Tout terrain copie le matériel d'un fichier-forme. Vous avez probablement oublié de mettre chacun des fichiers-formes téléchargés dans un répertoire séparé à l'intérieur du répertoire Data/shapefiles. <br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement]]<br />
[[en:Using TerraGear]]</div>Puchaczhttps://wiki.flightgear.org/w/index.php?title=Fr/Utiliser_TerraGear&diff=105985Fr/Utiliser TerraGear2016-11-18T21:17:37Z<p>Puchacz: </p>
<hr />
<div>[[File:Terragearprocesschart.png|thumb|Organigramme de TerraGear]]<br />
Le projet logiciel [[Fr/TerraGear|TerraGear]] participe au projet [[Fr/FlightGear|FlightGear]] en créant les fichiers utilisés par celui-ci pour représenter le relief et la texture de la Terre, ce qui comprend les aéroports, villes, champs, forêts, rivières, routes, etc. Le logiciel TerraGear lit des fichiers de données contenant l'élévation du sol, le positionnement et l'agencement des aéroports, les données géographiques d'occupation du sol, entre autres et produit les fichiers de scènes utilisés par Flightgear pour représenter la surface de la planète.<br />
<br />
Par simplicité et commodité, la plupart des utilisateurs de FlightGear téléchargent simplement les fichiers plug-and-play des scènes à partir du serveur de scènes de FlightGear, ou utilisent [[Fr/TerraSync|TerraSync]] pour télécharger automatiquement les scènes à la demande. Mais il peut y avoir des cas où vous voudriez utiliser TerraGear pour générer vos propres fichiers terrain, plutôt que de télécharger les scènes standard de FlightGear.<br />
<br />
Par exemple, si vous utilisez [[WorldEditor]] pour modifier/améliorer les information concernant un taxiway/une aire de trafic d'un [[:Category:Airports|aéroport]], vous pourriez avoir envie de visualiser à quoi ressemblerait cet aéroport modifié dans les scènes avant de décider que les résultats vous conviennent. Peut-être que les scènes officielles sont trop détaillées pour votre machine un peu ancienne, et que vous voudriez construire un terrain avec un modèle numérique de d'élévation (DEM) de plus faible résolution, afin de diminuer le nombre de polygones et ainsi augmenter votre taux de rafraîchissement d'image. Soit vous avez une machine ultra-rapide, et vous voulez construire votre propre terrain avec des données vectorielles de plus haute résolution (vmap1, Tiger, osm) pour obtenir de meilleures routes/rivières. Pour toutes ces raisons, apprendre à utiliser TerraGear est une bonne idée.<br />
<br />
== Obtenir TerraGear ==<br />
Vous pouvez soit compiler TerraGear vous-même, ou bien télécharger un binaire pré-compilé, cette dernière démarche étant plus aisée et donc recommandée pour les débutants.<br />
<br />
* '''Option 1 - Télécharger TerraGear pré-compilé (recommandé aux débutants) sur Windows'''<br />
*# Téléchargez la dernière version de TerraGear sur le [http://build.flightgear.org:8080/job/TerraGear-Win-Cmake/lastSuccessfulBuild/artifact/*zip*/archive.zip Serveur de compilation de FlightGear].<br />
*# Créez ou choisissez un répertoire pour contenir les outils TerraGear. <br />
*# Dé-zippez le paquetage et déplacez les fichiers de <tt>archive/install/msvc100/TerraGear/bin</tt> dans un sous-répertoire nommé <tt>Terragear/</tt> dans le répertoire de base.<br />
<br />
* '''Option 1b - Télécharger les paquetages ppa pour Ubuntu Linux'''<br />
<br />
https://launchpad.net/~saiarcot895/+archive/ubuntu/flightgear-edge/+index?batch=75&memo=75&start=75<br />
<br />
* '''Option 2 - Compiler TerraGear à partir du code source, comme expliqué dans [[Fr/TerraGear#Compilation|cet article]].<br />
<br />
{{note|1=Vous pourriez avoir besoin du fichier <code>default_priorities.txt</code> qui peut être obtenu à partir du {{terragear source|path=src/BuildTiles/Main/default_priorities.txt|text=dépôt Git}} ou à partir de l'archive téléchargée à partir du serveur de compilation (dans le sous-répertoire <code>archive/install/msvc100/TerraGear/share</code>). Voir [http://forum.flightgear.org/viewtopic.php?f=5&p=77950 ce lien du forum] pour les détails.}}<br />
<br />
=== Interface graphique ===<br />
L'interface graphique [[TerraGear GUI]] est disponible pour ceux voudraient utiliser TerraGear sans avoir à connaître/utiliser les options de ligne de commande.<br />
<br />
== Utilisation de TerraGear ==<br />
Tout d'abord, choisissez les limites de la zone de scène que vous voulez construire, en termes de latitude et de longitude. Plus la zone à générer sera restreinte, plus la quantité de données et le temps CPU nécessaire seront limités. Par exemple, si vous voulez juste générer une nouvelle disposition d'aéroport à la position 12°3 Ouest et 34°4 Nord, la génération des scènes entre 34°N 12°O et 35°N 13°O sera suffisante. <br />
<br />
Notez la boîte de délimitation (longitudes et latitudes minimum et maximum) pour la scène que vous voulez générer. Rappelez-vous que Ouest et Sud sont négatifs - c'est-à-dire que 4° Ouest 10° Sud doit être -4, -10. Essayez de ne pas vous mélanger les pinceaux, sinon la scène ou l'aéroport que vous créez se retrouvera de l'autre côté de la planète !<br />
<br />
Vous aurez affaire avec différents types de données utilisant des formats variés. Créez un nouveau répertoire pour votre travail de scène, puis créez à l'intérieur créez les sous-répertoires suivants : <br />
<br />
* '''data/''' - pour les données brutes et pré-calculées (par exemple, les fichiers d'élévation) <br />
* '''output/''' - pour les fichiers de scènes que vous créerez<br />
* '''work/''' - pour les données qui ont été calculez (par exemple par shape-decode) et qui sont prêtes à être intégrées dans la scène<br />
<br />
=== Obtenir et traiter les données ===<br />
Terragear utilise trois sortes d'informations différentes pour générer une scène :<br />
<br />
# L'élévation du terrain (fournie par SRTM)<br />
# L'emplacement et la disposition des aéroports (fournis par apt.dat ou un fichier .dat personnalisé) <br />
# Si une lat/lon donnée correspond à la mer, la terre, une ville, une forêt, un village, une route, un chemin de fer (fourni par VMAP0, [[CORINE]], etc. ou par des fichiers personnalisés de formes)<br />
<br />
Cet article décrit comment obtenir et traiter chacun de ces types de données dans l'ordre, et les fournir ensemble, pour que FlightGear les utilise. L'ordre de ces étapes est important. Par exemple, l'étape des données d'un aéroport a besoin des données d'élévation pour déterminer l'élévation des aéroports. Ainsi, vous commencerez par préparer les données d'élévation.<br />
<br />
'''<u>Remarque :</u> pour que votre travail puisse être intégré dans les scènes officielles de FlightGear, toutes les données <u>doivent</u> provenir de sources compatibles avec la licence [[GNU GPL]] !'''<br />
<br />
==== Données d'élévation ====<br />
Les meilleures données d'élévation actuellement disponibles proviennent du projet Shuttle Radar Topography Mission (SRTM). Il y a deux types de données SRTM :<br />
* Données de haute précision (1-arc seconde), ou SRTM-1, pour les USA<br />
* Données de précision moindre (3-arc second), ou SRTM-3, pour le reste du monde<br />
A partir de maintenant, nous supposerons que vous utilisez les données SRTM-3. Sauf mention contraire, le processus est identique pour SRTM-1.<br />
<br />
Vous pouvez télécharger les données appropriées à partir du site http://dds.cr.usgs.gov/srtm/version2_1/. Vous devrez récupérer tous les fichiers .hgt.zip couvrant la région qui vous intéresse. Selon la taille de votre scène, cela peut représenter un grand nombre de fichiers. Téléchargez les vers l'emplacement <tt>data/SRTM-1/</tt>(ou SRTM-3/SRTM-30 en fonction du type de données que vous téléchargez) dans votre répertoire de base. (Genapts recherchera ses données parmi un ensemble de noms de répertoires prédéfinis dans son répertoire de travail. SRTM-30 est l'un d'eux, c'est le moins déroutant dans cette liste. Notez que, à compter du 31 juillet 2010, l'outil genapts prend également en compte l'existence de répertoires SRTM-1/SRTM-3. Si vous utilisez une version plus ancienne, pensez à fournir les répertoires en utilisant --dem-path)<br />
<br />
Maintenant que nous avons les données, nous devons les convertir pour qu'elles puissent servir à TerraGear. Tout d'abord, dézippez chacun des fichiers .hgt. Ensuite, ouvrez la ligne de commande (Sous Windows: <tt>Démarrer > Exécuter > cmd.exe</tt>) et placez-vous dans le répertoire de base (<tt>cd .../.../TerraGear</tt>). <br />
* '''NOTE :''' si vous voulez créer un fichier batch, remplacez <tt>%f</tt> avec <tt>%%f</tt>, voir à ce sujet : [http://technet.microsoft.com/en-us/library/bb490909.aspx]<br />
* '''NOTE :''' pour les données SRTM-1, remplacez le <tt>3</tt> par un <tt>1</tt> dans le premier argument fourni à hgtchop<br />
<br />
Pour Windows :<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 %f .\work\SRTM-3<br />
ou<br />
for %f in (.\data\SRTM-3\*.hgt) do .\Terragear\hgtchop.exe 3 .\data\SRTM-3\%f .\work\SRTM-3<br />
<br />
Pour Linux :<br />
for i in $PWD/data/SRTM-3/*.hgt; do ./Terragear/hgtchop 3 $i $PWD/work/SRTM-3; done<br />
<br />
Maintenant, vous allez obtenir une quantité importante de fichiers .arr.gz dans votre répertoire work/SRTM-3/. Il nous faut les convertir au format .fit.gz. Utilisez à nouveau la ligne de commande avec<br />
* '''NOTE:''' l'espace et le point à la fin sont importants !<br />
<br />
Pour Windows :<br />
.\Terragear\terrafit.exe work\SRTM-3<br />
<br />
Pour Linux :<br />
./Terragear/terrafit work/SRTM-3<br />
<br />
==== Données d'aéroports ====<br />
Maintenant que nous avons les données d'élévation, nous pouvons générer nos aéroports. Tout d'abord, créons un répertoire <tt>data/airports/</tt> et copions-y le fichier apt.dat. Ceci peut être effectué soit directement à partir de votre paquetage de FlightGear (bien que vous devrez le dé-zipper), soit il peut correspondre au fichier que vous auriez modifié avec [[TaxiDraw]].<br />
<br />
La commande pour créer les aéroports est "genapts". Lancez-la sans arguments, afin de visualiser les différentes options de ligne de commande.<br />
<br />
Si elle est simplement lancée avec un fichier apt.dat spécifié et le répertoire de travail, elle génèrera les agencements d'aéroports pour chaque aéroport contenu dans le fichier, ce qui peut être long. <br />
<br />
Si vous créez juste un seul aéroport, et que vous connaissez son identifiant OACI (par exemple [[KSFO]], EGPH, EG32), utilisez cet identifiant comme suit à partir du répertoire racine de vos scènes (c'est à dire à partir du répertoire parent de vos répertoires data, work et output). Si vous utilisez un fichier apt.dat contenant un seul aéroport, vous pouvez omettre le paramètre "--airport". <br />
<br />
genapts --input=data/airports/apt.dat --work=./work --airport=<IDENTIFIANT_OACI_AEROPORT><br />
<br />
Si vous générez des scènes plus grandes, alors vous pouvez spécifier les longitudes et latitudes minimum et maximum.<br />
<br />
Genapts va créer deux sous-répertoires dans votre répertoire work:<br />
* AirportArea/<br />
* AirportObj/<br />
<br />
Ils contiennent les définitions des agencement de l'aéroport, et de certains objets présents (par exemple les manches à air). <br />
<br />
==== Données d'utilisation du sol ====<br />
Les dernières données que nous avons besoin de générer sont celles correspondant au type d'utilisation du sol. En général, elles proviennent du lot de données VMAP0 en tant que fichiers de formes en provenance du serveur de carte de la base de données des scènes, mais d'autres sources peuvent aussi être utilisées.<br />
<br />
Les données d'utilisation du sol peuvent être séparées en différents types :<br />
<br />
* '''Landmass :''' sépare la terre de la mer. Ces données sont utilisées comme masque pour toutes les autres données. Les plus couramment utilisées sont le Landmass VMAP0, mais GSHHS peut également être utilisé.<br />
* '''Land use data :''' définit si une portion de terrain correspond à une forêt, une zone urbaine, du sable, de la lave, des glaciers, etc. Ce sont généralement données VMAP0 définies en tant que polygones.<br />
* '''Line data :''' comprend les lignes de chemins de fer, les rivières, les routes. Typiquement VMAP0, mais aussi OpenStreetMap pour les routes.<br />
* '''Point data :''' est actuellement uniquement utilisé pour définir les villes.<br />
<br />
De loin, le moyen le plus facile pour obtenir ces données est de télécharger à partir du magnifique [http://mapserver.flightgear.org MapServer] les fichiers formes pour une zone de scène donnée. Cliquez sur le lien "Download Shapefiles" (ou allez directement à : http://mapserver.flightgear.org/download.psp). Entrez dans la boîte de délimitation de la scène que vous désirez générer, sélectionnez le type de données de fichier-formes que vous voulez, et cliquez sur '''download'''. Pour les scènes de base, prenez tout ce qui est listé sous VMap0 (c'est-à-dire utilisant le préfixe v0_).<br />
<br />
Téléchargez chaque fichier-forme dans un répertoire séparé (!) <tt>data/shapefiles/...</tt>. Ainsi, pour v0_landmass, vous obtiendriez <tt>data/shapefiles/v0_landmass/v0_landmass.shp</tt>, etc.<br />
<br />
Vous pouvez charger ces fichiers-formes dans un éditeur SIG tel que [[QGIS]] ou GRASS pour les visualiser et les éditer. C'est une bonne idée pour vérifier que vous avez bien les bons fichiers ! Plus tard, vous pourrez expérimenter en remplaçant divers fichiers-formes avec d'autres versions (GSHHS pour la côte, OSM pour les routes, etc.).<br />
<br />
L'étape suivante décode les fichiers-formes vers le format TerraGear en utilisant la commande '''ogr-decode''' . <br />
<br />
Il y a trois arguments de ligne de commande importants pour ogr-decode :<br />
* le répertoire de destination pour les données décodées,<br />
* la localisation du répertoire de fichiers-formes,<br />
* le type de matériau.<br />
<br />
Chaque fichier-forme correspond avec un des types de matériau défini dans les fichiers materials.xml. La correspondance est assez évidente. Par exemple, v0_mixedcroppasturecover correspond à MixedCropPastureCover. Notez que les types de matériau sont sensibles à la casse, donc il est bon de se référer au fichier <tt>[[$FG ROOT]]/materials.xml</tt> pour vérifier. L'exception est v0_landmass, qui DOIT correspondre au type Default.<br />
<br />
En complément, il existe de nombreux arguments optionnels pour indiquer la largeur des données linéaires (pour les routes, les rivières, les voies de chemin de fer), quelle largeur utiliser pour les données de type point (pour les villes) et quelle est la plus grande longueur acceptable pour une ligne droite.<br />
<br />
Par exemple, pour décoder le fichier-forme v0_landmass, vous entrez la commande suivante :<br />
<br />
ogr-decode --max-segment 500 --area-type Default work/Landmass data/shapefiles/v0_landmass<br />
<br />
Pour créer des rivières de 10 mètres de large :<br />
<br />
ogr-decode --max-segment 500 --line-width 10 --area-type Stream work/Stream data/shapefiles/v0_stream<br />
<br />
Pour générer des villes d'environ 1 kilomètre de diagonale :<br />
<br />
ogr-decode --point-width 500 --area-type Town work/Town data/shapefiles/v0_town<br />
<br />
Lancez cette commande pour chaque fichier-forme du lot de données.<br />
<br />
== Générer les scènes ==<br />
Vous avez maintenant un répertoire de travail, avec des sous-répertoires comme :<br />
{|<br />
|<br />
: AirportArea<br />
: AirportObj<br />
: Bog<br />
: DryCropPastureCover<br />
: EvergreenBroadCover<br />
: GrassCover<br />
: IrrCropPastureCover<br />
: Lake<br />
: Landmass<br />
: Marsh<br />
: MixedCropPastureCover<br />
| valign="top" |<br />
: MixedForestCover<br />
: Railroad<br />
: Road<br />
: Sand<br />
: ScrubCover<br />
: Shared<br />
: SRTM-3<br />
: Stream<br />
: Town<br />
: Urban<br />
|}<br />
<br />
Nous pouvons maintenant générer les scènes en utilisant la commande fgfs-construct. Lancez la commande avec <code>--help</code> pour obtenir les informations d'utilisation. <br />
<br />
Nous devons définir :<br />
* Les répertoires de travail (--work-dir) et de sortie (--output-dir) .<br />
** '''Notez''', au sujet du répertoire de sortie : il doit pointer vers le répertoire <tt>Terrain/</tt>, sinon, les versions récentes FlightGear seront incapables de charger le terrain.<br />
* Le centre de la scène que nous voulons générer (--lat, --lon).<br />
* Le rayon (--xdist, --ydist) à partir duquel on génère.<br />
* Tous les répertoires de travail à inclure dans la scène.<br />
<br />
Par exemple :<br />
{{Pre2|<nowiki>fgfs-construct --work-dir=./work --output-dir=./output/Terrain --lon=55 --lat=60 --xdist=3 --ydist=3 AirportArea SRTM-3 AirportObj Stream Bog IrrCropPastureCover Town Lake Urban Landmass Railroad DryCropPastureCover Road EvergreenBroadCover Marsh Sand MixedCropPastureCover ScrubCover GrassCover MixedForestCover</nowiki> }}<br />
<br />
Lorsque cette commande se termine, le répertoire de sortie contiendra un sous-répertoire scenery. Pointez vers lui en paramétrant [[$FG_SCENERY]] ou en utilisant l'option de ligne de commande --fg-scenery à fgfs, et testez votre nouvelle scène !<br />
<br />
== Un soucis ? ==<br />
Vous trouverez ci-dessous une liste de problèmes courants et leur solutions. Dans le doute, copiez/collez votre erreur dans Google. La plupart des problèmes (en particulier lors de la compilation de TerraGear) ont déjà été évoqués :<br />
<br />
* Crash de genapts. Quelquefois, genapts plante avec certains aéroports. Dans ce cas, essayez de le relancer avec l'argument --start-id pour démarrer à l'aéroport sur lequel il a planté, et l'argument --nudge pour essayer de remettre les calculs dans la bonne voie.<br />
* fgfs-construct tué. Le processus fgfs-construct peut se suicider s'il consomme trop de ressources système. L'augmentation des valeurs pour setrlimit dans src/BuildTiles/Main/main.cxx est la meilleure solution.<br />
* Les aéroports apparaissent au fond de trous, ou il y a des espaces entre les aéroports et la scène. Ceci arrive lorsque genapts est incapable de trouver la donnée d'élévation correcte, ou alors la donnée d'élévation a changé entre le lancement de genapts et celui de shape-decode. Essayez de générer un seul aéroport dans votre zone de scène en utilisant genapts, et visualisez la sortie. En particulier, soyez sûr que le répertoire work/SRTM-3 existe. <br />
* Seuls les aéroports apparaissent dans la scène. Il existe trois explications typiques :<br />
** vous n'avez pas téléchargé les fichiers-formes corrects de la zone;<br />
** vous n'avez pas lancé shape-decode sur le fichier-forme v0_landmass comme Default <br />
** vous n'avez pas inclus les répertoires corrects dans fgfs-construct. <br />
* La scène générée contient des données effacées des fichiers-formes. Si vous éditez des fichiers-formes, vous devez effacer le sous-répertoire work approprié avant de lancer shape-decode. Sinon, vos changements s'ajouteront à ceux qui existent déjà.<br />
* La scène entière est plate et au niveau de la mer. C'est généralement dû au fait que vous n'avez pas inclus les données d'élévation dans votre commande fgfs-construct. Assurez-vous qu'il existe un répertoire STRM-3 précisé dans la ligne de commande. <br />
* Tout terrain copie le matériel d'un fichier-forme. Vous avez probablement oublié de mettre chacun des fichiers-formes téléchargés dans un répertoire séparé à l'intérieur du répertoire Data/shapefiles. <br />
<br />
{{Terra}}<br />
<br />
[[Category:Scenery enhancement]]<br />
[[en:Using TerraGear]]</div>Puchacz