============================================================================
Architectures: Classic AMIGAs, WinUAE, FS-UAE, Linux, APPLE, (Windows WSL?)
---------------------------------------------------------------------------
(Apologies for typos, etc...)
(<CR> is the RETURN/ENTER key.)
MINIMUM Requirements Are:-
--------------------------
Amiga environment:-
-------------------
AMIGA A1200(HD), with as 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>
Screenshot here:
https://main.aminet.net/pix/misc/EM81_Simulator.png<CR>
Other systems:-
---------------
Works on, (current, as of 23-01-2026), GNU/Linux Mint 22.3 terminals.
Also Works on Apple OSX 10.15.7 terminal.
I have no idea whether it works on WSL as I am really not interested,
therefore you try it out at your own risk!
Also not tested on CygWin but 'mintty' should be 24 lines by 80
columns for testing, and again, you use it at your own risk!
Also I have NO access to any APPLE 'M' series HW, so I have no idea
whether this works or not inside their current terminal[s]; there is
no reason why not however.
----------------------------------------------------------------------------
History:-
---------
01-02-2026.
-----------
Version 1.00.00. Probably the one and only upload for this archive.
============================================================================
Consider this readme as a small part of the 'Extra_Notes.txt' file:
-------------------------------------------------------------------
This code recipe, DEMO, is an EM81 Magic Eye tuning indicator animation.
It requires a minimum terminal/shell_window size of 23 lines by 77 columns,
_easily_ obtainable on full sized windows for AMIGA NTSC, and PAL, default
shells.
Some things about POSIX that made me use a 'while' loop for a fractional
delay timer, and a random number generator, inside this POSIX recipe.
1) '/dev/urandom' and '/dev/random' are undefined in POSIX, and don't even
exist under ADE emulation.
2) 'sleep <integer>' IS valid POSIX, 'sleep <floating_point>' IS NOT valid.
3) The '${RANDOM}' variable is also not part of the POSIX requirement, hence
I use a subset of my 'WH_RANDOM' upload here on AMINET:
https://main.aminet.net/package/dev/gcc/WH_RANDOM.sh<CR>
This is fully POSIX compliant.
4) The 'expr' utility is considered as part of POSIX and so is allowed.
"Also note that this volume of POSIX.1-2017 permits implementations to
extend utilities."
Source:
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/expr.html<CR>
5) The '/bin/true' utility is fully POSIX compliant.
6) The 'uname' utility is fully POSIX compliant.
7) The _builtin_ 'printf' uses octal values as hexadecimal values are NOT
POSIX compliant.
Everything I do for the Shell nowadays HAS to be POSIX compliant, INCLUDING
any utilities I use. If ANY utility is available in the '/usr/bin/'
drawer/folder/directory it has to be POSIX compliant before I use it.
THIS IS TO DELIBERATELY MAKE LIFE DIFFICULT!
There are two scripts in the code......
1) EM81_Magic_Eye_AMIGA.sh:
This is absolutely fully POSIX compliant but is the slower of the two
scripts. It uses a small subset of my 'WH_RANDOM' upload to AMINET.
See above for the URL.
2) EM81_Magic_Eye_AMIGA_Orig.sh:
This is not absolutely POSIX compliant as it uses '${RANDOM}' which is not
part of the POSIX requirement. The script does NOT have a shebang start
line and can be invoked using, 'ksh', 'zsh', or 'bash'.
It is about 50% faster than the fully POSIX version above.
The archive shows three images, two for the AMIGA and one for GNU/Linux Mint
Cinnamon.
Read the scripts, and 'Extra Notes.txt' for more information.
----------------------------------------------------------------------------
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>
============================================================================
IMPORTANT:-
-----------
The Legal Stuff:-
-----------------
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:-
--------------------
All WinUAE, FS-UAE and Classic AMIGA test conditions were/are running
standard OS 3.1.x and using standard ~topaz 8~ fonts throughout. The
minimum hardware requirements ARE needed however.
I have no idea what strange configuration setups will create so refer
to the ~The Legal Stuff~ above.
----------------------------------------------------------------------------
Barry Walker, G0LCU.
Email:- wisecracker.bazza@gmail.com
----------------------------------------------------------------------------
A very useful HardWare related site, (C) Anthony Hoffman, for
modifications, schematics, repairs and the like is:-
http://amiga.serveftp.net/<CR>
============================================================================
Enjoy...
Bazza, G0LCU.
----------------------------------------------------------------------------
|