@babylonjs/core 5.0.0-alpha.48 → 5.0.0-alpha.51

package/package.json

@@ -7,7 +7,7 @@
     ],
     "name": "@babylonjs/core",
     "description": "Babylon.js is a JavaScript 3D engine based on webgl.",
-    "version": "5.0.0-alpha.48",
+    "version": "5.0.0-alpha.51",
     "repository": {
         "type": "git",
         "url": "https://github.com/BabylonJS/Babylon.js.git"
@@ -1752,6 +1752,9 @@
         "Meshes/mesh.d.ts",
         "Meshes/mesh.js",
         "Meshes/mesh.js.map",
+        "Meshes/mesh.lts.d.ts",
+        "Meshes/mesh.lts.js",
+        "Meshes/mesh.lts.js.map",
         "Meshes/mesh.vertexData.d.ts",
         "Meshes/mesh.vertexData.js",
         "Meshes/mesh.vertexData.js.map",
@@ -1863,6 +1866,9 @@
         "Misc/fileTools.d.ts",
         "Misc/fileTools.js",
         "Misc/fileTools.js.map",
+        "Misc/fileTools.lts.d.ts",
+        "Misc/fileTools.lts.js",
+        "Misc/fileTools.lts.js.map",
         "Misc/gradients.d.ts",
         "Misc/gradients.js",
         "Misc/gradients.js.map",
@@ -2377,6 +2383,9 @@
         "scene.d.ts",
         "scene.js",
         "scene.js.map",
+        "scene.lts.d.ts",
+        "scene.lts.js",
+        "scene.lts.js.map",
         "sceneComponent.d.ts",
         "sceneComponent.js",
         "sceneComponent.js.map",

package/readme.md

@@ -26,14 +26,14 @@ npm install @babylonjs/core --save
 This will allow you to import BabylonJS entirely using:
 
 ```javascript
-import * as BABYLON from '@babylonjs/core/Legacy/legacy';
+import * as BABYLON from "@babylonjs/core/Legacy/legacy";
 ```
 
 or individual classes to benefit from enhanced tree shaking using :
 
 ```javascript
-import { Scene } from '@babylonjs/core/scene';
-import { Engine } from '@babylonjs/core/Engines/engine';
+import { Scene } from "@babylonjs/core/scene";
+import { Engine } from "@babylonjs/core/Engines/engine";
 ```
 
 To add a module, install the respective package. A list of extra packages and their installation instructions can be found on the [babylonjs user on npm](https://www.npmjs.com/~babylonjs) scoped on @babylonjs.
@@ -48,14 +48,12 @@ import { Scene } from "@babylonjs/core/scene";
 import { Vector3 } from "@babylonjs/core/Maths/math";
 import { FreeCamera } from "@babylonjs/core/Cameras/freeCamera";
 import { HemisphericLight } from "@babylonjs/core/Lights/hemisphericLight";
-import { Mesh } from "@babylonjs/core/Meshes/mesh";
 
 // Side-effects only imports allowing the standard material to be used as default.
 import "@babylonjs/core/Materials/standardMaterial";
-// Side-effects only imports allowing Mesh to create default shapes (to enhance tree shaking, the construction methods on mesh are not available if the meshbuilder has not been imported).
-import "@babylonjs/core/Meshes/Builders/sphereBuilder";
-import "@babylonjs/core/Meshes/Builders/boxBuilder";
-import "@babylonjs/core/Meshes/Builders/groundBuilder";
+// import the individual builders or use MeshBuilder to have them all
+import { CreateSphere } from "@babylonjs/core/Meshes/Builders/sphereBuilder";
+import { CreateGround } from "@babylonjs/core/Meshes/Builders/groundBuilder";
 
 const canvas = document.getElementById("renderCanvas") as HTMLCanvasElement;
 const engine = new Engine(canvas);
@@ -76,14 +74,14 @@ var light = new HemisphericLight("light1", new Vector3(0, 1, 0), scene);
 // Default intensity is 1. Let's dim the light a small amount
 light.intensity = 0.7;
 
-// Our built-in 'sphere' shape. Params: name, subdivs, size, scene
-var sphere = Mesh.CreateSphere("sphere1", 16, 2, scene);
+// Our built-in 'sphere' shape. Params: name, options, scene
+var sphere = CreateSphere("sphere1", { segments: 16, diameter: 2 }, scene);
 
 // Move the sphere upward 1/2 its height
 sphere.position.y = 2;
 
-// Our built-in 'ground' shape. Params: name, width, depth, subdivs, scene
-Mesh.CreateGround("ground1", 6, 6, 2, scene);
+// Our built-in 'ground' shape. Params: name, options, scene
+CreateGround("ground1", { width: 6, height: 6, subdivisions: 2 }, this._scene);
 
 engine.runRenderLoop(() => {
     scene.render();
@@ -101,6 +99,7 @@ If you want to contribute, please read our [contribution guidelines](https://git
 - [Examples](https://doc.babylonjs.com/examples)
 
 ## Contributing
+
 Please see the [Contributing Guidelines](./contributing.md)
 
 ## Useful links
@@ -112,7 +111,7 @@ Please see the [Contributing Guidelines](./contributing.md)
 - 3DS Max [exporter](https://github.com/BabylonJS/Exporters/tree/master/3ds%20Max) can be used to generate a .babylon file from 3DS Max
 - Maya [exporter](https://github.com/BabylonJS/Exporters/tree/master/Maya) can be used to generate a .babylon file from 3DS Max
 - Blender [exporter](https://github.com/BabylonJS/Exporters/tree/master/Blender) can be used to generate a .babylon file from Blender 3d
-- Unity 5[ (deprecated) exporter](https://github.com/BabylonJS/Exporters/tree/master/Unity) can be used to export your geometries from Unity 5 scene editor(animations are supported)
+- Unity 5[(deprecated) exporter](https://github.com/BabylonJS/Exporters/tree/master/Unity) can be used to export your geometries from Unity 5 scene editor(animations are supported)
 - [glTF Tools](https://github.com/KhronosGroup/glTF#gltf-tools) by KhronosGroup
 
 ## Features

package/scene.d.ts

@@ -510,6 +510,10 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
     onPointerUp: (evt: IPointerEvent, pickInfo: Nullable<PickingInfo>, type: PointerEventTypes) => void;
     /** Callback called when a pointer pick is detected */
     onPointerPick: (evt: IPointerEvent, pickInfo: PickingInfo) => void;
+    /**
+     * Gets or sets a predicate used to select candidate faces for a pointer move event
+     */
+    pointerMoveTrianglePredicate: ((p0: Vector3, p1: Vector3, p2: Vector3, ray: Ray) => boolean) | undefined;
     /**
      * This observable event is triggered when any ponter event is triggered. It is registered during Scene.attachControl() and it is called BEFORE the 3D engine process anything (mesh/sprite picking for instance).
      * You have the possibility to skip the process and the call to onPointerObservable by setting PointerInfoPre.skipOnPointerObservable to true
@@ -1428,13 +1432,6 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @param attachControl defines if attachControl must be called for the new active camera (default: true)
      */
     switchActiveCamera(newCamera: Camera, attachControl?: boolean): void;
-    /**
-     * sets the active camera of the scene using its Id
-     * @param id defines the camera's Id
-     * @return the new active camera or null if none found.
-     * @deprecated Please use setActiveCameraById instead
-     */
-    setActiveCameraByID(id: string): Nullable<Camera>;
     /**
      * sets the active camera of the scene using its Id
      * @param id defines the camera's Id
@@ -1459,26 +1456,12 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @return the material or null if none found.
      */
     getMaterialByUniqueID(uniqueId: number): Nullable<Material>;
-    /**
-     * get a material using its id
-     * @param id defines the material's Id
-     * @return the material or null if none found.
-     * @deprecated Please use getMaterialById instead
-     */
-    getMaterialByID(id: string): Nullable<Material>;
     /**
      * get a material using its id
      * @param id defines the material's Id
      * @return the material or null if none found.
      */
     getMaterialById(id: string): Nullable<Material>;
-    /**
-     * Gets a the last added material using a given id
-     * @param id defines the material's Id
-     * @return the last material with the given id or null if none found.
-     * @deprecated Please use getLastMaterialById instead
-     */
-    getLastMaterialByID(id: string): Nullable<Material>;
     /**
      * Gets a the last added material using a given id
      * @param id defines the material's Id
@@ -1491,39 +1474,18 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @return the material or null if none found.
      */
     getMaterialByName(name: string): Nullable<Material>;
-    /**
-     * Get a texture using its unique id
-     * @param uniqueId defines the texture's unique id
-     * @return the texture or null if none found.
-     * @deprecated Please use getTextureByUniqueId instead
-     */
-    getTextureByUniqueID(uniqueId: number): Nullable<BaseTexture>;
     /**
      * Get a texture using its unique id
      * @param uniqueId defines the texture's unique id
      * @return the texture or null if none found.
      */
     getTextureByUniqueId(uniqueId: number): Nullable<BaseTexture>;
-    /**
-     * Gets a camera using its Id
-     * @param id defines the Id to look for
-     * @returns the camera or null if not found
-     * @deprecated Please use getCameraById instead
-     */
-    getCameraByID(id: string): Nullable<Camera>;
     /**
      * Gets a camera using its Id
      * @param id defines the Id to look for
      * @returns the camera or null if not found
      */
     getCameraById(id: string): Nullable<Camera>;
-    /**
-     * Gets a camera using its unique Id
-     * @param uniqueId defines the unique Id to look for
-     * @returns the camera or null if not found
-     * @deprecated Please use getCameraByUniqueId instead
-     */
-    getCameraByUniqueID(uniqueId: number): Nullable<Camera>;
     /**
      * Gets a camera using its unique Id
      * @param uniqueId defines the unique Id to look for
@@ -1536,13 +1498,6 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @return the camera or null if none found.
      */
     getCameraByName(name: string): Nullable<Camera>;
-    /**
-     * Gets a bone using its Id
-     * @param id defines the bone's Id
-     * @return the bone or null if not found
-     * @deprecated Please use getBoneById instead
-     */
-    getBoneByID(id: string): Nullable<Bone>;
     /**
      * Gets a bone using its Id
      * @param id defines the bone's Id
@@ -1561,52 +1516,24 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @return the light or null if none found.
      */
     getLightByName(name: string): Nullable<Light>;
-    /**
-     * Gets a light node using its Id
-     * @param id defines the light's Id
-     * @return the light or null if none found.
-     * @deprecated Please use getLightById instead
-     */
-    getLightByID(id: string): Nullable<Light>;
     /**
      * Gets a light node using its Id
      * @param id defines the light's Id
      * @return the light or null if none found.
      */
     getLightById(id: string): Nullable<Light>;
-    /**
-     * Gets a light node using its scene-generated unique Id
-     * @param uniqueId defines the light's unique Id
-     * @return the light or null if none found.
-     * @deprecated Please use getLightByUniqueId instead
-     */
-    getLightByUniqueID(uniqueId: number): Nullable<Light>;
     /**
      * Gets a light node using its scene-generated unique Id
      * @param uniqueId defines the light's unique Id
      * @return the light or null if none found.
      */
     getLightByUniqueId(uniqueId: number): Nullable<Light>;
-    /**
-     * Gets a particle system by Id
-     * @param id defines the particle system Id
-     * @return the corresponding system or null if none found
-     * @deprecated Please use getParticleSystemById instead
-     */
-    getParticleSystemByID(id: string): Nullable<IParticleSystem>;
     /**
      * Gets a particle system by Id
      * @param id defines the particle system Id
      * @return the corresponding system or null if none found
      */
     getParticleSystemById(id: string): Nullable<IParticleSystem>;
-    /**
-     * Gets a geometry using its Id
-     * @param id defines the geometry's Id
-     * @return the geometry or null if none found.
-     * @deprecated Please use getGeometryById instead
-     */
-    getGeometryByID(id: string): Nullable<Geometry>;
     /**
      * Gets a geometry using its Id
      * @param id defines the geometry's Id
@@ -1632,117 +1559,54 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @returns an array of Geometry
      */
     getGeometries(): Geometry[];
-    /**
-     * Gets the first added mesh found of a given Id
-     * @param id defines the Id to search for
-     * @return the mesh found or null if not found at all
-     * @deprecated Please use getMeshById instead
-     */
-    getMeshByID(id: string): Nullable<AbstractMesh>;
     /**
      * Gets the first added mesh found of a given Id
      * @param id defines the Id to search for
      * @return the mesh found or null if not found at all
      */
     getMeshById(id: string): Nullable<AbstractMesh>;
-    /**
-     * Gets a list of meshes using their Id
-     * @param id defines the Id to search for
-     * @returns a list of meshes
-     * @deprecated Please use getMeshesById instead
-     */
-    getMeshesByID(id: string): Array<AbstractMesh>;
     /**
      * Gets a list of meshes using their Id
      * @param id defines the Id to search for
      * @returns a list of meshes
      */
     getMeshesById(id: string): Array<AbstractMesh>;
-    /**
-     * Gets the first added transform node found of a given Id
-     * @param id defines the Id to search for
-     * @return the found transform node or null if not found at all.
-     * @deprecated Please use getTransformNodeById instead
-     */
-    getTransformNodeByID(id: string): Nullable<TransformNode>;
     /**
      * Gets the first added transform node found of a given Id
      * @param id defines the Id to search for
      * @return the found transform node or null if not found at all.
      */
     getTransformNodeById(id: string): Nullable<TransformNode>;
-    /**
-     * Gets a transform node with its auto-generated unique Id
-     * @param uniqueId efines the unique Id to search for
-     * @return the found transform node or null if not found at all.
-     * @deprecated Please use getTransformNodeByUniqueId instead
-     */
-    getTransformNodeByUniqueID(uniqueId: number): Nullable<TransformNode>;
     /**
      * Gets a transform node with its auto-generated unique Id
      * @param uniqueId efines the unique Id to search for
      * @return the found transform node or null if not found at all.
      */
     getTransformNodeByUniqueId(uniqueId: number): Nullable<TransformNode>;
-    /**
-     * Gets a list of transform nodes using their Id
-     * @param id defines the Id to search for
-     * @returns a list of transform nodes
-     * @deprecated Please use getTransformNodesById instead
-     */
-    getTransformNodesByID(id: string): Array<TransformNode>;
     /**
      * Gets a list of transform nodes using their Id
      * @param id defines the Id to search for
      * @returns a list of transform nodes
      */
     getTransformNodesById(id: string): Array<TransformNode>;
-    /**
-     * Gets a mesh with its auto-generated unique Id
-     * @param uniqueId defines the unique Id to search for
-     * @return the found mesh or null if not found at all.
-     * @deprecated Please use getMeshByUniqueId instead
-     */
-    getMeshByUniqueID(uniqueId: number): Nullable<AbstractMesh>;
     /**
      * Gets a mesh with its auto-generated unique Id
      * @param uniqueId defines the unique Id to search for
      * @return the found mesh or null if not found at all.
      */
     getMeshByUniqueId(uniqueId: number): Nullable<AbstractMesh>;
-    /**
-     * Gets a the last added mesh using a given Id
-     * @param id defines the Id to search for
-     * @return the found mesh or null if not found at all.
-     * @deprecated Please use getLastMeshById instead
-     */
-    getLastMeshByID(id: string): Nullable<AbstractMesh>;
     /**
      * Gets a the last added mesh using a given Id
      * @param id defines the Id to search for
      * @return the found mesh or null if not found at all.
      */
     getLastMeshById(id: string): Nullable<AbstractMesh>;
-    /**
-     * Gets a the last added node (Mesh, Camera, Light) using a given Id
-     * @param id defines the Id to search for
-     * @return the found node or null if not found at all
-     * @deprecated Please use getLastEntryById instead
-     */
-    getLastEntryByID(id: string): Nullable<Node>;
     /**
      * Gets a the last added node (Mesh, Camera, Light) using a given Id
      * @param id defines the Id to search for
      * @return the found node or null if not found at all
      */
     getLastEntryById(id: string): Nullable<Node>;
-    /**
-     * Gets a node (Mesh, Camera, Light) using a given Id
-     * @param id defines the Id to search for
-     * @return the found node or null if not found at all
-     * @deprecated Please use getNodeById instead
-     */
-    getNodeByID(id: string): Nullable<Node>;
     /**
      * Gets a node (Mesh, Camera, Light) using a given Id
      * @param id defines the Id to search for
@@ -1767,13 +1631,6 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      * @return the found transform node or null if not found at all.
      */
     getTransformNodeByName(name: string): Nullable<TransformNode>;
-    /**
-     * Gets a skeleton using a given Id (if many are found, this function will pick the last one)
-     * @param id defines the Id to search for
-     * @return the found skeleton or null if not found at all.
-     * @deprecated Please use getLastSkeletonById instead
-     */
-    getLastSkeletonByID(id: string): Nullable<Skeleton>;
     /**
      * Gets a skeleton using a given Id (if many are found, this function will pick the last one)
      * @param id defines the Id to search for
@@ -2187,4 +2044,5 @@ export declare class Scene extends AbstractScene implements IAnimatable, IClipPl
      */
     onComputePressureChanged: Observable<IComputePressureData>;
 }
+import "./scene.lts";
 export {};