QtAudio Namespace

関数のドキュメント

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

オーディオvolume from をある音量スケールto 別の音量スケールに変換し、その結果を返します。

文脈に応じて、オーディオの音量を表現するために異なるスケールが使用されます。オーディオの音量を持つすべてのQt Multimedia クラスは線形スケールを使用しています。その理由は、スピーカーの音量は、線形スケールに基づいて電圧を変調することで制御されるためです。 一方、人間の耳は音量を対数的に知覚します。したがって、ほとんどのアプリケーションでは、音量コントロールに対数スケールを使用するのが適切です。 デシベル（dB）スケールは本質的に対数スケールであり、音圧レベルの定義に一般的に使用されます。プロ用オーディオアプリケーションのUI音量コントロールでは、通常これを使用します。3乗スケールは、計算負荷の低い対数スケールの近似値であり、低音量域での制御性を高めます。

以下の例は、スライダーコントロールから取得した音量値を、QMediaPlayer に渡す前に変換する方法を示しています。その結果、音量スライダーを20から30に上げた場合と、50から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));
}

関連項目： VolumeScale 、QAudioSink::setVolume()、QAudioSource::setVolume()、およびQSoundEffect::setVolume()。