{{{ #!Markdown

# CarTelemetry

Displays internal information from the vehicle's components (speed, acceleration, suspension, inputs...). Also shows the graphic tire telemetry (realtime friction curves) and the debugging gizmos in the Editor (force lines). It's used for debugging and fine tuning the vehicles. It doesn't have utility in games, but it's strongly recommended at the development stage for configuring and fine tuning the vehicles.

This script is added to a _Main_ GameObject intended to hold the control scripts for the scene, together with a [CarMain](CarMain) script.

__Target__: vehicle to show the telemetry from. It must contain a [CarControl](wiki:CarControl) script. The [CarMain](CarMain) script configures the Target to the active vehicle.

__Enabled__: shows or hides all the telemetry information.

__Gizmos__: if enabled, playing the project within the Unity Editor shows force lines at the tires. Also shows the center of mass for the vehicle. Enable the _Gizmos_ option in the Game window.
 
__Velocity__: in addition to the forces, velocity lines at the contact point for each tire (blue) are also displayed.

__Curves__: shows an additional window with the graphic tire telemetry, as well as graphic suspension data.

__Style__: text style for the telemetry window. A fixed-width font is recommended for the data to be properly aligned.

## Telemetry Data:

In the [live demo][] the telemetry data is shown with the B key (_Enabled_ property at the script).

__WheelFL, FR, RL, RR:__ data for front - rear, left - right wheels

> __RPM:__ wheel spin in revs per minute.  
__S:__ spring extension. 0 is fully compressed, 1 is fully extended.  
__F:__ force supported by the spring in Newtons.  
__FS:__ tyre's forward slip (m/s)  
__SS:__ tyre's sideways slip (m/s)  
__FSR:__ tyre's forward skid ratio (<1 ok, 1..2 loosing grip, >2 skidding)  
__SSR:__ type's sideways skid ratio

__Friction F, S:__ forward/sideways slip peak and asymptote.  
__Grip F, R:__ forward/sideways grip ratio  
__Stab F, R:__ force ratio transfered by the front - rear stabilizer bars  
__Steer L, R:__ steering angle for each wheel  

__Speed:__ forward speed in m/s, km/h and mph

> __Abs:__ absolute velocity of the rigidbody (m/s)  
__Lat:__ sideways velocity of the rigidbody (m/s)  
__Acc:__ acceleration of the rigidbody (m/s2)

__Pitch:__ forwards angle (typically changes when accelerating and braking)  
__Roll:__ sideways angle (typically changes when steering)  

> __AngV:__ pitch/roll change rate with their higher reached values

__Gear:__ current gear, D (drive), N (neutral) or R (reverse).  
__Accel, Brake, Handbrake, Steer:__ user's input to pedals and steering wheel.  
__MotorMax, BrakeMax:__ maximum motor and braking torque applied to the wheels.

__StabMode:__ stabilizer bars stiffness: auto, offroad, comfort, sport, none (5)  
__ABS:__ Antilock Brake System (1)  
__TC:__ Traction Control (2)  
__ESP:__ auto-steering angle limiter (3)  
__4x4 / front / rear:__ current traction axle (4)  
__Slow-Motion:__ slow time scale is enabled (T)

## Tyre telemetry:

In the [live demo][] the tire telemetry is shown with the B key (show telemetry data), then shift-B (_Curves_ property at the script).

__Forwards and sideways friction curves per each wheel__, with their extremum and asymptote values. The horizontal scale is the tire slip in m/s. Forward and sideways slip values are shown in realtime:

__Green:__ slip is ok, the extremum value has not been reached.  
__Yellow:__ slip is between extremum and asymptote. Tire force is decreasing.  
__Red:__ slip has surpassed the asymptote value. Tyre force is the minimum (skidding).  

__Suspension and stabilizer bars__ are exposed in the right-most graphs:

__Wheels:__ the left bar shows the suspension travel, the right one the suspension force. Yellow means the suspension force has exceeded the spring value, and red means the suspension has reached its travel limit and it's fully compressed so hard contact points are created.  
__Stabilizer bars:__ the horizontal scale is the relative roll for that axle (0 = no roll, 1 = maximum roll before the inner wheel lifts from the ground) and the curve means the amount of force the stabilizer bar is exerting. Yellow means the force has exceeded the 50%, red means the force has exceeded the 75%.

[live demo]: http://www.edy.es/unity/offroader.html

}}}