KFracPlus V3.04 - FREEWARE - (c) 1991-93 by Andreas R. Kleinert. All rights reserved. This program was written under OS V3.00 and is therefore fully compatible. It needs OS >= V2.04. This program needs : - the 'gadtools.library' V37+ (in "LIBS:") - the 'asl.library' V37+ (in "LIBS:") - the 'ak_gen0.libray' V37+ (in "LIBS:") - the 'icon.library' V33+ (in "LIBS:") - the 'mathieeedoubbas.library' V33+ (in "LIBS:") - the 'mathieeedoubtrans.library' V33+ (in "LIBS:"). Full AGA-Support via the AK_GEN0-Screen-Mode-Requester. Release Date : 20.06.1993 Copyright : =========== The program KFracPlus V3.04 and its documentation files are (C)opyright 1991-93 by Andreas R. Kleinert. All rights reserved. Disclaimer : ============ The author takes no responsibility for any results of the use of this program. This software is provided "AS IS" and there is no warranty of any kind, so that you use this software at your own risk. Distribution : ============== The program KFracPlus V3.04 is freely distributable (FREEWARE). You may copy it, if the copyright notice is left intact and all of its parts are included in the distribution. This program must not be included in commercial packages or commercial program collections without my written permission. This program must not be sold in any way, but it is allowed to take a nominal fee including the costs for copying. This program may be put on public domain disks or included in public domain disk libraries. Special permission hereby goes to Fred Fish's AmigaLib-Disks and the german series TAIFUN, FRANZ and TIME. This program may also be distributed via electronic mail and may be put into mailboxes as long as the redistribution conditions are respected in all points. By using or distributing this program you automatically agree to all of the above conditions and terms. Intention : =========== Up to this version you have the possibility to generate the following types of fractals : 1) Feigenbaum 2) Julia-Sets 3) Mandelbrot-Sets ("Apfelmännchen") Usage : ======= Julia-Set : ----------- 'ze_re' and 'ze_im' determine, which part of the fractal, which results out of the 'c_re' and the 'c_im' value, is shown. 'ze_re' influences the X-Coordinates, 'z_im' the Y-Coordinates. The 'Iteration' value determines the depth - the 'clearness' - of the picture, and the 'width' and 'height' are responsible for the size of the picture. Speed may be increased by selecting less colors, a smaller size or less 'Iterations'. Mandelbrot-Set : ---------------- 'c_re' and 'c_im' determine, which part of the fractal, which is always similarily, is shown. 'c_re' influences the X-Coordinates, 'c_im' the Y-Coordinates. The Rest is the same as with the Julia-Set. Feigenbaum : ------------ This implementation does not seem to be fully bug-free, but with the default-values it works ! Tooltypes and File-Keywords : ============================= Tooltypes "neutralize" File-Keywords. SCREEN_MODE=<0x........> Mode-ID (Hex-Number like in "C") SCREEN_WIDTH= (depending on Screen-Mode) SCREEN_HEIGHT= (depending on Screen-Mode) SCREEN_DEPTH= Colordepth of the Screens WINDOW_WIDTH= Width and Height of the Display- WINDOW_HEIGHT= Window on the Screen FEIGENBAUM_KMIN= (described above) FEIGENBAUM_KMAX= FEIGENBAUM_Q0= FEIGENBAUM_VALS= FEIGENBAUM_SKIP= MANDELBROT_C_REMIN= (described above) MANDELBROT_C_REMAX= MANDELBROT_C_IMMIN= MANDELBROT_C_IMMAX= MANDELBROT_STEPWIDTH= JULIA_Z_REMIN= (described above) JULIA_Z_REMAX= JULIA_Z_IMMIN= JULIA_Z_IMMAX= JULIA_C_RE= JULIA_C_IM= JULIA_STEPWIDTH= SELECTED= selected Fraktal-Type Correspondence : ================ If you like, you may send me some money. Perhaps this will motivate me to continue programming such programs or just making updates of this one. Send bug-reports, suggestions, money (!) or whatever to : Andreas R. Kleinert, Grube Hohe Grethe 23, D-57074 Siegen, Germany. Construction : ============== The graphical surface of this program has been created under use of the famous program "GadToolsBox V1.4", which is written and (C) by Jan van den Baard. KFracPlus makes use of : - the 'gadtools.library' V37+ (Workbench V2.04+) - the 'asl.library' V37+ (Workbench V2.04+) - the 'ak_gen0.libray' V37+ (FREEWARE, by me) - the 'icon.library' V33+ (Workbench V1.2+) - the 'mathieeedoubbas.library' V33+ (Workbench V1.2+) - the 'mathieeedoubtrans.library' V33+ (Workbench V1.2+) KFracPlus has been written in SAS/C V6.00 under OS V3.00. The first versions of KFracPlus have been written between July 1991 and April 1992. Those versions were still called only "KFrac" - without this "Plus". They were partially developed during a 'project week' at the G.A.L. (Gymnasium am Löhrtor) in Siegen. Thanks to all, who gave me the knowledge to write the first version of this program and to fix its (many) bugs !!! Explicitely thanks go to Mr. Schnell, Steffen Dingel and René Koch, who organized our project about 'chaos : fractals and their meanings' ! Turbo-Version ??? ----------------- This program already uses the Standard-Math-Libraries, which support the 68881/2-Coprocessors, but if you are interested in a special 68020/68881/2-Turbo-Version, you may contact me ! Background : ============ About the Mandelbrot- and Julia-Set : ------------------------------------- Mandelbrot and Julia are both some ways of a partially display of an object, which depends on 4 parameters. Mandelbrot uses fix 'z_re' and 'z_im' and displays the fractal as a graphic, where the x- and y-position depend from 'c_re' and 'c_im'. Julia uses fix 'c_re' and 'c_im' and displays the fractal as a graphic, where the x- and y-position depend from 'z_re' and 'z_im'. Both use the same (recursive) algorithm, which looks as follows : z_n+1 = z_new = z_n^2 - c This is transferred to a 'complex platform', where z_n and c are complex (imaginary) numbers : z_re_new = z_re^2 - z_im^2 - c_re (new real part for iteration) z_im_new = 2*z_re*z_im - c_im (new imaginary part for iteration) With this formula it is possible to describe the behaviour of the above recursive algorithm in a 2-dimensional way, where 'convergency' and 'divergeny' (don't know if these are the right words) are represented and marked with different colors (each pixel). History : ========= V3.04 : (20.06.1993, original-size : 41372 Bytes ------- and (68020-Version) : 41224 Bytes) - "crash-bug" fixed - remembering values when switching fractal-type - Load-/Save-Option - more failure-checks and error-requester - Window is now cleared before Feigenbaum-Zoom - Icon is written (Default-Tool depending on program version) - Tooltype-Support V3.03 : (April 1993, original-size : 26884 Bytes ------- and (68020-Version) : 26712 Bytes) - now with special "68020+"-Version V3.02 : (March 1993, original size : 26884 Bytes) ------- - use of SAS/C V6.00 - another fix of the OS V3.0-IDCMP_CLOSEWINDOW-gadtools.library-Bug (use "==" instead of "&" to check this bit !) - changes to the doc-file - use of "ak_gen0.library" V37+ and of its new ScreenMode-Requester, so that now ALL available ScreenModes (Std., ECS, AA) are useable - made use of some global optimizations (calcing- and IFF-ILBM routines) V3.01 : (March 1993, original size : 28716 Bytes) ------- - fixed bug in Screen-Requester : forgot to convert "depth" into "number of colors" - new Icon - WB-Console-Window will be closed. Side effect : If no Intuition-based error-report is possible, you'll get none (because no CLI available). - now checking legality of values for window-width and -height - there was a small bug in the setting-routine for the ColorDepth- Slider-Gadget. Under OS V2.04 there only occured wrong values, but under OS V3.0 the whole surface disappeared ! This bug is now hopefully fixed !!! - now runs as a Background-Task (using "cback.o") V3.00 : (February 1993) ------- - complete redesign of surface in general : - new Start-Panel, from which all other areas (Settings, Actions) can be reached - new OnLine-Panel - and more - separate Screens for Interaction and Drawing - ScreenMode-Requester, which allows to select between the following modes (non- and interlaced) : - Lores (max. 32 Colors) - Hires (max. 16 Colors) - Superhires (max. 4 Colors) - Productivity (max. 4 Colors) - VGA-Lores (max. 4 Colors) - VGA-ExtraLores (max. 4 Colors) - A2024 (max. 4 Colors) There may be more modes supported in the future. - removed CCRT and CRNG things in IFF-Support (neither necessary nor useful there) - more intensive use of "V37+"-Functions - Last not least : "ak_gen0.library" V36+ (with new FileRequester abilities and less bugs ...) - and more ... !!! V2.01 : ------- - Interlace did not work. Now it does. - Last not least : "ak_gen0.library" V35.106+. V2.00 : ------- - now under use of Jan van den Baard's famous program "GadToolsBox" (V1.4) and therefore only runable under OS V2.04+ - Fixed some bad garbage in Mandelbrot-routine (divergency-test) - IFF-Support-routine now is more general (internal thing) - removed stupid "symmetry" things of former versions (Julia, Mandelbrot) - lowest accepted version of "ak_gen0.library" now is V35+ - cleared DocFile - removed "Quadranian" - make use of some special OS V2.04-stuff V1.12 : ------- - This version is no longer PUBLIC DOMAIN, but FREEWARE - now its possible to save the Fractals as IFF-ILBM-Graphics (uncompressed and compressed, as you like) - some small speed improvements (Yeeeaaaahh !!! :) - added some Menus (to the Display-Screen), so that Intuition now is supported much more better - fixed some things in the docs (this one you are reading now) and in the program-internal docs - this release makes use of "ak_gen0.library" V35.21 (V34.xx still supported) V1.10 : ------- - improved and "debugged" the documentation in- and outside the program - integrated three new types of fractals : - Mandelbrot (also called "Apfelmaennchen") - Feigenbaum (hope, it functions correctly) - Quadranian (it bases on rectangles, and produces a strange kind of pattern -> not one of the 'usual' fractals) - improved some less important things V1.02 : ------- - improved speed of main algorithmus - making use of pragmas - making use of special code optimizations - some other small enhancements - now the number of colors used is changeable (2, 4, 8, 16) V1.01 : ------- - modified for use with "ak_gen0.library" (instead of "ak.library") - now support of double precision instead of single precision V1.00 : ------- - initial release pre V1.00 : ----------- - unreleased work versions (constructed mainly during a 'project week') Copyrights : ============ Some of the mentioned names or products above may be copyrighted by companies or trademarks of companies.