Q U I C K   S T A R T
=========================================================================
UFO ONE KIT
http://www.CodeBrain.com
CodeBrainQuasar.class
01/08/2000

CREDITS

First and foremost, credit where credit is due!

THE ARTWORK

All of the artwork and much of the time-consuming applet tinker-
work is by Ralph Light of GhostGalleries.

You can currently visit Ralph's fantastic and robust gallery of graphics
at: http://ghostgallery.freeservers.com

THIS DOCUMENTATION

The full documentation for Quasar is at the end.  There's a lot you can
do with it, so look it over if you'd like to go further.  However, to get
this kit going on your page, *ALL YOU NEED TO DO* are these three
super-simple steps, below!



QUICK START INSTRUCTIONS TO INSTALL THIS KIT
=========================================================================
FOR THE UFO ONE KIT...

1.
From the included HTML page called cb_ufo1_demo.html, copy-and-paste
everything from the *first* <APPLET> tag to the *last* </APPLET> tag
into your page, exactly as is.

2.
Change the Link parameter to reflect the page you would like visitors
to be sent to when they click on the applet.  Make sure you use the
full form of the address, as shown.
               * -- OR -- *
If you just want to use this set decoratively, change the parameter
name Link to xLink in the code.  The applet will then ignore the para-
meter, and nothing will happen when a visitor clicks on it.

3.
Copy *your page* and *all five* files listed below to the SAME PLACE
(directory) on your server:

               cb_ufo1.au
               cb_ufo1_back.jpg
               cb_ufo1_float.gif
               cb_ufo1_fly.gif
               CodeBrainQuasar.class

Don't forget, class files must be sent up binary!

That's it, that's all there is, go to it!

Best regards,



The CodeBrain Staff



Q U A S A R :     F U L L   P A R A M E T E R    C H E A T    S H E E T   
=========================================================================
CodeBrainQuasar.class Version 01082000

Users of prior versions:  This new version does *not* require a key!
                          All other parameters remain the same.



GENERAL NOTES
-------------------------------------------------------------------------

// CodeBrainQuasar's code is written protectively -- to make it easy
// to set up and get running.
//
// Other than the "Notice" parameter and one image file (any one),
// you can leave out any parameter and the applet will run.
// That is, "If in doubt, leave it out!"  
//
// You can make the applet as simple as you wish, without the
// clutter and confusion of a multitude of parameters -- and then
// gradually build upward into more complex renditions.
//
// Parameter names are as descriptive as we can make them without
// having them a mile long, and they ARE case sensitive, so take care.
// On parameters with multiple values, make sure you put a value
// in each slot.
//
// Keep image files to the smallest dimensions and file sizes
// possible.  There's a great deal of redrawing going on -- so
// large images backload the applet and slow it down.
// (Note that the BackImage is NOT a traditional background image;
// it is just an image that sits in back of all others -- so keep
// that small, as well.)
//
// Good luck, and we hope you have a blast with CodeBrainQuasar.class.
// It's a remarkably flexible and powerful applet, well worth the
// small investment of time it takes to learn to use it well.
//
// Best regards,
//
// CodeBrain  





P A R A M E T E R S
=========================================================================



<param name="Notice"                 value="Applet by www.CodeBrain.com">
-------------------------------------------------------------------------
// Must be present, EXACTLY, or the applet will return an error message,
// saying "Notice param absent or incorrect!"



<param name="TimeConstant"                                  value = "50">
-------------------------------------------------------------------------
// Sets the overall speed of the applet.
// Smaller values are faster, larger are slower.
// Practical range is usually around 10-200.
// Getting started... try 50.



<param name="BackgroundColor"                        value="rrr,ggg,bbb">
-------------------------------------------------------------------------
// This sets the applet background color.
// Usual RGB format, values 0-255.
// Example: value = "255,0,0" would make the applet background red.



<param name="BackImage"                        value="imagefilename.ext">
-------------------------------------------------------------------------
// This image will sit at z-index zero, behind all others.
// The file can be a .gif, an animated .gif, or a .jpeg.
// Keep image files as small in dimension and file size as possible.



