Audio Resampler DSP

The Audio Resampler performs one or both of the following actions on an audio stream.

• Change the sampling rate.
• Change the number of channels.

CLSID

CLSID_CResamplerMediaObject

Interfaces

• IMediaObject
• IMFTransform
• IPropertyStore
• IWMResamplerProps

Formats

PCM or IEEE floating-point

The media type must specify an uncompressed PCM or floating-point audio format.

• For the IMFTransform interface, initialize the media type as described in Uncompressed Audio Media Types.
• For the IMediaObject interface, the media type must be a FORMAT_WaveFormatEx type. For more information, see DMO_MEDIA_TYPE.

Properties

• MFPKEY_WMRESAMP_FILTERQUALITY
• MFPKEY_WMRESAMP_CHANNELMTX
• MFPKEY_WMRESAMP_LOWPASS_BANDWIDTH

Required Attributes

The resampler requires the following attributes to be set on it:

• MF_MT_AUDIO_CHANNEL_MASK
• MF_MT_AUDIO_AVG_BYTES_PER_SECOND
• MF_MT_AUDIO_BLOCK_ALIGNMENT

Custom Channel Mapping

The audio resampler maps the input audio channels to the output audio channels, based on the following information:

• The number of channels. This is given in the MF_MT_AUDIO_NUM_CHANNELS attribute of the media type, or the nChannels member of the WAVEFORMATEX structure.
• The channel mask, which assigns channels to speaker position. The channel mask is given in the MF_MT_AUDIO_CHANNEL_MASK attribute of the media type, or the dwChannelMask member of the WAVEFORMATEXTENSIBLE structure.
• A matrix of mapping weights.

The matrix contains a series of weights, such that each output channel is a weighted average of the input channels.

You can specify a custom matrix for channel mapping by calling IWMResamplerProps::SetUserChannelMtx or by setting the MFPKEY_WMRESAMP_CHANNELMTX property. If a custom matrix is not provided, the Audio Resampler uses a set of default matrices.

Default Channel Mapping

If you do not specify a custom matrix, the Audio Resampler DSP uses default values for channel mapping.

In the tables that follow, the channels are abbreviated:

• L: Left
• R: Right
• C: Center
• LFE: Low Frequence Effects
• BL: Back Left
• BR: Back Right
• SL: Surround Left
• SR: Surround Right

The following table shows the default coefficients for mapping 6 channels (mask 0x3F) to 2 channels.

The following table shows the default coefficients for mapping 6 channels (mask 0x60F) to 2 channels.

The following table shows the default coefficients for mapping 6 (mask 0x3F or 0x60F) channels to 1 channel.

The following table shows the default coefficients for mapping 8 channels (mask 0x63F) to 2 channels.

The following table shows the default coefficients for mapping 8 channels (mask 0x63F) to 1 channel.

The following table shows the default coefficients for mapping 8 channels (mask 0x63F) to 6 channels (mask 0x3F).

The following table shows the default coefficients for mapping 8 channels (mask 0x63F) to 6 channels (mask 0x60F).

To understand how to interpret the tables of coefficients, consider the first table, which maps 6 channels to 2. The first row of the table (0.314, 0, 0.222, 0.031, 0.268, 0.164) is a vector of weights that specifies how heavily each input channel contributes to the left channel of the output. The second row of the table (0, 0.314, 0.222, 0.031, 0.164, 0.268) is a vector of weights that specifies how heavily each input channel contributes to the right channel of the output.

The following formulas show how the output channels are calculated.

L_out = L*0.314 + C*0.222 + LFE*0.031 + BL*0.268 + BR*0.164 
R_out = R*0.314 + C*0.222 + LFE*0.031 + BL*0.164 + BR*0.268

Output Quality

You can specify the output quality of the Audio Resampler DSP by calling IWMResamplerProps::SetHalfFilterLength or by setting the MFPKEY_WMRESAMP_FILTERQUALITY property. If you do not specify the output quality, the Audio Resampler DSP uses a default quality value of 30.

Requirements

See also

Digital Signal Processors