JAVAQUAT 1.6.0 INSTRUCTIONS

*TO JAVAQUAT*

Outline of Topics Below

  1. Quick Start
  2. Notes on Java (9-27-97)
  3. All the Controls in Detail
    1. Drawing Area Buttons
    2. Drawing Areas and the Mouse
    3. Saving your picture
    4. Argument Meanings
      1. Center R, i, j, and k
      2. Qo times R, i, j, and k
      3. Qo plus R, i, j, and k
      4. View Size
      5. Picture Size
      6. Power
      7. Sequence Depth
      8. Vertical Axis
      9. Horiz Axis
      10. Color Cyc.
      11. Shift amt.
      12. Pivot deg.
      13. Panels
    5. Argument Buttons
      1. Power and "Roll your own" Loop ID
      2. Set V-axis
      3. Number of Colors
      4. Fidelity
      5. 1 Big Canvas
      6. Auto Advance
      7. Pts/Pixel
      8. Scan on ...
      9. Swap H & V Axes
      10. I/O & Pivot
        1. Writing
          1. Saving Arguments
          2. Logging Arguments
          3. Saving a Picture
        2. Reading
          1. Reading Arguments
          2. Reading a Picture
          3. Initial Picture
        3. Creating a Zoom Sequence
        4. Creating a Pivot Sequence
        5. Other Pivot Manager Capabilities & Features
        6. Creating Large Images - Panels
      11. Edit Color Map
        1. Color Map Display
        2. The Color Map Editor Buttons
  4. Legal
  5. Bugs and Problems

Quick Start

What you should see when JavaQuat start is a blue area on the left and a green or gray area on the right. The blue area is where you can control the picture you are going to draw. I call it the blue argument entry area. The numbers and button settings for a given fractal will be refered to as the fractal's arguments. On the right are four (4) drawing areas (2 by 2). Each drawing area has three (3) buttons at the bottom.

Each drawing area comes with a set of arguments pre-loaded. If you click on the "Show Args." button of a drawing area the values for the pre-loaded picture, or the last picture that was drawn on it, will be displayed in the blue argument area. If you then click on a draw button the picture described in the blue area will be drawn. To see all the pre-loaded fractals, go to each drawing area, click on the "Show Args." button and then on the "Draw" button.

If you see something in one of the pictures that you would like to enlarge, drag the mouse across the area you want enlarged. A square box will be drawn where you dragged the mouse to show the section of the current picture that will be enlarged if you proceed to click on any draw buton. The values in the blue arguments area will change to indicate the new center and new "View Size".

If you want to change the size of the picture change the value in the "Picture Size" box, just above right center in the blue argument entry area. Values between 9 and 301 should be possible, though the upper limit may depend on your browser. If you want an even bigger picture, click on the button that says "1 Big Canvas". "Picture Size" can then be set as high as 609 on some browsers.


(Go to: Outline of Topics, Fractal Drawing Page)

Notes on Java (9-30-97)

The best that I've tried on Macintosh, PC, or Solaris is Apple's MRJ SDK (Software Development Kit) 1.5, just out for the Mac. It is fast and relatively bug free. For more detail on various Java implementations click here. JavaSoft is using some of the technology developed for Lisp and Smalltalk and hopes to soon have a really fast compiler.

I programmed in Lisp for a dozen years, and we had tools and techniques that C++ programmer have never even dreamt of. That and more is likely to come to Java in the next half dozen years or so, unless Microsoft succeeds in its plan to destroy Java. I'd much rather see Java destroy Microsoft, given a choice.

If you think you've found a bug that is my doing, please send email at lystad@iglobal.net describing the problem so I can fix it if I goofed.


(Go to: Outline of Topics, Fractal Drawing Page)

All the Controls in Detail

Read the "Quick Start" section above

Drawing Area Buttons

Each drawing area has three buttons at the bottom.


(Go to: Outline of Topics, Fractal Drawing Page)

Drawing Areas and the Mouse

To enlarge a section of a picture, drag the mouse across the section of interest. A white box will be drawn around the selected section and the appropriate argument values will be displayed in the blue argument area. Press any of the "Draw" buttons and the enlargement will be drawn in the corresponding area. If you did not mouse the exact area you wanted, try again. Refreshing the drawing with the "Draw" button, as described in the paragraph above, will erase the white box.

You can also simply click the mouse to display the coordinates of the point moused. They will be displayed in the four blue boxes labeled with the word "Center" at the top of the blue argument area. Pressing one of the "Draw" buttons subsequently will, of course, draw the same fractal re-centered to the newly moused point.

Saving your picture

If you are using JavaQuat from a browser your only option may be to do a screen capture. If you are using a Macintosh, you can save a screen image with Command-Shift-3. You Unix users probably have a key set up, or can set one up. PC users are on your own. Java security usually prevents my applet from writing pictures or anything else to your disk. However, Internet Explorer has a directory in which one can place applets that are trusted to not destroy your computer. You can place JavaQuat there, and then, I am told, you will be able to save pictures to your disk and read them back.

If you are using JavaQuat from an applet viewer that lets you turn off security restrictions on accessing your file system, or if you have downloaded JavaQuat and are running it as a standalone application (alone but for the Java VM) you should look at the "I/O & Pivot" section below.


(Go to: Outline of Topics, Fractal Drawing Page)

Argument Meanings

It would be helpful if you knew something about complex numbers and the generation of Julia Sets and the Mandelbrot set in order to understand what all the arguments mean. A basic understanding of Quaternions wouldn't hurt either. To that end you might want to read up on these topics. Links for documentation can be found at my Main Fractal Page. But if you don't know, and don't want to learn all that right now, I'll do the best I can to keep the explanation simple so you can use JavaQuat anyway.

For those of you unfamiliar with the above topics, you may want to skip ahead a paragraph or two.

JavaQuat originally drew only fractals of the form
Qn = Qn-1P + C * Q0 + T.
where Qwhatever, C, and T are either all Quaternions or all Complex numbers. The argument boxes let you select the center point of the picture, C, and T, each of which has four components labeled R, i, j, and k. If you are drawing in the Comples plane the j and k components will be unused. If you are drawing fractals in Quaternion space or any of the other 3 and 4 dimensional spaces available with JavaQuat they will very likely be used. The argument boxes labeled Center, Qo times, and Qo plus allow specification of the picture's center point, C, and T respectively.

The box labeled "Power" lets you specify P, the power. P may be any of the integers 2, 3, 4 or 5 currently. It also has another function that is described below under the topic Power Button. Briefly, the button can be set to "Loop Selector" in which case the box above it is relabeled "Loop ID". Various "Loop" methods define fractal functions in various mathematical spaces, including Hypercomples space and various others. If you know just a small amount of Java you can make your own "Loop" methods and so define any fractal you wish. There's no limit but the bounds of your imagination.


(Go to: Outline of Topics, Fractal Drawing Page)

Argument Buttons

There are various buttons in the blue argument area, among the argument boxes. Here's what they do.