---
name: "SDL_HINT_WAVE_TRUNCATION"
section: "3"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_HINT_WAVE_TRUNCATION"
---

# SDL\_HINT\_WAVE\_TRUNCATION(3)

A variable controlling how a truncated WAVE file is handled.

## NAME

SDL\_HINT\_WAVE\_TRUNCATION - A variable controlling how a truncated WAVE file is handled.

## HEADER FILE

Defined in SDL3/SDL\_hints.h

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**#define SDL\_HINT\_WAVE\_TRUNCATION** *SDL\_WAVE\_TRUNCATION"*

## DESCRIPTION

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.