Wave Dictionary: Difference between revisions
Content added Content deleted
(Updated basically everything.) |
m (Surround UUIDs in code tags because it looks better.) |
||
Line 165: | Line 165: | ||
! Index !! Name !! Format || UUID |
! Index !! Name !! Format || UUID |
||
|- |
|- |
||
| 0 || rwaWAVEFORMAT_VAG || PlayStation VAG ADPCM || d9ea9798-bbbc-447b-96b2-654759102e16 |
| 0 || rwaWAVEFORMAT_VAG || PlayStation VAG ADPCM || <code>d9ea9798-bbbc-447b-96b2-654759102e16</code> |
||
|- |
|- |
||
| 1 || rwaWAVEFORMAT_PCM || Signed 16-bit PCM || d01bd217-3587-4eed-b9d9-b8e86ea9b995 |
| 1 || rwaWAVEFORMAT_PCM || Signed 16-bit PCM || <code>d01bd217-3587-4eed-b9d9-b8e86ea9b995</code> |
||
|- |
|- |
||
| 2 || rwaWAVEFORMAT_FLOAT || || da1e4382-2c99-4c61-ad99-7f364b211537 |
| 2 || rwaWAVEFORMAT_FLOAT || || <code>da1e4382-2c99-4c61-ad99-7f364b211537</code> |
||
|- |
|- |
||
| 3 || rwaWAVEFORMAT_GCNADPCM || Nintendo DSP-ADPCM || f86215b0-31d5-4c29-bd37-cdbf9bd10c53 |
| 3 || rwaWAVEFORMAT_GCNADPCM || Nintendo DSP-ADPCM || <code>f86215b0-31d5-4c29-bd37-cdbf9bd10c53</code> |
||
|- |
|- |
||
| 4 || rwaWAVEFORMAT_XADPCM || Xbox IMA ADPCM || 632fa22b-11dd-458f-aa27-a5c346e9790e |
| 4 || rwaWAVEFORMAT_XADPCM || Xbox IMA ADPCM || <code>632fa22b-11dd-458f-aa27-a5c346e9790e</code> |
||
|- |
|- |
||
| 5 || rwaWAVEFORMAT_WMA || Windows Media Audio || 3f1d8147-b7c4-41e6-a69b-3cc0025b33c7 |
| 5 || rwaWAVEFORMAT_WMA || Windows Media Audio || <code>3f1d8147-b7c4-41e6-a69b-3cc0025b33c7</code> |
||
|- |
|- |
||
| 6 || rwaWAVEFORMAT_MP3 || MPEG-1/2 Audio Layer III || bacfb36e-529d-4692-bf53-324256b0734f |
| 6 || rwaWAVEFORMAT_MP3 || MPEG-1/2 Audio Layer III || <code>bacfb36e-529d-4692-bf53-324256b0734f</code> |
||
|- |
|- |
||
| 7 || rwaWAVEFORMAT_MP2 || MPEG-1/2 Audio Layer II || 34d09a54-57d3-409e-a6ad-2bc845aec339 |
| 7 || rwaWAVEFORMAT_MP2 || MPEG-1/2 Audio Layer II || <code>34d09a54-57d3-409e-a6ad-2bc845aec339</code> |
||
|- |
|- |
||
| 8 || rwaWAVEFORMAT_MPG || MPEG-1/2 Audio Layer I || 04c15ba7-f907-40ab-a49f-eefef8c4d296 |
| 8 || rwaWAVEFORMAT_MPG || MPEG-1/2 Audio Layer I || <code>04c15ba7-f907-40ab-a49f-eefef8c4d296</code> |
||
|- |
|- |
||
| 9 || rwaWAVEFORMAT_AC3 || Dolby AC-3 || a30db390-58a9-43c4-b9d2-55d84d3ae754 |
| 9 || rwaWAVEFORMAT_AC3 || Dolby AC-3 || <code>a30db390-58a9-43c4-b9d2-55d84d3ae754</code> |
||
|- |
|- |
||
| 10 || rwaWAVEFORMAT_IMAADPCM || Microsoft IMA ADPCM || ef386593-b611-432d-957f-a71ade44227a |
| 10 || rwaWAVEFORMAT_IMAADPCM || Microsoft IMA ADPCM || <code>ef386593-b611-432d-957f-a71ade44227a</code> |
||
|} |
|} |
||
Line 192: | Line 192: | ||
! Name !! UUID |
! Name !! UUID |
||
|- |
|- |
||
| rwaHOST_PS2 || aaeac9ac-fc38-4917-ae81-64eadbc79353 |
| rwaHOST_PS2 || <code>aaeac9ac-fc38-4917-ae81-64eadbc79353</code> |
||
|- |
|- |
||
| rwaHOST_WIN32 || 44e50a10-08ba-4250-b971-69e921b9cf4f |
| rwaHOST_WIN32 || <code>44e50a10-08ba-4250-b971-69e921b9cf4f</code> |
||
|- |
|- |
||
| rwaHOST_XBOX || 453a2d04-e45f-4bc8-81f0-df758b01f273 |
| rwaHOST_XBOX || <code>453a2d04-e45f-4bc8-81f0-df758b01f273</code> |
||
|- |
|- |
||
| rwaHOST_GCN || fd9d32d3-e179-426a-8424-14720ac7f648 |
| rwaHOST_GCN || <code>fd9d32d3-e179-426a-8424-14720ac7f648</code> |
||
|} |
|} |
||
Revision as of 02:15, 31 May 2024
The RenderWare Audio Wave Dictionary container format stores audio assets in a linked list. It is normally given the file extensions .awd
, .hwd
, and .lwd
.
Wave dictionaries are used in Burnout 3, Revenge, and Dominator, as well as Black and Call of Duty: Finest Hour. Note that although Burnout Legends uses .*wd extensions, its files are not the same format as described here.
Structures
Stream header
Offset | Length | Type | Name | Description | Comments |
---|---|---|---|---|---|
0x0 | 0x4 | RwUInt32 | ? | Magic number | 0x809 |
0x4 | 0x1 | bool | ? | Indicates the stream header should be byteswapped | Causes _RwaWaveDictStreamHeaderByteSwap() to be run
|
0x5 | 0x3 | Padding | |||
0x8 | 0x4 | RwUInt32 | ? | Size of the header data to read for wave loading | |
0xC | 0x4 | RwaWaveDict* | ? | Wave dictionary | |
0x10 | 0x4 | RwUInt32 | ? | Unknown, but set at runtime if used | |
0x14 | 0x4 | RwUInt32 | ? | Wave data size | |
0x18 | 0x10 | RwaUUID | ? | Platform UUID | See platform |
0x28 | 0x4 | void* | ? | Wave data |
RwaWaveDict
To do: Research and list flags. |
Offset | Length | Type | Name | Description | Comments |
---|---|---|---|---|---|
0x0 | 0xC | RwaUniqueID | uniqueID | Dictionary ID | UUID set at runtime |
0xC | 0xC | RwaLLNode | waveListHead | Prev wraps to final node, next is first node, and data is nullptr In wave dictionaries, data is an RwaWave | |
0x18 | 0x2 | RwUInt8[2] | pad | Padding | |
0x1A | 0x1 | RwUInt8 | flagsAux | Auxiliary flags | |
0x1B | 0x1 | RwUInt8 | flags | Flags | |
0x1C | 0x4 | RwLLLink | link | Set at runtime Structure not documented here | |
0x24 | 0x4 | void* | dumpAddr | Wave dump address | Set at runtime |
0x28 | 0x4 | void* | waveRAMHandle | Wave handle | Set at runtime |
0x2C | 0x4 | RwUInt32 | waveRAMSize | Wave size in memory | Set at runtime |
RwaUniqueID
To do: Research and list flags. |
Offset | Length | Type | Name | Description | Comments |
---|---|---|---|---|---|
0x0 | 0x4 | RwaUniqueID__uuid | uuid | UUID | |
0x4 | 0x4 | RwaUniqueID__name | name | Name | |
0x8 | 0x4 | RwUInt32 | flags | Flags |
RwaLLNode
Offset | Length | Type | Name | Description | Comments |
---|---|---|---|---|---|
0x0 | 0x4 | RwaLLNode* | prev | Previous node | |
0x4 | 0x4 | RwaLLNode* | next | Next node | |
0x8 | 0x4 | void* | data | Current node's data |
RwaWave
Offset | Length | Type | Name | Description | Comments |
---|---|---|---|---|---|
0x0 | 0xC | RwaUniqueID | uniqueID | Wave ID | Data set at runtime |
0xC | 0x4 | RwaWaveDef* | waveDef | Wave definition Primarily contains function pointers |
Set at runtime Structure not described here |
0x10 | 0x1C | RwaWaveFormat | format | Source wave format | |
0x2C | 0x1C | RwaWaveFormat | targetFormat | Target wave format | |
0x48 | 0x4 | RwUInt32 | uncompressedLength | Null in samples. Set at runtime? | |
0x4C | 0x4 | void* | data | Wave data | Set at runtime |
0x50 | 0x4 | void* | state | Wave state | Set at runtime |
0x54 | 0x4 | RwUInt32 | flags | Flags | |
0x58 | 0x4 | RwaObj* | obj | Object data | Set at runtime Structure not described here |
RwaWaveFormat
To do: Research and list flags. Research misc data. |
Offset | Length | Type | Name | Description | Comments |
---|---|---|---|---|---|
0x0 | 0x4 | RwUInt32 | sampleRate | Sample rate | |
0x4 | 0x4 | RwaUUID* | dataType | Sample format | Index in asset, set to pointer at runtime. See data type |
0x8 | 0x4 | RwUInt32 | length | Duration (milliseconds) | |
0xC | 0x1 | uint8_t | bitDepth | Bit depth | |
0xD | 0x1 | uint8_t | noChannels | Number of channels | |
0xE | 0x2 | RwUInt8[2] | pad | Padding | |
0x10 | 0x4 | void* | miscData | Additional platform-specific data | Only used on GameCube in practice, where an additional header with coefficients and initial history data is present. |
0x14 | 0x4 | RwUInt32 | miscDataSize | Additional data size | |
0x18 | 0x1 | uint8_t | flags | Flags | |
0x19 | 0x1 | uint8_t | reserved | ||
0x1A | 0x2 | Padding |
RwaUUID
Offset | Length | Type | Name | Description | Comments |
---|---|---|---|---|---|
0x0 | 0x4 | RwUInt32 | time_low | Timestamp if version 1, otherwise random | Always a random value as UUID version is always 4 See RFC 9562 Section 5.4 |
0x4 | 0x2 | RwUInt16 | time_mid | ||
0x6 | 0x2 | RwUInt16 | time_hi_and_version | ||
0x8 | 0x8 | RwUInt8[8] | node |
Unions
RwaUniqueID__uuid
Length | Type | Name | Description | Comments |
---|---|---|---|---|
0x4 | RwaUUID* | uuid | ||
0x4 | RwaUUID* | copyUUID |
RwaUniqueID__name
Length | Type | Name | Description | Comments |
---|---|---|---|---|
0x4 | RwChar* | uniqueName | ||
0x4 | RwChar* | copyName |
Enumerations
Data type
Index | Name | Format | UUID |
---|---|---|---|
0 | rwaWAVEFORMAT_VAG | PlayStation VAG ADPCM | d9ea9798-bbbc-447b-96b2-654759102e16
|
1 | rwaWAVEFORMAT_PCM | Signed 16-bit PCM | d01bd217-3587-4eed-b9d9-b8e86ea9b995
|
2 | rwaWAVEFORMAT_FLOAT | da1e4382-2c99-4c61-ad99-7f364b211537
| |
3 | rwaWAVEFORMAT_GCNADPCM | Nintendo DSP-ADPCM | f86215b0-31d5-4c29-bd37-cdbf9bd10c53
|
4 | rwaWAVEFORMAT_XADPCM | Xbox IMA ADPCM | 632fa22b-11dd-458f-aa27-a5c346e9790e
|
5 | rwaWAVEFORMAT_WMA | Windows Media Audio | 3f1d8147-b7c4-41e6-a69b-3cc0025b33c7
|
6 | rwaWAVEFORMAT_MP3 | MPEG-1/2 Audio Layer III | bacfb36e-529d-4692-bf53-324256b0734f
|
7 | rwaWAVEFORMAT_MP2 | MPEG-1/2 Audio Layer II | 34d09a54-57d3-409e-a6ad-2bc845aec339
|
8 | rwaWAVEFORMAT_MPG | MPEG-1/2 Audio Layer I | 04c15ba7-f907-40ab-a49f-eefef8c4d296
|
9 | rwaWAVEFORMAT_AC3 | Dolby AC-3 | a30db390-58a9-43c4-b9d2-55d84d3ae754
|
10 | rwaWAVEFORMAT_IMAADPCM | Microsoft IMA ADPCM | ef386593-b611-432d-957f-a71ade44227a
|
Platform
Name | UUID |
---|---|
rwaHOST_PS2 | aaeac9ac-fc38-4917-ae81-64eadbc79353
|
rwaHOST_WIN32 | 44e50a10-08ba-4250-b971-69e921b9cf4f
|
rwaHOST_XBOX | 453a2d04-e45f-4bc8-81f0-df758b01f273
|
rwaHOST_GCN | fd9d32d3-e179-426a-8424-14720ac7f648
|