###### (This function is part of SDL_mixer, a separate library from SDL.)
# Mix_SetPanning

Set the panning of a channel.

## Header File

Defined in SDL_mixer.h

## Syntax

```c
int Mix_SetPanning(int channel, Uint8 left, Uint8 right);

```

## Function Parameters

|                 |                                                                   |
| --------------- | ----------------------------------------------------------------- |
| **channel**     | The mixer channel to pan or [MIX_CHANNEL_POST](MIX_CHANNEL_POST). |
| **left**        | Volume of stereo left channel, 0 is silence, 255 is full volume.  |
| **right**       | Volume of stereo right channel, 0 is silence, 255 is full volume. |

## Return Value

Returns zero if error (no such channel or
[Mix_RegisterEffect](Mix_RegisterEffect)() fails), nonzero if panning
effect enabled.

## Remarks

The left and right channels are specified as integers between 0 and 255,
quietest to loudest, respectively.

Technically, this is just individual volume control for a sample with two
(stereo) channels, so it can be used for more than just panning. If you
want real panning, call it like this:

```c
Mix_SetPanning(channel, left, 255 - left);
```

Setting `channel` to [MIX_CHANNEL_POST](MIX_CHANNEL_POST) registers this as
a posteffect, and the panning will be done to the final mixed stream before
passing it on to the audio device.

This uses the [Mix_RegisterEffect](Mix_RegisterEffect)() API internally,
and returns without registering the effect function if the audio device is
not configured for stereo output. Setting both `left` and `right` to 255
causes this effect to be unregistered, since that is the data's normal
state.

Note that an audio device in mono mode is a no-op, but this call will
return successful in that case. Error messages can be retrieved from
[Mix_GetError](Mix_GetError)().

Note that unlike most SDL and SDL_mixer functions, this function returns
zero if there's an error, not on success. We apologize for the API design
inconsistency here.

## Version

This function is available since SDL_mixer 3.0.0.

## See Also

* [Mix_SetPosition](Mix_SetPosition)
* [Mix_SetDistance](Mix_SetDistance)

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction)