What precisely is the "silence" value in the SDL audio API?

In SDL, when you set up your audio output device, you and SDL have to agree on an audio format - e.g. 44.1KHz stereo 16-bit signed little-endian. That's fine. But along with the final agreed format, you also get a computed "silence" value which doesn't seem well documented.

A silent sound sample obviously consist of the same sample value repeated over and over again, and you want that to be at the "zero" level. In a sense any constant value will do, but you have to agree a value (so you don't get pops when switching to a different sound), and in a sane world you want to choose a value bang in the centre of your sample-value range.

So if you happen to use an unsigned format for your sample value range for 0..whatever, your silence value will be (whatever/2).

EDIT - inserted "unsigned" below to avoid confusion.

That's all fine. But the silence value 开发者_如何学编程you get given is an unsigned 8-bit integer. That doesn't work very well if you want unsigned 16 bit samples - the logical silence value of 0x8000 requires two different byte values and it requires them to be in the correct endian order.

So the silence value you get from SDL doesn't seem to make much sense. You can't use it to wipe your buffers, for instance, without dealing with extra complications and making inferences which pretty much make the precalculated silence value pointless anyway.

Which means, of course, that I've misunderstood the point.

So - if this isn't how the silence value is meant to be used, how should it be used?

I have no evidence to back this up but I think the assumption here is that "silence" could be interpreted as "silence for common soundcard formats". Those being:

1. Unsigned 8-bit integers
2. Signed 16-bit integers
3. Signed 32-bit integers (for 24-bit audio data)
4. Normalized 32-bit floating point
5. Normalized 64-bit floating point.

In all the cases except for unsigned 8-bit, zero (0) is the "zero amplitude" value. So the returned unsigned 8-bit integer contains all the possible values of "zero amplitude" for these formats.