********************************************************************* * * * _________________________ * * / /// / \ * * +-----------------------+ \ * * \ | \ | * * \ / , \ / * * +-OOOOOOOOOOOOOOOOOO----+ * * /|OOOOO§OOOOOOOOOOOOOO /| * * / OOOOOOOOOOOOOOOOOOOOOO/ | * * +-----------------------+ | * * | |o| | | * * | |A| | | * * | +-+ | + * * | | / * * | APFELKISTE |/ * * +-----------------------+ * * * * * ********************************************************************* * Author: Michael Böhnisch, * * Löher Str. 2, * * 4790 Paderborn (Germany) * ********************************************************************* * Requirements: iff.library Version 18.5 (or later) * * color.library -"- 1.0 -"- * * Kickstart -"- 37.175 -"- * * To re-build the program: Lattice/SAS C 5.10a * ********************************************************************* 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 requires KS 2.0 (37.175 or higher). 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). Since version 28 I've added the "AutoScroll" feature of the new intuition library. While "VIEWing" the picture or while drawing with Multitasking "ON", you now are able to scroll around the screen. The program should work with NTSC Amigas; I have not tested this, though. 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 regular floating point routines instead of mine. Just to show the difference, or if you want to be VERY exact at high degree zoom-ins. 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 tired more and more... you feel the urge to send a '040 card to the author of this program...] 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 to 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, but the machine will be blocked until completion of the drawing. COLORCYCLING Color animation while VIEWing on or off. *************************************************************************** Warnings are given as RECOVERY_ALERTS (orange 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. If a library like intuition or asl is requested, you probably don't have Kickstart 37.175 or above and should use the 1.3 Version of Apfelkiste. 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 most likely 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 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. ***************************************************************************