Changelog

v5.8.1 -- 24/04/2019

API

Add

• CameraOptions:
  • zoomEnabled optional parameter CameraOptions.zoomEnabled
  • rotationEnabled optional parameter CameraOptions.rotationEnabled
  • minDistance optional parameter CameraOptions.minDistance
  • maxDistance optional parameter CameraOptions.maxDistance

v5.8.0 -- 04/10/2018

API

Add

• AdsumProjector:
  • altRelativeToGround optional parameter AdsumProjector.utmToAdsum
  • altRelativeToGround optional parameter AdsumProjector.gpsToAdsum
• StackFloorAnimation:
  • StackFloorAnimationOptions.hideHigherFloorsSameBuildingOnly

Fix

• AdsumProjector:
  • AdsumProjector.utmToGps was returning lat/long in radians instead of degrees.
  • AdsumProjector.adsumTogps was returning lat/long in radians instead of degrees.
  • AdsumProjector.adsumLocationToGps was returning lat/long in radians instead of degrees.
• MouseManager:
  • MOUSE_EVENTS.click was returning some invisble labels.
  • MOUSE_EVENTS.dbClick was returning some invisble labels.
• WayfindingManager:
  • WayfindingManager.setUserGpsPosition altitude should be relative to given floor.
  • WayfindingManager.setUserUtmPosition altitude should be relative to given floor.
  • WayfindingManager.computePath was returning inconsistent path sections due to caching issue.

v5.7.0 -- 20/09/2018

API

Add

• Namespace:
  • PinUserObject
  • PinUserObjectOptions
  • WireframeDecorOptions
• CameraManager:
  • CameraManager.zoom
  • CameraManager.reset
• SceneManager:
  • SceneManager.reset
  • SingleFloorAnimationOptions.fadeInDelay
  • SingleFloorAnimationOptions.fadeOutDelay
  • SingleFloorAnimationOptions.bounceDownDelay
  • SingleFloorAnimationOptions.bounceUpDelay
  • SingleFloorAnimationOptions.bounce
  • SingleFloorAnimationOptions.bounceUpTime
  • SingleFloorAnimationOptions.bounceDownTime
  • SingleFloorAnimationOptions.bounceGhostFactor
  • SingleFloorAnimationOptions.center
  • SingleFloorAnimationOptions.centerOnOptions
• WayfindingManager:
  • WayfindingManager.reset
• ObjectManager:
  • ObjectManager.addLabelOnAdsumLocation
• AdsumLoader:
  • AdsumLoaderOptions.wireframeBuildings
  • AdsumLoaderOptions.wireframeBuildingsOptions
  • AdsumLoaderOptions.wireframeSpaces
  • AdsumLoaderOptions.wireframeSpacesOptions
  • WireframeDecorOptions
• AdsumProjector:
  • AdsumProjector.adsumLocationToGps
  • AdsumProjector.adsumLocationToUtm
• AdsumObject3D
  • AdsumObject3D.getPosition
  • BuildingObject.getPosition
  • DotUserObject.getPosition
  • FloorObject.getPosition
  • LabelImageObject.getPosition
  • LabelTextObject.getPosition
  • OrientedDotUserObject.getPosition
  • SiteObject.getPosition
  • SpaceObject.getPosition
  • UserObject.getPosition
• FloorObject:
  • FloorObject.isBounced
  • FloorObject.getBounceFactor
  • FloorObject.bounceUp
  • FloorObject.bounceDown
• LabelObject:
  • LabelObject.forceDisplayMode
  • LabelImageObject.forceDisplayMode
  • LabelTextObject.forceDisplayMode
  • LabelObject.resetForceDisplayMode
  • LabelImageObject.resetForceDisplayMode
  • LabelTextObject.resetForceDisplayMode
• PinUserObject:
  • PinUserObject
  • PinUserObjectOptions

Fix

• CameraManager:
  • CameraManager.centerOn distance was not treat as meters
  • CameraManager.centerOnObjects distance was not treat as meters
  • CameraManager.move consistency & accuracy with CameraManager.getState
