afft(1) afft(1) Name afft - A Realtime FFT display client SYNOPSIS afft [-color] [-d device] [-file file] [-gain gainvalue] [-length fftlength] [-log] [-min minvalue] [-max maxvalue] [-nodc] [-noscope] [-nowindow] [-realtime] [-sine] [-spec] [-stride stridelength] Description afft accepts mu-law audio data from one of several sources, executes a run- ning Fourier transform on the data, and displays the transform result. The display is updated continuously in either "waterfall" or "spectrogram" for- mat. afft is initially configured through command line switches. Many of the parameters can be changed while the progogram is running via the graphical user interface, as described below. The source of the audio that is displayed depends on the configuration as folows: If the -file switch is given, then the audio source is a file of mu-law samples. Otherwise, if the -sine switch is given, the audio source is a "canned" sine wave that sweeps up and down the frequency spectrum. If neither -file or -sine are given, then afft takes its audio data from the audio server local input. Options -color Specifies that the display is to be in color. The default is grays- cale. The color scheme can be changed while afft is running by means of a pull-down menu labeled "Colors". -d device Specifies the name of the audio device. If not given, afft defaults to the local audio device. -file file Input will be taken from file, which should contain raw mu-law samples of audio data. afft will continuously loop through the file from beginning to end, rewind the file, and repeat. If file is given as "-", input is taken from stdin. Since it is not possible to rewind stdin, afft will terminate on end-of-file in this case. If afft can connect to the audio server, then the file is played through the audio output device in synchronization with the fft display. -gain gainvalue Sets the gain in DB to be applied to the audio samples. Should be in the range of -100 to -5, and represents a level down from a theoreti- cal peak value of 0DB. Applies only when log mode is selected, see -log switch. Default value is -20. The gain value may be controlled while afft is running by a slider labeled "Gain". -length fftlength Sets the number of samples over which each FFT transform is computed. Legal values are 512, 256, 128, and 64. Default value is 512. The length can be changed while afft is running by means of a pull-down menu labeled "FFT Length" -log Selects the initial display mode to be logarithmic. If not specified, the initial display mode is linear. The selection between log and linear mode may be changed while afft is running by a pair of radio buttons labeled "Log" and "Linear". -min minvalue Sets the lowest audio level that will be displayed. Value is in DB for log mode, or in percent of peak value in linear mode. Default is -100 in log mode, and 0 in linear. The minimum value may be con- trolled while afft is running by a slider labeled "Minimum". -max maxvalue Sets the hightest audio level that will be displayed. Value is in DB for log mode, or in percent of peak value in linear mode. Default is 0 in log mode, and 100 in linear. The maximum value may be con- trolled while afft is running by a slider labeled "Maximum". -nodc Supresses display of the DC component. Default is to include the DC component in the fft display. Inclusion or supression of the DC com- ponent may be changed while afft is running by a pair of radio buttons labeled "NoDC" and "DC". -noscope Suppresses display of the audio stream in an oscilloscope-like form. The default is to show this display. Oscilloscope display can also be turned on and off while afft is running by a pair of radio buttons labeled "Scope On" and "Scope Off". -nowindow Supresses the window function. By default, a Hamming window is used. Other window functions can be selected through a pulldown menu labeled "Windows". Additional window functions include Hanning, and Triangu- lar. -realtime If this switch is given, afft attempts to stay synchronized with the audio server in real time. If afft cannot get enough CPU cycles to keep up with the incoming audio stream, it may fall behind enough that it no longer captures valid audio data. In non-realtime mode (the default), afft will discard audio samples in order to keep up with real time. -sine Causes afft to begin operation in demo mode, which displays a sine curve sweep from the minimum frequency up to the Nyquist cut-off fre- quency. afft can operate in this mode even if the audio server is not running or no audio hardware is available. afft can be switched between demonstration mode and live mode (input from the audio server) by a pair of radio buttons labeled "Live" and "Demo. -spec Selects spectrogram display. Otherwise, a waterfall style of display is used. You can switch at will between spectrogram and waterfall by a pair of radio buttons labeled "Waterfall" and "Spec". -stride stridelength Sets the number of samples that afft advances between FFT frames. Legal values are 512, 256, 128, and 64. Default value is 512. How- ever, the stride will never be greater than the FFT length (see above). The stride can be changed while afft is running by means of a pull-down menu labeled "Stride" Owner Original by L. Stewart User Interface by J. Morse Copyright Copyright 1992-1994 Digital Equipment Corporation