Compartilhar via


enumeração AUDIO_CURVE_TYPE (ksmedia.h)

A enumeração AUDIO_CURVE_TYPE define constantes que especificam um algoritmo de curva a ser aplicado para definir um nível de volume.

Syntax

typedef enum {
  AUDIO_CURVE_TYPE_NONE,
  AUDIO_CURVE_TYPE_WINDOWS_FADE
} AUDIO_CURVE_TYPE;

Constantes

 
AUDIO_CURVE_TYPE_NONE
Especifica que nenhum algoritmo de curva será aplicado. Quando essa curva é especificada, a duração da curva especificada deve ser igual a 0.
AUDIO_CURVE_TYPE_WINDOWS_FADE
Especifica que o algoritmo aplicado à configuração de volume deve seguir a curva mostrada no diagrama na seção Comentários .

Comentários

O snippet de código a seguir do pseudocódigo mostra a lógica do algoritmo que é aplicado à configuração de volume para alcançar o nível de volume de destino.

// POWER IN AMPLITUDE: 1.75

// Fade In:
// Curve begins at 0 when nFrame = 0
// When nFrame gets to (nFrames - 1), curve = 1
//
// curve = pow(nFrame / (nFrames - 1), exponent)

float fFrameCount = nFrames - 1.0f;
for (UINT32 nFrame = 0; nFrame < nFrames; nFrame++) {
    float curve = powf(nFrame / fFrameCount, 1.75f);
    for (UINT32 nChannel = 0; nChannel < pWfx->nChannels; nChannel++) {
            pFloat[nFrame * pWfx->nChannels + nChannel] *= curve;
    }
}

// Fade Out:
// curve begins at 1 when nFrame = 0
// When nFrame gets to (nFrames - 1), curve = 0
//
// curve = pow(1 - (nFrame / (nFrames - 1)), exponent)

float fFrameCount = nFrames - 1.0f;
for (UINT32 nFrame = 0; nFrame < nFrames; nFrame++) {
    float curve = powf(1.0f - (nFrame / fFrameCount), 1.75f);
    for (UINT32 nChannel = 0; nChannel < pWfx->nChannels; nChannel++) {
            pFloat[nFrame * pWfx->nChannels + nChannel] *= curve;
    }
}

E o diagrama a seguir mostra uma representação gráfica do pseudocódigo anterior para definir o nível de volume.

Representação gráfica da curva de nível de volume.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Cabeçalho ksmedia.h

Confira também

KSAUDIOENGINE_VOLUMELEVEL

KSPROPERTY_AUDIOENGINE_VOLUMELEVEL