CopyWave for OS/2 by Carsten Arnold
Version 1.14
eMail:  C.Arnold@Transnet.de
URL:    http://www.c-arnold.de.vu

This program is freeware.

The program copies parts from an existing PCM-Wave file starting 
from an indicated place in an indicated length into a new Wave file. 
The files can be very big.

Syntax:
CopyWave Source Target [Options]
or
CopyWave Source1+Source2+SourceN Target [Misc and/or target options]
or
CopyWave Source1+Source2+SourceN Target [Misc and/or target options]

If You specify more as one source file and You may set source options,
You must set the file name and the options in {}, for exemple:

CopyWave {Source1 /st:4} + {Source2 st:6} Target 
or cutting
CopyWave file /cut:10:00

For file You can specify wildcards * and ?. If You use wildcards, You can
not use time-parameter for source files. The full file size are copied.
Files are copied in alphabetical order, oder is not case sensitive.
If parameter /r specified, subdirectories are worked.

Source options are: 
/ss:n     start sample
/es:n     end sample
/cs:n     count of samples
   instead of samples can also specified time
/st:n     start time in seconds
/et:n     end time in seconds
/ct:n     length in seconds

   or bytes
/sb:n     startbyte
/eb:n     endbyte
/cb:n     count of bytes

Target options:
/a        append data
/o        enable overwrite
/fi:t     fade in, where t is time
/fo:t     fade out, where t is time

cutting options:
/cut:n    cutting the end of file where n is result time in seconds
/cutB:n   cutting the end of file where n is result count of data bytes
/cutS:n   cutting the end of file where n is result count of samples


Seconds can be decimal fraction, for example
/ct:20.2
or in hh:mm:ss.ms
/ct:0:20:25


Misc options:
/r        recurse into directories if used wildcards for source files
/pr:c.d   priority
    c = class 0-4 (0->no change, 2 is default)
    d = delta 0 - 31
/Buffer:n Buffer size in Byte, default is 409600

Use with care, the buffer are allocated fom RAM, 
too big buffer will swapped out to swapper.dat

/Async    ansynchron read and write (2 threads), default is synchron

CopyWave can work with two threads, thread one read, thread two write.
This option is suggestive only, if copy from one physical HD to another
physical HD. This can increase the speed of copying.

/v        View only

shows file data, for example:
file:       z.wav
file size   5,000,044 byte
data size   5,000,000 byte
samples     1,250,004
duration    28.345 seconds  00:00:28.345
channels    stereo
bits/sample 16
samples/sec 44100

/NoWc       No write cache

Normally the file-system driver should place data from I/O operations 
into its cache. If this switch is set I/O operations to the file need not 
be done through the file-system driver's cache. 
The setting of this bit determines whether file-system drivers should place 
data into the cache. Like the write-through flag. 

/NoRc       No read cache

See /NoWc

/WThrough

If this switch not set, data writes to the file may go through the file-system 
driver's cache. The file-system driver writes the sectors when 
the cache is full or the file is closed. 

If set, data writes to the file may go through the file-system driver's 
cache, but the sectors are written (the actual file I/O operation is 
completed) before a synchronous write call returns. This state of the file 
defines it as a synchronous file. For synchronous files, this flag must 
be set, because the data must be written to the medium for synchronous 
write operations. 


Parameters are not case sensitive.


