SlideShow

SlideShow.zip


What is SlideShow?

SlideShow automatically cycles through each window giving a slide show presentation effect. Only one window will display at a time and each will pop up automatically as the applet cycles through them. 


SlideShow Error Messages  

The applet is designed to tell you when it's not set up properly by displaying error messages in the browser’s status bar, so please make sure your browser’s status bar is enabled 

For example, if you get a this or a similar error message: 

error: appletColor value="null" 

this means the applet cannot locate a required parameter, in this case "appletColor". To correct this, just add the parameter to the applet code. 

There is one situation in which the applet will not display an error message. This is when a specified image is not found by the applet. Use the "image" parameter to tell the applet the name of the image, take care to spell the image name correctly in this parameter, upper and lower case matter. Then put the image in the same directory as the applet class files. While the applet is loading images, it will display the message: loading.... If the applet displays this message for an unusually long time, or finishes loading but does not display the image, this could indicate that the applet could not find the image file. 


Easy setup 

The easiest way to set up the applet on your page is to use the sample applet code provide in the file slideShow.html. Cut and paste and the HTML code from one of these files into your own HTML file (from the <applet> to the </applet> tag). Then try it out and customize the parameters for your site. 


Applet parameters 
 
width and height: 
Change the width and height to indicate the size of the applet. 

windows:  
This parameter names and identifies the applet's windows. You may choose any name you want, and enter as many as you want, but make sure each name is separated by a semicolon. There also must be a semicolon at the end.

Each window must have a unique name. 
For example: 

<param  name=windows value="msSub1;msSub2;msSub3;msSub4;msSub5;> 

The above parameter tells the applet there are 5 windows to cycle through.  Only one window  will appear at a time and will take up the entire applet real estate. 

appletColor:  
This is the background color of the applet, this is usually the same color as your HTML page. 

slideShowPause:  
This is the number of seconds to pause while cycling through the windows during a slide show. Each window will slide to the top, pause for this amount of time, and then slide down. This is entered in seconds. 


Window parameters 

All the parameters below control the individual window presentation. These parameters must be set up for each window. For example, if you have 2 windows ALL these parameters must be set up TWICE, once for each window. Precede each parameter with the window name followed by a dash. For example, if a window is called msSub1, the "numberOfLines" parameter should be entered like this: 

<param name=msSub1-numberOfLines value="12"> 

numberOfLines:  
This is the number of lines to display. 

background:  
This is the background color of the window. You may specify the color either by color name or by RGB color values. You may use any one of the following color names: 

  • Black
  • blue
  • cyan
  • darkGray
  • gray
  • green
  • lightGray
  • magenta
  • orange
  • pink
  • red
  • white
  • yellow.

Or, you can specify the red, green, and blue values for a unique RGB color. Just specify the three numbers from 0 - 255. Each number must be separated by a comma. 

For example the following specifies the color red: 

<param name=msSub1-background value="255,0,0"> 

lineSpace:  
This controls how much space is between each line vertically. 

linkFrame:  
This controls which HTML frame to use when a hyperlink is clicked. Use this parameter like the HTML Target attribute. Set the value of this parameter to the name of the frame in which you would like the link to open. You may also specify one of the following standard values:

  • _self   - load in current frame. 
  • _parent - load in parent frame. 
  • _top    - load in topmost frame. 
  • _blank  - load in new unnamed top-level frame. 
scrollDelay:  
This controls the speed of the scroll, the lower the number the faster it scrolls.

linkColor:  
This controls the color of the hyperlink line when the mouse is placed over the line. Colors supported are the same as background. 

linkClick:  
This is the number of times to click on a hyperlink line. Use either 1 or  2, for a single or double click. 

image:  
This is the name of the image file used for the window background. Put the image in the same directory as the applet class file. Take care to spell this correctly, upper and lower case matter. 

imageCenter:  
If using an image, this will center the image in the applet. Enter a yes to center the image. Enter no and the image will not center.

If the image is not centered, and it is smaller than the applet size, then the image will be automatically tiled.

border:  
This parameter indicates what type of border is to be drawn around the window. The following values apply: 
 

  • line -     draw a one pixel line around the window. 
  • down - draw a 3d border around the window that appears lowered. 
  • up   -    draw a 3d border around the window that appears raised. 
  • no   -    no border around the window. 
For example, to create a raised border for window msSub1, use the following code: 
<param name=msSub1-border value="up">

borderColor: 
The border will be drawn in this color. Colors supported are the same as background. 


Window default parameters 
 
sizeDefault: 
This is the default text size for each line. 

lineDefault:  
This is the default text that is displayed for each line (usually the default is blank, and 
this is overridden). 

colorDefault:  
This is the default color for all lines. Colors supported are the same as for the background parameter. 

fontDefault:  
This is the default font for all lines. Use one of the following: 

Dialog 
Helvetica 
TimesRoman 
Courier 

styleDefault: 
This is the default font style for all lines. Use one of the following: 

PLAIN 
ITALIC 
BOLD 

linkDefault:  
This is the default link for all lines (the default is usually blank). Enter as a standard URL:  http://www.consultcom.com 

or 
use a relative link: 
../mypage.html  

lineOffsetDefault:  
This is the default starting position for all lines (starting at position zero). 


Optional parameters (controls each individual line) 
 
These parameters are almost the same as the default parameters. Just replace the word 'Default' with the line number. For example, to change the default text for the first line of the msSub1 window, use the parameter 'line1': 

<param name=msSub1-line1 value="consulting.com, Inc."> 
 
Other line parameters (the line number must appear after the parameter)  
 
separator:  
This will draw a horizontal line separator on the applet. Enter yes or no. For example, to draw a line separator on line 2 of msSub1 window try this: 
<param name=msSub1-separator2 value="yes"> 

Please note that you may not change the color or the offset of the line separators.