@cognite/[email protected]

This is a beta release of the next major version of Reveal. Reveal 2.0 comes with ThreeJS embedded so you do not have this as a dependency in your project. If you still want to have it as a direct dependency, it must match the version used by Reveal (r128). You can also use three.js version exported by Reveal as import { THREE } from '@cognite/reveal.

Migrating from 2.0.0-beta.0

There are some notable changes between beta.0 and this version:

• Cognite3DViewer.getIntersectionFromPixel() is now async
• Renamed a lot of classes in the styling API:
  • NodeSet -> NodeCollectionBase
  • ByNodePropertyNodeSet -> PropertyFilterNodeCollection
  • ByAssetNodeSet -> AssetNodeCollection
  • ByTreeIndexNodeSet -> TreeIndexNodeCollection
  • InvertedNodeSet -> InvertedNodeCollection
  • CombinedNodeSet -> replaced by UnionNodeCollection and IntersectionNodeCollection
• Renamed some functions in Cognite3DModel:
  • addStyledNodeSet -> assignStyledNodeCollection
  • removeStyledNodeSet -> unassignStyledNodeCollection
  • removeAllStyledNodeSets -> removeAllStyledNodeCollections
  • Note that assignStyledNodeCollection can be used to assign a new style, or change the styling of an existing "styled node collection"

🚀 Features

