QtAudio Namespace

関数ドキュメント

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

audiovolume from a volume scaleto another を変換し、結果を返します。

コンテキストに応じて、オーディオの音量を表すために異なるスケールが使用されます。音声ボリュームを持つすべてのQt Multimedia クラスは、線形スケールを使用します。その理由は、スピーカーのラウドネスは、線形スケールで電圧を変調することによって制御されるからです。一方、人間の耳はラウドネスを対数的に知覚します。従って、ボリューム・コントロールに対数スケールを使用することは、ほとんどの用途において適切です。デシベルスケールはもともと対数スケールであり、サウンドレベルを定義するために一般的に使用され、それは通常、プロフェッショナルオーディオアプリケーションのUIボリュームコントロールに使用されます。キュービックスケールは、対数スケールの計算コストの安い近似値で、より低い音量レベルをよりコントロールできます。

次の例では、スライダコントロールのボリューム値を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 （）も参照 。