Suspension Audio Debug

Editor extension for visualizing and debugging vehicle suspension audio parameters. Renders real-time graphs of shock compression, surface data, and audio-related wheel metrics. Also displays IMU and

Editor extension for visualizing and debugging vehicle suspension audio parameters. Renders real-time graphs of shock compression, surface data, and audio-related wheel metrics. Also displays IMU and vehicle body audio state.

Public Functions

Function	Description
`M.onEditorGui()`	Draws the Suspension Audio Debug ImGui window with beam sound plots
`M.onEditorInitialized()`	Registers the editor window under Audio menu
`M.onExtensionLoaded()`	No-op placeholder
`M.onExtensionUnloaded()`	No-op placeholder
`M.onVehicleSwitched(oldVehicle, newVehicle, player)`	Resets beam sound data on vehicle switch
`M.open()`	Shows the debug window

Example: Suspension Audio Debug Visualization

-- The debug window shows real-time plots for each wheel of the player vehicle:

-- Per-wheel graphs:
--   downForce         - suspension downforce
--   compressionSmooth - smoothed shock compression
--   lastSlip          - tire slip value
--   lastSurfaceType   - terrain surface type index

-- IMU data panel:
--   Yaw Rate, Lat Accel, Long Accel, Vert Accel

-- Body audio state:
--   eventDirtRoadSpeed, filteredTotalSlip, absFilteredTotalSlip
--   surfaceMaterial info

-- Data flow:
-- 1. Reads from: be:getPlayerVehicle(0) -> vehicleData.vdata
-- 2. Accesses: vdata.wheels, vdata.body (live telemetry)
-- 3. Plots scrolling line graphs via ImGui.PlotLines

-- Graph buffer size: 100 samples per metric per wheel
-- Updates every frame when the window is visible

Functions

`onExtensionLoaded()`

Callback for extension loaded event.

`onExtensionUnloaded()`

Callback for extension unloaded event.

`onVehicleSwitched(oldVehicle, newVehicle, player)`

Callback for vehicle switched event.

oldVehicle (any)
newVehicle (any)
player (any)

Returns: self

`open()`

Handles open.

Public Functions

Function	Description
`M.onEditorGui()`	Draws the Suspension Audio Debug ImGui window with beam sound plots
`M.onEditorInitialized()`	Registers the editor window under Audio menu
`M.onExtensionLoaded()`	No-op placeholder
`M.onExtensionUnloaded()`	No-op placeholder
`M.onVehicleSwitched(oldVehicle, newVehicle, player)`	Resets beam sound data on vehicle switch
`M.open()`	Shows the debug window

Example: Suspension Audio Debug Visualization

-- The debug window shows real-time plots for each wheel of the player vehicle:

-- Per-wheel graphs:
--   downForce         - suspension downforce
--   compressionSmooth - smoothed shock compression
--   lastSlip          - tire slip value
--   lastSurfaceType   - terrain surface type index

-- IMU data panel:
--   Yaw Rate, Lat Accel, Long Accel, Vert Accel

-- Body audio state:
--   eventDirtRoadSpeed, filteredTotalSlip, absFilteredTotalSlip
--   surfaceMaterial info

-- Data flow:
-- 1. Reads from: be:getPlayerVehicle(0) -> vehicleData.vdata
-- 2. Accesses: vdata.wheels, vdata.body (live telemetry)
-- 3. Plots scrolling line graphs via ImGui.PlotLines

-- Graph buffer size: 100 samples per metric per wheel
-- Updates every frame when the window is visible