Infinite Icon Menus

Note: The unregistered version of this applet may be completely customized and used for evaluation purposes on a single computer and viewed locally. The purchased version includes the necessary security key class file and license to display multiple copies of the software on one web site.

This software is available as part of Web Effects (Enterprise and Gold Collections), for more information use the links below or contact OpenCube at 207-947-1955

Purchasing the Applet
Note: The unregistered version of this applet may be completely customized and used for evaluation purposes on a single computer and viewed locally.

This software is available for purchase as part of Web Effects (Navigation and Gold Collections), for more information use the links below or contact OpenCube at 207-947-1955

The Status Bar Message

Note: The status bar messages which indicate the name of the applet and "Java by OpenCube" in the sample implementation above is customizable using the "onsbtext" and "offsbtext" parameters. See the parameter list below for more information on customizing the Status Bar Text.

Running Applets Locally

Note: Some versions of Internet Explorer and Netscape, depending on the platform, (primarily IE 3.02, IE 4.x and Netscape 4.x) will not be able to view this and most other applets locally due to a security precaution implemented by the browsers (usually image based or text file reading applets). If this is the case we recommend placing all the class files, html, and applet support files in the same folder when running locally, or try using IE 3.0 - 3.01, Netscape 2.0 - 3.01 or the Microsoft Applet Viewer. Note: This security mechanism will not be present once the applet is located on the internet and the applet will work under all browser / platform scenarios.

To customize and view this evaluation applet locally the HTML page containing the applet must be opened using the file protocol (by selecting file - open in the browser or double clicking the HTML files icon). Viewing the applet via http://, (weather through the internet or a personal web server such as the one provided with FrontPage) will generate an evaluation applet security error and the applet will not display. Note: The purchased applets include the necessary security key class file to run the applets on the internet.

Required Class Files

This applet uses multiple class files (included with the download), the main class file: iim.class must be referenced by the applet tag. The other support class files must be located in the same folder as the main class file in order for the applet to run. The required class files are: iim.class, occcolor.class, occcord.class, ocfontc.clss, ocgifix.class, ocekey.class

Applet Tag Templates

Template - Based on above sample

Online Documentation at www.opencube.com

Receiving Technical Support:

If you are having trouble customizing the applet or cannot get the applet to function appropriately please contact OpenCube by phone or e-mail at 207-947-1955, or support@opencube.com. When contacting support by e-mail please include any error messages you received and an explanation of the problem. If you have already customized your tag please e-mail the HTML document which includes the tag and any support files such as images that the applet uses and we will correct the problem and e-mail the working tag with your page back to you.

The Required Parameters:

Parameter 1, the notice tag, must be included in the applet tag in order for the applet to work. The only other required parameters are at least one image file name and highlight image file name. Usually the easiest way to customize your applet is to cut and paste the applet tag used in the template and modify it to fit your web page.

Defining Colors:

