Función Mix_SetPanning

Sintaxis

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

Descripción

Ajusta la panorámica de un canal.

Parámetros

channel

El canal del mezclador a panoramizar o MIX_CHANNEL_POST.

left

Volumen del canal izquierdo estéreo, 0 es silencio, 255 es volumen máximo.

right

Volumen del canal derecho estéreo, 0 es silencio, 255 es volumen máximo.

Valor de retorno

Devuelve cero si hay error (no existe tal canal o Mix_RegisterEffect() falla), distinto de cero si el efecto panorámico está activado.

Observaciones

Los volúmenes para los canales izquierdo y derecho se especifican como enteros entre 0 y 255, del más bajo al más alto, respectivamente.

Técnicamente, esto es sólo un control de volumen individual para una muestra con dos canales (estéreo), por lo que se puede utilizar para algo más que la panoramización. Si se quiere una panoramización real, llámarlo así:

Mix_SetPanning(channel, left, 255 - left);

Establecer el canal a MIX_CHANNEL_POST lo registra como un postefecto, y la panoramización se realizará al flujo final mezclado antes de pasarlo al dispositivo de audio.

Esta función utiliza la API Mix_RegisterEffect() internamente, y devuelve sin registrar la función de efecto si el dispositivo de audio no está configurado para salida estéreo. Establecer tanto la izquierda como la derecha a 255 hace que este efecto no se registre, ya que ese es el estado normal de los datos.

Hay que tener en cuenta que un dispositivo de audio en modo mono es un no-op, pero esta llamada volverá con éxito en ese caso. Los mensajes de error pueden ser recuperados desde Mix_GetError().

También hay que tener en cuenta que a diferencia de la mayoría de las funciones SDL y SDL_mixer, esta función devuelve cero si hay un error, no en caso de éxito.