USAGE: mergewav -<option> ....
  (prepare to )merge wav-files channel-wise (0=Left, 1=Right).

LISTING
USAGE: mergewav -<option> <audiofile> [<from> <byd>|0]
OPTION:
 -d<ch> write samplevalues of channel <ch> as signed decimal integer to stdout.
 -D<ch0><ch1> same as -d for two channels.
 -x<ch> write samplevalues of channel <ch> as hexadecimal integer to stdout.
 -X<ch0><ch1> same as -x for two channels.
        Note: <from> <byd> in samples, <byd>=0 for EOF.
STATISTICS
USAGE: mergewav -<option> <audiofile>
OPTION:
 -p<ch> write average & max. of abs(sample-previous_sample) in <ch> to stdout.
 -l<ch> write RMS and dBA per second of <audiofile> for channel <ch> to stdout.
 -L<ch> write RMS and dBA of <audiofile> for channel <ch> to stdout.
        RMS on scale 0..100, not on scale of 2^samplesize.
 -O<ch> write count and percentage of digital clipping of <audiofile>
        for channel <ch> to stdout.
 -R<ch> write only RMS <audiofile> for channel <ch> to stdout and dBA to stderr.
 -s     write properties of <audiofile> to stdout.
 -v<ch> write statistics per second for channel <ch> to stdout.
 -V<ch> write statistics of <audiofile> for channel <ch> to stdout.
USAGE: mergewav -w <audiofile> [<audiofile> ..]
        write length of audio and number of channels to stdout.
USAGE: mergewav -p<ch> <audiofile> <blocksize>
        same as "-p <audiofile>", but per <blocksize> samples.
USAGE: mergewav -Q<ch0><ch1> <audiofile0> <audiofile1> [<mergeoffset>]
       write correlation coefficient between <ch0> of <audiofile0>
       and <ch1> of <audiofile1> to stdout.
USAGE: mergewav -= <RMS-value>
        write equivalent dbA value to stdout.

COPY
USAGE: mergewav -<option> <audiofile0> <dest> <from0> <byd0>|0 [[-]<noise>]
OPTION:
 -c copy all channels of <audiofile0> from sample <from0>
    to sample <byd0>|EOF to <dest>.
 -t copy all channels of <audiofile0> from time <from0> seconds
    to time <byd0>|EOF seconds to <dest>.
 -C compress by a factor of 2 <audiofile0> from time <from0> seconds
    to time <byd0>|EOF seconds to <dest>.
 -E stretch by a factor of 2 <audiofile0> from time <from0> seconds
    to time <byd0>|EOF seconds to <dest>.
    Optionally white noise with an amplitudo of <noise> bits will be added.
    The granularity of <noise> is 0.01 unit of sample value.
    -<noise> will suppress the original signal from <audiofile0>.
USAGE: mergewav -A <audiofile0> <dest> <from0> <byd0>|0 <attack> <decay>
    copy all channels of <audiofile0> from time <from0> seconds to time
    <byd0>|EOF seconds to <dest> with linear in- and decreasing volume
    for the first <attack> and last <decay> seconds.
USAGE: mergewav -z <audiofile0> <dest> <from0> <byd0>|0 <add_to_ch0> [<add_to_ch1>]
    copy all channels of <audiofile0> from time <from0> seconds to time
    <byd0>|EOF seconds to <dest> with shift.
NOTE: Time in seconds implies that fractions of seconds are allowed.

MERGE MONO TO LEFT+RIGHT
USAGE: mergewav -<option> <audiofile0> <audiofile1> <dest>
                           <atten0> <atten1> <mergeoffset>
OPTION:
 -m<ch0><ch1> copy <ch0> from <audiofile0> to channel 0 of <dest>
              copy weighted sum of <ch0> from <audiofile0>
              and <ch1> from <audiofile1> to channel 1 of <dest>.
              +[-]ve <mergeoffset>: start at sample [-]<mergeoffset>
              in <audiofile1[0]>.

MERGE MONO TO MONO
USAGE: mergewav -<option> <audiofile0> <audiofile1> <dest>
                           <atten0> <atten1> <mergeoffset>
OPTION:
 -M<ch0><ch1> copy weighted sum of
              <ch0> from <audiofile0> and <ch1> from <audiofile1>
              to the single channel of <dest>.
              +[-]ve <mergeoffset>: start at sample [-]<mergeoffset>
              in <audiofile1[0]>.

MERGE STEREO TO STEREO
USAGE: mergewav -<option> <audiofile0> <audiofile1> <dest> <atten0left>
                       <atten1left> <atten0right> <atten1right> <mergeoffset>
OPTION:
 -S<ch0left><ch1left><ch0right><ch1right> copy weighted sum of
              <ch0left/ch0right> from <audiofile0> and <ch1left/ch1right>
              from <audiofile1> to channel left/right of <dest>.
              +[-]ve <mergeoffset>: start at sample [-]<mergeoffset>
              in <audiofile1[0]>.

CONCATENATE
USAGE: mergewav -+ <audiofile0> <audiofile1> <dest> <from0> <byd0>|0 <from1> <byd1>|0
              concatenate selected samples in <ch0> of <audiofile0>
              and selected samples in channel <ch1> of <audiofile1>.

CORRELATE
USAGE: mergewav -<option> <audiofile0> <audiofile1> <from0> <byd0>|0 <from1> <byd1>|0
OPTION:
 -q<ch0><ch1> correlate selected samples in <ch0> of <audiofile0>
              with selected samples in channel <ch1> of <audiofile1>.
              The difference in samplelength abs(<byd1>-<from1>-<byd0>+<from0>)
              determines the number of correlations calculated.
 -b<ch0><ch1> as -q, write best correlation only.

USAGE
USAGE: mergewav
USAGE: mergewav -h[elp]
USAGE: mergewav --[help]
              write this usage info to stdout.

Copyright (C) 2011 by Harm J. Schoonhoven

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
VERSION: Dec  4 2012