MicroStation CONNECT Edition SDK Update 15

December 8, 2020

The MicroStation SDK team is pleased to announce the release of the MicroStation CONNECT Edition SDK Update 15 (U15).

The most recent release provides several enhancements in the following areas:

1. Executive Summary
   
   
   • Microsoft Visual Studio 2017 Professional (or better) is the default toolset requirement
   • Recompile MDL applications when toolset requirements have changed
   • Incremental updates: APIs, Documentation, Examples, eula.pdf
     
     
2. Documentation
   
   
   • Latest Changes 
     • MicroStation SDK (Announcements, Roadmap and ChangeLogs)
     • developer.bentley.com
       
       
   • Local Help
     • Incremental API Updates
     • SDK Previews > Docs
       
       
3. Developer Shell
   
   
   • N/A
     
     
4. Includes and APIs
   
   
   • Added
     
     
     • Geom\BoxFaces.h
     • Geom\TransformedDRange3d.h
     • mki\gtest.mki (See: Add Unit Testing to the MicroStation SDK)
       
       
   • Updated
     
     
     • DgnIModel\publish\IModelPublisherOptions.h (GetRemoveIModelsAfterPackaging, SetRemoveIModelsAfterPackaging)
     • DgnPlatform\Tcb\3dtools.r.h (polyhedronGeodesicDepth, meshFromPointsRemoveLongEdges, maxBoundaryEdgeLength)
     • DgnPlatform\Tcb\tcb.r.h (activeVariation)
     • DgnPlatform\CustomItemType.h (IsHiddenProperty, SetIsHiddenProperty, IsReadOnlyProperty, SetIsReadOnlyProperty)
     • DgnPlatform\DgnAttachment.h (Enforced: DgnAttachment vs DgnModel)
     • DgnPlatform\DgnECInstance.h (CreateReadOnly, SetCreateReadOnly)
     • DgnPlatform\DgnLinkManager.h (DGNLINK_REGIONTYPE_NamedBoundary, DGNLINK_FILTERTYPE_Region_NamedBoundary)
     • DgnPlatform\DisplayHandler.h (CalcElementRange)
     • DgnPlatform\ECReportNode.h (Many: ItemType and ReportResult options)
     • DgnPlatform\IViewDraw.h (MATSYMB_OVERRIDE_FallbackRenderMaterial)
     • DgnPlatform\Light.h (GetNaturalFilmResponseExposure, SetNaturalFilmResponseExposure)
     • DgnPlatform\NamedBoundary.h (FindOrphanByName)
     • DgnPlatform\ParametricModeling.h (ByLevelSymbologyFlag)
     • DgnPlatform\PickList.h (SetName, SortValues, SavePickListLibToDgnWithChanges)
     • DgnPlatform\RenderStore.h (RenderStore_VueSetup)
     • DgnPlatform\TextTableHandler.h (GetSizeLock)
     • DgnPlatform\WorkSet.h (Eh: 1108579. AddProperty, AreAllPropertiesLoaded, RemoveProperty)
     • GeoCoord\BaseGeoCoord.h
       • WGS84ConvertCode, GenConvertCode
       • InitTransverseMercator, originalIfPresent, allowUnitsOverride, ReprojectStatus
       • GetLinearTransformECEF, CartesianFromCartesian, CartesianFromECEF
       • GetGeoTiffKeys, GetMathematicalDomain, GetMathematicalDomainExtent
     • GeoCoord\BaseGeoDefs.r.h (GEOCOORDERR_GeoCoordNotInitialized, GEOCOORDERR_InvalidGeodeticTransform)
     • Mstn\MdlApi\dgnlib.h (ElementTemplatesOnly, ItemTypesOnly)
     • Mstn\MdlApi\dlogids.r.h (GCS macros)
     • Mstn\MdlApi\msinput.fdf (SetEnterIdleFunction)
     • Mstn\MdlApi\rmdlgids.r.h (Menu entries: GCS and Raster)
     • Mstn\MdlApi\userpref.r.h (useDarkTheme, dropLineStyleWarning)
     • Mstn\cmdlist.r.h (CMD_PLACE_BLOCK_CENTERED)
     • Mstn\MicroStation.r.h (ACTIVEPARAM_VARIATION)
     • Mstn\MstnDefs.h (CAPABILITY_TEXT_INSERTSTACKFRACTIONS)
     • mki\AssertToolSet.mki (VS2019_NO_SHORT_NAME, DONT_SET_NET_FRAMEWORK_FOR_VS2017)
     • mki\CaptureCommandEnv.py (s_sub8dot3PathExclusionList)
     • mki\common.mki (BMAKE_CLEANER_ENVIRONEMNT, DOTNET_SDK_PROJECT_BUILD)
     • mki\VsDevCmdImport.bat (VS2019_NO_SHORT_NAME)
     • mki\winntmdl.mki (Defect 1108605 - Corrections to ntTools macro) 
       
       