<param name="BackXY"                                         value="X,Y">
-------------------------------------------------------------------------
// Where the BackImage will be positioned, upper left corner of image.
// X is pixels across, Y is pixels down.
// Positioning at values less than zero or larger than the dimensions
//    of the applet will place it completely or partly off-screen.
// Example, if your applet is 200 wide and 300 high, value="100,150"
//    would position the BackImage upper left corner dead center



<param name="FrontImage"                       value="imagefilename.ext">
-------------------------------------------------------------------------
// This image will sit in front, on top of all others.
// The file can be a .gif, an animated .gif, or a .jpeg.
// Keep image files as small in dimension and file size as possible.


<param name="FrontXY"                                        value="X,Y">
-------------------------------------------------------------------------
// Where the FrontImage will be positioned, upper left corner of image.
// X is pixels across, Y is pixels down.
//
// Use integers, i.e., value="75,95"
//
// Positioning at values less than zero or larger than the dimensions
//    of the applet will place it completely or partly off-screen.



<param name="FloatImage"                       value="imagefilename.ext">
-------------------------------------------------------------------------
// The FloatImage is one of two active (moving) images in the applet.
//    It's z-index or layer is adjustable, to fall anywhere above
//    the BackImage and below the FrontImage -- see FloatZ.
//    
// There are a total of 9 modes of motion -- see FloatMode.
//
// The file can be a .gif, an animated .gif, or a .jpeg.
// Keep image files as small in dimension and file size as possible.



<param name="FloatXXYY"                value="Xleft,Xright,Ytop,Ybottom">
-------------------------------------------------------------------------
// This is a bounding box, dimensions in pixels.
// Xleft is as far as the image will travel left.
// Xright as far as it will travel right.
// Ytop as far up as it will go.
// Ybottom as far down as it will go.
//
// Use integers, i.e. value= "20,200,30,150)"
//
// You can use negative values and values greater than the size
//    of the applet... useful in moving the image off-screen



<param name="FloatZ"                                           value="0">
-------------------------------------------------------------------------
// FloatZ is at what depth (what layer) the FloatImage will be postioned
//    RELATIVE to the FlyImage (see below).
// For example, if you set up the FlyImage FlyHowMany (see below) for
//    seven images, setting FloatZ to "3" would cause the FloatImage
//    to hover between the third and fourth FloatImage



<param name="FloatMode"                                        value="0">
-------------------------------------------------------------------------
// The FloatImage has 9 modes of motion.  
// These modes are:
//    0 = static
//    1 = left to right
//    2 = right to left
//    3 = horizontal bounce
//    4 = top to bottom
//    5 = bottom to top
//    6 = vertical bounce
//    7 = circles clockwise
//    8 = circles counterclockwise
//    9 = random (moves pseudo-randomly through modes 1-4)

// Only modes *7,*8, and *9 have speed control; see FloatSpeed789 (below)



<param name="FloatSpeed789"                                   value="25">
-------------------------------------------------------------------------
// Sets how fast the FloatImage moves -- modes 7,8,9 only
// Larger values are faster; try 25 to get started.




<param name="FlyImage"                         value="imagefilename.ext">
-------------------------------------------------------------------------
// The FlyImage is the second of the two active (moving) images.
//    It creates multiple copies of itself (see FlyHowMany),
//    and has three main parameter sets to control how it moves.
//    All though all of the motion is based on Sine/Cosine (circular) 
//    relationships, changing these parameters results in 
//    a remarkable range of variation.
//
// The file can be a .gif, an animated .gif, or a .jpeg.
// Keep image files as small in dimension and file size as possible.



<param name="FlyHowMany"                                       value="3">
-------------------------------------------------------------------------
// How many copies the Fly Image will present.
// Practically, you probably want to keep this between 1-20 or so.
// Make sure you set FlySeparateMaxMinROC (below) so you can see.



<param name="FlyDirection"                                     value="1">
-------------------------------------------------------------------------
// Which direction the Fly image orbit will rotate.
//  0= ccw, 1 = cw



<param name="FlyCenterXY"                                    value="X,Y">
-------------------------------------------------------------------------
// This is the starting CENTER position of the image.
// The applet automatically takes into account the width and height of
//    the image!
// Thus, if you have an applet that is, say, 300 wide by 300 high,
//    value="150,150" will exactly center the image, no matter what
//    the image dimensions are.  (Say thank you.)



