Difference between revisions of "Catapult/Arrestor Operations (FSXA)"

From FSDeveloper Wiki
Jump to: navigation, search
m (Configuring (Vessel))
m
 
(34 intermediate revisions by 3 users not shown)
Line 9: Line 9:
 
| FS98 = unknown
 
| FS98 = unknown
 
}}
 
}}
FSX Acceleration addon introduces native functionality to simulate aircraft operations for a large flat-decked aircraft carrier.
+
The FSX Acceleration pack introduces native functionality to simulate aircraft operations for a large flat-decked aircraft carrier.
  
  
The catapult launch system is designed to simulate a modern catapult assisted takeoff.  
+
The catapult launch system is designed to simulate a modern catapult assisted takeoff.
 
<br>
 
<br>
The landing system is designed to simulate systems to aid the recovery of an aircraft.  
+
IRL it consists of a track built into the flight deck, below which is a large piston or shuttle that is attached through the track to the nose gear of the aircraft.
  
  
Includes info missing from the published SDK.
+
The landing system is designed to simulate systems to aid the recovery of an aircraft.  
 
 
== Configuring ==
 
To enable the Catapult/Arrestor operations functionality, two seperate aspects must be configured -
 
* Vessel - The runway, catapult, and arrestor-cables, for the carrier you'll takeoff from, and recover to.
 
* Aircraft - The launch-bar, (for the catapult), and tailhook, (for the arrestor-cables), located on the aircraft.
 
 
 
The FSX Acceleration key-mapping must also be functioning correctly.
 
 
<br>
 
