# Message Presenter

Required Class Files: mpresent.class, ocgifix.class, occcolor.class, occcord.class, ocfontc.class, ocwordw.class, ocekey.class Notice Tag: "Message Presenter, (c) 1997, OpenCube Technologies, Registered (Your Unique Key ID#)"

Applet Tag Templates

- Template - Based on above sample

Information about the applet and its parameters

Required Parameters

Parameter 1 (the "notice" tag) must be included in the applet tag in order for the applet to work. Most of the parameters will default if you fail to define them, at a minimum you must include the notice tag and description parameters for your messages. Usually the easiest way to customize the applet is cut and paste 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 the same parameter name

Parameters used to customize a specific message are indicated using a range, such as "desc0" - "descN". To define a parameter for a specific message (available when noted as above), use "textcolor0" to define, in this case, the text color for the first message - "textcolor1" would define the text color for the second message, etc., 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 go 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 go down as far as the applet is high.

The Applet Parameters

The Applet

Parameter 1
Attribute: Copyright notice.
param name="Notice"
value="Message Presenter, (c) 1997, OpenCube Technologies, Registered (Your Unique Key ID#)"
Note: This must be included for the applet to work.

Parameter 2
Attribute: Background Color
param name= "bgcolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: WHITE

Parameter 3
Attribute: 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 - Message Presenter"

Parameter 4
Attribute: 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 Navigation Images

Note: The images defined as highlight and click images (defined with the 'switchfile' and 'clickfile' parameter) appear at the same coordinate space defined for the main image files (defined with the 'imagefile' parameter), and therefore should have the same dimensions.

Parameter 5
Attribute: Image File Locations and Names
param name = "imagefile0" and "imagefile1"
Value = X. Where X is the relative location and name of the image file to be displayed in the applet area as a main navigation image. This must be defined relative to the location of the HTML document which contains the applet.

Parameter 6
Attribute: Image x,y (horizontal, vertical) locations
param name = "picxy0" and "picxy1"
Value = x,y. Where x and y is the horizontal and vertical location of the top left corner of the image relative to the top left corner of the applet. Both the x,and y values, separated by a comma are required or an error will be generated.

Parameter 7
Attribute: Switch Image File Locations and Names
param name = "switchfile0" and "switchfile1"
Value = X. Where X is the relative location and name of the switch image files to be displayed in the applet area. The switch image appears as the mouse moves over its corresponding main image file (defined with the imagefile parameter). This must be defined relative to the location of the HTML document which contains the applet.

Parameter 8
Attribute: Click Image File Locations and Names
param name = "clickfile0" and "clickfile1"
Value = X. Where X is the relative location and name of the click image files to be displayed in the applet area. The click image appears when the user clicks a main navigation image. This must be defined relative to the location of the HTML document which contains the applet.

The Messages

Parameter 9
Attribute: Message
param name="desc0-0" - "descN-N"
value=X, where X is the message to be typed
Note: The first number after the string "desc" specifies the frame and the second number after the character '-' specifies a sequentially ordered block of text in that frame. Messages longer than the width of the applet are automatically put in a multi-line format. To use a message as a blank line break use a space character " ".

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

Parameter 11
Attribute: Frame-Specific Text Color
param name= "textcolor0" - "textcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: BLACK

Parameter 12
Attribute: Specific Text Color
param name= "textcolor0-0" - "textcolorN-N"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: BLACK

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

Parameter 14
Attribute: Frame-Specific Text Highlight Color
param name= "texthlcolor0" - "texthlcolorN"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: BLACK

Parameter 15
Attribute: Specific Text Highlight Color
param name= "texthlcolor0-0" - "texthlcolorN-N"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: BLACK

Parameter 16
Attribute: Default Text Font Style
param name="textfont"
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 font Java face values are Helvetica, TimesRoman, Courier, Dialog, or DialogInput. The allowable style options are plain, bold, bolditalic, or italic.
DEFAULT: Helvetica, plain, 12

Parameter 17
Attribute: Frame-Specific Text Font Style
param name="textfontN"
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 font Java face values are Helvetica, TimesRoman, Courier, Dialog, or DialogInput. The allowable style options are plain, bold, bolditalic, or italic.
DEFAULT: Helvetica, plain, 12

Parameter 18
Attribute: Specific Text Font Style
param name="textfontN-N"
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 font Java face values are Helvetica, TimesRoman, Courier, Dialog, or DialogInput. The allowable style options are plain, bold, bolditalic, or italic.
DEFAULT: Helvetica, plain, 12

Parameter 19
Attribute: Left and Right Margin Width
param name="lrmargin"
Value = X, Where X is the width of the right and left margin.
DEFAULT: 5

Parameter 20
Attribute: Bottom Margin
param name="bottommargin"
Value = X, Where X is the distance from the bottom border of the applet to the message being typed.
DEFAULT: 5

Parameter 21
Attribute: Top Margin
param name="topmargin"
Value = X, Where X is the distance from the bottom border of the applet to the message being typed.
DEFAULT: 5

Parameter 22
Attribute: Default Vertical Alignment
param name="valign"
Value = "top", "center", or "bottom".
DEFAULT: left

Parameter 23
Attribute: Frame-Specific Vertical Alignment
param name="valignN"
Value = "top", "center", or "bottom".

Parameter 24
Attribute: Default Horizontal Alignment
param name="halign"
Value = "top", "center", or "bottom".
DEFAULT: top

Parameter 25
Attribute: Frame-Specific Horizontal Alignment
param name="halignN"
Value = "top", "center", or "bottom".

Messages that act as URL Links

Parameter 26
Attribute: Specific Destination URL Link
param name="desturl0-0" - "desturlN-N"
Value = X, Where X is the location of the document to load relative to the location of the HTML document containing the applet (e.g. if the HTML page containing the applet is located at http://www.opencube.com and the document to load is located at http://www.opencube.com/myhtml/mydoc.htm then the desturlN value would be "myhtml/mydoc.htm"). Note: The desturlN tags directly correspond to the descN tags, setting desturl0 will add a link to the first message description identified in desc0, desturl1 uses a link with desc1, etc.

Parameter 27
Attribute: Default Load Destination URL Link Where? (Frame Targeting)
param name="loadwhere"
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.
"_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.

Parameter 28
Attribute: Specific Load Destination URL Link Where? (Frame Targeting)
param name="loadwhere0-0" - "loadwhereN-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.
"_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.

Optional Page Numbering

Parameter 29
Attribute: Page Number Font
param name="pnfont"
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 font Java face values are Helvetica, TimesRoman, Courier, Dialog, or DialogInput. The allowable style options are plain, bold, bolditalic, or italic.
DEFAULT: Helvetica, plain, 12

Parameter 30
Attribute: Page Number Color
param name="pncolor"
Value=r,g,b or #000000 - #FFFFFF - See above for more information on defining colors.
DEFAULT: BLACK

Parameter 31
Attribute: Show Page Numbers as a Fraction of Total Pages
param name="usepnr"
Value = True or False, If false the page number is shown in standard format.
DEFAULT: False

Parameter 32
Attribute: Page Number Default X Coordinate
param name="pnxy"
Value=X,Y , where X,Y is the default x and y coordinate for the page number's placement.

Parameter 33
Attribute: Page Number Specific X Coordinate
param name="pnxy0"-"pnxyN"
Value=X,Y, where X,Y is the x and y coordinate for the page number's placement on frame N.

Note: If no coordinates are specified for a frame, no page number will appear as long as the default coordinates have not been defined.

Message Presenter, Enterprise Edition, © 1997, OpenCube Technologies