New vehicle light types and controls

[ohlidalp]

Closes #2751 (when done). Closes #2946 because syncing of flare states between linked actors is completely redone here. Pardon the messy history below, this PR grew quie far beyond it's intended scope.

Changes:

• Added new flare types and input events - see this comment
• Deleted input event TOGGLE_TRUCK_LIGHTS (N) because it would conflict with new, more specific input events. The N hotkey was repurposed as low beams toggle.
• Added dash elements for all flare types, even those not comonly present on dashboards: custom_lightN (N is 1-10), headlights, highbeams, foglights, sidelights, brake_lights, reverse_light, beacons.
• Existing dashboard element lights (bool) is now an alias of sidelights.
• Savegame: field lights repurposed for headlights, added fields high_beams, fog_lights. Savegame version was not bumped, the new fields are optional and default to false.
• Savegame: field pp_beacon_light was renamed to beacon_light. On loading game, the latter is preffered if exists, otherwise former is loaded. The strange pp_ prefix was caused by find-&-replace derp in commit 5a159ad9c0d0ffb1fa3e6f4f9c4577fab3910e3e.
• Truck file format: section flares3 which obeys set_inertia_defaults for incandescence effect, see this comment
• RoRnet: added enum Lightmask because new flare types wouldn't fit in existing enum Flagmask. Also, these flags are used for both networking and internally, simplifying light syncing between linked actors.

Limitations:

• At the moment, the fading effect of flares3 works only for flare billboards, not light sources or materialflarebindings. To be done after OGRE13 port.

Testing:

• To test new dashboard elements, use attached dashtut agoras
• To test flares3, use attached flare3-agoras
• both have user flares on the rear

[ohlidalp]

After getting feedback from Discord, I'll do these changes: EDIT: more feedback, I'm reassigning 'N' as CYCLE_LIGHTS and 'B' as HIGH_BEAMS.

• s - Sidelights (running/parking lights) - control with TOGGLE_TRUCK_LIGHTS or CYCLE_TRUCK_LIGHTS
• f - Low beams - control with TOGGLE_TRUCK_LIGHTS or CYCLE_TRUCK_LIGHTS
• t - Tail lights - activated together with f.
• h - High beams - activated separately by TOGGLE_TRUCK_HIGH_BEAMS
• g - Fog lights - activated by TOGGLE_TRUCK_FOG_LIGHTS

Key controls:

• TOGGLE_TRUCK_LIGHTS (N) - deleted to avoid conflict with user's older inputmaps (because of the added EXPL tag).
• TOGGLE_TRUCK_LOW_BEAMS (Ctrl+ N) toggle truck low beams (on/off); also toggles running lights.
• CYCLE_TRUCK_LIGHTS (N) cycle truck front light mode (off -> running light -> low beams -> off).
• TOGGLE_TRUCK_HIGH_BEAMS (B) toggle truck high beams (on/off); doesn't need low beams, doesn't use 't' lights.
• TOGGLE_TRUCK_FOG_LIGHTS (Alt+N) toggle truck fog lights (on/off); doesn't need low beams, doesn't use 't' lights.

[ohlidalp]

Purpose: To raise the bar for vehicle accuracy - add separate headlight/high beam/foglight/sidelight (running light) controls, including multiplayer sync.

Estimate: 3 man days. Flares and hotkeys work, just dashboard system needs to be extended.

[ohlidalp]

By popular demand (last but not least: https://forum.rigsofrods.org/threads/incandesant-material-flares.3749/) I tried hooking flares into our existing "command key inertia" system (docs: https://docs.rigsofrods.org/vehicle-creation/fileformat-truck/#set_inertia_defaults) so they would fade in and out with fine control. The result is a complete success.

To test, use the attached vehicle (modified Agora bus with 10 user flares). flare3-agoras.zip

All lights are set to the same parameters:

flares3
set_inertia_defaults 0.4, 0.8, linear, linear

In the GIF below, right blinker is on, user lights 0-6 are toggled on, and finally brake lights are tested.

[ohlidalp]

AgoraS with silly custom dashboard HUD to test the new elements.

dashtut-agora.zip

[CuriousMike56]

• Beacons (M key) no longer works
• CTRL+N (light mode cycle) doesn't cycle high beams, only headlights and sidelights

[ohlidalp]

• Fixed beacons (M key) not working.
• Fixed vehicles spawning with headlights on.
• Improved light cycling (CTRL+N) to use only available flares (fog lights are omitted): 1) all lights off 2) sidelights on but only if any installed, otherwise skip to 3). 3) sidelights and lowbeams on. 4) sidelights, lowbeams and highbeams on, but only if highbeams are installed, otherwise cycle to 1).

[ohlidalp]

I've restored the lights lamp as an alias for sidelights (aka "daytime running lights" in the US). It's the least wrong solution - sidelights automatically light up with low beams which is what the classic N key now does. Also the light cycling hotkey is intelligent now, anyway, it skips light types which have no flares installed - so for existing mods it will just toggle "1. off 2. sidelights+headlights".

[CuriousMike56]

Reverse lights no longer work: master this PR

Everything else seems to work nicely though 👍