-
Notifications
You must be signed in to change notification settings - Fork 0
/
signal2pbm.1
119 lines (111 loc) · 3.06 KB
/
signal2pbm.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
.TH signal2pbm 1 "November 14, 2018"
.
.
.
.SH NAME
signal2pbm \- plot a sequence of numbers
.
.
.
.SH SYNOPSIS
.TP
\fBsignal2pbm\fP [\fIoptions\fP] \fIdatafile\fP [\fIoutfile.pbm\fP]
.
.
.
.SH DESCRIPTION
Plot an AU file (1-channel 16-bit linear PCM) or a sequence of integers,
producing a \fBpbm\fP(\fI5f\fP) image file as a result.
.
.
.
.SH OPTIONS
.TP
.BI -w " width
the width of the image, in pixels;
the height depends on the number of samples
.TP
.BI -t " timeslot
how many samples are drawn in an horizontal pixel;
all values between the minimal value and maximal value in the slot are drawn,
not just the values that are actually sampled within the time slot; if
\fItimeslot\fP is zero or negative, each sample is replicated \fI-timeslot+2\fP
times
.TP
.BI -m " maxvalue
the maximal value for the signal; by default, it is \fIINT16_MAX\fP, the
maximal possible value for a signed 16-bit integer; this option can be used to
expand the signal, like \fI-e\fP; if a value is larger than the maximal value,
it is drawn cropped
.TP
.BI -i " interline
the output images has the signal drawn in a sequence of lines;
this amount tells how much pixels each line has below and above;
the default is 10, meaning that lines are 20 pixels apart
.TP
.BI -e " factor
how much to expand each line; if \fIfactor\fP is more than one (the default),
the signal is drawn cropped when it would be larger than half the interline; in
other words, the drawing never invades the lines above and below
.TP
.BI -s " threshold
amounts lower than this are considered null as far as the no-signal line
squeezing is concerned (see option \fI-n\fP)
.TP
.BI -n " height
flat lines are squeezed to save space; this is their height;
to suppress squeezing, set \fIheight\fP to be double the interline
.TP
.BI -d " samples
discard this number of samples at the beginning of input
.TP
.B -b
discard samples until one significant, one that is displayed above the line of
zero according to the current interline and expansion; that first significan
sample is also discarded
.TP
.BI -x " samples
only display this number of samples
.TP
.B -j
without this option, a jump between signal values at consecutive points is
connected; this option disables this; as a result, the signal line may be shown
as broken
.TP
.B -a
normally, all points between minimum and maximal level in the timeslot are
drawn; this option makes the average being drawn instead; this average is
likely to be uniformly zero
.TP
.B -0
draw the line of signal level 0 in addition to the actual signal level
.TP
.B -f
input is a sequence of numbers in ascii, one per line;
the default is a 1-channel 16-bit linear PCM AU file with header
.TP
.BI -c " channel
select the channel number; only applies to AU files
.TP
.B -p
convert output to png; requires \fBnetpbm\fP(\fI1\fP)
.TP
.B -v
run the \fBfeh\fP(\fI1\fP) or \fBfbi\fP(\fI1\fP) viewer to show the resulting
image; implies \fI-p\fP
.TP
.B -h
in-line help
.TP
.B outfile.pbm
output file; \fIoutput.pbm\fP, if omitted
.
.
.
.SH EXAMPLE
Visualize what \fBremote\fP(\fI1\fP) received:
.nf
remote -l
signal2pbm -p log.au
fbi output.png
.fi