<param name="FlyOscillateXXYY"               value="Xmax,Xmin,Ymax,Ymin">
-------------------------------------------------------------------------
// This is the most important parameter for motion.  You WILL need to
//    experiment with it, and it DOES take some fiddling, though it's
//    very well behaved when you get the hang of it.
//
// Take NOTE... this is NOT a bounding box -- it is an oscillator, and
//   the values are for the limits.  The values are relative to the 
//   FlyCenterXY point, and they are the radii -- not the diameters --
//   of the circles/elipses that the FlyImage moves through.
//
//   Xmax - maximum to which the radius will expand, left-to-right
//   Xmin - minimum to which the radius will contract, left-to-right
//   Ymax - maximum to which the radius will expand, top-to-bottom
//   Ymin - minimum to which the radius will contract, top-to-bottom
//  
// Getting started... look at the demos included and work with them,
//    changing values a little at a time.
//
// Use integers, negative numbers are allowed -- with sometimes very
//   interesting results!



<param name="FlySpeedMaxMinROC"                       value="Max,Min,ROC">
-------------------------------------------------------------------------
// This adjusts how fast the FlyImage will move.
// Max is the maximum speed, Min is the minium speed, and ROC stands
//    for RateOfChange between the Max and Min speeds.  That is,
//    if you used value="20,2,11", the FlyImage would speed p to 20,
//    then slow down to 2 -- and the CHANGE in the speed would occur
//    at a RATE of 11.  This changing speed adds life to the applet,
//    and reduces the sensation of repetition.
// Again, work with the demos, changing this a little at a time.  The
//    effects can be starting.
// For a static (unchanging) speed, set Max and Min the same, and the
//    rate to any value; for example, value = "9,9,0"
// Decimal (i.e., 1.15) and negative values are allowed.



<param name="FlySeparateMaxMinROC"                   value="Max,Min,ROC">
-------------------------------------------------------------------------
// This adjusts how far apart each copy of the FlyImage will be.
//   (For those interested, the value is in radians.)
// Similar to setting up the parameter above, Max is the maximum
//   distance between images, Min is the minimum distance, and ROC is
//   the rate at which the distance between the images changes.  Work
//   with the demos!  Pushing the ROC up past 11 or so can have 
//   fascinating results.
// For a static (unchanging) distance, set Max and Min the same, and the
//    rate to any value; for example, value = "9,9,0"
// Decimal (i.e., 1.15) and negative values are allowed.



<param name="SoundFile"                         value="soundfilename.au">
-------------------------------------------------------------------------
// This is the name of a sound file you may optionally associate
//    with the applet.  There are three modes, see below.
// The sound file MUST be a standard, JAVA .au file.
// Keep the sound file as small as possible, especially for sync mode.



<param name="SoundMode"                                        value="1">
-------------------------------------------------------------------------
// The associated SoundFile (above) can be set to trigger in three
//   different modes, as follows...
//   1 = plays the sound only when the applet opens
//   2 = plays the sound continuously (loop)
//   3 = sync mode -- plays the file syncrhonized with FloatImage motion




<param name="StatusBarTextS"           value="Static status bar message">
-------------------------------------------------------------------------
// Optional, a text message the applet displays in the browser status
//    bar whenever the mouse is NOT over the applet.



<param name="StatusBarTextM"        value="MouseOver status bar message">
-------------------------------------------------------------------------
// Optional, a text message the applet displays in the browser status
//    bar whenever the mouse IS over the applet.



<param name="Link"                      value="http://www.codebrain.com">
-------------------------------------------------------------------------
// Optional, a link to which the applet will send the browser when you
//    click on the applet.  Make sure you use the full path, as shown!



<param name="Target"                                        value="_new">
-------------------------------------------------------------------------
// Optional, used in conjuntion with the Link parameter above.
// This is in standard syntax -- _new, _top, etc.; or the name of
//    the target frame if you are using a framed layout.










=========================================================================
The CodeBrainQuasar.class applet is (c) 1999,2000 by CodeBrain
All responsibility for use of the applet remains with the user.
