Merge pull request #69 from Csantucci/master

Update OR manual with documentation about bell animation.

Author: twpol

Source/Documentation/Manual/features-rollingstock.rst

@@ -444,4 +444,28 @@ MSTS wagon::
 At runtime, when in passenger view, the player may pass from one viewpoint to 
 the other by pressing Shift-5.
 
+Bell animation
+==============
+
+Open Rails supports bell animation. The bell animation matrix must be named 
+ORTSBELL within the engine's .s file. Its default frame rate is 8 frames per 
+second. The default frame rate may be modified through the optional parameter 
+ESD_ORTSBellAnimationFPS (n), to be inserted within the .sd file related to the 
+.s file. n defines the animation FPS.
+It is advisable that the related sound stream within the .sms file is synchronized 
+with the visible animation. To accomplish this the .wav file should contain two 
+bell strokes, which time interval is equal to the time interval of a bell swing 
+from an oscillation end point to the opposite end point. As the first bell stroke 
+should not start immediately, but when the bell is about at the maximum of the 
+swing, the first stroke within the .wav file should be at the time distance equivalent 
+to the oscillation from center point to an oscillation end point. The file should have 
+one cue point at its beginning and one after the time interval of a complete bell swing 
+forward and backward, and should have a final fadeoff for best result. 
+
+
+
+  
+
+
+
 

Source/Documentation/Manual/operation.rst

@@ -1671,9 +1671,10 @@ user settings, and as such are kind of an extension to the four available
 
 Function call::
 
-    state = HASHEAD(Index of SignalSubObj);
+    state = HASHEAD( n );
 
-Function returns 1 if head is set, else 0. 
+where n is the SignalSubObj-Number in question.
+Function returns 1 if head SignalSubObj is set, else 0.
 
 
 Signalling flag OR_NOSPEEDREDUCTION