What's New

What's New in Release 6.0

This release of the Autodesk MapGuide Viewer API includes one new object and several new and changed methods and properties. This topic lists these changes and additions and describes what features they support. When using the API reference and index, you can also identify which objects, methods, and properties are new by looking for the symbol. To identify methods and properties that have been changed, look for the symbol. For a list of methods and properties that have been replaced in this and earlier releases, see Replaced Methods and Properties.

Note: The version number of this release is 6.0. You can also determine the version programatically using the getApiVersion method.

New and Enhanced Features

Release 6.0 provides the following new and enhanced features. Each of these are described in more detail in the following sections:

Autodesk DWG Data Source Support
Enhanced Support for Map Redraw Operations
Symbol Bitmap Support
Map Mode Retrieval Support

Autodesk DWG Data Source Support

Several changes and additions were made to Autodesk MapGuide and the Autodesk MapGuide Viewer API Help to support Autodesk drawing (DWG) data sources. The most significant addition is a new MGDwgDataSources object. Methods and properties were also added or changed in MGMapLayerSetup to support DWG data sources.

MGDwgDataSources Methods and Properties
getDataSource	Gets the DWG data source name that establishes a connection between Autodesk MapGuide Server and the data provider.
getDwg	Gets the Autodesk DWG file name or project file for the Autodesk DWG layer.
getKeyColumn	Gets the name of the column that contains the primary key for each map feature on the DWG layer.
getKeyColumnType	Gets the DWG key column data type.
getKeyTable	Gets the name of the DWG key table to use as primary keys for either map feature properties, external database links, or object data in the Autodesk DWG.
getLayerFilter	Gets the layer filter, which specifies which layers to extract from the specified Autodesk DWG or project file.
getNameColumn	Gets the name of the column that contains the name for each map feature.
getNameTable	Gets the name of the DWG table for MapTips about map feature properties, external database links, or object data in the Autodesk DWG.
getUrlColumn	Gets the name of the column that contains the URL associated with each map feature.
getUrlTable	Gets the name of the DWG URL table containing URLs to which Autodesk DWG map features are linked.
setDataSource	Sets the DWG data source name that establishes a connection between Autodesk MapGuide Server and the data provider.
setDwg	Sets the Autodesk DWG file name or project file for the Autodesk DWG layer.
setKeyColumn	Sets the name of the column that contains the primary key for each map feature on the DWG layer.
setKeyColumnType	Sets the DWG key column data type.
setKeyTable	Sets the name of the DWG key table to use as primary keys for either map feature properties, external database links, or object data in the Autodesk DWG.
setLayerFilter	Sets the layer filter, which specifies which layers to extract from the specified Autodesk DWG or project file.
setNameColumn	Sets the name of the column that contains the name for each map feature.
setNameTable	Sets the name of the DWG table for MapTips about map feature properties, external database links, or object data in the Autodesk DWG.
setUrlColumn	Sets the name of the column that contains the URL associated with each map feature.
setUrlTable	Sets the name of the DWG URL table containing URLs to which Autodesk DWG map features are linked.
DataSource	Gets or sets the DWG data source name that establishes a connection between Autodesk MapGuide Server and the data provider.
Dwg	Gets or sets the Autodesk DWG file name or project file for the Autodesk DWG layer.
KeyColumn	Gets or sets the name of the column that contains the primary key for each map feature on the DWG layer.
KeyColumnType	Gets or sets the DWG key column data type.
KeyTable	Gets or sets the name of the DWG key table to use as primary keys for either map feature properties, external database links, or object data in the Autodesk DWG.
LayerFilter	Gets or sets the layer filter, which specifies which layers to extract from the specified Autodesk DWG or project file.
NameColumn	Gets or sets the name of the column that contains the name for each map feature.
NameTable	Gets or sets the name of the DWG table for MapTips about map feature properties, external database links, or object data in the Autodesk DWG.
UrlColumn	Gets or sets the name of the column that contains the URL associated with each map feature.
UrlTable	Gets or sets the name of the DWG URL table containing URLs to which Autodesk DWG map features are linked.

MGMapLayerSetup DWG Methods and Properties
getDataFile	Returns the name of the data file from which Autodesk MapGuide Server retrieves the map data for this map layer. Support for Autodesk DWG layers was added. This methods returns the Autodesk DWG file. This use of this method is retained in this release for backward compatibility and will be deprecated in the next release. Instead, you should use the MGDwgDataSources getDwg method.
getDwgDataSources	Returns the MGDwgDataSources object for this layer. Support for DWG layers was added. This will set the Autodesk DWG file. This use of this method in this release is retained for backward compatibility and will be deprecated in the next release. Instead, you should use the MGDwgDataSources setDwg method.
setDataFile	Sets the name of the data file from which Autodesk MapGuide Server retrieves data for this map layer.
DataFile	Gets or sets the name of the data file from which Autodesk MapGuide Server retrieves map data for this map layer. Support for DWG layers was added. This property will get or set the Autodesk DWG file. This use of this property is retained in this release for backward compatibility and will be deprecated in the next release. Instead, you should use the MGDwgDataSources Dwg property.
MGDwgDataSources	Returns the MGDwgDataSources object for this layer.

Enhanced Support for Map Draw Operations

New methods and a property were added to MGMap to allow more control over how frequently, and under what conditions, Autodesk MapGuide Viewer draws a map. Maps are now updated every 1.5 seconds by default, which allows the end user to view changes to the map as it is being drawn instead of waiting until the entire map is rendered.

MGMap Intermediate Updates Methods and Property
getIntermediateUpdatesEnabled	Gets the current setting of the intermediate updates flag.
setIntermediateUpdatesEnabled	Specifies whether or not the map window should update every 1.5 seconds during a drawing operation or only at the end of the operation when all data has been loaded and rendered.
IntermediateUpdatesEnabled	Specifies whether or not the map window should update every 1.5 seconds during a drawing operation or only at the end of the operation when all data has been loaded and rendered.

Symbol Bitmap Support

Changes were made to MGSymbolAttr methods and properties to support bitmaps in symbols.

MGSymbolAttr Bitmap Support Methods and Properties
setRotation	Sets the rotation of the point. This method was changed to return an error if the symbol contains a bitmap since such symbols cannot be rotated.
setSymbol	Sets the symbol to be used as the symbol attribute. This method was changed so that if the specified symbol contains bitmaps, and the current rotation angle is non-zero, the symbol will be set, and the rotation angle will be set to zero.
Rotation	The rotation of the point, in degrees.This property was changed to return an error if the symbol contains a bitmap since such symbols cannot be rotated.
Symbol	The symbol to be used as the point attribute. This property was changed so that if the specified symbol contains bitmaps, and the current rotation angle is non-zero, the symbol will be set, and the rotation angle will be set to zero.

Map Mode Retrieval Support

A new method and property was added to MGMap to allow retrieval of a map's mode (zoom, pan, and so on).

MGMap Mode Retrieval Method and Property
getMode	Gets the current mode of the Autodesk MapGuide Viewer.
Mode	Gets the current viewer mode of the map, such as ZoomIn, Digitize, Pan, and so on.

New and Enhanced Features

Autodesk DWG Data Source Support

MGDwgDataSources Methods and Properties

MGMapLayerSetup DWG Methods and Properties

Enhanced Support for Map Draw Operations

MGMap Intermediate Updates Methods and Property

Symbol Bitmap Support

MGSymbolAttr Bitmap Support Methods and Properties

Map Mode Retrieval Support

MGMap Mode Retrieval Method and Property