autocad map 3d 2009 sdk - documentation & help · the three developer's guides are also...

Introduction

TheAutoCADMap3DSDKincludesObjectARX,ObjectARX.NET,FeatureDataObjects(FDO),andGeospatialPlatform.NET.

ObjectARXisanunmanagedC++API.ObjectARX.NETisthemanagedC++equivalent.

FDO,likeObjectARX,comprisesbothaC++APIandamanagedC++equivalent.

TheGeospatialPlatformisexposedas.NETonly.

TopicsinThisSection

AutoCADMap3DSDKBeforeYouBeginWhat'sNewinThisReleaseWhat'sNewinPreviousReleases

AutoCADMap3D2009SDK080310

TheAutoCADMap3DSDKincludesObjectARX,GeospatialPlatform,andFeatureDataObjects(FDO).

ObjectARXandFDOareexposedasC++andalso.NET.GeospatialPlatformisexposedas.NETonly.

ObjectARX,GeospatialPlatform,andFDOareinstalledwiththeAutoCADMap3DSDKonly.HoweverthedocumentationfortheseAPIsisincludedinbothAutoCADMap3DandAutoCADMap3DSDKinstallations.

SDKDocumentation

AutoCADMap3DSDKHelpandthefollowingcomponentHelpfilesarelocatedinAutoCADMap3D\HelpandalsoinAutoCADMap3DSDK\Docs.Solongasthesefilesresideinthesamefolder,allcomponentHelpcontentisavailableontheContentstabofAutoCADMap3DSDKHelpwhenyouopenit.

Title FileName

AutoCADMap3DObjectARXC++Developer'sGuide

sdk.arx.cpp.dev.chm

AutoCADMap3DObjectARXC++Reference

sdk.arx.cpp.ref.chm

AutoCADMap3DObjectARX.NETDeveloper's

sdk.arx.net.dev.chm

Guide

AutoCADMap3DObjectARX.NETReference

sdk.arx.net.ref.chm

AutoCADMap3DGeospatialPlatformDeveloper'sGuide

sdk.geospatial.platform.dev.chm

AutoCADMap3DGeospatialPlatformReference

sdk.geospatial.platform.ref.chm

AutoCADMap3DGeospatialPlatformSupplementReference

sdk.geospatial.platform.supplement.ref.chm

AutoCADMap3DSDKReadme

sdk._readme.chm

Thethreedeveloper'sguidesarealsoavailableasPDFfiles,whicharelocatedinthesamefolderastheirCHMequivalents.

InadditiontothedocumentationcomponentswithObjectARX.NETintheirtitles,notethattheObjectARXC++Developer'sGuideincludesa.NEToverview.Toviewthissection,openAutoCADMap3DDKHelp,andthenclickDeveloper'sGuide>ManagedWrapperClasses.

DocumentationfortheFDOAPI,whichisalsoapartoftheSDK,isdescribedinitsownFDOsectionbelow.

SDKScope

ObjectARXC++and.NETcorrespondclosely.EachcoversmostofAutoCADMap3Dfunctionality,exceptwhatiscoveredexclusivelybyGeospatialPlatform.

GeospatialPlatformcoverageincludes

ResourceServiceFeatureService

MappingService

ThescopeoftheFDOAPI,whichisalsoapartoftheSDK,isdescribedinitsownFDOsectionbelow.

SDKSamplesandC++HeaderFiles

SDKsampleprojectsandC++headerfilesareinstalledwiththeAutoCADMap3DSDKonly.TheyarenotincludedwithAutoCADMap3D.

ThesampleprojectsandC++headerfilesforFDO,whichisalsoapartoftheSDK,aredescribedintheirownFDOsectionbelow.

FDODocumentation

exposedasC++andalso.NET.

LikeObjectARX,FDOisexposedasC++andalso.NET.

TheFDOdocumentationincludesthefollowingcomponents.ThesefilesarelocatedinAutoCADMap3D\HelpandalsoinAutoCADMap3DSDK\FDO\Docs.

