From 82c81858c65c80fb667e73ffdcc4ff69007cfa17 Mon Sep 17 00:00:00 2001 From: Vasile Vilvoiu Date: Thu, 15 Jul 2021 22:53:30 +0300 Subject: Support "-" for input/output files as stdin/stdout. Support dumping output file to stdout. Switch logger to stderr, make it multithreaded. Log input/output files. Closes #8, closes #10, closes #13. --- man/specgram.1 | 10 +++++++++- man/specgram.1.html | 17 +++++++++++++++-- man/specgram.1.pdf | Bin 36426 -> 37118 bytes 3 files changed, 24 insertions(+), 3 deletions(-) (limited to 'man') diff --git a/man/specgram.1 b/man/specgram.1 index 8df7812..971af9d 100644 --- a/man/specgram.1 +++ b/man/specgram.1 @@ -56,6 +56,8 @@ See \fBEXAMPLES\fR for common use cases. .BR \fIoutfile\fR Optional output image file. Check \fISFML\fR documentation for supported file types, but PNG files are recommended. +If "\fB-\fR" is provided then the resulting image is written to stdout in PNG format. + Either \fIoutfile\fR must be specified, \fB\-l, \-\-live\fR must be set, or both. .TP @@ -75,7 +77,7 @@ Input file name. If option is provided, \fIINFILE\fR is handled as a raw dump of values (i.e. input file format is not considered). The program will stop when EOF is encountered. -If option is not provided, data will be read indefinitely from stdin. +If option is not provided or "\fB-\fR" is provided, data will be read indefinitely from stdin. .TP .BR \-r ", " \-\-rate =\fIRATE\fR @@ -325,6 +327,12 @@ Render a crisp output with a transparent background, so it can be embedded in a .IP \fBspecgram\fR -qe --bg-color=00000000 -i \fIinfile\fR \fIoutfile.png\fR +.LP +Generating from a file to stdout and displaying the output with \fBimagemagick\fR: + +.IP +\fBspecgram\fR -i \fIinfile\fR - | \fBdisplay\fR + .SH BUGS Frequency bounds (\fB\-x, \-\-fmin\fR and \fB\-y, \-\-fmax\fR) may exceed FFT window frequency limits when resampling is enabled (i.e. default behaviour), but may not do so when resampling is disabled (\fB\-q, \-\-no_resampling\fR). diff --git a/man/specgram.1.html b/man/specgram.1.html index 1559b4c..41cce87 100644 --- a/man/specgram.1.html +++ b/man/specgram.1.html @@ -1,5 +1,5 @@ - + @@ -128,6 +128,10 @@ forcefully quit.

Check SFML documentation for supported file types, but PNG files are recommended.

+

If +"-" is provided then the resulting image is +written to stdout in PNG format.

+

Either outfile must be specified, −l, −−live must be set, or both.

@@ -151,7 +155,8 @@ provided, INFILE is handled as a raw dump of values stop when EOF is encountered.

If option is -not provided, data will be read indefinitely from stdin.

+not provided or "-" is provided, data will +be read indefinitely from stdin.

−r, −−rate=RATE

@@ -536,6 +541,14 @@ in a document:

specgram -qe --bg-color=00000000 -i infile outfile.png

+

Generating from +a file to stdout and displaying the output with +imagemagick:

+ + +

specgram +-i infile - | display

+

BUGS

diff --git a/man/specgram.1.pdf b/man/specgram.1.pdf index 7c6de03..4b9db2d 100644 Binary files a/man/specgram.1.pdf and b/man/specgram.1.pdf differ -- cgit v1.2.3