The following general notes include known problems or issues with using Autodesk MapGuide Viewer Release 5.
Displaying Selected Features Under Raster Layers
VBA Not Supported in Release 5
Problems with HP LaserJet Printers
Printing Problems with PCL Printer Drivers
Viewing a Report for Multiple Features
Error Message "Missing parameter 'ITEM'"
Web Browser Window Displaying Behind Other Windows
Issues with Microsoft Internet Explorer
Issues with Netscape Communicator
Issues with the Java Edition of the Viewer
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 5 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" 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 might print outside of the map boundary and might not clip properly. This problem happens 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 following notes relate specifically to using Microsoft Internet Explorer.
With Microsoft Internet Explorer 4.0 or 5.0, 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 Active X Control resides.
To remedy this problem, use the Print > Print command (if available) from the popup menu in Autodesk MapGuide Viewer.
If you click the Stop button on the Microsoft Internet Explorer 4.0 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 4.0, 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 Communicator.
If you are running Windows NT 4 with Service Pack 3, and you are using Netscape Communicator 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.
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 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 4 or 5, 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 each of the following steps in order 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 dialog box 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.
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 the various versions of Internet Explorer:
| Internet Explorer Version | Java Virtual Machine Build |
|---|---|
| Internet Explorer 4.01 | Build 2445 |
| Internet Explorer 5 | Build 3193 |
| Internet Explorer 5.01 | Build 3240 |
You can download the Java Virtual Machine builds from the Microsoft web site.
Microsoft and ActiveX are registered trademarks of Microsoft Corporation in the United States and/or other countries.
Netscape and Netscape Navigator are registered trademarks of Netscape Communications Corporation in the United States and other countries. Netscape Communicator is also a trademark of Netscape Communications Corporation, which may be registered in other countries.
All other brand names, product names, or trademarks are the property of their respective owners.
Revised: June 9, 2000