Title FileName

TheEssentialFDO FET_TheEssentialFDO.pdf

FDODeveloper'sGuide FDG_FDODevGuide.pdf

FDOAPIReference FDO_API.chm

FDOAPIReference-Managed FDO_API_managed.chm

FDOSDKReadme FDO_SDK_ReadMe.chm

FDOProviderforArcSDE ArcSDE_Provider_API.chm

FDOProviderforMySQL MySQL_Provider_API.chm

FDOProviderforODBC ODBC_Provider_API.chm

FDOProviderforOracle Oracle_Provider_API.chm

FDOProviderforRaster Raster_Provider_API.chm

FDOProviderforSDF SDF_Provider_API.chm

FDOProviderforSHP SHP_Provider_API.chm

FDOProviderforSQLServer SQLServer_Provider_API.chm

FDOProviderforWMS WMS_Provider_API.chm

FDOScope

FDOprovidesagenericinterfacetoanumberofback-enddatasourcetechnologiesforthestorageandretrievalofGISdata.Italsoprovidesamodelforextendingthisgenericinterfacetoadditionaldatasourcetechnologies.TheimplementationoftheinterfaceforaparticulartechnologyiscalledanFDOprovider.

BesidesusingtheFDOAPItodevelopFDOproviderstosupportadditionaldatasourcetechnologies,youcanalsouseittobuildapplicationsthatconnecttoandconfigureFDOproviders.

FDOSamplesandC++HeaderFiles

FDOsampleprojectsandC++headerfilesareinstalledwiththeAutoCADMap3DSDKonly.TheyarenotincludedwithAutoCADMap3D.

BeforeYouBegin

TodevelopapplicationsusingAutoCADMap3DObjectARX,youshouldbefamiliarwithAutoCADObjectARXandalsotheAutoCADMap3DandAutoCADapplications.

Forinformationabout... Referto...

AutoCADObjectARX AutoCADObjectARXDocumentation,arxdoc.chm,whichislocatedinthedocsfolderofyourObjectARXinstallation.

AutoCADMap3DandAutoCAD

AutoCADMap3DHelp,whichislocatedintheHelpfolderofAutoCADMap3Dinstallations.

ImportantNoteAutoCADMap3DHelpisespeciallyusefulforundestandinghowAutoCADMap3Dmodelsitsdomain,forunderstandingdrawingsetsandqueries,forexample.SincedetailedexplanationsoftheseparadigmsareavailableinAutoCADMap3DHelp,AutoCADMap3DObjectARXHelpexplainsthemonlybrieflyornotatall.BeforeyouattempttoautomateorextendanAutoCADMap3Dfeature,reviewthesubjectinAutoCADMap3DHelp.

CompatabilityofObjectARXandAutoCADMap3D

AutoCADMap3DObjectARXmustbeinstalledinanexistingAutoCADObjectARXinstallation,andtheAutoCADMap3DandAutoCADObjectARXversionsmustbecompatiblewitheachotherandwiththeversionofAutoCADMap3Dthatyouareextending.Forexample,AutoCADMap3DObjectARX

2007mustbeinstalledintoanexistingAutoCADObjectARX2007installation,andyouneedbothAPIstobuildObjectARXapplicationsforAutoCADMap3D2007.

ComponentsNotIntendedforPublicUse

Inmanycases,butnotall,whereacomponentisdocumentedbutnotintendedforpublicuse,thisfactisnotedinthecomponentdescription.Withthefollowingcomponents,however,thisnotemaynotbepresent.Avoidthemnevertheless.TheyareintendedforinternalAutodeskuseonly.

ImportantNoteBeawareofthesecomponents.Avoidusingtheminyourapplications.

Componentstoavoid:

AcMapMbTileNameGeneratorGridClassAcMapMbTileNameGeneratorDataClassAcMapMbTileNameGeneratorSequenceClassAcMapMbTileNameGeneratorClass

ReviewWhat'sNew

