Audio Level: Configuration & Usage - Revision history

Dkn at 07:03, 9 April 2021

2021-04-09T07:03:14Z

Dkn at 06:43, 9 April 2021

2021-04-09T06:43:22Z

Dkn at 06:42, 9 April 2021

2021-04-09T06:42:51Z

Dkn at 06:41, 9 April 2021

2021-04-09T06:41:37Z

Dkn at 06:40, 9 April 2021

2021-04-09T06:40:10Z

Dkn at 06:39, 9 April 2021

2021-04-09T06:39:17Z

Dkn at 06:38, 9 April 2021

2021-04-09T06:38:41Z

Dkn at 06:38, 9 April 2021

2021-04-09T06:38:20Z

Dkn at 06:36, 9 April 2021

2021-04-09T06:36:56Z

Dkn at 06:36, 9 April 2021

2021-04-09T06:36:21Z

← Older revision		Revision as of 07:03, 9 April 2021
Line 1:		Line 1:
−	Brief description of the [[Audio Level]] DirectShow filter capabilities.	+	Brief description of the [[Audio Level]] DirectShow filter capabilities.<br>
	Interface IMLAudioLevel can be found in file <filter installation directory>\Idl\ALevel.idl		Interface IMLAudioLevel can be found in file <filter installation directory>\Idl\ALevel.idl

@@ Line 43: / Line 43: @@
 ===Spectrum analyzer===
-The signal spectrum (in dB) in a given channel can be obtained using the IMLAudioLevel::GetSpectrum() method. The whole spectrum is divided into 11 octaves with centers 15.625, 31.250, 62.500, 125.000, 250.000, 500.000, 1000.000, 2000.000, 4000.000, 8000.000, 16000.000 Hz.
+The signal spectrum (in dB) in a given channel can be obtained using the IMLAudioLevel::GetSpectrum() method.<br>
-Each octave can in turn be divided into bands.<br>
+The whole spectrum is divided into 11 octaves with centers 15.625, 31.250, 62.500, 125.000, 250.000, 500.000, 1000.000, 2000.000, 4000.000, 8000.000, 16000.000 Hz. Each octave can in turn be divided into bands.<br>
 The method returns an array of power spectrum values and the number of calculated values in the array. The number of calculated values is equal to min(total number of bands, array size). If the array size is less than the number of bands, then only the first spectrum values will be returned.<br>
 Spectrum analyzer parameters:<br>

@@ Line 43: / Line 43: @@
 ===Spectrum analyzer===
-The signal spectrum (in dB) in a given channel can be obtained using the IMLAudioLevel::GetSpectrum() method.
+The signal spectrum (in dB) in a given channel can be obtained using the IMLAudioLevel::GetSpectrum() method. The whole spectrum is divided into 11 octaves with centers 15.625, 31.250, 62.500, 125.000, 250.000, 500.000, 1000.000, 2000.000, 4000.000, 8000.000, 16000.000 Hz.
-The whole spectrum is divided into 11 octaves with centers 15.625, 31.250, 62.500, 125.000, 250.000, 500.000, 1000.000, 2000.000, 4000.000, 8000.000, 16000.000 Hz.
+Each octave can in turn be divided into bands.<br>
-Each octave can in turn be divided into bands.
+The method returns an array of power spectrum values and the number of calculated values in the array. The number of calculated values is equal to min(total number of bands, array size). If the array size is less than the number of bands, then only the first spectrum values will be returned.<br>
-The method returns an array of power spectrum values and the number of calculated values in the array. The number of calculated values is equal to min(total number of bands, array size).
+Spectrum analyzer parameters:<br>
-If the array size is less than the number of bands, then only the first spectrum values will be returned.
+- number of bands per octave: 1,2,3 or 6. If 0 is selected, then spectrum analyzer is disabled.<br>
-Spectrum analyzer parameters:
+- type of window function for spectrum calculation.<br>
 - number of bands per octave: 1,2,3 or 6. If 0 is selected, then spectrum analyzer is disabled.
 - type of window function for spectrum calculation
 - the length of the Fourier window for calculating the spectrum.

@@ Line 23: / Line 23: @@
 ===Audio trigger===
-Trigger is used to notify the application that the averaged absolute amplitude of the signal is above or below a specified threshold for a specified time.
+Trigger is used to notify the application that the averaged absolute amplitude of the signal is above or below a specified threshold for a specified time. The following notification options are available:<br>
 The following notification options are available:<br>
 - IMLAudioLevel::AdviseNotify(): calling IMLAudioLevelNotify::OnLevel() callback method;<br>
 - IMLAudioLevel::AdviseEvent(): calling the function SetEvent() with handle to the event created by the user using CreateEvent() system function.<br>
