- Breaking changes (why so many?)
- Removed
CesiumWidget.onRenderLoopError
andViewer.renderLoopError
. They have been replaced byScene.renderError
. - Removed
Shapes.compute2DCircle
,Shapes.computeCircleBoundary
andShapes.computeEllipseBoundary
. Instead, useCircleOutlineGeometry
andEllipseOutlineGeometry
. See the tutorial. - Replaced
Scene.createTextureAtlas
withnew TextureAtlas
. - Removed
PolylinePipeline
,PolygonPipeline
,Tipsify
,FrustumCommands
, and allRenderer
types (except noted below) from the public Cesium API. These are still available but are not part of the official API and may change in future versions.Renderer
types in particular are likely to change. - Renamed
CompositePrimitive
toPrimitiveCollection
and added anoptions
parameter to the constructor function. - For AMD users only:
- Moved
PixelFormat
fromRenderer
toCore
. - Moved the following from
Renderer
toScene
:TextureAtlas
,TextureAtlasBuilder
,BlendEquation
,BlendFunction
,BlendingState
,CullFace
,DepthFunction
,StencilFunction
, andStencilOperation
. - Moved the following from
Scene
toCore
:TerrainProvider
,ArcGisImageServerTerrainProvider
,CesiumTerrainProvider
,EllipsoidTerrainProvider
,VRTheWorldTerrainProvider
,TerrainData
,HeightmapTerrainData
,QuantizedMeshTerrainData
,TerrainMesh
,TilingScheme
,GeographicTilingScheme
,WebMercatorTilingScheme
,sampleTerrain
,TileProviderError
,Credit
.
- Moved
- Removed
TilingScheme.createRectangleOfLevelZeroTiles
,GeographicTilingScheme.createLevelZeroTiles
andWebMercatorTilingScheme.createLevelZeroTiles
.
- Removed
- Improved terrain and imagery rendering performance when very close to the surface.
- Added
preRender
andpostRender
events toScene
. - Fixed dark lighting in 3D and Columbus View when viewing a primitive edge on. (#592)
- Added
Viewer.targetFrameRate
andCesiumWidget.targetFrameRate
to allow for throttling of the requestAnimationFrame rate. - Added
Viewer.resolutionScale
andCesiumWidget.resolutionScale
to allow the scene to be rendered at a resolution other than the canvas size. Also addedczm_resolutionScale
automatic GLSL uniform. - Added new functions to
Cartesian3
:fromDegrees
,fromRadians
,fromDegreesArray
,fromRadiansArray
,fromDegreesArray3D
andfromRadiansArray3D
. - Added
interleave
option toPrimitive
constructor.
- Breaking changes (why so many?):
- Renamed and moved
Scene.primitives.centralBody
moved toScene.globe
. - Removed
CesiumWidget.centralBody
andViewer.centralBody
. UseScene.globe
. - Renamed
CentralBody
toGlobe
. - Replaced
Model.computeWorldBoundingSphere
withModel.boundingSphere
. - Refactored visualizers, removing
setDynamicObjectCollection
,getDynamicObjectCollection
,getScene
, andremoveAllPrimitives
which are all superfluous after the introduction ofDataSourceDisplay
. The affected classes are:DynamicBillboardVisualizer
DynamicConeVisualizerUsingCustomSensor
DynamicLabelVisualizer
DynamicModelVisualizer
DynamicPathVisualizer
DynamicPointVisualizer
DynamicPyramidVisualizer
DynamicVectorVisualizer
GeometryVisualizer
- Renamed Extent to Rectangle
Extent
->Rectangle
ExtentGeometry
->RectangleGeomtry
ExtentGeometryOutline
->RectangleGeometryOutline
ExtentPrimitive
->RectanglePrimitive
BoundingRectangle.fromExtent
->BoundingRectangle.fromRectangle
BoundingSphere.fromExtent2D
->BoundingSphere.fromRectangle2D
BoundingSphere.fromExtentWithHeights2D
->BoundingSphere.fromRectangleWithHeights2D
BoundingSphere.fromExtent3D
->BoundingSphere.fromRectangle3D
EllipsoidalOccluder.computeHorizonCullingPointFromExtent
->EllipsoidalOccluder.computeHorizonCullingPointFromRectangle
Occluder.computeOccludeePointFromExtent
->Occluder.computeOccludeePointFromRectangle
Camera.getExtentCameraCoordinates
->Camera.getRectangleCameraCoordinates
Camera.viewExtent
->Camera.viewRectangle
CameraFlightPath.createAnimationExtent
->CameraFlightPath.createAnimationRectangle
TilingScheme.extentToNativeRectangle
->TilingScheme.rectangleToNativeRectangle
TilingScheme.tileXYToNativeExtent
->TilingScheme.tileXYToNativeRectangle
TilingScheme.tileXYToExtent
->TilingScheme.tileXYToRectangle
- Converted
DataSource
get methods into properties.getName
->name
getClock
->clock
getChangedEvent
->changedEvent
getDynamicObjectCollection
->dynamicObjects
getErrorEvent
->errorEvent
BaseLayerPicker
has been extended to support terrain selection (#1607).- The
BaseLayerPicker
constructor function now takes the container element and an options object instead of a CentralBody and ImageryLayerCollection. - The
BaseLayerPickerViewModel
constructor function now takes an options object instead of aCentralBody
andImageryLayerCollection
. ImageryProviderViewModel
->ProviderViewModel
BaseLayerPickerViewModel.selectedName
->BaseLayerPickerViewModel.buttonTooltip
BaseLayerPickerViewModel.selectedIconUrl
->BaseLayerPickerViewModel.buttonImageUrl
BaseLayerPickerViewModel.selectedItem
->BaseLayerPickerViewModel.selectedImagery
BaseLayerPickerViewModel.imageryLayers
has been removed and replaced withBaseLayerPickerViewModel.centralBody
- The
- Renamed
TimeIntervalCollection.clear
toTimeIntervalColection.removeAll
Context
is now private.- Removed
Scene.context
. Instead, useScene.drawingBufferWidth
,Scene.drawingBufferHeight
,Scene.maximumAliasedLineWidth
, andScene.createTextureAtlas
. Billboard.computeScreenSpacePosition
,Label.computeScreenSpacePosition
,SceneTransforms.clipToWindowCoordinates
andSceneTransforms.clipToDrawingBufferCoordinates
take aScene
parameter instead of aContext
.Camera
constructor takesScene
as parameter instead ofContext
- Removed
- Types implementing the
ImageryProvider
interface arenow require ahasAlphaChannel
property. - Removed
checkForChromeFrame
since Chrome Frame is no longer supported by Google. See Google's official announcement. - Types implementing
DataSource
no longer need to implementgetIsTimeVarying
.
- Renamed and moved
- Added a
NavigationHelpButton
widget that, when clicked, displays information about how to navigate around the globe with the mouse. The new button is enabled by default in theViewer
widget. - Added
Model.minimumPixelSize
property so models remain visible when the viewer zooms out. - Added
DynamicRectangle
to support DataSource providedRectangleGeometry
. - Added
DynamicWall
to support DataSource providedWallGeometry
. - Improved texture upload performance and reduced memory usage when using
BingMapsImageryProvider
and other imagery providers that return false fromhasAlphaChannel
. - Added the ability to offset the grid in the
GridMaterial
. GeometryVisualizer
now creates geometry asynchronously to prevent locking up the browser.- Add
Clock.canAnimate
to prevent time from advancing, even while the clock is animating. Viewer
now prevents time from advancing if asynchronous geometry is being processed in order to avoid showing an incomplete picture. This can be disabled via theViewer.allowDataSourcesToSuspendAnimation
settings.- Added ability to modify glTF material parameters using
Model.getMaterial
,ModelMaterial
, andModelMesh.material
. - Added
asynchronous
andready
properties toModel
. - Added
Cartesian4.fromColor
andColor.fromCartesian4
. - Added
getScale
andgetMaximumScale
toMatrix2
,Matrix3
, andMatrix4
. - Upgraded Knockout from version 3.0.0 to 3.1.0.
- Upgraded TopoJSON from version 1.1.4 to 1.6.8.
- Breaking changes:
-
All
CameraController
functions have been moved up to theCamera
. RemovedCameraController
. For example, code that looked like:scene.camera.controller.viewExtent(extent);
should now look like:
scene.camera.viewExtent(extent);
-
Finished replacing getter/setter functions with properties:
ImageryLayer
getImageryProvider
->imageryProvider
getExtent
->extent
Billboard
,Label
getShow
,setShow
->show
getPosition
,setPosition
->position
getPixelOffset
,setPixelOffset
->pixelOffset
getTranslucencyByDistance
,setTranslucencyByDistance
->translucencyByDistance
getPixelOffsetScaleByDistance
,setPixelOffsetScaleByDistance
->pixelOffsetScaleByDistance
getEyeOffset
,setEyeOffset
->eyeOffset
getHorizontalOrigin
,setHorizontalOrigin
->horizontalOrigin
getVerticalOrigin
,setVerticalOrigin
->verticalOrigin
getScale
,setScale
->scale
getId
->id
Billboard
getScaleByDistance
,setScaleByDistance
->scaleByDistance
getImageIndex
,setImageIndex
->imageIndex
getColor
,setColor
->color
getRotation
,setRotation
->rotation
getAlignedAxis
,setAlignedAxis
->alignedAxis
getWidth
,setWidth
->width
getHeight
setHeight
->height
Label
getText
,setText
->text
getFont
,setFont
->font
getFillColor
,setFillColor
->fillColor
getOutlineColor
,setOutlineColor
->outlineColor
getOutlineWidth
,setOutlineWidth
->outlineWidth
getStyle
,setStyle
->style
Polygon
getPositions
,setPositions
->positions
Polyline
getShow
,setShow
->show
getPositions
,setPositions
->positions
getMaterial
,setMeterial
->material
getWidth
,setWidth
->width
getLoop
,setLoop
->loop
getId
->id
Occluder
getPosition
->position
getRadius
->radius
setCameraPosition
->cameraPosition
LeapSecond
getLeapSeconds
,setLeapSeconds
->leapSeconds
Fullscreen
getFullscreenElement
->element
getFullscreenChangeEventName
->changeEventName
getFullscreenErrorEventName
->errorEventName
isFullscreenEnabled
->enabled
isFullscreen
->fullscreen
Event
getNumberOfListeners
->numberOfListeners
EllipsoidGeodesic
getSurfaceDistance
->surfaceDistance
getStart
->start
getEnd
->end
getStartHeading
->startHeading
getEndHeading
->endHeading
AnimationCollection
getAll
->all
CentralBodySurface
getTerrainProvider
,setTerrainProvider
->terrainProvider
Credit
getText
->text
getImageUrl
->imageUrl
getLink
->link
TerrainData
,HightmapTerrainData
,QuanitzedMeshTerrainData
getWaterMask
->waterMask
Tile
getChildren
->children
Buffer
getSizeInBytes
->sizeInBytes
getUsage
->usage
getVertexArrayDestroyable
,setVertexArrayDestroyable
->vertexArrayDestroyable
CubeMap
getPositiveX
->positiveX
getNegativeX
->negativeX
getPositiveY
->positiveY
getNegativeY
->negativeY
getPositiveZ
->positiveZ
getNegativeZ
->negativeZ
CubeMap
,Texture
getSampler
,setSampler
->sampler
getPixelFormat
->pixelFormat
getPixelDatatype
->pixelDatatype
getPreMultiplyAlpha
->preMultiplyAlpha
getFlipY
->flipY
getWidth
->width
getHeight
->height
CubeMapFace
getPixelFormat
->pixelFormat
getPixelDatatype
->pixelDatatype
Framebuffer
getNumberOfColorAttachments
->numberOfColorAttachments
getDepthTexture
->depthTexture
getDepthRenderbuffer
->depthRenderbuffer
getStencilRenderbuffer
->stencilRenderbuffer
getDepthStencilTexture
->depthStencilTexture
getDepthStencilRenderbuffer
->depthStencilRenderbuffer
hasDepthAttachment
->hasdepthAttachment
Renderbuffer
getFormat
->format
getWidth
->width
getHeight
->height
ShaderProgram
getVertexAttributes
->vertexAttributes
getNumberOfVertexAttributes
->numberOfVertexAttributes
getAllUniforms
->allUniforms
getManualUniforms
->manualUniforms
Texture
getDimensions
->dimensions
TextureAtlas
getBorderWidthInPixels
->borderWidthInPixels
getTextureCoordinates
->textureCoordinates
getTexture
->texture
getNumberOfImages
->numberOfImages
getGUID
->guid
VertexArray
getNumberOfAttributes
->numberOfAttributes
getIndexBuffer
->indexBuffer
-
Finished removing prototype functions. (Use 'static' versions of these functions instead):
BoundingRectangle
union
,expand
BoundingSphere
union
,expand
,getPlaneDistances
,projectTo2D
Plane
getPointDistance
Ray
getPoint
Spherical
normalize
Extent
validate
,getSouthwest
,getNorthwest
,getNortheast
,getSoutheast
,getCenter
,intersectWith
,contains
,isEmpty
,subsample
-
DataSource
now has additional required properties,isLoading
andloadingEvent
as well as a new optionalupdate
method which will be called each frame. -
Renamed
Stripe
material uniformslightColor
anddarkColor
toevenColor
andoddColor
. -
Replaced
SceneTransitioner
with new functions and properties on theScene
:morphTo2D
,morphToColumbusView
,morphTo3D
,completeMorphOnUserInput
,morphStart
,morphComplete
, andcompleteMorph
. -
Removed
TexturePool
.
-
- Improved visual quality for translucent objects with Weighted Blended Order-Independent Transparency.
- Fixed extruded polygons rendered in the southern hemisphere. #1490
- Fixed Primitive picking that have a closed appearance drawn on the surface. #1333
- Added
StripeMaterialProperty
for supporting theStripe
material in DynamicScene. loadArrayBuffer
,loadBlob
,loadJson
,loadText
, andloadXML
now support loading data from data URIs.- The
debugShowBoundingVolume
property on primitives now works across all scene modes. - Eliminated the use of a texture pool for Earth surface imagery textures. The use of the pool was leading to mipmapping problems in current versions of Google Chrome where some tiles would show imagery from entirely unrelated parts of the globe.
- Breaking changes:
- Replaced getter/setter functions with properties:
Scene
getCanvas
->canvas
getContext
->context
getPrimitives
->primitives
getCamera
->camera
getScreenSpaceCameraController
->screenSpaceCameraController
getFrameState
->frameState
getAnimations
->animations
CompositePrimitive
getCentralBody
,setCentralBody
->centralBody
getLength
->length
Ellipsoid
getRadii
->radii
getRadiiSquared
->radiiSquared
getRadiiToTheFourth
->radiiToTheFourth
getOneOverRadii
->oneOverRadii
getOneOverRadiiSquared
->oneOverRadiiSquared
getMinimumRadius
->minimumRadius
getMaximumRadius
->maximumRadius
CentralBody
getEllipsoid
->ellipsoid
getImageryLayers
->imageryLayers
EllipsoidalOccluder
getEllipsoid
->ellipsoid
getCameraPosition
,setCameraPosition
->cameraPosition
EllipsoidTangentPlane
getEllipsoid
->ellipsoid
getOrigin
->origin
GeographicProjection
getEllipsoid
->ellipsoid
WebMercatorProjection
getEllipsoid
->ellipsoid
SceneTransitioner
getScene
->scene
getEllipsoid
->ellipsoid
ScreenSpaceCameraController
getEllipsoid
,setEllipsoid
->ellipsoid
SkyAtmosphere
getEllipsoid
->ellipsoid
TilingScheme
,GeographicTilingScheme
,WebMercatorTilingSheme
getEllipsoid
->ellipsoid
getExtent
->extent
getProjection
->projection
ArcGisMapServerImageryProvider
,BingMapsImageryProvider
,GoogleEarthImageryProvider
,GridImageryProvider
,OpenStreetMapImageryProvider
,SingleTileImageryProvider
,TileCoordinatesImageryProvider
,TileMapServiceImageryProvider
,WebMapServiceImageryProvider
getProxy
->proxy
getTileWidth
->tileWidth
getTileHeight
->tileHeight
getMaximumLevel
->maximumLevel
getMinimumLevel
->minimumLevel
getTilingScheme
->tilingScheme
getExtent
->extent
getTileDiscardPolicy
->tileDiscardPolicy
getErrorEvent
->errorEvent
isReady
->ready
getCredit
->credit
ArcGisMapServerImageryProvider
,BingMapsImageryProvider
,GoogleEarthImageryProvider
,OpenStreetMapImageryProvider
,SingleTileImageryProvider
,TileMapServiceImageryProvider
,WebMapServiceImageryProvider
getUrl
->url
ArcGisMapServerImageryProvider
isUsingPrecachedTiles
- >usingPrecachedTiles
BingMapsImageryProvider
getKey
->key
getMapStyle
->mapStyle
GoogleEarthImageryProvider
getPath
->path
getChannel
->channel
getVersion
->version
getRequestType
->requestType
WebMapServiceImageryProvider
getLayers
->layers
CesiumTerrainProvider
,EllipsoidTerrainProvider
,ArcGisImageServerTerrainProvider
,VRTheWorldTerrainProvider
getErrorEvent
->errorEvent
getCredit
->credit
getTilingScheme
->tilingScheme
isReady
->ready
TimeIntervalCollection
getChangedEvent
->changedEvent
getStart
->start
getStop
->stop
getLength
->length
isEmpty
->empty
DataSourceCollection
,ImageryLayerCollection
,LabelCollection
,PolylineCollection
,SensorVolumeCollection
getLength
->length
BillboardCollection
getLength
->length
getTextureAtlas
,setTextureAtlas
->textureAtlas
getDestroyTextureAtlas
,setDestroyTextureAtlas
->destroyTextureAtlas
- Removed
Scene.getUniformState()
. Usescene.context.getUniformState()
. - Visualizers no longer create a
dynamicObject
property on the primitives they create. Instead, they set theid
property that is standard for all primitives. - The
propertyChanged
on DynamicScene objects has been renamed todefinitionChanged
. Also, the event is now raised in the case of an existing property being modified as well as having a new property assigned (previously only property assignment would raise the event). - The
visualizerTypes
parameter to theDataSouceDisplay
has been changed to a callback function that creates an array of visualizer instances. DynamicDirectionsProperty
andDynamicVertexPositionsProperty
were both removed, they have been superseded byPropertyArray
andPropertyPositionArray
, which make it easy for DataSource implementations to create time-dynamic arrays.VisualizerCollection
has been removed. It is superseded byDataSourceDisplay
.DynamicEllipsoidVisualizer
,DynamicPolygonVisualizer
, andDynamicPolylineVisualizer
have been removed. They are superseded byGeometryVisualizer
and correspondingGeometryUpdater
implementations;EllipsoidGeometryUpdater
,PolygonGeometryUpdater
,PolylineGeometryUpdater
.- Modified
CameraFlightPath
functions to take place in the camera's current reference frame. The arguments to the function now need to be given in world coordinates and an optional reference frame can be given when the flight is completed. PixelDatatype
properties are now JavaScript numbers, notEnumeration
instances.combine
now takes two objects instead of an array, and defaults to copying shallow references. TheallowDuplicates
parameter has been removed. In the event of duplicate properties, the first object's properties will be used.- Removed
FeatureDetection.supportsCrossOriginImagery
. This check was only useful for very old versions of WebKit.
- Replaced getter/setter functions with properties:
- Added
Model
for drawing 3D models using glTF. See the tutorial and Sandcastle example. - DynamicScene now makes use of Geometry and Appearances, which provides a tremendous improvements to DataSource visualization (CZML, GeoJSON, etc..). Extruded geometries are now supported and in many use cases performance is an order of magnitude faster.
- Added new
SelectionIndicator
andInfoBox
widgets toViewer
, activated byviewerDynamicObjectMixin
. CesiumTerrainProvider
now supports mesh-based terrain like the tiles created by STK Terrain Server.- Fixed rendering artifact on translucent objects when zooming in or out.
- Added
CesiumInspector
widget for graphics debugging. In Cesium Viewer, it is enabled by using the query parameterinspector=true
. Also see the Sandcastle example. - Improved compatibility with Internet Explorer 11.
DynamicEllipse
,DynamicPolygon
, andDynamicEllipsoid
now have properties matching their geometry counterpart, i.e.EllipseGeometry
,EllipseOutlineGeometry
, etc. These properties are also available in CZML.- Added a
definitionChanged
event to theProperty
interface as well as mostDynamicScene
objects. This makes it easy for a client to observe when new data is loaded into a property or object. - Added an
isConstant
property to theProperty
interface. Constant properties do not change in regards to simulation time, i.e.Property.getValue
will always return the same result for all times. ConstantProperty
is now mutable; it's value can be updated viaConstantProperty.setValue
.- Improved the quality of imagery near the poles when the imagery source uses a
GeographicTilingScheme
. OpenStreetMapImageryProvider
now supports imagery with a minimum level.BingMapsImageryProvider
now uses HTTPS by default for metadata and tiles when the document is loaded over HTTPS.- Added the ability for imagery providers to specify view-dependent attribution to be display in the
CreditDisplay
. - View-dependent imagery source attribution is now added to the
CreditDisplay
by theBingMapsImageryProvider
. - Fixed viewing an extent. #1431
- Fixed camera tilt in ICRF. #544
- Fixed developer error when zooming in 2D. If the zoom would create an invalid frustum, nothing is done. #1432
- Fixed
WallGeometry
bug that failed by removing positions that were less close together by less than 6 decimal places. #1483 - Fixed
EllipsoidGeometry
texture coordinates. #1454 - Added a loop property to
Polyline
s to join the first and last point. #960 - Use
performance.now()
instead ofDate.now()
, when available, to limit time spent loading terrain and imagery tiles. This results in more consistent frame rates while loading tiles on some systems. RequestErrorEvent
now includes the headers that were returned with the error response.- Added
AssociativeArray
, which is a helper class for maintaining a hash of objects that also needs to be iterated often. - Added
TimeIntervalCollection.getChangedEvent
which returns an event that will be raised whenever intervals are updated. - Added a second parameter to
Material.fromType
to override default uniforms. #1522 - Added
Intersections2D
class containing operations on 2D triangles. - Added
czm_inverseViewProjection
andczm_inverseModelViewProjection
automatic GLSL uniform.
- Breaking changes:
- The
Viewer
constructor argumentoptions.fullscreenElement
now matches theFullscreenButton
default ofdocument.body
, it was previously theViewer
container itself. - Removed
Viewer.objectTracked
event;Viewer.trackedObject
is now an ES5 Knockout observable that can be subscribed to directly. - Replaced
PerformanceDisplay
withScene.debugShowFramesPerSecond
. Asphalt
,Blob
,Brick
,Cement
,Erosion
,Facet
,Grass
,TieDye
, andWood
materials were moved to the Materials Pack Plugin.- Renamed
GeometryPipeline.createAttributeIndices
toGeometryPipeline.createAttributeLocations
. - Renamed
attributeIndices
property toattributeLocations
when callingContext.createVertexArrayFromGeometry
. PerformanceDisplay
requires a DOM element as a parameter.
- The
- Fixed globe rendering in the current Canary version of Google Chrome.
Viewer
now monitors the clock settings of the first addedDataSource
for changes, and also now has a constructor optionautomaticallyTrackFirstDataSourceClock
which will turn off this behavior.- The
DynamicObjectCollection
created byCzmlDataSource
now sends a singlecollectionChanged
event after CZML is loaded; previously it was sending an event every time an object was created or removed during the load process. - Added
ScreenSpaceCameraController.enableInputs
to fix issue with inputs not being restored after overlapping camera flights. - Fixed picking in 2D with rotated map. #1337
TileMapServiceImageryProvider
can now handle casing differences in tilemapresource.xml.OpenStreetMapImageryProvider
now supports imagery with a minimum level.- Added
Quaternion.fastSlerp
andQuaternion.fastSquad
. - Upgraded Tween.js to version r12.
- Breaking changes:
-
Added
allowTextureFilterAnisotropic
(default:true
) andfailIfMajorPerformanceCaveat
(default:true
) properties to thecontextOptions
property passed toViewer
,CesiumWidget
, andScene
constructors and moved the existing properties to a newwebgl
sub-property. For example, code that looked like:var viewer = new Viewer('cesiumContainer', { contextOptions : { alpha : true } });
should now look like:
var viewer = new Viewer('cesiumContainer', { contextOptions : { webgl : { alpha : true } } });
-
The read-only
Cartesian3
objects must now be cloned to camera properties instead of assigned. For example, code that looked like:camera.up = Cartesian3.UNIT_Z;
should now look like:
Cartesian3.clone(Cartesian3.UNIT_Z, camera.up);
-
The CSS files for individual widgets, e.g.
BaseLayerPicker.css
, no longer import other CSS files. Most applications should importwidgets.css
(and optionallylighter.css
). -
SvgPath
has been replaced by a Knockout binding:cesiumSvgPath
. -
DynamicObject.availability
is now aTimeIntervalCollection
instead of aTimeInterval
. -
Removed prototype version of
BoundingSphere.transform
. -
Matrix4.multiplyByPoint
now returns aCartesian3
instead of aCartesian4
.
-
- The minified, combined
Cesium.js
file now omits certainDeveloperError
checks, to increase performance and reduce file size. When developing your application, we recommend using the unminified version locally for early error detection, then deploying the minified version to production. - Fixed disabling
CentralBody.enableLighting
. - Fixed
Geocoder
flights when following an object. - The
Viewer
widget now clearsGeocoder
input when the user clicks the home button. - The
Geocoder
input type has been changed tosearch
, which improves usability (particularly on mobile devices). There were also some other minor styling improvements. - Added
CentralBody.maximumScreenSpaceError
. - Added
translateEventTypes
,zoomEventTypes
,rotateEventTypes
,tiltEventTypes
, andlookEventTypes
properties toScreenSpaceCameraController
to change the default mouse inputs. - Added
Billboard.setPixelOffsetScaleByDistance
,Label.setPixelOffsetScaleByDistance
,DynamicBillboard.pixelOffsetScaleByDistance
, andDynamicLabel.pixelOffsetScaleByDistance
to control minimum/maximum pixelOffset scaling based on camera distance. - Added
BoundingSphere.transformsWithoutScale
. - Added
fromArray
function toMatrix2
,Matrix3
andMatrix4
. - Added
Matrix4.multiplyTransformation
,Matrix4.multiplyByPointAsVector
.
- Breaking changes:
-
Changed the
CatmulRomSpline
andHermiteSpline
constructors from taking an array of structures to a structure of arrays. For example, code that looked like:var controlPoints = [ { point: new Cartesian3(1235398.0, -4810983.0, 4146266.0), time: 0.0}, { point: new Cartesian3(1372574.0, -5345182.0, 4606657.0), time: 1.5}, { point: new Cartesian3(-757983.0, -5542796.0, 4514323.0), time: 3.0}, { point: new Cartesian3(-2821260.0, -5248423.0, 4021290.0), time: 4.5}, { point: new Cartesian3(-2539788.0, -4724797.0, 3620093.0), time: 6.0} ]; var spline = new HermiteSpline(controlPoints);
should now look like:
var spline = new HermiteSpline({ times : [ 0.0, 1.5, 3.0, 4.5, 6.0 ], points : [ new Cartesian3(1235398.0, -4810983.0, 4146266.0), new Cartesian3(1372574.0, -5345182.0, 4606657.0), new Cartesian3(-757983.0, -5542796.0, 4514323.0), new Cartesian3(-2821260.0, -5248423.0, 4021290.0), new Cartesian3(-2539788.0, -4724797.0, 3620093.0) ] });
-
loadWithXhr
now takes an options object, and allows specifying HTTP method and data to send with the request. -
Renamed
SceneTransitioner.onTransitionStart
toSceneTransitioner.transitionStart
. -
Renamed
SceneTransitioner.onTransitionComplete
toSceneTransitioner.transitionComplete
. -
Renamed
CesiumWidget.onRenderLoopError
toCesiumWidget.renderLoopError
. -
Renamed
SceneModePickerViewModel.onTransitionStart
toSceneModePickerViewModel.transitionStart
. -
Renamed
Viewer.onRenderLoopError
toViewer.renderLoopError
. -
Renamed
Viewer.onDropError
toViewer.dropError
. -
Renamed
CesiumViewer.onDropError
toCesiumViewer.dropError
. -
Renamed
viewerDragDropMixin.onDropError
toviewerDragDropMixin.dropError
. -
Renamed
viewerDynamicObjectMixin.onObjectTracked
toviewerDynamicObjectMixin.objectTracked
. -
PixelFormat
,PrimitiveType
,IndexDatatype
,TextureWrap
,TextureMinificationFilter
, andTextureMagnificationFilter
properties are now JavaScript numbers, notEnumeration
instances. -
Replaced
sizeInBytes
properties onIndexDatatype
withIndexDatatype.getSizeInBytes
.
-
- Added
perPositionHeight
option toPolygonGeometry
andPolygonOutlineGeometry
. - Added
QuaternionSpline
andLinearSpline
. - Added
Quaternion.log
,Quaternion.exp
,Quaternion.innerQuadrangle
, andQuaternion.squad
. - Added
Matrix3.inverse
andMatrix3.determinant
. - Added
ObjectOrientedBoundingBox
. - Added
Ellipsoid.transformPositionFromScaledSpace
. - Added
Math.nextPowerOfTwo
. - Renamed our main website from cesium.agi.com to cesiumjs.org.
-
Breaking changes:
- Reversed the rotation direction of
Matrix3.fromQuaternion
to be consistent with graphics conventions. Mirrored change inQuaternion.fromRotationMatrix
. - The following prototype functions were removed:
- From
Matrix2
,Matrix3
, andMatrix4
:toArray
,getColumn
,setColumn
,getRow
,setRow
,multiply
,multiplyByVector
,multiplyByScalar
,negate
, andtranspose
. - From
Matrix4
:getTranslation
,getRotation
,inverse
,inverseTransformation
,multiplyByTranslation
,multiplyByUniformScale
,multiplyByPoint
. For example, code that previously looked likematrix.toArray();
should now look likeMatrix3.toArray(matrix);
.
- From
- Replaced
DynamicPolyline
color
,outlineColor
, andoutlineWidth
properties with a singlematerial
property. - Renamed
DynamicBillboard.nearFarScalar
toDynamicBillboard.scaleByDistance
. - All data sources must now implement
DataSource.getName
, which returns a user-readable name for the data source. - CZML
document
objects are no longer added to theDynamicObjectCollection
created byCzmlDataSource
. Use theCzmlDataSource
interface to access the data instead. TimeInterval.equals
, andTimeInterval.equalsEpsilon
now compare interval data as well.- All SVG files were deleted from
Widgets/Images
and replaced by a newSvgPath
class. - The toolbar widgets (Home, SceneMode, BaseLayerPicker) and the fullscreen button now depend on
CesiumWidget.css
for global Cesium button styles. - The toolbar widgets expect their
container
to be the toolbar itself now, no need for separate containers for each widget on the bar. Property
implementations are now required to implement a prototypeequals
function.ConstantProperty
andTimeIntervalCollectionProperty
no longer take aclone
function and instead require objects to implement prototypeclone
andequals
functions.- The
SkyBox
constructor now takes anoptions
argument with asources
property, instead of directly takingsources
. - Replaced
SkyBox.getSources
withSkyBox.sources
. - The
bearing
property ofDynamicEllipse
is now calledrotation
. - CZML
ellipse.bearing
property is nowellipse.rotation
.
- Reversed the rotation direction of
-
Added a
Geocoder
widget that allows users to enter an address or the name of a landmark and zoom to that location. It is enabled by default in applications that use theViewer
widget. -
Added
GoogleEarthImageryProvider
. -
Added
Moon
for drawing the moon, andIauOrientationAxes
for computing the Moon's orientation. -
Added
Material.translucent
property. Set this property orAppearance.translucent
for correct rendering order. Translucent geometries are rendered after opaque geometries. -
Added
enableLighting
,lightingFadeOutDistance
, andlightingFadeInDistance
properties toCentralBody
to configure lighting. -
Added
Billboard.setTranslucencyByDistance
,Label.setTranslucencyByDistance
,DynamicBillboard.translucencyByDistance
, andDynamicLabel.translucencyByDistance
to control minimum/maximum translucency based on camera distance. -
Added
PolylineVolumeGeometry
andPolylineVolumeGeometryOutline
. -
Added
Shapes.compute2DCircle
. -
Added
Appearances
tab to Sandcastle with an example for each geometry appearance. -
Added
Scene.drillPick
to return list of objects each containing 1 primitive at a screen space position. -
Added
PolylineOutlineMaterialProperty
for use withDynamicPolyline.material
. -
Added the ability to use
Array
andJulianDate
objects as custom CZML properties. -
Added
DynamicObject.name
and corresponding CZML support. This is a non-unique, user-readable name for the object. -
Added
DynamicObject.parent
and corresponding CZML support. This allows forDataSource
objects to present data hierarchically. -
Added
DynamicPoint.scaleByDistance
to control minimum/maximum point size based on distance from the camera. -
The toolbar widgets (Home, SceneMode, BaseLayerPicker) and the fullscreen button can now be styled directly with user-supplied CSS.
-
Added
skyBox
to theCesiumWidget
andViewer
constructors for changing the default stars. -
Added
Matrix4.fromTranslationQuaternionRotationScale
andMatrix4.multiplyByScale
. -
Added
Matrix3.getEigenDecomposition
. -
Added utility function
getFilenameFromUri
, which given a URI with or without query parameters, returns the last segment of the URL. -
Added prototype versions of
equals
andequalsEpsilon
method back toCartesian2
,Cartesian3
,Cartesian4
, andQuaternion
. -
Added prototype equals function to
NearFarScalar
, andTimeIntervalCollection
. -
Added
FrameState.events
. -
Added
Primitive.allowPicking
to save memory when picking is not needed. -
Added
debugShowBoundingVolume
, for debugging primitive rendering, toPrimitive
,Polygon
,ExtentPrimitive
,EllipsoidPrimitive
,BillboardCollection
,LabelCollection
, andPolylineCollection
. -
Added
DebugModelMatrixPrimitive
for debugging primitive'smodelMatrix
. -
Added
options
argument to theEllipsoidPrimitive
constructor. -
Upgraded Knockout from version 2.3.0 to 3.0.0.
-
Upgraded RequireJS to version 2.1.9, and Almond to 0.2.6.
-
Added a user-defined
id
to all primitives for use with picking. For example:primitives.add(new Polygon({ id : { // User-defined object returned by Scene.pick }, // ... })); // ... var p = scene.pick(/* ... */); if (defined(p) && defined(p.id)) { // Use properties and functions in p.id }
-
Breaking changes:
-
Cesium now prints a reminder to the console if your application uses Bing Maps imagery and you do not supply a Bing Maps key for your application. This is a reminder that you should create a Bing Maps key for your application as soon as possible and prior to deployment. You can generate a Bing Maps key by visiting https://www.bingmapsportal.com/. Set the
BingMapsApi.defaultKey
property to the value of your application's key before constructing theCesiumWidget
or any other types that use the Bing Maps API.BingMapsApi.defaultKey = 'my-key-generated-with-bingmapsportal.com';
-
Scene.pick
now returns an object with aprimitive
property, not the primitive itself. For example, code that looked like:var primitive = scene.pick(/* ... */); if (defined(primitive)) { // Use primitive }
should now look like:
var p = scene.pick(/* ... */); if (defined(p) && defined(p.primitive)) { // Use p.primitive }
-
Removed
getViewMatrix
,getInverseViewMatrix
,getInverseTransform
,getPositionWC
,getDirectionWC
,getUpWC
andgetRightWC
fromCamera
. Instead, use theviewMatrix
,inverseViewMatrix
,inverseTransform
,positionWC
,directionWC
,upWC
, andrightWC
properties. -
Removed
getProjectionMatrix
andgetInfiniteProjectionMatrix
fromPerspectiveFrustum
,PerspectiveOffCenterFrustum
andOrthographicFrustum
. Instead, use theprojectionMatrix
andinfiniteProjectionMatrix
properties. -
The following prototype functions were removed:
- From
Quaternion
:conjugate
,magnitudeSquared
,magnitude
,normalize
,inverse
,add
,subtract
,negate
,dot
,multiply
,multiplyByScalar
,divideByScalar
,getAxis
,getAngle
,lerp
,slerp
,equals
,equalsEpsilon
- From
Cartesian2
,Cartesian3
, andCartesian4
:getMaximumComponent
,getMinimumComponent
,magnitudeSquared
,magnitude
,normalize
,dot
,multiplyComponents
,add
,subtract
,multiplyByScalar
,divideByScalar
,negate
,abs
,lerp
,angleBetween
,mostOrthogonalAxis
,equals
, andequalsEpsilon
. - From
Cartesian3
:cross
Code that previously looked like
quaternion.magnitude();
should now look likeQuaternion.magnitude(quaternion);
. - From
-
DynamicObjectCollection
andCompositeDynamicObjectCollection
have been largely re-written, see the documentation for complete details. Highlights include:getObject
has been renamedgetById
.removeObject
has been renamedremoveById
.collectionChanged
event added for notification of objects being added or removed.
-
DynamicScene
graphics object (DynamicBillboard
, etc...) have had their staticmergeProperties
andclean
functions removed. -
UniformState.update
now takes a context as its first parameter. -
Camera
constructor now takes a context instead of a canvas. -
SceneTransforms.clipToWindowCoordinates
now takes a context instead of a canvas. -
Removed
canvasDimensions
fromFrameState
. -
Removed
context
option fromMaterial
constructor and parameter fromMaterial.fromType
. -
Renamed
TextureWrap.CLAMP
toTextureWrap.CLAMP_TO_EDGE
.
-
-
Added
Geometries
tab to Sandcastle with an example for each geometry type. -
Added
CorridorOutlineGeometry
. -
Added
PolylineGeometry
,PolylineColorAppearance
, andPolylineMaterialAppearance
. -
Added
colors
option toSimplePolylineGeometry
for per vertex or per segment colors. -
Added proper support for browser zoom.
-
Added
propertyChanged
event toDynamicScene
graphics objects for receiving change notifications. -
Added prototype
clone
andmerge
functions toDynamicScene
graphics objects. -
Added
width
,height
, andnearFarScalar
properties toDynamicBillboard
for controlling the image size. -
Added
heading
andtilt
properties toCameraController
. -
Added
Scene.sunBloom
to enable/disable the bloom filter on the sun. The bloom filter should be disabled for better frame rates on mobile devices. -
Added
getDrawingBufferWidth
andgetDrawingBufferHeight
toContext
. -
Added new built-in GLSL functions
czm_getLambertDiffuse
andczm_getSpecular
. -
Added support for EXT_frag_depth.
-
Improved graphics performance.
- An Everest terrain view went from 135-140 to over 150 frames per second.
- Rendering over a thousand polylines in the same collection with different materials went from 20 to 40 frames per second.
-
Improved runtime generation of GLSL shaders.
-
Made sun size accurate.
-
Fixed bug in triangulation that fails on complex polygons. Instead, it makes a best effort to render what it can. #1121
-
Fixed geometries not closing completely. #1093
-
Fixed
EllipsoidTangentPlane.projectPointOntoPlane
for tangent planes on an ellipsoid other than the unit sphere. -
CompositePrimitive.add
now returns the added primitive. This allows us to write more concise code.var p = new Primitive(/* ... */); primitives.add(p); return p;
becomes
return primitives.add(new Primitive(/* ... */));
This releases fixes 2D and other issues with Chrome 29.0.1547.57 (#1002 and #1047).
- Breaking changes:
-
The
CameraFlightPath
functionscreateAnimation
,createAnimationCartographic
, andcreateAnimationExtent
now takescene
as their first parameter instead offrameState
. -
Completely refactored the
DynamicScene
property system to vastly improve the API. See #1080 for complete details.- Removed
CzmlBoolean
,CzmlCartesian2
,CzmlCartesian3
,CzmlColor
,CzmlDefaults
,CzmlDirection
,CzmlHorizontalOrigin
,CzmlImage
,CzmlLabelStyle
,CzmlNumber
,CzmlPosition
,CzmlString
,CzmlUnitCartesian3
,CzmlUnitQuaternion
,CzmlUnitSpherical
, andCzmlVerticalOrigin
since they are no longer needed. - Removed
DynamicProperty
,DynamicMaterialProperty
,DynamicDirectionsProperty
, andDynamicVertexPositionsProperty
; replacing them with an all new system of properties.Property
- base interface for all properties.CompositeProperty
- a property composed of other properties.ConstantProperty
- a property whose value never changes.SampledProperty
- a property whose value is interpolated from a set of samples.TimeIntervalCollectionProperty
- a property whose value changes based on time interval.MaterialProperty
- base interface for all material properties.CompositeMaterialProperty
- aCompositeProperty
for materials.ColorMaterialProperty
- a property that maps to a color material. (replacesDynamicColorMaterial
)GridMaterialProperty
- a property that maps to a grid material. (replacesDynamicGridMaterial
)ImageMaterialProperty
- a property that maps to an image material. (replacesDynamicImageMaterial
)PositionProperty
- base interface for all position properties.CompositePositionProperty
- aCompositeProperty
for positions.ConstantPositionProperty
- aPositionProperty
whose value does not change in respect to theReferenceFrame
in which is it defined.SampledPositionProperty
- aSampledProperty
for positions.TimeIntervalCollectionPositionProperty
- ATimeIntervalCollectionProperty
for positions.
- Removed
-
Removed
processCzml
, useCzmlDataSource
instead. -
Source/Widgets/Viewer/lighter.css
was deleted, useSource/Widgets/lighter.css
instead. -
Replaced
ExtentGeometry
parameters for extruded extent to make them consistent with other geometries.options.extrudedOptions.height
->options.extrudedHeight
options.extrudedOptions.closeTop
->options.closeBottom
options.extrudedOptions.closeBottom
->options.closeTop
-
Geometry constructors no longer compute vertices or indices. Use the type's
createGeometry
method. For example, code that looked like:var boxGeometry = new BoxGeometry({ minimumCorner : min, maximumCorner : max, vertexFormat : VertexFormat.POSITION_ONLY });
should now look like:
var box = new BoxGeometry({ minimumCorner : min, maximumCorner : max, vertexFormat : VertexFormat.POSITION_ONLY }); var geometry = BoxGeometry.createGeometry(box);
-
Removed
createTypedArray
andcreateArrayBufferView
from each of theComponentDatatype
enumerations. Instead, useComponentDatatype.createTypedArray
andComponentDatatype.createArrayBufferView
. -
DataSourceDisplay
now requires aDataSourceCollection
to be passed into its constructor. -
DeveloperError
andRuntimeError
no longer contain anerror
property. CalltoString
, or check thestack
property directly instead. -
Replaced
createPickFragmentShaderSource
withcreateShaderSource
. -
Renamed
PolygonPipeline.earClip2D
toPolygonPipeline.triangulate
.
-
- Added outline geometries. #1021.
- Added
CorridorGeometry
. - Added
Billboard.scaleByDistance
andNearFarScalar
to control billboard minimum/maximum scale based on camera distance. - Added
EllipsoidGeodesic
. - Added
PolylinePipeline.scaleToSurface
. - Added
PolylinePipeline.scaleToGeodeticHeight
. - Added the ability to specify a
minimumTerrainLevel
andmaximumTerrainLevel
when constructing anImageryLayer
. The layer will only be shown for terrain tiles within the specified range. - Added
Math.setRandomNumberSeed
andMath.nextRandomNumber
for generating repeatable random numbers. - Added
Color.fromRandom
to generate random and partially random colors. - Added an
onCancel
callback toCameraFlightPath
functions that will be executed if the flight is canceled. - Added
Scene.debugShowFrustums
andScene.debugFrustumStatistics
for rendering debugging. - Added
Packable
andPackableForInterpolation
interfaces to aid interpolation and in-memory data storage. Also made most core Cesium types implement them. - Added
InterpolationAlgorithm
interface to codify the base interface already being used byLagrangePolynomialApproximation
,LinearApproximation
, andHermitePolynomialApproximation
. - Improved the performance of polygon triangulation using an O(n log n) algorithm.
- Improved geometry batching performance by moving work to a web worker.
- Improved
WallGeometry
to follow the curvature of the earth. - Improved visual quality of closed translucent geometries.
- Optimized polyline bounding spheres.
Viewer
now automatically sets its clock to that of the first addedDataSource
, regardless of how it was added to theDataSourceCollection
. Previously, this was only done for dropped files byviewerDragDropMixin
.CesiumWidget
andViewer
now display an HTML error panel if an error occurs while rendering, which can be disabled with a constructor option.CameraFlightPath
now automatically disables and restores mouse input for the flights it generates.- Fixed broken surface rendering in Columbus View when using the
EllipsoidTerrainProvider
. - Fixed triangulation for polygons that cross the international date line.
- Fixed
EllipsoidPrimitive
rendering for some oblate ellipsoids. #1067. - Fixed Cesium on Nexus 4 with Android 4.3.
- Upgraded Knockout from version 2.2.1 to 2.3.0.
- Breaking changes:
- Replaced tessellators and meshes with geometry. In particular:
- Replaced
CubeMapEllipsoidTessellator
withEllipsoidGeometry
. - Replaced
BoxTessellator
withBoxGeometry
. - Replaced
ExtentTessletaor
withExtentGeometry
. - Removed
PlaneTessellator
. It was incomplete and not used. - Renamed
MeshFilters
toGeometryPipeline
. - Renamed
MeshFilters.toWireframeInPlace
toGeometryPipeline.toWireframe
. - Removed
MeshFilters.mapAttributeIndices
. It was not used. - Renamed
Context.createVertexArrayFromMesh
toContext.createVertexArrayFromGeometry
. Likewise, renamedmesh
constructor property togeometry
.
- Replaced
- Renamed
ComponentDatatype.*.toTypedArray
toComponentDatatype.*.createTypedArray
. - Removed
Polygon.configureExtent
. UseExtentPrimitive
instead. - Removed
Polygon.bufferUsage
. It is no longer needed. - Removed
height
andtextureRotationAngle
arguments fromPolygon
setPositions
andconfigureFromPolygonHierarchy
functions. UsePolygon
height
andtextureRotationAngle
properties. - Renamed
PolygonPipeline.cleanUp
toPolygonPipeline.removeDuplicates
. - Removed
PolygonPipeline.wrapLongitude
. UseGeometryPipeline.wrapLongitude
instead. - Added
surfaceHeight
parameter toBoundingSphere.fromExtent3D
. - Added
surfaceHeight
parameter toExtent.subsample
. - Renamed
pointInsideTriangle2D
topointInsideTriangle
. - Renamed
getLogo
togetCredit
forImageryProvider
andTerrainProvider
.
- Replaced tessellators and meshes with geometry. In particular:
- Added Geometry and Appearances #911.
- Added property
intersectionWidth
toDynamicCone
,DynamicPyramid
,CustomSensorVolume
, andRectangularPyramidSensorVolume
. - Added
ExtentPrimitive
. - Added
PolylinePipeline.removeDuplicates
. - Added
barycentricCoordinates
to compute the barycentric coordinates of a point in a triangle. - Added
BoundingSphere.fromEllipsoid
. - Added
BoundingSphere.projectTo2D
. - Added
Extent.fromDegrees
. - Added
czm_tangentToEyeSpaceMatrix
built-in GLSL function. - Added debugging aids for low-level rendering:
DrawCommand.debugShowBoundingVolume
andScene.debugCommandFilter
. - Added extrusion to
ExtentGeometry
. - Added
Credit
andCreditDisplay
for displaying credits on the screen. - Improved performance and visual quality of
CustomSensorVolume
andRectangularPyramidSensorVolume
. - Improved the performance of drawing polygons created with
configureFromPolygonHierarchy
.
- Breaking changes:
- Removed
CesiumViewerWidget
and replaced it with a newViewer
widget with mixin architecture. This new widget does not depend on Dojo and is part of the combined Cesium.js file. It is intended to be a flexible base widget for easily building robust applications. (#838) - Changed all widgets to use ECMAScript 5 properties. All public observable properties now must be accessed and assigned as if they were normal properties, instead of being called as functions. For example:
clockViewModel.shouldAnimate()
->clockViewModel.shouldAnimate
clockViewModel.shouldAnimate(true);
->clockViewModel.shouldAnimate = true;
ImageryProviderViewModel.fromConstants
has been removed. Use theImageryProviderViewModel
constructor directly.- Renamed the
transitioner
property onCesiumWidget
,HomeButton
, andScreenModePicker
tosceneTrasitioner
to be consistent with property naming convention. ImageryProvider.loadImage
now requires that the calling imagery provider instance be passed as its first parameter.- Removed the Dojo-based
checkForChromeFrame
function, and replaced it with a new standalone version that returns a promise to signal when the asynchronous check has completed. - Removed
Assets/Textures/NE2_LR_LC_SR_W_DR_2048.jpg
. If you were previously using this image withSingleTileImageryProvider
, consider instead usingTileMapServiceImageryProvider
with a URL ofAssets/Textures/NaturalEarthII
. - The
Client CZML
SandCastle demo has been removed, largely because it is redundant with the Simple CZML demo. - The
Two Viewer Widgets
SandCastle demo has been removed. We will add back a multi-scene example when we have a good architecture for it in place. - Changed static
clone
functions in all objects such that if the object being cloned is undefined, the function will return undefined instead of throwing an exception.
- Removed
- Fix resizing issues in
CesiumWidget
(#608, #834). - Added initial support for GeoJSON and TopoJSON. (#890, #906)
- Added rotation, aligned axis, width, and height properties to
Billboard
s. - Improved the performance of "missing tile" checking, especially for Bing imagery.
- Improved the performance of terrain and imagery refinement, especially when using a mixture of slow and fast imagery sources.
TileMapServiceImageryProvider
now supports imagery with a minimum level. This improves compatibility with tile sets generated by MapTiler or gdal2tiles.py using their default settings.- Added
Context.getAntialias
. - Improved test robustness on Mac.
- Upgraded RequireJS to version 2.1.6, and Almond to 0.2.5.
- Fixed artifacts that showed up on the edges of imagery tiles on a number of GPUs.
- Fixed an issue in
BaseLayerPicker
where destroy wasn't properly cleaning everything up. - Added the ability to unsubscribe to
Timeline
update event. - Added a
screenSpaceEventHandler
property toCesiumWidget
. Also added asceneMode
option to the constructor to set the initial scene mode. - Added
useDefaultRenderLoop
property toCesiumWidget
that allows the default render loop to be disabled so that a custom render loop can be used. - Added
CesiumWidget.onRenderLoopError
which is anEvent
that is raised if an exception is generated inside of the default render loop. ImageryProviderViewModel.creationCommand
can now return an array of ImageryProvider instances, which allows adding multiple layers when a single item is selected in theBaseLayerPicker
widget.
- Breaking changes:
- Replaced
Uniform.getFrameNumber
andUniform.getTime
withUniform.getFrameState
, which returns the full frame state. - Renamed
Widgets/Fullscreen
folder toWidgets/FullscreenButton
along with associated objects/files.FullscreenWidget
->FullscreenButton
FullscreenViewModel
->FullscreenButtonViewModel
- Removed
addAttribute
,removeAttribute
, andsetIndexBuffer
fromVertexArray
. They were not used.
- Replaced
- Added support for approximating local vertical, local horizontal (LVLH) reference frames when using
DynamicObjectView
in 3D. The object automatically selects LVLH or EastNorthUp based on the object's velocity. - Added support for CZML defined vectors via new
CzmlDirection
,DynamicVector
, andDynamicVectorVisualizer
objects. - Added
SceneTransforms.wgs84ToWindowCoordinates
. #746. - Added
fromElements
toCartesian2
,Cartesian3
, andCartesian4
. - Added
DrawCommand.cull
to avoid redundant visibility checks. - Added
czm_morphTime
automatic GLSL uniform. - Added support for OES_vertex_array_object, which improves rendering performance.
- Added support for floating-point textures.
- Added
IntersectionTests.trianglePlaneIntersection
. - Added
computeHorizonCullingPoint
,computeHorizonCullingPointFromVertices
, andcomputeHorizonCullingPointFromExtent
methods toEllipsoidalOccluder
and used them to build a more accurate horizon occlusion test for terrain rendering. - Added sun visualization. See
Sun
andScene.sun
. - Added a new
HomeButton
widget for returning to the default view of the current scene mode. - Added
Command.beforeExecute
andCommand.afterExecute
events to enable additional processing when a command is executed. - Added rotation parameter to
Polygon.configureExtent
. - Added camera flight to extents. See new methods
CameraController.getExtentCameraCoordinates
andCameraFlightPath.createAnimationExtent
. - Improved the load ordering of terrain and imagery tiles, so that relevant detail is now more likely to be loaded first.
- Improved appearance of the Polyline arrow material.
- Fixed polyline clipping artifact. #728.
- Fixed polygon crossing International Date Line for 2D and Columbus view. #99.
- Fixed issue for camera flights when
frameState.mode === SceneMode.MORPHING
. - Fixed ISO8601 date parsing when UTC offset is specified in the extended format, such as
2008-11-10T14:00:00+02:30
.
- Breaking changes:
-
Removed the color, outline color, and outline width properties of polylines. Instead, use materials for polyline color and outline properties. Code that looked like:
var polyline = polylineCollection.add({ positions : positions, color : new Color(1.0, 1.0, 1.0, 1.0), outlineColor : new Color(1.0, 0.0, 0.0, 1.0), width : 1.0, outlineWidth : 3.0 });
should now look like:
var outlineMaterial = Material.fromType(context, Material.PolylineOutlineType); outlineMaterial.uniforms.color = new Color(1.0, 1.0, 1.0, 1.0); outlineMaterial.uniforms.outlineColor = new Color(1.0, 0.0, 0.0, 1.0); outlineMaterial.uniforms.outlinewidth = 2.0; var polyline = polylineCollection.add({ positions : positions, width : 3.0, material : outlineMaterial });
-
CzmlCartographic
has been removed and all cartographic values are converted to Cartesian internally during CZML processing. This improves performance and fixes interpolation of cartographic source data. The Cartographic representation can still be retrieved if needed. -
Removed
ComplexConicSensorVolume
, which was not documented and did not work on most platforms. It will be brought back in a future release. This does not affect CZML, which uses a custom sensor to approximate a complex conic. -
Replaced
computeSunPosition
withSimon1994PlanetaryPosition
, which has functions to calculate the position of the sun and the moon more accurately. -
Removed
Context.createClearState
. These properties are now part ofClearCommand
. -
RenderState
objects returned fromContext.createRenderState
are now immutable. -
Removed
positionMC
fromczm_materialInput
. It is no longer used by any materials.
-
- Added wide polylines that work with and without ANGLE.
- Polylines now use materials to describe their surface appearance. See the Fabric wiki page for more details on how to create materials.
- Added new
PolylineOutline
,PolylineGlow
,PolylineArrow
, andFade
materials. - Added
czm_pixelSizeInMeters
automatic GLSL uniform. - Added
AnimationViewModel.snapToTicks
, which when set to true, causes the shuttle ring on the Animation widget to snap to the defined tick values, rather than interpolate between them. - Added
Color.toRgba
andColor.fromRgba
to convert to/from numeric unsigned 32-bit RGBA values. - Added
GridImageryProvider
for custom rendering effects and debugging. - Added new
Grid
material. - Made
EllipsoidPrimitive
double-sided. - Improved rendering performance by minimizing WebGL state calls.
- Fixed an error in Web Worker creation when loading Cesium.js from a different origin.
- Fixed
EllipsoidPrimitive
picking and picking objects with materials that have transparent parts. - Fixed imagery smearing artifacts on mobile devices and other devices without high-precision fragment shaders.
- Breaking changes:
Billboard.computeScreenSpacePosition
now takesContext
andFrameState
arguments instead of aUniformState
argument.- Removed
clampToPixel
property fromBillboardCollection
andLabelCollection
. This option is no longer needed due to overall LabelCollection visualization improvements. - Removed
Widgets/Dojo/CesiumWidget
and replaced it withWidgets/CesiumWidget
, which has no Dojo dependancies. destroyObject
no longer deletes properties from the object being destroyed.darker.css
files have been deleted and thedarker
theme is now the default style for widgets. The original theme is now known aslighter
and is in correspondinglighter.css
files.- CSS class names have been standardized to avoid potential collisions. All widgets now follow the same pattern,
cesium-<widget>-<className>
. - Removed
view2D
,view3D
, andviewColumbus
properties fromCesiumViewerWidget
. Use thesceneTransitioner
property instead.
- Added
BoundingSphere.fromCornerPoints
. - Added
fromArray
anddistance
functions toCartesian2
,Cartesian3
, andCartesian4
. - Added
DynamicPath.resolution
property for setting the maximum step size, in seconds, to take when sampling a position for path visualization. - Added
TileCoordinatesImageryProvider
that renders imagery with tile X, Y, Level coordinates on the surface of the globe. This is mostly useful for debugging. - Added
DynamicEllipse
andDynamicObject.ellipse
property to render CZML ellipses on the globe. - Added
sampleTerrain
function to sample the terrain height of a list ofCartographic
positions. - Added
DynamicObjectCollection.removeObject
and handling of the new CZMLdelete
property. - Imagery layers with an
alpha
of exactly 0.0 are no longer rendered. Previously these invisible layers were rendered normally, which was a waste of resources. Unlike theshow
property, imagery tiles in a layer with analpha
of 0.0 are still downloaded, so the layer will become visible more quickly when itsalpha
is increased. - Added
onTransitionStart
andonTransitionComplete
events toSceneModeTransitioner
. - Added
SceneModePicker
; a new widget for morphing between scene modes. - Added
BaseLayerPicker
; a new widget for switching among pre-configured base layer imagery providers.
- Breaking changes:
- Major refactoring of both animation and widgets systems as we move to an MVVM-like architecture for user interfaces.
- New
Animation
widget for controlling playback. - AnimationController.js has been deleted.
ClockStep.SYSTEM_CLOCK_DEPENDENT
was renamed toClockStep.SYSTEM_CLOCK_MULTIPLIER
.ClockStep.SYSTEM_CLOCK
was added to have the clock always match the system time.ClockRange.LOOP
was renamed toClockRange.LOOP_STOP
and now only loops in the forward direction.Clock.reverseTick
was removed, simply negateClock.multiplier
and pass it toClock.tick
.Clock.shouldAnimate
was added to indicate ifClock.tick
should actually advance time.- The Timeline widget was moved into the Widgets/Timeline subdirectory.
Dojo/TimelineWidget
was removed. You should use the non-toolkit specific Timeline widget directly.
- New
- Removed
CesiumViewerWidget.fullScreenElement
, instead use theCesiumViewerWidget.fullscreen.viewModel.fullScreenElement
observable property. IntersectionTests.rayPlane
now takes the newPlane
type instead of separateplaneNormal
andplaneD
arguments.- Renamed
ImageryProviderError
toTileProviderError
.
- Major refactoring of both animation and widgets systems as we move to an MVVM-like architecture for user interfaces.
- Added support for global terrain visualization via
CesiumTerrainProvider
,ArcGisImageServerTerrainProvider
, andVRTheWorldTerrainProvider
. See the Terrain Tutorial for more information. - Added
FullscreenWidget
which is a simple, single-button widget that toggles fullscreen mode of the specified element. - Added interactive extent drawing to the
Picking
Sandcastle example. - Added
HeightmapTessellator
to create a mesh from a heightmap. - Added
JulianDate.equals
. - Added
Plane
for representing the equation of a plane. - Added a line segment-plane intersection test to
IntersectionTests
. - Improved the lighting used in 2D and Columbus View modes. In general, the surface lighting in these modes should look just like it does in 3D.
- Fixed an issue where a
PolylineCollection
with a model matrix other than the identity would be incorrectly rendered in 2D and Columbus view. - Fixed an issue in the
ScreenSpaceCameraController
where disabled mouse events can cause the camera to be moved after being re-enabled.
- Breaking changes:
- The combined
Cesium.js
file and other required files are now created inBuild/Cesium
andBuild/CesiumUnminified
folders. - The Web Worker files needed when using the combined
Cesium.js
file are now in aWorkers
subdirectory. - Removed
erosion
property fromPolygon
,ComplexConicSensorVolume
,RectangularPyramidSensorVolume
, andComplexConicSensorVolume
. Use the newErosion
material. See the Sandbox Animation example. - Removed
setRectangle
andgetRectangle
methods fromViewportQuad
. Use the newrectangle
property. - Removed
time
parameter fromScene.initializeFrame
. Instead, pass the time toScene.render
.
- The combined
- Added new
RimLighting
andErosion
materials. See the Fabric wiki page. - Added
hue
andsaturation
properties toImageryLayer
. - Added
czm_hue
andczm_saturation
to adjust the hue and saturation of RGB colors. - Added
JulianDate.getDaysDifference
method. - Added
Transforms.computeIcrfToFixedMatrix
andcomputeFixedToIcrfMatrix
. - Added
EarthOrientationParameters
,EarthOrientationParametersSample
,Iau2006XysData
, andIau2006XysDataSample
classes toCore
. - CZML now supports the ability to specify positions in the International Celestial Reference Frame (ICRF), and inertial reference frame.
- Fixed globe rendering on the Nexus 4 running Google Chrome Beta.
ViewportQuad
now supports the material system. See the Fabric wiki page.- Fixed rendering artifacts in
EllipsoidPrimitive
. - Fixed an issue where streaming CZML would fail when changing material types.
- Updated Dojo from 1.7.2 to 1.8.4. Reminder: Cesium does not depend on Dojo but uses it for reference applications.
- Breaking changes:
-
Renamed the
server
property tourl
when constructing aBingMapsImageryProvider
. Likewise, renamedBingMapsImageryProvider.getServer
toBingMapsImageryProvider.getUrl
. Code that looked likevar bing = new BingMapsImageryProvider({ server : 'dev.virtualearth.net' });
should now look like:
var bing = new BingMapsImageryProvider({ url : 'http://dev.virtualearth.net' });
-
Renamed
toCSSColor
totoCssColorString
. -
Moved
minimumZoomDistance
andmaximumZoomDistance
from theCameraController
to theScreenSpaceCameraController
.
-
- Added
fromCssColorString
toColor
to create aColor
instance from any CSS value. - Added
fromHsl
toColor
to create aColor
instance from H, S, L values. - Added
Scene.backgroundColor
. - Added
textureRotationAngle
parameter toPolygon.setPositions
andPolygon.configureFromPolygonHierarchy
to rotate textures on polygons. - Added
Matrix3.fromRotationX
,Matrix3.fromRotationY
,Matrix3.fromRotationZ
, andMatrix2.fromRotation
. - Added
fromUniformScale
toMatrix2
,Matrix3
, andMatrix4
. - Added
fromScale
toMatrix2
. - Added
multiplyByUniformScale
toMatrix4
. - Added
flipY
property when callingContext.createTexture2D
andContext.createCubeMap
. - Added
MeshFilters.encodePosition
andEncodedCartesian3.encode
. - Fixed jitter artifacts with polygons.
- Fixed camera tilt close to the
minimumZoomDistance
. - Fixed a bug that could lead to blue tiles when zoomed in close to the North and South poles.
- Fixed a bug where removing labels would remove the wrong label and ultimately cause a crash.
- Worked around a bug in Firefox 18 preventing typed arrays from being transferred to or from Web Workers.
- Upgraded RequireJS to version 2.1.2, and Almond to 0.2.3.
- Updated the default Bing Maps API key.
- Breaking changes:
- Renamed
EventHandler
toScreenSpaceEventHandler
. - Renamed
MouseEventType
toScreenSpaceEventType
. - Renamed
MouseEventType.MOVE
toScreenSpaceEventType.MOUSE_MOVE
. - Renamed
CameraEventHandler
toCameraEventAggregator
. - Renamed all
*MouseAction
to*InputAction
(including get, set, remove, etc). - Removed
Camera2DController
,CameraCentralBodyController
,CameraColumbusViewController
,CameraFlightController
,CameraFreeLookController
,CameraSpindleController
, andCameraControllerCollection
. Common ways to modify the camera are through theCameraController
object of theCamera
and will work in all scene modes. The default camera handler is theScreenSpaceCameraController
object on theScene
. - Changed default Natural Earth imagery to a 2K version of Natural Earth II with Shaded Relief, Water, and Drainages. The previously used version did not include lakes and rivers. This replaced
Source/Assets/Textures/NE2_50M_SR_W_2048.jpg
withSource/Assets/Textures/NE2_LR_LC_SR_W_DR_2048.jpg
.
- Renamed
- Added pinch-zoom, pinch-twist, and pinch-tilt for touch-enabled browsers (particularly mobile browsers).
- Improved rendering support on Nexus 4 and Nexus 7 using Firefox.
- Improved camera flights.
- Added Sandbox example using NASA's new Black Marble night imagery.
- Added constrained z-axis by default to the Cesium widgets.
- Upgraded Jasmine from version 1.1.0 to 1.3.0.
- Added
JulianDate.toIso8601
, which creates an ISO8601 compliant representation of a JulianDate. - The
Timeline
widget now properly displays leap seconds.
- Breaking changes:
- Widget render loop now started by default. Startup code changed, see Sandcastle examples.
- Changed
Timeline.makeLabel
to take aJulianDate
instead of a JavaScript date parameter. - Default Earth imagery has been moved to a new package
Assets
. Images used bySandcastle
examples have been moved to the Sandcastle folder, and images used by the Dojo widgets are now self-contained in theWidgets
package. positionToEyeEC
inczm_materialInput
is no longer normalized by default.FullScreen
and related functions have been renamed toFullscreen
to match the W3C standard name.Fullscreen.isFullscreenEnabled
was incorrectly implemented in certain browsers.isFullscreenEnabled
now correctly determines whether the browser will allow an element to go fullscreen. A newisFullscreen
function is available to determine if the browser is currently in fullscreen mode.Fullscreen.getFullScreenChangeEventName
andFullscreen.getFullScreenChangeEventName
now return the proper event name, suitable for use with theaddEventListener
API, instead prefixing them with "on".- Removed
Scene.setSunPosition
andScene.getSunPosition
. The sun position used for lighting is automatically computed based on the scene's time. - Removed a number of rendering options from
CentralBody
, including the ground atmosphere, night texture, specular map, cloud map, cloud shadows, and bump map. These features weren't really production ready and had a disproportionate cost in terms of shader complexity and compilation time. They may return in a more polished form in a future release. - Removed
affectedByLighting
property fromPolygon
,EllipsoidPrimitive
,RectangularPyramidSensorVolume
,CustomSensorVolume
, andComplexConicSensorVolume
. - Removed
DistanceIntervalMaterial
. This was not documented. Matrix2.getElementIndex
,Matrix3.getElementIndex
, andMatrix4.getElementIndex
functions have had their parameters swapped and now take row first and column second. This is consistent with other class constants, such as Matrix2.COLUMN1ROW2.- Replaced
CentralBody.showSkyAtmosphere
withScene.skyAtmosphere
andSkyAtmosphere
. This has no impact for those using the Cesium widget.
- Improved lighting in Columbus view and on polygons, ellipsoids, and sensors.
- Fixed atmosphere rendering artifacts and improved Columbus view transition.
- Fixed jitter artifacts with billboards and polylines.
- Added
TileMapServiceImageryProvider
. See the Imagery LayersSandcastle
example. - Added
Water
material. See the MaterialsSandcastle
example. - Added
SkyBox
to draw stars. AddedCesiumWidget.showSkyBox
andCesiumViewerWidget.showSkyBox
. - Added new
Matrix4
functions:Matrix4.multiplyByTranslation
,multiplyByPoint
, andMatrix4.fromScale
. AddedMatrix3.fromScale
. - Added
EncodedCartesian3
, which is used to eliminate jitter when drawing primitives. - Added new automatic GLSL uniforms:
czm_frameNumber
,czm_temeToPseudoFixed
,czm_entireFrustum
,czm_inverseModel
,czm_modelViewRelativeToEye
,czm_modelViewProjectionRelativeToEye
,czm_encodedCameraPositionMCHigh
, andczm_encodedCameraPositionMCLow
. - Added
czm_translateRelativeToEye
andczm_luminance
GLSL functions. - Added
shininess
toczm_materialInput
. - Added
QuadraticRealPolynomial
,CubicRealPolynomial
, andQuarticRealPolynomial
for finding the roots of quadratic, cubic, and quartic polynomials. - Added
IntersectionTests.grazingAltitudeLocation
for finding a point on a ray nearest to an ellipsoid. - Added
mostOrthogonalAxis
function toCartesian2
,Cartesian3
, andCartesian4
. - Changed CesiumViewerWidget default behavior so that zooming to an object now requires a single left-click, rather than a double-click.
- Updated third-party Tween.js.
- Breaking changes:
- Renamed
Texture2DPool
toTexturePool
. - Renamed
BingMapsTileProvider
toBingMapsImageryProvider
. - Renamed
SingleTileProvider
toSingleTileImageryProvider
. - Renamed
ArcGISTileProvider
toArcGisMapServerImageryProvider
. - Renamed
EquidistantCylindrdicalProjection
toGeographicProjection
. - Renamed
MercatorProjection
toWebMercatorProjection
. CentralBody.dayTileProvider
has been removed. Instead, add one or more imagery providers to the collection returned byCentralBody.getImageryLayers()
.- The
description.generateTextureCoords
parameter passed toExtentTessellator.compute
is now calleddescription.generateTextureCoordinates
. - Renamed
bringForward
,sendBackward
,bringToFront
, andsendToBack
methods onCompositePrimitive
toraise
,lower
,raiseToTop
, andlowerToBottom
, respectively. Cache
andCachePolicy
are no longer used and have been removed.- Fixed problem with Dojo widget startup, and removed "postSetup" callback in the process. See Sandcastle examples and update your startup code.
- Renamed
CentralBody
now allows imagery from multiple sources to be layered and alpha blended on the globe. See the newImagery Layers
andMap Projections
Sandcastle examples.- Added
WebMapServiceImageryProvider
. - Improved middle mouse click behavior to always tilt in the same direction.
- Added
getElementIndex
toMatrix2
,Matrix3
, andMatrix4
.
- Breaking changes:
- Removed the
render
andrenderForPick
functions of primitives. The primitiveupdate
function updates a list of commands for the renderer. For more details, see the Data Driven Renderer. - Removed
Context.getViewport
andContext.setViewport
. The viewport defaults to the size of the canvas if a primitive does not override the viewport property in the render state. shallowEquals
has been removed.- Passing
undefined
to any of the set functions onBillboard
now throws an exception. - Passing
undefined
to any of the set functions onPolyline
now throws an exception. PolygonPipeline.scaleToGeodeticHeight
now takes ellipsoid as the last parameter, instead of the first. It also now defaults toEllipsoid.WGS84
if no parameter is provided.
- Removed the
- The new Sandcastle live editor and demo gallery replace the Sandbox and Skeleton examples.
- Improved picking performance and accuracy.
- Added EllipsoidPrimitive for visualizing ellipsoids and spheres. Currently, this is only supported in 3D, not 2D or Columbus view.
- Added
DynamicEllipsoid
andDynamicEllipsoidVisualizer
which use the newEllipsoidPrimitive
to implement ellipsoids in CZML. Extent
functions now take optional result parameters. Also addedgetCenter
,intersectWith
, andcontains
functions.- Add new utility class,
DynamicObjectView
for tracking a DynamicObject with the camera across scene modes; also hooked up CesiumViewerWidget to use it. - Added
enableTranslate
,enableZoom
, andenableRotate
properties toCamera2DController
to selectively toggle camera behavior. All values default totrue
. - Added
Camera2DController.setPositionCartographic
to simplify moving the camera programmatically when in 2D mode. - Improved near/far plane distances and eliminated z-fighting.
- Added
Matrix4.multiplyByTranslation
,Matrix4.fromScale
, andMatrix3.fromScale
.
-
Breaking changes:
-
Materials are now created through a centralized Material class using a JSON schema called Fabric. For example, change:
polygon.material = new BlobMaterial({repeat : 10.0});
to:
polygon.material = Material.fromType(context, 'Blob'); polygon.material.repeat = 10.0;
or:
polygon.material = new Material({ context : context, fabric : { type : 'Blob', uniforms : { repeat : 10.0 } } });
-
Label.computeScreenSpacePosition
now requires the current scene state as a parameter. -
Passing
undefined
to any of the set functions onLabel
now throws an exception. -
Renamed
agi_
prefix on GLSL identifiers toczm_
. -
Replaced
ViewportQuad
propertiesvertexShader
andfragmentShader
with optional constructor arguments. -
Changed the GLSL automatic uniform
czm_viewport
from anivec4
to avec4
to reduce casting. -
Billboard
now defaults to an image index of-1
indicating no texture, previously billboards defaulted to0
indicating the first texture in the atlas. For example, change:billboards.add({ position : { x : 1.0, y : 2.0, z : 3.0 }, });
to:
billboards.add({ position : { x : 1.0, y : 2.0, z : 3.0 }, imageIndex : 0 });
-
Renamed
SceneState
toFrameState
. -
SunPosition
was changed from a static object to a functioncomputeSunPosition
; which now returns aCartesian3
with the computed position. It was also optimized for performance and memory pressure. For example, change:var result = SunPosition.compute(date); var position = result.position; to: var position = computeSunPosition(date);
-
-
All
Quaternion
operations now have static versions that work with any objects exposingx
,y
,z
andw
properties. -
Added support for nested polygons with holes. See
Polygon.configureFromPolygonHierarchy
. -
Added support to the renderer for view frustum and central body occlusion culling. All built-in primitives, such as
BillboardCollection
,Polygon
,PolylineCollection
, etc., can be culled. See the advanced examples in the Sandbox for details. -
Added
writeTextToCanvas
function which handles sizing the resulting canvas to fit the desired text. -
Added support for CZML path visualization via the
DynamicPath
andDynamicPathVisualizer
objects. See the CZML wiki for more details. -
Added support for WEBGL_depth_texture. See
Framebuffer.setDepthTexture
. -
Added
CesiumMath.isPowerOfTwo
. -
Added
affectedByLighting
toComplexConicSensorVolume
,CustomSensorVolume
, andRectangularPyramidSensorVolume
to turn lighting on/off for these objects. -
CZML
Polygon
,Cone
, andPyramid
objects are no longer affected by lighting. -
Added
czm_viewRotation
andczm_viewInverseRotation
automatic GLSL uniforms. -
Added a
clampToPixel
property toBillboardCollection
andLabelCollection
. When true, it aligns all billboards and text to a pixel in screen space, providing a crisper image at the cost of jumpier motion. -
Ellipsoid
functions now take optional result parameters.
-
Breaking changes:
-
Removed keyboard input handling from
EventHandler
. -
TextureAtlas
takes an object literal in its constructor instead of separate parameters. Code that previously looked like:context.createTextureAtlas(images, pixelFormat, borderWidthInPixels);
should now look like:
context.createTextureAtlas({images : images, pixelFormat : pixelFormat, borderWidthInPixels : borderWidthInPixels});
-
Camera.pickEllipsoid
returns the picked position in world coordinates and the ellipsoid parameter is optional. Prefer the newScene.pickEllipsoid
method. For example, changevar position = camera.pickEllipsoid(ellipsoid, windowPosition);
to:
var position = scene.pickEllipsoid(windowPosition, ellipsoid);
-
Camera.getPickRay
now returns the newRay
type instead of an object with position and direction properties. -
Camera.viewExtent
now takes anExtent
argument instead of west, south, east and north arguments. PreferScene.viewExtent
overCamera.viewExtent
.Scene.viewExtent
will work in anySceneMode
. For example, changecamera.viewExtent(ellipsoid, west, south, east, north);
to:
scene.viewExtent(extent, ellipsoid);
-
CameraSpindleController.mouseConstrainedZAxis
has been removed. Instead, useCameraSpindleController.constrainedAxis
. Code that previously looked like:spindleController.mouseConstrainedZAxis = true;
should now look like:
spindleController.constrainedAxis = Cartesian3.UNIT_Z;
-
The
Camera2DController
constructor andCameraControllerCollection.add2D
now require a projection instead of an ellipsoid. -
Chain
has been removed.when
is now included as a more complete CommonJS Promises/A implementation. -
Jobs.downloadImage
was replaced withloadImage
to provide a promise that will asynchronously load an image. -
jsonp
now returns a promise for the requested data, removing the need for a callback parameter. -
JulianDate.getTimeStandard() has been removed, dates are now always stored internally as TAI.
-
LeapSeconds.setLeapSeconds now takes an array of LeapSecond instances instead of JSON.
-
TimeStandard.convertUtcToTai and TimeStandard.convertTaiToUtc have been removed as they are no longer needed.
-
Cartesian3.prototype.getXY()
was replaced withCartesian2.fromCartesian3
. Code that previously looked likecartesian3.getXY();
should now look likeCartesian2.fromCartesian3(cartesian3);
. -
Cartesian4.prototype.getXY()
was replaced withCartesian2.fromCartesian4
. Code that previously looked likecartesian4.getXY();
should now look likeCartesian2.fromCartesian4(cartesian4);
. -
Cartesian4.prototype.getXYZ()
was replaced withCartesian3.fromCartesian4
. Code that previously looked likecartesian4.getXYZ();
should now look likeCartesian3.fromCartesian4(cartesian4);
. -
Math.angleBetween
was removed because it was a duplicate ofCartesian3.angleBetween
. Simply replace calls of the former to the later. -
Cartographic3
was renamed toCartographic
. -
Cartographic2
was removed; useCartographic
instead. -
Ellipsoid.toCartesian
was renamed toEllipsoid.cartographicToCartesian
. -
Ellipsoid.toCartesians
was renamed toEllipsoid.cartographicArrayToCartesianArray
. -
Ellipsoid.toCartographic2
was renamed toEllipsoid.cartesianToCartographic
. -
Ellipsoid.toCartographic2s
was renamed toEllipsoid.cartesianArrayToCartographicArray
. -
Ellipsoid.toCartographic3
was renamed toEllipsoid.cartesianToCartographic
. -
Ellipsoid.toCartographic3s
was renamed toEllipsoid.cartesianArrayToCartographicArray
. -
Ellipsoid.cartographicDegreesToCartesian
was removed. Code that previously looked likeellipsoid.cartographicDegreesToCartesian(new Cartographic(45, 50, 10))
should now look likeellipsoid.cartographicToCartesian(Cartographic.fromDegrees(45, 50, 10))
. -
Math.cartographic3ToRadians
,Math.cartographic2ToRadians
,Math.cartographic2ToDegrees
, andMath.cartographic3ToDegrees
were removed. These functions are no longer needed because Cartographic instances are always represented in radians. -
All functions starting with
multiplyWith
now start withmultiplyBy
to be consistent with functions starting withdivideBy
. -
The
multiplyWithMatrix
function on eachMatrix
type was renamed tomultiply
. -
All three Matrix classes have been largely re-written for consistency and performance. The
values
property has been eliminated and Matrices are no longer immutable. Code that previously looked likematrix = matrix.setColumn0Row0(12);
now looks likematrix[Matrix2.COLUMN0ROW0] = 12;
. Code that previously looked likematrix.setColumn3(cartesian3);
now looked likematrix.setColumn(3, cartesian3, matrix)
. -
'Polyline' is no longer externally creatable. To create a 'Polyline' use the 'PolylineCollection.add' method.
Polyline polyline = new Polyline();
to
PolylineCollection polylineCollection = new PolylineCollection(); Polyline polyline = polylineCollection.add();
-
-
All
Cartesian2
operations now have static versions that work with any objects exposingx
andy
properties. -
All
Cartesian3
operations now have static versions that work with any objects exposingx
,y
, andz
properties. -
All
Cartesian4
operations now have static versions that work with any objects exposingx
,y
,z
andw
properties. -
All
Cartographic
operations now have static versions that work with any objects exposinglongitude
,latitude
, andheight
properties. -
All
Matrix
classes are now indexable like arrays. -
All
Matrix
operations now have static versions of all prototype functions and anywhere we take a Matrix instance as input can now also take an Array or TypedArray. -
All
Matrix
,Cartesian
, andCartographic
operations now take an optional result parameter for object re-use to reduce memory pressure. -
Added
Cartographic.fromDegrees
to make creating Cartographic instances from values in degrees easier. -
Added
addImage
toTextureAtlas
so images can be added to a texture atlas after it is constructed. -
Added
Scene.pickEllipsoid
, which picks either the ellipsoid or the map depending on the currentSceneMode
. -
Added
Event
, a new utility class which makes it easy for objects to expose event properties. -
Added
TextureAtlasBuilder
, a new utility class which makes it easy to build a TextureAtlas asynchronously. -
Added
Clock
, a simple clock for keeping track of simulated time. -
Added
LagrangePolynomialApproximation
,HermitePolynomialApproximation
, andLinearApproximation
interpolation algorithms. -
Added
CoordinateConversions
, a new static class where most coordinate conversion methods will be stored. -
Added
Spherical
coordinate type -
Added a new DynamicScene layer for time-dynamic, data-driven visualization. This include CZML processing. For more details see https://github.com/AnalyticalGraphicsInc/cesium/wiki/Architecture and https://github.com/AnalyticalGraphicsInc/cesium/wiki/CZML-in-Cesium.
-
Added a new application, Cesium Viewer, for viewing CZML files and otherwise exploring the globe.
-
Added a new Widgets directory, to contain common re-usable Cesium related controls.
-
Added a new Timeline widget to the Widgets directory.
-
Added a new Widgets/Dojo directory, to contain dojo-specific widgets.
-
Added new Timeline and Cesium dojo widgets.
-
Added
CameraCentralBodyController
as the new default controller to handle mouse input.- The left mouse button rotates around the central body.
- The right mouse button and mouse wheel zoom in and out.
- The middle mouse button rotates around the point clicked on the central body.
-
Added
computeTemeToPseudoFixedMatrix
function toTransforms
. -
Added 'PolylineCollection' to manage numerous polylines. 'PolylineCollection' dramatically improves rendering speed when using polylines.
- Breaking changes:
- Changed
Tipsify.tipsify
andTipsify.calculateACMR
to accept an object literal instead of three separate arguments. Supplying a maximum index and cache size is now optional. CentralBody
no longer requires a camera as the first parameter.
- Changed
- Added
CentralBody.northPoleColor
andCentralBody.southPoleColor
to fill in the poles if they are not covered by a texture. - Added
Polygon.configureExtent
to create a polygon defined by west, south, east, and north values. - Added functions to
Camera
to provide position and directions in world coordinates. - Added
showThroughEllipsoid
toCustomSensorVolume
andRectangularPyramidSensorVolume
to allow sensors to draw through Earth. - Added
affectedByLighting
toCentralBody
andPolygon
to turn lighting on/off for these objects.
-
Breaking changes:
-
Renamed Geoscope to Cesium. To update your code, change all
Geoscope.*
references toCesium.*
, and reference Cesium.js instead of Geoscope.js. -
CompositePrimitive.addGround
was removed; useCompositePrimitive.add
instead. For example, changeprimitives.addGround(polygon);
to:
primitives.add(polygon);
-
Moved
eastNorthUpToFixedFrame
andnorthEastDownToFixedFrame
functions fromEllipsoid
to a newTransforms
object. For example, changevar m = ellipsoid.eastNorthUpToFixedFrame(p);
to:
var m = Cesium.Transforms.eastNorthUpToFixedFrame(p, ellipsoid);
-
Label properties
fillStyle
andstrokeStyle
were renamed tofillColor
andoutlineColor
; they are also now color objects instead of strings. The labelColor
property has been removed.For example, change
label.setFillStyle("red"); label.setStrokeStyle("#FFFFFFFF");
to:
label.setFillColor({ red : 1.0, blue : 0.0, green : 0.0, alpha : 1.0 }); label.setOutlineColor({ red : 1.0, blue : 1.0, green : 1.0, alpha : 1.0 });
-
Renamed
Tipsify.Tipsify
toTipsify.tipsify
. -
Renamed
Tipsify.CalculateACMR
toTipsify.calculateACMR
. -
Renamed
LeapSecond.CompareLeapSecondDate
toLeapSecond.compareLeapSecondDate
. -
Geoscope.JSONP.get
is nowCesium.jsonp
.Cesium.jsonp
now takes a url, a callback function, and an options object. The previous 2nd and 4th parameters are now specified using the options object. -
TWEEN
is no longer globally defined, and is instead available asCesium.Tween
. -
Chain.js functions such as
run
are now moved toCesium.Chain.run
, etc. -
Geoscope.CollectionAlgorithms.binarySearch
is nowCesium.binarySearch
. -
Geoscope.ContainmentTests.pointInsideTriangle2D
is nowCesium.pointInsideTriangle2D
. -
Static constructor methods prefixed with "createFrom", now start with "from":
Matrix2.createfromColumnMajorArray
becomes
Matrix2.fromColumnMajorArray
-
The
JulianDate
constructor no longer takes aDate
object, use the new from methods instead:new JulianDate(new Date());
becomes
JulianDate.fromDate(new Date("January 1, 2011 12:00:00 EST")); JulianDate.fromIso8601("2012-04-24T18:08Z"); JulianDate.fromTotalDays(23452.23);
-
JulianDate.getDate
is nowJulianDate.toDate()
and returns a new instance each time. -
CentralBody.logoOffsetX
andlogoOffsetY
have been replaced withCentralBody.logoOffset
, aCartesian2
. -
TileProviders now take a proxy object instead of a string, to allow more control over how proxy URLs are built. Construct a DefaultProxy, passing the previous proxy URL, to get the previous behavior.
-
Ellipsoid.getScaledWgs84()
has been removed since it is not needed. -
getXXX()
methods which returned a new instance of what should really be a constant are now exposed as frozen properties instead. This should improve performance and memory pressure.Cartsian2/3/4.getUnitX()
->Cartsian2/3/4.UNIT_X
Cartsian2/3/4.getUnitY()
->Cartsian2/3/4.UNIT_Y
Cartsian2/3/4.getUnitZ()
->Cartsian3/4.UNIT_Z
Cartsian2/3/4.getUnitW()
->Cartsian4.UNIT_W
Matrix/2/3/4.getIdentity()
->Matrix/2/3/4.IDENTITY
Quaternion.getIdentity()
->Quaternion.IDENTITY
Ellipsoid.getWgs84()
->Ellipsoid.WGS84
Ellipsoid.getUnitSphere()
->Ellipsoid.UNIT_SPHERE
Cartesian2/3/4/Cartographic.getZero()
->Cartesian2/3/4/Cartographic.ZERO
-
-
Added
PerformanceDisplay
which can be added to a scene to display frames per second (FPS). -
Labels now correctly allow specifying fonts by non-pixel CSS units such as points, ems, etc.
-
Added
Shapes.computeEllipseBoundary
and updatedShapes.computeCircleBoundary
to compute boundaries using arc-distance. -
Added
fileExtension
andcredit
properties toOpenStreetMapTileProvider
construction. -
Night lights no longer disappear when
CentralBody.showGroundAtmosphere
istrue
.
-
Breaking changes:
-
Replaced
Geoscope.SkyFromSpace
object withCentralBody.showSkyAtmosphere
property. -
For mouse click and double click events, replaced
event.x
andevent.y
withevent.position
. -
For mouse move events, replaced
movement.startX
andstartY
withmovement.startPosition
. Replacedmovement.endX
andmovement.endY
withmovement.endPosition
. -
Scene.Pick
now takes aCartesian2
with the origin at the upper-left corner of the canvas. For example, code that looked like:scene.pick(movement.endX, scene.getCanvas().clientHeight - movement.endY);
becomes:
scene.pick(movement.endPosition);
-
-
Added
SceneTransitioner
to switch between 2D and 3D views. See the new Skeleton 2D example. -
Added
CentralBody.showGroundAtmosphere
to show an atmosphere on the ground. -
Added
Camera.pickEllipsoid
to get the point on the globe under the mouse cursor. -
Added
Polygon.height
to draw polygons at a constant altitude above the ellipsoid.
- Breaking changes:
- Replaced
Geoscope.Constants
andGeoscope.Trig
withGeoscope.Math
. Polygon
- Replaced
setColor
andgetColor
with amaterial.color
property. - Replaced
setEllipsoid
andgetEllipsoid
with anellipsoid
property. - Replaced
setGranularity
andgetGranularity
with agranularity
property.
- Replaced
Polyline
- Replaced
setColor
/getColor
andsetOutlineColor
/getOutlineColor
withcolor
andoutline
properties. - Replaced
setWidth
/getWidth
andsetOutlineWidth
/getOutlineWidth
withwidth
andoutlineWidth
properties.
- Replaced
- Removed
Geoscope.BillboardCollection.bufferUsage
. It is now automatically determined. - Removed
Geoscope.Label
set/get functions forshadowOffset
,shadowBlur
,shadowColor
. These are no longer supported. - Renamed
Scene.getTransitions
toScene.getAnimations
. - Renamed
SensorCollection
toSensorVolumeCollection
. - Replaced
ComplexConicSensorVolume.material
with separate materials for each surface:outerMaterial
,innerMaterial
, andcapMaterial
. - Material renames
TranslucentSensorVolumeMaterial
toColorMaterial
.DistanceIntervalSensorVolumeMaterial
toDistanceIntervalMaterial
.TieDyeSensorVolumeMaterial
toTieDyeMaterial
.CheckerboardSensorVolumeMaterial
toCheckerboardMaterial
.PolkaDotSensorVolumeMaterial
toDotMaterial
.FacetSensorVolumeMaterial
toFacetMaterial
.BlobSensorVolumeMaterial
toBlobMaterial
.
- Added new materials:
VerticalStripeMaterial
HorizontalStripeMaterial
DistanceIntervalMaterial
- Added polygon material support via the new
Polygon.material
property. - Added clock angle support to
ConicSensorVolume
via the newmaximumClockAngle
andminimumClockAngle
properties. - Added a rectangular sensor,
RectangularPyramidSensorVolume
. - Changed custom sensor to connect direction points using the sensor's radius; previously, points were connected with a line.
- Improved performance and memory usage of
BillboardCollection
andLabelCollection
. - Added more mouse events.
- Added Sandbox examples for new features.
- Replaced
- Added complex conic and custom sensor volumes, and various materials to change their appearance. See the new Sensor folder in the Sandbox.
- Added modelMatrix property to primitives to render them in a local reference frame. See the polyline example in the Sandbox.
- Added eastNorthUpToFixedFrame() and northEastDownToFixedFrame() to Ellipsoid to create local reference frames.
- Added CameraFlightController to zoom smoothly from one point to another. See the new camera examples in the Sandbox.
- Added row and column assessors to Matrix2, Matrix3, and Matrix4.
- Added Scene, which reduces the amount of code required to use Geoscope. See the Skeleton. We recommend using this instead of explicitly calling update() and render() for individual or composite primitives. Existing code will need minor changes:
- Calls to Context.pick() should be replaced with Scene.pick().
- Primitive constructors no longer require a context argument.
- Primitive update() and render() functions now require a context argument. However, when using the new Scene object, these functions do not need to be called directly.
- TextureAtlas should no longer be created directly; instead, call Scene.getContext().createTextureAtlas().
- Other breaking changes:
-
Camera get/set functions, e.g., getPosition/setPosition were replaced with properties, e.g., position.
-
Replaced CompositePrimitive, Polygon, and Polyline getShow/setShow functions with a show property.
-
Replaced Polyline, Polygon, BillboardCollection, and LabelCollection getBufferUsage/setBufferUsage functions with a bufferUsage property.
-
Changed colors used by billboards, labels, polylines, and polygons. Previously, components were named r, g, b, and a. They are now red, green, blue, and alpha. Previously, each component's range was [0, 255]. The range is now [0, 1] floating point. For example,
color : { r : 0, g : 255, b : 0, a : 255 }
becomes:
color : { red : 0.0, green : 1.0, blue : 0.0, alpha : 1.0 }
-
-
Added
Shapes.computeCircleBoundary
to compute circles. See the Sandbox. -
Changed the
EventHandler
constructor function to take the Geoscope canvas, which ensures the mouse position is correct regardless of the canvas' position on the page. Code that previously looked like:var handler = new Geoscope.EventHandler();
should now look like:
var handler = new Geoscope.EventHandler(canvas);
-
Context.Pick no longer requires clamping the x and y arguments. Code that previously looked like:
var pickedObject = context.pick(primitives, us, Math.max(x, 0.0), Math.max(context.getCanvas().clientHeight - y, 0.0));
can now look like:
var pickedObject = context.pick(primitives, us, x, context.getCanvas().clientHeight - y);
-
Changed Polyline.setWidth and Polyline.setOutlineWidth to clamp the width to the WebGL implementation limit instead of throwing an exception. Code that previously looked like:
var maxWidth = context.getMaximumAliasedLineWidth(); polyline.setWidth(Math.min(5, maxWidth)); polyline.setOutlineWidth(Math.min(10, maxWidth));
can now look like:
polyline.setWidth(5); polyline.setOutlineWidth(10);
-
Improved the Sandbox:
- Code in the editor is now evaluated as you type for quick prototyping.
- Highlighting a Geoscope type in the editor and clicking the doc button in the toolbar now brings up the reference help for that type.
-
BREAKING CHANGE: The
Context
constructor-function now takes an element instead of an ID. Code that previously looked like:var context = new Geoscope.Context("glCanvas"); var canvas = context.getCanvas();
should now look like:
var canvas = document.getElementById("glCanvas"); var context = new Geoscope.Context(canvas);
- Added new Sandbox and Skeleton examples. The sandbox contains example code for common tasks. The skeleton is a bare-bones application for building upon. Most sandbox code examples can be copy and pasted directly into the skeleton.
- Added
Geoscope.Polygon
for drawing polygons on the globe. - Added
Context.pick
to pick objects in one line of code. - Added
bringForward
,bringToFront
,sendBackward
, andsendToBack
functions toCompositePrimitive
to control the render-order for ground primitives. - Added
getShow
/setShow
functions toPolyline
andCompositePrimitive
. - Added new camera control and event types including
CameraFreeLookEventHandler
,CameraSpindleEventHandler
, andEventHandler
. - Replaced
Ellipsoid.toCartesian3
withEllipsoid.toCartesian
. - update and
updateForPick
functions no longer require aUniformState
argument.
- Added support for lines using
Geoscope.Polyline
. See the Sandbox example. - Made
CompositePrimitive
,LabelCollection
, andBillboardCollection
have consistent function names, including a newcontains()
function. - Improved reference documentation layout.
- Flushed out
CompositePrimitive
,TimeStandard
, andLeapSecond
types. - Improved support for browsers using ANGLE (Windows Only).
- Added
Geoscope.TimeStandard
for handling TAI and UTC time standards. - Added
Geoscope.Quaternion
, which is a foundation for future camera control. - Added initial version of
Geoscope.PrimitiveCollection
to simplify rendering. - Prevented billboards/labels near the surface from getting cut off by the globe.
- See the Sandbox for example code.
- Added more reference documentation for labels.
- Added
Geoscope.LabelCollection
for drawing text. - Added
Geoscope.JulianDate
andGeoscope.TimeConstants
for proper time handling. - See the Sandbox example for how to use the new labels and Julian date.
- Added
Geoscope.ViewportQuad
andGeoscope.Rectangle
(foundations for 2D map). - Improved the visual quality of cloud shadows.
- Added
SunPosition
type to compute the sun position for a julian date. - Simplified picking. See the mouse move event in the Sandbox example.
Cartographic2
andCartographic3
are now mutable types.- Added reference documentation for billboards.
- Initial Release.