Besideshighlightingnewfunctionality,theWhat'sNewtopicalsolistsObjectARXcomponentsthatarenotintendedforpublicuse,inadditiontothecomponentsthatarealreadylistedin"ComponentsNotIntendedforPublicUse"above.Eventhoughtheyarepresentinpublicheaderfilesandmayevenbepartiallydocumented,theyareintendedforinternalAutodeskuseonly.


ReturnDescriptionsWithMultipleReturnCodesCited

Withreturndescriptionsoffunctionswheremultiplereturncodesarecited,notethatthelistofreturncodesisnotnecessarilyexhaustive.Undocumentedreturncodesarepossible.

Forexample,thereturndescriptionsforObjectARXfunctionsFullEdge::GetHalfEdge()andAcDbBasicFilter::FilterObjects()shouldsimplysay,"ReturnseOkoranerrorcode."Theirlistsofreturncodesarelengthyenoughthatyoumightthinktheyareexhaustive,buttheyarenot.

TypographicConventions

HowItLooks WhatItIs

anteatereater TextyouenterattheAutoCADMap3Dcommandprompt.

dirname\filename.ext Namesoffilesanddirectories.

dir*.h/b/o:n>dir.txt

Code.

NoteAllfilenamesanddirectorypathsinAutoCADMap3Darecasesensitive.

AutoCADMap3D2009SDK:What'sNew

What'sneworchangedsincethepreviousrelease.

GeospatialPlatformAPIPromotedfromPreviewtoProduction

Likewiseitsdocumentation:

Title FileName

AutoCADMap3DGeospatialPlatformDeveloper'sGuide

sdk.gis.platform.dev.chmsdk.gis.platform.dev.pdf

AutoCADMap3DGeospatialPlatformReference

sdk.gis.platform.ref.chm

AutoCADMap3DGeospatialPlatformSupplementReference

sdk.gis.platform.supplement.ref.chm

TheGeospatialPlatformAPIisexposedas.NETonly.Itcoversthefollowingareasoffunctionality:

ResourceServiceFeatureServiceMappingService

NewDocumentation

AutoCADMap3DSDKHelp,sdk.doc.main.chm,includestwonewdocumentationcomponents.

Title FileName

AutoCADMap3DDeveloperSamples sdk.samples.chmsdk.samples.pdf

AutoCADMap3DSDKHelpanditscomponentHelpfilesareinstalledintheDocsfolderofSDKinstallations.Solongasthesefilesresideinthesamefolder,allcomponentHelpcontentisavailableontheContentstabofAutoCADMap3DSDKHelpwhenyouopenit.

NewSampleProjects

ClassifyFeatureExplorerFeatureInspectorQueryAndLocate

OtherChanges

TheGeospatialPlatformAPIisnowmoreconsistentandmoreefficient.Changesinclude

BridginggapsintheareaofinteroperatingbetweenCADentitiesandFDOfeatures.Specifically,wehaveaddedmethodstoAcMapFeatureEntityServicetoimprovesupportforapplicationsworkingwiththeAutoCADandGeospatialPlatformAPIstomanageAutoCADselectionsets,checkedentities,andFDOfeatures.AddingAcMapMap.SetViewScale,whichzoomsthemaptoagivenscale,tocomplementtheexistingAcMapMap.GetViewScale,whichmerelyreportsthescale.RenamingAcMapApiMgd.dlltoAutodesk.Map.Platform.dlltocomplywith.NETnamingconventions.

Enhancingeventstoinclude<ResourceName><OperationName>Canceledeventscorrespondingto<ResourceName>ToBe<OperationName>events.(By<OperationName>wemeanoperationslikeAdded,Modified,Updated,andsoon.)Withtheseeventsadded,applicationsthatdobookkeepingwhileanoperationproceedscanrollbacktheirbookkeepingiftheoperationfails.AddinganMgFeatureQueryOptionsparametertoAcMapLayer.SaveFeatureChangessoanapplicationcancommitasubsetoffeaturesthataremodifiedinsteadofall.AddingAcMapLayer.GetLockedFeaturestobeconsistentwithwhatisinFeatureServiceandwiththeabilityofapplicationstouselockandunlockcommandswiththeUpdateFeaturesmethod.RemovingdirectinstantiationofAcMapLayerandintroducingastaticAcMapLayer.Createmethod,whichletsapplicationsreturnthecorrecttypeoflayer(vectororgrid)dependingonthetypeoflayerdefinitionthenewlayerisbasedon.Andbesides,withAcMapLayer.Create,youcanwritecleaner,moreeasilymaintainedcode.

