Short:        Audio Function Generator, (AFG.sh).
Author:       wisecracker.bazza@gmail.com (Barry Walker)
Uploader:     Barry Walker
Type:         dev/gg
Version:      0.90.00
Architecture: generic; m68k-amigaos
Distribution: AMINET

============================================================================

Architectures: Classic AMIGAs, FS-UAE, OSX 10.15.7, Linux Mint 21.2.
--------------------------------------------------------------------

  MINIMUM Requirements Are:-
  --------------------------

  1) Amiga environment:-
       Stock AMIGA 1200 with HDD and 4MB FastRAM.
         (!!! RECOMMENDED !!! -> 68030-FPU and at least 8MB FastRAM.
         It will run much faster and better however with more FastRAM,
         serious expansion cards, etc...).
       FS-UAE on OSX 10.15.x, AND, Linux Mint 20.3/21.1.
       Standard AMIGA OS_3.0.x install or better.
  2) Apple OSX 10.15.x using the default terminal and shell ONLY.
  3) Linux Mint 20.3 using the default terminal and shell ONLY.
  4) It has NOT been tested on WinUAE, CygWin, Android, and WSL but it might
     just work.
     (AFAIK, Android and CygWin supposedly have 'paplay'.)

----------------------------------------------------------------------------

  History:-
  ---------

  22-07-2023.
  -----------
  Version 0.90.00: A taster upload to see if anyone is interested...

----------------------------------------------------------------------------

  Other minimum requirements depending on what you decide to use:-
  ----------------------------------------------------------------

  Play16, two versions the lower one includes a 68000 version,
  and also supports AHI if need be...
    http://aminet.net/package/mus/play/Play16
    http://aminet.net/package/mus/play/Play16_v1.9
    http://aminet.net/package/dev/c/AsyncIO
  ADE, the *NIX _emulator_...
    http://aminet.net/package/dev/gcc/ADE
  ...and its dependency...
    http://aminet.net/package/util/libs/ixemul-48.0 
  ...no other dependencies are needed.

  Other OSes, (for example, OSX 10.15.x and GNU/Linux flavours), ONLY
  require the shell script itself inside your '${HOME}' directory for full
  usage. It has to be executable so use 'chmod 755 AFG.sh' to execute it,
  and run it in the usual manner from your '${HOME}' directory:-
    Your_prompt$ ./AFG.sh
  Then follow any on screen prompts.

----------------------------------------------------------------------------

  General:-
  ---------

  (Apologies for any typos, etc...)
  This is an Audio Function Generator that creates, SINE, SQUARE, TRIANGLE,
  PULSE, INVERSE_PULSE, SAWTOOTH, and INVERSE_SAWTOOTH waveforms.
  It uses any 'default' command line audio players, and, was primarily
  designed for the minimum of the AMIGA requirements that will play '.WAV'
  files within the limits of the AMIGA, see the manual.

  !!! IMPORTANT !!!
  The waveforms are NOT _pure_ but good enough for home use, especially for
  a real classic AMIGA A1200(HD) with 4MB fastRam. Under enulation this may
  be different so be aware.
  I have no idea what the other platforms wave shape accuracies will be
  like as every platform and hardware is different in some way, but again
  these waveforms will be good enough for amateur usage.
  !!! END_IMPORTANT !!!

  The AMIGA has no default player but I chose 'Play16' as it works well
  enough for this application.
  ONLY 8 bit Unsigned Integer, Mono, at various Sample Rates, '.WAV' files
  are created _on_the_fly_ in this archive.

  !IMPORTANT! ONLY the ASCII characters, SPACE to TILDE, are used to create
  the waveforms giving 95 possible _values_, so you only need a text editor
  to create your own waveforms.

  Other OSes have 'afplay' for OSX 10.15.x, 'aplay' for ALSA, and 'paplay'
  for PulseAudio. If you have none of these then there is 'music123' for
  a multitude of GNU/Linux flavours to do the same job, it is already in the
  script but commented out unless you need it, just uncomment the section
  save and re-run the script.

  Enjoy...

  Bazza...

----------------------------------------------------------------------------

                                IMPORTANT:-
                                -----------

    The Legal Stuff:-
    -----------------

    This archive is GPLv3 licenced.

    The authors are not responsible for any damage to, or loss of, or
    failure of equipment or data caused in any way by the use of this code.

    There is NO warranty with the use of this software release and
    YOU USE IT AT YOUR OWN RISK.

----------------------------------------------------------------------------

    Testing Evaluation:-
    --------------------

    FS-UAE and Classic AMIGA test conditions were/are running standard
    OS 3.0.x, 4MB FastRAM and using standard ~topaz 8~ fonts throughout.
    A stock AMIGA A1200(HD) can be a little jerky hence the addition of
    FastRAM. It will run much faster and better however with more FastRAM
    and serious expansion cards.

    I have no idea what strange configuration setups will create so refer
    to the ~The Legal Stuff~ above.

----------------------------------------------------------------------------

    Barry Walker, G0LCU.

----------------------------------------------------------------------------

    A very useful HardWare related site, (C) Anthony Hoffman, for
    modifications, schematics, repairs and the like is:-

                          http://amiga.serveftp.net/

============================================================================