
WaveCut - documentation file

Introduction

WaveCut is a PM tool for playing and cutting large wav files into smaller 
wav file tracks. It runs under os/2 and ecomstation and requires both 
Rexx and MMOS/2 to be previously installed.  

Features:
 - small and tall PM interface
 - integrated wav player
 - fast cutting (integration of COPYWAVE)
 - source files can be very large, up to 4 GB
 - adjust the volume of several files to the same level (integration 
   of NORMALIZE)
 - fade in / fade out of tracks
 - burning tracks to CDR (support for "RSJ CD WRITER")
 - integration of rexx scripts
 - sample scripts to encode the tracks to MP3 or OGG VORBIS formats
 - sample script to create medleys


Installation

 1. unpack the archive to a directory of your choice
 2. Download NORMALIZE and install it. 
    This is only required if you want to use the normalize function.  
    If you do, please be sure you have the latest EMX libraries as they 
    are needed by NORMALIZE.
 3. Download COPYWAVE and install it.
 4. Install LAME and OGG VORBIS if you want to use the encode scripts.  
    Please make sure to modify the path entries within these files to match 
    your configuration.
 5. Run wavecut.exe to launch the program or run install.cmd to create 
    a WaveCut folder on your desktop.
 6. Set up WaveCut (select 'properties' from tracklist window)  


URLs and (tested-) versions

 home of RSJ CD WRITER (v4.05)
    http://www.rsj.de
 home of COPYWAVE (v1.14)
    http://www.c-arnold.de.vu
 get NORMALIZE (v0.7.3), LAME (v3.90a7) and OGG VORBIS (v1.0) from HOBBES
    http://hobbes.nmsu.edu
 home of WaveCut
    http://www.subsys.de



Using WaveCut

 1. Loading a wave file
    There are several ways to load a wav file:
    - use the load button in the player window
    - drag and drop a wav file from a folder or from the desktop 
      to the file display-field in the player window
    - start WaveCut with a file name parameter, e.g.:  "wavecut.exe 
      d:\tracks\concert.wav" The parameter must be a file name 
      including full path and drive

 2. Using the wav player
    One you have opened a wav file, you can use the integrated wav 
    player to play the file.  Using the slider, you can navigate 
    throughout large wav files quickly.  The other player functions 
    operate as you expect and should be self-explainatory.

 3. Cutting the wave file
    In the tracklist window, you can create the new tracks.  First, 
    select a target directory where you want the files placed.  This 
    target directory must be an EMPTY folder.  Second, you should select 
    the DAO checkbox if you want to create DAO compatible wav tracks. If 
    you do select the DAO option, the tracks will have sizes with whole 
    sectors (40/1000 sec steps). If the DAO option is not checked, you 
    can create track sizes in 1/1000 sec steps.

    Next, offsets for the new tracks can be set in the track settings dialog.  
    This dialog communicates with the wav player. There are buttons to get 
    the current position within the source track from the wav player, or to 
    set the player to a specified position from the track settings dialog.

    You will find a short description of all functions in the help line 
    located in the bottom of a window. There are also several special 
    functions that deserve mentioning, e.g. you can open the target directory 
    with a right mouse button click of the displayed directory name, or you 
    can double click an entry at the tracklist and the track will be played 
    from the start to the end of the offset.

    Additionally, make sure you have plenty of hard disk space to accommodate 
    the large amount of room wav files require.


 4. Managing your tracklists 
    In the tracklist window, you can open and save your tracklists.  
    A tracklist file is a plain ascii file that you can edit manually 
    - but be careful and only attempt if you are comfortable with changing 
    the file in this manner.
    The function "export cd info" creates a list with track names and 
    track length (whole min:sec). This is useful to help create CD covers.


 5. Using scripts
    You can launch REXX - Scripts after the creation of target files.  
    The scripts must be placed in a subdirectory called "script".  The 
    script will start with the name of the target directory as the 
    parameter.

    WaveCut comes with some example scripts to get you started.  Please
    make sure to modify the path entries within these files to match your
    configuration.

    The medley script creates a single wav file that contains all the 
    tracks from the tracklist. To append the tracks in the right order, 
    name the tracks in track setup with numbers, e.g. track01, track02 
    - trackXX


Bugs

    There are no known bugs.
    For bug reports, please send me an email at mail@subsys.de and use 
    the word "wavecut" in the subject line.  Thanks.



License

    This program is Freeware (see also the file licence.txt) If you want to 
    support the subsys development, we will be happy if you send us an empty 
    CDR (we have crashed a lot of CDRs during the development of the RSJ 
    features, and we supplies is always welcome :).
    The postal address is:

	Frank Wochatz
	Heinrich-Roller-Str. 25
	10405 Berlin

    Thanks in advance.



Thanks to:

    Carsten Anrold for CopyWave

    Oliver Ebert and Rudolf Hoeger - for beta testing.

    Chris Wohlgemuth - for some essential hints.

    Gerald James Helfrich - for revising this english documentation

    Carsten Mueller - for the directory open dialog for vispro rexx 
    and providing the webspace used for the beta forum at commTalk.de

    RSJ - for making this great software and for answering all my
    stupid questions.




Frank Wochatz <mail@subsys.de>

Berlin, 29.12.2002