diff --git a/Release checklist.txt b/Release checklist.txt index 31753ea..9ef976b 100644 --- a/Release checklist.txt +++ b/Release checklist.txt @@ -1,8 +1,9 @@ 1. Change version number in version.h 2. Create setups using build.bat -3. Export trunk to an external folder, create EqualizerAPO-src-x.zip from the folder contents -4. Upload EqualizerAPO32-x.exe, EqualizerAPO64-x.exe and EqualizerAPO-src-x.zip to new folder x -5. Update readme.txt using subversion log -6. Set EqualizerAPO64-x.exe as new default download -7. Update URL for tool "Downloads" to https://sourceforge.net/projects/equalizerapo/files/x/ -7. Create tag of trunk in tags/x \ No newline at end of file +3. Commit trunk with message "Version x" +4. Export trunk to an external folder, create EqualizerAPO-src-x.zip from the folder contents +5. Upload EqualizerAPO32-x.exe, EqualizerAPO64-x.exe and EqualizerAPO-src-x.zip to new folder x +6. Update readme.txt using subversion log +7. Set EqualizerAPO64-x.exe as new default download +8. Update URL for tool "Downloads" to https://sourceforge.net/projects/equalizerapo/files/x/ +9. Create tag of trunk in tags/x with message "Tag release x" diff --git a/Wiki/Configuration reference.txt b/Wiki/Configuration reference.txt index 7455941..976a6bd 100644 --- a/Wiki/Configuration reference.txt +++ b/Wiki/Configuration reference.txt @@ -73,8 +73,8 @@ PK
Modal
PEQ | Peaking filter
(Parametric EQ) | X | X | X | ON PK LP
LPQ | Low-pass filter | X | | O | ON LP Fc 8000 Hz
ON LPQ Fc 10000 Hz Q 0.400 HP
HPQ | High-pass filter | X | | O | ON HP Fc 30.0 Hz
ON HPQ Fc 20.0 Hz Q 0.500 BP | Band-pass filter
(not from DCX2496) | X | | O | ON BP Fc 1000 Hz Q 0.100 -LS
LSC x dB | Low-shelf filter
(with center freq.,
x dB per oct. (LSC)) | X | X | | ON LS Fc 300 Hz Gain 5.0 dB
ON LSC 10.8 dB Fc 300 Hz Gain 5.0 dB -HS
HSC x dB | High-shelf filter
(with center freq.,
x dB per oct. (HSC)) | X | X | | ON HS Fc 1000 Hz Gain -3.0 dB
ON HSC 6 dB Fc 100 Hz Gain -6.0 dB +LS
LSC x dB | Low-shelf filter
(with center freq.,
x dB per oct. (LSC)) | X | X | O
(1.2.1) | ON LS Fc 300 Hz Gain 5.0 dB
ON LSC 10.8 dB Fc 300 Hz Gain 5.0 dB
ON LSC Fc 300 Hz Gain 5.0 dB Q 0.6473 +HS
HSC x dB | High-shelf filter
(with center freq.,
x dB per oct. (HSC)) | X | X | O
(1.2.1) | ON HS Fc 1000 Hz Gain -3.0 dB
ON HSC 6 dB Fc 100 Hz Gain -6.0 dB
ON HSC Fc 100 Hz Gain -6.0 dB Q 0.4272 LS 6dB
LS 12dB | Low-shelf filter
(6 / 12 dB per octave
with corner freq.) | X | X | | ON LS 6dB Fc 50.0 Hz Gain 7.2 dB
ON LS 12dB Fc 2000 Hz Gain -5.0 dB HS 6dB
HS 12dB | High-shelf filter
(6 / 12 dB per octave
with corner freq.) | X | X | | ON HS 6dB Fc 12000 Hz Gain 10.0 dB
ON HS 12dB Fc 500 Hz Gain 5.0 dB NO | Notch filter | X | | O | ON NO Fc 800 Hz @@ -142,10 +142,10 @@ Replaces the audio on the target channel by the sum of the given source channels # Attention: Sets the audio on channel L to the audio on the second channel # (not to constant value 2, because no decimal point is present) Copy: L=2 - # Real world example: Replaces the audio on the subwoofer channel with + # Real world example: Replaces the audio on the LFE channel with # the audio on the left channel while muting all other channels of a 5.1 speaker system # (useful for measuring the subwoofer response in REW) - Copy: SUB=L L=0.0 R=0.0 C=0.0 RL=0.0 RR=0.0 + Copy: LFE=L L=0.0 R=0.0 C=0.0 RL=0.0 RR=0.0
## GraphicEQ (since version 1.0) @@ -219,7 +219,7 @@ Selects the channels to which the following Filter and Preamp commands will be a **Channel configurations:** The following table lists the channel configurations that are supported by Equalizer APO. The channel identifiers in the column titles resemble the channels in Start -> Control Panel -> Sound -> Configure. If a channel position is supported for a configuration, the cell in the corresponding row contains the channel number. -Configuration | Left
L | Right
R | Center
C | Subwoofer
SUB | Rear left
RL | Rear right
RR | Rear center
RC | Side left
SL | Side right
SR +Configuration | Left
L | Right
R | Center
C | Subwoofer
LFE | Rear left
RL | Rear right
RR | Rear center
RC | Side left
SL | Side right
SR - | - | - | - | - | - | - | - | - | - Mono | | | 1 | | | | | | Stereo | 1 | 2 | | | | | | | @@ -233,7 +233,7 @@ Surround | 1 | 2 | 3 | | | | 4 | | Attention:
-Although it might be tempting to assign low frequency filters only to the subwoofer channel, this might not lead to the expected results. Many audio systems apply bass redirection after Equalizer APO has processed the signal, so filters applied to the subwoofer channel won't be effective for redirected sound. Furthermore, as crossover filters only gradually fade in, the low frequency audio might be played over multiple speakers, not just the subwoofer, reducing the effectivity of subwoofer-only filters. Therefore, to avoid these problems, it's recommended to apply low frequency filters to all channels. +Although it might be tempting to assign low frequency filters only to the LFE channel, this might not lead to the expected results. Many audio systems apply bass redirection after Equalizer APO has processed the signal, so filters applied to the LFE channel won't be effective for redirected sound. Furthermore, as crossover filters only gradually fade in, the low frequency audio might be played over multiple speakers, not just the subwoofer, reducing the effectivity of LFE-only filters. Therefore, to avoid these problems, it's recommended to apply low frequency filters to all channels.
**Example:** diff --git a/Wiki/Developer.txt b/Wiki/Developer.txt index 6bd7cd3..ad28b0b 100644 --- a/Wiki/Developer.txt +++ b/Wiki/Developer.txt @@ -19,16 +19,18 @@ It is neither complete nor guaranteed to be free of errors. ## Compilation prerequisites The following software has been successfully used to compile Equalizer APO. -1. [Visual Studio Community 2013](https://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx). Visual Studio 2015 is not used to compile Equalizer APO because it introduces changes to the C runtime library that make simple redistribution by bundling the DLLs much harder. The newer versions of Visual Studio already include the Windows Kit 8.1 or 10, so the installation of the WDK is no longer necessary. +1. [Visual Studio Community 2013](https://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx). Visual Studio 2015 or newer is not used to compile Equalizer APO because it introduces changes to the C runtime library that make simple redistribution by bundling the DLLs much harder. The newer versions of Visual Studio already include the Windows Kit 8.1 or 10, so the installation of the WDK is no longer necessary. 2. [libsndfile](http://www.mega-nerd.com/libsndfile/). There are installers for the 64 and 32 bit version, so no need to compile from source. Has to be installed to C:\Program Files\libsndfile and C:\Program Files (x86)\libsndfile, respectively. 3. [FFTW](http://www.fftw.org/install/windows.html). The prebuilt 64/32 bit archives have to be extracted to C:\Program Files\fftw3 and C:\Program Files (x86)\fftw3, respectively. As mentioned on the linked page, the import libraries have to be created using the lib program of Visual Studio. -4. [muParserX 3.0.1](https://code.google.com/p/muparserx/). Unfortunately, there are no prebuilt files, so compilation from source is needed. The source code has to be compiled to a static library muparserx.lib (muparserxd.lib for debug build) and the include and library path has to be added via a [user property page](http://social.msdn.microsoft.com/Forums/vstudio/en-US/a494abb8-3561-4ebe-9eb0-6f644a679862/visual-studio-2010-professional-how-to-add-include-directory-for-all-projects?forum=vcgeneral#7b5ab5f2-f793-4b0e-a18a-679948d12bdd). Please note that the version has to be 3.0.1 as an important feature was removed in 3.0.2 (semicolon). As version 3.0.1 is no longer available, it is now [attached](Developer%20documentation/attachment/muparserx_v3_0_1.zip) to this page including prebuilt static library files for MSVC2013. The zip file has to be extracted to C:\\Program Files. + +4. [muParserX 3.0.1](https://code.google.com/p/muparserx/). Unfortunately, there are no prebuilt files, so compilation from source is needed. Please note that the version has to be 3.0.1 as an important feature was removed in 3.0.2 (semicolon). As version 3.0.1 is no longer available, it is now [attached](Developer%20documentation/attachment/muparserx_v3_0_1.zip) to this page including prebuilt static library files for MSVC2013. The zip file has to be extracted to C:\\Program Files. 5. [TCLAP](http://tclap.sourceforge.net/). As this is a template library, only the source is needed, which will be compiled into the application. The downloaded tar.gz file has to be extracted to C:\\Program Files. This library only used in the Benchmark application. 6. [Qt](http://www.qt.io/download-open-source/). The current 32 and 64 bit versions for MSVC2013 should be installed to C:\\Qt. Qt Creator is used instead of Visual Studio as IDE. The prebuilt versions can be used for development although Equalizer APO ships with custom-built variants with reduced dependencies. Currently only needed to build the Configuration Editor. + 7. [NSIS](http://nsis.sourceforge.net/). Needed to create the installer. Additionaly, the plugins [NSISpcre](http://nsis.sourceforge.net/NSISpcre_plug-in) and [AccessControl](http://nsis.sourceforge.net/AccessControl_plug-in) are needed. ## Source code organization diff --git a/Wiki/Documentation.txt b/Wiki/Documentation.txt index 52c3c49..2ca9ad1 100644 --- a/Wiki/Documentation.txt +++ b/Wiki/Documentation.txt @@ -43,6 +43,18 @@ This information has been moved to the [configuration reference](https://sourcef This section describes approaches to solve possible problems impeding the successful operation of Equalizer APO. +## Configurator +By default, Equalizer APO will try to keep the functionality of other APOs that have been shipped with the sound card driver ("original APOs"). In some cases, this causes instabilities in the audio processing. The Configurator offers troubleshooting options to adjust how the original APOs are used. + +If you experience instabilities during playback or recording when using Equalizer APO, you can try to disable the usage of the original APOs in the Configurator: +1. Select your audio device by clicking on its connection name. +2. Enable the troubleshooting options. +3. Uncheck both "Use original APO" checkboxes. + (click to enlarge) +Note that you will lose all features that the sound card driver realizes through its APOs. You can also try to uncheck only one of the check boxes to preserve some functionality. + +Some sound card drivers disable options when they detect that another APO has been registered. You can uncheck one of the "Install APO" checkboxes to only install Equalizer APO in the pre-mix or post-mix stage. For the other stage, the original APO will be registered then, which may help to recover some options of the sound card driver. + ## Control Panel If you installed Equalizer APO and no changes to the configuration file lead to any changes in the signal, APOs might have been disabled for the device in the Control Panel. To check this, open Start Menu -> Control Panel -> Sound and double click on your audio device to open the properties dialog. diff --git a/Wiki/UseOriginalAPO.png b/Wiki/UseOriginalAPO.png new file mode 100644 index 0000000..2e20666 Binary files /dev/null and b/Wiki/UseOriginalAPO.png differ diff --git a/Wiki/UseOriginalAPO.xcf b/Wiki/UseOriginalAPO.xcf new file mode 100644 index 0000000..300d856 Binary files /dev/null and b/Wiki/UseOriginalAPO.xcf differ diff --git a/version.h b/version.h index ddbd0ff..c4c2479 100644 --- a/version.h +++ b/version.h @@ -1,3 +1,3 @@ #define MAJOR 1 #define MINOR 2 -#define REVISION 0 +#define REVISION 1