-------------------------------------------------------------------------------------------------------------
Module "Fly_AirFeedback.dll" for Fly! / Fly!2, version 1.00
Author : Roland Herblot (from France)
e-mail : rherblot@rd-tech.fr


**************************************************************************************************************************************************
***************** Please write "FAF" in the subject message, if you want to contact me by e-mail for suggestions & problems **********************
**************************************************************************************************************************************************


	Compiled and linked with Microsoft Visual C++ 6.0, with "Pentium Pro" speed optimisation
	Some troubles should occur with older processors, but can you run Fly!II with ? :-))




$$$$$$$$$$$$$$$$$$$$$$  F R E N C H    S E C T I O N $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$

-------------------------------------------------------------------------------------------------------------
Installation :

- Copiez la dll "Fly_AirFeedback.dll" et le fichier "AirFeedback.ini" dans le rpertoire "Modules\PC\" de Fly!II.
- n'oubliez pas d'enlever de ce mme rpertoire "ForceFed.dll" si vous l'avez, pour viter tout conflit.


En cas de problme, envoyer moi le fichier "AirFeedback.log" qui sera cr dans le mme rpertoire.


-------------------------------------------------------------------------------------------------------------
Options du fichier AirFeedback.ini :

[AirFeedback options]
- Si la DLL semble fonctionner correctement aprs la premire installation (sans modification du fichier INI), alors vous pouvez essayer de changer l'option "UseJoystickState=0" en "UseJoystickState=1" pour conomiser du temps cela conomisera du temps processeur toujours prcieux !
Si les messages "Actuators ON /OFF" ne s'affichent pas correctement selon la situation, revenez  l'tat prcdent.
Si tout se passe bien, laissez l'option  1, cela conomisera du temps processeur toujours prcieux !

- Si vous ne voulez pas de l'effet Buffeting, vous pouvez le dsactiver galement : "UseBuffetingEffect=0"

- l'amplitude globale des effets retour de force de votre manette est maintenant rglable avec
  le champs "GlobalJoystickGain=" (valeur de 1  10).

- Il est conseill d'ajouter les avions manquants  la fin du "AirFeedback.ini". Les effets n'en seront 
que plus ralistes.
Pour chaque avion, il faut spcifier les vitesse mini et maxi d'utilisation.
De plus, on peut diminuer ou augmenter l'effet li aux acclrations angulaires (je l'ai fait  l'origine pour le PA-28
puis galement utilis pour le P51D, il y en a peut-tre d'autres...)

Pour chaque nouvel avion, vous devez ajouter les lignes suivantes :

[nom du nouvel avion]
LowestFlapSpeed=XX                  ; stall air speed limit with full flaps
LowestSpeed=XX                      ; stall air speed limit without flaps
HighestSpeed=XXX                    ; maximum air speed allowed
AccelerationRollFactor=10           ; standard value = 10, decrease if you have to much ROLL reaction with your plane
AccelerationPitchFactor=10          ; standard value = 10, decrease if you have to much PITCH reaction with your plane
FlapsPositionNbr=3                  ; Number of active Flaps position, eg for the FlyHawk, pos are: 0, 1, 2, 3 

** Si l'avion n'a pas de flaps, il faut mettre la mme valeur dans "LowestFlapSpeed" & "LowestSpeed".
** Ne mettez pas la ligne "FlapsPositionNbr=" dans ce cas.

** Pour les hlicoptres, seuls les champs "HighestSpeed" & "AccelerationFactor" sont requis.

Il est fort probable que le fichier contiennent des erreurs car je n'ai pas vrifi tous les avions de la liste.
Notemment au niveau des vitesses de dcrochage et du nombre de positions flaps. Merci de me le faire savoir !


-------------------------------------------------------------------------------------------------------------
Remarques sur le fonctionnement :

- Les effets sont suspendus quand Fly! est en "pause" ou en mode "saut".
- La modification des effets est suspendue quand on enlve la main du joystick si l'option "UseJoystickState" est  1 (pour conomiser du CPU),
 mais la rcupration des donnes de vol et les calculs d'acclration se poursuivent pour viter les accoups irralistes lors de la ractivation du joystick.


-------------------------------------------------------------------------------------------------------------
Descriptions rapide des effets gnrs :