What'sNewinPreviousReleases

Featuresthatwereneworchangedinpreviousreleases.

20082007200620052004

AutoCADMap3DSDK2008:What'sNew

Thefollowingfeaturesareneworchanged.

NewGeospatialPlatformAPIPreview

Thisisapreviewrelease,whichmeansthattheGeospatialPlatformAPIisbynomeanssetinstone.Weinviteyourcommentsandsuggestions,especiallywhereyoucanidentifymissingpieces.

Pleaseletusknowwhatelseyouneed!

TheGeospatialPlatformisexposedas.NETonly.Itcoversthefollowingareasoffunctionality:

ResourceServiceFeatureServiceMappingService

NewDocumentation

AutoCADMap3DSDKHelp,sdk.doc.main.chm,includesfournewdocumentationcomponents.

AllofthenewdocumentationcomponentsareavailableontheContentstabofAutoCADMap3DSDKHelpwhenyouopenit,solongastheyallresideinthesamefolder.AndallofthemareincludedintheBetareleaseexceptasnoted.Developer'sguidecomponentsareduplicatedinPDFformat.

Title FileName

AutoCADMap3DGeospatialPlatform.NETDeveloper'sGuide(Preview)

NoteIncludedintheBeta2release,butitisincomplete.

sdk.dev.net.gis.chm

AutoCADMap3DGeospatialPlatform.NETReference(Preview)

sdk.ref.gis.platform.chm

AutoCADMap3D.NETReferenceSupplement(Preview)

sdk.ref.net.supp.chm

AutoCADMap3D.NETDeveloper'sGuide

NoteIncludedintheBeta2release,butitisincomplete.

sdk.dev.net.chm

AutoCADMap3DSDKHelpanditscomponentHelpfilesarelocatedintheDocsfolderoftheSDKinstallation.

What'sNewin2007

NoteTheproductnameforSDKreleases2007andearlierwasAutodeskMap3DObjectARX.

Thefollowingfeaturesareneworchangedinthe2007release.

NewAreasofFunctionality

TherearenonewareasoffunctionalityineitherObjectARXorManagedObjectARX.

DeletedAreasofFunctionality

FDOEnablerAPIhasbeenremovedfrombothObjectARXandManagedObjectARX.

UnicodeSupport

Unicodecharactersarenowacceptableinallstringarguments.SeetheAutoCADdocumentationformoreinformation.

MicrosoftVisualC++Version8.0Required

AutodeskMap3DObjectARXrequiresMicrosoftVisualC++version8.0.

ObjectClassandFeatureClass

WheretheObjectARXdocumentationusesthetermsfeatureclass,keepinmindthattheUIdocumentationhasreplacedthistermwithobjectclass.ThereasonforthechangeistorestrictfeatureterminologytotheFDOcontext(whichincidentallyisnotaddressedbytheObjectARXAPI),sothatwecanmakeacleardistinctionbetweenthefollowingtwokindsofmapcomponents:

Geospatialcomponents,whichisstoredinFDOfeaturesources,andarereferredtoasfeatures.Drawingcomponents(DWG-baseddata),whichisstoredinAutodeskMapdrawings,andarereferredtoasobjects.

WearenotchangingtheterminologyintheAPIbecausesomeAPIcomponentshavefeatureintheirnames,andchangingnamesofAPIcomponentsistoodisruptive.

NewComponentsNotIntendedforPublicUse

Somecomponentsinthefollowingsection,"ChangestoExistingFunctionality,"arenotintendedforpublicuse.


