SDL_HINT_WAVE_TRUNCATION(3)

SDL_HINT_WAVE_TRUNCATION3

A variable controlling how a truncated wave file is handled.

Usage

#include "SDL3/SDL.h"

#define SDL_HINT_WAVE_TRUNCATION SDL_WAVE_TRUNCATION"

Header file

Defined in SDL3/SDL_hints.h

Overview

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 ()

Availability

This hint is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.