enumerazione AUDIO_CURVE_TYPE (ksmedia.h)

Articolo
02/26/2024

L'enumerazione AUDIO_CURVE_TYPE definisce costanti che specificano un algoritmo di curva da applicare per impostare un livello di volume.

Sintassi

typedef enum {
  AUDIO_CURVE_TYPE_NONE,
  AUDIO_CURVE_TYPE_WINDOWS_FADE
} AUDIO_CURVE_TYPE;

Costanti


`AUDIO_CURVE_TYPE_NONE` Specifica che non verrà applicato alcun algoritmo di curva. Quando si specifica questa curva, la durata della curva specificata deve essere uguale a 0.
`AUDIO_CURVE_TYPE_WINDOWS_FADE` Specifica che l'algoritmo applicato all'impostazione del volume deve seguire la curva illustrata nel diagramma nella sezione Osservazioni .

Commenti

Il frammento di pseudocodice seguente mostra la logica per l'algoritmo applicato all'impostazione del volume per raggiungere il livello del volume di destinazione.

// 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;
    }
}

Il diagramma seguente mostra una rappresentazione grafica dello pseudocodice precedente per l'impostazione del livello del volume.

Rappresentazione grafica della curva a livello di volume.