Web Page Production Guide

2: Customizing Image Files

This page describes the scope and use of the applet parameters that control the appearance and behaviour of image files loaded into a CADViewer window.

CONTENTS: Selecting an initial view of the drawing

Adding a "watermark" to a drawing

Turning drawing layers off

Listing additional drawings that can be accessed directly (with the "Open" button)

Loading redlines with a specific drawing

Specifying the target window for URLs in a drawing


PARAMETER -- Selecting an initial view of the drawing
PURPOSE: If there is a particular view in a drawing that you want to appear in the CADViewer when it is first loaded, you can specify it in this parameter.
*.cfg: INITIAL_VIEW_NAME="[text]"
VALUE OPTIONS: In the place where "[text]" occurs, type the name of the view that you want to appear in the CADViewer window. For example:


RESULTS: The CADViewer will select the designated view as the "initial view" -- or the first view used -- when the drawing is loaded into the CADViewer window.

RETURN to top of page

PARAMETER -- Adding a "watermark" to a drawing
PURPOSE: If you would like to add "watermark" texts to a drawing when it is displayed in the CADViewer (without having to modify the original drawing) you can do so with this parameter.
*.cfg: WATER_MARK=[text]
VALUE OPTIONS: In the place where [text] occurs, type your watermark text, wrapped in quotation marks. For example:

VALUE="Image copyright © 2000 MegaCorp, Inc."

This value will place the specified copyright notice on any and all drawings opened in this Web page's CADViewer.
RESULT: The CADViewer will display the designated drawing, then overlay the watermark type across the top of the image.
TIPS: Any amount of text can be displayed -- pending the usable area of the CADViewer. The text will appear in the top portion of the drawing.

RETURN to top of page

PARAMETER -- Turning drawing layers off
PURPOSE: If the original drawing includes a number of layers that you want hidden from the end user, you can specify those layers with this parameter. These layers will remain hidden, despite the presence of the Show/Hide Layers feature in the CADViewer.
EXAMPLE: < NAME="OFF_LAYERS" VALUE="[layer numbers]" >
*.cfg: OFF_LAYERS=[layer numbers]
VALUE OPTIONS: Enter each and every layer as "Layer 1", etc., separated by a semi-colon. For example, the value might be:

"Layer 1;Layer 2;Layer99"

The above-noted example of a value entry will turn off Layers 1, 2 and 99 while leaving all other layers visible.
RESULTS: The CADViewer will hide the specified layers and display all the others.

RETURN to top of page

PARAMETER -- Listing additional drawings that can be accessed with this CADViewer
PURPOSE: If you have created a list of drawings that can be opened by means of the CADViewer Open dialog box, this parameter links the CADViewer to that list file.
EXAMPLE: < NAME="LIST" VALUE="[file name]" >
*.cfg: LIST=[file name]
VALUE OPTIONS: The value should be the pathway to the current list file, which should be a list of drawing file names saved as a text file -- including the .TXT extension. For more information on the creation of the list file, click "Creating a list file".
RESULTS: When the user clicks the CADViewer window "Open" button, the viewer will open this file and load the contents (a list of available drawings) into a File List dialog box.
TIPS: By default, a list (drawings.txt) is stored in the same server directory as the CADViewer. If not, the 'list' value should specify the pathway to the location of this file (along with the file name.)

For example, if the location of the drawing list is at this location:


This parameter's value would be the following:

<parameter name="list" value="/cad/drawings/project_a/list.txt">

Note that the path is from the server root ("/").

In addition, if you have a group of drawings (specific to a project), that project can be incorporated into a unique list of drawings, that can be opened within a particular CADViewer (on a particular Web page.)

RETURN to top of page

PARAMETER -- Loading redlines with a specific drawing
PURPOSE: If you would like a specific set of redlines to appear when a particular drawing is opened in a CADViewer, you can specify the file and the automatic loading with this parameter.
EXAMPLE: < NAME="open_redline_with_drawing" VALUE="initial" >
<param name="load_redline_from_url" value="[file name]">
*.cfg: open_redline_with_drawing=initial
load_redline_from_url=[file name]
VALUE OPTIONS: In the place of "[file name]", type the name of the specific redline file. Include the directory path, if this file is stored in any other location not the document base location. (Note that the path should be relative to the document base.)
RESULTS: This parameter instructs the viewer to display a specific redlines file.
TIPS: <param name="open_redline_with_drawing" value="initial"> If the value is "always", then only the [file name] redline will be opened and no other redline file are allowed even files in the local machine

RETURN to top of page

PARAMETER -- Specifying the target window for URLs in a drawing
PURPOSE: If this drawing has URLs that link to other sites or resources, you can use this parameter to specify a target window or region for the URL destination. This includes a separate browser window, a different frame in the same window, or in the same window as the CADViewer.
EXAMPLE: < NAME="TARGET" VALUE="[see below]" >
*.cfg: TARGET=[see below]
VALUE OPTIONS: You can use the "target" parameter as you would in standard HTML coding. Parameter options include the following:

_blank Displays the target URL in a new, unnamed browser window
_self Opens the target URL in the same browser window as the viewer--replacing the CADViewer with the target. Any unsaved redlines (Pro version only) will be lost once the URL has been clicked.
_parent Displays the target URL into the parent of the browser where the viewer is running. Useful when working with frames, as this link extension will replace the entire frames layout with the designated page or viewer.
_top Displays the target URL in the current window, replacing any frames in the window.
other Displays the URL in a new browser window entitled "other".
RESULTS: When a user clicks the URL button and then clicks on a URL hotspot in a drawing, CADViewer will instruct the parent browser to open that link in a specified target.

RETURN to top of page

1: Viewer-specific parameters | 2: Drawing-specific parameters | 3: Server-specific parameters