Avoidcomponentsthatarealtogethernew.Butitissafetousecomponentswhereallthathaschangedistheirname(orthenameofaparameteroranenumeratorelement),andtheirfunctionalityisthesameasbefore.Withenumerations,itisalsosafetouseanyenumeratorelementsthathavebeenaddedtothem.

ChangestoExistingFunctionality

Changesaresummarizedinthefollowingtable.

HeaderFilesandClasses Changes

acmapmbmapbook.h PublicbitmaskenumAcMapMbMapBook::EModificationTypehasnew

enumerators:

kMapBookTileNameChanged=8kMapBookTileAdjacencyModified=16

acmapmbmapsheet-layoutsettings.hAcMapMbMapSheet-LayoutSettings

acmapmbtile-generatorsettings.hAcMapMbTile-GeneratorSettings

acmapmbtile-generatorsettingsarea.hAcMapMbTile-GeneratorSettingsArea

acmapmbtile-generatorsettingsgrid.hAcMapMbTile-GeneratorSettingsGrid

acmapmbtile-generatorsettingsmanual.hAcMapMbTile-GeneratorSettingsManual

acmapmbtilename-generatorsettings.hAcMapMbTileName-GeneratorSettings

acmapmbtilename-generatorsettingsdata.hAcMapMbTileName-

EachoftheseAcMapMbXXclasseshastwonewvirtualfunctions:

virtualAcad::ErrorStatusxmlInFields(AcMapMbXmlFiler*pFiler);

virtualAcad::ErrorStatusxmlOutFields(AcMapMbXmlFiler*pFiler)const;

GeneratorSettingsData

acmapmbtilename-generatorsettingsgrid.hAcMapMbTileName-GeneratorSettingsGrid

acmapmbtilename-generatorsettingssequence.hAcMapMbTileName-GeneratorSettingsSequence

acmapmbtilename-generatorsettings.hAcMapMbTileName-GeneratorIndexer

ClassAcMapMbTileNameGeneratorIndexertwonewvirtualfunctions:

virtualAcad::ErrorStatusStreamIn(AcMapMbXmlFiler*pFiler);

virtualAcad::ErrorStatusStreamOut(AcMapMbXmlFiler*pFiler)const;

adeads.hGlobaldata-extension(ADE)functions

mapads.hGlobalmappingfunctions

topoads.hGlobaltopologyfunctions

Allfunctionsdefinedinthexxads.hheaderfilesarenowdeclaredasextern"C"forC++compilation.Notethatthesefunctionsaredeprecatedinfavorofnewerclass-basedAPIs.

dmdefaultelement.h Newfile.

dmdisplayelement.h ClassAcMapDMStyleReferenceIteratorhasbeenrenamedAcMapDMAllStyleReferencesIterator

ClassAcMapDMElementhastwonewfunctions:DisplayNameandRemoveEntityFromAcquisition

FunctionGetStyleReferenceIteratorhasbeenreplacedbyGetAllStyleReferencesIterator.

FunctionsAddStyle,RemoveStyle,andMoveStylewhichusedtheolditeratorname,havebeenchangedaccordingly.

Thefollowingfunctionshavebeenadded:

virtualAcad::ErrorStatusRender(Renderer&renderer;);

virtualvoidOnMapCSChanged(constACHAR*oldCS,constACHAR*newCS);

Acad::ErrorStatusExcludeEntitiesFromStylization(constAcDbObjectIdArray&ids);

Acad::ErrorStatusRemoveEntitiesFromStylizationExclusion(constAcDbObjectIdArray&ids);

dmdisplayitem.h ClassAcMapDMItemIteratorhasbeenrenamedAcMapDMAllItemsIterator.ClassAcMapDMItemIteratorwassubclassedfromAcMapDMAllDrawOrderItemsIterator,butitsreplacement,AcMapDMAllItemsIterator,isnot.

MemberfunctionRewindhasbeenadded.

MemberfunctionGetObjecthasbeenremoved.