• feat: add SinglePropertyNodeCollection for matching on many property values on a single node property (experimental) (#1516)
• feat: Implement save / restore viewer state (#1523)
• feat: ByTreeIndexNodeSet - allow empty constructor (#1524)
• feat: add NodeSet.clear() (#1519)
• feat: add Cognite3DViewer.models to access currently added models (#1506)

🐞 Bug fixes and enhancements

• fix: Bug causing black fade for cad models when resizing screen (#1504)
• fix: remove @internal from Cognite3DViewerToolBase. This should fix an issue where HtmlOverlayTool could not be imported. (#1531)
• fix: add assert as a direct dependency to make sure it's available in client projects (#1544)
• improvement: replace pink and purple outline colors with green and red [REV-171] (#1541)
• improvement: Cognite3DModel.getSubtreeIndices() now returns a range (#1525)
• improvement: improve performance of applying styles by avoiding allocations of arrays (#1527)
• refac: make Cognite3DViewer.getIntersectionFromPixel async [REV-176] (#1540)
• refac: rename NodeSet to NodeCollection (#1539)
• chore: update potree-core, move sdk-core to peerDeps
• chore: replace gl-matrix with ThreeJS (#1513)
• chore: remove Cognite3DModel.loadingHints (#1526)
• chore: upgrade viewer/examples to TypeScript 4.3 (#1508)
• chore: remove sdk-core from dev deps (#1502)

📖 Documentation

• docs: fix example in cad-styling-custom.mdx (#1536)
• doc: update migration documentation to accommodate for migration from version 1 to 2 (#1505)

See installation documentation for details about installing Reveal.

@cognite/[email protected]

This is a beta release of the next major version of Reveal. Reveal 2.0 comes with ThreeJS embedded so you do not to have this as a dependency in your project. Note that if you are using ThreeJS directly, you will need to have it as a direct dependency in your project or import it using import { THREE } from '@cognite/reveal'. If you choose to have it as a direct dependency, it must match the version used by Reveal (0.128.0).

🚀 Features

• Add more performant and flexible API for styling nodes (#1371)
• Add an axis view tool (#1456)
• When a geometry filter is active, cull away (most) geometry outside the filter (#1424)

🐞 Bug fixes and enhancements

• Bump ThreeJS to r128 (#1494)
• Set ThreeJS to a static version and add as common dependency (#1472)
• Better handling of errors in web workers (#1473)
• Bug causing sectors to never load after a network failure [REV-152] (#1454)
• Replace non-standard array initialisation that fails on Safari (#1459)
• Force re-render after screenshot to avoid black screen [REV-153] (#1469)
• Certain MSAA quality settings causes black screen (#1484)
• Remove deprecated functionality [REV-165] (#1476)

See installation documentation for details about installing Reveal and migration documentation for information about migration from version 1 to 2.

@cognite/[email protected]

This version of Reveal requires ThreeJS r125.

• avoid viewer crash caused by wrong comlink dependency version

This version requires @cognite/[email protected] as the minimum version. If you use the following line somewhere in your application

revealEnv.publichPath = 'https://apps-cdn.cognitedata.com/@cognite/[email protected]/'

just delete it completely if it exactly the same. Otherwise, consult the docs regarding upgrading the parser-worker version on your own static server.

@cognite/[email protected]

This is a technical release that fixes issues with internal dependencies (comlink library).

This version of parser-worker will be a minimum required version for all further reveal releases starting from 1.5.5

1.5.4

This version of Reveal depends on ThreeJS r125. Your application should match
the version used to ensure compatibility.

🐞 Bug fixes and enhancements

• fix: apply update to near/far planes every frame to avoid clipping geometry when moving camera near object (#1466) – 16f299c
• chore: bump threejs to v125 (#1464) – e1c1ae1

See installation documentation for
details about installing Reveal.

1.5.3

🐞 Bug fixes and enhancements

• bug causing sectors to never load after a network failure [REV-152] (#1454) (#1458) – 0550f80

@cognite/[email protected]

🐞 Bug fixes and enhancements

• regression issue for loading geometry introduced in version 1.5.1

@cognite/[email protected]

🐞 Bug fixes and enhancements

• issue causing missing geometry when sectors was loaded from cache [REV-150] (#1439) – 3c4de37

@cognite/[email protected]

Reveal 1.5.0 brings a bunch of performance improvements to reduce geometry loaded for complex 3D models and increase rendering performance.

🚀 Features

• feat: allow providing geometryFilter in "model space" (#1416) – 35c4128
• feat: introduce DebugCameraTool for visualising the camera frustum for debugging (#1390) – 7540fa5

🐞 Bug fixes and enhancements

• improvement: iteratively load sectors and cull them towards already loaded geometry before loading (#1411) – 9ef5c28
• improvement: batch drawing of instanced meshes across sectors to reduce draw calls (#1412) – 1138867
• improvement: replace CTM LRU cache with slim most frequently used cache to save memory (#1407) – 14a3df4
• improvement: don't update treeIndex<>nodeId maps every time a sector is loaded to avoid allocation hot path (#1408) – c3dce9f
• improvement: clamp and smooth edges to reduce effect when far away from the model (#1404)
• improvement: add option to disable outline effect (#1404) – 5f63094
• improvement: use tighter bounding boxes/spheres for certain primitives to improve culling during rendering (#1402) – 62a09d0
• improvement: mark discarded sectors as hidden to avoid traversal (#1401) – 7c83965
• improvement: avoid calling updateMatrixWorld for entire scene graph each frame [REV-129] (#1399) – 645a763
• fix: bug causing sector bounds not to be placed correctly (#1403) – 4dc780a

📖 Documentation

• doc: fix broken HTML overlay example (#1410) – ecd9940
• doc: make overlay example slightly more interesting (#1394) – be41f95
• doc: document how to combine two models and align coordinate systems [REV-133] (#1406) – ffa18e1

@cognite/[email protected]

Version 1.4 adds improved visualization quality and tools for creating exploded views and HTML overlays.

🚀 Features

• add SSAO shading to render pipeline to give visualization shadows (#1372) – 9cafbe9
• add edge detection visualization to improve visual quality (#1359) – 0b79250
• add ExplodedViewTool for creating "exploded view" of equipment (#1381) – 99506a0
• add HtmlOverlayTool utility to manage HTML overlays in Cognite3dViewer (#1362) – d9e2b66
• add support for removing already loaded models (#1355) – 5f4c920

🐞 Bug fixes and enhancements

• simplify installation of parser-worker (#1369) – 4180550
  • you don't need to use revealEnv.publicPath anymore if apps-cdn.cognitedata.com is whitelisted in your CSP
• convert geometry filters to model/threejs space before applying them and remove them when model is removed (#1377) – 5583af1
• fix Z-fighting for low-detail geometry (#1374) – fd3f0cf
• Cognite3DModel.mapFromCdfToModelCoordinates and mapPositionFromModelToCdfCoordinates correctly returns transformed coordinates (#1361) – f1f27f6
• fix neverending rerendering of point cloud models (#1356) – 0cc1832
• print error message for parser-worker version mismatch (#1346) – f97a9d0
• avoid triggering identical loadingStateChanged events (#1345) – e17cb23
• fix broken rendering for certain primitives (#1363) – ff5a3de
• update camera position/target immediately when animation duration is zero (#1348) – d5a0c0b
• reduce garbage collection during mesh parsing (#1349) – a2563be
• update camera position/target immediatly when animation duration is zero (#1348) – d5a0c0b

📖 Documentation

• deprecate Cognite3DModel.deselectNode (#1347) – ae6c097