Audio Function Generator, (AFG.sh).

   Author:       wisecracker.bazza at gmail.com (Barry Walker)
   Uploader:     Barry Walker
   Type:         dev/gg
   Version:      0.90.00
   Architecture: generic; m68k-amigaos
   Distribution: AMINET
   Date:         2023-07-21
   Readme:       http://aminet.net/dev/gg/AFG.sh.readme
   Downloads:    1

http://aminet.net/dev/gg/AFG.sh.zip

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

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/

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

Contents of dev/gg/AFG.sh.zip

Archive:  /home/aminet/aminet_root/doc//dev/gg/AFG.sh.zip
 Length   Method    Size  Cmpr    Date    Time   CRC-32   Name
--------  ------  ------- ---- ---------- ----- --------  ----
       0  Stored        0   0% 2023-07-21 14:29 00000000  AFG/
   32700  Defl:N     9477  71% 2023-07-17 17:55 3030d82f  AFG.sh
       0  Stored        0   0% 2023-07-16 14:52 00000000  AFG/16/
  524288  Defl:N     1145 100% 2023-07-16 14:52 886bdb0f  AFG/16/IPULSE
  524288  Defl:N     1164 100% 2023-07-16 14:52 e14adf7c  AFG/16/ISAWTOOTH
  524288  Defl:N     1145 100% 2023-07-16 14:52 2549921c  AFG/16/PULSE
  524288  Defl:N     1164 100% 2023-07-16 14:52 319b9bb7  AFG/16/SAWTOOTH
  524288  Defl:N     1160 100% 2023-07-16 14:52 457cce54  AFG/16/SINE
  524288  Defl:N     1145 100% 2023-07-16 14:52 65a82603  AFG/16/SQUARE
  524288  Defl:N     1161 100% 2023-07-16 14:52 04f040ff  AFG/16/TRIANGLE
       0  Stored        0   0% 2023-07-16 14:52 00000000  AFG/4/
  524288  Defl:N      635 100% 2023-07-16 14:52 578183c6  AFG/4/IPULSE
  524288  Defl:N      639 100% 2023-07-16 14:52 03216446  AFG/4/ISAWTOOTH
  524288  Defl:N      635 100% 2023-07-16 14:52 faa3cad5  AFG/4/PULSE
  524288  Defl:N      639 100% 2023-07-16 14:52 9c165189  AFG/4/SAWTOOTH
  524288  Defl:N      637 100% 2023-07-16 14:52 1a0d9a85  AFG/4/SINE
  524288  Defl:N      635 100% 2023-07-16 14:52 3559c1c8  AFG/4/SQUARE
  524288  Defl:N      637 100% 2023-07-16 14:52 2d291910  AFG/4/TRIANGLE
       0  Stored        0   0% 2023-07-16 14:52 00000000  AFG/64/
  524288  Defl:N     1697 100% 2023-07-16 14:52 71c4807e  AFG/64/IPULSE
  524288  Defl:N     1724 100% 2023-07-16 14:52 70c4ab23  AFG/64/ISAWTOOTH
  524288  Defl:N     1697 100% 2023-07-16 14:52 dce6c96d  AFG/64/PULSE
  524288  Defl:N     1724 100% 2023-07-16 14:52 a896947b  AFG/64/SAWTOOTH
  524288  Defl:N     1718 100% 2023-07-16 14:52 38b07946  AFG/64/SINE
  524288  Defl:N     1654 100% 2023-07-16 14:52 3bea69d9  AFG/64/SQUARE
  524288  Defl:N     1717 100% 2023-07-16 14:52 d5a265bf  AFG/64/TRIANGLE
   32700  Defl:N     9477  71% 2023-07-17 17:55 3030d82f  AFG/AFG.sh
    5545  Defl:N     2234  60% 2023-07-21 14:28 eb36d35d  AFG/AFG.sh.readme
   18431  Defl:N     5503  70% 2023-07-16 14:52 cacdb34b  AFG/Manual.txt
  524332  Defl:N     1205 100% 2023-07-17 17:38 e0bd283c  AFG/WAVEFORM.wav
--------          -------  ---                            -------
11623756            52368 100%                            30 files

Aminet © 1992-2023 Urban Müller and the Aminet team. Aminet contact address: <aminet aminet net>