HTML provides several ways to display images with the Prizm® browser-based Viewer. Before the reviewing the options available, please read the following Notes.

NOTES

These options originally changed with version 4.2 of the Prizm Viewer (formerly called the Prizm® Plug-in); review this section carefully if you have created HTML for use with earlier versions of the Prizm Viewer.

Embed tags are no longer recommended for use with World Wide Web Consortium (W3C) compliant browsers. It recommends that the Object tag be used instead. The W3C develops specifications, guidelines, software, and tools for the Web and Web browsers.

• Create a standard link directly to an image using the <A HREF=""></A> tag. When someone viewing the HTML document clicks on the link, the browser will load the Prizm Viewer and display the image in the browser window.
• Use embed tags <EMBED> to specify the image you would like displayed. This creates a window within the HTML page in which the Prizm Viewer displays the image. The Viewer has custom parameters that you can include on the embed tag that allow you to customize the display and/or printing of the image, such as rotation, initial display (zoomed in, full image, full width, etc.), and abbreviated toolbars.
• Use object tags (<OBJECT>) to specify the image to display. You can use the same custom parameters with object tags as with embed tags.

To fully support both Internet Explorer and Netscape browsers, we recommended that you use <EMBED> tags nested inside <OBJECT> tags.

The rest of this page describes how to correctly code <OBJECT> and <EMBED> tags. This information is intended for those who are very familiar with HTML coding and formats. You will find the following sections in this page:

Standard Link Description
Embed Tag Description
Object Tag Description
Nested Embed Tags Within Object Tags
Prizm Viewer Custom Embed and Object Tag Parameters

NOTE:

Microsoft discontinued support for plug-ins in the Internet Explorer browser starting with IE 5.5 sp2 and above. Pegasus Imaging Corporation has updated the Prizm Viewer to include an ActiveX wrapper that allows the Viewer to work under IE 5.5 sp2 and above. If you have HTML that will be used with both IE and Netscape browsers or with the IE browser only, and you expect your users to upgrade to IE 5.5 sp2 or above, read the following information to determine if changes apply to you. Please note that IE 6 ships with Windows XP.

Standard Link Description

To create a link to an image in HTML, use the standard method for creating links in HTML, the <A HREF> tag. The following is a link to an image. When you click on the link, the browser window is updated with the image displayed in the Prizm Viewer.

TIFF Image with 3 Pages

The syntax used is as follows.

<A HREF="images/3page.tif">TIF Image with 3 Pages</A>

Embed Tag Description

The "embed" tag became popular when Netscape introduced plug-ins for its browser. As noted in the beginning of this section, <EMBED> tags are no longer recommended for use with W3C compliant browsers. We recommend moving to either <OBJECT> tags (for IE only support) or <EMBED> tags nested inside <OBJECT> tags (for IE & Netscape support).

To use the embed tag to specify an image to be displayed on an HTML page, use the following syntax:

<EMBED SRC="URL" WIDTH="nnn" HEIGHT="nnn" [parameter-name="parameter-value"]>

where

URL is the valid path and name for the image file to be displayed. Any valid path and name of an image file allowed in HTML is valid.

nnn is the number of pixels desired for either the width or the height of the window that will contain the image. Actual pixels (i.e., width="800" height="600") or percentages (i.e., width="95%" height="95%") can be used.

parameter-name and parameter-value are Prizm Viewer custom parameters for the embed tag. You can find a list of these in the table at the end of this page.

An embed tag was used to place the following image on this page. The syntax used in the HTML is as follows:

<EMBED SRC="images/3page.tif" WIDTH="400" HEIGHT="450" EBAR="1" TYPE="image/tif">

Object Tag Description

The OBJECT tag allows HTML authors to specify the application (in our case, an ActiveX that encases a plug-in) that should be used to display a particular object. You can use the <OBJECT> tag alone if your target browser is Internet Explorer or you can use <EMBED> tags nested inside <OBJECT> tags if you will be targeting both IE and Netscape browsers.

To use the <OBJECT> tag to specify an image to be displayed on, or printed from, an HTML page, use the following syntax:

<OBJECT ID="PrizmActiveXName"
        CLASSID="PrizmActiveXCLSID"
        height="nnn" width="nnn">
   <PARAM NAME=”SRC” VALUE=”URL”>
   [<PARAM NAME="parameter-name" VALUE="parameter-value">]
</OBJECT>

where

