(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_HINT_WAVE_TRUNCATION

A variable controlling how a truncated WAVE file is handled.

Header File

Defined in <SDL3/SDL_hints.h>

Syntax

#define SDL_HINT_WAVE_TRUNCATION "SDL_WAVE_TRUNCATION"

Remarks

A WAVE file is considered truncated if any of the chunks are incomplete or the data chunk size is not a multiple of the block size. By default, SDL decodes until the first incomplete block, as most applications seem to do.

The variable can be set to the following values:

• "verystrict" - Raise an error if the file is truncated.
• "strict" - Like "verystrict", but the size of the RIFF chunk is ignored.
• "dropframe" - Decode until the first incomplete sample frame.
• "dropblock" - Decode until the first incomplete block. (default)

This hint should be set before calling SDL_LoadWAV() or SDL_LoadWAV_IO()

Version

This hint is available since SDL 3.1.3.

---

CategoryAPI, CategoryAPIMacro, CategoryHints

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.