apass(1) apass(1) NAME apass - copy from one AF server to another SYNOPSIS apass [-ia input-AF-server] [-oa output-AF-server] [-full_duplex] [-id input-device-#] [-od output-device-#] [-delay seconds] [-aj anti-jitter- seconds] [-buffering buffering-seconds] [-g dB-gain] [-e encodingType] [-log] [-f <parameter-file>] DDESCRIPTION apass reads samples from the input audio server and writes them to the out- put audio server. There will be delay seconds between input and output. OPTIONS -ia server Specifies which audio server to record the sound from. Defaults to the value of the AUDIOFILE environment variable. -oa server Specifies which audio server to play the sound to. Defaults to the value of the AUDIOFILE environment variable. -full_duplex Copies sound in both directions (between input and output servers.) -id device Specifies which audio device on the input server to record the sound from. Defaults to the first device that isn't connected to the tele- phone, which is often the local microphone device. -od device Specifies which audio device on the output server to play the sound to. Defaults to the first device that isn't connected to the tele- phone, which is often the local speaker device. -delay seconds Sets the record to playback delay. The default value is 0.2 seconds. This delay is made up of three components, the buffer size - because you cannot play back a sample until the whole buffer is recorded, the nominal anti-jitter delay, which absorbs variation in the scheduling and transport delays between the record server and the playback server, and a pure delay. The minimum value is buffering+aj and the maximum is 3.0 seconds. -aj seconds Sets the tolerance for clock drift between the input and the output. If the input to output delay drifts from its nominal value by more than this amount, the delay will be resynchronized, probably resulting in an audible blip. Default value is 0.1 seconds. Legal values are 0 to 1 second. -buffering seconds This parameter sets the amount of audio read from the input and writ- ten to the output as a single operation. It sets a minimum value for delay. The default value is 0.2 seconds. Legal values are 0.1 to 0.5 second. -g dB-gain Controls the playback gain. The default value is 0 dB. Legal values are from -30 to +30. -e encodingType Sets the encoding type of the audio. This information is passed to the sending and receiving AF servers, where any necessary conversions will be done. "-e xxx" will get a list of acceptable types. Some types may not be supported by some servers. If the -e switch is not specified, the encoding type will be the natural type of the input AF device. -log If set, apass will print a message on stdout whenever it is necessary to resynchronize clocks between input and output and whenever the record side of the program takes longer than 400 milliseconds. -f file Whenever a SIGUSR1 is received, apass will read file to acquire param- eters. The parameter file should contain one or more lines. Each value should have a keyword and a value. Legal keywords are delay, buffering, aj, and gain. A typical parameter file might contain: delay 0.3 buffering 0.2 aj 0.1 gain 0.0 The general idea behind the -f file feature is that another process can be used to control the apass process. For example, a tk(1) pro- gram or emacs keybindings could alter the behavior of apass. This permits a multi-process but single threaded environment to act like a multi-threaded environment. ENVIRONMENT AUDIOFILE specifies the host and server to use if otherwise unspeci- fied BUGS must be some If you encounter a reproducible bug, please submit a problem report to (af-bugs@crl.dec.com). SEE ALSO AF(1), aplay(1) COPYRIGHT Copyright 1993-1994, Digital Equipment Corporation. See AF(1) for a full statement of rights and permissions. AUTHORS Digital Cambridge Research Lab