
EM81_Magic_Eye_AMIGA.sh

                          EM81 valve/tube Simulator.
                          --------------------------
(Apologies for any typos, etc...)

Architectures: Expanded AMIGAs, FS-UAE, WinUAE, Linux, (APPLE M SoCs?, WSL?).
-----------------------------------------------------------------------------

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

        AMIGA A1200(HD), with a fast as possible CPU, and 8MB FastRAM.
        WinUAE 3.4.0, minimum.
        FS-UAE 3.1.x, minimum.
        Standard AMIGA OS 3.1.x install or better.
        (It might work on AMIGA OS 3.0.x but untested.)

        Full ADE *NIX environment install, (full install on AMINET):
        https://aminet.net/package/dev/gcc/ADE<CR>
                       AND...
        Library file ixnet.library version 48.0
        Library file ixemul.library version 48.0
        Both files are here if you have NOT got them:
        https://aminet.net/package/util/libs/ixemul-48.0<CR>

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

Preamble:-
----------

<CR> is the ENTER/RETURN key.

This creation is an ASCII text mode, EM81, valve/tube simulator.
It simulates these valves/tubes EM81, (6DA5 and 65ME).
A video of a real one here:
        https://www.youtube.com/watch?v=H2zKvQkMx6A<CR>
The one on the right I have done years ago on AMINET:
        https://main.aminet.net/package/dev/src/AMIGA_Magic_Eye.py<CR>

As I do everything in fixed width ASCII text mode now, and not pixel width
graphics, then visual _ERRORS_ exist but are close enough within the limits
of a PAL, full width window, AmigaShell that can give 23 lines easily.
Therefore the AmigaShell window should be 23 lines by 77 columns MINIMUM.

For you _NTSC_ folks, the Shell Window should be a standard full sized one.
Running in a PAL system it suggests it WORKS fine, when tried with NTSC
dimensions. See the image in the 'Pics' drawer|directory|folder, or the
screenshot at:
          https://main.aminet.net/pix/misc/EM81_Simulator.png<CR>
The Shell ICON TOOLTYPE should have this line:
                   WINDOW=CON:0/0/640/200/Shell/CLOSE<CR>

Only the first four colours of the Workbench GUI are used, in my case, Black;
White; Light Grey; Dark Grey.
ADE shell *NIX style Escape Codes are used throughout.

On running the code, a very highly expanded AMIGA A1200(HD), (Fast CPU, and
8MB FastRAM minimum), is needed.
(It will be SSLLOOWW on a stock AMIGA A1200(HD) with 4MB of FastRAM.)
 
-----------------------------------------------------------------------------

How to use it:-
---------------

From the command line in ADE *NIX emulation, enter:
                  [/FULL/path/to/][./]EM81_Magic_Eye_AMIGA.sh<CR>
And away you go...
There will be one second bursts of each image in succession and will then run
straight into the animation...

There is another that is faster, BUT, requires the '${RANDOM}' variable
which is not part of POSIX, so has no 'shebang', (#!) at the start of the
script as it won't work with 'dash' or 'sh'. The known shells it does work
on are inside the script.

'/dev/urandom' is NOT part of a POSIX requirement so that can't be used, nor
'sleep <floating_point_number> either, 'sleep <integer>' is valid however.

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

Optional requirements not in the readme:-
-----------------------------------------
(This section can be skipped over.)

1) A Monitor or TV capable of PAL format for ease of use, see above for NTSC.
2) An AMIGA to SCART cable for those of number 1) above that have them.
3) Productivity Mode for Monitors that are available to make life easier.
4) An AMIGA to VGA adaptor with accessories to connect to number 3).
5) Borderless window:
          https://main.aminet.net/package/util/boot/MaxCli<CR>
   Call as:            MaxCli NOBORDER FULLSIZE<CR>

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

Have fun...

Bazza, G0LCU.

