SDL_HINT_WAVE_RIFF_CHUNK_SIZE(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_HINT_WAVE_RIFF_CHUNK_SIZE 💖

okay bestie, so this is a page from the SDL3 FUNCTIONS manual — yes, that SDL — and it's all about one lil hint that controls how the size of the RIFF chunk affects the loading of a WAVE file. no cap. let's get into it 🎀

✨ NAME ✨

SDL_HINT_WAVE_RIFF_CHUNK_SIZE — a variable controlling how the size of the RIFF chunk affects the loading of a WAVE file. that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_WAVE_RIFF_CHUNK_SIZE "SDL_WAVE_RIFF_CHUNK_SIZE"

💅 DESCRIPTION 💅

so here's the tea: the size of the RIFF chunk (which, for the record, includes all the sub-chunks of the WAVE file) is not always reliable. 😭 like, it says it's a certain size and then… it isn't. rude. and in case that size is wrong, it's possible to just ignore it entirely and step through the chunks one by one until a fixed limit is reached. slay. ✨

now, a heads up, because this part matters: files that have trailing data unrelated to the WAVE file, or corrupt files, may slow down the loading process without a reliable boundary. 💀 by default, SDL stops after 10000 chunks to prevent wasting time. if you wanna change that, use SDL_HINT_WAVE_CHUNK_LIMIT to adjust this value. iykyk.

the variable can be set to the following values:

  • "force" — always use the RIFF chunk size as a boundary for the chunk search. it's giving boundaries. 👑
  • "ignorezero" — like "force", but a zero size searches up to 4 GiB. this one is the default. 🫶
  • "ignore" — ignore the RIFF chunk size and always search up to 4 GiB. go big or go home fr fr.
  • "maximum" — search for chunks until the end of file. > ⚠️ not recommended, bestie. this is the main-character-of-chaos option. 🙈
💡 set this hint before calling SDL_LoadWAV() or SDL_LoadWAV_IO(). before, bestie. the way that timing matters… ⏰

🌈 AVAILABILITY 🌈

this hint is available since SDL 3.2.0. iconic behavior honestly. ⭐

Simple Directmedia Layer • SDL 3.4.18 • SDL_HINT_WAVE_RIFF_CHUNK_SIZE(3)

and that's the whole page, bestie 💜 mwah, go load some WAVs responsibly 🎀✨

📦 where this page comes from