Skip to main content

MapCore 12.5.0

  • Breaking change in Web: MapCore_Worker.js/.wasm no longer exist, one pair of JS/wasm files is used
  • Breaking change in Web: vector item IDs are now 64-bit BigInt instead of Number: IMcVectorMapLayer::Query() and OnVectorQueryResult() now use BigUint64Array (was Float64Array), SVectorItemFound::uVectorItemID and MC_EXTRA_CONTOUR_VECTOR_ITEM_ID are now bigint, GetVectorItemPoints()/GetValidFieldsPerDataSource()/GetVectorItemFieldValueAsInt/Double/String/WString()/VectorItemIDToOriginalID() take a bigint item ID, VectorItemIDFromOriginalID() returns one
  • Breaking change in Web: SMcVariantID: 32-bit/53-bit constructors replaced by a single number|bigint|Uint8Array|SMcVariantID constructor, Set53Bit()/Get53Bit() replaced by Set64Bit()/Get64Bit(), u128BitHighLow/u128BitHighHigh replaced by u128BitHigh
  • Breaking change in Web: MC_HISTOGRAM is now BigInt64Array instead of Float64Array
  • Breaking change: creating a map layer or a terrain now requires an existing map device
  • Breaking change: IMcTexture::EUsage: EU_STATIC_WRITE_ONLY_IN_ATLAS replaced by EU_STATIC_IN_ATLAS
  • Breaking change: IMcTexture's descendants: bFillPattern removed from Create()/SetXXX() along with IsFillPattern(); optional aSprites added along with GetSprites() to support multiple sprites in one texture
  • Breaking change: IMcTextItem: Set/GetCollisionPrevention(): bool replaced by ECollisionPreventionOption to respect or ignore the viewport's collision prevention mode; EBackgroundShape moved to IMcSymbolicItem
  • Breaking change: obsolete API removed: IMcMapDevice::SInitParams: bAlignScreenSizeObjects, bDisableDepthBuffer, bOpenConfigWindow; IMcMapViewport: Render()'s pBuffer (use RenderScreenRectToBuffer() instead), Set/GetOverloadMode()
  • Breaking change: IMcPrintMap::IPrintCallback::OnPrintTileReceived(): nTileStartX changed from int to UINT, nTileStartX/nTileStartY renamed to uTileStartX/uTileStartY; in .NET: return type changed to void, parameters changed to uint uPageNumber/uTileStartX/uTileStartY
  • Breaking change: IMcGlobalMap::RegisterLocalMap(): the global map viewport must now have an overlay manager
  • Breaking change: IMcSpatialQueries::SQueryParams: unused fBoundingBoxExpansionDist removed; NodeTypeToItemTypeBit() moved to IMcObjectSchemeNode
  • Breaking change: IMcMapCamera::IsInCameraWorldVisibleArea() now receives SMcScanGeometry (point/box/polygon) instead of SMcBox
  • Breaking change: typo fixes in all APIs: IMcMapViewport::SHeigtColor renamed to SHeightColor, IMcImageProcessing::EFilterProccessingOperation to EFilterProcessingOperation
  • Breaking change: IMcRaw3DModelMapLayer: indexed layers no longer supported: indexed Create() overload, BuildIndexingData() and DeleteIndexingData() removed; unused pClipRect/PositionOffset removed from Create() and puNumLevelsToIgnore/ppClipRect,PositionOffset from GetCreateParams()
  • Breaking change: converted 3D model layers no longer supported: IMcNative3DModelMapLayer, IMcNativeServer3DModelMapLayer, IMcMapLayer::CastToNative3DModelMapLayer()/CastToNativeServer3DModelMapLayer() and IMcMapProduction::Convert3DModelLayer() removed; terrains saved with such layers no longer load; MapProductionTool: "Convert 3D Model" and export of static-objects layer to raster/DTM removed
  • Breaking change: IMcMapProduction::CreateSourceMatrixFromGeometry(): str3DModelLayerDir removed
  • Breaking change: IMc3DModelMapLayer::SetResolvingConflictsWithDtmAndRaster() removed
  • Breaking change in .NET: IDNMcMapGlobal renamed to IDNMcGlobalMap
  • Behavior change: IMcImageProcessing: GetOriginalHistogram() now returns the histogram set by SetOriginalHistogram() (NOT_INITIALIZED if none); SetVisibleAreaOriginalHistogram(false) now affects the specified channel(s) only
  • Behavior change: scalable textures (e.g. SVG) in world-size items and 3D-shape sides are now rendered in their basic size (which should be large enough to look good in zoom-in)
  • Behavior change: on Linux the shipped libraries and the installed LinuxTester/McMapLayerServer load each other by relative RUNPATH rather than through the ldconfig cache
  • Behavior change: object scheme nodes: property setters refuse a reserved property ID; property getters refuse a call whose outputs are all NULL
  • Native map layers and raw 3D model layers can be created over a 3TZ-like archive (*.3tz) instead of a directory, served by MapLayerServer as well (except heat map layers)
  • IMcMapProduction::ConvertLayerDirectoryTo3tzArchive() added to pack a native layer's directory into a 3TZ-like archive; MapProductionTool and MCVectorEditor: "3tz" conversion option added; MapProductionTool: "Convert destination directory to 3tz file" added
  • IMcPictureItem: Set/GetTextureSprite() added; IMcLineBasedItem: Set/GetLineTextureSprite(), Set/GetSidesFillTextureSprite() added; IMcClosedShapeItem: Set/GetFillTextureSprite() added to define which texture sprite is used by item
  • IMcLineBasedItem with line texture: FLT_MAX as line width now means texture height (plus twice outline width)
  • IMcLineBasedItem: Set/GetLineStartShape(), Set/GetLineTurnShape(), Set/GetLineEndShape() added to draw shapes at an open line's start, interior and end points, Set/GetLineStartTextureMapping(), Set/GetLineTurnTextureMapping(), Set/GetLineEndTextureMapping() added to define how the line texture fills them
  • IMcLineBasedItem::SetClippingItems()/GetClippingItems(): optional uClippingMargin/puClippingMargin added to enlarge each clipping item's rectangle
  • IMcPictureItem: Set/GetBorderShape(), Set/GetBorderColor(), Set/GetBorderWidth() added to draw a border around a picture; IMcOverlayManager::ESizePropertyType: ESPT_PICTURE_BORDER_WIDTH and ESPT_ALL_PICTURE added to scale its width
  • IMcPictureItem/IMcTextItem with screen size and world orientation: screen offset now allowed via SetCoordinateSystemConversion(EPCS_SCREEN, true)
  • IMcObjectScheme::Clone(): optional pNodeToGetCloned/ppClonedNode added to retrieve the clone of a specified node
  • IMcObjectSchemeItem::CopyFrom() added to copy another item's data into an existing item of the same type
  • IMcMapCamera::ScreenToWorldOnTerrain(): optional dHeightAboveTerrain added to convert onto a surface above the terrain
  • IMcSpatialQueries: optional bIsDirectLine added to GetLineOfSight(), eTargetBuildingSurfaceType added to SQueryParams
  • IMcSightPresentationItemParams: Set/GetIsSightDirectLine() added to calculate sight along a direct line, Set/GetSightBuildingSurfaceType() added to define which part of building is detected
  • IMcRaw3DModelMapLayer::GetMainJsonContents() added to retrieve the layer's main 3DTiles tileset JSON
  • MC_RAW_3D_MODEL_DEFAULT_TARGET_RESOLUTION added as the default of IMcRaw3DModelMapLayer::Create()'s fTargetHighestResolution
  • MapLayerServer: zero number of threads in command line (the default in docker now) means twice the number of hardware thread contexts plus one
  • MapLayerServer: environment variables MCLAYERSERVER_MemoryCacheSize_inMB, MCLAYERSERVER_DiskCacheSize_inMB, MCLAYERSERVER_DiskCacheFolder, MCLAYERSERVER_IntermediateFilesFolder, MCLAYERSERVER_GpuUsageInSpatialQueries, MCLAYERSERVER_ImportScansInterval, MCLAYERSERVER_DefaultTilingScheme and MCLAYERSERVER_DefaultMaxScaleFactor added to override the matching McMapLayersServerConfig.xml parameters at startup; the overridden values are saved to the file (the disk cache size is not enforced yet)
  • MapLayerServer: unused DefaultTextIndexFilePath configuration parameter removed (ignored if still present in McMapLayersServerConfig.xml)
  • MapLayerServer Windows installer: WWWRoot and the server configuration moved to C:\ProgramData\Elbit\MapLayerServer\<version> so layers can be added and exported without administrator rights; port, data folder and an optional Windows service can now be chosen at install
  • MapLayerServer: the /fromenv command line now accepts four to seven arguments instead of crashing
  • IMcRaw3DModelMapLayer::Create(): optional bSmartRealityModel added (and pbSmartRealityModel to GetCreateParams()); when false (the default), the DTM is lowered under the main JSON's asset.footprint polygon, or under one traced from the coarsest tiles when it has no asset.footprint
  • IMcEditMode: Set/GetSnapping() added to snap an edited point to other objects' item vertices or segments, Set/GetSnapAndLimitTolerance() added to define the screen tolerance of snapping and geometric limit
  • IMcEditMode: SetObjectGeometricLimit() added to confine the edited object to a polygon, GetCurrentObjectOutOfLimitPolygon() added to retrieve the object's parts out of the limit, ICallback::OutOfLimitChanged() added to report out-of-limit changes
  • IMcEditMode: Set/GetObjectHeightMode() and SObjectOperationsParams::eObjectHeightMode added to define the edited point's height mode in 3D; EEMP_CHANGE_HEIGHT added to allow changing vertex height, along with ECT_UP_DOWN_CURSOR and EUPT_MOVE_UP_DOWN_ACTIVE/REGULAR
  • IMcEditMode: CurrentObjectUpdated() added to report that the application changed the edited object (optionally its scheme); GetAutoChangeObjectOperationsParams() is now const
  • IMcGeometricCalculations: EG2DPolyGonCut() added to cut polygons out of a polygon, EG2DPolyGonsJunctionsAndLines() added to retrieve polygons' junction points and lines between them
  • IMcSymbolicItem::EAttachPointType: EAPT_POLY_INTERP and EAPT_LONGEST_SEGMENT_INTERP implemented: interpolation along the parent's whole line or its longest segment
  • Android: the native libraries are built with NDK r30 and are 16 KB page aligned
  • Linux and Android: map layers and other data can now be read from https:// URLs, as on Windows; requests that verify the server's certificate need a CA bundle

Verified against MapCore 12.5.0