<br>
Please see [[http://www.fsdeveloper.com/wiki/index.php?title=Key_Mapping_(FSXA) Key Mapping (FSXA)]]
+
IRL it consists of a series of cables strung across the landing area which the aircraft hooks on to.
  
== Configuring (Vessel) ==
 
To specify that a ship has one or more catapults, runway, and arrestor cables,
 
<br>
 
'''the appropriate ''Attach Points'' need to be added to the vessel ''model'''''.
 
  
These features can only be implemented by editing the model's source code.
+
The FSX Acceleration pack includes a preconfigured functioning aircraft carrier model, plus a carrier enabled F/A-18 aircraft.
  
  
For pre-existing models, you'd have to use addon systems,
+
Includes info missing from the published SDK.
<br>
 
e.g. [http://www.fs-shipyards.org/index.php?ind=downloads&op=section_view&idev=17 Rob Barendregt's - Carrier Operation Package RCBCO].
 
  
=== Takeoff Components ===
 
  
==== Catapult Assist (Vessel) ====
 
An aircraft catapult is a device used to launch aircraft from ships - in particular aircraft carriers - as a form of assisted take off.
 
<br>
 
It consists of a track built into the flight deck, below which is a large piston or shuttle that is attached through the track to the nose gear of the aircraft.
 
  
 +
== Configuring ==
 +
To enable the Catapult/Arrestor operations functionality, two seperate key aspects must be configured/functioning -
 +
* Aircraft - The launch-bar, (for the catapult), and tailhook, (for the arrestor-cables), located on the aircraft.
 +
* Vessel - The runway, catapult, and arrestor-cables, for the carrier you'll takeoff from, and recover to.
  
A maximum of four operational catapults and blast shields is supported.
 
  
  
For each catapult required, add an -
+
=== Prerequisite ===
* attachpt_catapult_start_n
+
The FSX Acceleration key-mapping must also be functioning correctly.
* attachpt_catapult_end_n
 
* attachpt_blast_shield_n.
 
Where '''n''' is the index# between 1 and 4 identifying the catapult and matching blast shield.
 
 
 
 
 
The ''start position'' is the point where the aircraft should connect its ''launch bar''.  
 
 
<br>
 
<br>
The ''blast shield point'' should be the center hinge of the shield.
+
Please see [[http://www.fsdeveloper.com/wiki/index.php?title=Key_Mapping_(FSXA) Key Mapping (FSXA)]]
  
=== Landing Components ===
 
  
==== Runway (Vessel) ====
 
The area where an aircraft lands.
 
<br>
 
'''A carrier can only have one runway'''.
 
  
 
+
== Configuring (FSXA) ==
Add the following -
 
* attachpt_runway_start
 
* attachpt_runway_end
 
* attachpt_runway_edge attach point
 
The '''attachpt_runway_edge''' point defines the half-width of the runway,
 
<br>
 
and should be to starboard of '''attachpt_runway_start'''.
 
 
 
==== Arrestor Cables (Vessel) ====
 
The cable strung across the landing area which catches the aircraft.
 
<br>
 
A maximum of four operational arrestor cables is supported.
 
 
 
 
 
For each arrestor cable required, add a '''pair''' of -
 
* attachpt_cable_n_1
 
* attachpt_cable_n_2
 
Where '''n''' is the index# between 1 and 4 identifying the arrestor cable.
 
 
 
==== Optical Landing System (OLS) (Vessel) ====
 
The OLS indicates the glidepath information to pilots in the terminal phase of landing on an aircraft carrier.
 
<br>
 
TODO - Add info for configuring - Anyone ?
 
 
 
== Configuring (Aircraft) ==
 
  
 
=== fsx.CFG ===
 
=== fsx.CFG ===
Line 101: Line 50:
 
Add/edit to enable -
 
Add/edit to enable -
 
* '''CatapultForceLimiter=1''' - Only fighter type aircraft can be catapulted.  
 
* '''CatapultForceLimiter=1''' - Only fighter type aircraft can be catapulted.  
* '''CatapultForceLimiter=0''' -  Any type of aircraft can be catapulted.
+
* '''CatapultForceLimiter=0''' -  Enables the catapult systems to generate the required force for any type of aircraft.
TODO - Find/add info how FSX discriminates between fighter and non-fighter aircraft.
+
 
 +
 
 +
'''TODO''' - Find/add info how FSX discriminates between fighter and non-fighter aircraft.
 +
 
 +
== Configuring (Aircraft) ==
  
 
=== Catapult Assist (Aircraft) ===
 
=== Catapult Assist (Aircraft) ===
To ''launch'' an aircraft, a launch bar is lowered to engage the catapult system.
+
To ''launch'' an aircraft, a '''launch bar''' is lowered to engage the catapult system.
  
 
+
Add a launch bar to an aircraft, by either -
To add a launch bar to an aircraft, by either -
+
* defining a '''[launch_assistance]''' entry in the aircraft configuration file.
* set the '''attachpt_Launch_Bar_Pivot''' and '''attachpt_Launch_Bar_Lug''' attach points in the model,  
+
* setting the '''attachpt_Launch_Bar_Pivot''' and '''attachpt_Launch_Bar_Lug''' attach points in the model,  
* define a '''[launch_assistance]''' entry in the aircraft configuration file.
 
 
'''An entry in the configuration file will override the model's attach points, if they exist.'''
 
'''An entry in the configuration file will override the model's attach points, if they exist.'''
  
==== Model - launch-bar ====
 
Requires the model's source code.
 
  
TODO - Add/edit/split instructions for implementation.
 
  
 
==== aircraft.cfg - launch-bar ====
 
==== aircraft.cfg - launch-bar ====
Line 123: Line 72:
 
Add a section titled '''[launch_assistance]'''
 
Add a section titled '''[launch_assistance]'''
 
<br>
 
<br>
with the following parameters and values.
+
with the following parameters and values -
 
<br>
 
<br>
 
'''launch_bar_pivot''' = Launch bar pivot point, relative to datum reference point.
 
'''launch_bar_pivot''' = Launch bar pivot point, relative to datum reference point.
Line 130: Line 79:
  
 
Example - Boeing F/A-18
 
Example - Boeing F/A-18
[code][launch_assistance]
+
<pre>[launch_assistance]
 
launch_bar_pivot = 5.0, 0.0, -1.0
 
launch_bar_pivot = 5.0, 0.0, -1.0
launch_bar_lug = 5.0, 0.0, -4.5[/code]
+
launch_bar_lug = 5.0, 0.0, -4.5</pre>
 +
 
 +
'''Marker States''' - A tool to aid positioning, see download at bottom of page:
 +
 
 +
[http://lc0277.gratisim.fr/Adapting_SX_aircrafts_to_acceleration_carriers.html Lamont Clarke's wiki - Adapting FSX aircrafts to acceleration carriers]
 +
 
 +
 
 +
 
 +
==== Model - launch-bar ====
 +
Requires the model's source code.
 +
 
 +
TODO - Add/edit/split instructions for implementation.
 +
 
  
[http://lc0277.nerim.net/wiki/index.php?Adapting%20FSX%20aircrafts%20to%20acceleration%20carriers Lamont Clarke's wiki - Adapting FSX aircrafts to acceleration carriers] includes his '''Marker States''' tool to aid positioning.
 
  
 
=== Arrestor Cables (Aircraft) ===
 
=== Arrestor Cables (Aircraft) ===
To ''trap'' an aircraft, a tailhook is lowered to catch an arrestor cable.
+
To ''trap'' an aircraft, a '''tailhook''' is lowered to catch an arrestor cable.
  
To add a tailhook to an aircraft, by either -
+
Add a tailhook to an aircraft, by either -
* set the '''attachpt_tailhook_pivot''' and '''attachpt_tailhook_hook''' attach points in the model.
+
* defining a '''[tailhook]''' entry in the aircraft configuration file.
* define a '''[tailhook]''' entry in the aircraft configuration file.  
+
* setting the '''attachpt_tailhook_pivot''' and '''attachpt_tailhook_hook''' attach points in the model.
 
'''An entry in the configuration file will override the attach points, if they exist.'''
 
'''An entry in the configuration file will override the attach points, if they exist.'''
  
==== Model - Tailhook ====
 
Requires the model's source code.
 
  
TODO - Add/edit/split instructions for implementation.
 
  
 
==== aircraft.cfg - Tailhook ====
 
==== aircraft.cfg - Tailhook ====
Line 154: Line 111:
 
Add a section titled '''[tailhook]'''
 
Add a section titled '''[tailhook]'''
 
<br>
 
<br>
with the following parameters and values.
+
with the following parameters and values -
 
<br>
 
<br>
 
'''tailhook_length''' = Length of tailhook in feet.
 
'''tailhook_length''' = Length of tailhook in feet.
Line 161: Line 118:
  
 
Example - Boeing F/A-18
 
Example - Boeing F/A-18
[code][tailhook]
+
<pre>[tailhook]
 
tailhook_length = 4.5
 
tailhook_length = 4.5
tailhook_position = -49.0, 0, -2.5[/code]
+
tailhook_position = -49.0, 0, -2.5</pre>
 +
 
 +
'''Marker States''' - A tool to aid positioning, see download at bottom of page:
 +
 
 +
[http://lc0277.gratisim.fr/Adapting_SX_aircrafts_to_acceleration_carriers.html Lamont Clarke's wiki - Adapting FSX aircrafts to acceleration carriers]
 +
 
 +
 
 +
 
 +
==== Model - Tailhook ====
 +
Requires the model's source code.
 +
 
 +
TODO - Add/edit/split instructions for implementation.
 +
 
 +
 
 +
 
 +
== Configuring (Vessel) ==
 +
To specify that a ship has one or more catapults, runway, and arrestor cables,
 +
<br>
 +
'''the appropriate ''Attach Points'' need to be added to the vessel ''model'''''.
 +
 
 +
These features can only be implemented by editing the model's source code.
 +
 
 +
 
 +
 
 +
'''Important'''
 +
<br>
 +
This article is specifically refering to ''Attach Point Names'', and not refering to the model's ''Animation Tags''.
 +
<br>
 +
Unfortunately the ''Animation Tags'' ''label name's'' spelling and capitalization, plus the ''index numbering'' is inconsistent, (e.g. for blast shield, catapults, steam).
  
[http://lc0277.nerim.net/wiki/index.php?Adapting%20FSX%20aircrafts%20to%20acceleration%20carriers Lamont Clarke's wiki - Adapting FSX aircrafts to acceleration carriers] includes his '''Marker States''' tool to aid positioning.
+
 
 +
'''Note'''
 +
<br>
 +
The attach points for carrier operations are '''not included''' in the list of options in the attach point tool.
 +
<br>
 +
These need to be manually entered as an ''empty attach point''.
 +
 
 +
The actual code used can be checked in Object Properties/User Defined to ensure there have been no syntax errors. 
 +
<br>
 +
See [http://www.fsdeveloper.com/forum/showpost.php?p=59688&postcount=7] for further details.
 +
 
 +
 
 +
For pre-existing models, you'd have to use addon systems,
 +
<br> e.g.
 +
 
 +
[http://www.flightsim.com/kdl.php?fid=84303Rob Barendregt's - FS2004 Carrier Operation Package V2.0]
 +
 
 +
[http://library.avsim.net/esearch.php?CatID=fsxgau&DLID=98408Rob Barendregt's - FSX Carrier Operation Package V3.0].
 +
 
 +
 
 +
 
 +
=== Takeoff Components ===
 +
 
 +
 
 +
 
 +
==== Catapult Assist (Vessel) ====
 +
A maximum of four operational catapults and blast shields is supported.
 +
 
 +
 
 +
For each catapult required, add an -
 +
* attachpt_catapult_start_'''n'''
 +
* attachpt_catapult_end_'''n'''
 +
* attachpt_blast_shield_'''n'''
 +
Where '''n''' is the index# between 1 and 4 identifying the catapult and matching blast shield.
 +
 
 +
 
 +
The ''start'' position is the point where the aircraft should connect its ''launch bar''.
 +
<br>
 +
Developers have reported - Distance from the model's origin to ''start'' position must not exceed 65 metres.
 +
 
 +
 
 +
The ''blast shield'' point should be the center hinge of the shield.
 +
 
 +
 
 +
 
 +
=== Landing Components ===
 +
 
 +
 
 +
 
 +
==== Runway (Vessel) ====
 +
The area where an aircraft lands.
 +
<br>
 +
'''A carrier can only have one runway'''.
 +
 
 +
 
 +
Add the following -
 +
* attachpt_runway_start
 +
* attachpt_runway_end
 +
* attachpt_runway_edge
 +
The '''attachpt_runway_edge''' point defines the half-width of the runway,
 +
<br>
 +
and should be to starboard of '''attachpt_runway_start'''.
 +
 
 +
This will activate the 'Meatball' glideslope indicator on the left hand side of the defined area.
 +
<br>
 +
It is not required for a working carrier if the US style 'Meatball' is inappropriate.
 +
 
 +
 
 +
 
 +
==== Arrestor Cables (Vessel) ====
 +
A maximum of four operational arrestor cables is supported.
 +
 
 +
 
 +
For each arrestor cable required, add a '''pair''' of -
 +
* attachpt_cable_'''n'''_1
 +
* attachpt_cable_'''n'''_2
 +
Where '''n''' is the index# between 1 and 4 identifying the arrestor cable.
 +
 
 +
 
 +
 
 +
==== Optical Landing System (OLS) (Vessel) ====
 +
The OLS indicates the glidepath information to pilots in the terminal phase of landing on an aircraft carrier.
 +
 
 +
The OLS is automatically placed on the left hand side of the area defined as the runway (see above). 
 +
<br>
 +
It is not possible to configure the OLS for anything other than the default glideslope, or to alter the style and configuration of the lights.
  
 
== Operating ==
 
== Operating ==
 
TODO - Add/edit/split instructions for testing & operating.
 
TODO - Add/edit/split instructions for testing & operating.
 +
 +
  
 
=== Takeoff ===
 
=== Takeoff ===
Line 191: Line 263:
  
 
The aircraft can then be moved away from the catapult.
 
The aircraft can then be moved away from the catapult.
 +
 +
  
 
=== Landing ===
 
=== Landing ===
Line 202: Line 276:
 
* Cable breaks are not simulated.  
 
* Cable breaks are not simulated.  
 
The aircraft can be parked on deck, perhaps using the KEY_TOGGLE_WING_FOLD or KEY_SET_WING_FOLD key events to fold the wings.
 
The aircraft can be parked on deck, perhaps using the KEY_TOGGLE_WING_FOLD or KEY_SET_WING_FOLD key events to fold the wings.
 +
 +
  
 
== Related ==
 
== Related ==
Line 209: Line 285:
 
=== External ===
 
=== External ===
 
Credits  -
 
Credits  -
* [http://paul-flightsimguy.spaces.live.com/blog/cns!D282374D24B565FB!264.entry Paul Lange's blog - Launch Bars and Carriers]
+
* [http://paul-flightsimguy.spaces.live.com/blog/cns!D282374D24B565FB!264.entry Paul Lange's blog - Launch Bars and Carriers] (No longer available).
* [http://lc0277.nerim.net/wiki/index.php?Adapting%20FSX%20aircrafts%20to%20acceleration%20carriers Lamont Clarke's wiki - Adapting FSX aircrafts to acceleration carriers]
+
* [http://lc0277.gratisim.fr/Adapting_SX_aircrafts_to_acceleration_carriers.html Lamont Clarke's wiki - Adapting FSX aircrafts to acceleration carriers]
  
  

Latest revision as of 04:36, 27 June 2011

The FSX Acceleration pack introduces native functionality to simulate aircraft operations for a large flat-decked aircraft carrier.


The catapult launch system is designed to simulate a modern catapult assisted takeoff.
IRL it consists of a track built into the flight deck, below which is a large piston or shuttle that is attached through the track to the nose gear of the aircraft.


The landing system is designed to simulate systems to aid the recovery of an aircraft.
IRL it consists of a series of cables strung across the landing area which the aircraft hooks on to.


The FSX Acceleration pack includes a preconfigured functioning aircraft carrier model, plus a carrier enabled F/A-18 aircraft.


Includes info missing from the published SDK.


Configuring

To enable the Catapult/Arrestor operations functionality, two seperate key aspects must be configured/functioning -

  • Aircraft - The launch-bar, (for the catapult), and tailhook, (for the arrestor-cables), located on the aircraft.
  • Vessel - The runway, catapult, and arrestor-cables, for the carrier you'll takeoff from, and recover to.


Prerequisite

The FSX Acceleration key-mapping must also be functioning correctly.
Please see [Key Mapping (FSXA)]


Configuring (FSXA)

fsx.CFG

In the [Realism] section.
Add/edit to enable -

  • CatapultForceLimiter=1 - Only fighter type aircraft can be catapulted.
  • CatapultForceLimiter=0 - Enables the catapult systems to generate the required force for any type of aircraft.


TODO - Find/add info how FSX discriminates between fighter and non-fighter aircraft.

Configuring (Aircraft)

Catapult Assist (Aircraft)

To launch an aircraft, a launch bar is lowered to engage the catapult system.

Add a launch bar to an aircraft, by either -

  • defining a [launch_assistance] entry in the aircraft configuration file.
  • setting the attachpt_Launch_Bar_Pivot and attachpt_Launch_Bar_Lug attach points in the model,

An entry in the configuration file will override the model's attach points, if they exist.


aircraft.cfg - launch-bar

Works for any aircraft.

Add a section titled [launch_assistance]
with the following parameters and values -
launch_bar_pivot = Launch bar pivot point, relative to datum reference point.
launch_bar_lug = Launch bar lug point, relative to datum reference point.

Example - Boeing F/A-18

[launch_assistance]
launch_bar_pivot = 5.0, 0.0, -1.0
launch_bar_lug = 5.0, 0.0, -4.5

Marker States - A tool to aid positioning, see download at bottom of page:

Lamont Clarke's wiki - Adapting FSX aircrafts to acceleration carriers


Model - launch-bar

Requires the model's source code.

TODO - Add/edit/split instructions for implementation.


Arrestor Cables (Aircraft)

To trap an aircraft, a tailhook is lowered to catch an arrestor cable.

Add a tailhook to an aircraft, by either -

  • defining a [tailhook] entry in the aircraft configuration file.
  • setting the attachpt_tailhook_pivot and attachpt_tailhook_hook attach points in the model.

An entry in the configuration file will override the attach points, if they exist.


aircraft.cfg - Tailhook

Works for any aircraft.

Add a section titled [tailhook]
with the following parameters and values -
tailhook_length = Length of tailhook in feet.
tailhook_position = Tailhook pivot point, relative to datum reference point.

Example - Boeing F/A-18

[tailhook]
tailhook_length = 4.5
tailhook_position = -49.0, 0, -2.5

Marker States - A tool to aid positioning, see download at bottom of page:

Lamont Clarke's wiki - Adapting FSX aircrafts to acceleration carriers


Model - Tailhook

Requires the model's source code.

TODO - Add/edit/split instructions for implementation.


Configuring (Vessel)

To specify that a ship has one or more catapults, runway, and arrestor cables,
the appropriate Attach Points need to be added to the vessel model.

These features can only be implemented by editing the model's source code.


Important
This article is specifically refering to Attach Point Names, and not refering to the model's Animation Tags.
Unfortunately the Animation Tags label name's spelling and capitalization, plus the index numbering is inconsistent, (e.g. for blast shield, catapults, steam).


Note
The attach points for carrier operations are not included in the list of options in the attach point tool.
These need to be manually entered as an empty attach point.

The actual code used can be checked in Object Properties/User Defined to ensure there have been no syntax errors.
See [1] for further details.


For pre-existing models, you'd have to use addon systems,
e.g.

Barendregt's - FS2004 Carrier Operation Package V2.0

Barendregt's - FSX Carrier Operation Package V3.0.


Takeoff Components

Catapult Assist (Vessel)

A maximum of four operational catapults and blast shields is supported.


For each catapult required, add an -

  • attachpt_catapult_start_n
  • attachpt_catapult_end_n
  • attachpt_blast_shield_n

Where n is the index# between 1 and 4 identifying the catapult and matching blast shield.


The start position is the point where the aircraft should connect its launch bar.
Developers have reported - Distance from the model's origin to start position must not exceed 65 metres.


The blast shield point should be the center hinge of the shield.


Landing Components

Runway (Vessel)

The area where an aircraft lands.
A carrier can only have one runway.


Add the following -

  • attachpt_runway_start
  • attachpt_runway_end
  • attachpt_runway_edge

The attachpt_runway_edge point defines the half-width of the runway,
and should be to starboard of attachpt_runway_start.

This will activate the 'Meatball' glideslope indicator on the left hand side of the defined area.
It is not required for a working carrier if the US style 'Meatball' is inappropriate.


Arrestor Cables (Vessel)

A maximum of four operational arrestor cables is supported.


For each arrestor cable required, add a pair of -

  • attachpt_cable_n_1
  • attachpt_cable_n_2

Where n is the index# between 1 and 4 identifying the arrestor cable.


Optical Landing System (OLS) (Vessel)

The OLS indicates the glidepath information to pilots in the terminal phase of landing on an aircraft carrier.

The OLS is automatically placed on the left hand side of the area defined as the runway (see above).
It is not possible to configure the OLS for anything other than the default glideslope, or to alter the style and configuration of the lights.

Operating

TODO - Add/edit/split instructions for testing & operating.


Takeoff

Use one of the KEY_TOGGLE_LAUNCH_BAR_SWITCH or KEY_SET_LAUNCHBAR_SWITCH key events to drop the launch bar from the nose of the aircraft.

This is an animated feature of the F-18, and the launch bar should be visible.

The aircraft should be moved into position on the catapult, and then one of the KEY_TAKEOFF_ASSIST_ARM_SET or KEY_TAKEOFF_ASSIST_ARM_TOGGLE key events should be used to attach the launch bar to the bogie of the catapult, (not modeled/animated).

  • If the aircraft is not in the correct location, the connection will not be made.
  • If all goes well, the connection will be made, and the blast shield will be raised.

The KEY_TAKEOFF_ASSIST_FIRE event key is used to fire the catapult. The user cannot control the position of the aircraft until the aircraft clears the deck.


If for any reason the assist arm is unset, again using the KEY_TAKEOFF_ASSIST_ARM_SET or KEY_TAKEOFF_ASSIST_ARM_TOGGLE key events, then the blast shield will also be retracted.

The aircraft can then be moved away from the catapult.


Landing

Use one of the KEY_SET_TAIL_HOOK_HANDLE or KEY_TOGGLE_TAIL_HOOK_HANDLE key events, or the TAILHOOK POSITION simulation variable, to set the tail hook in position.

Land on the appropriate spot on the carrier.

There are typically four arrestor cables.

  • If the aircraft does not land with excessive speed, it will be brought to a halt and pulled back a short distance.
  • If it does land with excessive speed the cables will not prevent the aircraft going off the deck.
  • Cable breaks are not simulated.

The aircraft can be parked on deck, perhaps using the KEY_TOGGLE_WING_FOLD or KEY_SET_WING_FOLD key events to fold the wings.


Related

Internal

External

Credits -