• WayfindingManager:
  • WayfindingManager.setUserAdsumPosition is now conserving the given z-offset to control the user position elevation.
  • WayfindingManager.setUserUtmPosition is now conserving the given z-offset to control the user position elevation.
  • WayfindingManager.setUserGpsPosition is now conserving the given z-offset to control the user position elevation.

Behavior

Fix

• Wayfinding:
  • Draw path to Label location
• EngineManager:
  • Handle edge cases on canvas size (preventing to divide by 0)

Documentation

• Add Using System Coordinates
• Add PlayWithLabels - Positioning

v5.6.1 -- 21/08/2018

API

Fix

• SceneManager:
  • SceneManager.setCurrentFloor with Stack floor animation edge cases causing loosing camera target.
• WayfindingManager:
  • WayfindingManager.drawPathSection using animated=false is now not animated.

Behavior

Fix

• Transparency artifacts

v5.6.0 -- 20/08/2018

API

Add

• Namespace:
  • StackFloorAnimation
  • StackFloorAnimationOptions
• CameraManager:
  • CameraManager.getState
  • CameraCenterOnOptions.minDistance
  • CameraCenterOnOptions.maxDistance
• Objects:
  • FloorObject.altitude
  • SiteObject.altitude
• SceneManager:
  • SceneManager.setCurrentFloor accepts optional parameter options to overwride options setup at initialization.
  • SceneManager.setFloorTransition used to show floor transition. Note that the behavior is delegated on SingleFloorAnimation or StackFloorAnimation
  • SingleFloorAnimationOptions.ghostOpacity
  • StackFloorAnimation
  • StackFloorAnimationOptions
• SCENE_EVENTS:
  • SCENE_EVENTS.floor.willTransition
  • SCENE_EVENTS.floor.didTransition
• WayfindingManager:
  • WayfindingManager.drawPathSection accepts optional parameter animated
  • DotPathSectionDrawerOptions.showDelay
  • Path.getPrecedingPathSections
  • PathSection.getPath
  • PathSection.getPrecedingPathSections
  • PathSection.getFirstGround
  • PathSection.getInterGrounds
  • PathSection.getDeltaAltitude
  • PathSection.getInclination

Fix

• LabelTextObject.setText
• LabelTextObject.setStyle

Behavior

Changes

• CameraManager:
  • Minimum azimuth angle is now 0 instead of PI / 6
  • Improve default calibration created when is not set through studio

Fix

• CameraManager:
  • CameraManager.move does not jump anymore

Add

• FloorAnimation:
  • SingleFloorAnimation supports floor transtion using SceneManager.setFloorTransition.
• WayfindingManager:
  • WayfindingManager.drawPathSection supports inter-ground PathSection.

v5.5.0 -- 06/08/2018

API

Add

• AdsumProjector
  • AdsumProjector.adsumToGps accepts an optional parameter ground to deal with relative position.
  • AdsumProjector.adsumToUtm accepts an optional parameter ground to deal with relative position.
  • AdsumProjector.gpsToAdsum accepts an optional parameter ground to deal with relative position.
  • AdsumProjector.utmToAdsum accepts an optional parameter ground to deal with relative position.

v5.4.0 -- 30/07/2018

API

Add

• Namespace:
  • ArrowPathPatternOptions
  • DotPathSectionDrawer
  • DotPathSectionDrawerOptions
  • DotUserObject
  • DotUserObjectOptions
  • FlatArrowPathPatternOptions
  • OrientedDotUserObject
  • OrientedDotUserObjectOptions
  • SceneOptions
  • SingleFloorAnimation
  • SingleFloorAnimationOptions
  • WayfindingOptions
• CameraManager:
  • CameraManager.centerOnObjects
  • CameraManager.move
• SceneManager:
  • SceneManager.setCurrentFloor
    • supports animated parameter using fadeOut / fadeIn
    • SiteObject can be passed as argument which is equivalent to null
  • SceneManager.isCurrentFloor
  • SceneManager#SCENE_EVENTS.floor.willChanged
  • SingleFloorAnimation
• WayfindingManager:
  • WayfindingManager.drawPathSection optional parameter to change drawOptions
  • WayfindingManager.getUserPathSectionProgress
  • WayfindingManager.setUserAzimuthHeading
  • PathSection.getAzimuthOrientation
  • DotPathSectionDrawer
