diff options
| author | Vasile Vilvoiu <vasi@vilvoiu.ro> | 2021-07-16 18:32:27 +0300 |
|---|---|---|
| committer | Vasile Vilvoiu <vasi@vilvoiu.ro> | 2021-07-16 18:32:27 +0300 |
| commit | 47bbfdbf1e2a6193157397938e76b16a1f60e789 (patch) | |
| tree | 5f90ac568bcd0ddfa2e885bacf4e4e996395d249 /man/specgram.1.html | |
| parent | 82c81858c65c80fb667e73ffdcc4ff69007cfa17 (diff) | |
Add support for arbitrary scales, with custom units.
Add support for linear scales.
Logging of scale to stderr.
Closes #9.
Diffstat (limited to 'man/specgram.1.html')
| -rw-r--r-- | man/specgram.1.html | 35 |
1 files changed, 25 insertions, 10 deletions
diff --git a/man/specgram.1.html b/man/specgram.1.html index 41cce87..6cc0a1c 100644 --- a/man/specgram.1.html +++ b/man/specgram.1.html @@ -1,5 +1,5 @@ <!-- Creator : groff version 1.22.4 --> -<!-- CreationDate: Thu Jul 15 19:45:50 2021 --> +<!-- CreationDate: Fri Jul 16 11:40:40 2021 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> @@ -334,17 +334,32 @@ frequency spectrum, in Hz.</p> <p style="margin-left:11%;"><b>−s</b>, <b>−−scale</b>=<i>SCALE</i></p> -<p style="margin-left:22%;">Spectrogram scale. Valid values -are: dBFS.</p> +<p style="margin-left:22%;">Spectrogram scale, specified +with the following format: +<i>unit</i>[,<i>lower</i>[,<i>upper</i>]]</p> -<p style="margin-left:22%; margin-top: 1em">Default is -dBFS.</p> +<p style="margin-left:22%; margin-top: 1em"><i>unit</i> is +an arbitrary string representing the unit of measurement +(e.g. <b>V</b>). <i>lower</i> is an optional numeric value +representing the lower bound of the scale. <i>upper</i> is +an optional numeric value representing the upper bound of +the scale.</p> -<p style="margin-left:22%; margin-top: 1em"><b>[dBFS] -NOTE:</b> By default, the scale has a -120dB lower bound. -You can adjust it by appending the custom lower bound after -the scale string (e.g. <b>−s dBFS-60</b> for a -60dB -lower bound).</p> +<p style="margin-left:22%; margin-top: 1em">Valid values +for <i>SCALE</i> specify either just the unit, the unit and +the lower bound, or all three values.</p> + +<p style="margin-left:22%; margin-top: 1em">After +normalization and prescaling (see <b>−p, +−−prescale</b>), the following transformations +are applied to the input: <br> +• if <i>unit</i> starts with "dB", then a +logarithmic decibel scale is assumed: Y=20*log10(X) <br> +• the values are clamped between <i>lower</i> and +<i>upper</i>: Y=clamp(X, <i>lower</i>, <i>upper</i>)</p> + +<p style="margin-left:22%; margin-top: 1em">Default is +dBFS,-120,0.</p> <p style="margin-left:22%; margin-top: 1em"><b>[dBFS] NOTE:</b> The peak amplitude assumed for dBFS, after |