summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorVasile Vilvoiu <vasi@vilvoiu.ro>2023-05-06 20:40:52 +0300
committerVasile Vilvoiu <vasi@vilvoiu.ro>2023-05-06 20:40:52 +0300
commitf2f4792f824cd64e679cdc859fb008769541257b (patch)
treed2ee924bd8945dbf4112afa365aaa822dfea34bc /man
parent2ebb152342283a2237bc7ca2dd96baf3cac0d56e (diff)
Add support for waiting for input.
Introduce -S/--sleep_for_input command line argument. Closes #17.
Diffstat (limited to 'man')
-rw-r--r--man/specgram.111
-rw-r--r--man/specgram.1.html16
-rw-r--r--man/specgram.1.pdfbin37623 -> 37897 bytes
3 files changed, 24 insertions, 3 deletions
diff --git a/man/specgram.1 b/man/specgram.1
index 0cbf166..4d679d8 100644
--- a/man/specgram.1
+++ b/man/specgram.1
@@ -1,4 +1,4 @@
-.TH SPECGRAM 1 "2021-10-20"
+.TH SPECGRAM 1 "2023-05-06"
.SH NAME
specgram \- create spectrograms from raw files or standard input
@@ -14,6 +14,7 @@ specgram \- create spectrograms from raw files or standard input
[\fB\-d, --datatype\fR=\fIDATA_TYPE\fR]
[\fB\-p, --prescale\fR=\fIPRESCALE_FACTOR\fR]
[\fB\-b, --block_size\fR=\fIBLOCK_SIZE\fR]
+[\fB\-S, --sleep_for_input\fR=\fISLEEP_MS\fR]
[\fB\-f, --fft_width\fR=\fIFFT_WIDTH\fR]
[\fB\-g, --fft_stride\fR=\fIFFT_STRIDE\fR]
[\fB\-n, --window_function\fR=\fIWIN_FUNC\fR]
@@ -121,6 +122,14 @@ The larger this value, the larger the latency of the live spectrogram.
Default is 256.
.TP
+.BR \-S ", " \-\-sleep_for_input =\fISLEEP_MS\fR
+Duration in milliseconds to sleep for when input is not available.
+Set this to a reasonable value when input is sparse.
+Leave unset when input is constant and low latency is desired.
+
+Default is 0 (i.e. program busywaits).
+
+.TP
\fBFFT OPTIONS\fR
.TP
diff --git a/man/specgram.1.html b/man/specgram.1.html
index 367fa10..5ac4677 100644
--- a/man/specgram.1.html
+++ b/man/specgram.1.html
@@ -1,5 +1,5 @@
<!-- Creator : groff version 1.22.4 -->
-<!-- CreationDate: Wed Oct 20 18:28:19 2021 -->
+<!-- CreationDate: Sat May 6 17:36:19 2023 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
@@ -55,7 +55,8 @@ input</p>
--rate</b>=<i>RATE</i>] [<b>&minus;d,
--datatype</b>=<i>DATA_TYPE</i>] [<b>&minus;p,
--prescale</b>=<i>PRESCALE_FACTOR</i>] [<b>&minus;b,
---block_size</b>=<i>BLOCK_SIZE</i>] [<b>&minus;f,
+--block_size</b>=<i>BLOCK_SIZE</i>] [<b>&minus;S,
+--sleep_for_input</b>=<i>SLEEP_MS</i>] [<b>&minus;f,
--fft_width</b>=<i>FFT_WIDTH</i>] [<b>&minus;g,
--fft_stride</b>=<i>FFT_STRIDE</i>] [<b>&minus;n,
--window_function</b>=<i>WIN_FUNC</i>] [<b>&minus;m,
@@ -227,6 +228,17 @@ spectrogram.</p>
<p style="margin-left:22%; margin-top: 1em">Default is
256.</p>
+<p style="margin-left:11%;"><b>&minus;S</b>,
+<b>&minus;&minus;sleep_for_input</b>=<i>SLEEP_MS</i></p>
+
+<p style="margin-left:22%;">Duration in milliseconds to
+sleep for when input is not available. Set this to a
+reasonable value when input is sparse. Leave unset when
+input is constant and low latency is desired.</p>
+
+<p style="margin-left:22%; margin-top: 1em">Default is 0
+(i.e. program busywaits).</p>
+
<p style="margin-left:11%;"><b>FFT OPTIONS <br>
&minus;f</b>,
<b>&minus;&minus;fft_width</b>=<i>FFT_WIDTH</i></p>
diff --git a/man/specgram.1.pdf b/man/specgram.1.pdf
index d6a0be4..1d9bae6 100644
--- a/man/specgram.1.pdf
+++ b/man/specgram.1.pdf
Binary files differ