Library globals

Namespace globals . towing . hitch

View source

Version: 30. December 2014

Purpose of this routine:
------------------------

- Create visible winch- and towropes for gliders and towplanes
- Support of aerotowing and winch for JSBSim-aircraft (glider and towplanes)

This routine is very similar to /FDM/YASim/Hitch.cpp
Aerotowing is fully compatible to the YASim functionality.
This means that YASim-gliders could be towed by JSBSim-aircraft and vice versa.
Setup-instructions with copy and paste examples are given below:


Setup of visible winch/towropes for Yasim-aircraft:
----------------------------------------------------

YASim-aircraft with winch/aerotowing functionality should work out of the box.
Optional you can customize the rope-diameter by adding the following to "your_aircraft-set.xml":
</sim>
<hitches>
<aerotow>
<rope>
<rope-diameter-mm type ="float">10</rope-diameter-mm>
</rope>
</aerotow>
<winch>
<rope>
<rope-diameter-mm type ="float">20</rope-diameter-mm>
</rope>
</winch>
</hitches>
</sim>

That's all!



Support of aerotowing and winch for JSBSim-aircraft (glider and towplanes):
----------------------------------------------------------------------------

1. Define a hitch in the JSBSim-File. Coordinates according to JSBSims structural frame of reference
(x points to the tail, y points to the right wing, z points upwards).
Unit must be "LBS", frame must be "BODY". The force name is arbitrary.

<external_reactions>
<force name="hitch" frame="BODY" unit="LBS" >
<location unit="M">
<x>3.65</x>
<y> 0.0</y>
<z>-0.12</z>
</location>
<direction>
<x>0.0</x>
<y>0.0</y>
<z>0.0</z>
</direction>
</force>
</external_reactions>

Functions

PointRotate3D

aerotow

assignHitchLocations

closeHitch

createTowrope

findBestAIObject

getFreeModelID

pull_in_rope

releaseHitch

releaseWinch

removeTowrope

runWinch

setAIObjectDefaults

setWinchPositionAuto

towing

winch