This example was created with the following HTML code:

<applet name="goround" code="goround.class" width=200 height=133>   <param name="images" value="images/fish/p000[1934-1957].jpg">   <param name="auto" value="1600"> <applet>

You supply multiple images of an object to GoRound, and GoRound will display your images in-order, which will give the effect of the object being rotated.

• The easiest way to add object movies to web pages and CDs -- quick start
• Object is displayed as it is loaded
• There is no plugin to be installed first!
• Very small (9k) cross-platform Java applet loads quickly
• Fully controllable via JavaScript -- details
• Actively supported, professional product -- release history
• Extensively tested under the major browsers for maximum compatibility

The following table describes the parameters that GoRound can use. In most cases, you will only need to use just a couple parameters, but it is nice to have total control when you need it.

For the GoRound applet, only the images parameter is required.

goround.class Java Applet Parameters
name	value	Description
images	URL	The URL to all the images of the object
view	Integer	The number of degrees covered by the images (default: 360)
auto	Integer	Auto scroll through all images in this many milliseconds (default: 0) [1.0c]
sauto	Integer	Auto scroll at startup in this many milliseconds (default: 1000) [1.1a]
cHelp	hex-color	Background color of help boxes (default light yellow: FFFFC0) [1.1c]
delay	Integer	Delay in milliseconds before auto rotate restarts (default: 30000) [1.2a]

Where the images parameter uses a technique to encode multiple images into a single URL that looks like:

image[1-20].jpg = image1.jpg,image2.jpg,...,image20.jpg fish[01-24].jpg = fish01.jpg,fish02.jpg,...,fish24.jpg

So, in the example above, "images/fish/p000[1934-1957].jpg" expands into 24 images, named "images/fish/p0001934.jpg" to "images/fish/p0001957.jpg".

hex-color: A color specified in 'RRGGBB' (red/green/blue) hexadecimal format. For example, 'FF0000' is pure red, '00FF00' is pure green, '0000FF' is pure blue, 'FFFFFF' is white, '000000' is black, 'CCCCCC' is light gray, etc. Please refer to http://www.utexas.edu/learn/pub/colors for a list of sample colors along with 'RRGGBB' values.

TIP: GoRound expects pictures in counter-clockwise order, but what if the pictures were taken in clockwise order? No problem. Just change the order of the numbers in the specification. For example, fish[01-24].jpg specifies counter-clockwise order. But fish[24-01].jpg specifies clockwise order.

Install the Demo: First download and install the GoRound demo (into a directory/folder of your choice) as the following steps assume you already have GoRound installed. View the readme.html file from the demo to verify that GoRound works. You will see a demo very similar to what you see above.

Preparation: Using a tripod is a must as the object will be moved between pictures, but you want the background to stay exactly the same. A light background helps to hilight an object (maybe by using a white sheet) and helps to reduce image size as very little background detail will compress very well. Plan on taking around 20 to 24 pictures (or more if you want to). With 24 pictures, your object will have to be rotated 15° after each picture. More pictures result in a less jerky result, but longer download times. Practice rotating your object. Can you rotate your object a small amount each time and have it return to its original position? A rotating platform is optional, but can yield superior results.

Picture Taking: Set up your object, tripod, and camera. Frame your object in the camera viewfinder so that what you see is what you want GoRound to display. Trust me, you don't want to do any image cropping. Take your pictures. A digital camera will make this step a lot easier. Remember to rotate your object counter-clockwise after each picture.

TIP: One client uses a cardboard disk, marked in half, quarters, etc, with a little slot in the middle and places it on a phonograph turntable. Then an object is centered on this stand, a picture is taken using a digital camera on a tripod, and the turntable is rotated by one mark. The process is repeated until all photos are taken.

Image Resizing: Transfer your images into your computer and one-by-one resize them all to a size that you feel is appropriate. You will also probably want to play around with resizing and saving a test image to discover the resulting file size. Aim for about 3k to 6k per image. Sequentially number each picture (eg: fish1.jpg, fish2.jpg, etc), saving them into a new directory/folder in the GoRound install directory (where you unzipped the goround.zip files).

View The Result: Run the HTMLGEN.EXE program (Requires Windows and Internet Explorer to be installed for Java support) from the goround.zip install directory/folder. This will allow you to create the HTML that is required to view your files with GoRound. Simply select the image group from your new directory/folder and press "Create and Test Now". Easy!

The GoRound applet can be controlled via JavaScript. The applet has a public function that looks like:

public void set( String name, String value )

Just use the same parameter names and values that are described in the applet parameter tables above.

In the sample applet above, changing the view between Fish, Shoe, and Car is accomplished via JavaScript. The applet is first named by using the name applet tag like: name="goround". This enables you to use JavaScript code like the following to change the image at any time:

document.goround.set('images','images/shoe/p000[1988-2007].jpg');   

1.2c - 01/04/2001 - maintenance release
1.2b - 08/17/2000 - compensate for bad web servers -- image load retry on errors
1.2a - 07/11/2000 - added 'delay' parameter
1.1c - 04/25/2000 - added 'cHelp' parameter
1.1b - 04/25/2000 - improved image loading times
1.1a - 04/17/2000 - fix several htmlgen problems
1.0c - 03/15/2000 - added 'view' applet parameter
1.0b - 03/11/2000 - now bundled with HTMLGEN.EXE
1.0a - 03/10/2000 - first offered for sale