********************************************************************* * * * _________________________ * * / /// / \ * * +-----------------------+ \ * * \ | \ | * * \ / , \ / * * +-OOOOOOOOOOOOOOOOOO----+ * * /|OOOOO§OOOOOOOOOOOOOO /| * * / OOOOOOOOOOOOOOOOOOOOOO/ | * * +-----------------------+ | * * | |o| | | * * | |A| | | * * | +-+ | + * * | | / * * | APFELKISTE |/ * * +-----------------------+ * * * * * ********************************************************************* * Author: Michael Böhnisch, * * Löher Str. 2, * * 4790 Paderborn (Germany) * ********************************************************************* * Requirements: arp.library Version 39.1 (or later) * * iff.library -"- 18.5 -"- * * color.library -"- 1.0 -"- * * To re-build the program: Lattice/SAS C 5.10 * ********************************************************************* The program is rated PD with the following restriction: If you change the source, please leave my name in it. I need that for my self-confidence. Comments, flames, flattery via E-Mail to: billy@uni-paderborn.de Please forgive me for my awkward english. Feel free to correct wrong spellings or grammatical catastrophes by yourself. ********************************************************************* Documentation: "Apfelkiste" is yet-another-mandelbrot program. It's not as fast as MandFXP (about 10% slower, in fact), but DAMNED fast anyway. This version is the last one runnable with KS 1.3. I have included it only for completness. Please send bug-reports for the 2.0 version only, since this is the only one I will work on int the future! The program can be run from Workbench or Shell just as you like. The only thing you should look for is the file "Apfel0.IFF". This should be located in the active directory and is loaded at start-up to get default settings of the graphics. Later on you can edit the configuration file "Apfelkiste.config", where you can choose another name for the picture file and change most of the program parameters. The configuration file will be searched in the active directory, in DEVS: and in S: (this order). Do NOT change the order or general format of "Apfelkiste.config" and don't insert white spaces, or this will most likely lead to malfunctions. A little requester appears where you can change the borders of the area to calculate. You can set these values by mouse as described later. Other settings that can be manipulated here are the maximal depth of iteration, a border of divergence, the size of your picture in dots and the color-resolution counted in bitplanes. The program chooses a "best match" of resolution and viewmodes, including EXTRA_HALFBRITE with 64 colors in Lo-Res. You also can calculate pictures that are too big to display on a normal screen (e.g. 1024x1024, 2 bitplanes). These can be looked at later with "Mostra" (to be found on another AmigaLibDisk). This should work with NTSC Amigas, but I was not able to test it. Beyond the text-gadgets you can see a panel with smaller switches: ABOUT Tells you who's done it and allows me to send some greetings. FXP Start of the generator in high speed mode. Fasten your seatbelts! FLOAT Same as FXP, but using Lattice IEEE Routines instead of mine. Just to show the difference. VIEW Make the request window invisible and show the set in it's whole beauty. If "Colorcycling" is turned on, there will be some additional action on the screen. [Look deep in my eyes, you're feeling sleepy more and more...] Return to the requester by pressing the left mouse button. MOUSE With left mouse button held down you can choose a rectangular area for magnification. (Zoom in) QUIT Just as it says... LOAD Load an IFF picture from disk. At the moment no data referring the Mandelbrot set are saved along with pictures. SAVE Save the newly calculated pictures to disk. PRINT Dump the picture to the printer. DEFLT Restore the default settings. COLOR A color requester is popped up where you can change the palette of the screen. MULTITASKING Switch it on or off. Off results in a speed-up of the calculations of about 15%, depending how busy your Amiga is with other tasks. COLORCYCLING Color animation while VIEWing on or off. *************************************************************************** Warnings are given as RECOVERY_ALERTS (red blinking rectangular at the upper end of your monitor, just like a GURU). These may result in abortion of the program, if the error was too severe too be corrected. (After freeing all used memory, of course) In detail: Can't open xxxxx.library Vxx.x+ One of the shared libraries was not available. Possibly you ran out of memory, or you're not up-to-date with your LIBS: directory. Copy the missing library to your LIBS: directory and try again after rebooting. Can't open screen Can't open window A screen or window can not be opened. You may have run out of chip-memory or intuition was not able to find enough continuous memory. The program tries to pop up the input window on the Workbench. No memory for filerequester Can't open printer port Can't open IORequest for printer The program was not able to allocate some internal structures. These errors should *NOT* occur! Nevertheless, if they DO occur you really should switch off your computer and reboot. There is probably more than one thing going wrong. IFF file not found The program tried to open a file that was not an IFF file or did not exist at all. If this warning comes up just after the start of the program, you probably did not copy the file "Apfel0.IFF" to the directory where you started "Apfelkiste", or you have edited the configuration file "Apfelkiste.config" and did a typo in the default name. Not an IFF/ILBM file The program tried to load a file that did not fit into the requirements of the standard IFF picture format (ILBM). Scrambled IFF file It was tried to load a picture file containing corrupted data. Can't find configuration file Apfelkiste was not able to lock on the configuration file and will use builtin default parameters. "Apfelkiste.config" is searched in the current directory, DEVS: and S: (this order). It is an editable ASCII file and is fairly self-documenting. Adapting it you should avoid changing the exact order of the entries and you should not insert white spaces or blank lines. *************************************************************************** BUGS none. *************************************************************************** SPECIAL FEATURES - Using FXP mode with VERY small areas of the plane lead to calculation errors because fixpoint resolution is limited to 2**(-24). Use FLOAT instead if you insist on going such deep into the set. ***************************************************************************