Mandelbrot Plotter Julia Plotter Version 3.03 Dated 28-Sep-1989 38 percent faster then the version 2.xx series. Any older versions and any demo versions should be replaced with the versions in this package. Neil B. Breeden II 9016 S. Goddard Cr. W. Jordan, Ut. 84088 The Mandelbrot and Julia programs described in this document are Copyright 1989 Neil B. Breeden II and Oquirrh Mountian Digital. All rights reserved. Special thanks to Arlan Davis for his modifications to my code. Arlan's edits achieved 22% faster code. Released as Freeware by the Author as long as the document files, all four executables and the example DESKTOP.INF are kept together and are not altered in any way. This package may be distributed in Public Domain collections as long as the Freeware notice items above are followed. These programs are now free. (As of this date no one has registered.) If you would like the latest version of these programs plus the following: Bifurcation Plotter programs. Plot Bifurcation diagrams in COLOR and MONO. Biomorph, Some of them look like single cell animals. COLOR and MONO also. Send $20.00 to the address above. The sources are also availible. They are written in Mark Williams C. The complete set is $60.00. This covers Julia, Mandelbrot, Bifurcation and the Biomorph programs. (The executables are also supplied in this package.) Thank You, And have fun!!! Neil Breeden. ---------------------------------------------------------------------------- After all files are dearchived you should find the following: DOCUMENT.TXT (You'r reading it) TRY_ME.TXT Coordinates of interesting areas to plot. JUL_SIN.PRG Single screen Julia plotter for all resolutions. MAN_SIN.PRG Single screen Mandelbrot plotter for all resolutions. JUL_MUL.PRG Multiple screen Julia plotter for all resolutions. MAN_MUL.PRG Multiple screen Mandelbrot plotter for all resolutions. DESKTOP.INF Suggested DESKTOP.INF file, Use this one to set up the colors for the desktop, this was supplied too me by Arlan Davis. (Personally I love his choice of colors, they are a MAJOR improvment to the plots. Neil) ---------------------------------------------------------------------------- Instructions for JUL_SIN.PRG and MAN_SIN.PRG (Single Screen programs) After running the program you will see the title screen and will be asked for several numeric inputs, follow the on screen examples to get a feel for inputting the control data into the program. After inputting the control parameters the screen will clear and the requested plot will begin to be generated. Anytime during the plot LEFT clicking will produce the following Alert Box: (Note, if Infinity is set high or max loop is set high you may need to click several times before the following menu appears.) n.nnnnn% done. [Abort] [Cont] The n.nnnnn% done will give you an idea how far along the plot is. Clicking on [Abort] will take you to menu (0). Clicking on [Cont] will continue plotting the current screen. (I added this because my CAT loves to sit on my mouse, I became very tired of my cat aborting the run for me. Neil) menu (0) Whats Next [EXIT] [ZOOM] Clicking on [EXIT] takes you to menu (1), this allows you to end the program. Clicking on [ZOOM] allows you to select a section of the screen to zoom up, follow this sequence to select an area to ZOOM: A set of crosshairs appears in place of the mouse pointer. Place the crosshairs over the UPPER RIGHT HAND corner of the area you wish to zoom. PRESS and HOLD DOWN the Left Mouse Button. While holding down the Left Button drag the mouse down and to the right. When the outlined rectangle that is being drawn as you drag the mouse surrounds the area you wish to zoom release the Left Button. See entry for menu (2) menu (1) Are You Sure [EXIT] [ZOOM] Clicking on [EXIT] takes you to menu (4). Clicking on [ZOOM] allows you to select an area to ZOOM. See the section under menu (0) to preform the zoom. menu (2) Do the ZOOM [YES] [NO] Clicking on [YES] takes you to menu (3). Clicking on [NO] takes you to menu (0). menu (3) Save this Picture with the area to be zoomed outlined. [YES] [NO] Clicking on [YES] will outline the area to be zoomed on the current screen. It will then save a Degas PI* picture. The screen then clears and the area to be zoomed will begin to be plotted. Clicking on [NO] will clear the current screen. The area to be zoomed will then begin to be plotted. menu (4) BYE [bye] This menu tells you the program exited ok. Click on [BYE] to get exit to the desktop. menu (5) Display program parameters on screen [YES] [NO] This menu is displayed after a plot has COMPLETED being drawn! Clicking on [YES] takes you to menu (6). Clicking on [NO] takes you to menu (7). menu (6) You will be given instructions to remind you how to place the parameters on the screen. Click on [OK]. Follow this sequence to place the parameters on the screen: Left click/HOLD down the left mouse button. An outlined rectangle will appear on the screen. This rectangle shows you the area the text will cover on the screen. Move the mouse around while holding down the left button to position the rectangle on an area of the screen were you will cover up the least amount of detail on the screen. Release the left button and the parameters are drawn on the screen. Procede to menu (7). menu (7) Save Degas Pic [YES] [NO] Clicking on [YES] will save a Degas PI* file, menu (0) is next. Note: you will have a second chance to save the current screen after you select an area to ZOOM. Clicking on [NO] also takes you to menu (0). menu (8) Disk is full. Put a formatted disk in the drive. [OK] Remove the current disk from the drive you ran the program from. Replace it with a FORMATTED disk. Click on [OK] to continue with the program. menu (9) Sorry Delta X or Y = 0.0 Aborting run! [OK] You have either defined an area to plot where the X or Y axis values are the same or by zooming you have reached the limits of the ST's math routines. Click on [OK] and an message will appear telling you the program exited due to an error. ---------------------------------------------------------------------------- The filenames used to save the various pictures are as follows: For Julia's the file names will be JULn.PIr. For Mandelbrots the file names will be MANn.PIr. n will be a number from 1 to 999, the program will search for an unused name starting with JUL1.PIr, then JUL2.PIr until an unused one is found, the picture will be saved to this file name. (NOTE: For the mandelbrot program the names will be MAN1.PIr, MAN2.PIr etc.) r is the current screen resolution, 1 = low, 2 = medium and 3 = high. ---------------------------------------------------------------------------- Instructions for JUL_MUL.PRG and MAN_MUL.PRG (Multiple screen programs) The inputs to these program are the same as the single screen programs. The differences are as follows: 1. Zoom mode is not used, clicking anytime during the run aborts the entire run and returns you to the desktop. (You may need to click several times to get the program's attention.) 2. These versions allow you to make poster sized plots and single page plots that use the resolution of your printer (With a driver you will need to write unless you have an OKIMATE 20 and the Cyber Paint package by Larry Bergan, see text at the end of this file). If you have Degas Elite and the Degas printer driver for your printer allows you to hold down the Alternate Key to cause the picture to be printed sideways then you are set. Poster size plots are just a few days away. Load up an entire column of pictures into Degas, Select the TOP picture, hold down ALTERNATE, click on print pic. The top pic is printed. Select the next picture down, ALTERNATE/CLICK to print it. Do all the pic's in the column. Do each column. Trim the columns, tape them together and you've got poster sized plots. What does Multiple mean? It means multiple screens are used. Two of the control parameters you are asked at program startup are how many rows and columns of pictures you wish to break the plot up into. 4 rows by 6 cols is a good number for single page plotting. This gives you 1280 by 1200 resolution. Each plot generated will be maned name in the format: RrCc.PIt. r is the row number, c is the column number and t is the current screen resolution, 1 = low, 2 = medium and 3 = high. For a 4 row by 3 column matrix of low resolution pictures the layout is: R4C1.PI1 R4C2.PI1 R4CL.PI1 R3C1.PI1 R3C2.PI1 R3CL.PI1 R2C1.PI1 R2C2.PI1 R2CL.PI1 R1C1.PI1 R1C2.PI1 R1CL.PI1 Notice that the higher row numbers are above the lower row numbers. *********** NOTICE: Version 2.07 update notice, please read ************** Watch you disk space carefully, plan ahead for big plots, floppies can store a limited number of picture files per disk. Single sided disks (360K) can store 10 picture files. Double sided disks (720k) can store 21 picture files. NOTE: Each saved picture uses 32034 bytes. The program always saves the files to the disk and folder the program was ran from. If you are running from a hard drive make sure you have enough free space. *********** NOTICE: Version 2.08 update notice, please read ************** If during the run you click to abort the run some of the picture files may have been completed. (This applies also if the power goes out.) You will find a file called PARAMTRS.TXT, print it or write down the values in it. It contains the input parameters you supplied the program. With these values in mind double click on the program to run it. Reenter the values as they were entered before. If a picture file already exists an alert box will appear telling you that the file already exists and will not be replotted. Click on the OK box. For each picture file this alert box will appear. Once the program finds the spot where it's execution was aborted earlier it will begin to replot that screen. It will continue to run as if it hadn't stopped from this point on. NOTICE: Due to the restart ability discussed in the above paragraph you need to be a little carefull when creating new multiple picture plots. Before the program is run copy any picture files to another disk or folder if you wish to keep them. Delete any RrCc.PIn files from the disk and folder the program is to be ran from. Double click the program to run it. The correct new picture files will be saved this way. If any RcCc.PIn files are found that happen to correspond with the name the program needs to use that screen will be lost. *********** NOTICE: Version 2.09 update notice, please read ************** Fixed bug causing mouse pointer to be displayed during the input of the control parameters. Added another alert box, if during a plot you click you now get an alert box that allows you to ether ABORT or CONTINUE the run, it tells you info also about how far into the run you are. ********** NOTICE: Versions 2.10 to 2.99 were never released. *********** Many bug fixes. Many enhancments. Many many Many debug runs. ******************** NOTICE: Version 3.00 update. *********************** Each program will now check the resolution it's ran from and will auto configure to it. Incorporated Arlan Davis's edits to increase preformance. Run time was decreased by 22%. ******************** NOTICE: Version 3.01 update. *********************** Made edits to speed the program up. I stripped another 16% from the run time. (This was on top of the 22% from 3.00.) Version 3.00 series is 38% faster than the 2.00 series. ******************** NOTICE: Version 3.02 update. *********************** Another minor fix. Doc's updated. ******************** NOTICE: Version 3.03 update. *********************** Changes to the DISPLAY PARAMETERS on screen mode. The change is simple. The rectangle displayed to indicate the size of the area the text will occupy now is set to be the same size as the actual text. Before a default size was used, it was not allways big enough. ---------------------------------------------------------------------------- Finally, the Low and Medium resolution programs were written for use with Cyber Print. This program can print Spectrum 512, NEO and Degas pictures on the OKIMATE 20 printer with the Atari ST interface. Personally I find the best feature of Cyber Print to be its ability to print up to 32 low resolution pictures on one page in color using full screen resolution. By using the ***_MUL.PRG versions mentioned above you can get spectacular printouts in full color. Cyber Print was written by Larry Bergan and is availible through Antic Software, 544 Second Street, San Francisco, CA. 94107 (415)-957-0886 or your local Atari software dealer. Of course, Degas, Cyber Print, Spectrum 512 and the Okimate names, programs and hardware are copyrighted by there authors/publishers/manufactures. ---------------------------------------------------------------------------- Bugs, If you find one drop me a note. Try to describe everything that was going on. If it crashes let me know, I ask your forgiveness in advance. ---------------------------------------------------------------------------- I (Neil Breeden) make no warranty of any kind in respect to this manual and the software described in this manual. The user assumes any risk as to the quality and performance of this product. In no event will I be liable for direct, indirect, incidental or consequential damages resulting from any defect in the performance and use of this product. ---------------------------------------------------------------------------- Finally I can be reached on GEnie. My mail ID is: N.BREEDENII -------------------------- End of the Doc's file ---------------------------