• UserObject:
  • DotUserObject
  • OrientedDotUserObject
• Options:
  • ArrowPathPatternOptions
  • CameraCenterOnOptions
    • CameraCenterOnOptions.altitude
    • CameraCenterOnOptions.azimuth
    • CameraCenterOnOptions.time
  • DotPathSectionDrawerOptions
  • DotUserObjectOptions
  • DotPathBuilderOptions.pattern
  • FlatArrowPathPatternOptions
  • Options.scene
  • OrientedDotUserObjectOptions
  • SceneOptions
  • SingleFloorAnimationOptions
  • UserPositionUpdateOptions
  • WayfindingOptions
    • WayfindingOptions.userObject
    • WayfindingOptions.userPositionUpdateOptions
    • WayfindingOptions.pathSectionDrawer
• AdsumProjector:
  • AdsumProjector.getAdsumNorthDirection
• SCENE_EVENTS:
  • SCENE_EVENTS.floor.willChanged

Behavior

Change

• Keep site visible by default, can be changed using SceneOptions.animation with a SingleFloorAnimation using option SingleFloorAnimationOptions.keepSiteVisible
• PathSection distance doesn't take anymore the distance from the gate of space to center. Meaning the distance of a Path is the distance from the current location to the destination gate.

Fix

• After loading, floor texture was visible only after next interaction.
• PathSection drawer takes into account from / to adsumObject when center.
• CameraCenterOnOptions.fitRatio is now accurate
• FloorObject.setDisplay now apply it to labels & decors
• SiteObject.setDisplay now apply it to labels & decors

Add

• User position update is now smoothed in order to prevent jump due to indoor positioning precision

5.3.0 -- 04/07/2018

API

Add

• Namespace
  • TEXTURE_QUALITY
• Options
  • AdsumLoaderOptions.textureQuality
• Others
  • TEXTURE_QUALITY
• Experimental NodeJs support

Behavior

Change

• Use optimize textures by default, set AdsumLoaderOptions.textureQuality to TEXTURE_QUALITY.HIGH for using high texture quality.

Fix

• Ambient Occlusion supports transparency
• Ambient Occlusion on Site take buildings into account
• Invalid Calibration on some center making the camera wrongly oriented
• Label on building position

Internal

• On demand rendering
• Drop memory usage up to 75%
  • BufferGeometries
• Drop CPU usage up to 50%
  • BufferGeometries
  • Drop autoUpdate matrices
• Improve loading time up to 30%
  • Lazy binding to PathNetwork
  • BufferGeometries
• Support multi-materials objects
• Merge extrude mesh

Documentation

Reference

• Add
  • TEXTURE_QUALITY
  • TEXTURE_QUALITY
  • AdsumLoaderOptions.textureQuality

v5.2.0 - 12/06/2018

API

Deprecate

• Namespace
  • DISPLAY_MODE due to typo error in favor of DISPLAY_MODES
• Wayfinding
  • Path#pathSections in favor of Path#getPathSections

Add

• Namespace:
  • AdsumWebMap#DisplayLevelState
  • AdsumWebMap#LabelImageObject
  • AdsumWebMap#LabelTextObject
  • AdsumWebMap#LevelOfDetails
• Wayfinding
  • Path.getPathSections
  • PathSection.grounds
  • PathSection.isInterGround
  • PathSection.getLastGround
• ObjectManager:
  • ObjectManager#addLabel
  • ObjectManager#removeLabel
  • ObjectManager#getByAdsumLocation
• EngineManager:
  • EngineManager#disableLevelOfDetails
  • EngineManager#enableLevelOfDetails
  • EngineManager#isLevelOfDetailsEnabled
• AdsumLoader:
  • AdsumLoader#buildLabel
• AdsumWebMap:
  • AdsumWebMap#getProjector
  • AdsumWebMap#stop
• BuildingObject:
  • BuildingObject#name
• FloorObject:
  • FloorObject#name
• SpaceObject:
  • SpaceObject#name
