BNVIB (File Format)
From Wexos's Wiki
(Redirected from BNVIB)
BNVIB (Binary NX VIBration) is a file format used on the Nintendo Switch. It contains controller rumble data.
File Format
The file byte order is always little endian.
Metadata
The file format starts with a section that contains metadata information:
Offset | Type | Description | |
---|---|---|---|
0x00 | UInt32 | Metadata size, excluding this value itself. | |
0x04 | UInt16 | Format ID. Always 3. | |
0x06 | UInt16 | Sampling rate in hertz. Always 200. | |
If Metadata size ≥ 0xC | |||
0x08 | UInt32 | Loop start sample position. | |
0x0C | UInt32 | Loop end sample position. | |
If Metadata size = 0x10 | |||
0x10 | UInt32 | Loop interval in samples, from the end of the loop to the start of the loop. |
Vibration Data
This section contains information about the rumble sample data.
Offset | Type | Description |
---|---|---|
0x00 | UInt32 | Data size (S), excluding this value. |
0x04 | UInt32[S / 4] | Vibration sample data. |
Vibration Sample Data
Each vibration value represents a sample, comprised in 4 bytes.
Offset | Type | Description |
---|---|---|
0x00 | Byte | Low band amplitude. |
0x01 | Byte | Low band frequency. |
0x02 | Byte | High band amplitude. |
0x03 | Byte | High band frequency. |
Converting Amplitude Values
The amplitude value recorded in a byte B can be converted using the following formula into an amplitude value in float:
Amplitude = B / 255
Converting Frequency Values
The frequency value recorded in a byte B can be converted using the following formula into a frequency value in float:
Frequency = 10 * 2B/32
Notes
- The default frequency for low bandwidths is 160 Hz.
- The default frequency for high bandwidths is 320 Hz.
- The conversion from audio data to vibration data is processed by resampling the audio to 8000 Hz and using either the Butterworth or Chebyshev filters (Butterworth by default). The samples are recalculated to fit with the controller's rumble sampling rate, which is 200 Hz.
Tools
The following tools can handle BNVIB files:
- (none)