- Un effet d'inertie est applique en permanence (propre  toute mcanique).
- La manette doit "durcir" en fontion de la vitesse air.
- Vous devez galement ressentir les effets ds aux acclrations angulaires de l'avion (pitch et roll).
	(essayez un PA-19 ou PA-28 par grand vent et rafales, a vaut le coup d'oeil (de main !), ou encore lors d'une avarie d'aile)
- Plus les effets : roulement piste, rentre / bloquage des trains et choc  l'aterrissage  proportionnel
  la vitesse verticale lors du contact.
- J'ai implment un effet "Buffeting" mais je n'ai pas la moindre ide de son ralisme. S'il ne vous plait pas, dsactivez le dans le .INI


-------------------------------------------------------------------------------------------------------------
Les informations suivantes sont affiches dans Fly! :

- Nom de la manette dont l'acquisition a russi, au dmarrage de chaque nouvelle situation.
- les messages "Actuators ON / Actuators OFF" lorsqu'on tient / lache le manche (ou le joystick est hors tension secteur)
  (je ne sais pas si tous les joysticks disposent de cette fonction).
- Un message d'alerte si l'avion que vous utilisez n'est pas dans le fichier INI.


-------------------------------------------------------------------------------------------------------------
Compatibilit :

- Cette DLL a t essaye avec succs, sur les systmes suivants :
	Fly! II				: version europenne, patch 230, patch 240
	Operating system	: Windows 2000 Pro, Windows 98 SE
	Joystick			: Microsoft Sidewinder Force Feedback 2
	DirectX				: version 8.1, version 9.0

mais il y a encore des problmes sur certains systmes...

- La DLL devrait normalement fonctionner galement sous Fly!1 et avec tout joystick compatible DirectX 8.
	(faites le moi savoir)
	

J'espre que vous apprcierez cette DLL, Bons vols !



$$$$$$$$$$$$$$$$$$$$$$$$ E N G L I S H    S E C T I O N $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$


-------------------------------------------------------------------------------------------------------------
Installation :

- Copy the "Fly_AirFeedback.dll" & "AirFeedback.ini" files in your "Fly!II\Modules\Pc\" folder.
- Don't forget to remove the "ForceFed.dll" (same folder) if you use it, to avoid any conflict.

- In case of problem, send me the "AirFeedback.log" file, which is located in the same folder.



-------------------------------------------------------------------------------------------------------------
AiFeedback.ini file options :

- You can switch "UseJoystickState" key to 0 in [AirFeedback options] if the "Actuators ON /OFF" messages are 
not displayed at correct time.
If everything is going all right, leave it at 1, as you will save some precious CPU time !

- You can also disable the "Buffeting" effect with : "UseBuffetingEffect=0"

- You can adjust the global amplitude effect of your Joystick with the "GlobalJoystickGain=" field (1 to 10 max)

- You should add your missing plane at the end of "AirFeedback.ini" file to have more realistic effects.

For each new plane, you should type the following lines :

[name of the plane]
LowestFlapSpeed=XX                  ; stall air speed limit with full flaps
LowestSpeed=XX                      ; stall air speed limit without flaps
HighestSpeed=XX                     ; maximum air speed allowed
AccelerationFactor=10               ; standard value = 10, decrease if you have to much picth and roll reaction with your plane
AccelerationPitchFactor=10          ; standard value = 10, decrease if you have to much PITCH reaction with your plane
FlapsPositionNbr=3                  ; Number of active Flaps position, eg for the FlyHawk, pos are: 0, 1, 2, 3 

*** For helicopters, only the "HighestSpeed" & "AccelerationFactor" fields are required

*** If your plane has no flaps, please fill the same value in both "LowestSpeed" & "LowestFlapSpeed" and don't create the "FlapsPositionNbr" field.


-------------------------------------------------------------------------------------------------------------
Displayed informations on Fly! screen :

- Name of the joystick successfully connected at start time
- The two messages "Actuators ON / Actuators OFF" when you get / drop the joystick with your hand (if you use "UseJoystickState=1" in the INI file)
- An alert message if the current aircraft is not part of the INI file.
 

-------------------------------------------------------------------------------------------------------------
Compatibility :

- This DLL has been tested with the following systems :

	Fly! II				: european version, patch 230, patch 240
	Operating system		: Windows 2000 Pro, Windows 98 SE
	Joystick			: Microsoft Sidewinder Force Feedback 2
	DirectX				: version 8.1, version 9.0

but on some system, we still have some problems ...

- The DLL should probably work with Fly!1, and with all DirectX8 compatible joystick
 (please tell me).
	

I hope you will enjoy ! (sorry for my poor english)



$$$$$$$$$$$$$$$$$$$$$$$$ C O M M O N    S E C T I O N  $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$


-------------------------------------------------------------------------------------------------------------
Known problems:
- It seems that this DLL doesn't work correctly with NON USB joysticks - I have spend many hours on that - sorry


-------------------------------------------------------------------------------------------------------------
Version History :

- 0.83 ==>  first beta for external beta test

- 0.84 ==>  some compilation options changed

- 0.85 ==>  again some compilation options (runtime DLL) changed with success on some PC malfunction (not all :-(( )

- 0.90 ==>  add "AirFeedback.ini" support to adapt hardness range regarding speed range on all aircrafts.
            add "Buffeting" effect at stall full flaps air speed, but I need more explanations from real life pilots
            to create a correct one, and I didn't find any solution to retrieve the FLAPS position !
            add "AirFeedback.log" to trace problems
            I've increased the overall effect level, but you can decrease them with you own joystick software !

- 0.91 ==>  modified start time for the permanent effect (try to correct some missing effect with some system)
            NO GOOD results :-((

- 0.92 ==>  add new setting for all plane in "AirFeedback.ini" to adjust the sensitivity to pitch/roll accelerations
            (for example with the PA 28)

- 0.93 ==>  avoid buffeting with helicopters !

- 0.94 ==>  Add more FAILED traces in AirFeedback.log. Changed the buffeting effect parameters and add the related
            Changed the ground algo.
                    option in AirFeedback.ini. **** NOW COMPILED WITH DIRECTX 9.0 Software Developpment Kit ****

- 0.95 ==>  UseJoystickState=0 for default value
            UseBuffetingEffect=1 for default value
            Modifications in AirFeedback.ini : duplicate identical aircraft sections to avoid finding problems. 
            Modifications in log file.

- 0.97 ==> Major modification in the way of initialise DirectX and connect the joystick - try to correct major problem on some system (again !)

- 0.98 ==> Add some trace for window address checking.
            Force global joystick gain to DI_FFNOMINALMAX.

- 0.99 ==> Add the global joystick gain in the INI file for fine tunning

- 1.00 ==> Bug correction : crash when no joystick found :-((
           Add different settings in INI file for roll & pitch acceleration effects (for the P51D Mustang)


====== Special thanks to Richard Harvey, who gave us a fantastic and really "opened" simulator ============
