Edit

EQUALIZERSETTINGS Element

  • Article

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The EQUALIZERSETTINGS element provides a way to manipulate the graphic equalizer and other audio settings of Windows Media Player using the attributes and method listed here.

The EQUALIZERSETTINGS element supports the following attributes.

Attribute Description
bands Retrieves the number of frequency bands supported.
bypass Specifies or retrieves a value indicating whether the equalizer filter is bypassed in the filter graph.
crossFade Specifies or retrieves a value indicating whether cross-fade is enabled.
crossFadeWindow Specifies or retrieves the amount of cross-fade overlap in milliseconds.
currentPreset Specifies or retrieves the index of the current preset.
currentPresetTitle Retrieves the title of the current preset.
currentSpeakerName Retrieves the name of the current speaker setting.
enableSplineTension Specifies or retrieves a value indicating whether spline tension is enabled or disabled.
enhancedAudio Specifies or retrieves a value indicating whether enhanced audio is turned on.
gainLevels Specifies or retrieves the gain level of the band corresponding to the index provided.
gainLevel1 Specifies or retrieves the gain level of band 1.
gainLevel2 Specifies or retrieves the gain level of band 2.
gainLevel3 Specifies or retrieves the gain level of band 3.
gainLevel4 Specifies or retrieves the gain level of band 4.
gainLevel5 Specifies or retrieves the gain level of band 5.
gainLevel6 Specifies or retrieves the gain level of band 6.
gainLevel7 Specifies or retrieves the gain level of band 7.
gainLevel8 Specifies or retrieves the gain level of band 8.
gainLevel9 Specifies or retrieves the gain level of band 9.
gainLevel10 Specifies or retrieves the gain level of band 10.
normalization Specifies or retrieves a value indicating whether normalization is enabled.
normalizationAverage Retrieves the average normalization value.
normalizationPeak Retrieves the peak normalization value.
presetCount Retrieves the number of presets available.
speakerSize Specifies or retrieves the index of the current speaker size.
splineTension Specifies or retrieves the spline tension for the equalizer control.
truBassLevel Specifies or retrieves the SRS TruBass level.
wowLevel Specifies or retrieves the SRS WOW Effect level.

 

The EQUALIZERSETTINGS element supports the following methods.

Method Description
nextPreset Applies the next equalizer preset.
presetTitle Retrieves the name of the equalizer preset with the specified index.
previousPreset Applies the previous equalizer preset.
reset Resets the gain levels of all bands to zero decibels.

 

The EQUALIZERSETTINGS element can implement the attribute_onchange event handlers.

Skin Programming Reference