@@ Line 33: / Line 32: @@
 - data accumulation interval in ms. Notifications are not called if the signal leaves the specified level before the expiration of the time interval;<br>
 - threshold transition type: average absolute value of the signal above or below the threshold after the transition<br>
-The method returns a cookie used to identify the notification and cancel it using IMLAudioLevel::Unadvise().
+The method returns a cookie used to identify the notification and cancel it using IMLAudioLevel::Unadvise().<br>
 The trigger can be used to notify you when the silence is broken, or vice versa, when the sound stops.
-It can also be used to inform about any events through the specified channel of the audio stream.
+It can also be used to inform about any events through the specified channel of the audio stream.<br>
 <br>
 ===Delay correction===
 Audio filters (Audio Renderer, for example) can have large buffers for sound accumulation and, accordingly, large delays in audio output.
-To reduce the delay, the IMLAudioLevel::SetDelay() method is used, with the help of which the maximum advance of the audio stream relative to the current time is set.
+To reduce the delay, the IMLAudioLevel::SetDelay() method is used, with the help of which the maximum advance of the audio stream relative to the current time is set.<br>
-Data from the AudioLevel output pin will be sent to the downstream filter only after the difference between the audio output time (the output time of the first atomic audio sample from the DirectShow audio sample) and the current time from the Reference Clock becomes less than the delay time.
+Data from the AudioLevel output pin will be sent to the downstream filter only after the difference between the audio output time (the output time of the first atomic audio sample from the DirectShow audio sample) and the current time from the Reference Clock becomes less than the delay time. Thus, the advance of the sound will not exceed the set delay time.<br>
-Thus, the advance of the sound will not exceed the set delay time. A value of -1 disables delay correction. It is not recommended to set the delay value less than 200 ms - this can lead to breaks in audio playback.
+A value of -1 disables delay correction. It is not recommended to set the delay value less than 200 ms - this can lead to breaks in audio playback.<br>
 <br>
 ===Spectrum analyzer===

@@ Line 17: / Line 17: @@
 ===Dynamic range compression (auto gain)===
-Auto gain reduces the audio signal level if its average amplitude from its own VU meter exceeds a specified threshold.
+Auto gain reduces the audio signal level if its average amplitude from its own VU meter exceeds a specified threshold.<br>
 DRC parameters (threshold and gain) for an individual channel (or for all at once) are set using the IMLAudioLevel::SetAutoGain() method.
-Threshold and gain values are set in dB, the allowable range is [-120 db, 0 dB].
+Threshold and gain values are set in dB, the allowable range is [-120 db, 0 dB].<br>
-Auto gain part uses its own VU-meter to average the amplitude, its parameters (attack, release and transition times) are set using the IMLAudioLevel::SetAutoGainTimes() method.
+Auto gain part uses its own VU-meter to average the amplitude, its parameters (attack, release and transition times) are set using the IMLAudioLevel::SetAutoGainTimes() method.<br>
 <br>
 ===Audio trigger===

@@ Line 4: / Line 4: @@
 ===Number of channels===
 The number of channels in the connected audio stream can be obtained using the IMLAudioLevel::GetChannels() function.
-Maximum possible number of channels: 32.
+Maximum possible number of channels: 32.<br>
 <br>
 ===VU-meter===
@@ Line 11: / Line 10: @@
 VU-meter properties (attack and release time in ms) are set using methods IMLAudioLevel::SetAttackTime() and SetReleaseTime().
 The attack (rise) time is the time to reach an amplitude of 90% (-2dB) for a step signal of 0 -> 1, and the release (fall) time is an amplitude of 10% (-20dB) for a step signal of 1 -> 0.<br>
-If the VU-meter is not needed, then its operation can be disabled using the IMLAudioLevel::EnableProcessing() method.
+If the VU-meter is not needed, then its operation can be disabled using the IMLAudioLevel::EnableProcessing() method.<br>
 <br>
 ===Signal amplification===
-Signal gain (in dB) for a single channel (or for all at once) is set using IMLAudioLevel::SetGain() method. Gain range: -120 to 100 dB.
+Signal gain (in dB) for a single channel (or for all at once) is set using IMLAudioLevel::SetGain() method. Gain range: -120 to 100 dB.<br>
-A sudden change in gain can lead to distortion in the output signal. To reduce this effect, the transition time to the specified gain level is set in IMLAudioLevel::SetGain().
+A sudden change in gain can lead to distortion in the output signal. To reduce this effect, the transition time to the specified gain level is set in IMLAudioLevel::SetGain().<br>
 <br>
 ===Dynamic range compression (auto gain)===