QtAudio Namespace

Documentación de funciones

float QtAudio::convertVolume(float volume, QtAudio::VolumeScale from, QtAudio::VolumeScale to)

Convierte un audio volume from una escala de volumen to otra, y devuelve el resultado.

Dependiendo del contexto, se utilizan diferentes escalas para representar el volumen del audio. Todas las clases de Qt Multimedia que tienen un volumen de audio utilizan una escala lineal, la razón es que la sonoridad de un altavoz se controla modulando su voltaje en una escala lineal. El oído humano, en cambio, percibe el volumen de forma logarítmica. Por lo tanto, utilizar una escala logarítmica para los controles de volumen es adecuado en la mayoría de las aplicaciones. La escala de decibelios es logarítmica por naturaleza y se utiliza habitualmente para definir los niveles sonoros; suele emplearse para los controles de volumen de la interfaz de usuario en aplicaciones de audio profesionales. La escala cúbica es una aproximación computacionalmente barata de una escala logarítmica, proporciona más control sobre los niveles de volumen más bajos.

El siguiente ejemplo muestra cómo convertir el valor del volumen de un control deslizante antes de pasarlo a QMediaPlayer. Como resultado, el aumento percibido del volumen es el mismo cuando se aumenta el control deslizante del volumen de 20 a 30 que cuando se aumenta de 50 a 60:

void applyVolume(int volumeSliderValue)
{
    // volumeSliderValue is in the range [0..100]

    qreal linearVolume = QtAudio::convertVolume(volumeSliderValue / qreal(100.0),
                                                QtAudio::LogarithmicVolumeScale,
                                                QtAudio::LinearVolumeScale);

    player.setVolume(qRound(linearVolume * 100));
}

Véase también VolumeScale, QAudioSink::setVolume(), QAudioSource::setVolume(), y QSoundEffect::setVolume().