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

This program is freeware.

The program can recording and playing very big wave files directyl from/to HD.
Its required dart.

Syntax:
PlayRec [Options] filename
or 
PlayRec filename [Options]

If filename is "con", then streaming is enabled.
The program provide data to stdout in raw PCM, so it can used by lame.
e.g.
playrec con /r /f:22050 | lamepcm -r -s 22.05 -m s - test.mp3

Note, use lamepcm. lame (whithout "pcm") do not work for this.

I have tested whith lame version 3.57.

/h or /?  displays this text

Parameters for recording

/r        recording (default is playing)
/8        8 bit recording (default is 16), implicate /r
/f:n      frequency (2000hz up to 48000 hz, default=44100), implicate /r
/u        uLaw (8 bits), implicate /r
/a        aLaw (8 bits), implicate /r
/m        mono (default is stereo), implicate /r
/d        IMA ADPCM hardware compression (16 bits; 4:1), implicate /r
/rb:n     buffersize for recording in MB (default is 16MB), implicate /r
          This replaced the buffersize (/b) for the MMPM-handler of older versions.
          The buffer prevents dropouts on recording if the target device 
          temporary not ready for writing wave data.
/sp       show level (VU-meter), implicate /r
/np:n     noise level to recording in promille (0-1000, default=0), implicate /r
/t:n      trailing time in ms, used if /np:n > 0 (default is 200 ms), implicate /r
          if /np:n > 0 recording stopped while real noise level < /np:n
/end      program ended if trailing time elapsed
/src:x    audio source, where x can be line, mic or cd, default is line
          xmp: /src:line
/nocp     no change code page
          For display VU-meter I use the character '' hex DD.
          So that this character is correctly represented, code page must be
          adjusted to 437. That can lead on some systems (Matrox) to
          problems. Here can this feature turned off.
/max:n    max. file size, n is a value in bytes. If file size or max. file 
          size by file system is reached a new file will be created whith 
          a number appended on the file name. e.g.:
          first file is file.wav
          next file  is file-001.wav
/app      append to a existing file, the file MUST exist
          audio parameter come from exist file
/nyc      no yellow color in VU-meter
/nrc      no read color in VU-meter
/ycl:n    level for yellow color in VU-meter (default is 85%)
/o        overwrite file
          

Misc parameters

/mv:n     set master volume in %
/v:n      set volume for playing or recording in %
/i:x      device number, default=0
/st:n     if recording the clock time where the recording started
          if playing the start time of file where the file played
/et:n     if recording the clock time where the recording ended
          if playing the end time of file where the file played
/ct:n     if recording the duration of recording
          if playing the duration of playing

times can be specified as hh:mm:ss.ms or ss.ms

example:
PlayRec /r test.wav /st:20:00:00 /et:22:00:00

record test.wav whith 44100 hz, 16 bit, stereo
recording started at 20:00 and ended at 22:00 


PlayRec test.wav /st:1:00:00

play test.wav at file time 1:00:00 until file ends

examples of times:

1:00:00     3600   seconds or  1:00:00 am
   1:00       60   seconds or  0:01:00 am  
      1        1   second  or  0:00:01 am

1:00:00.3   3600.3 seconds or  1:00:00.3 am
   1:00.3     60.3 seconds or  0:01:00.3 am
      1.3      1.3 seconds or  0:00:01.3 am

Keybord control:
You can control any functions via keyboard.

Always:

shift+cursor down   mastervolume lower
shift+cursor up     mastervolume higher
ESC                 end program
space               pause

Recording:
cursor down     recording volume lower
cursor up       recording volume higher

Notice, any soundcards or drivers change the volume not in
single percent steps, but in another step width.
The volume are is viewed in 1 percent steps.

Playing:
cursor down     play volume lower
cursor up       play volume higher
cursor right    1 second forward
cursor left     1 second back
page down       10 seconds forward
page up         10 seconds back
home            start of file
end             end of file
+               speed x 0.001 faster
-               speed x 0.001 slower
ctrl++          speed x 1 faster
ctrl+-          speed x 1 slower
0               normal speed
B               backward/forward
M               speed mode real/block

Notice, if any of keys used to change speed or position,
auto end at file end is disabled, You must use ESC to end program.