• LabelObject:
  • LabelObject#isPermanentDisplay
  • LabelObject#levelOfDetails
  • LabelObject#offset
  • LabelObject#opacity
  • LabelObject#rotation
  • LabelObject#scale
  • LabelObject#selected
  • LabelObject#moveBy
  • LabelObject#moveTo
  • LabelObject#setAutoScale
  • LabelObject#setOrientationMode
  • LabelObject#setOpacity
  • LabelObject#setPermanentDisplay
  • LabelObject#setRotation
  • LabelObject#setScale
  • LabelObject#select
  • LabelObject#unselect
• LabelImageObject:
  • LabelImageObject#constructor
  • LabelImageObject#height
  • LabelImageObject#image
  • LabelImageObject#width
  • LabelImageObject#setHeight
  • LabelImageObject#setImage
  • LabelImageObject#setWidth
• LabelTextObject:
  • LabelTextObject#constructor
  • LabelTextObject#style
  • LabelTextObject#text
  • LabelTextObject#setStyle
  • LabelTextObject#setText
• Options
  • LabelImageObjectOptions
  • LabelTextObjectOptions
  • TextStyleOptions
• Others:
  • AdsumProjector
  • DisplayLevelState
  • LevelOfDetails
  • LevelStateInterface

Fix

• Namespace
  • AdsumWebMap#DISPLAY_MODES was not exported (typo error)
• Wayfinding
  • Path.getDistance take into account inter-floor distance

Behavior

Change

• CameraManager:
  • Touch behavior is:
    • one finger: pan
    • two fingers:
      • pinch / spread: zoom
      • rotate: rotate around z axis (ground to sky); affect Azimuth angle
      • drag vertically: change camera altitude; affect Polar angle

Add

• Wayfinding
  • Studio Editor path checkpoint feature

Fix

• SceneManager:
  • Site & Building label visibility when current floor is not null.
• Wayfinding
  • z-fight with User position object
  • WayfinginManager#computePath setting Path#computed to true
• CameraManager:
  • Prevent camera to be aligned with the current floor, which was making the texture disappearing.
  • Allow the camera to be aligned with z index (view from top).

Documentation

Tutorials

• Add Label Visibility
• Add Play with Labels
• Update Learn the Basics
  • Change:
    • Deprecated usage of Path#pathSections in favor of Path#getPathSections
  • Add:
    • Label selection on click and when a PathSection is ending on a location where a label is attached.
    • Floor#name and Building#name are used to name the floors in controls.
• Update Object Manager getByAdsumLocation example
• Update User Interaction
  • Change:
    • Camera manipulation touch controls according to change of behavior.
• Update Wayfinding Manager
  • Change:
    • Deprecated usage of Path#pathSections in favor of Path#getPathSections

Reference

• Fix LabelTextObject#getType which returns ADSUM_OBJECT_TYPES.LabelTextObject and not ADSUM_OBJECT_TYPES.LabelImageObject

v5.1.1 - 14/05/2018

Documentation

Fix

• Installation to use semver by default to add in your project
• SceneAndCameraManagers Calibration is used in adsumWebMap.setDeviceId and not in adsumWebMap.setDevice which does not exist.
• CameraManager#centerOn reference code example was incorrect
• CameraManager#centerOnFloor reference code example was incorrect
• SpaceObject#setColor reference returns value is SpaceObject (this)
• LocationRepository#getByAdsumObject reference code example incorrect

v5.1.0 - 07/05/2018

API

Add

• Namespace
  • Expose AdsumWebMap#DotPathBuilderOptions
  • Expose AdsumWebMap#DotPathBuilder
• AdsumWebMap
  • Optional animated parameter to AdsumWebMap#setDeviceId
• Options
  • Options#wayfinding
  • WayfindingOptions
• Wayfinding
  • DotPathBuilder to personalize path pattern
  • DotPathBuilderOptions to personalize path pattern

Fix

• AdsumWebMap
  • AdsumWebMap#constructor with plain object.
• Wayfinding
  • WayfindingManager#computePath is now using user location when Path#to is null.
• CameraManager
  • CameraManager#centerOn now resolves AFTER animation completed
  • CameraManager#centerOnFloor now resolves AFTER animation completed

Behavior

Fix

• CameraManager
  • Camera lost when animating

Documentation

• Add documentation

v5.0.0 - 06/04/2018

Please read the Upgrade guide to get the list of changes