diff --git a/doc/TODO b/doc/TODO index 966e3d6e..8589750a 100644 --- a/doc/TODO +++ b/doc/TODO @@ -2,8 +2,6 @@ o [mzuther] document code o [mzuther] add const to methods -* reset standalone by deleting .ini file - * horizontal meter * implement inter-sample peak meter (ITU BS.1770-1, Annex 2) diff --git a/doc/include/images/button_about_off.png b/doc/include/images/button_about_off.png index d743a1e5..5f46d8d3 100644 Binary files a/doc/include/images/button_about_off.png and b/doc/include/images/button_about_off.png differ diff --git a/doc/include/images/button_about_on.png b/doc/include/images/button_about_on.png index 53ae1cde..f4d5c838 100644 Binary files a/doc/include/images/button_about_on.png and b/doc/include/images/button_about_on.png differ diff --git a/doc/include/images/button_averaging_selection.png b/doc/include/images/button_averaging_selection.png index 1a403863..9634df06 100644 Binary files a/doc/include/images/button_averaging_selection.png and b/doc/include/images/button_averaging_selection.png differ diff --git a/doc/include/images/button_expand_meter_off.png b/doc/include/images/button_expand_meter_off.png index a71cdbe4..96d09e61 100644 Binary files a/doc/include/images/button_expand_meter_off.png and b/doc/include/images/button_expand_meter_off.png differ diff --git a/doc/include/images/button_expand_meter_on.png b/doc/include/images/button_expand_meter_on.png index 4ed9cb84..4d505e68 100644 Binary files a/doc/include/images/button_expand_meter_on.png and b/doc/include/images/button_expand_meter_on.png differ diff --git a/doc/include/images/button_gpl_off.png b/doc/include/images/button_gpl_off.png index 4d669b36..4fe84bab 100644 Binary files a/doc/include/images/button_gpl_off.png and b/doc/include/images/button_gpl_off.png differ diff --git a/doc/include/images/button_gpl_on.png b/doc/include/images/button_gpl_on.png index ed1afe32..cbd63364 100644 Binary files a/doc/include/images/button_gpl_on.png and b/doc/include/images/button_gpl_on.png differ diff --git a/doc/include/images/button_meter_selection.png b/doc/include/images/button_meter_selection.png index 506d43be..04f6f615 100644 Binary files a/doc/include/images/button_meter_selection.png and b/doc/include/images/button_meter_selection.png differ diff --git a/doc/include/images/button_mono_off.png b/doc/include/images/button_mono_off.png index 3bc6bc93..8643d206 100644 Binary files a/doc/include/images/button_mono_off.png and b/doc/include/images/button_mono_off.png differ diff --git a/doc/include/images/button_mono_on.png b/doc/include/images/button_mono_on.png index 5bfb2e8e..ec3f6a0c 100644 Binary files a/doc/include/images/button_mono_on.png and b/doc/include/images/button_mono_on.png differ diff --git a/doc/include/images/button_peak_hold_off.png b/doc/include/images/button_peak_hold_off.png index 787cbcaa..74422bec 100644 Binary files a/doc/include/images/button_peak_hold_off.png and b/doc/include/images/button_peak_hold_off.png differ diff --git a/doc/include/images/button_peak_hold_on.png b/doc/include/images/button_peak_hold_on.png index e1593a5c..e1e0297a 100644 Binary files a/doc/include/images/button_peak_hold_on.png and b/doc/include/images/button_peak_hold_on.png differ diff --git a/doc/include/images/button_peak_meter_off.png b/doc/include/images/button_peak_meter_off.png index 55eacb9c..dc284d3a 100644 Binary files a/doc/include/images/button_peak_meter_off.png and b/doc/include/images/button_peak_meter_off.png differ diff --git a/doc/include/images/button_peak_meter_on.png b/doc/include/images/button_peak_meter_on.png index e2d9b167..14f4ca00 100644 Binary files a/doc/include/images/button_peak_meter_on.png and b/doc/include/images/button_peak_meter_on.png differ diff --git a/doc/include/images/button_reset.png b/doc/include/images/button_reset.png deleted file mode 100644 index a73a0c96..00000000 Binary files a/doc/include/images/button_reset.png and /dev/null differ diff --git a/doc/include/images/button_reset_off.png b/doc/include/images/button_reset_off.png new file mode 100644 index 00000000..6c9af5be Binary files /dev/null and b/doc/include/images/button_reset_off.png differ diff --git a/doc/include/images/button_reset_on.png b/doc/include/images/button_reset_on.png new file mode 100644 index 00000000..ca9a6a41 Binary files /dev/null and b/doc/include/images/button_reset_on.png differ diff --git a/doc/include/images/button_skin_off.png b/doc/include/images/button_skin_off.png new file mode 100644 index 00000000..8a999f68 Binary files /dev/null and b/doc/include/images/button_skin_off.png differ diff --git a/doc/include/images/button_skin_on.png b/doc/include/images/button_skin_on.png new file mode 100644 index 00000000..eb2705bd Binary files /dev/null and b/doc/include/images/button_skin_on.png differ diff --git a/doc/include/images/button_validate_off.png b/doc/include/images/button_validate_off.png index e6d436fd..833c0b63 100644 Binary files a/doc/include/images/button_validate_off.png and b/doc/include/images/button_validate_off.png differ diff --git a/doc/include/images/button_validate_on.png b/doc/include/images/button_validate_on.png index 75efe968..64a8b68f 100644 Binary files a/doc/include/images/button_validate_on.png and b/doc/include/images/button_validate_on.png differ diff --git a/doc/include/images/dialog_validation.png b/doc/include/images/dialog_validation.png index 086e5ec8..e3ae18f4 100644 Binary files a/doc/include/images/dialog_validation.png and b/doc/include/images/dialog_validation.png differ diff --git a/doc/include/images/fft_192khz-freq-fx_path.png b/doc/include/images/fft_192khz-freq-fx_path.png index a1885a41..9bd7030f 100644 Binary files a/doc/include/images/fft_192khz-freq-fx_path.png and b/doc/include/images/fft_192khz-freq-fx_path.png differ diff --git a/doc/include/images/fft_192khz-freq-itu_r.png b/doc/include/images/fft_192khz-freq-itu_r.png index 05111a85..a94232e1 100644 Binary files a/doc/include/images/fft_192khz-freq-itu_r.png and b/doc/include/images/fft_192khz-freq-itu_r.png differ diff --git a/doc/include/images/fft_192khz-freq-rms.png b/doc/include/images/fft_192khz-freq-rms.png index c8b3b867..c18adbe5 100644 Binary files a/doc/include/images/fft_192khz-freq-rms.png and b/doc/include/images/fft_192khz-freq-rms.png differ diff --git a/doc/include/images/fft_192khz-freq_zoomed-itu_r.png b/doc/include/images/fft_192khz-freq_zoomed-itu_r.png index 5624a657..a523ed34 100644 Binary files a/doc/include/images/fft_192khz-freq_zoomed-itu_r.png and b/doc/include/images/fft_192khz-freq_zoomed-itu_r.png differ diff --git a/doc/include/images/fft_192khz-freq_zoomed-rms.png b/doc/include/images/fft_192khz-freq_zoomed-rms.png index 3d3a3b32..de1d3ac1 100644 Binary files a/doc/include/images/fft_192khz-freq_zoomed-rms.png and b/doc/include/images/fft_192khz-freq_zoomed-rms.png differ diff --git a/doc/include/images/fft_192khz-phase-fx_path.png b/doc/include/images/fft_192khz-phase-fx_path.png index c7092fb0..aced4e0f 100644 Binary files a/doc/include/images/fft_192khz-phase-fx_path.png and b/doc/include/images/fft_192khz-phase-fx_path.png differ diff --git a/doc/include/images/fft_192khz-phase-itu_r.png b/doc/include/images/fft_192khz-phase-itu_r.png index 6982a860..55d90942 100644 Binary files a/doc/include/images/fft_192khz-phase-itu_r.png and b/doc/include/images/fft_192khz-phase-itu_r.png differ diff --git a/doc/include/images/fft_192khz-phase-rms.png b/doc/include/images/fft_192khz-phase-rms.png index 5381e91a..4615fe01 100644 Binary files a/doc/include/images/fft_192khz-phase-rms.png and b/doc/include/images/fft_192khz-phase-rms.png differ diff --git a/doc/include/images/kmeter.png b/doc/include/images/kmeter.png index cbdc39d8..7ab210dc 100644 Binary files a/doc/include/images/kmeter.png and b/doc/include/images/kmeter.png differ diff --git a/doc/include/images/kmeter_normal_scale.png b/doc/include/images/kmeter_normal_scale.png index 62d80863..e8cd34e4 100644 Binary files a/doc/include/images/kmeter_normal_scale.png and b/doc/include/images/kmeter_normal_scale.png differ diff --git a/doc/include/images/level_meter_combined.png b/doc/include/images/level_meter_combined.png index 6dae92ac..b7d3ec86 100644 Binary files a/doc/include/images/level_meter_combined.png and b/doc/include/images/level_meter_combined.png differ diff --git a/doc/include/images/maximum_peak_clipped.png b/doc/include/images/maximum_peak_clipped.png index bb91e482..ff0e0b22 100644 Binary files a/doc/include/images/maximum_peak_clipped.png and b/doc/include/images/maximum_peak_clipped.png differ diff --git a/doc/include/images/maximum_peak_normal.png b/doc/include/images/maximum_peak_normal.png index 6639af98..ee17c48c 100644 Binary files a/doc/include/images/maximum_peak_normal.png and b/doc/include/images/maximum_peak_normal.png differ diff --git a/doc/include/images/overload_counter_clipped.png b/doc/include/images/overload_counter_clipped.png index 95f723b7..5f0b4f13 100644 Binary files a/doc/include/images/overload_counter_clipped.png and b/doc/include/images/overload_counter_clipped.png differ diff --git a/doc/include/images/overload_counter_normal.png b/doc/include/images/overload_counter_normal.png index 8c269c53..cf4f4b1a 100644 Binary files a/doc/include/images/overload_counter_normal.png and b/doc/include/images/overload_counter_normal.png differ diff --git a/doc/include/images/phase_correlation_meter.png b/doc/include/images/phase_correlation_meter.png index 8428029d..20e3ae77 100644 Binary files a/doc/include/images/phase_correlation_meter.png and b/doc/include/images/phase_correlation_meter.png differ diff --git a/doc/include/images/stereo_meter.png b/doc/include/images/stereo_meter.png index 1bf5ea48..ef354105 100644 Binary files a/doc/include/images/stereo_meter.png and b/doc/include/images/stereo_meter.png differ diff --git a/doc/kmeter.pdf b/doc/kmeter.pdf index ff810710..604cb6f2 100644 Binary files a/doc/kmeter.pdf and b/doc/kmeter.pdf differ diff --git a/doc/kmeter.tex b/doc/kmeter.tex index adf46bdf..1666f41d 100644 --- a/doc/kmeter.tex +++ b/doc/kmeter.tex @@ -97,24 +97,29 @@ \chapter{The K-System} \chapter{Installation} \label{chap:installation} -In order to use the pre-compiled binaries, simply extract the -\textbf{K-Meter} files from the downloaded archive. For the plug-ins, -you'll then have to move the extracted files to your respective -plug-in folder (\path{~/.lv2}, \path{~/.vst}, -\path{C:\Program Files\Steinberg\VstPlugins\} or the like). +In order to use the pre-compiled binaries, simply extract the K-Meter +files from the downloaded archive. For the plug-ins, you'll then have +to move the extracted files to your respective plug-in folder +(\path{~/.lv2}, \path{~/.vst}, \path{C:\Program + Files\Steinberg\VstPlugins\} or the like). Loading K-Meter may take a few seconds: it checks your computer's capabilities on start-up so that FFT calculations will run at maximum speed. Depending on your computer, this little wait in the beginning may well result in lower resource usage later. +Should the standalone version ever fail to start, you can reset its +settings by deleting the file \path{kmeter_stereo.ini} or +\path{kmeter_surround.ini}. These files are located in +\path{~/.config} (GNU/Linux) or \path{%appdata%\.config\} (Windows). + \chapter{Controls} \label{chap:controls} \section{Meter selection} \begin{wrapfigure}{r}{0pt} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_meter_selection.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_meter_selection.png} \end{wrapfigure} You can select the different K-System meter scales (\textbf{K-20}, @@ -124,7 +129,7 @@ \section{Meter selection} on top of the meter's scale. \begin{wrapfigure}{r}{0pt} - \includegraphics[scale=0.49,clip]{include/images/kmeter_normal_scale.png} +\includegraphics[scale=0.60,clip]{include/images/kmeter_normal_scale.png} \end{wrapfigure} With its \emph{two} green areas, the \textbf{Normal} meter also looks @@ -141,7 +146,7 @@ \section{Meter selection} \section{Averaging method} \begin{wrapfigure}{r}{0pt} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_averaging_selection.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_averaging_selection.png} \end{wrapfigure} The average level meters can either read unweighted levels @@ -155,7 +160,7 @@ \section{Averaging method} loudness-weighted \textbf{ITU-R} method should be used for channel-summed loudness metering. To reference a meter, state both K-System meter scale and averaging method, separated by a slash, such -as ``K-20/ITU''. +as ``K-20/ITU-R''. \emph{\underline{Note:} K-Meter fully implements Annex 1 of the now superseded ITU-R BS.1770-1 standard ('K' frequency weighting, mean @@ -166,9 +171,9 @@ \section{Averaging method} \section{Infinite peak hold} \begin{wrapfigure}{r}{0.14\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_peak_hold_on.png} - \newline \vspace{-0.9\baselineskip} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_peak_hold_off.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_peak_hold_on.png} +\newline \vspace{-0.9\baselineskip} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_peak_hold_off.png} \end{wrapfigure} Click on this button to toggle between infinite peak hold and @@ -178,9 +183,9 @@ \section{Infinite peak hold} \section{Show peak level meter} \begin{wrapfigure}{r}{0.14\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_peak_meter_on.png} - \newline \vspace{-0.9\baselineskip} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_peak_meter_off.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_peak_meter_on.png} +\newline \vspace{-0.9\baselineskip} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_peak_meter_off.png} \end{wrapfigure} Click on this button to toggle display of the peak level meters. The @@ -198,9 +203,9 @@ \section{Show peak level meter} \section{Magnify meters} \begin{wrapfigure}{r}{0.14\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_expand_meter_on.png} - \newline \vspace{-0.9\baselineskip} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_expand_meter_off.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_expand_meter_on.png} +\newline \vspace{-0.9\baselineskip} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_expand_meter_off.png} \end{wrapfigure} This button magnifies both average and peak level meters to @@ -216,47 +221,60 @@ \section{Magnify meters} \section{Mono mode} \begin{wrapfigure}{r}{0.14\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_mono_on.png} - \newline \vspace{-0.9\baselineskip} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_mono_off.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_mono_on.png} +\newline \vspace{-0.9\baselineskip} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_mono_off.png} \end{wrapfigure} Click this button to easily check the mono compatibility of your stereo mix or master. In \textbf{mono} mode, audio channels will be down-mixed to mono and the meters will be linked. -In case you insert the plug-in into a mono channel strip, -\textbf{mono} mode will be selected and cannot be toggled. +If you insert the stereo plug-in into a mono channel strip, +\textbf{mono} mode will be selected and cannot be toggled. In the +surround version, the \textbf{mono} button is disabled. \section{Reset button} \begin{wrapfigure}{r}{0.14\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_reset.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_reset_on.png} +\newline \vspace{-0.9\baselineskip} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_reset_off.png} \end{wrapfigure} Click on this button to reset all meters, peaks and counters. You can also use it to get rid of graphical artifacts, because all meters will be redrawn as well. +\section{Select a skin} + +\begin{wrapfigure}{r}{0.14\linewidth} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_skin_on.png} +\newline \vspace{-0.9\baselineskip} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_skin_off.png} +\end{wrapfigure} + +Click on this button to select the currently used K-Meter skin. You +can also set a default skin that will be loaded when new plug-ins are +instantiated. + \section{Validation button} \label{sec:validation_button} \begin{wrapfigure}{r}{0.14\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_validate_on.png} - \newline \vspace{-0.9\baselineskip} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_validate_off.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_validate_on.png} +\newline \vspace{-0.9\baselineskip} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_validate_off.png} \end{wrapfigure} Click on this button to open the \textbf{validation window} (see -\ref{chap:validation}) which allows you to play an audio file (WAV, -AIFF or FLAC) through K-Meter and dump internal data. During -validation, the button will light up and clicking it will stop -validation early. +\ref{chap:validation}) which allows you to play an audio file through +K-Meter and dump internal data. During validation, the button will +light up and clicking it will stop validation early. \emph{Unfortunately, the underlying JUCE library does not seem to support multi-channel audio files. You may load such audio files - into your DAW of choice and insert \textbf{K-meter} as a plug-in - instance.} + into your DAW of choice and use a K-Meter plug-in.} On Linux, dumped data will be written to \path{stderr}, so just start the K-Meter standalone or your VST host from the shell and watch the @@ -272,9 +290,9 @@ \section{Validation button} \section{About button} \begin{wrapfigure}{r}{0.14\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_about_on.png} - \newline \vspace{-0.9\baselineskip} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_about_off.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_about_on.png} +\newline \vspace{-0.9\baselineskip} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_about_off.png} \end{wrapfigure} Clicking on this button will open the \textbf{about window} where you @@ -284,9 +302,9 @@ \section{About button} \section{Display license} \begin{wrapfigure}{r}{0.15\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_gpl_on.png} - \newline \vspace{-0.9\baselineskip} - \includegraphics[scale=\screenshotscale,clip]{include/images/button_gpl_off.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_gpl_on.png} +\newline \vspace{-0.9\baselineskip} +\includegraphics[scale=\screenshotscale,clip]{include/images/button_gpl_off.png} \end{wrapfigure} This button is located in the \textbf{about window} and does not only @@ -303,8 +321,8 @@ \chapter{Meters} \section{K-System meter} -\begin{wrapfigure}{r}{0.14\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/level_meter_combined.png} +\begin{wrapfigure}{r}{0.20\linewidth} +\includegraphics[scale=0.6,clip]{include/images/level_meter_combined.png} \end{wrapfigure} The K-System meter consists of an average level meter (graphic on the @@ -359,8 +377,8 @@ \section{Average level meter} \emph{Thus, in ITU-R mode sine waves do \emph{not} read the same on average and peak level meters. Moreover, pink noise (\SI{-20}{\dBFS}\,RMS, \SI{20}{\hertz} to \SI{20}{\kilo\hertz}) does - \emph{not} read \SI{0}{\dB} on the K-20 average level meter. So for - calibration, please switch K-Meter to RMS mode.} + \emph{not} read \SI{0}{\dB} on the K-20 average level meter. + \textbf{So for calibration, please switch K-Meter to RMS mode!}} \section{Peak level meter} @@ -371,9 +389,9 @@ \section{Peak level meter} \section{Overload counter} \begin{wrapfigure}{r}{0.23\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/overload_counter_normal.png} - \newline \vspace{-0.9\baselineskip} - \includegraphics[scale=\screenshotscale,clip]{include/images/overload_counter_clipped.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/overload_counter_normal.png} +\newline +\includegraphics[scale=\screenshotscale,clip]{include/images/overload_counter_clipped.png} \end{wrapfigure} The overload counter displays the number of samples that have reached @@ -389,9 +407,9 @@ \section{Overload counter} \section{Maximum peak display} \begin{wrapfigure}{r}{0.23\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/maximum_peak_normal.png} - \newline \vspace{-0.9\baselineskip} - \includegraphics[scale=\screenshotscale,clip]{include/images/maximum_peak_clipped.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/maximum_peak_normal.png} +\newline +\includegraphics[scale=\screenshotscale,clip]{include/images/maximum_peak_clipped.png} \end{wrapfigure} This meter displays the maximum peak level encountered so far in @@ -404,7 +422,7 @@ \section{Maximum peak display} \section{Phase correlation meter} \begin{wrapfigure}{r}{0pt} - \includegraphics[scale=\screenshotscale,clip]{include/images/phase_correlation_meter.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/phase_correlation_meter.png} \end{wrapfigure} This meter only works for stereo channels and displays the cross @@ -427,7 +445,7 @@ \section{Phase correlation meter} \section{Stereo meter} \begin{wrapfigure}{r}{0pt} - \includegraphics[scale=\screenshotscale,clip]{include/images/stereo_meter.png} +\includegraphics[scale=\screenshotscale,clip]{include/images/stereo_meter.png} \end{wrapfigure} The stereo meter obviously only works for stereo channels and displays @@ -437,7 +455,7 @@ \section{Stereo meter} But please don't get the false notion that the needle should stay in the middle all the time in order to achieve a good mix. Quite the -contrary! As I said, you should not mix by your eyes \dots +contrary! As I said before, you should not mix by your eyes \dots \chapter{Validation} \label{chap:validation} @@ -452,12 +470,12 @@ \chapter{Validation} \textbf{damage your ears} and speakers, so please watch your monitor levels! -Begin by starting \textbf{K-Meter}. If in a Bash shell, try this: +Begin by starting K-Meter. If in a Bash shell, try this: \path{./kmeter_stereo 2>&1 | tee /tmp/validation.log} -\begin{wrapfigure}{r}{0.395\linewidth} - \includegraphics[scale=\screenshotscale,clip]{include/images/dialog_validation.png} +\begin{wrapfigure}{r}{0.32\linewidth} +\includegraphics[scale=0.60,clip]{include/images/dialog_validation.png} \end{wrapfigure} After opening the \textbf{validation window} (see @@ -481,6 +499,8 @@ \chapter{Validation} button. Please ensure that all intermediate software and hardware mixers are set to the correct levels. +\newpage %% layout + \section{Validation status} \begin{minipage}{1.0\linewidth} @@ -550,37 +570,37 @@ \section{Validation status} \end{tabular} \end{minipage} -\newpage %% layout - \section{Frequency and phase response} -Frequency and phase response have been determined at a sample rate of -\SI{192}{\kilo\hertz} using -\href{http://www.savioursofsoul.de/Christian/programs/measurement-programs/}{VST - Plugin Analyser}. +Frequency and phase response have been determined using Christan +Budde's fantastic +\href{http://www.pcjv.de/applications/measurement-programs/}{VST + Plugin Analyser} with a sample rate of \SI{192}{\kilo\hertz} and a +log sine sweep as input signal (set using Ctrl-Shift-F). + +\newpage %% layout \textbf{Frequency response of complete effect path (\SI{5}{\hertz} to \SI{96}{\kilo\hertz}, \SI{0}{\dB} \SI{\pm 0.1}{\dB}):} \begin{center} - \includegraphics[scale=0.65,clip]{include/images/fft_192khz-freq-fx_path.png} + \includegraphics[scale=0.60,clip]{include/images/fft_192khz-freq-fx_path.png} \end{center} \textbf{Phase response of complete effect path (\SI{5}{\hertz} to \SI{96}{\kilo\hertz}, \SI{0}{\degree}\,\SI{\pm 0.1}{\degree}):} \begin{center} - \includegraphics[scale=0.65,clip]{include/images/fft_192khz-phase-fx_path.png} -\end{center} -\newpage %% layout +\includegraphics[scale=0.60,clip]{include/images/fft_192khz-phase-fx_path.png} +\end{center} \textbf{Frequency response of band-limited RMS detection stage (\SI{5}{\hertz} to \SI{96}{\kilo\hertz}, \SI{-140}{\dB} to \SI{5}{\dB}):} \begin{center} - \includegraphics[scale=0.65,clip]{include/images/fft_192khz-freq-rms.png} + \includegraphics[scale=0.60,clip]{include/images/fft_192khz-freq-rms.png} \end{center} \textbf{Phase response of band-limited RMS detection stage @@ -588,7 +608,7 @@ \section{Frequency and phase response} \SI[addsign]{+180}{\degree}):} \begin{center} - \includegraphics[scale=0.65,clip]{include/images/fft_192khz-phase-rms.png} + \includegraphics[scale=0.60,clip]{include/images/fft_192khz-phase-rms.png} \end{center} \newpage %% layout @@ -597,7 +617,7 @@ \section{Frequency and phase response} \SI{5}{\dB}):} \begin{center} - \includegraphics[scale=0.65,clip]{include/images/fft_192khz-freq-itu_r.png} + \includegraphics[scale=0.60,clip]{include/images/fft_192khz-freq-itu_r.png} \end{center} \textbf{Phase response of band-limited ITU-R BS.1770-1 detection stage @@ -605,32 +625,32 @@ \section{Frequency and phase response} \SI[addsign]{+180}{\degree}):} \begin{center} - \includegraphics[scale=0.65,clip]{include/images/fft_192khz-phase-itu_r.png} + \includegraphics[scale=0.60,clip]{include/images/fft_192khz-phase-itu_r.png} \end{center} \newpage %% layout \textbf{Frequency response of band-limited RMS detection stage (\SI{5}{\hertz} to \SI{96}{\kilo\hertz}, \SI{0}{\dB} \SI{\pm - 1}{\dB}):} + 4}{\dB}):} \begin{center} - \includegraphics[scale=0.65,clip]{include/images/fft_192khz-freq_zoomed-rms.png} + \includegraphics[scale=0.60,clip]{include/images/fft_192khz-freq_zoomed-rms.png} \end{center} \textbf{Frequency response of band-limited ITU-R BS.1770-1 detection stage - (\SI{5}{\hertz} to \SI{96}{\kilo\hertz}, \SI{0}{\dB} \SI{-6}{\dB} to - \SI{4}{\dB}):} + (\SI{5}{\hertz} to \SI{96}{\kilo\hertz}, \SI{0}{\dB} \SI{\pm + 4}{\dB}):} \begin{center} - \includegraphics[scale=0.65,clip]{include/images/fft_192khz-freq_zoomed-itu_r.png} + \includegraphics[scale=0.60,clip]{include/images/fft_192khz-freq_zoomed-itu_r.png} \end{center} \chapter{Help needed} \label{chap:help_needed} As K-Meter was coded using cross-platform code, it should be easy to -compile on Mac OS X. I just don’t have a Mac \dots +compile on Mac OS X. Unfortunately, I happen to not have a Mac \dots In case you want to help, please see the next chapter for an email address. You’ll need sufficient experience in coding, compiling and @@ -771,7 +791,7 @@ \subsection{premake4} \subsubsection{Installation} Place the binary somewhere in your \path{PATH}. Depending on your -platform, you should run \emph{premake} using the scripts +platform, you should run \path{premake} using the scripts \path{Builds/run_premake.sh} or \path{Builds/run_premake.bat}. \newpage %% layout @@ -783,7 +803,7 @@ \subsection{JUCE library} Importance: \> required \\ Version: \> 3.2.0 \\ - License: \> GPL v2 (among others) \\ + License: \> GPL v3 (among others) \\ Homepage: \> \href{http://www.juce.com/}{www.juce.com} \end{tabbing} @@ -912,7 +932,7 @@ \subsection{Artistic Style} \subsubsection{Installation} Place the binary somewhere in your \path{PATH}. Depending on your -platform, you should run \emph{astyle} using the scripts +platform, you should run \path{astyle} using the scripts \path{Source/format_code.sh} or \path{Source/format_code.bat}. \section{Building on GNU/Linux} @@ -927,11 +947,8 @@ \section{Building on GNU/Linux} where \application{CFG} is one of \application{debug32}, \application{debug64}, \application{release32} and -\application{release64}, and \application{TARGET} is one of -\application{linux\_standalone\_stereo}, -\application{linux\_standalone\_surround}, -\application{linux\_vst\_stereo} and -\application{linux\_vst\_surround}. +\application{release64}, and \application{TARGET} is the version you +want to compile, such as \application{linux\_standalone\_stereo}. The compiled binaries will end up in the directory \path{bin}.