The following general notes include known problems or issues with using Autodesk MapGuide Viewer Release 6.3:
Print to a non-PostScript printer or install a driver for your PostScript printer that supports Hewlett-Packard Graphics Language (HPGL) or Printer Control Language (PCL). For example, if your printer is currently configured with an HP LaserJet 4M printer driver, choose Start > Settings > Control Panel > Printers and add a second printer that uses the HP LaserJet 5L PCL driver.
If you select polygons using the Autodesk MapGuide Viewer ActiveX Control or Plug-In, and then print to a PostScript printer, the selected polygon always prints with a white fill. To solve this problem, try using a different printer driver (such as PCL driver), or print to a non-PostScript printer.
Some Hewlett Packard printers, such as the 5N model, print dashed lines as solid lines. To fix this problem, try any of the following:
If your graphics card supports only 256 colors or less, features selected under a raster layer may not be highlighted correctly.
Please note that VBA is not supported in Release 6 of Autodesk MapGuide, and using the ActiveX Control with VBA may result in erratic behavior.
Some HP LaserJet printers require a specific Properties specification to support the ghosting feature. If you have trouble using this feature on your LaserJet, go to the Printer Properties screen (click the Properties button in any standard Print dialog box), click the Graphics tab, and then select Use Raster Graphics instead of Use Vector Graphics.
Note The Graphics tab may not be available depending on your access rights to it.
If you get a "Print Overrun Error" message on your printer, increase the Printer memory. (This setting is also in the Printer Properties dialog box.)
When printing a map from Autodesk MapGuide Viewer, some of the text labels and line breaks that are near the edge of the map may print outside of the map boundary and may not clip properly. Also, text may overprint other features in the map. These problems happen only on LaserJet printers that are using older Win95/WinNT PCL printer drivers.
For each Web site and CGI gateway, there is a limit to the number of features that can be processed. If the CGI gateway does not process all selected features (that is, you failed to receive the report you requested for all selected features), you have selected too many features for the present Web site and gateway to handle.
To remedy this problem, select fewer features, and then run the report again.
If you receive this error message, the Autodesk MapGuide Server that provides the data for the map you are viewing is probably using a slow connection. To remedy this problem, please inform the server administrator that you have received this error message and that Autodesk MapGuide Server needs to be reconfigured to use the NSAPI or ISAPI version of the map agent.
When Autodesk MapGuide Viewer asks your Web browser to display a URL in a window, it has little control over how the window is displayed. When a map is loaded, the Web browser window is sometimes displayed behind other windows, rather than in front as you would expect. This often happens when you minimize a window. This problem also occurs when Autodesk MapGuide displays an error message, because error messages display in a separate window.
To remedy this problem, close all other browser windows. If no additional browser windows are open when Autodesk MapGuide Viewer creates a new window, the new window automatically appears in front of any other program and document windows that are open.
If are using a very small-scale map (such as 1:1,000,000), you may notice that the scale is not precisely what you specified. With very small-scale maps, Autodesk MapGuide Viewer sometimes rounds the scale to a higher or lower value.
The legend width of the ActiveX control Viewer can be controlled from the API by using an existing property. The Plug-In and Java Edition do not have corresponding methods to change the Legend Width, so the Viewer legend width cannot be set for the Plug-In and Java Edition from the API. You can, however, use the LAYERSVIEWWIDTH URL parameter to set the legend width for the Plug-In and Java Edition Viewers.
If you are using the ActiveX Control Viewer, you will not be able to open reports whose names contain double quotation marks, for example "Server Report." You can, however, open reports whose names contain single quotation marks, for example 'Server Report.' Contact the author of the map if you have trouble opening reports.
Autodesk MapGuide Viewer Plug-In needs http:// at the beginning of URL links to correctly locate the Autodesk MapGuide Server and specified maps.
The following Autodesk MapGuide Viewer keyboard shortcut keys do not work on Apple Macintosh computers running MacOS 9 with Internet Explorer 5.0:
The following notes relate specifically to using Microsoft Internet Explorer.
With Microsoft Internet Explorer 5.x, if you set security to High, you will not be able to view maps.
To remedy this problem, in Microsoft Internet Explorer, choose View > Internet Options, and then set security to Medium.
If you install multiple copies of Autodesk MapGuide Viewer ActiveX Control in different locations, and you uninstall one of the copies, the \help directory and all of its files for that copy are not uninstalled. To remove these files, you must delete them manually.
If you try to print using Microsoft Internet Explorer's File > Print command, a blank space will appear on the printed page where the Autodesk MapGuide Viewer ActiveX Control resides.
To remedy this problem, use the Print > Print command (if available) from the popup menu in Autodesk MapGuide Viewer.
The Microsoft Internet Explorer 5.5 Print Preview command does not work with Autodesk MapGuide Viewer.
If you click the Stop button on the Microsoft Internet Explorer toolbar while the Autodesk MapGuide Viewer ActiveX Control is downloading map data, the download process will terminate. However, the ActiveX Control will continue to display the hourglass cursor. To remedy this, click the Stop button on the ActiveX Control toolbar to restore the normal cursor.
With Microsoft Internet Explorer 5.x, if you enter the path name of a map window file (MWF) in the address field (such as c:\maps\tutorial.mwf), or if you browse to it, the browser will not display the map. To work around this limitation, embed the MWF file in an HTML page, or add a link to the MWF file from an HTML page.
The following notes relate specifically to using Netscape Navigator.
If you are running Windows NT 4 with Service Pack 3, and you are using Netscape Navigator 4.03 or 4.04 as your browser, you should not use True Color mode as your display color palette, as it can cause intermittent problems using Autodesk MapGuide Viewer. Instead, in Display Settings in the Control Panel, change your color palette mode to 65536 or any setting other than True Color mode.
The following notes relate specifically to using the Java Edition of the Viewer.
Autodesk MapGuide Viewer Java Edition is missing Help buttons for dialog boxes, such as Preference, Zoom Goto, and Page Setup, and so on. To get dialog Help, either select the Help (?) icon or right click and select Help > Help Contents, then navigate to the appropriate dialog topic.
On some operating systems, in particular the Japanese OS, Autodesk MapGuide Viewer Java Edition installation may appear to fail. You may see a blank Autodesk MapGuide window at the end of installation, and when you hold the cursor over the window, the status bar reads:
load: com.autodesk.mgjava.MGMapApplet can't be instantiated.
However, the installation has in fact succeeded and Autodesk MapGuide Viewer Java Edition will run.
After installing the Autodesk MapGuide Viewer Java Edition, you may notice that in the Downloaded Program Files folder, the status column for the Autodesk MapGuide Viewer, Java Edition shows “Damaged”. This is caused by a problem with Internet Explorer. After you reboot the machine, the Java Edition will be shown as “Installed”.
The Java Edition of the Viewer does not run if you are using Microsoft Internet Explorer 5.x with Mac OS Runtime for Java (MRJ) 2.2. You need to upgrade to MRJ 2.2.4 or later.
If you zoom in on a map and then print the map, the printed map will appear as if you had not zoomed in.
Using certain commands such as Zoom Goto in the Java Edition can cause the cursor to go into a perpetual busy state, displaying an hourglass when the cursor is over the map window. To remedy this problem, click the Select button on the toolbar.
If you install Internet Explorer 6 Service Pack 1, the reporting feature of
Autodesk MapGuide Viewer Java Edition is disabled when targeting a frame on
the same page as the viewer. To avoid this problem, change the application to
show reports in a separate window. If you cannot change the application, you
can find generated reports as HTML files in C:\Documents and Settings\yourloginname\Local
Settings\Temp.
If you are using the Java Edition of Autodesk MapGuide Viewer with Internet Explorer and you click outside any Autodesk MapGuide Viewer dialog box, the dialog box will go behind the Internet Explorer window.
When using Microsoft Internet Explorer 5.x, you might have trouble loading maps in the Java Edition of Autodesk MapGuide Viewer. This can happen when your Web page uses percentages instead of fixed width and height values to display the Java Edition Viewer. You can prevent this problem by not using percentages. If you decide to use percentages and the problem does occur, try the following procedure until the problem is remedied:
Additionally, you should always wait for the map to load completely before exiting the browser, as this can cause the application to fail.
Unlike the Plug-In and ActiveX Control, the Java Edition Viewer does not display different cursors for many operations. The Java Edition Viewer uses only a selection cursor, a pan cursor, and a general cursor for all other operations.
The Java Edition Viewer does not recognize changes you make using the Regional Settings Properties Control Panel. For example, if you change the date format or the decimal symbol, the Java Edition Viewer will not use the new settings.
If you zoom in on a map and then use the browser's Refresh or Reload command, the map is redrawn at the current scale rather than returning to the original scale.
If you receive an error message while using the Java Edition Viewer, be sure to close the error message before closing the browser. Although you can close the error message after closing an Internet Explorer browser, you cannot close the error message after closing a Netscape browser. If you inadvertently close a Netscape browser while an error message is on the screen, you will need to press CTRL+ALT+DEL and end the task.
When you set page setup options (such as changing the page orientation from Portrait to Landscape) and print a map in the Java Edition Viewer, the Page Setup options will be reset to their default state the next time you print the map. To print the map again with the same settings, you will need to specify the settings again before printing.
If you use your browser's Print command in the Java Edition Viewer, you may get a blurry or blank printout. To avoid this problem, always use the Print command in the Viewer popup menu.
When printing polypolygons from Netscape 4.x using the Print command in the Java Edition Viewer popup menu, you may find connecting lines between the polypolygons on the printout. To avoid this problem, use a different browser.
If you print using the Java Edition Viewer from a Macintosh OS computer, you may notice that legend labels are cut off in the printed map.
The API call to View Reports does not work on the MacOS/MRJ 2.2 platform, but does work for the View Reports button and popup menu. Unlike Netscape and IE on the Windows platform, Apple's MRJ virtual machine uses the standard JDK 1.1 applet security mechanism. Unless the applet is signed or put into the Java Runtime library directory, the applet will run inside a sandbox and will not have access to the local file system. For more information, see Apple's MRJ Technotes TN 1175: Applet signing with MRJ and JavaKey.
If you are using the Java Edition Viewer with Microsoft Internet Explorer, you may notice the same commands appearing multiple times in the popup menu. If this happens, you may need to update your version of the Java Virtual Machine. Following are the versions of the Java Virtual Machine that are required for Internet Explorer:
| Internet Explorer Version | Java Virtual Machine Build |
|---|---|
| Internet Explorer 5 | Build 3193 |
| Internet Explorer 5.01 | Build 3240 |
You can download the Java Virtual Machine builds from the Microsoft Web site.