SuperEQ

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m (one more touch-up)
(include .feq file on the page; formatting; more links)
Line 1: Line 1:
 +
__NOTOC__
 
{{Template:Func2Def|SuperEQ(clip, string filename)|SuperEQ(clip, float ''band1'' [, float ''band2'', ..., float ''band18''])}}
 
{{Template:Func2Def|SuperEQ(clip, string filename)|SuperEQ(clip, float ''band1'' [, float ''band2'', ..., float ''band18''])}}
  
Line 12: Line 13:
  
  
'''Shibatch Super Equalizer''' is a graphic equalizer, originally created as plugin for Winamp by [http://shibatch.sourceforge.net/ Naoki Shibata]. SuperEQ uses 16383th order FIR filter with FFT algorithm. Its equalization is very precise. Note that unlike traditional equalizers, there is very little [[wikipedia:Roll-off|roll-off]] or overlap between the bands; see the spectrum analysis images [[#spectrum-analysis|below]].
+
'''Shibatch Super Equalizer''' is a graphic equalizer, originally created as a plugin for Winamp by [http://shibatch.sourceforge.net/ Naoki Shibata]. SuperEQ uses 16383th order [http://en.wikipedia.org/wiki/Finite_impulse_response FIR] filters using [http://en.wikipedia.org/wiki/Fast_Fourier_transform FFT]. Its equalization is very precise. Note that unlike traditional equalizers, there is very little [http://en.wikipedia.org/wiki/Roll-off roll-off] or overlap between the bands.
  
The 18 '''SuperEQ''' bands cover the following frequency ranges:
+
 
 +
=====''Frequencies''=====
 +
The 18 bands cover the following frequency ranges:
 
{| border="1"  style="text-align:right"
 
{| border="1"  style="text-align:right"
 
!Band #!!''f'' (low)!!''f'' (high)
 
!Band #!!''f'' (low)!!''f'' (high)
Line 58: Line 61:
  
  
 +
=====''Preset Files''=====
 
SuperEQ can accept a [http://www.foobar2000.org foobar2k] equalizer '''Preset''' (.feq) file. Foobar's equalizer can be found in the [http://wiki.hydrogenaud.io/index.php?title=Foobar2000:Preferences:Playback:DSP_Manager DSPManager], and presets are adjusted and saved from there as well.
 
SuperEQ can accept a [http://www.foobar2000.org foobar2k] equalizer '''Preset''' (.feq) file. Foobar's equalizer can be found in the [http://wiki.hydrogenaud.io/index.php?title=Foobar2000:Preferences:Playback:DSP_Manager DSPManager], and presets are adjusted and saved from there as well.
  
 
An .feq file is a text file with a positive or negative integer on each line. No extra characters are allowed on the line.
 
An .feq file is a text file with a positive or negative integer on each line. No extra characters are allowed on the line.
Each value controls the amplification in [[wikipedia:Decibel|decibels]] over one frequency band. Preset files can be found in your \AviSynth25\Examples folder (Equalizer Presets.zip), or may be found by searching the Web for "foobar2000 presets."  
+
Each value controls the amplification in [http://en.wikipedia.org/wiki/Decibel decibels] over one frequency band. Preset files can be found in your \AviSynth25\Examples folder (Equalizer Presets.zip), or may be found by searching the Web for "foobar2000 presets."  
  
'''Example 1:''' ''Apply a Preset file ([[Loudness.feq|Loudness.feq]])''
+
'''Example 1:''' ''Apply a Preset file Loudness.feq)''
  
 
  SuperEq("C:\Equalizer Presets\Loudness.feq")
 
  SuperEq("C:\Equalizer Presets\Loudness.feq")
  
[[File:SuperEQ-loudness-624x534.png|206px]]
+
Contents of Loudness.feq:
 +
4
 +
4
 +
4
 +
2
 +
-2
 +
-2
 +
-2
 +
-2
 +
-2
 +
-2
 +
-2
 +
-4
 +
-10
 +
-7
 +
0
 +
3
 +
4
 +
4
 +
[http://audacityteam.org/ Audacity] spectrum analysis:
  
[http://audacityteam.org/ Audacity] spectrum analysis
+
:[[File:SuperEQ-loudness-624x534.png|206px]]
  
  
 +
=====''Band Gain Arguments''=====
 
From Avisynth version 2.60, '''band gain arguments''' allow all 18 bands to be set within your script, instead of requiring a preset file. The values are specified in decibels, as integer or floating point.
 
From Avisynth version 2.60, '''band gain arguments''' allow all 18 bands to be set within your script, instead of requiring a preset file. The values are specified in decibels, as integer or floating point.
  
Line 97: Line 121:
 
  \ )
 
  \ )
 
  ConvertAudioTo16bit
 
  ConvertAudioTo16bit
<div id="spectrum-analysis">[[File:SuperEQ-midboost-624x534.png|206px]]</div>
 
  
[http://audacityteam.org/ Audacity] spectrum analysis
+
[http://audacityteam.org/ Audacity] spectrum analysis:
 +
:[[File:SuperEQ-midboost-624x534.png|206px]]
  
  
'''Requirements:'''
+
=====''Requirements''=====
  
 
This plugin is optimized for processors which have cache equal to or greater than 128k bytes (16383*2*sizeof(float) = 128k). This plugin won't work efficiently with K6 series processors.
 
This plugin is optimized for processors which have cache equal to or greater than 128k bytes (16383*2*sizeof(float) = 128k). This plugin won't work efficiently with K6 series processors.

Revision as of 14:15, 1 September 2015

SuperEQ(clip, string filename)
SuperEQ(clip, float band1 [, float band2, ..., float band18])

Parameter:

filename The foobar2k equalizer preset file to apply.
band1-band18 Allows to set all bands within your script (in dB).


Shibatch Super Equalizer is a graphic equalizer, originally created as a plugin for Winamp by Naoki Shibata. SuperEQ uses 16383th order FIR filters using FFT. Its equalization is very precise. Note that unlike traditional equalizers, there is very little roll-off or overlap between the bands.


Frequencies

The 18 bands cover the following frequency ranges:

Band # f (low) f (high)
1 0 Hz 65 Hz
2 65 Hz 92 Hz
3 92 Hz 131 Hz
4 131 Hz 185 Hz
5 185 Hz 262 Hz
6 262 Hz 370 Hz
7 370 Hz 523 Hz
8 523 Hz 740 Hz
9 740 Hz 1046 Hz
10 1046 Hz 1480 Hz
11 1480 Hz 2093 Hz
12 2093 Hz 2960 Hz
13 2960 Hz 4186 Hz
14 4186 Hz 5920 Hz
15 5920 Hz 8372 Hz
16 8372 Hz 11839 Hz
17 11839 Hz 16744 Hz

(adapted from avisynth/src/audio/supereq.h)


Preset Files

SuperEQ can accept a foobar2k equalizer Preset (.feq) file. Foobar's equalizer can be found in the DSPManager, and presets are adjusted and saved from there as well.

An .feq file is a text file with a positive or negative integer on each line. No extra characters are allowed on the line. Each value controls the amplification in decibels over one frequency band. Preset files can be found in your \AviSynth25\Examples folder (Equalizer Presets.zip), or may be found by searching the Web for "foobar2000 presets."

Example 1: Apply a Preset file Loudness.feq)

SuperEq("C:\Equalizer Presets\Loudness.feq")

Contents of Loudness.feq:

4
4
4
2
-2
-2
-2
-2
-2
-2
-2
-4
-10
-7
0
3
4
4

Audacity spectrum analysis:

SuperEQ-loudness-624x534.png


Band Gain Arguments

From Avisynth version 2.60, band gain arguments allow all 18 bands to be set within your script, instead of requiring a preset file. The values are specified in decibels, as integer or floating point.

Example 2: Boost midrange (speech) using band arguments

ConvertAudioToFloat
SuperEQ(
\   0,  [*    65 *]
\   0,  [*    92 *]
\   0,  [*   131 *]
\   0,  [*   185 *]
\   0,  [*   262 *]
\   0,  [*   370 *]
\   0,  [*   523 *]
\   5,  [*   740 *]
\  10,  [*  1046 *]
\  10,  [*  1480 *]
\  10,  [*  2093 *]
\   5,  [*  2960 *]
\   0,  [*  4186 *]
\   0,  [*  5920 *]
\   0,  [*  8372 *]
\   0,  [* 11839 *]
\   0   [* 16744 *]
\ )
ConvertAudioTo16bit

Audacity spectrum analysis:

SuperEQ-midboost-624x534.png


Requirements

This plugin is optimized for processors which have cache equal to or greater than 128k bytes (16383*2*sizeof(float) = 128k). This plugin won't work efficiently with K6 series processors.

Changes:

v2.60 Added custom band setting to allow all 16 bands to be set from script.
v2.54 Initial Release.

Some parts of SuperEQ are:
Copyright © Naoki Shibata.

Other parts are:
Copyright © 2001-2003, Peter Pawlowski All rights reserved.

Personal tools