FlightGear wiki - User contributions [en]

Portal:Developer

2008-09-30T23:49:34Z

Alfonsodg:

<div align="center">
[[Portal:Developer|Developer]] - [[Portal:User|User]]
</div>

{|style="border-spacing:8px; margin:0px -8px;"
|class="MainPageBG" style="width:100%; border:1px solid #d9e2e2; background:#efefef; vertical-align:top; color:#000;"|
{|width="100%" cellpadding="1" cellspacing="5" style="vertical-align:top; background:#efefef;"
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">The Developer Portal</h2>
|-
|style="color:#000;"|
This portal is for developers contributing to FlightGear. If you wanna help with FlightGears development, it's a good idea to subscribe yourself to the [http://lists.sourceforge.net/lists/listinfo/flightgear-devel FlightGear devel] mailing list. The [http://sourceforge.net/mailarchive/forum.php?forum_name=flightgear-devel list archive] is also available and should be searched before posting the same question.<br><br>
'''The FlightGear project is looking for organizations/individuals who would be willing to help sponsor a fulltime project coordinator/manager to help oversee the overall development process If you are interested in helping or have anything else to contribute to this issue, please subscribe to the the [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg11813.html FlightGear Devel mailing list] to discuss details.'''
|}
|}

{|style="border-spacing:8px; margin:0px -8px;"
|class="MainPageBG" style="width:50%; border:1px solid #d9e2e2; background:#efefef; vertical-align:top; color:#000;"|
{|width="100%" cellpadding="2" cellspacing="5" style="vertical-align:top; background:#efefef;"
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Latest Organizational Issues</h2>
|-
|style="color:#000;"|
* [[ Project Infrastructure Enhancements ]]
* [[Google Summer of Code Candidate Projects]] - application template to allow community members to prepare a possible application to decrease the effort required to actually apply
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Background Info</h2>
|-
|style="color:#000;"|
* [[Resources]]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Compiling</h2>
|-
|style="color:#000;"|
* [[ Building Flightgear ]]
* [[ Building Flightgear - Windows]]
* [[ Building FlightGear Launch Control ]]
* [[ Building Terragear ]]
* [[ Keeping FlightGear (win32) up to date without compiling]]
* [[ OpenSceneGraph ]]
* [[ Tools of the Trade ]]
* [[ Using TortoiseCVS with FlightGear ]]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Contributing</h2>
|-
|style="color:#000;"|
* [[ Code Cleanup ]]
* [[ Contributor Repositories ]] mirrors, branches and forks privately maintained by contributors
* [[ Development Resources ]]
* [[ Extension Support ]]
* [[ Submitting Patches ]]
* [[ Technical Reports ]]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Code Internals</h2>
|-
|style="color:#000;"|
* [[Command Parameters]]
* [[ FDM API ]]
* [[ File Formats ]]
* [[ Initialization Sequence ]]
* [[ Nasal scripting language ]]
* [[ Property Tree ]]
* [[ Subsystems ]]
* [[ UML Diagrams ]]
* [[ YASim ]]
* [[ FlightGear 1.0 aircraft names for command line‎|1.0.0 a/c names for command line]]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Current Efforts/Branches & Work in Progress</h2>
|-
|style="color:#000;"|
*Warning! These links outdated, and some of these projects are finished:
* [http://www.flightgear.org/forums/viewtopic.php?t=1378 Efforts to create photo realistic scenery for FlightGear] (Images: [http://www.brest-metropole-oceane.fr/vueduciel/images/101_106.jpg] [http://blaniel.free.fr/pub/flightgear/brest/brest1.png] [http://helijah.free.fr/LFRB/fgfs-screen-001.jpg] [http://helijah.free.fr/LFRB/fgfs-screen-003.jpg]
* [http://www.flightgear.org/forums/viewtopic.php?t=755 New aircraft model under development: Bede BD-5J]
* [http://www.flightgear.org/forums/viewtopic.php?t=542 F14-Tomcat aircraft model under development] ([[Grumman F-14 Tomcat|F-14 released!]])
* [http://www.flightgear.org/forums/viewtopic.php?t=1001 787 being revamped]
* [http://www.flightgear.org/forums/viewtopic.php?t=1436 LFLJ enhancements]
* [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg16176.html Free Walking mode for FlightGear using the Jeep vehicle in CVS]
* [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg15388.html Random Trees for FlightGear]

'''[[Work in progress|More...]]'''
|-
|}

|class="MainPageBG" style="width:50%; border:1px solid #d9e2e2; background:#efefef; vertical-align:top"|
{| width="100%" cellpadding="2" cellspacing="5" style="vertical-align:top; background:#efefef;"
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Todo</h2>
|-
|style="color:#000;"|
* [[ Bugs ]]
* [[ Feature Requests / Proposals / Ideas ]]
* [[ FGFS Todo ]]
* [[ FlightGear Expo Checklist ]]
* [[ Long Term Goals ]]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Done</h2>
|-
|style="color:#000;"|
* [[ Changes since 0.9.10 ]]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">HowTos</h2>
|-
|style="color:#000;"|
* [[Howto: Add smooth ("Ambient Occlusion") shadows in Blender|Add smooth shadows in Blender]]
* [[Howto: 3D Aircraft Models|3D Aircraft Models]]
* [[Howto: Add aircraft lights|Add aircraft lights]]
* [[Howto: Edit a livery|Edit a livery]]
* [[Howto: Illuminate faces|Illuminate faces]]
* [[Howto: Make a helicopter|Make a helicopter]]
* [[Howto: Set up a multiplayer server|Set up a multiplayer server]]
'''[[:Category:Howto|More...]]'''
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Instrumentation</h2>
|-
|style="color:#000;"|
* [[ Creating instruments for FG ]]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Nasal scripting</h2>
|-
|style="color:#000;"|
* [[ Nasal scripting language ]]
* [[ Writing simple scripts in %22nasal%22 ]]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Autopilot configuration</h2>
|-
|style="color:#000;"|
* [http://www.flightgear.org/Docs/XMLAutopilot/ FlightGear Autopilot] (Theory, Configuration, and Tuning)
* [[ Autopilot Tuning Resources ]]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">3D Modeling</h2>
|-
|style="color:#000;"|
* [[ Howto: 3D Aircraft Models|3D Aircraft Models]] (howto)
* [[ Aircraft Information Resources ]]
* [[ Model Import and Export ]]
* [[ Modeling - FAQ ]]
* [[ Modeling - Getting Started ]]
* [[ Modeling Resources ]]
* [[ Modeling - SketchUp]]
* [[ Normals and Transparency Tutorial ]]
* [http://en.wikibooks.org/wiki/Blender_3D:_Noob_to_Pro Blender3D Modeling]
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Scenery</h2>
|-
|style="color:#000;"|
* [[ Blender Ground Signs Tutorial]]
* [[ Placing 3D Objects with the UFO ]]
* [[ Signs ]] (placing and explanation)
* [[ Using Terragear ]]
* [[ Using the Custom Scenery TerraGear Toolset ]]
* [[ Building_terragear-cs_in_Ubuntu_64|Building Terragear-cs in Ubuntu Hardy]]
|-
|}
|}

__NOTOC__
__NOEDITSECTION__

== Developer Documentation ==
=== RFC Topics ===
'''Clarification:'''In its current form, the RFC section is exclusively based on and covered by previous mailing list and forum discussions (as well as various wiki entries), as such it is not supposed to reflect work in progress (RFC="Request For Comments" and not WIP), but is rather to be seen as an attempt to provide comprehensive analyses and summaries of key issues identified in various FlightGear related discussions and feature requests (which are to be linked to in the corresponding resource sections, if that didn't yet take place, it's because of most of these RFCs being indeed WIP).

Thus, RFC entries are not meant to imply anyone "working" on any of these issues, in fact only because an RFC entry is listed here doesn't necessarily mean that work on that particular issue is endorsed by the FlightGear community.

* [[Next Generation Scenery ]] - revamping the FG scenery engine
* [[Keyboard function priority list]] - reorganizing FlightGear keybindings
* [[FlightGear Sessions]] - discussing possible steps to finally allow aircraft to be reliably switched at runtime
* [[Formalizing Aircraft Status]] - discussing suggestions about how to more properly describe aircraft development status
* [[Simplifying Aircraft Deployment]] - identifying potential steps to simplify deployment of FlightGear aircraft
* [[FDM engine feature standardization]] - discussing possible steps to standardize feature support of mainstream FlightGear FDM engines
* [[FlightGear Glass Cockpits]] - discussing required infrastructure changes to enable non-developers to easily access FlightGear-internals in order to enable them to model complex glass cockpit-type aircraft instrumentation systems
* [[Recommended Property Tree Enhancements]] - discussing possible property tree enhancements to help ensure integrity of crucial runtime state
* [[Backwards Compatibility Initiative]] - discussing possible ways to improve FlightGear's backwards compatibility
* [[Recommended Project Policies]] - discussing recommended policies for future contributions to the project
* [[Distributed Interactive Simulation]] - discussing possible steps to prepare FlightGear for HLA
* [[Property Tree Reorganization]] - reorganizing the property tree (i.e. implementing and enforcing existing property/node naming conventions)

=== Miscellaneous ===
* [[ Glass Cockpit Projects ]]
* [[ Copyright Inquiry ]]
* [http://www.cafepress.com/fgfs_gear FlightGear - Gear]
* [[ Sign Specification Proposal ]]

== Middleware & Base Package Development ==

* [[:Category:Aircraft TODO]]

=== Misc ===
* [[FGSD- How to make a airport]]

{{buidling}}

Main Page

2008-09-30T23:47:37Z

Alfonsodg:

{| style="width:100%; background:#efefef; margin-top:1.2em; border:1px solid #d9e2e2;"
|style="width:56%; color:#000"| 
{| style="width:70%; border:solid 0px; background:none;"
|style="width:500px; text-align:center; white-space:nowrap; color:#000;"|
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;">Welcome to the FlightGear Wiki,</div>
<div id="articlecount" style="width:100%; text-align:center; font-size:85%;">There are now [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles here.</div>
|}
|style="width:11%; font-size:95%; color:#000;"|
|}
{|style="width:100%; background:none; margin:-.8em 0 -.7em 0;"
|style="font-size:95%; padding:10px 0; margin:0px; text-align:left; white-space:nowrap; color:#000;"| [[Help:Tutorial|Editing]] '''·''' [[Help:Contents|Help]]
|style="font-size:95%; padding:10px 0; margin:0px; text-align: right; white-space:nowrap; color:#000;"| [[Special:Allpages|All pages]] '''·''' [[Special:Search|Search]]
|}

{|style="border-spacing:8px; margin:0px -8px;"
|class="MainPageBG" style="width:100%; border:1px solid #d9e2e2; background:#efefef; vertical-align:top; color:#000;"|
{|width="100%" cellpadding="1" cellspacing="5" style="vertical-align:top; background:#efefef;"
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">FlightGear Flight Simulator</h2>
|-
|style="color:#000;"|
'''FlightGear''' Flight Simulator is an open-source flight simulator created by the FlightGear project. Source code for the entire project is available from a [[CVS]] repository and licensed under [[GNU General Public License]] ([http://www.gnu.org/copyleft/gpl.html GPL]). FlightGear [[FlightGear 1.0.0|1.0]] was [[FlightGear 1.0 features showcase|released]] in December 2007 ([http://www.flightgear.org/Gallery-v1.0/ v1.0 Gallery]). FlightGear is in the midst of software architecture transition from PLIB to OSG.

The goals of the [[FlightGear]] project include creating a sophisticated flight simulator framework for use in research or academic environments, for the development and pursuit of other interesting flight simulation ideas, and as an end-user application. It can be expanded and improved upon by anyone interested in [[Volunteer|contributing]], and has many [http://www.flightgear.org/links.html related projects].

FlightGear comes with a set of illustrated documentation, notably
"[[The Manual]]", which is available as
[ftp://ftp.de.flightgear.org/pub/fgfs/Docs/getstart.pdf PDF] and
[http://www.flightgear.org/Docs/getstart/getstart.html HTML]. The FlightGear Wiki was started in 2006 and currently covers a wide range of FlightGear related topics.

'''Please choose a portal:'''
* [[Portal:User|User]]
* [[Portal:Developer|Developer]]

===== '''If you are new, please check the [[Help:Your_first_article|manual]] before you start editing or creating articles!''' =====
|-
|}
|}


{|style="border-spacing:8px; margin:0px -8px;"
|class="MainPageBG" style="width:50%; border:1px solid #d9e2e2; background:#efefef; vertical-align:top; color:#000;"|
{|width="100%" cellpadding="2" cellspacing="5" style="vertical-align:top; background:#efefef;"
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Getting Started</h2>
|-
|style="color:#000;"|
* [[New to FlightGear ]]
* [[FAQ ]]
* [[Troubleshooting Problems ]]
* [[Howto: Multiplayer|Multiplayer Setup]]
* [[Building_terragear-cs_in_Ubuntu_64|Building Terragear in Ubuntu]]

'''[[Portal:User|More...]]'''
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Using FlightGear</h2>
|-
|style="color:#000;"|
* [[Aircraft]]
* [[Helicopter]]
* [[Flying the helicopter|Helicopter flying]]
* [[Table of models]]
'''[[Portal:User|More...]]'''
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Upcoming events</h2>
|-
|style="color:#000;"|
* '''November 1+2 2008:''' [http://www.fsweekend.com FS Weekend] in Aviodrome (Lelystad Airport, The Netherlands) (see [[FS Weekend 2008]])
'''[[Current_events|More...]]'''
|-
|}
|class="MainPageBG" style="width:50%; border:1px solid #d9e2e2; background:#efefef; vertical-align:top"|
{| width="100%" cellpadding="2" cellspacing="5" style="vertical-align:top; background:#efefef;"
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Picture of the day</h2>
|-
|style="color:#000;"|
{{POTD protected/{{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}}}
|-
! <h2 style="margin:0; background:#0f7a71; font-size:120%; font-weight:bold; border:1px solid #d9e2e2; text-align:left; color:white; padding:0.2em 0.4em;">Did you know...</h2>
|-
|style="color:#000;"|
* ...that you can now walk through some of the aircraft cabins?
* ...that FlightGear's first release was in July 1997. FlightGear is almost 11 years old!
* ...that you can toggle the menubar on or off by pressing F10, and even change the GUI style by pressing Shift + F10?
'''[[Did you know...|More...]]'''
|-
|}
|}

__NOTOC__
__NOEDITSECTION__

Howto:Place 3D objects with the UFO

2008-05-28T02:31:59Z

Alfonsodg: /* Placing objects */

'''Placing 3D objects inside Flightgear scenery using the UFO'''

A very useful tool for placing objects within the scenery, created by Melchior Franz, is available with Flightgear 0.9.10 and later. It is an addon to the [[UFO from the 'White Project' of the UNESCO|UFO]] aircraft which allows a user to place a new (or old) 3D object at any arbitrary location in the scenery with just a few clicks of the mouse.

=Selecting the ufo=
The first thing you need is a 3d model file to place in the scenery; let's say we'll use a catii-iii.xml object. You must save it in a path where this UFO feature can find it. The UFO searches the objects in the Flightgear/data/Models/ directory. In this example, we create a subdirectory called Tabu and save our catii-iii.xml there.

[[Image:Placing_objects_with_UFO_html_m49fbed81.jpg]]

Now start Flightgear, and choose UFO as your aircraft.

=Placing objects=
Once Flightgear has been started, fly with the UFO to the place you want the model to be positioned.

You must be sure about the size of the object in reference with the scene, it means: try to obtain the right value using some tools. Particulary, i recommend combine Googleearth and the rule tool and some size definition in the 3D software for obtain the right size, in my case, i have use Blender and the Caliper script. -- Alfonso de la Guarda

[[Image:Placing_objects_with_UFO_html_5fa8d7b1.jpg]]

Let's say we want to position the catii-iii.xml object at the end of a taxiway. We stop the UFO just above this intersection and press the space key, a Select Model window will open up where the contents of the Flightgear/data/Models/ directory will be shown. Select your model from this list, then close the window. The selected model path/name will be display in green text at the bottom left of the FlightGear screen.

[[Image:Placing_objects_with_UFO_html_m184fb381.jpg]]

Now you may point the mouse on the scenery ground and left-click again, the CAT II/III ground marking model will be positioned there. Of course, it does not have the correct orientation and it's partly covered by the surrounding terrain, but we can adjust that.

[[Image:Placing_objects_with_UFO_html_12ee70a1.jpg]]

=Rotating objects=
Fly closer to the ground with the UFO, so that you can see it better.

Now press TAB (or Ctrl-I), and use the resulting sliders to adjust the latitude/longitude/elevation/heading of the model.

[[Image:Placing_objects_with_UFO_html_439816e9.jpg]]

=Exporting the result=
Now that the model is correctly positioned, press the D key to dump the model position data to the terminal. A few lines will be printed on the console, providing the necessary orientation data. You will save those coordinates into a scenery objects file in the next step. If you don't do that, next time you run Flightgear it will know nothing about the new object.

[[Image:Placing_objects_with_UFO_html_m4cf0cbf7.jpg]]

In the terminal window, you get three sections printed out by the UFO with very detailed information about what's going on, we need the line at the end.

e000n50/e008n50/3089154.stg is the secenery object file where this object's coordinates have to be saved. The default place where to find e000n50 directory is inside Flightgear/data/Scenery/Objects/. You just open the 3089154.stg file with any text editor, add the following line and save it the file:

OBJECT_SHARED Models/Tabu/catii-iii.xml 8.57928135 50.03667992 105.9972 111.1

Now you have your object's position saved, and it will appear inside the scenery every time you start Flightgear.

=Reload a saved session=
If you press the E key while developing sceneries with Ufo, fgfs will generate an xml file with the dump of your current work, this file can be after reloaded giving the --config=path_to_file parameter.
Example for Linux:
fgfs --config=$HOME/.fgfs/ufo-model-export.xml

=Useful keys=
See the [[UFO from the 'White Project' of the UNESCO]] page for ufo command keys.