tomwalters@0: .TH EDWAVE 1 "1 September 1993"
tomwalters@0: 
tomwalters@0: .SH NAME
tomwalters@0: edwave \-  Edit a given range of a wave.
tomwalters@0: 
tomwalters@0: .SH SYNTAX 
tomwalters@0: edwave [options] [filename]
tomwalters@0: 
tomwalters@0: .SH DESCRIPTION
tomwalters@0: Editing operations extract or delete a given time range of a given wave,
tomwalters@0: and the results are written on the stdout.
tomwalters@0: 
tomwalters@0: .SH OPTIONS
tomwalters@0: 
tomwalters@0: 1. range.
tomwalters@0: 
tomwalters@0: The range option specifies the stretch of the wave for the editing operation
tomwalters@0: by:
tomwalters@0: 
tomwalters@0: .nf
tomwalters@0: 	    range=a[-b]
tomwalters@0: .fi
tomwalters@0: 
tomwalters@0: The upper limit `b' is optional, and when it is missing then the range
tomwalters@0: is a single sample of the given type, otherwise `a' and `b' are inclusive range limits.
tomwalters@0: The strings "min" and "max" are recognised as extreme limits
tomwalters@0: ("min" = start of file, "max" = end of file),
tomwalters@0: otherwise the values of `a' and `b' are sample numbers: 0,1,2,...
tomwalters@0: Values given with time units (ms or s) are converted to samples using
tomwalters@0: the given samplerate option.
tomwalters@0: 
tomwalters@0: 2. operation.
tomwalters@0: 
tomwalters@0: The `operation' option sets the edit operation to either:
tomwalters@0: 
tomwalters@0: .nf
tomwalters@0: 	    operation=extract
tomwalters@0: or
tomwalters@0: 	    operation=delete
tomwalters@0: .fi
tomwalters@0: 
tomwalters@0: The extract operation outputs the part of the input which is inclusively
tomwalters@0: within the given range.
tomwalters@0: The delete operation outputs the part of the input which is NOT inclusively
tomwalters@0: within the given range.
tomwalters@0: 
tomwalters@0: 3. type.
tomwalters@0: 
tomwalters@0: The datatype of input and output. Known types are in the list:
tomwalters@0: char, short, int, float, double, ascii. The ascii type is interpreted as one
tomwalters@0: sample per line.
tomwalters@0: 
tomwalters@0: 4. size.
tomwalters@0: 
tomwalters@0: Print the size of the wave on the stdout in given units.
tomwalters@0: Units are seconds ("size=s"), milliseconds ("size=ms"), or samples ("size=on").
tomwalters@0: Sizes in time units are calculated using the given `samplerate' option.
tomwalters@0: 
tomwalters@0: .SH "SEE ALSO"
tomwalters@0: options bufwave
tomwalters@0: 
tomwalters@0: .SH COPYRIGHT
tomwalters@0: .LP
tomwalters@0: Copyright (c) Applied Psychology Unit, Medical Research Council, 1995
tomwalters@0: .LP
tomwalters@0: Permission to use, copy, modify, and distribute this software without fee 
tomwalters@0: is hereby granted for research purposes, provided that this copyright 
tomwalters@0: notice appears in all copies and in all supporting documentation, and that 
tomwalters@0: the software is not redistributed for any fee (except for a nominal 
tomwalters@0: shipping charge). Anyone wanting to incorporate all or part of this 
tomwalters@0: software in a commercial product must obtain a license from the Medical 
tomwalters@0: Research Council.
tomwalters@0: .LP
tomwalters@0: The MRC makes no representations about the suitability of this 
tomwalters@0: software for any purpose.  It is provided "as is" without express or 
tomwalters@0: implied warranty.
tomwalters@0: .LP
tomwalters@0: THE MRC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING 
tomwalters@0: ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL 
tomwalters@0: THE A.P.U. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES 
tomwalters@0: OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, 
tomwalters@0: WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, 
tomwalters@0: ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS 
tomwalters@0: SOFTWARE.
tomwalters@0: