Ramp Marshall: Difference between revisions

Jump to navigation Jump to search

Ramp Marshall (view source)

Revision as of 16:47, 7 August 2013

198 bytes added ,  7 August 2013
Cleanup; it's called a "marshaller" or "marshalling".
No edit summary
(Cleanup; it's called a "marshaller" or "marshalling".)
Line 1: Line 1:
= Ramp Marshall =
A '''(ramp) marshaller''' is a person who guides [[aircraft]] using hand (and wand) signals at a parking ramp. This is a new feature that being worked on for a more generalized scale in [[FlightGear]]. Until this gets merged into the fgdata repository, you can get this from omega95's fgdata clone or the new Singapore Scenery development.


A '''Ramp Marshall''' is a person who guides aircraft using hand (and wand) signals at a parking ramp. This new feature is now available on a more generalized scale in FlightGear. Until this gets merged into the fgdata repository, you can get this from omega95's fgdata clone or the new Singapore Scenery development.  
Currently, support can be added to airports with the [[UFO]], but soon ramp marshallers will be added automatically if a parking spot's flag is set to enable it. This will integrate FlightGear parking positions, ramp marshallers and other features that might come up related to parking ramps or gates.


Currently, support can be added to airports with the ufo but soon, ramp marshalls will be added automatically if a parking spot's flag is set to enable it. This will integrate FlightGear parking positions, ramp marshalls and other features that might come up related to parking ramps or gates.
These are videos of the first prototype of the ramp marshaller.
 
These are videos of the first prototype of the ramp marshall.


{{#ev:youtube | c_KEbyv_h5A}} {{#ev:youtube | Hz4WU8nsdls}}
{{#ev:youtube | c_KEbyv_h5A}} {{#ev:youtube | Hz4WU8nsdls}}


= Using the Ramp Marshall =


To use the ramp marshall with a compatible aircraft at a compatible airport (scroll down to see how you can make aircraft and/or airports compatible), simply taxi to the gate/ramp you want to park at and click on the marshall waiting at the ramp. His hands should move from rest position (both wands down by his sides) to direct you to the ramp. It's recommended to taxi to the ramp on the taxiway lines as long as you can see them and once they go out of view, follow the marshall's instructions. Make sure that you're not taxiing faster than 5 to 10 kts at the ramp.
== Using the ramp marshaller ==
To use the ramp marshaller with a compatible aircraft at a compatible airport (scroll down to see how you can make aircraft and/or airports compatible), simply taxi to the gate/ramp you want to park at and click on the marshaller waiting at the ramp. His hands should move from rest position (both wands down by his sides) to direct you to the ramp. It's recommended to taxi to the ramp on the taxiway lines as long as you can see them and once they go out of view, follow the marshaller's instructions. Make sure that you're not taxiing faster than 5 to 10 kts at the ramp.


Currently, the ramp marshall knows the following signals -
Currently, the ramp marshaller knows the following signals -
* Move forward
* Move forward
* Turn Left
* Turn left
* Turn Right
* Turn right
* Slow down and stop
* Slow down and stop
* Immediate stop
* Immediate stop


But we're teaching it new signals. If you want to teach it a signal, scroll down to find out how. To find out what the signals look like, take a look at the videos above.
But we're teaching him new signals. If you want to teach him a signal, scroll down to find out how. To find out what the signals look like, take a look at the videos above.
 
= Adding Ramp Marshall Support =
 
== Adding Ramp Marshall Compatibility to Aircraft ==
 
[[File:A330-200 Ramp Marshall Compatibility - getting position with ac3D.png|thumb|525px|Demonstrating how to get x-position of nose gear with ac3D for ramp marshall compatibility.]]
 
It's actually very simple to add ramp marshall compatibility to an aircraft, the only file required to be edited is the aircraft's '''-set.xml''' file. (or common xml file for aircraft groups) The user is still required to use some kind of 3D modeling program to get the position.


1. Open the Aircraft's model file (containing the gears) with a 3D modeling program and get the '''x''' position of the bottom of the nose gear. (Or the position you want to rest at the ramp)
== Adding ramp marshalling support ==
=== Adding ramp marshalling compatibility to aircraft ===
[[File:A330-200 Ramp Marshall Compatibility - getting position with ac3D.png|thumb|270px|Demonstrating how to get x-position of nose gear with AC3D for ramp marshalling compatibility.]]


2. Add the following code within the '''<sim> ... <model> ... </model></sim>''' tags in the aircraft's '''-set.xml''' file. (or common xml file for aircraft groups)
It's actually very simple to add ramp marshalling compatibility to an aircraft, the only file required to be edited is the aircraft's [[Aircraft-set.xml|<tt>-set.xml</tt> file]] (or common xml file for aircraft groups). The user is still required to use some kind of 3D modeling program to get the position.


# Open the aircraft's model file (containing the gears) with a 3D modeling program and get the '''x''' position of the center of the nose gear. (Or the position you want to rest at the ramp)
# Add the following code within the <code><sim> ... <model> ... </model></sim></code> tags in the aircraft's <tt>-set.xml</tt> file. (or common xml file for aircraft groups)
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<ramp>
<ramp>
Line 40: Line 34:
</ramp>
</ramp>
</syntaxhighlight>
</syntaxhighlight>
:The '''x''' position from the 3D model is in the <code><x-m></code> tag and the aircraft class is in the <code><class></code> tag. With the current models, the aircraft classes are as follows -
:* 0 - 747s, 777-300s, A340s, A380s
:* 1 - 777-300s, A330-300s, 787s
:* 2 - A330-200s, 757s, 767s
:* 3 - A320s (includes A318s, A319s and A321s), 737s and other aircraft in general. This works for CRJs, E-jets etc.


The '''x''' position from the 3D model is in the <x-m> tag and the aircraft class is in the <class> tag. With the current models, the aircraft classes are as follows -
This should be all! The ramp marshaller should be able to ''recognize'' the aircraft and guide it to the right position at the ramp!
* 0 - 747s, 777-300s, A340s, A380s
* 1 - 777-300s, A330-300s, 787s
* 2 - A330-200s, 757s, 767s
* 3 - A320s (includes A318s, A319s and A321s), 737s and other aircraft in general. This works for CRJs, E-jets etc.
 
This should be all! The ramp marshall should be able to ''recognize'' the aircraft and guide it to the right position at the ramp!


== Adding Ramp Marshalls to an Airport ==
=== Adding ramp marshallers to an airport ===


'''NOTE -''' In the future, this will change because ramp marshall positions are going to be connected to an airport's '''groundnet.xml''' file.
'''NOTE -''' In the future, this will change because ramp marshall positions are going to be connected to an airport's '''groundnet.xml''' file.


[[File:ramp-marshall-arpt-1.png|thumb|525px|Placing Ramp Marshall using ufo]]
[[File:ramp-marshall-arpt-1.png|thumb|270px|Placing ramp marshaller using ufo]]
 
[[File:ramp-marshall-arpt-2.png|thumb|270px|Converting STG file to ramps XML]]
[[File:ramp-marshall-arpt-2.png|thumb|525px|Converting STG File to Ramps XML]]


1. Start up FlightGear with the '''ufo''' at the airport you want to place ramp marshalls.
# Start up FlightGear with the UFO at the airport you want to place ramp marshallers.
# Hit the {{key press|L}} key on the keyboard to bring up the model selection dialog and select <tt>[[$FG_ROOT]]/Models/Airport/Ramp/ramp.xml</tt>. Using the ufo's scenery editing tools, place (and adjust) ramp marshallers everywhere you want. To make it simpler, click on the exact position you want the airplane to come to a stop. This will usually be at the end of a parking ramp's taxiway lines. Then, you will only have to change the heading.
# Once you've finished placing all the models, hit the {{key press|D}} key to dump the stg lines onto the console. (Do not close FlightGear yet) Copy the stg lines into a blank file. (name does not matter)
# Open up the Nasal console and execute the following function.
#: <syntaxhighlight lang="javascript">ramp_marshall.convert_stg();</syntaxhighlight>
# Choose the stg file you pasted the dumped stg lines in to convert the file into a readable xml ramp position file. The converted file can be found <tt>[[$FG_HOME]]/Export<tt>.
# Copy the exported file (it will be called '''ramps-export.xml''') to <tt>[[$FG_ROOT]]/AI/Airports/<icao>/ramps.xml</tt>. For example, if you want these ramps at Singapore Changi Intl. Airport (WSSS), you'd put it in <tt>[[$FG_ROOT]]/AI/Airports/<icao>/WSSS.xml</tt>.


2. Hit the '''L''' key on the keyboard to bring up the model selection dialog and select '''$FGDATA/Models/Airport/Ramp/ramp.xml'''. Using the ufo's scenery editing tools, place (and adjust) ramp marshalls everywhere you want. To make it simpler, click on the exact position you want the airplane to come to a stop. This will usually be at the end of a parking ramp's taxiway lines. Then, you will only have to change the heading.
== Contributing to the module ==


3. Once you've finished placing all the models, hit the '''D''' key to dump the stg lines onto the console. (Do not close FlightGear yet) Copy the stg lines into a blank file. (name does not matter)
=== Teach the ramp marshaller new signals ===
 
4. Open up the Nasal console and execute the following function.
 
<syntaxhighlight lang="javascript">
ramp_marshall.convert_stg();
</syntaxhighlight>
 
5. Choose the stg file you pasted the dumped stg lines in to convert the file into a readable xml ramp position file. The converted file can be found '''$FGHOME/Export'''.
 
6. Copy the exported file (it will be called '''ramps-export.xml''') to '''$FGDATA/AI/Airports/<icao>/ramps.xml'''. For example, if you want these ramps at Singapore Changi Intl. Airport (WSSS), you'd put it in '''$FGDATA/AI/Airports/<icao>/WSSS.xml'''.
 
= Contributing to the Module =
 
== Teach the Ramp Marshall new signals ==


{{WIP}}
{{WIP}}


== Using dfferent models or textures ==
=== Using dfferent models or textures ===


{{WIP}}
{{WIP}}


= Further development =
== Further development ==


== Visual Docking Guidance System ==
=== Visual Docking Guidance System ===


{{WIP}}
{{WIP}}


== External Links ==
== External links ==
* https://gitorious.org/~omega95/fg/omega95s-fgdata
* [https://gitorious.org/~omega95/fg/omega95s-fgdata Omega95's fgdata] (Gitorious)
* https://gitorious.org/fg-singapore-scenery
* [https://gitorious.org/fg-singapore-scenery FG Singapore Scenery] (Gitorious)
 
* [http://flightgear.org/forums/viewtopic.php?f=30&t=20572 Forum topic]
== Related ==
* http://flightgear.org/forums/viewtopic.php?f=30&t=20572


[[Category:Scenery]]
[[Category:Scenery enhancement]]
[[Category:Scenery enhancement]]
Retrieved from "https://wiki.flightgear.org/Special:MobileDiff/62071"

Navigation menu