← Back to branch summary

~ubuntu-branches/ubuntu/saucy/siggen/saucy

« back to all changes in this revision

Viewing changes to tones.1

  • Committer: Package Import Robot
  • Author(s): Thorsten Alteholz
  • Date: 2012-03-13 18:51:09 UTC
  • mfrom: (4.1.3 sid)
  • Revision ID: package-import@ubuntu.com-20120313185109-0zkxvq2vpwbjbkf2
Tags: 2.3.10-5
http://bugs.debian.org/628941
* new maintainer (closes: #628941)
* debian/rules: remove explicit patch targets
* debian/rules: replace dh_clean -k by dh_prep
* debian/rules: build-arch and build-indep introduced
* debian/rules: standard moved to 3.9.3 (no changes)
* debian/watch: added, but not working with upstreams website
* debian/control: dependency on quilt removed
* debian/control: no public vcs available
* debian/control: moved to dh 9
* debian/patches: add header
* debian/source/format: 3.0 (quilt) introduced

Show diffs side-by-side

added added

removed removed

Lines of Context:
tones.1
65
65
.PP
66
66
Waveforms can be specified/altered at anytime. A single waveform name
67
67
specifies that waveform to be used for all channels. Alternatively
68
 
a comma (',') seperated list of waveforms can be given to specify or alter
 
68
a comma (',') separated list of waveforms can be given to specify or alter
69
69
the waveform to use for a given channel. Ommitting a waveform in a list,
70
70
means that the previous waveform is left unchanged.
71
71
.PP
86
86
.PP
87
87
Instead of playing the output to 
88
88
.I /dev/dsp
89
 
the samples can be written to a file as raw samples (-o file) or written in
90
 
WAV format (-w wavfile). These data files can then be played back quickly
 
89
the samples can be written to a file as raw samples (\-o file) or written in
 
90
WAV format (\-w wavfile). These data files can then be played back quickly
91
91
with a raw data or WAV file player (e.g. wavplay) without the overhead of
92
92
actually generating the samples.
93
93
.PP
137
137
.PP
138
138
e.g.
139
139
.I 440,880@-12,1760@-30
140
 
specifies a mixture with 880Hz -12dB down, and 1760Hz -30dB down relative
 
140
specifies a mixture with 880Hz \-12dB down, and 1760Hz \-30dB down relative
141
141
to the level of 440Hz. The mixed signal samples will span the full 16 or 8
142
142
bit range permitted for maximal signal accuracy.
143
143
.PP
146
146
being at a relative power level of 0.5,
147
147
.I -20dB
148
148
being at a relative power level of 0.01 . However power levels are
149
 
proportional to the square of the signal amplitude. So a signal at -6dB
 
149
proportional to the square of the signal amplitude. So a signal at \-6dB
150
150
(quarter power) will only have its amplitude down by half. To reduce a
151
 
signal amplitude by 1/10 then specify -20dB, i.e. a power level down 
 
151
signal amplitude by 1/10 then specify \-20dB, i.e. a power level down
152
152
by a factor of a hundredth.
153
153
.PP 
154
154
dB levels can be specified as decimal values.
165
165
.PP
166
166
e.g.
167
167
.I 500@-20,750@-6,1000,-12
168
 
gives 500Hz at -20db (amplitude 0.1), 750Hz at -6db (amplitude 0.5),
169
 
and 1000Hz at -12dB (amplitude 0.25). The final mixed signal will have
170
 
an amplitude of 0.1 + 0.5 + 0.25 = 0.85 or -1.4dB.
 
168
gives 500Hz at \-20db (amplitude 0.1), 750Hz at \-6db (amplitude 0.5),
 
169
and 1000Hz at \-12dB (amplitude 0.25). The final mixed signal will have
 
170
an amplitude of 0.1 + 0.5 + 0.25 = 0.85 or \-1.4dB.
171
171
.PP
172
172
As can be seen, there is no "hands-free" in 
173
173
.I absolute
174
174
mode. You have to work out the dB levels yourself and ensure that the
175
175
resultant mixed signal does not go above 0dB and get clipped. Remember also
176
 
that a sine wave at -80dB down (amplitude 1/10000th) only has 6 digital
 
176
that a sine wave at \-80dB down (amplitude 1/10000th) only has 6 digital
177
177
levels and is a pretty poor representation of a sine wave, not suitable for
178
178
post amplification and use!
179
179
.PP
186
186
.PP
187
187
e.g.
188
188
.I @-20\ 1000,1200@+6,1400@-6
189
 
is the same as 1000Hz at -20dB, 1200Hz at -14dB and 1400Hz at -26dB.
 
189
is the same as 1000Hz at \-20dB, 1200Hz at \-14dB and 1400Hz at \-26dB.
190
190
.SH LOADABLE\ WAVEFORMS
191
191
.PP
192
192
Given that the generation method used by 
230
230
.IP -abs|-absolute
231
231
set absolute amplitude mode
232
232
.IP -a
233
 
when used in conjunction with the -o option, data is appended to the file.
 
233
when used in conjunction with the \-o option, data is appended to the file.
234
234
.IP -C\ file
235
235
use "file" as the local configuration file (see below).
236
236
.IP -c\ CHANNELS
238
238
CHANNELS. The default number is 4. There is some virtue in keeping the
239
239
number of channels to a minimum.
240
240
.IP -f
241
 
when used in conjunction with the -o or -w options, any existing file is
 
241
when used in conjunction with the \-o or \-w options, any existing file is
242
242
silently overwritten.
243
243
.IP -h
244
244
display usage and help info
248
248
are actioned before the input file is read.
249
249
.IP -l
250
250
play the tone sequence repetitively. Forced off if writing samples to a file
251
 
with the -o or -w options.
 
251
with the \-o or \-w options.
252
252
.IP -loop\ N
253
253
play the tone sequence N times.
254
254
.IP -o\ file
262
262
.IP -w\ wavfile
263
263
write samples out in WAV format to wavfile. The WAV header contains details
264
264
of whether the data is 8 or 16 bits and the sampling rate. You cannot use the
265
 
append (-a) option with WAV files.
 
265
append (\-a) option with WAV files.
266
266
.IP -v
267
267
be verbose
268
268
.IP -lw\ N
275
275
the second of 700Hz and 1200Hz and the third of 800Hz, 1100Hz and 1300Hz
276
276
.IP tones\ -loop\ square\ 200\ 700\ 900\ 400\ 500
277
277
generates a sequence of 4 200 millisecs square wave tones which is repeated
278
 
until the program is interupted.
 
278
until the program is interrupted.
279
279
.IP tones\ -w\ seq.wav\ 70\ 1016\ 1200\ 1080\ 1150\ 1016
280
280
generates a sequence of 5 70 millisecs sine tones, and instead of playing them
281
281
the samples are stored in WAV format in seq.wav which can be played by any
333
333
looks for configuration values CHANNELS, DACFILE, SAMPLERATE,
334
334
SAMPLESIZE, VERBOSE, LOADABLE_WAVEFORMS.
335
335
.IP CHANNELS
336
 
sets the number of channels, see '-c' option.
 
336
sets the number of channels, see '\-c' option.
337
337
.IP DACFILE
338
338
allows the name of the DAC/DSP/PCM device to be changed from /dev/dsp
339
339
.IP LOADABLE_WAVEFORMS
346
346
sets whether or not to run in verbose mode.
347
347
 
348
348
.SH SEE  ALSO
349
 
.IP siggen.conf(5),\ sgen(1),\ swgen(1)
 
349
.IP siggen.conf(5),\ signalgen(1),\ swgen(1)
350
350
.SH
351
351
.SH BUGS
352
352
.SH