From 47bbfdbf1e2a6193157397938e76b16a1f60e789 Mon Sep 17 00:00:00 2001 From: Vasile Vilvoiu Date: Fri, 16 Jul 2021 18:32:27 +0300 Subject: Add support for arbitrary scales, with custom units. Add support for linear scales. Logging of scale to stderr. Closes #9. --- man/specgram.1.html | 35 +++++++++++++++++++++++++---------- 1 file changed, 25 insertions(+), 10 deletions(-) (limited to 'man/specgram.1.html') 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 @@ - + @@ -334,17 +334,32 @@ frequency spectrum, in Hz.

−s, −−scale=SCALE

-

Spectrogram scale. Valid values -are: dBFS.

+

Spectrogram scale, specified +with the following format: +unit[,lower[,upper]]

-

Default is -dBFS.

+

unit is +an arbitrary string representing the unit of measurement +(e.g. V). lower is an optional numeric value +representing the lower bound of the scale. upper is +an optional numeric value representing the upper bound of +the scale.

-

[dBFS] -NOTE: 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. −s dBFS-60 for a -60dB -lower bound).

+

Valid values +for SCALE specify either just the unit, the unit and +the lower bound, or all three values.

+ +

After +normalization and prescaling (see −p, +−−prescale), the following transformations +are applied to the input:
+• if unit starts with "dB", then a +logarithmic decibel scale is assumed: Y=20*log10(X)
+• the values are clamped between lower and +upper: Y=clamp(X, lower, upper)

+ +

Default is +dBFS,-120,0.

[dBFS] NOTE: The peak amplitude assumed for dBFS, after -- cgit v1.2.3