Short:    portable audio system
Author:   lorylombus@gmail.com (Lorence Lombardo)
Uploader: lorylombus@gmail.com (Lorence Lombardo)
Type:     driver/audio
Version:  12-Aug-2020
Architecture: m68k-amigaos


PAS  (C) 2013-2020  Lorence Lombardo.


PAS provides extended functionality and parity to the following:-

"audio.device"
"ahi.device" 
"AUD" DOS device handler
"AUDIO" DOS device handler
Paula (without "audio.device" beta) 
Maestro (beta)

By using PAS you immediately provide support for all of these devices.

There is also a file output module which does require the "sndfile.library".

PAS reads from the standard input so I will be demonstrating how to use PAS
with the "APIPE:" device. But you may find an alternative way to use PAS.

PAS will read in one second chunks of audio asynchronously.

Usage:-

PAS <bit> <fre> <chan> [I|F|U|P]

I=intel, F=float, U=unsigned 8bit, P=priority [value] (default=1)

eg. copy motorola.cdr "apipe:pas 16 44100 2"

See "mp3_dec" and "ADPCM_dec" for examples of how to use PAS within a
program.

eg. mp3_dec test.mp3 !pas  OR  ADPCM_dec test.adpcm !PAS

The input bit width ranges from 8 to 32 bit integer. 

Also 32bit and 64bit is available for IEEE floating point audio.

The maximum output bit width of the file output module is 32bit.

If the specification is zeroed then PAS will look for an AIFF/C or WAV
header.

eg. oggv_dec test.ogg >"apipe:pas 0 0 0"

eg. opusdec --force-wav test.opus "apipe:pas 0 0 0"


PAS has no Ctrl-C breaking since that is the job of the program feeding in
the audio, but an EOF can be sent to PAS from CLI with Ctrl-\.


The default priority can be changed with the environment variable
PASPRIORITY.

I have done on my Amithlon system the following:-

setenv save PASPRIORITY 20

But that value could be too much for slower systems.

On earlier OS versions the equivalent would be the following:-

setenv PASPRIORITY 20
copy env:PASPRIORITY envarc:


In the case that it would be more advantageous to use the APIPE: device
indirectly the "pas.library" is provided. The "pas.library" also provides
some thorough checking and programs using the "pas.library" will also
require the PAS module shares the same path. Examples for the
"pas.library" have been provided for Blitz, AmigaE and C.


Future considerations:-

Add support for Christian Buchner's 14 bit audio driver.


PAS was developed and tested only on my Amithlon/WinUAE system.

Feedback about PAS operation is welcome.


URL's of related interest:-

http://aminet.net/package/util/shell/APipe_37_7
http://aminet.net/package/dev/basic/mp3_dec
http://aminet.net/package/mus/misc/ADPCM_dec
http://aminet.net/package/mus/play/Audio-Handler
http://aminet.net/package/mus/play/oggv_dec
http://aminet.net/package/mus/edit/opus_68k
http://aminet.net/package/driver/audio/m68k-amigaos-ahiusr
http://aminet.net/package/util/libs/sndfile
http://aminet.net/package/util/batch/madp
http://geocities.ws/lorylomb/