EnumerationAcMapDMItem::ELegendDetailLevelnolongerincludestheenumeratorkLegendCollapsed

dmdisplaymanagement.h ClassAcMapDMDisplayManagementhasthreenewfunctions:

Acad::ErrorStatusGetGWS(IGWS**pGWS,AcDbDatabase*pDb);

Acad::ErrorStatusGetVectorElementIdForFeatureLayer(AcDbObjectId&elementId,AcDbDatabase*pDb,constTCHAR*layerSourceName);

Acad::ErrorStatusGetEntityIdForFeatureOnLayer(AcDbObjectId&entId,AcDbDatabase*pDb,constTCHAR*layerSourceName,intfeatureId);

dmdisplaystyle.h ClassAcMapDMStylehasanewenumeration:

enumCoExistenceFlags{kNotApplicable=0,kAllStyles,kSingleton,kLikeKind};

Andfournewfunctions:

virtualconstACHAR*DisplayName()const;

virtualAcad::ErrorStatusRefresh(void*&pCookie,AcDbObjectIdentityId,Adesk::UInt32flag=0);

virtualAcad::ErrorStatusRefresh(void*&pCookie,constACHAR*pTopoName,longlTopoElemId,Adesk::UInt32flag=0);

virtualAcad::ErrorStatusdeepClone(AcDbObject*pOwnerObject,AcDbObject*&pClonedObject,AcDbIdMapping&idMap,

Adesk::BooleanisPrimary=true)const;

dmgroup.h ToaccommodatechangingthenameofAcMapDMItemIteratortoAcMapDMAllItemsIterator,memberfunctionsofclassAcMapDMGrouphavebeenchangedaccordingly.

dmmap.h ClassAcMapDMMaphaschanged:

FunctionGetDrawOrderIteratorhasbeenremoved.

AcMapDMDrawOrderIteratorhasbeenreplacedwithAcMapDMAllDrawOrderItemsIterator.

Thefollowingfunctionshavebeenrenamed:

OldName NewName

NumScales NumScaleThresholds

GetScale GetScaleThreshold

SetCurrentScale SetCurrentScaleThreshold

GetCurrentScale GetCurrentScaleThreshold

AddScale AddScaleThreshold

CopyScale CopyScaleThreshold

RemoveScale RemoveScaleThreshold

GetMapScaleFor GetThresholdFor

ModifyScale ModifyScaleThreshold

FunctionSetCurrentScalehasanadditionalparameter:regen.

Thefollowingfunctionsarenew:

staticboolIsInfintyThreshold(doubledScale);

staticdoubleInfinityThreshold();

Acad::ErrorStatusSetExaggeration(doubledValue);

doubleGetExaggeration()const;

Acad::ErrorStatusSet3dGridPercent(intiValue);

intGet3dGridPercent()const;

Acad::ErrorStatusSetExtent(doubledMinX,

doubledMinY,doubledMaxX,doubledMaxY);

Acad::ErrorStatusRemoveExtent();

Acad::ErrorStatusGetExtent(double&dMinX,double&dMinY,double&dMaxX,double&dMaxY)const;

Acad::ErrorStatusGetSun(double&dAzimuth,double&dAltitude)const;

Acad::ErrorStatusSetSun(doubledAzimuth,doubledAltitude);

dmseannotationstyle.h ClassAcMapDMSEAnnotationStylehasanewfunction:

virtualAcMapDMStyle::CoExistenceFlagsCoExistenceType()const;

dmthematicstyle.h ClassAcMapDMThematicBuildRangesErrorCodehasanewfunction:

virtualAcMapDMStyle::CoExistenceFlagsCoExistenceType()const;

dmthematictable.h TBD.

dmtopoqueryelement.h ClassAcMapDMTopoQueryElementhastwonewfunctions:

virtualAcad::ErrorStatusAddStyle(AcDbObjectId&styleRefId,AcMapDMStyle*pStyle,AcMapDMAllStyleReferencesIterator&Position);

