From 13f1cf1114321827d24aa762c018c0d32b4a4053 Mon Sep 17 00:00:00 2001
From: bnnm <bananaman255@gmail.com>
Date: Mon, 29 May 2023 00:38:46 +0200
Subject: [PATCH] doc

---
 doc/FORMATS.md | 147 ++++++++++++++++++++++++++-----------------------
 1 file changed, 79 insertions(+), 68 deletions(-)

diff --git a/doc/FORMATS.md b/doc/FORMATS.md
index 8b2e53d8..c1b0fdfa 100644
--- a/doc/FORMATS.md
+++ b/doc/FORMATS.md
@@ -246,74 +246,85 @@ This list is not complete and many other files are supported.
 Quick list of most codecs vgmstream supports, including many obscure ones that
 are used in few games.
 
-- PCM 16-bit
-- PCM 8-bit (signed, unsigned)
-- PCM 4-bit (signed, unsigned)
-- PCM 32-bit float
-- u-Law/a-LAW
-- CRI ADX (standard, fixed, exponential, encrypted)
-- Nintendo DSP ADPCM a.k.a GC ADPCM
-- Nintendo DTK ADPCM
-- Nintendo AFC ADPCM
-- ITU-T G.721
-- CD-ROM XA ADPCM
-- Sony PSX ADPCM a.k.a VAG (standard, badflags, configurable, extended)
-- Sony HEVAG
-- Electronic Arts EA-XA (stereo, mono, Maxis)
-- Electronic Arts EA-XAS (v0, v1)
-- DVI/IMA ADPCM (stereo/mono + high/low nibble, 3DS, Quantic Dream, SNDS, etc)
-- Microsoft MS IMA ADPCM (standard, Xbox, NDS, Radical, Wwise, FSB, WV6, etc)
-- Microsoft MS ADPCM (standard, Cricket Audio)
-- Westwood VBR ADPCM
-- Yamaha ADPCM (AICA, Aska)
-- Procyon Studio ADPCM
-- Level-5 0x555 ADPCM
-- lsf ADPCM
-- Konami MTAF ADPCM
-- Konami MTA2 ADPCM
-- Paradigm MC3 ADPCM
-- FMOD FADPCM 4-bit ADPCM
-- Konami XMD 4-bit ADPCM
-- Platinum 4-bit ADPCM
-- Argonaut ASF 4-bit ADPCM
-- Tantalus 4-bit ADPCM
-- Ocean DSA 4-bit ADPCM
-- Circus XPCM ADPCM
-- Circus XPCM VQ
-- OKI 4-bit ADPCM (16-bit output, 4-shift, PC-FX)
-- Ubisoft 4/6-bit ADPCM
-- Tiger Game.com ADPCM
-- LucasArts iMUSE VBR ADPCM
-- CompressWave (CWav) Huffman ADPCM
-- SDX2 2:1 Squareroot-Delta-Exact compression DPCM
-- CBD2 2:1 Cuberoot-Delta-Exact compression DPCM
-- Activision EXAKT SASSC DPCM
-- Xilam DERF DPCM
-- InterPlay ACM
-- VisualArt's NWA
-- Electronic Arts MicroTalk a.k.a. UTK or UMT
-- Relic Codec
-- CRI HCA
-- tri-Ace PS2 Codec
-- Xiph Vorbis (Ogg, FSB5, Wwise, OGL, Silicon Knights)
-- MPEG MP1/2/3 (standard, AHX, XVAG, FSB, AWC, P3D, EA, etc)
-- ITU-T G.722.1 annex C a.k.a. Polycom Siren 14 (Namco)
-- ITU-T G.719 annex B a.k.a. Polycom Siren 22
-- Electronic Arts EASpeex
-- Electronic Arts EALayer3
-- Electronic Arts EA-XMA
-- Sony ATRAC3, ATRAC3plus
-- Sony ATRAC9
-- Microsoft XMA1/2
-- Microsoft WMA v1, WMA v2, WMAPro
-- AAC
-- Bink
-- AC3/SPDIF
-- Xiph Opus (Ogg, Switch, EA, UE4, Exient)
-- Xiph CELT (FSB)
-- Musepack
-- FLAC
-- Inti Creates' Range / DCT codecs
+- PCM
+  - PCM 16-bit (little endian, big endian)
+  - PCM 8-bit (signed, unsigned, sign bit)
+  - PCM 4-bit (signed, unsigned)
+  - PCM 24-bit (little endian, big endian)
+  - PCM 32-bit float
+  - u-Law/a-LAW
+- ADPCM (BRR/XA-style)
+  - CD-ROM XA ADPCM
+  - Sony PSX ADPCM a.k.a VAG (standard, badflags, configurable, extended)
+  - CRI ADX (standard, fixed, exponential, encrypted)
+  - Silicon Graphics VADPCM
+  - Nintendo DSP ADPCM a.k.a GC ADPCM
+  - Nintendo DTK ADPCM
+  - Nintendo AFC ADPCM
+  - Microsoft MSADPCM (standard, mono, Cricket Audio)
+  - Electronic Arts EA-XA (stereo, mono, Maxis)
+  - Electronic Arts EA-XAS (v0, v1)
+  - Konami MTAF ADPCM
+  - Konami MTA2 ADPCM
+  - FMOD FADPCM ADPCM
+  - Procyon Studio ADPCM
+  - Level-5 0x555 ADPCM
+  - Konami XMD ADPCM
+  - Argonaut ASF ADPCM
+  - Tantalus ADPCM
+- ADPCM (IMA-style)
+  - DVI/IMA ADPCM (stereo/mono + high/low nibble, 3DS, Quantic Dream, SNDS, etc)
+  - Microsoft MS-IMA ADPCM (standard, Xbox, NDS, Radical, Wwise, FSB, WV6, etc)
+  - Yamaha ADPCM (AICA, Aska)
+  - Westwood VBR ADPCM
+  - OKI ADPCM (16-bit output, 4-shift, PC-FX)
+  - LucasArts iMUSE VBR ADPCM
+  - Tiger Game.com ADPCM
+- ADPCM (others)
+  - Sony HEVAG
+  - Ubisoft 4/6-bit ADPCM
+  - Platinum ADPCM
+  - Paradigm MC3 ADPCM
+  - Ocean DSA ADPCM
+  - lsf ADPCM
+  - ITU-T G.721
+  - CompressWave (CWav) Huffman ADPCM
+- Perceptual/transform-based
+  - MPEG MP1/2/3 (standard, AHX, XVAG, FSB, AWC, P3D, EA, etc)
+  - Xiph Vorbis (Ogg, FSB, Wwise, OGL, Silicon Knights)
+  - CRI HCA
+  - ITU-T G.722.1 annex C a.k.a. Polycom Siren 14 (Namco)
+  - ITU-T G.719 annex B a.k.a. Polycom Siren 22
+  - Xiph Opus (Ogg, Switch, EA, UE4, Exient, FSB)
+  - Xiph CELT (FSB)
+  - Microsoft XMA1/2
+  - Microsoft WMA v1, WMA v2, WMAPro
+  - AAC
+  - Sony ATRAC3
+  - Sony ATRAC3plus
+  - Sony ATRAC9
+  - Relic Codec
+  - tri-Ace PS2 Codec
+  - Bink
+  - AC3/SPDIF
+  - Musepack
+  - Electronic Arts EASpeex
+  - Electronic Arts EALayer3
+  - Electronic Arts EA-XMA
+  - Electronic Arts MicroTalk a.k.a. UTK or UMT
+  - Inti Creates DCT codec
+  - Circus XPCM VQ
+- Misc
+  - SDX2 2:1 Squareroot-Delta-Exact compression DPCM
+  - CBD2 2:1 Cuberoot-Delta-Exact compression DPCM
+  - Activision EXAKT SASSC DPCM
+  - Xilam DERF DPCM
+  - Circus XPCM DPCM
+  - VisualArt's NWA PCM/DPCM
+  - Marble WADY PCM/DPCM
+  - InterPlay ACM
+  - Inti Creates Range codec
+  - FLAC
 - Others
 
 Sometimes standard codecs come in non-standard layouts that aren't normally