Gauger Plugin Version 0.6 Beta / Window Version 6.0 Beta

[Introduction]
  I developed a plugin and named "GaugerPlugin" for Richard Burns Rally (by SCi / Warthog)(RBR).
  If it is installed, you can visually see the operation of steering,
  throttle and brake etc. at replay, too. :)
  You can change the layout, size and colors etc.,
  and use RBRDll and Analog Gauges at the same time.
  Just for your information, GaugerPlugin detours a function
  at 0x0040E890 on RBR process that call IDirect3DDevice9::EndScene,
  and inserts Gauger rendering processing.


[credit]
  The GaugerPlugin is using a library called "DetourXS".
  It is a similar library to "Detours Express 2.1" by M$.
  ( I could download it from "Collaborative RCE Tool Library" and "UCDownloads". )
  The "DetourXS" is released by Sinner, and includes following credits.
    * z0mbie's ADE32 (source code of disassembler)
    * LanceVorgin's CDetour (some idea)
  I can not find its license, so I used it without asking....
  And, thanks to Sinner, z0mbie, LanceVorgin, and Warthog.
  For base texture, thanks to bloom , Racer_S and BLITZ.


[Requirement]
  * (Moderate) Knowledge of self-responsibility and self-sacrifice
  * DirectX 9.0c ( Summer 2004 or later )
  * RichardBurnsRally_SSE.exe or RichardBurnsRally_NoSSE.exe playable PC
  * Keep following 3 terms
    + Use this plugin at your own risk.
    + Do NOT receive any financial benefits ( e.g. money etc. ).
    + Do NOT add, change and remove any copyright, notices and terms.


[How to use]
  1.(Plugin Version)
    Please make "Plugins" folder in the RBR folder,
    and copy or move "GaugerPlugin.dll" into "Plugins".
    e.g.) copy or move GaugerPlugin.dll into
          D:\SCi Games\Richard Burns Rally\Plugins\
    (Window Version)
    Please launch Gauger.exe (before or after launching RBR).
  2.Please launch RichardBurnsRally_SSE.exe (RichardBurnsRally_NoSSE.exe)
    Note)You can use Kegetys's RBRDll and Racer_S's Analog Gauges at the same time.
  3.Please see it at Replay etc.
  4.Please change the configuration, if you need.
    e.g.) go to Options -> Plugins -> GaugerPlugin, then change and save,
          or edit directly GaugerPlugin.cfg (Gauger.cfg for Window Version)
          create at first time.


[Description]
  * Gauger will show you Shift-up Lights, Gear, Percentage of Lock/Slip,
    Boost Pressure, Water Temperature, Travel Distance,
    Distance from near Start Control, Distance to Finishing Line,
    Measuring Time, Car Speed ( it is different value from the actual speed,
    if tyres are locked / slipped ), Engine (Crankshaft) Revolutions,
    Steering, Throttle ( Accelerator ), Brake, Hand brake and Clutch.
  * Gauger will indicates 100%, if locked / slipped entirely,
    if you steered until steering was locked,
    applied the hand brake or floored the pedals.
    However, only in steering, it show you "L" if you steered left (-100% to -1%),
    "R" steered right (+1%`+100%) or "C" if steering is in the middle
    in the left of its value.


[Known Problems]
  * test is not enough   :(
  * probably there are bugs   >:(
  * program is getting lazy   ~>:(
  * we can NOT see the driving technique of Professor Burns....   :'(
  * the demonstration etc. is using that called "Animated Replay" different from normal replay,
    so Gauger can NOT get the data of operation etc.
  * GaugerPlugin indicates different value from the actual speed, if tyres are locked / slipped.
  * GaugerPlugin gets "filtered" value of steering, throttle and brake,
    so the values are different from the actual operation's.
  * Sometimes Gauger that is round off values will show you the different values
    from RBR digidash, because the digidash round values down.


[Future Aims (in other words, reverie or pie in the sky)]
  * Divide this GaugerPlugin into 2 parts : hooking part and
    getting values part (general-purpose dll) and rendering part (plugin dll).
    (I think this will allow us to avoid overlapping and competing
     (or scramble for hooking procedures) problem in the hooking part,
     and probably others more easily can make plugins.)
  * Modify the plugin to display also in the actual car speed.
  * Modify the plugin to display the applied load in each tyre
    and G Force like F1 TV programs, if those are implementable.
  * Allow us to see the driving technique of Professor Burns.
    (I think that it is just convert to the normal replay file.)


 V317MT ( Nov. 2009 )
http://www.geocities.jp/v317mt/