virtualAcad::ErrorStatusAddStyle(AcDbObjectId&styleRefId,constAcDbObjectId&styleId,AcMapDMAllStyleReferencesIterator&Position);

mapreactors.h ClassAcMapProjectReactorhasthreenewfunctions:

virtualboolCoordinateSystemIsToBeChanged(AcMapProject*pproject,constACHAR*oldCS,

constACHAR*newCS);

virtualvoidCoordinateSystemChanged(AcMapProject*pproject,constACHAR*oldCS,constACHAR*newCS);

virtualvoidCoordinateSystemChangeVetoed(AcMapProject*pproject,constACHAR*oldCS,constACHAR*newCS);

What'sNew2006


Thefollowingfeatureswereneworchangedinthe2006release.

NewAreasofFunctionality

AlthoughFeatureDataObjects(FDOClient)andMapPlottingarenotnewareasoffunctionality,theirclass-basedimplementationsinthisreleaseareentirelynew.

NoteThepreviousimplementationforFeatureDataObjectsisnolongeravailable.Applicationsbasedonitarenolongervalidandwillnotcompile.ThepreviousimplementationforMapPlotting,althoughdeprecated,remainsinplace.

Feature HeaderandLibraryFiles

FDOEnabler AcMapFdo*.hAcmapfdoenabler.lib

MapBook AcMapMB*.hAcMapMapBook.lib

CustomObjectProtocolExtensions

AcMapQueryPE.hAcMapGeometryPE.hmaparx.lib

ChangedAreasofFunctionality

Feature HeaderandLibraryFiles

DisplayManager AcMapDM*.hDm*.hAcMapDisplayManagement.lib

ManagedWrapperClasses

TheManagedWrapperClassespresentallofObjectARXasManagedC++,whichletsyouaccessObjectARXfunctionalityusingVB.NET,C#,oranyother.NETlanguage.

What'sNewin2005



NewObjectARXAPIs

ThefollowingnewareasoffunctionalityhavemorethandoubledthesizeandscopeofObjectARXforAutodeskMap3Dbyaddingmorethan100newclassesandalmost1700newfunctions.

AnnotationClassificationCoordinateSystemsCreateCentroidsDataSourcesDisplayManagementFDOClientImport-ExportObjectFilterTopologyUserManagement

Inaddition,AutodeskMap3Ddocumentationnowincludesadeveloper'sguide.Typically,eachoverviewinthedeveloper'sguideisasingletopic,howeverlong,whichmakesiteasytoprintinasinglestep.

WiththisreleaseofAutodeskMap3D,ObjectARXAPIcoverageandAutodeskMap3DUIcoverageareaclosematch.

AdditionstoDataExtensionClasses

Onenewclass,AcMapHostApplicationServices.Eightexistingclasseshavenewfunctionsadded.Onenewenumeration.

FDOAPI

YouneedtheFDOAPIifyouaredevelopingcustomFDOprovidersorFDOclientsliketheOracleSpatialproviderandtheFDOclientthatareincludedwithAutodeskMap3D.YoucanfindoutmoreabouttheFDOAPIattheAutodeskDeveloperCenter,whereFDOdocumentationisavailablefordownload.NotethattheFDOheaderand.libfilesareincludedwithAutodeskMap3DObjectARX.

PointsandSurfacesAPI

PointsandSurfacesisanewActiveXAPI.ActiveXAPIsareincludedwithAutodeskMap3D,butnotwithObjectARX.ToviewPointsandSurfacesdocumentation,dothefollowing.IntheHelpfolderofanAutodeskMap3Dinstallation,openacmapatm.chm.

GlobalFunctionSets

The"ADS"functionsets,whichformerlyweredocumentedinAutodeskMap3DADS/AutoLISPHelp,arenowdocumentedintheDeveloper'sGuideandReferenceforObjectARX.AllofthesefunctionsareglobalObjectARXfunctions.

DataExtensionFunctionsMapPlottingFunctionsTopologyFunctions

