Version 18.2.0
Released on 16 Apr 2025
| Type |
Description |
|
Detect ground and background meshes via name and not via BackgroundMaterial assignment anymore |
|
Reworked exclusion geometry framework, resulting in renaming ExcludeGeometry(List) to NodeDescription and adapting corresponding input parameters and option typings (e.g. AutofocusSettings) |
|
Exclude dimension line meshes as shadow generators in updateShadows |
|
Exclude html anchor meshes from glb export via GltfExportManager |
|
Support updateGround for planes that have been created in XZ space |
|
Application of material on mesh that has just became visible |
Version 18.1.0
Released on 25 Feb 2025
| Type |
Description |
|
Add property cropTransparentArea in ScreenshotSettings to remove all bounding transparent pixels in the screenshot |
|
Set default value of ScreenshotSettings samples property to "8" for improved screenshot quality |
|
HTML anchor elements are now created right after viewer canvas and can therefore get overlayed by other sibling HTML elements (e.g. load masks) |
|
Html anchor position calculation on mobile devices |
|
Html anchor occlusion for screenshots |
|
Mesh filter list (exclude property) in createScreenshot (required updating to Babylon.js version v7.50.0) |
Version 18.0.0
Released on 17 Feb 2025
| Type |
Description |
|
Implement HtmlAnchorManager for mapping html elements like buttons or labels on 3d positions |
|
Implement DimensionLineManager for visualizing sizes and dimensions within the 3d scene |
|
Implement scene asset parser for setting up scene environments from imported .babylon files (see SceneManager) |
|
Added possibility to limit vertical camera panning limit (required updating to Babylon.js version v7.47.3) |
|
Remove texture when inserting empty string as texture image parameter value |
|
Performance improvement: Models are now loaded simultaneously via setModelVisibility |
|
Performance improvement: Parameter observers are now executed simultaneously (see ParameterManager) |
|
Moved calculateBoundingInfo into SceneManager |
|
Cloning of materials image processing configuration (required updating to Babylon.js version v7.44.0) |
Version 17.1.0
Released on 13 Jan 2025
| Type |
Description |
|
Implement BuiltInParameter for morph target influence value |
|
Added getter for tagged entities in asset container, e.g. AssetContainer.getMeshesByTags (required updating to Babylon.js version v7.43.0) |
|
Support Vector3 and Color3 classes in parameter system for associated parameters (e.g. "BuiltInParameter.Color", "BuiltInParameter.Rotation") |
|
Misleading warning when loading .babylon.gz files |
Version 17.0.0
Released on 11 Dec 2024
| Type |
Description |
|
Provide option to create an "instanced model" clone (ModelCloneOptions) |
|
Display tags in inspector (required updating to Babylon.js version v7.34.3) |
|
Set readable "display name" of texture for inspector, while keeping the original texture url (required updating to Babylon.js version v7.34.3) |
|
Don't create deep copies of internal metadata object when cloning nodes or materials |
|
Added support for displaying node-specific coordinate systems with showCoordinateSystem, including automatic scaling based on the scenes size. |
|
Ground meshes are now excluded by default in calculateBoundingInfo, affecting autofocusActiveCamera, createScreenshot, and showCoordinateSystem. |
|
Apply decal offset relative to each individual vertice |
|
Renamed showWorldCoordinates to showCoordinateSystem |
Version 16.0.0
Released on 13 Nov 2024
| Type |
Description |
|
Implement decals parser for .babylon file and wrapper for (mesh) decals creation in general. |
|
Avoid throwing exceptions if material asset could not be found in getOrCreateMaterial function |
Version 15.1.0
Released on 28 Oct 2024
| Type |
Description |
|
Implement material cloning functionality (see cloneMaterial) |
|
Return asset container of cloned model (see cloneModel ) |
|
Erroneous morph target manager ids from parsed model (fixed by updating to Babylon.js version v7.30.1) |
Version 15.0.0
Released on 07 Oct 2024
| Type |
Description |
|
Implement lots of built-in texture parameters (see BuiltInParameter.createTextureParameter) |
|
Screenshot excludes instanced meshes which were initially hidden (fixed by updating to Babylon.js version v7.15.2) |
|
Tag mapping algorithm for cloned models doesn't remove existing tags |
|
Material not applied if mesh gets activated via parent visibility |
Version 14.1.0
Released on 18 Sep 2024
| Type |
Description |
|
Enable all glTF extensions, allowing models to be loaded and exported with the complete glTF feature set in Babylon.js |
|
Improve gltf export times for meshes with node geometry |
|
Make nodeNamingStrategy and tagNamingStrategy optional in ModelCloneOptions |
|
AR error on Android devices when exported scene contains AnimationGroups |
|
Ensure that autofocusActiveCamera always reached target position in scenarios with heavy workload |
Version 14.0.0
Released on 15 Jul 2024
| Type |
Description |
|
Improve createScreenshot functionality:
- dedicated camera position for the screenshot
- exclude meshes from the screenshot
- define size of the final screenshot image independent of viewport size |
Version 13.0.1
Released on 05 Jul 2024
| Type |
Description |
|
Loading multiple models which contain morph target managers |
Version 13.0.0
Released on 25 Jun 2024
Version 12.4.4
Released on 07 Oct 2024
| Type |
Description |
|
Bounding box calculation for meshes with multiple morph targets (fixed by updating to Babylon.js version v6.35.0) |
Version 12.4.3
Released on 12 Sep 2024
| Type |
Description |
|
AR error on Android devices when exported scene contains AnimationGroups |
Version 12.4.1
Released on 23 Apr 2024
| Type |
Description |
|
Improved readability of texture names which are based on Combeenation image assets (e.g. shown in inspector) |
|
GLB export for scenes which include paintables |
Version 12.4.0
Released on 19 Mar 2024
| Type |
Description |
|
Add possibility to disable parallel shader compilition via Spec (see useParallelShaderCompile flag in SceneJson) |
|
Locked version of optional Babylon.js packages in order to fix development build errors in consuming code |
Version 12.3.0
Released on 04 Mar 2024
Version 12.2.1
Released on 09 Feb 2024
| Type |
Description |
|
Move viewer internal debug meshes into dedicated rendering utility scene |
Version 12.2.0
Released on 08 Feb 2024
| Type |
Description |
|
Add function Viewer.hideWorldCoordinates as counterpart for Viewer.showWorldCoordinates |
Version 12.1.2
Released on 31 Jan 2024
| Type |
Description |
|
Fix internal instanced mesh type checking in production builds |
Version 12.1.1
Released on 31 Jan 2024
| Type |
Description |
|
Reconstruct original tags assignment for instanced meshes on loading, instead of syncing source mesh tags state |
Version 12.1.0
Released on 29 Jan 2024
| Type |
Description |
|
Apply current skeleton influence for GLB export |
|
Import and cloning of models with instanced meshes |
Version 12.0.2
Released on 03 Jan 2024
| Type |
Description |
|
Improve apprearance of debug coordinate system from Viewer.showWorldCoordinates function |
Version 12.0.1
Released on 11 Dec 2023
| Type |
Description |
|
Adjust Babylon.js Inspector dependencies configuration to decrease build size in certain environments |
Version 12.0.0
Released on 05 Dec 2023
Version 11.1.0
Released on 27 Nov 2023
| Type |
Description |
|
Support usage of Node Geometry Editor in Babylon.js Inspector |
|
Fix negative scalings in Gltf export which leads to erroneous AR models on iOS devices |
Version 11.0.0
Released on 08 Nov 2023
| Type |
Description |
|
Update from Babylon.js v5.27.1 to v6.27.1, see new features of Babylon.js 6 |
Version 10.0.0
Released on 19 Oct 2023
Version 9.3.0
Released on 21 Sep 2023
| Type |
Description |
|
Support usage of baked skeletons |
|
Fix Event.TEXTURE_LOADING_END event not triggered if models with morph targets are loaded |
Version 9.2.0
Released on 12 Sep 2023
| Type |
Description |
|
Bake morph targets in glb export for AR so that they can be displayed on iOS devices |
|
Viewer scene breaks after GLB export for AR due to interaction with dummy export scene |
Version 9.1.1
Released on 02 Jun 2023
| Type |
Description |
|
Crashing glb export with paintables based on SVGs with embedded assets (eg: fonts) |
Version 9.1.0
Released on 23 May 2023
| Type |
Description |
|
Add option for limiting texture size in glb export (see IExportOptionsExtended.limitTextureSize) |
|
Handling of invalid SVG in paintable parameter |
|
Crashing glb export in iOS devices |
Version 9.0.1
Released on 05 May 2023
| Type |
Description |
|
Handling of paintable parser errors when used in Combeenation viewer control |
|
Avoid multiple material requests for the same material on different meshes |
Version 9.0.0
Released on 02 May 2023
| Type |
Description |
|
Add materials as subject for tag manager |
|
Add paintables as material parameter in tag manager |
|
Add material sub parameter Parameter.COLOR, Parameter.METALLIC and Parameter.ROUGHNESS in tag manager |
|
Remove support for legacy material sub parameter Parameter.MATERIAL_COLOR, Parameter.MATERIAL_METALLNESS and Parameter.MATERIAL_ROUGHNESS in tag manager |
|
Geometry filter for glb export ignored TransformNodes and adapted mesh names from AR optimization |
|
Tag manager race conditions which sometimes didn't apply parameter values correctly |
Version 8.0.0
Released on 19 Apr 2023
| Type |
Description |
|
Changed options for IExportOptionsExtended which is used in exportGlb, exportGltfToFile & exportGlbToFile:
Removed createUniqueMeshNames from IExportOptionsExtended which is now part of the new optimizeForAR parameter of the export functions & added exchangeRefractionMaterials to IExportOptionsExtended. |
|
The viewer now bakes transformations in gltf export functions when using the new optimizeForAR parameter to handle iOS negative scaling issue in augmented reality |
Version 7.1.3
Released on 12 Apr 2023
Version 7.1.2
Released on 30 Mar 2023
| Type |
Description |
|
Support providing viewer package as full distribution build (needed for Combeenation 3d viewer control) |
|
Exclude meshes with infinite distance (skybox) from Viewer.autofocusActiveCamera function |
|
New TagManager.getAllTags |
|
Viewer is printing some subtle info about all registered variant instances to the console when bootstrapping |
|
Viewer.autofocusActiveCamera & GLB export functions now also support TagManagerSubjects to be given with the exclude options |
|
When cloning variant instances, nodes of elements are renamed a bit different then before |
|
Handling of boolean tag parameter values when passed as strings |
|
Parameter values where sometimes re-applied when same value was given multiple times to the tag manager |
Version 7.1.1
Released on 15 Mar 2023
| Type |
Description |
|
Race conditions when applying tag manager parameter values while bootstrapping |
Version 7.1.0
Released on 06 Mar 2023
| Type |
Description |
|
createMaterialFromCbnAssets and getOrCreateMaterial functions became asynchronous, due to viewer usage in Combeenation asset environment |
Version 7.0.0
Released on 23 Feb 2023
| Type |
Description |
|
Introduce Tag Manager as new framework for altering node data |
|
Remove scene as parameter of setMaterial |
|
Change default value of SceneJsons cloneMaterialsOnMutation from true to false |
|
Viewer.bootstrap requires a set of initial tag and node parameter values |
|
Change naming algorithm for nodes of variant instances and clones |
|
Change default value of Viewer.autofocusActiveCamera radius factor back to 1.5 to get some padding when zooming on the model |
|
Unhandled exception in setMaterial function |
The new default value false of SceneJson.cloneMaterialsOnMutation might changes the behavior and look of your 3d model when working with material parameters. Test carefully when updating to this release.
The adapted node naming strategy will most likely break your application, if nodes are accessed directly via Babylon.js API (eg: scene.getMeshByName)
Version 6.5.0
Released on 23 Jan 2023
| Type |
Description |
|
Expose SpecStorage to public API to support manual re-booting of viewer |
|
Firing mesh enable observers too late so that material application looks weird in some cases |
|
Unhandled exception in material post load observer |
Version 6.4.0
Released on 19 Jan 2023
| Type |
Description |
|
Defer applying materials until material shader is compiled to avoid meshes from appearing transparent when setting materials the first time |
|
Replace dots (.) with slashes (/) when auto-generating the Spec to avoid special handling of dotted path variants |
|
Fix triggering material application if mesh visibility state is changed by parent node |
Version 6.3.0
Released on 09 Jan 2023
| Type |
Description |
|
Defer applying materials until all its textures are loaded to avoid meshes from appearing transparent during texture loading |
Version 6.2.1
Released on 03 Jan 2023
| Type |
Description |
|
Variant instances were not shown initially when visible parameter and lazy flag were both set to true |
|
Rework Viewer.autofocusActiveCamera function to avoid timing issues with deferred material loading |
Version 6.2.0
Released on 22 Dec 2022
| Type |
Description |
|
Add option for creating Spec automatically, using Viewer.generateSpec |
Version 6.1.0
Released on 3 Nov 2022
| Type |
Description |
|
Option for creating unique mesh names when exporting GLB/GLTF files via GltfExportManager, which is required for certain AR engines |
|
Events Event.TEXTURE_LOADING_START & Event.TEXTURE_LOADING_END which can be used e.g. to show a load load mask whenever a texture is loading in the background |
Version 6.0.0
Released on 14 Oct 2022
| Type |
Description |
|
Update build process, using webpack 5 (see Update Guide for more details) |
|
Update from Babylon.js v5.21.0 to v5.27.0 |
Version 5.1.3
Released on 5 Oct 2022
| Type |
Description |
|
Materials set via element parameter were sometimes not applied when there are multiple instances of the same variant |
Version 5.1.2
Released on 29 Sep 2022
| Type |
Description |
|
Material textures were erroneously eager loaded when element was hidden via value of named parameter |
Version 5.1.1
Released on 27 Sep 2022
| Type |
Description |
|
Support for babylon files & PbrMaterials loaded from Combeenation assets |
|
Update from Babylon.js v5.6.0 to v5.21.0 |
Version 5.0.3
Released on 8 Sep 2022
| Type |
Description |
|
Provide Photo Domes and further environment options in the Spec |
|
Exporting GLBs sometimes threw an unhandled exception |
Version 5.0.2
Released on 27 Jun 2022
| Type |
Description |
|
Provide Babylon.js Inspector from CDN to decrease bundle size |
Version 5.0.1
Released on 9 Jun 2022
| Type |
Description |
|
Basis for Augmented Reality (AR) due to newly introduced GLTF Export Manager |
|
Add option for excluding certain meshes from Viewer.autofocusActiveCamera |
|
Update to Babylon.js version 5 |
|
Multiple creation of lazy loaded variants |
|
Console warning about shortestWay flag in animation framework GSAP |
See details page for more in-depth descriptions.
Version 4.3.0
Released on 22 Mar 2022
See details page for more in-depth descriptions.
Version 4.2.0
Released on 21 Feb 2022
| Type |
Description |
|
Viewer.autofocusActiveCamera now automatically adjusts camera clipping plane so that very small models don't get clipped when zooming in |
|
Added alpha, beta and animation properties for AutofocusSettings |
Version 4.1.0
Released on 7 Feb 2022
| Type |
Description |
|
Parameter.SCALING parameter is now applied relative to initial mesh scaling and in world coordinates |
|
Viewer.moveActiveCameraTo doesn't work if animation definition is missing |
|
"shortestWay" flag in AnimationDefinition doesn't work if alpha value is 0 |
There are breaking changes concerning the interpretation of transformation parameters (Parameter.ROTATION, Parameter.SCALING) between V3.1.2 - V4.0.0 and also V4.0.0 - V4.1.0,
which will most likely change the way that your 3d model is shown in the viewer.
This was required for fixing certain transformation bugs and to ensure consistency throughout these parameters.
The updated transformation behaviour is described in the Transformation Parameters Docs.
Version 4.0.0
Released on 24 Jan 2022
| Type |
Description |
|
Parameter.ROTATION parameter is now applied relative to initial mesh rotation |
|
Introduced lights & shadow configuration in Spec |
|
Support font formats woff, ttf & otf for Paintables, beside the already supported format woff2 |
|
Added best practice example for changing custom material properties |
|
Include further material extensions in viewer by default:
KHR_texture_basisu, KHR_materials_clearcoat, KHR_materials_sheen, KHR_materials_ior, KHR_materials_pbrSpecularGlossiness, KHR_materials_specular, KHR_materials_translucency, KHR_materials_transmission, KHR_materials_unlit, KHR_materials_variants |
|
Camera avoids movements beyond 360° when moving to target position (see new flag shortestWay in AnimationDefinition) |
|
Evaluation of visible meshes in Viewer.autofocusActiveCamera function |
|
Blurry text paintables on transparent background |
|
Text paintables which could not be drawn on certain IOS devices |
Version 3.1.2
Released on 13 Jan 2022
Version 3.1.0
Released on 20 Oct 2021
| Type |
Description |
|
Fixed Element.getNode function, as it got broken with the latest performance improvements |
Version 3.0.0
Released on 7 Oct 2021
| Type |
Description |
|
Performance improvements for bootstrapping process which is especially effective for specs/3d models with a very high number of elements and meshes. E.g. bootstrapping time of an example 3d model with a total of ~ 2600 meshes has been reduced from 70 seconds to 3 - 4 seconds. |
Version 2.3.0
Released on 25 Aug 2021
| Type |
Description |
|
New Event.VARIANT_PARAMETER_BAG_COMMITTED |
|
Viewer.reset has been fixed as it threw an unhandled exception in earlier versions |
Version 2.2.0
Released on 18 Mai 2021
| Type |
Description |
|
Support for *.babylon files in addition to *.glb |
Version 2.1.2
Released on 12 Mai 2021
| Type |
Description |
|
Fix issue which sometimes lead to multiple variant instances being shown when using VariantInstanceManager.show with the exclusive flag |
Version 2.1.1
Released on 5 Mai 2021
| Type |
Description |
|
Export EventEmitter class from viewer |
Version 2.1.0
Released on 27 Apr 2021
| Type |
Description |
|
Basic support for GLBs with instanced meshes / linked duplicates |
|
New convenience functions Viewer.getNode, Viewer.getMesh, VariantInstance.getElement, VariantInstance.getNode, VariantInstance.getMesh, VariantInstance.commitParameter, VariantInstance.commitParameters, Variant.getNode, Variant.getMesh & Element.getMesh for easier access to nodes & meshes |
See details page for more in-depth descriptions.
Version 2.0.0
Released on 16 Mar 2021
| Type |
Description |
|
"Paintables" which allow graphics (like SVG) to be drawn on the 3d model |
|
Convenience function Viewer.autofocusActiveCamera which automatically sets some sensible defaults for the current camera position & camera control properties like panning sensitivity etc. |
|
Better documentation & simplified usage of events & parameters exposed by the Viewer |
|
Some functions have been changed from "sync" to "asnyc" behavior |
See details page for more in-depth descriptions.
Starting with this release, we'll be following SemVer more strictly. The main change is that we'll be incrementing the major version (e.g. 1.2.2 -> 2.0.0) every time a breaking change comes with the new version whereas until now we only incremented the minor version (e.g. 1.2.2 -> 1.3.0) on breaking changes and reserved major version bumps for releases with "big changes".
Version 1.2.2
Released on 12 Mar 2021
| Type |
Description |
|
Scene.clearColor is now set to transparent by default |
|
Better explanation for some important types in docs.
E.g. see properties of StructureJson. |
Version 1.2.1
Released on 2 Feb 2021
| Type |
Description |
|
Update to styles of release notes in docs |
Version 1.2.0
Released on 2 Feb 2021
This release brings many simplifications and contains significant breaking changes:
See details page for more in-depth descriptions.
Version 1.1.2
Released on 25 Nov 2020
This release brings some simplifications for the specification syntax and contains breaking changes.
See details page for more in-depth descriptions.