wolfDashboard
Wolf Territoriesinteger wolfDashboard(string avatar, list rules)
Drive the Wolf dashboard of a driver sitting on this object: key/value pairs - type ("car", "truck", "bike", "speedboat", "spaceship", "submarine"), units ("kmh", "mph", "kn"), rpm, max_rpm, redline, max_speed, gear ("P", "R", "N", "D", "1".."18"), fuel, adblue (percent), temp (C), air1, air2 (bar), indicators (0 off, 1 left, 2 right, 3 hazard), lights (0, 1 dipped, 2 main), handbrake, retarder (0-5, the stage braking now), dsc_speed (km/h, downhill speed control's set speed), cruise, drive_time (seconds), odo (km), warnings ("engine,oil,abs,retarder..."), clear; speedboat/spaceship/submarine: throttle (-100..100), trim (-5..5), anchor, engine, mode ("ship", "rocket"), stage, stages (0-9), boost, shield, hull, heat (percent), assist, landing_gear, ballast (0-100), max_depth (m), oxygen, battery (percent), planes (-100..100), periscope. The speed is measured by the viewer. Each driver takes 10 at once, then 5 a second; at most 64 values (32 pairs) in one call. TRUE when sent.
Only for a script in the linkset the avatar is sitting on, on a Wolf Territories region, to a driver using WolfViewer or WolfStorm. Numbers outside a key's range are held to it; an unknown key, a key given twice or a value that is not allowed refuses the whole call. What you send is kept while the driver stays in the vehicle, until "clear", 1. Each driver takes 10 updates at once and then 5 a second; faster ones are refused ("too many dashboard updates for that avatar - slow down"). At most 64 values in one call (32 key/value pairs).
Parameters
| Type | Name | What it does |
|---|---|---|
| string | avatar | The driver: the avatar sitting on this object. |
| list | rules | Key/value pairs, any order, any subset. Every key, its type and its allowed values are in the table below. |
The rules list
Generated from the region software’s own list of accepted keys.
| Key | Type | Values | Note |
|---|---|---|---|
| type | string | matching ^(car|truck|bike|speedboat|spaceship|submarine)\z | |
| units | string | matching ^(kmh|mph|kn)\z | kn: knots (the speedboat's and submarine's default) |
| gear | string | "P", "R", "N", "D", "S", "C", "R1" to "R4", or "1" to "18" | |
| rpm | integer | 0 to 30000 (whole number) | |
| max_rpm | integer | 1000 to 30000 (whole number) | |
| redline | integer | 500 to 30000 (whole number) | |
| max_speed | integer | 10 to 1000 (whole number) | full scale, in units |
| fuel | float | 0 to 100 | percent |
| adblue | float | 0 to 100 | percent |
| temp | float | -40 to 150 | coolant, degrees C |
| air1 | float | 0 to 12 | brake circuit 1, bar |
| air2 | float | 0 to 12 | brake circuit 2, bar |
| indicators | integer | 0 to 3 (whole number) | 0 off, 1 left, 2 right, 3 hazard |
| lights | integer | 0 to 2 (whole number) | 0 off, 1 dipped, 2 main beam |
| handbrake | integer | 0 to 1 (whole number) | |
| retarder | integer | 0 to 5 (whole number) | 0 off, 1..5 the script's own stages |
| cruise | integer | 0 to 1 (whole number) | |
| drive_time | integer | 0 to 86400 (whole number) | seconds driven since the last break |
| odo | float | 0 to 9999999 | km |
| warnings | string | matching ^((engine|oil|battery|brake|abs|temp|tyre|airbag|seatbelt|fuel|adblue|air|door|esp|shield|hull|heat|stage|boost|anchor|depth|oxygen|leak)(,(?=.)|\z))*\z | |
| clear | integer | 0 to 1 (whole number) | 1: forget every value this vehicle set |
| throttle | integer | -100 to 100 (whole number) | lever percent; negative = astern / reverse thrust |
| trim | integer | -5 to 5 (whole number) | speedboat engine trim: 0 neutral, + bow up |
| anchor | integer | 0 to 1 (whole number) | speedboat anchor down |
| engine | integer | 0 to 1 (whole number) | engine running |
| mode | string | matching ^(ship|rocket)\z | spaceship HUD layout |
| stage | integer | 0 to 9 (whole number) | stage now firing, from 1; 0 = no stages |
| stages | integer | 0 to 9 (whole number) | total number of stages |
| boost | float | 0 to 100 | boost reserve, percent |
| shield | float | 0 to 100 | percent |
| hull | float | 0 to 100 | percent |
| heat | float | 0 to 100 | percent, 100 = overheated |
| assist | integer | 0 to 1 (whole number) | flight assist on |
| landing_gear | integer | 0 to 1 (whole number) | landing gear down |
| ballast | integer | 0 to 100 (whole number) | submarine ballast flooded, percent (0 = blown) |
| max_depth | integer | 1 to 1000 (whole number) | submarine safe depth, metres |
| oxygen | float | 0 to 100 | submarine oxygen, percent |
| battery | float | 0 to 100 | submarine battery, percent |
| planes | integer | -100 to 100 (whole number) | dive planes, percent; + = nose down |
| periscope | integer | 0 to 1 (whole number) | periscope up |
How players use it, and more examples: the Driving guide.
Example
wolfDashboard(llAvatarOnSitTarget(), ["type","car",
"rpm", 3200, "gear", "3", "fuel", 74]);Ours alone. Grid features you will not find on any other OpenSimulator grid.