This applet uses a simple RGB or Hexadecimal color definition scheme. On most systems (depending on the software being used to choose a color) its easier to define a color using RGB, however since most web pages define colors using a HEX value we have allowed for both methods of color definition. To define a color using RGB use commas to separate the values such as 255,255,255 (White). To define a color using a hexadecimal value use a pound sign ('#') followed by a 6 digit hex value in the rage of 000000 - FFFFFF (e.g. #FFFFFF is equal to the color White).

Note: There is a possible bug, depending on the platform in Netscape 4.0, with Hexadecimal color definition. When users may be viewing this applet with Netscape 4.0 use a RGB color definition scheme to avoid the possibility of an error.

Color Definition with RGB: To define a color in one of the color parameters using RGB choose a value between 0 - 255 for the red, green, and blue components separated by commas and typed out in the correct r,g,b order. Below is a sample of how a color parameter using RGB should look, the example specifies several different sample colors for the "bgcolor" parameter.

WHITE: <param name="bgcolor" value="255,255,255">
GREEN: <param name="bgcolor" value="0,255,0">
BLACK: <param name="bgcolor" value="0,0,0">
YELLOW: <param name="bgcolor" value="255,255,0">
OFF WHITE: <param name="bgcolor" value="240,239,234">

The best way to choose the exact color you are looking for without having to guess the numbers is to access your systems Color Picker. Color Pickers usually allow you to drag the mouse over a rainbow type color grid to select a color, and show you the appropriate RGB values. In windows the Color Picker is accessible through MS Paint as well as a majority of the popular Imaging and HTML Authoring Software.

Defining Multiple attributes with One Parameter:

Parameters used to customize a specific image location or menu description are indicated using a range, such as "imagefile0" - "imagefileN". To define a parameter for a specific image or menu description (available when noted as above), use "imagefile0" to define, in this case, the first main menu image, "imagefile1" would define the second main menu image, etc.

The Applet Coordinate System:

The origin of the applets coordinate system is located at the upper left corner of the applet. The x (horizontal) coordinate starts at the left border with 0 and goes as far to the right as the applet is wide. The y (vertical) coordinate starts at the top of the applet with 0 and goes down as far as the applet is high.

The Applet Parameters

The Applet

Parameter 1
Attribute: Copyright notice.
param name="Notice"
value="Infinite Icon Menus, Enterprise Edition, Copyright (c) 1998 OpenCube Technologies, Unregistered"
Note: This must be included for the applet to work. The text must appear as one continuous line of text without a line break or the applet will not recognize the string, the appropriate capitalization must be used as well.

Parameter 2
Attribute: Applet Background Color
param name = "bgcolor"
Value = R,G,B, Where R,G,B are the red, green, and blue components of the applets background color.

Parameter 3
Attribute: Default Status Bar Text when mouse is over applet
param name = "onsbtext"
value="X", where X is the message to appear in the status bar when the mouse is over the applet but not over a URL link.
DEFAULT: OpenCube - Infinite Menus Menu

Parameter 4
Attribute: Default Status Bar Text when mouse is off applet
param name = "offsbtext"
value="X", where X is the message to appear in the status bar when the mouse is not over the applet.
DEFAULT: Java by OpenCube

Parameter 5
Attribute: Loading Images Message
param name = "loadmsg"
value="X", where X is the message to appear in the applet area while the sub menu icon and background images are loading.
DEFAULT: Loading Images...

Parameter 6
Attribute: Loading Images Message Color
param name = "loadmsgcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: White

Applet Background Image

Parameter 7
Attribute: Background Image File Name
param name = "bgimagefile"
Value = X. Where X is the relative location and name of the image file to be displayed in the applets background.

Parameter 8
Attribute: Background Image X,Y Location
param name = "bgimagexy"
Value = X,Y. Where X,Y is the horizontal and vertical coordinate location to display the background image at, relative to the top left corner of the applet.
DEFAULT: 0,0

The Main Menu Images

Parameter 9
Attribute: Image File Locations and Names
param name = "imagefile0" - "imagefileN"
Value = X. Where X is the relative location and name of the image file to be displayed in the applet area as a main menu image. This file must be defined relative to the location of the HTML document which contains the applet or by fully qualified.

Parameter 10
Attribute: Image x,y Coordinates
param name = "picxy0" - "picxyN"
Value = X,Y. Where X,Y is the horizontal and vertical coordinates of the image relative to the top-left corner of the applet. Note: The index must correspond to the associated "imagefile" parameter (see above).
DEFAULT: 0,0

Main Menu Switch (highlight) Images

Note: The images defined as Highlight images appear as the mouse moves over a main menu image. The highlighted images are automatically placed directly over the main menu image to which they correspond and therefore should in most cases have the same dimensions as the main menu image to which they belong.

Parameter 11
Attribute: Switch (highlight) Image File Locations and Names
param name = "switchfile0" - "switchfileN"
Value = X. Where X is the relative location and name of the image file to be displayed in the applet area when the mouse is over a main menu image. This must be defined relative to the location of the HTML document which contains the applet or be fully qualified. Note: The index must correspond to the index used with the "imagefile" parameter (see above).

Sub Menu Descriptions and Format

Parameter 12
Attribute: Sub Menu Descriptions and Associated Icons
param name = "desc0-0-0..." - "descN-N-N..."
Value = 'Icon Index ID|Description' or 'Description' only.

Where the index value corresponds to a main menu image as well as its parent sub menu if applicable. To define level 1 sub menus (the first menu to appear as the mouse moves over an image) use "descN-N", e.g. "desc0-0" refers to the first sub menu description for the first image, "desc0-1" refers to the second sub menu description for the first image. To branch another sub menu off a previous sub menu extend the reference, e.g. "desc0-1-0" would force a new menu to pop up as the mouse passed over the second description in the first sub menu which was defined by "desc0-1", "desc0-1-1" would add another description to this new second level sub menu. Sub menus may be branched indefinitely in any configuration.

To associate an icon with the description use the icons index id followed by a vertical bar "|" then the description for the sub menu, e.g. "0|my sub menu description" would create a sub menu link using the icon and switch icon defined with "iconfile0" and "iconswitchfile0" along with the description "my sub menu description". To use just a text description without an icon ignore the vertical bar separator and specify the description only in the value.

Parameter 13
Attribute: Font Style
param name = "font"
Value = Font Face, Style, Size, Each value must be separated by a comma and appear in the correct order (font face, style, and size) The Allowable Java font face values are Helvetica, TimesRoman, Courier, Dialog, or DialogInput. The allowable style options are plain, bold, bolditalic, or italic.
DEFAULT: Helvetica, plain, 12

Parameter 14
Attribute: Text Color
param name = "menutextcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Parameter 15
Attribute: Menu Bit Height
param name = "menubitheight"
Value = X, Where X is the height of an individual sub menu description link. If left undefined or if defined smaller than the height of the font being used the height is automatically set.
DEFAULT: Not Used (Automatic according to font size)

Parameter 16
Attribute: Left and Right Margins
param name = "lrmargin"
Value = X, Where X is the left and right margin to use for the sub menu messages.
DEFAULT: 4

Parameter 17
Attribute: Icon to Text Distance
param name = "icontextspace"
Value = X, Where X is the distance in pixels to separate the icons from the text under any alignment scenario.
DEFAULT: 1

Parameter 18
Attribute: Default Icon & Text Alignment
param name = "italign"
Value = X, Where X = 0,1,2, or 3. Each value corresponds to specific text and icon alignment. Note: the text and icon alignment may also be defined for a specific sub menu (see below for more information)
1 = icon left, text left
2 = text left, icon right
3 = icon right, text left
4 = icon right, text right
DEFAULT: 0

Note: To specify the alignment of a given sub menu use the sub menus base index value used with the "desc0-0-0..." - "descN-N-N..." tags, e.g. "italign0" would refer to the first images initial sub menu, "italign0-1" would refer to the second level sub menu which appears as the mouse passes over the second sub menu description of the first images initial sub menu, etc.

Parameter 19
Attribute: Specific Icon & Text Alignment
param name = "italign0-0..." - "italignN-N..."
Value = X, Where X = 0,1,2, or 3. Each value corresponds to specific text and icon alignment. Note: the text and icon alignment may also be defined for a specific sub menu (see below for more information)
1 = icon left, text left
2 = text left, icon right
3 = icon right, text left
4 = icon right, text right

Icon and Icon Switch (highlight) Images for Sub Menus

An unlimited number of icon images in varying sizes and formats may be defined and associated with any sub menu link. Each icon is optionally referenced from the "desc" tag by using the icons id which is the numbered index used in the parameter to uniquely specify the file name and location of the icon image. For more information on how to add an icon reference to a menu link see the descriptions for the "desc" tag. The icons associated switch image is automatically displayed when a sub menu link is highlighted. Note: The icons are automatically indented by the amount specified using the left and right margin parameter (see "lrmargin").

Parameter 20
Attribute: Icon Files
param name = "iconfile0" - "iconfileN"
Value = X. Where X is the name and relative location of the icon image file.The file should be defined relative to the location of the document containing the applet or fully qualified (e.g. http://www.mydomain.com/...).

Parameter 21
Attribute: Icon Switch (highlight) Files
param name = "iconswitchfile0" - "iconswitchfileN"
Value = X. Where X is the name and relative location of the icon switch image file.The file should be defined relative to the location of the document containing the applet or fully qualified (e.g. http://www.mydomain.com/...).

Specifying Sub Menu Coordinates

NOTE: The applet will attempt to automatically place your sub menus, if left undefined, according to icon alignment and proximity to the lower and right applet edge. However the placement may be such that the sub menu is cut off by the edge of the applet, if this is the case or the applets automatic sub menu placement is not agreeable, its position may be specifically defined using the menuxy parameter described below.

Note: To specify the coordinates of a given sub menu use the sub menus base index value (defined with the "desc0-0-0..." - "descN-N-N..." tags, e.g. "menuxy0" would refer to the first images initial sub menu, "menuxy0-1" would refer to the second level sub menu which appears as the mouse passes over the second sub menu description of the first images initial sub menu, etc.

Parameter 22
Attribute: Sub Menu X,Y Coordinate
param name = "menuxy0-0..." - "menuxyN-N..."
Value = X,Y Where X,Y is the horizontal and vertical coordinates relative to the top-left corner of the sub menus associated image or sub menu.
DEFAULT: 0,0

Customizing Sub Menu Levels

NOTE: Each sub menu level can be customized with specific colors, background images, etc. To point to a specific sub menu level use the param name (customizable options listed below) with an index value stating with 0, e.g. to define the text color for the first level sub menus use "menutextcolor0", "menutextcolor1" would define the color of the second level sub menus, etc. Specifying one of the level customization parameters without an index will force all sub menus to default to that value unless specifically defined.

Parameter 23
Attribute: Default Sub Menu Background Image File Name and Location
param name = "subbgfile"
Value = X. Where X is the relative location and name of the image file to be displayed as the sub menus default background image. This file must be defined relative to the location of the HTML document which contains the applet or by fully qualified. Note: The default background image is used on all sub menu level unless defined differently for a specific level, the background image is automatically tiled to fit the sub menu area.

Parameter 24
Attribute: Specific Sub Menu Background Image File Name and Location
param name = "subbgfile0" - "subbgfileN"
Value = X. Where X is the relative location and name of the image file to be displayed as the specific sub menus background image. This file must be defined relative to the location of the HTML document which contains the applet or by fully qualified. Note: The background image is automatically tiled to fit the sub menu area.

Parameter 25
Attribute: Default Sub Menu Background Color
param name = "menucolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Yellow

Parameter 26
Attribute: Specific Sub Menu Background Color
param name = "menucolor0" - "menucolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Parameter 27
Attribute: Default Text Color
param name = "menutextcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Parameter 28
Attribute: Specific Text Color
param name = "menutextcolor0" - "menutextcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Parameter 29
Attribute: Default Sub Menu Box Outline Color
param name = "menuboxoutcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Black

Parameter 30
Attribute: Specific Sub Menu Box Outline Color
param name = "menuboxoutcolor0" - "menuboxoutcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Parameter 31
Attribute: Default Sub Menu Description Outline Color
param name = "menuoutcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Not Used

Parameter 32
Attribute: Specific Sub Menu Description Outline Color
param name = "menuoutcolor0" - "menuoutcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Parameter 33
Attribute: Default Sub Menu Highlight Outline Color
param name = "menuhlcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Not Used

Parameter 34
Attribute: Specific Sub Menu Highlight Outline Color
param name = "menuhlcolor0" - "menuhlcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

Parameter 35
Attribute: Default Sub Menu Highlight Text Color
param name = "menuhltextcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: Blue

Parameter 36
Attribute: Default Sub Menu Highlight Text Color
param name = "menuhltextcolor0" - "menuhltextcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

URL Links

Parameter 37
Attribute: Main Menu Image URL Links
param name = "imagedesturl0" - "imagedesturlN"
value=URL | Target or URL, where URL is the link for the specific sub menu message. URL's can be defined relative to the HTML document containing the applet or fully qualified (e.g. http://www.mydomain.com/...).

The desturl value can optionally be separated by a | to define a specific target location for the URL. To specifically target a named frame, set the value to the URL, than use a vertical bar delimiter ' |' followed by the name of the frame or use the URL link in combination with the constants listed below. The default target location is the value set with the loadwhere tag which defaults to "_self". e.g. a URL link which loads in a frame named content... "...myfolder/mylink.htm|content", e.g. a URL link which uses the default target location... "...myfolder/mylink.htm".

"_self" show in the current frame
"_parent" show in the parent frame
"_top" show in the top-most frame
"_blank" show in a new unnamed top-level window
"name" show in a new top-level window named name
"frame name" show in the frame named frame name

Parameter 38
Attribute: Sub Menu Level URL Links
param name = "desturl0-0-0..." - "desturlN-N-N..."
value=URL | Target or URL, where URL is the link for the specific sub menu message. The "N-N-N" index must correspond to the sub menus associated desc index (see the "desc" tag for more information). URL's can be defined relative to the HTML document containing the applet or fully qualified (e.g. http://www.mydomain.com/...).

Parameter 39
Attribute: Default Load Destination URL Where?
param name="loadwhere"
The "loadwhere" tag specifies where the document specified in the "desturlN-N-N" and "imagedesturlN" parameters should be loaded. The default is "_self". A value equal to the name (case sensitive) of a frame will load the document in that frame.
"_parent" show in the parent frame
"_top" show in the top-most frame
"_self" show in the current frame
"_blank" show in a new unnamed top-level window
"name" show in a new top-level window named name
"frame name" show in the frame named frame name

Note: When targeting a frame location with the name of the frame make certain that the case and names are typed identically. If the applet cannot find the frame the document will be loaded in a new window.

This software may be used for evaluation purposes only. For more information regarding the use of this evaluation software see the End User Agreement Document.