PrizmActiveXName is the name of the Prizm Viewer ActiveX. The names of the ActiveX controls are given below.

• Prizm Viewer: PrizmXAdapter
• PrizmPrint (batch download only): PrizmPrintXAdapter

PrizmActiveXCLSID is the class ID for the Prizm Viewer ActiveX. There are two class IDs for the Viewer:

• CLSID:7A2633f0-33D5-4F5E-93BE-74ACBEE7F7EA
• PrizmPrint (batch download only): CLSID:F6A484FB-2DED-4CAD-AC6C-1E9EF0D96A3A

nnn is the number of pixels desired for either the width or the height of the window that will contain the image. Actual pixels (i.e., width="800" height="600") or percentages (i.e., width="95%" height="95%") can be used.

URL is the valid path and name for the image file to be displayed. Any valid path and name of an image file allowed in HTML is valid.

Parameter-name and parameter-value are Prizm Viewer custom parameters for the embed tag. You can find a list of these in the Object/Embed Tag table.

For example, the embed tag in the example above uses the following syntax:

<EMBED SRC="images/3page.tif" WIDTH="400" HEIGHT="450" EBAR="1" TYPE="image/tif">

The equivalent object tag would be:

<OBJECT ID="PrizmXAdapter"
        CLASSID="CLSID:7A2633f0-33D5-4F5E-93BE-74ACBEE7F7EA"
        height="450" width="400">
   <PARAM NAME=”SRC” VALUE=”images/3page.tif”>
   <PARAM NAME="EBAR" VALUE="1">
   <PARAM NAME="TYPE" VALUE="image/tif">
</OBJECT>

For printing from the Prizm Viewer, a valid embed tag may appear as follows:

<EMBED SRC="image/3page.xlo" WIDTH="95%" HEIGHT="95%" TYPE="image/tif">

The equivalent object tag would be:

<OBJECT ID="PrizmPrintXAdapter"
        CLASSID="CLSID: F6A484FB-2DED-4CAD-AC6C-1E9EF0D96A3A "
        HEIGHT="95%" WIDTH="95%">
        <PARAM NAME=”SRC” VALUE=”images/3page.xlo”>
        <PARAM NAME="TYPE" VALUE="image/tif">
 </OBJECT>

The following example shows various parameters being used in an object tag:

<object id="PrizmXAdapter"
        classid="CLSID:3DB7E7DB-3781-4FF8-8147-42419DEA9F26"
        height="1" width="1">
        <param name="SRC" value="c:\images\clock.jpg">
        <param name="SAVEASFUNCTION" value="disable">
        <param name="EXPORTFUNCTION" value="disable">
        <param name="ANNCGI" value="<cerberus.pegasusimaging.com<http://cerberus.pegasusimaging.com/cgi-
        bin/annserver.cgi><solaris.pegasusimaging.com<https://solaris.pegasusimaging.com/cgidir/annotcgi.exe>">
       <param name="LOCALCACHE" value="internetcache,subdir1/subdir2/subdir3">
</object>

Nested Embed Tag Description

To nest the <EMBED> tag in an <OBJECT> tag, start with a correctly formed <OBJECT> tag and a correctly formed <EMBED> tag. Put the <EMBED> tag immediately before the </OBJECT> tag. As an example, let's look at the <EMBED> and <OBJECT> tags referenced in the above section. Nesting the <EMBED> tag inside the <OBJECT> tag would gives the following HTML.

<OBJECT ID="PrizmXAdapter"
        CLASSID="CLSID:3DB7E7DB-3781-4FF8-8147-42419DEA9F26 "
        height="450" width="400">
   <PARAM NAME=”SRC” VALUE=”images/3page.tif ”>
   <PARAM NAME="EBAR" VALUE="1">
   <PARAM NAME="TYPE" VALUE="image/tif">

   <EMBED SRC="images/3page.tif" WIDTH="400" HEIGHT="450"
         EBAR="1" TYPE="image/tif">
</OBJECT>

Prizm Viewer Custom Object/Embed Tag Parameter and Directive Information

The Viewer provides custom parameters that can be used to override default actions of the Prizm Viewer. Three tables contain information about specific tags available. The Custom Object/Embed table contains object and embed tags and the Directive table contains directive information. The table labeled Parameter-Directives contains tags that can be used as embed/object tags or directives. Click the appropriate heading below to review values and descriptions for each tag and directive listed.