5. Examples
   
   
   • Added
     
     
     • DgnEC\ItemTypeExamples
     • Elements\AccuDrawDemoTest
     • GTestRunner (See: Add Unit Testing to the MicroStation SDK)
       
       
   • Updated
     
     
     • Elements\ManagedToolsExample
       •  KEY-INS
         • TOOLSEXAMPLE BOOLEAN DIFFERENCE
         • TOOLSEXAMPLE BOOLEAN INTERSECTION
         • TOOLSEXAMPLE BOOLEAN UNION
         • TOOLSEXAMPLE EXAMPLEVIEW TOOL
         • TOOLSEXAMPLE MODIFY ELEMENTS
6. Libraries
   
   
   • None
     
     
7. Requirements
   
   
   • Microsoft Visual Studio 2017 Professional (or better) is required and the default toolset

   • Workload Dependencies .NET desktop development Desktop development with C++ (Provides: DIA SDK) Universal Windows Platform development (Provides: Windows 10 SDK, or Download)

     Installing and Configuring Install: Get set up, or Configure: Workloads and Components, or Modify: Using Command-line parameters and Workload and Component IDs

     Toolset location Changes Compiler Tools Layout in Visual Studio 2017  How to: Set Environment Variables for the Visual Studio Command Line (VSDevCmd.bat) Note: Microsoft recommends binding 1 Toolset (version) per 1 Development Shell (environment instance)

   • MicroStation CONNECT Edition SDK native (C/C++) and managed code (.NET add ins) development requires:
     • Microsoft Visual Studio 2017 Professional (latest patches)
     • Microsoft .NET Framework 4.6.2 runtime (required for Windows 2012 and prior)
       
       
8. Known Issues, Bug Fixes, Breaking Changes
   
   
   • The MicroStation CONNECT Edition SDK installer version may differ slightly from the SDK build version. This is cosmetic and either version number is acceptable.
   • Review Resolved Defects: MicroStation CONNECT Edition Update 15 - Resolved Issues
   • Recompile MDL applications when default toolset requirements change
     
     
9. Release Notes
   
   
   • It is recommended to modify the Desktop and/or Start Charm/Menu shortcut properties to enable: "Run as Administrator".
     This ensures any Windows protected locations can be created and modified properly.
   • MicroStation CONNECT Edition SDK releases generally are available within 2 weeks of a respective closely paired MicroStation product release
   • To ensure maximum application compatibility and stability of your applications:
     • Make sure to use the latest MicroStation CONNECT Edition SDK and a (closely) matching MicroStation product version
     • It is highly recommended to recompiling existing applications for each new MicroStation product and SDK update release
   • If Breaking Changes are provided, MDL applications will require recompilation
     
     
10. Resources
    
    
    • MicroStation CONNECT
      
      • MicroStation CONNECT Edition SDK Downloads
      • MicroStation CONNECT Edition (Product) Releases
      • New to MicroStation CONNECT? (New/Experienced Developers)
        
        
    • Localized SDK Announcements (Chinese, English, German)
    • Bentley CONNECTION Center Bentley online services portal
    • Developers and Programming - Forums search then post Bentley Programming questions
    • Bentley Developer Network - visit to learn more about: the BDN Program, Search and Ask questions and more!
    • Bentley Developer Network Inquiry/Contact Us Form - SDK access or download SDK issues
    • Support Lifecycle Policy, Privacy, Terms of Use, EULA (Legal and Privacy)