Professional Documents
Culture Documents
Customization Roadmap
February 2008
© 2008 Autodesk, Inc. All Rights Reserved. Except as otherwise permitted by Autodesk, Inc., this publication, or parts thereof, may not be
reproduced in any form, by any method, for any purpose.
Certain materials included in this publication are reprinted with the permission of the copyright holder.
Trademarks
The following are registered trademarks or trademarks of Autodesk, Inc., in the USA and other countries: 3DEC (design/logo), 3December,
3December.com, 3ds Max, ActiveShapes, Actrix, ADI, Alias, Alias (swirl design/logo), AliasStudio, Alias|Wavefront (design/logo), ATC, AUGI,
AutoCAD, AutoCAD Learning Assistance, AutoCAD LT, AutoCAD Simulator, AutoCAD SQL Extension, AutoCAD SQL Interface, Autodesk, Autodesk
Envision, Autodesk Insight, Autodesk Intent, Autodesk Inventor, Autodesk Map, Autodesk MapGuide, Autodesk Streamline, AutoLISP, AutoSnap,
AutoSketch, AutoTrack, Backdraft, Built with ObjectARX (logo), Burn, Buzzsaw, CAiCE, Can You Imagine, Character Studio, Cinestream, Civil
3D, Cleaner, Cleaner Central, ClearScale, Colour Warper, Combustion, Communication Specification, Constructware, Content Explorer,
Create>what's>Next> (design/logo), Dancing Baby (image), DesignCenter, Design Doctor, Designer's Toolkit, DesignKids, DesignProf, DesignServer,
DesignStudio, Design|Studio (design/logo), Design Your World, Design Your World (design/logo), DWF, DWG, DWG (logo), DWG TrueConvert,
DWG TrueView, DXF, EditDV, Education by Design, Exposure, Extending the Design Team, FBX, Filmbox, FMDesktop, Freewheel, GDX Driver,
Gmax, Heads-up Design, Heidi, HOOPS, HumanIK, i-drop, iMOUT, Incinerator, IntroDV, Inventor, Inventor LT, Kaydara, Kaydara (design/logo),
LocationLogic, Lustre, Maya, Mechanical Desktop, MotionBuilder, Mudbox, NavisWorks, ObjectARX, ObjectDBX, Open Reality, Opticore,
Opticore Opus, PolarSnap, PortfolioWall, Powered with Autodesk Technology, Productstream, ProjectPoint, ProMaterials, Reactor, RealDWG,
Real-time Roto, Recognize, Render Queue, Reveal, Revit, Showcase, ShowMotion, SketchBook, SteeringWheels, StudioTools, Topobase, Toxik,
ViewCube, Visual, Visual Bridge, Visual Construction, Visual Drainage, Visual Hydro, Visual Landscape, Visual Roads, Visual Survey, Visual Syllabus,
Visual Toolbox, Visual Tugboat, Visual LISP, Voice Reality, Volo, Wiretap, and WiretapCentral
The following are registered trademarks or trademarks of Autodesk Canada Co. in the USA and/or Canada and other countries: Backburner,
Discreet, Fire, Flame, Flint, Frost, Inferno, Multi-Master Editing, River, Smoke, Sparks, Stone, and Wire
All other brand names, product names or trademarks belong to their respective holders.
Disclaimer
THIS PUBLICATION AND THE INFORMATION CONTAINED HEREIN IS MADE AVAILABLE BY AUTODESK, INC. "AS IS." AUTODESK, INC. DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE REGARDING THESE MATERIALS.
iii
Chapter 4 Autodesk Geospatial APIs . . . . . . . . . . . . . . . . . . . . . 23
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
AutoCAD Map 3D APIs . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Autodesk MapGuide Enterprise and MapGuide Open Source
APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Geospatial Platform API Concepts . . . . . . . . . . . . . . . . . . . . 30
Autodesk Topobase APIs . . . . . . . . . . . . . . . . . . . . . . . . . . 33
FDO Data Access Technology . . . . . . . . . . . . . . . . . . . . . . . 36
AutoCAD Raster Design API . . . . . . . . . . . . . . . . . . . . . . . . 37
Autodesk Design Review API . . . . . . . . . . . . . . . . . . . . . . . 37
Autodesk RealDWG API . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Autodesk DWF Toolkit . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
iv | Contents
Autodesk Geospatial
Applications 1
Overview
Custom geospatial solutions work with data from multiple sources that are
created using diverse applications in complex workflows. Integrating geospatial
technology into a customer’s business process presents significant challenges
when the integrity of requirements and data may be in doubt. Developers rely
on technical documentation, examples, and shared community expertise to
pick the right tools for successful delivery.
Autodesk provides a complete line of products designed to meet the challenges
of successful solution development in complex environments. The products
work with geospatial and engineering data, in multiple formats and across
multiple systems. A diverse set of application programming interfaces (APIs)
and scripting tools allows products to be customized to add new features,
improve workflow integration, or access new types of data.
In this guide you will find:
1
Geospatial Product Line
The Autodesk geospatial product line covers a range of functionality, including
products for creating, editing, deploying, and analyzing geospatial data on
the desktop or across the Internet.
Core Geospatial Products
Product Description
All the core geospatial products include Feature Data Objects (FDO) Data
Access Technology. FDO is an API for manipulating, defining, and analyzing
geospatial information regardless of where it is stored. FDO uses a
RELATED For more information about AutoCAD Map 3D, see the following:
■ www.autodesk.com/map3d
■ mapguide.osgeo.org
Autodesk Topobase
Autodesk Topobase provides infrastructure design and asset management
capabilities to users throughout an organization. You can use Autodesk
Topobase to plan, design, and analyze geometric and attribute data graphically
using the full capabilities of AutoCAD Map 3D and AutoCAD.
Autodesk Topobase | 5
Autodesk Topobase components
RELATED For more information about Autodesk Topobase, see the following:
■ www.autodesk.com/topobase
RELATED For more information about AutoCAD Raster Design, see the following:
■ www.autodesk.com/rasterdesign
NOTE Autodesk Design Review and DWG TrueView work with drawing objects,
but not with AutoCAD Map 3D object data and other additions. FDO data must
be converted to CAD drawing objects before it is visible to Autodesk Design Review
or DWG TrueView. See Data Types on page 11 for details about CAD drawing
objects and geospatial data.
■ View, print, and publish DWF, DWG, DXF, DGN, JT, raster files
RELATED For more information about Autodesk Design Review, see the following:
■ www.autodesk.com/designreview
Autodesk RealDWG
The RealDWG developer toolkit is a software library that allows C++ and .NET
developers to read and write AutoCAD DWG and DXF files. This technology
was formerly known as ObjectDBX™.
RealDWG is a subset of ObjectARX and contains the APIs for reading and
writing AutoCAD DWG and DXF files. RealDWG is a self-contained toolkit
that may be invoked within stand-alone software development environments
and does not contain either data viewing capability or access to the AutoCAD
User Interface.
NOTE RealDWG works with drawing objects, but not with AutoCAD Map 3D
object data or other extensions on CAD drawing elements. It cannot read or write
any of the geospatial data managed with FDO. See Data Types on page 11 for
details about CAD drawing objects and geospatial data.
RELATED For more information about the Autodesk DWF Toolkit, see the following:
■ www.autodesk.com/dwftoolkit
Data Types
Common data types used in geospatial workflows include:
■ CAD data
CAD Data
CAD data refers to the lines and symbols on a typical drafting page. A standard
CAD drawing contains all its data within a single file, such as an AutoCAD DWG
file. This makes it convenient to edit the file, but it limits the amount and types
of data that can be stored together.
Objects in a CAD drawing are called drawing objects, DWG objects, or AutoCAD
entities. The objects are formed by lines and shapes on the page. The positioning
of graphic objects in a drawing may represent the location of objects in the real
world, but this is not necessarily the case. Although CAD drawings are generally
11
organized into layers, with similar types of objects on the same layer, this is
not a strict requirement. For example, a single layer might contain both the
drawing elements that represent hydrants and the water lines connecting
them. In a CAD drawing, the hydrant and water line layer may even include
the graphic representation of labels and attributes, referred to as annotation.
Each individual object or annotation can have its own unique style.
Data Types | 13
DWF
One additional data format that should be discussed is the Design Web Format
(DWF), which Autodesk developed as a specialized data format used for storing
and sharing map and design drawing data. A single DWF file can contain a
particular representation of an AutoCAD drawing or AutoCAD Map 3D map,
somewhat like an electronic version of a single printed map.
DWF is used primarily for output. It contains a visual representation of the
data, but it does not have the additional information that describes individual
features or their attributes. This results in a much smaller file size, which makes
it an excellent way to distribute maps and other drawings.
Autodesk Design Review offers a way for users of Autodesk technology to add
annotation to a DWF file without altering any of the original data. Using
Design Review, technical and nontechnical users can collaboratively share,
review, and mark up drawings.
■ www.autodesk.com/dwf-developers
■ www.autodesk.com/dwftoolkit
Data Sources
GIS data is found in more diverse sources and formats than CAD data. A
complex geospatial workflow may include the use of GIS data from files on
the local file system, from data in a relational database, and even from data
on the Web.
Common GIS data sources include:
■ File-based data
■ Relational databases
■ Web services
File-based data sources are stored in individual files or sets of files on a user’s
personal computer or a local network.
CAD data is file-based. In a standard CAD workflow, each drawing is a
self-contained file. Objects can be copied from other drawings, but the copied
objects do not retain any link to the source objects.
AutoCAD Map 3D adds additional functionality for working with CAD data
from multiple drawings. Using AutoCAD Map 3D, a single DWG file can attach
other DWG files and “query in” objects for display or editing. These attached
DWGs can be shared between multiple users. For example, a DWG containing
road locations for a community can be attached to other DWG files for water
and utilities. Changes to the road data will show in any other drawings that
attach the road data.
Other file-based data sources are designed to store geospatial feature data. A
good example of this is Spatial Data Format (SDF), which is used in many
Autodesk geospatial products. SDF is an open format that can be read and
written using a standard FDO provider. It offers many of the advantages of a
full relational database, but with simpler administration.
Raster data is often stored in individual files, using formats like TIFF, GIF,
PNG, JPEG, and JPEG 2000. Some of these formats contain internal
georeferencing data, but others require an external World File or some other
method.
Relational Databases
Some relational databases, such as Oracle, have been adapted for storing
geospatial data. These “spatial databases” have additional functionality for
managing geographic data, including the ability to store GIS feature data and
create queries using geometric comparison. For example, using a spatial
database, it is possible to find all features that lie within a geographic area, or
that cross a certain road, without invoking a traditional GIS application to
perform the spatial analysis.
Because spatial databases have been optimized for data retrieval and editing,
access may be faster than by using other methods when working with large
quantities of data. Applications working with large data sets or that have large
numbers of users will often require the use of a relational database for the
storage of some geographic and attribute information.
Both feature data and raster data can be stored in spatially enabled relational
databases. Many geospatial workflows also require the analysis of non-spatial
Data Sources | 15
attribute data combined with geographic features. In modern enterprise
systems, most non-spatial attribute data is stored in relational databases.
Through FDO, many Autodesk applications have the capability to access both
spatial and non-spatial data stored in relational databases.
Web Services
RELATED For more information about WMS and WFS, see the following:
■ www.opengeospatial.org/standards/wms
■ www.opengeospatial.org/standards/wfs
■ www.opengeospatial.org/standards/gml
AutoCAD Map 3D
One of the strengths of AutoCAD is the way its technology can be incorporated
into other products such as AutoCAD Map 3D. AutoCAD Map 3D is a stand-alone
application, built on top of AutoCAD, that behaves as a desktop application.
Customization of AutoCAD Map 3D always requires the invocation of the full
AutoCAD Map 3D application.
17
As shown below, AutoCAD Map 3D extends the functionality of AutoCAD in
a few different ways:
AutoCAD Map 3D
Managing maps and layers
Reading and writing geospatial data via FDO
Analyzing and manipulating using the Geospatial Platform API
Styling geospatial data
Attaching object data to drawing objects
Classifying drawing objects
Combining drawing objects from multiple DWG files
AutoCAD
Standard CAD operation for creating and editing drawing objects
Basic framework for customization, adding commands and menus
The server tier handles data access and manages the resources on the site. The
site server controls access to the resources based on user and group
identification. It also performs computationally intensive operations like
creating and rendering maps.
The web tier manages communication between the server tier and the client
tier. The web tier includes the MapGuide Web Server Extensions, which are
accessed through the Web API. This API includes the Geospatial Platform API
for data access and analysis, plus classes and methods specific to MapGuide.
■ www.autodesk.com/mapguidestudio
■ mapguide.osgeo.org/downloads.html
Autodesk Topobase
Topobase provides organization-wide access to spatial information from
engineering, GIS, operations, and business teams. Data is stored in an Oracle
Spatial database, which provides the security, integrity, and performance
required for an enterprise-level application. The Topobase desktop client is
built on AutoCAD Map 3D, with additional industry-specific modules. The
Oracle Spatial
Application Server Client
Relational Database
Topobase
Administrator
User Management/
Oracle Security
Partner App
Wastewater
Legacy GIS
Electric
Survey
Water
Data Models
Land
Gas
Topobase Client
Includes Map 3D
Workflows/
Business Rules
Partner App
Wastewater
Electric
Survey
Water
CRM
Land
Jobs
Gas
DWF/AJAX
(long transactions)
Topobase Web Web browser
Includes MapGuide Enterprise
Topology DWF/AJAX
ERP
The following table shows the API components that together make up the
Topobase API.
Map API
Utility API
Autodesk Topobase | 21
API component Applies to: Technology
Workflows API
Map 3D ObjectARX API C++, .NET Working with drawing objects, object data,
and drawing sets.
Geospatial Platform API .NET Working with geospatial feature data, co-
ordinate systems, and geometric analysis
23
API Language Customization Capabilities
FDO (Feature Data Objects) C++, .NET Advanced functionality for working with
API geospatial feature data sources.
Geospatial Platform API ASP.NET, Working with geospatial feature data, co-
PHP, Ja- ordinate systems, maps, layers, and geo-
va/JSP metric analysis.
AutoCAD ObjectARX API C++, .NET Full customization of the AutoCAD environ-
ment, including:
■ Accessing the AutoCAD database
■ Interacting with the AutoCAD editor
■ Creating user interfaces using the Mi-
crosoft Foundation Classes (MFC)
■ Supporting the multiple document in-
terface (MDI)
■ Creating custom classes
■ Building complex applications
■ Interacting with other programming
environments
AutoCAD ActiveX API VB, VBA Basic automation using standard AutoCAD
objects. Can also be integrated with other
applications that use VBA, such as Mi-
crosoft Office.
Overview | 25
API Language Customization Capabilities
Legacy APIs
The legacy APIs provide simple automation, but are not recommended for new application
development.
Map 3D ActiveX API
Map 3D AutoLISP API
AutoCAD ActiveX API
AutoCAD AutoLISP API
New application development should use the .NET APIs wherever possible.
These provide access to the most complete functionality.
The Feature Data Objects (FDO) Data Access Technology is used internally by
the Geospatial Platform API of AutoCAD Map 3D. FDO uses a provider-based
model for reading and writing geospatial data. AutoCAD Map 3D ships with
FDO providers that can be used with most standard geospatial data formats.
See FDO Data Access Technology on page 36 for details.
FDO is an open source project of the Open Source Geospatial Foundation,
fdo.osgeo.org. In addition to source code and binaries, this site also includes
additional providers.
Documentation for the FDO API is installed with AutoCAD Map 3D. The
assemblies and other components required to use the API are included with
the AutoCAD Map 3D SDK, which is available from the Developer Center at
www.autodesk.com/developer.
The AutoCAD ObjectARX API is available as a C++ API or a .NET API. The .NET
API is a managed wrapper for the C++ API, offering equivalent functionality.
The AutoCAD Object ARX APIs are included in the AutoCAD SDK, which is
available from the Developer Center at www.autodesk.com/developer.
The AutoCAD Map 3D ObjectARX API is available as a C++ API or a .NET API.
The .NET API is a managed wrapper for the C++ API, offering equivalent
functionality. Note that the organization of the .NET API is somewhat different
from the C++ API, to make it follow the standard .NET model more closely.
The AutoCAD Map 3D Object ARX APIs are included with the AutoCAD Map
3D SDK, which is available from the Developer Center at
www.autodesk.com/developer. They also require the AutoCAD ObjectARX APIs.
NOTE The AutoCAD Map 3D ObjectARX APIs rely on the AutoCAD ObjectARX
APIs for core functionality. Both SDKs, for AutoCAD and for AutoCAD Map 3D,
must be installed in the same folder. The AutoCAD SDK is installed first because
some components of the AutoCAD Map 3D SDK replace versions in the AutoCAD
SDK.
Legacy APIs
The AutoCAD Map 3D ActiveX and AutoLISP APIs cover Autodesk Data
Extension functionality (ADE), which includes drawing sets, queries, and
object data. The AutoCAD Map 3D AutoLISP API also covers map plotting and
topology. These APIs do not include functions for newer AutoCAD Map 3D
features, such as access to geospatial data through FDO. Because of this, they
can be used for some basic automation, but should not be used for new
application development. The legacy APIs are installed with AutoCAD Map
3D. Documentation is available from the Help menu.
Web API
The Web API is available to applications running on the web tier. It includes
the Geospatial Platform API plus some classes and methods that are specific
to MapGuide. See Geospatial Platform API Concepts on page 30 for more
details about the Platform API.
The Web API is available in ASP .NET, Java/JSP, and PHP.
Viewer API
The Viewer API is a JavaScript API used by the AJAX Viewer and the DWF
Viewer. Nearly all calls are identical between the two Viewers.
The Viewer API contains methods for panning, zooming, digitizing, and other
interaction with the Viewer. It also contains methods for submitting requests
to the Web tier.
Most MapGuide custom applications will use a combination of Web API and
Viewer API calls.
Studio API
The Studio API is a .NET API used by Autodesk MapGuide Studio for loading
data into the site repository. Use this API to automate load procedures for
external data sources.
The Feature Data Objects (FDO) API is used internally by the Geospatial
Platform API in Autodesk MapGuide Enterprise and MapGuide Open Source.
There should be no need for most applications to program directly against
this API.
■ Standardized methods for reading and writing data from different sources,
including SHP, SDF, and Oracle Spatial databases.
For AutoCAD Map 3D, the Geospatial Platform API is available as a .NET API,
and can be called from any .NET language. For MapGuide Enterprise and
MapGuide Open Source, the Geospatial Platform API is available in ASP .NET,
Java/JSP, and PHP. There are minor differences due to the syntaxes of the
languages, but other than that the API is consistent across all languages.
MapGuide has the simplest implementation because it works exclusively with
feature sources managed by FDO. AutoCAD Map 3D is more complex because
it also works with CAD drawing objects.
Resources in the Geospatial Platform API are XML streams that define the
components of a map. Some of the different resource types are:
Resources are managed by the Resource Service. Working with the resource
service requires reading, writing, and modifying the XML. Other services use
the resources. For example, the Feature Service uses FeatureSource resources
when it connects to FDO data sources.
MapDefinition
Stylization
LayerDefinition
Feature Service
FeatureSource
Definition
FDO
Config Files
Resource Service
MapDefinition
Stylization
LayerDefinition
Config Files
FDO
Resource Service
MapDefinition
Stylization
LayerDefinition
Config Files
FDO
Resource Service
Oracle Spatial
Plug-ins
Client API
The Topobase Client API is 100% managed code and provides access to key
components of Topobase. For example, the API enables you to insert, modify,
and delete features, and to work with topics (groups of feature classes) and
domains (sets of values defined for feature attributes).
Data layer
As well as support for standard database transactions, the Topobase API fully
supports Oracle Spatial for managing geospatial objects and data in an Oracle
Database. It reads and writes features (rows) and provides typed access to
feature classes (tables). The long transactions interface includes routines for
Map layer
For map services and coordinate systems transformations, the map interface
of the Topobase API includes over fifty methods that work as they do in
AutoCAD Map 3D, for client-side operations, and as they do in MapGuide
Enterprise for the Web.
The Topobase Forms API gives you access to Topobase forms and controls.
These are the principal means for editing, viewing, and analyzing Topobase
feature data. Using the API, you can manipulate the location of controls and
elements on the forms to meet your own requirements.
Vertical modules
Several Topobase API components help you develop new Vertical Application
Modules:
■ Workflows
■ Feature rules
Workflows
The Topobase Workflows API enables you to create custom plug-ins that use
workflows to guide users through complex tasks, such as data acquisition,
analysis, and reporting.
Feature rules
Feature rules are methods and triggers for processing data according to
predefined algorithms. The methods and triggers operate when certain events
occur and you can use them to control tasks such as checking data consistency,
correcting data, or to add new capabilities.
The Topobase server-side API enables you work directly with the Oracle
database using Java and PL/SQL. The API includes Java packages with classes
and methods for data management and for working with geometry, features,
and topology.
■ Creating applications that use the FDO API to read and write feature data
Working with data from a new format simply requires using a provider for
that format. There is no need to make any changes to the main application.
The FDO provider model includes support for the following types of data:
The FDO API provides methods for querying the capabilites of a provider, to
determine what kinds of data it handles and what can be done with the data.
FDO is used internally in AutoCAD Map 3D, Autodesk MapGuide Enterprise,
MapGuide Open Source, and Autodesk Topobase for access to geospatial data.
The standard APIs for these products can handle most data access, but the
■ List—Retrieving the object id of the image from model space or paper space
Detailed information about the Raster Design ActiveX interface may be found
in the Autodesk Raster Design ActiveX Reference help file that is installed with
the product. The help file contains detailed examples covering nearly every
object and method that is discussed.
The Autodesk Design Review APIs give you programmatic access to many of
the objects that make up the application. You can embed controls in Microsoft
Internet Explorer and Microsoft Office applications, and then use Visual Basic
.NET, Visual C# .NET, and JavaScript to customize the controls.
If you want to build applications to work with DWF files, the specification of
Design Web Format files is publically available and the DWF Toolkit includes
C++ samples that demonstrate how to read and write DWF files.
The DWF Toolkit comprises four components that provide cross-platform
(Microsoft Windows, Apple Mac OS, Linux) support, in both 32-bit and 64-bit
environments:
Using the DWF Toolkit you can write applications that can perform the
following tasks:
The current version of the toolkit handles DWF files generated by AutoCAD
2008 and other Autodesk design software.
The DWF Toolkit is available from www.autodesk.com/dwftoolkit.
AutoCAD Map 3D
BuildMap
41
also includes a few additional commands for changing how the layers are
displayed.
BuildMap Output
FindIntersects
The FindIntersects sample loads external data representing roads in a city. The
roads are made up of road segments, where each segment is a feature in the
feature class.
FindIntersects is very similar to FindIntersectsMG, which works with Autodesk
MapGuide Enterprise. This is a good example of how the Geospatial Platform
API spans the different products.
Running the FindIntersects command creates another layer in the map, with
points showing where road segments intersect.
GenerateAnnotation
InputEditor
The NetworkTrace sample loads data representing a road network. The user
selects a start point and an end point in the network, and the application
traces a path on the network between the two points.
NetworkTrace Output
PolygonOperation
■ Difference
■ Union
■ Intersection
■ Subtraction
PolygonOperation Difference
PolygonOperation Intersection
SpiderNetwork
The SpiderNetwork sample loads data from two separate SDF files. One of the
files contains point data representing the locations of police stations and the
other file contains point data representing the locations of crime scenes. The
feature class for the crime scenes also contains attribute data that identifies
the police station that responded to the crime.
Running the spider network command creates a third layer that contains lines
connecting the crime locations with the responding police stations.
This demonstrates how to combine data from different feature classes.
This sample shows how to display a map and how to handle simple user
interaction. If the user clicks a link beside the map, the sample retrieves and
displays information about the map.
This sample shows different ways of calling MapGuide Viewer API functions.
■ Custom buttons are added to the tool bar, task list, and context menu.
When the user clicks the button, the sample calls the Viewer API’s
ZoomToView() method to reposition the map to a specific location.
■ The sample also shows how to call the same method from links in the task
pane beside the map.
This sample shows how to control a map’s layers through the API.
■ Layer Visibility
This sample shows how to retrieve information about a map’s layers. When
the user clicks a link, it lists the map’s layers and their current visibility
status.
This example shows how to work with the map’s underlying data.
■ Query Features
Shows how to list particular features, for example all the properties owned
by a specified person.
These examples shows how to manipulate maps and the map’s layers.
This example show various ways you can analyze the map’s data.
■ Create Buffer
Creates a buffer around a selected parcel. The buffer is drawn on the map
and shows all the parcels within a specified distance from the selected
parcel.
This example shows how to respond to a user’s input as they click or drag on
the map.
■ Digitizing
Shows how to convert a user’s mouse clicks to map coordinates.
■ Redlining
Shows how to enable the user to draw lines on a map.
Custom Output
This sample shows how to prepare versions of the map ready for printing or
electronic distribution.
■ Property Report
Shows how to create a printable page with an image insert of a selected
property.
■ eMap
Shows how to create and display an eMap, which is a form of DWF that
contains metadata that allows a DWF viewer to connect to the MapGuide
server to display the map. An eMap is a compact format, but it requires
access to the MapGuide map agent via the Internet or a company intranet.
■ ePlot
Shows how to create and display an ePlot, which is designed for offline
viewing and printing. Each map sheet in an ePlot is a complete map image
that can be viewed offline using Autodesk Design Review.
■ Multi Plot
Viewer Samples
The Viewer samples are more complex than the Developer Guide samples.
They show some techniques for application development using Autodesk
MapGuide Enterprise. Functionally, these three samples are the same, but they
demonstrate different Viewer technology. The samples are:
■ DwfLoadProcedure Class
■ DwgComponent.Children Property
■ DwgLoadProcedure Class
■ RasterLoadProcedure Class
■ SdfLoadProcedure Class
■ ShpLoadProcedure Class
Autodesk Topobase
The Topobase Developer's Guide describes the purpose and the operation of
over 75 samples. The samples are available in both the C# and VB.NET
■ Creating users
■ Creating workflows
To work with the Topobase API samples in Microsoft Visual Studio, open the
solution files in either the Development\Samples\CSharp directory or in the
Development\Samples\VB.Net directory of the Topobase Client installation.
Index | 57
DEM 13 geometry, API for 31
Design Review 3 georeferencing 13
Design Web Format (DWF) 7 geospatial data, in AutoCAD Map 3D 18
digital elevation models (DEM) 7 Geospatial Platform API 28, 30–31
drawing files, marking up 7 AutoCAD Map 3D 28
drawing objects 11 Resource Service 31
drawing objects, in AutoCAD Map 3D 4 GIF 15
drawing tools, in AutoCAD Map 3D 32 GIS feature data 12
DWF files, creating from DWG files 7
DWF files, reading and writing 9, 39
DWF Toolkit 3
I
DWF Viewer 20, 38 infrastructure design 5
DWF, description 14 Internet Explorer, embedding Autodesk
DWG files 7, 11, 15 Design Review 37
attached 15 Internet mapping 5
multiple 15
DWG files, in AutoCAD Map 3D 4
DWG files, reading and writing 8, 38 J
DWG objects 11
DWG TrueView 7 JPEG 15
DXF files 7
DXF files, reading and writing 8, 38 L
LayerDefinition resource type 31
E layers, in AutoCAD Map 3D 18
entities, AutoCAD 11
M
F Map 3D 2
FDO 2, 28, 36 map layer, in Autodesk Topobase 35
API 28, 36 MapDefinition resource type 31
data types 36 MapGuide Enterprise 2
providers 28, 36 MapGuide Open Source 2, 4, 18, 29
FDO, in AutoCAD Map 3D 4 APIs 29
feature class 12 architecture 18
Feature Data Objects, see FDO MapGuide Studio, see Autodesk MapGuide
feature rules, in Autodesk Topobase 35 Studio
feature, definition 12 MapGuide Web Studio 20
FeatureSource resource type 31 maps, in AutoCAD Map 3D 18
file-based data 15 Microsoft Internet Explorer, embedding
Autodesk Design Review 37
Microsoft Office, embedding Autodesk
G Design Review 37
multiple DWG files 15
geographic information system, see GIS
geometric analysis, API for 31
58 | Index
O scanned paper drawings 7
SDF files 15, 31
object classification 4 server-side API, in Autodesk Topobase 36
ObjectARX 8 SHP files 31
ObjectARX, differences with site server, in Autodesk MapGuide
RealDWG 38 Enterprise 19
ObjectDBX 8 spatial data format, see SDF files
objects 11 spatial databases 15
Open Source Geospatial Foundation 5, Studio, see Autodesk MapGuide Studio
28, 37 style, for displaying GIS data 12
Oracle Spatial 15, 31 styling, in AutoCAD Map 3D 18
Oracle Spatial database, in Autodesk
Topobase 20
Oracle Spatial, in Autodesk Topobase 34
T
theming 12
P TIFF 15
Topobase 2
paper drawings, scanned 7 Topobase Administrator 6
plug-ins, in Autodesk Topobase 34 Topobase Client 6
PNG 15 Topobase modules 6
properties, of a feature 12 Topobase Web 6
providers, FDO 28
providers, for FDO 36
U
R user interface layer, in Autodesk
Topobase 35
raster data 15
raster data, analysis and conversion 7
raster data, in GIS applications 13
V
Raster Design 3 vertical modules, in Autodesk
raster images 7 Topobase 35
RealDWG 3, 38
differences with ObjectARX 38
licensing 38 W
relational databases 15
Resource Service 32 Web API, in Autodesk MapGuide
in AutoCAD Map 3D 32 Enterprise 19
Resource Service, in Geospatial Platform Web Feature Service (WFS) 16
API 31 Web Map Service (WMS) 16
web services 16
web tier, in Autodesk MapGuide
S Enterprise 19
workflows API, in Autodesk Topobase 35
satellite data 7
Index | 59
60