# Infinite Menus - Image Menu

Class File Names: imenus.class, occcolor.class, occcord.class, ocfontc.class, ocgifix.class, ocjwkey.class
Notice Tag: "Infinite Menus, Copyright (c) 1997 OpenCube Technologies, Registered (Unique Key ID#)"

Applet Tag Template

- Template Based on above sample

Information about the applet and its parameters

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 two image file names and highlight image file names. 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).

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 message are indicated using a range, such as "imagefile0" - "imagefileN". To define a parameter for a specific image or message (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 (defined with the width tag - see above). The y (vertical) coordinate starts at the top of the applet with 0 and goes down as far as the applet is high (defined with the height tag - see above).

The Applet Parameters

The Applet

Parameter 1
Attribute: Copyright notice.
param name="Notice"
value="Infinite Menus, Copyright (c) 1997 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

The Images

Parameter 5
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 must be defined relative to the location of the HTML document which contains the applet.

Parameter 6
Attribute: Image x,y (horizontal) locations
param name = "picxy0" - "picxyN"
Value = X,Y. Where X,Y is the horizontal and vertical location of the left border of the image relative to the left margin of the applet.

The Highlighted 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 have the same dimensions as the main menu image to which they belong.

Parameter 7
Attribute: 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.

The Associated Sub Menus Descriptions

Parameter 8
Attribute: Sub Menu Descriptions
param name = "desc0-0-0..." - "descN-N-N..."
Value = X, Where X is the message that corresponds to the index used to identify an 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 of 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 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.

Parameter 9
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 alowable style options are plain, bold, bolditalic, or italic.
DEFAULT: Helvetica, plain, 12

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

Parameter 11
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 12
Attribute: Center or Left Justify Text?
param name = "centertext"
Value = true or false, True = yes, Center Text - False = no, left justify text
DEFAULT: Left Justified

Positioning the Sub Menus

Note: To specify the placement of a given sub menu point to the sub menus base index value, e.g. "menuxoffset1-2" would refer to the sub menu defined for the third menu description for the second images initial sub menu, "mainxoffset1-2-0" would refer to the first sub menu of the sub menu associated with the third menu description for the second image, "mainxoffset2" would refer to the third images initial sub menu. See the "descN-N-N" tag for more information. If the menu is an initial sub menu of an image the values described below are offsets from the top left corner of the image, if the menus is a sub menu of a sub menu the values described below are offsets from the top left corner of the sub menus parent sub menu. To specify placement above or to the left of the parent image or sub menu use a negative value with the parameters below.

Parameter 13
Attribute: Sub Menu X (Horizontal) Offset from the left side of the Image or Sub Menu
param name = "menuxy0-0..." - "menuxyN-N..."
Value = X,Y Where X,Y is the horizontal and vertical offset from the left edge of the image or sub menu calling the sub menu, using the coordinate system described above.
DEFAULT: 0,0

Customizing Sub Menu Colors

Note: The index N for a specific color property identifies a sub menu level, all the sub menus on the level inherit the property of the parameter used with N. A sub menu level must exist (defined using the "descN-N-N..." tag) in order to define a property for it. The second sub menu level (a sub menu branched off from a main menu images sub menu) starts with the number 0. To define a property for the second level menus use "menutextcolor0", to define a text color for the third level menus use "menutextcolor1", etc. Level definitions cannot be skipped, in other words to define a property for the third sub menu level you must also define a property for the second sub menu level. What happened to the first level sub menus? The first level sub menus are defined using the default parameters (a parameter with no index, e.g. "menutextcolor").

Note: It is not actually necessary to sequentially define all specific level color properties, so long as at least one of the parameters is specifically defined for each level and is equal to or greater then any of the other level parameters non sequential index specifications. For example, say you have 4 levels of sub menus and you want to specifically define a menu color for each level, however you want to use the same text color on each level except for the fourth level. To do this you must define each levels menu color first. The level one menu color would be defined using "menucolor", level 2 using "menucolor0", level 3 using "menucolor1", and level 4 using "menucolor2". Since you have sequentially defined all your levels using the "menucolor" you are free to skip around with any other level parameters. This means that defining the text color for level 4 only requires one "menutextcolor2" tag.

Parameter 14
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 15
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 16
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 17
Attribute: Specific Text Color
param name = "menutextcolor0" - "menutextcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.

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

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

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

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

Parameter 22
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: Black

Parameter 23
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 24
Attribute: Image URL Links
param name = "imagedesturl0" - "imagedesturlN"
value=X, where X is the link for the specific image. URL's can be defined relative to the HTML document containing the applet or fully qualified.

Parameter 25
Attribute: Specific Load Destination Image URL Where?
param name="imageloadwhere0" - "imageloadwhereN"
The "loadwhere" tag specifies where the document specified in the "URL" value 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.
"_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

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.

Parameter 26
Attribute: Sub Menu URL Links
param name = "desturl0-0-0..." - "desturlN-N-N..."
value=X, where X is the link for the specific sub menu message. (e.g. to define a link for the first images first sub menu message use "desturl0-0" for the second use "desturl0-1", to define a link for the first sub menu message which is related to the first images initial sub menus second description use "desturl0-1-0", etc. For more information regarding this process see the "descN-N-N..." parameter. URL's can be defined relative to the HTML document containing the applet or fully qualified.

Parameter 27
Attribute: Default Load Destination URL Where?
param name = "loadwhere0-0-0..." - "loadwhereN-N-N..."
The "loadwhere" tag specifies where the document specified in the "URL" value 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.
"_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

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.

Infinite Menus, © 1997, OpenCube Technologies