AutodeskMap3DADS/AutoLISPHelp,acmapads.chm,isnolongerincludedinObjectARXdocumentation.TheAutoLISPpartofADS/AutoLISPHelpisnowdocumentedinanewHelpfile,theAutoLISPAPIReference,acmaplisp.chm,

http://www.autodesk.com/developer

whichisavailableintheHelpfolderofAutodeskMap3Dinstallations.

NewDrawingCleanupVariables

Newcleanupvariablesfor

AddingfeatureclassestotheIncludeset.ExcludingentitiesfromtheAnchorset.Markingapparentintersectionerrors.Deletingduplicatesandsnappingclusterednodes.Weedingpolylines.

NewCleanGroupTypeConstants

512 Apparentintersections1024Weedpolylines

Theseconstantsareusedwiththefollowingfunctions:

tpm_cleanactionlistgetattpm_cleanactionlistinstpm_cleangrouptype

Thecompletesetofconstantsislistedwithtpm_cleangrouptype.

NewDrawingCleanupFunctions

tpm_cleancreatedss Getscreatedentitiesfollowingacleanupprocess.tpm_cleanmodifiedss Getschangedentitiesfollowingacleanupprocess.tpm_cleanunchangedss Getsunchangedentitiesfollowingacleanupprocess.

What'sNewin2004



AcDbMPolygonMoved

TheAcDbMPolygonclasshasbeenmovedfromtheAutodeskMap3DObjectARXAPItotheAutodeskObjectARXAPIandisnowdocumentedintheAutodeskObjectARXReference.

TrueColor

MostAutodeskMap3Dcolorsituations,includingqueryingandpropertyalteration,nowsupporttrue-colorformattedstringsinadditiontocolorindexes.

Forexample,youcanusetruecolorsinsituationsassociatedwiththefollowingAPIcomponents.

IntheAcMap::EAlterationTypeenumeration,whichidentifiespropertyalterationtypes,thekAlterationColorenumerator.IntheAcMap::EPropertyTypeenumeration,whichidentifiesthepropertytypeonwhichapropertyconditionisbased,theAcMap::kColorenumerator.IntheAcMap::EErrCodeenumeration,whichspecifiesasetofreturncodes,theAcMap::kErrInvalidColor(1806)enumeratorandtheAcMap::kErrTopInvalidColor(2019)enumerator.

TheAcMapQueryConditionsubclasses,AcMapDataCondition,AcMapLocationCondition,AcMapPropertyCondition,andAcMapSQLCondition,whichrepresentthefourtypesofquerycondition,withtheircondition-definingfunctionsforconditionsthatcaninvolvecolor.TheAcMapPropertyAlterationclass,whichrepresentssimplepropertyalterationssuchascolorchanges.Textandhatchalterations,whichaddtextlabelsandapplyhatchpatternstoqueriedobjects,arerepresentedbytwoAcMapPropertyAlterationsubclasses:AcMapTextAlterationandAcMapHatchAlteration.Apropertyalterationdefinitioncancontainanyofthethree.TheGetandSetOptionValuefunctionsoftheAcMapProjectclass,withtheirpcNamearguments,ColorForAddandColorForRemove,whicharelistedunderQueryOptionsintheProjectOptionstopic.

PropertyandDataQueriesInvolvingFeatureClasses

Toletyouspecify,whenqueryingfeatureclassobjects,whethertoincludesubclassesofthetargetfeatureclass,anoptionalFlagparameterhasbeenaddedtotheAcMapDataConditionandAcMapPropertyConditionconstructors.ToletyouvieworchangetheFlagsettingofadataorpropertycondition,twofunctions,Flag()andSetFlag(),havebeenaddedtotheAcMapDataConditionandAcMapPropertyConditionclasses.

MicrosoftVisualC++Version7.0Required

AutodeskMap3DObjectARXrequiresMicrosoftVisualC++version7.0.MicrosoftVisualC++.NET2003,acomponentofVisualStudio.NET2003,code-namedEverett,isnotsupported.

autocad map 3d 2009 sdk - documentation & help · the three developer's guides are also...

Documents