@dcl/hammurabi-server 1.0.0-17268386187.commit-b609629

package/dist/lib/babylon/scene/AssetManager.js

@@ -0,0 +1,271 @@
+"use strict";
+// the assetManager class enable scenes to pre-fetch assets and instance them in world
+// one of the main features of the assetManager is the ability to load assets in parallel
+// and reuse meshes, it is common in decentraland scenes that a single model is reused
+// many times inside the same scene. the associated cost of loading, parsing and generating
+// buffers for each model requies us to find a reusable solution
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instantiateAssetContainer = exports.AssetManager = void 0;
+const BABYLON = __importStar(require("@babylonjs/core"));
+const content_server_entity_1 = require("../../decentraland/scene/content-server-entity");
+const glTFFileLoader_1 = require("@babylonjs/loaders/glTF/glTFFileLoader");
+const colliders_1 = require("./logic/colliders");
+const mesh_collider_gen_1 = require("@dcl/protocol/out-js/decentraland/sdk/components/mesh_collider.gen");
+const sceneContextMap = new Map();
+class AssetManager {
+    get wearableEntity() {
+        if (this.loadableScene.entity.type !== 'wearable')
+            throw new Error('The entity of this AssetManager is not a wearable');
+        return this.loadableScene.entity;
+    }
+    constructor(loadableScene, babylonScene) {
+        this.loadableScene = loadableScene;
+        this.babylonScene = babylonScene;
+        this.models = new Map();
+    }
+    getContainerFuture(_src) {
+        const normalizedSrc = _src.toLowerCase();
+        let fileHash = (0, content_server_entity_1.resolveFile)(this.loadableScene.entity, normalizedSrc);
+        if (!fileHash) {
+            return Promise.reject(`‼️ The file ${normalizedSrc} is not present in the deployed entity.`);
+        }
+        if (!this.models.has(fileHash)) {
+            // store a WeakRef to the sceneContext to enable file resolver
+            sceneContextMap.set(this.loadableScene.urn, new WeakRef(this.loadableScene));
+            const extension = normalizedSrc.endsWith('.gltf') ? '.gltf' : '.glb';
+            // calculate the base path for the model
+            const base = normalizedSrc.split('/').slice(0, -1).join('/');
+            const ret = BABYLON.SceneLoader.LoadAssetContainerAsync(this.loadableScene.baseUrl, fileHash + '?sceneId=' + encodeURIComponent(this.loadableScene.urn) + '&base=' + encodeURIComponent(base), this.babylonScene, null, extension);
+            // once the assetContainer loads it needs to be processed before usage
+            ret.then(_ => processAssetContainer(_));
+            // store the promise in the map, it will be reused for the whole scene
+            this.models.set(fileHash, ret);
+        }
+        return this.models.get(fileHash);
+    }
+    async readFile(file) {
+        // this method resolves a file deployed with the entity. it returns the content of the file and its hash
+        const hash = (0, content_server_entity_1.resolveFile)(this.loadableScene.entity, file);
+        if (!hash)
+            throw new Error(`File not found: ${file}`);
+        const absoluteLocation = (0, content_server_entity_1.resolveFileAbsolute)(this.loadableScene, file);
+        if (!absoluteLocation)
+            throw new Error(`File not found: ${file}`);
+        const res = await fetch(absoluteLocation);
+        if (!res.ok)
+            throw new Error(`Error loading URL: ${absoluteLocation}`);
+        return { content: new Uint8Array(await res.arrayBuffer()), hash };
+    }
+    async loadTexture(file) {
+        return new Promise((resolve, reject) => {
+            const hash = (0, content_server_entity_1.resolveFile)(this.loadableScene.entity, file);
+            if (!hash)
+                throw new Error(`File not found: ${file}`);
+            const absoluteLocation = (0, content_server_entity_1.resolveFileAbsolute)(this.loadableScene, file);
+            if (!absoluteLocation)
+                throw new Error(`File not found: ${file}`);
+            const task = new BABYLON.TextureAssetTask(file, absoluteLocation, false, false);
+            task.onError = () => reject(task.errorObject);
+            task.onSuccess = () => {
+                resolve(task.texture);
+            };
+            task.run(this.babylonScene, () => resolve(task.texture), reject);
+        });
+    }
+    dispose() {
+        for (const [hash, model] of Array.from(this.models.entries())) {
+            model.then((container) => {
+                /// TODO: this line should not be commented, but there is a bug in Babylon.js that
+                /// breaks the shared glTF materials when disposing the assetContainer. We will sacrifice
+                /// GPU memory for now until the bug is fixed.
+                // container.dispose()
+            });
+            this.models.delete(hash);
+        }
+    }
+}
+exports.AssetManager = AssetManager;
+BABYLON.SceneLoader.OnPluginActivatedObservable.add(function (plugin) {
+    if (plugin instanceof glTFFileLoader_1.GLTFFileLoader) {
+        plugin.animationStartMode = glTFFileLoader_1.GLTFLoaderAnimationStartMode.NONE;
+        plugin.compileMaterials = true;
+        plugin.validate = false;
+        plugin.createInstances = true;
+        plugin.animationStartMode = 0;
+        plugin.preprocessUrlAsync = async function (url) {
+            // HERE BE DRAGONS 🐉:
+            //  To hack the GLTF loader to use Decentraland's file system, we must
+            //  access private properties to get the parent context to resolve individual
+            //  files.
+            //
+            //  This Hack prevents the engine from caching the entire GLB/GLTF because
+            //  query parameters are added to them. it is RECOMMENDED that the engine
+            //  caches all the files by their name (CIDv1)
+            const loader = plugin._loader;
+            const file = loader._fileName;
+            const [_gltfFilename, strParams] = file.split('?');
+            if (strParams) {
+                const params = new URLSearchParams(strParams);
+                const base = params.get('base') || '';
+                const sceneId = params.get('sceneId');
+                const ctx = sceneContextMap.get(sceneId)?.deref();
+                if (ctx) {
+                    const relative = url.replace(ctx.baseUrl, base ? base + '/' : '');
+                    const ret = (0, content_server_entity_1.resolveFileAbsolute)(ctx, relative);
+                    if (ret) {
+                        return ret;
+                    }
+                }
+            }
+            console.error('‼️ ‼️ ‼️ Cannot resolve file ' + url);
+            return '/images/UV_checker_Map_byValle.jpg';
+        };
+    }
+});
+function processAssetContainer(assetContainer) {
+    // by default, the models will be added to the scene at 0,0,0. We will remove that instance
+    assetContainer.removeAllFromScene();
+    // keep track of every generated mes and submesh
+    assetContainer.meshes.forEach((mesh) => {
+        if (mesh instanceof BABYLON.Mesh) {
+            if (mesh.geometry && !assetContainer.geometries.includes(mesh.geometry)) {
+                assetContainer.geometries.push(mesh.geometry);
+            }
+        }
+        if (mesh.subMeshes) {
+            mesh.subMeshes.forEach((subMesh) => {
+                // this fixes a bug with meshes not correctly disposed
+                subMesh.refreshBoundingInfo();
+                const mesh = subMesh.getMesh();
+                if (mesh instanceof BABYLON.Mesh) {
+                    if (mesh.geometry && !assetContainer.geometries.includes(mesh.geometry)) {
+                        assetContainer.geometries.push(mesh.geometry);
+                    }
+                }
+            });
+        }
+        // Find all the materials from all the meshes and add to $.materials
+        mesh.cullingStrategy = BABYLON.AbstractMesh.CULLINGSTRATEGY_BOUNDINGSPHERE_ONLY;
+        if (mesh.material) {
+            if (!assetContainer.materials.includes(mesh.material)) {
+                assetContainer.materials.push(mesh.material);
+            }
+        }
+        if (mesh.name.endsWith('_collider')) {
+            (0, colliders_1.setColliderMask)(mesh, mesh_collider_gen_1.ColliderLayer.CL_PHYSICS | mesh_collider_gen_1.ColliderLayer.CL_POINTER);
+        }
+        else {
+            (0, colliders_1.setColliderMask)(mesh, mesh_collider_gen_1.ColliderLayer.CL_NONE);
+        }
+    });
+    // Find the textures in the materials that share the same domain as the context
+    // then add the textures to the $.textures
+    assetContainer.materials.forEach((material) => {
+        // register all textures for the scene
+        for (let i in material) {
+            const t = material[i];
+            if (i.endsWith('Texture') && t instanceof BABYLON.Texture) {
+                if (!assetContainer.textures.includes(t)) {
+                    assetContainer.textures.push(t);
+                }
+            }
+        }
+        if (material instanceof BABYLON.PBRMaterial) {
+            // static materials for the moment
+            material.freeze();
+            // then replace the reflection probe of the materials when needed
+            material.reflectionTexture = assetContainer.scene.reflectionProbes?.find($ => $.name === 'skyReflection')?.cubeTexture || null;
+            if (material.alphaMode === 2) {
+                if (material.albedoTexture) {
+                    material.albedoTexture.hasAlpha = true;
+                    material.useAlphaFromAlbedoTexture = true;
+                }
+            }
+        }
+        material.freeze();
+    });
+}
+const tmpVector = new BABYLON.Vector3();
+function instantiateAssetContainer(assetContainer, parentNode, entity) {
+    const instances = assetContainer.instantiateModelsToScene(name => name, true);
+    for (let node of instances.rootNodes) {
+        // reparent the root node inside the entity
+        node.parent = parentNode;
+        node.getChildMeshes(false).forEach(mesh => {
+            // this override makes all meshes not renderable if the rootNode is not enabled.
+            // it cascades the effect of the culling of the rootNode down to each mesh to lighten the CPU work
+            // of calculating every bounding box
+            Object.defineProperty(mesh, 'isBlocked', {
+                enumerable: true,
+                configurable: true,
+                get() {
+                    return !entity.context.deref()?.rootNode.isEnabled || (mesh._masterMesh !== null && mesh._masterMesh !== undefined);
+                },
+            });
+            const originalF = mesh.isInFrustum;
+            /**
+             * Returns `true` if the mesh is within the frustum defined by the passed array of planes.
+             * A mesh is in the frustum if its bounding box intersects the frustum
+             * @param frustumPlanes defines the frustum to test
+             * @returns true if the mesh is in the frustum planes
+             *
+             * In this case, we are monkey patching the isInFrustum method to cull out meshes that are too far away
+             * or are too small based on the distance to the camera.
+             */
+            mesh.isInFrustum = function (frustumPlanes) {
+                if (!entity.context.deref()?.rootNode.isEnabled)
+                    return false;
+                if (this.absolutePosition) {
+                    const distanceToObject = tmpVector.copyFrom(this.absolutePosition).subtract(this.getScene().activeCamera.position).length();
+                    // cull out elements farther than 300meters
+                    if (distanceToObject > 300)
+                        return false;
+                    if (this._boundingInfo) {
+                        if (this._boundingInfo.diagonalLength < 0.50 && distanceToObject > 30)
+                            return false;
+                        // cull elements smaller than 20cm at 40meters
+                        if (this._boundingInfo.diagonalLength < 0.20 && distanceToObject > 20)
+                            return false;
+                        // cull elements smaller than 10cm at 10meters
+                        if (this._boundingInfo.diagonalLength < 0.10 && distanceToObject > 10)
+                            return false;
+                    }
+                }
+                return originalF.call(this, frustumPlanes);
+            };
+        });
+    }
+    // by default animations will be configured with weight 0
+    for (let animationGroup of instances.animationGroups) {
+        animationGroup.stop();
+        for (let animatable of animationGroup.animatables) {
+            animatable.weight = 0;
+        }
+    }
+    return instances;
+}
+exports.instantiateAssetContainer = instantiateAssetContainer;
+//# sourceMappingURL=AssetManager.js.map

package/dist/lib/babylon/scene/AssetManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetManager.js","sourceRoot":"","sources":["../../../../src/lib/babylon/scene/AssetManager.ts"],"names":[],"mappings":";AAAA,sFAAsF;AACtF,yFAAyF;AACzF,sFAAsF;AACtF,2FAA2F;AAC3F,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;AAEhE,yDAA0C;AAC1C,0FAA6I;AAC7I,2EAAqG;AAErG,iDAAmD;AACnD,0GAAkG;AAGlG,MAAM,eAAe,GAAG,IAAI,GAAG,EAA8C,CAAA;AAE7E,MAAa,YAAY;IAGvB,IAAI,cAAc;QAChB,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACvH,OAAO,IAAI,CAAC,aAAa,CAAC,MAAqC,CAAA;IACjE,CAAC;IAED,YAAmB,aAA4B,EAAS,YAA2B;QAAhE,kBAAa,GAAb,aAAa,CAAe;QAAS,iBAAY,GAAZ,YAAY,CAAe;QAPnF,WAAM,GAAG,IAAI,GAAG,EAA2C,CAAA;IAO4B,CAAC;IAExF,kBAAkB,CAAC,IAAY;QAC7B,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QACxC,IAAI,QAAQ,GAAG,IAAA,mCAAW,EAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;QAEpE,IAAI,CAAC,QAAQ,EAAE;YACb,OAAO,OAAO,CAAC,MAAM,CAAC,eAAe,aAAa,yCAAyC,CAAC,CAAA;SAC7F;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;YAC9B,8DAA8D;YAC9D,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAA;YAE5E,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;YAEpE,wCAAwC;YACxC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAE5D,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,CACrD,IAAI,CAAC,aAAa,CAAC,OAAO,EAC1B,QAAQ,GAAG,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,EACzG,IAAI,CAAC,YAAY,EACjB,IAAI,EACJ,SAAS,CACV,CAAA;YAED,sEAAsE;YACtE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAA;YAEvC,sEAAsE;YACtE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;SAC/B;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,wGAAwG;QACxG,MAAM,IAAI,GAAG,IAAA,mCAAW,EAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QACzD,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAA;QAErD,MAAM,gBAAgB,GAAG,IAAA,2CAAmB,EAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAA;QACtE,IAAI,CAAC,gBAAgB;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAA;QACjE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAA;QAEzC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,gBAAgB,EAAE,CAAC,CAAA;QAEtE,OAAO,EAAE,OAAO,EAAE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,CAAA;IACnE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,OAAO,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtD,MAAM,IAAI,GAAG,IAAA,mCAAW,EAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YACzD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAA;YAErD,MAAM,gBAAgB,GAAG,IAAA,2CAAmB,EAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAA;YACtE,IAAI,CAAC,gBAAgB;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAA;YAEjE,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;YAC/E,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YAC7C,IAAI,CAAC,SAAS,GAAG,GAAG,EAAE;gBACpB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACvB,CAAC,CAAA;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;QAClE,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE;YAC7D,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;gBACvB,kFAAkF;gBAClF,yFAAyF;gBACzF,8CAA8C;gBAC9C,sBAAsB;YACxB,CAAC,CAAC,CAAA;YACF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;SACzB;IACH,CAAC;CACF;AAvFD,oCAuFC;AAED,OAAO,CAAC,WAAW,CAAC,2BAA2B,CAAC,GAAG,CAAC,UAAU,MAAM;IAClE,IAAI,MAAM,YAAY,+BAAc,EAAE;QACpC,MAAM,CAAC,kBAAkB,GAAG,6CAA4B,CAAC,IAAI,CAAA;QAC7D,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAA;QAC9B,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAA;QACvB,MAAM,CAAC,eAAe,GAAG,IAAI,CAAA;QAC7B,MAAM,CAAC,kBAAkB,GAAG,CAAC,CAAA;QAC7B,MAAM,CAAC,kBAAkB,GAAG,KAAK,WAAW,GAAW;YACrD,sBAAsB;YACtB,sEAAsE;YACtE,6EAA6E;YAC7E,UAAU;YACV,EAAE;YACF,0EAA0E;YAC1E,yEAAyE;YACzE,8CAA8C;YAC9C,MAAM,MAAM,GAAgB,MAAc,CAAC,OAAO,CAAA;YAClD,MAAM,IAAI,GAAY,MAAc,CAAC,SAAS,CAAA;YAC9C,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClD,IAAI,SAAS,EAAE;gBACb,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAA;gBAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;gBACrC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAE,CAAA;gBACtC,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;gBACjD,IAAI,GAAG,EAAE;oBACP,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;oBAEjE,MAAM,GAAG,GAAG,IAAA,2CAAmB,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;oBAE9C,IAAI,GAAG,EAAE;wBACP,OAAO,GAAI,CAAA;qBACZ;iBACF;aACF;YACD,OAAO,CAAC,KAAK,CAAC,+BAA+B,GAAG,GAAG,CAAC,CAAA;YACpD,OAAO,oCAAoC,CAAA;QAC7C,CAAC,CAAA;KACF;AACH,CAAC,CAAC,CAAA;AAEF,SAAS,qBAAqB,CAAC,cAAsC;IACnE,2FAA2F;IAC3F,cAAc,CAAC,kBAAkB,EAAE,CAAA;IAEnC,gDAAgD;IAChD,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,IAAI,IAAI,YAAY,OAAO,CAAC,IAAI,EAAE;YAChC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBACvE,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;aAC9C;SACF;QAED,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBACjC,sDAAsD;gBACtD,OAAO,CAAC,mBAAmB,EAAE,CAAA;gBAE7B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;gBAC9B,IAAI,IAAI,YAAY,OAAO,CAAC,IAAI,EAAE;oBAChC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;wBACvE,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;qBAC9C;iBACF;YACH,CAAC,CAAC,CAAA;SACH;QAED,oEAAoE;QACpE,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,mCAAmC,CAAA;QAE/E,IAAI,IAAI,CAAC,QAAQ,EAAE;YACjB,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBACrD,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;aAC7C;SACF;QAED,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;YACnC,IAAA,2BAAe,EAAC,IAAI,EAAE,iCAAa,CAAC,UAAU,GAAG,iCAAa,CAAC,UAAU,CAAC,CAAA;SAC3E;aAAM;YACL,IAAA,2BAAe,EAAC,IAAI,EAAE,iCAAa,CAAC,OAAO,CAAC,CAAA;SAC7C;IACH,CAAC,CAAC,CAAA;IAEF,+EAA+E;IAC/E,0CAA0C;IAC1C,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAgD,EAAE,EAAE;QACpF,sCAAsC;QACtC,KAAK,IAAI,CAAC,IAAI,QAAQ,EAAE;YACtB,MAAM,CAAC,GAAI,QAAgB,CAAC,CAAC,CAAC,CAAA;YAE9B,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,OAAO,EAAE;gBACzD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;oBACxC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;iBAChC;aACF;SACF;QAED,IAAI,QAAQ,YAAY,OAAO,CAAC,WAAW,EAAE;YAC3C,kCAAkC;YAClC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAElB,iEAAiE;YACjE,QAAQ,CAAC,iBAAiB,GAAG,cAAc,CAAC,KAAK,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,EAAE,WAAW,IAAI,IAAI,CAAA;YAE9H,IAAI,QAAQ,CAAC,SAAS,KAAK,CAAC,EAAE;gBAC5B,IAAI,QAAQ,CAAC,aAAa,EAAE;oBAC1B,QAAQ,CAAC,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAA;oBACtC,QAAQ,CAAC,yBAAyB,GAAG,IAAI,CAAA;iBAC1C;aACF;SACF;QAED,QAAQ,CAAC,MAAM,EAAE,CAAA;IACnB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;AAEvC,SAAgB,yBAAyB,CAAC,cAAsC,EAAE,UAAiC,EAAE,MAAqB;IACxI,MAAM,SAAS,GAAG,cAAc,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAE7E,KAAK,IAAI,IAAI,IAAI,SAAS,CAAC,SAAS,EAAE;QACpC,2CAA2C;QAC3C,IAAI,CAAC,MAAM,GAAG,UAAU,CAAA;QAExB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACxC,gFAAgF;YAChF,kGAAkG;YAClG,oCAAoC;YACpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE;gBACvC,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;gBAClB,GAAG;oBACD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAA;gBACrH,CAAC;aACF,CAAC,CAAA;YAEF,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAA;YAElC;;;;;;;;eAQG;YACH,IAAI,CAAC,WAAW,GAAG,UAAsC,aAA8B;gBACrF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC,SAAS;oBAAE,OAAO,KAAK,CAAA;gBAE7D,IAAI,IAAI,CAAC,gBAAgB,EAAE;oBACzB,MAAM,gBAAgB,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,YAAa,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAA;oBAE5H,2CAA2C;oBAC3C,IAAI,gBAAgB,GAAG,GAAG;wBACxB,OAAO,KAAK,CAAA;oBAEd,IAAI,IAAI,CAAC,aAAa,EAAE;wBACtB,IAAI,IAAI,CAAC,aAAa,CAAC,cAAc,GAAG,IAAI,IAAI,gBAAgB,GAAG,EAAE;4BACnE,OAAO,KAAK,CAAA;wBACd,8CAA8C;wBAC9C,IAAI,IAAI,CAAC,aAAa,CAAC,cAAc,GAAG,IAAI,IAAI,gBAAgB,GAAG,EAAE;4BACnE,OAAO,KAAK,CAAA;wBACd,8CAA8C;wBAC9C,IAAI,IAAI,CAAC,aAAa,CAAC,cAAc,GAAG,IAAI,IAAI,gBAAgB,GAAG,EAAE;4BACnE,OAAO,KAAK,CAAA;qBACf;iBACF;gBAED,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;YAC5C,CAAC,CAAA;QACH,CAAC,CAAC,CAAA;KACH;IAED,yDAAyD;IACzD,KAAK,IAAI,cAAc,IAAI,SAAS,CAAC,eAAe,EAAE;QACpD,cAAc,CAAC,IAAI,EAAE,CAAA;QACrB,KAAK,IAAI,UAAU,IAAI,cAAc,CAAC,WAAW,EAAE;YACjD,UAAU,CAAC,MAAM,GAAG,CAAC,CAAA;SACtB;KACF;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAlED,8DAkEC"}

package/dist/lib/babylon/scene/BabylonEntity.d.ts

@@ -0,0 +1,84 @@
+import * as BABYLON from '@babylonjs/core';
+import { SceneContext } from './scene-context';
+import { Transform } from '../../decentraland/sdk-components/transform-component';
+import { ComponentDefinition } from '../../decentraland/crdt-internal/components';
+import { Entity } from '../../decentraland/types';
+import { PBBillboard } from '@dcl/protocol/out-js/decentraland/sdk/components/billboard.gen';
+import { PBRaycast } from '@dcl/protocol/out-js/decentraland/sdk/components/raycast.gen';
+import { PBMeshCollider } from '@dcl/protocol/out-js/decentraland/sdk/components/mesh_collider.gen';
+import { PBGltfContainer } from '@dcl/protocol/out-js/decentraland/sdk/components/gltf_container.gen';
+import { PBPointerEvents } from '@dcl/protocol/out-js/decentraland/sdk/components/pointer_events.gen';
+import { PBMeshRenderer } from '@dcl/protocol/out-js/decentraland/sdk/components/mesh_renderer.gen';
+import { AvatarRenderer } from '../avatars/AvatarRenderer';
+import { PBDelayedInterpolation } from '@dcl/protocol/out-js/decentraland/sdk/components/delayed_interpolation.gen';
+import { PBTween } from '@dcl/protocol/out-js/decentraland/sdk/components/tween.gen';
+import { PBMaterial } from '@dcl/protocol/out-js/decentraland/sdk/components/material.gen';
+import { PBAvatarBase } from '@dcl/protocol/out-js/decentraland/sdk/components/avatar_base.gen';
+export type TransformCommand = {
+    value: Transform;
+    time: number;
+};
+export type AppliedComponents = {
+    transform: {
+        commands: Array<TransformCommand>;
+        parent: Entity;
+    };
+    billboard: PBBillboard;
+    raycast: {
+        value: PBRaycast;
+        helper?: BABYLON.RayHelper;
+        ray: BABYLON.Ray;
+    };
+    meshCollider: {
+        info: PBMeshCollider;
+        collider: BABYLON.AbstractMesh | null;
+    };
+    meshRenderer: {
+        info: PBMeshRenderer;
+        mesh: BABYLON.AbstractMesh | null;
+    };
+    gltfContainer: {
+        value: PBGltfContainer;
+        gltfContainer: BABYLON.AbstractMesh | null;
+        instancedEntries: BABYLON.InstantiatedEntries | null;
+    };
+    pointerEvents: PBPointerEvents;
+    avatarRenderer: AvatarRenderer;
+    avatarBase: PBAvatarBase;
+    delayedInterpolation: PBDelayedInterpolation;
+    tween: PBTween;
+    material: {
+        value: PBMaterial;
+        material: BABYLON.Material;
+    };
+};
+export declare const baseMaterial: (a: BABYLON.Scene) => BABYLON.StandardMaterial;
+/**
+ * This class wraps a BabylonEntity and extends it with all the component-related
+ * logic for the Decentraland ECS semantics.
+ */
+export declare class BabylonEntity extends BABYLON.TransformNode {
+    entityId: Entity;
+    context: WeakRef<SceneContext>;
+    readonly isDCLEntity = true;
+    usedComponents: Map<number, ComponentDefinition<unknown>>;
+    appliedComponents: Partial<AppliedComponents>;
+    constructor(entityId: Entity, context: WeakRef<SceneContext>);
+    putComponent(component: ComponentDefinition<unknown>): void;
+    deleteComponent(component: ComponentDefinition<unknown>): void;
+    _setTransformParametersBeforeMatrixCalculation(): void;
+    computeWorldMatrix(force: boolean | undefined, camera?: BABYLON.Nullable<BABYLON.Camera>): BABYLON.Matrix;
+    _afterComputeWorldMatrix(): void;
+    _isSynchronized(): boolean;
+    /**
+     * Returns the parentEntity set by the Transform Component.
+     * Defaults to ROOT_ENTITY(0)
+     */
+    get expectedParentEntityId(): number;
+    /**
+     * Returns the children that extends EcsEntity, filtering any other Object3D
+     */
+    childrenEntities(): Iterable<BabylonEntity>;
+    dispose(_doNotRecurse?: boolean | undefined, _disposeMaterialAndTextures?: boolean | undefined): void;
+}
+//# sourceMappingURL=BabylonEntity.d.ts.map

package/dist/lib/babylon/scene/BabylonEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BabylonEntity.d.ts","sourceRoot":"","sources":["../../../../src/lib/babylon/scene/BabylonEntity.ts"],"names":[],"mappings":"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"}

package/dist/lib/babylon/scene/BabylonEntity.js

@@ -0,0 +1,174 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BabylonEntity = exports.baseMaterial = void 0;
+const BABYLON = __importStar(require("@babylonjs/core"));
+const core_1 = require("@babylonjs/core");
+const billboard_gen_1 = require("@dcl/protocol/out-js/decentraland/sdk/components/billboard.gen");
+const billboards_1 = require("./logic/billboards");
+const static_entities_1 = require("./logic/static-entities");
+const delayed_interpolation_1 = require("./logic/delayed-interpolation");
+const memoize_1 = require("../../misc/memoize");
+exports.baseMaterial = (0, memoize_1.memoize)((scene) => {
+    const material = new BABYLON.StandardMaterial('base-box', scene);
+    material.diffuseTexture = new BABYLON.Texture('images/UV_checker_Map_byValle.jpg');
+    return material;
+});
+/**
+ * This class wraps a BabylonEntity and extends it with all the component-related
+ * logic for the Decentraland ECS semantics.
+ */
+class BabylonEntity extends BABYLON.TransformNode {
+    constructor(entityId, context) {
+        super(`ecs-${entityId.toString(16)}`);
+        this.entityId = entityId;
+        this.context = context;
+        this.isDCLEntity = true;
+        this.usedComponents = new Map();
+        this.appliedComponents = {};
+    }
+    putComponent(component) {
+        component.declaration.applyChanges(this, component);
+        this.usedComponents.set(component.componentId, component);
+    }
+    deleteComponent(component) {
+        component.declaration.applyChanges(this, component);
+        this.usedComponents.delete(component.componentId);
+    }
+    // this function chooses which value is going to be used to calculate the world
+    // transform of this entity. the order of precedence is:
+    // 1. if there are no user defined Transform, use an identity transform
+    // 2. if the PBDelayedInterpolation component is present, interpolate a value using the time-traveling commands
+    // 3. if the PBTween component is present, interpolate a value using the tweening commands
+    // 4. if the PBTransform component is present, use the latest value (command)
+    _setTransformParametersBeforeMatrixCalculation() {
+        if (!this.rotationQuaternion)
+            this.rotationQuaternion = core_1.Quaternion.Identity();
+        // perform interpolation if needed
+        const commands = this.appliedComponents.transform?.commands;
+        if (!commands || commands.length === 0) {
+            this.position.setAll(0);
+            this.scaling.setAll(1);
+            this.rotationQuaternion.set(0, 0, 0, 1);
+            return;
+        }
+        if (this.appliedComponents.delayedInterpolation) {
+            (0, delayed_interpolation_1.applyDelayedInterpolation)(this, this.appliedComponents.delayedInterpolation, commands, performance.now());
+        }
+        else /* if(BPTween) {
+          applyTween(this, this.appliedComponents.tween!, commands, performance.now())
+        } else */ {
+            const latestCommand = commands[commands.length - 1];
+            this.position.set(latestCommand.value.position.x, latestCommand.value.position.y, latestCommand.value.position.z);
+            this.scaling.set(latestCommand.value.scale.x, latestCommand.value.scale.y, latestCommand.value.scale.z);
+            this.rotationQuaternion.set(latestCommand.value.rotation.x, latestCommand.value.rotation.y, latestCommand.value.rotation.z, latestCommand.value.rotation.w);
+        }
+    }
+    computeWorldMatrix(force, camera) {
+        if (this.entityId === static_entities_1.StaticEntities.RootEntity) {
+            return super.computeWorldMatrix(force, camera);
+        }
+        this._setTransformParametersBeforeMatrixCalculation();
+        return super.computeWorldMatrix(force, camera);
+    }
+    // This function is called after Babylon calculates the world matrix of the entity
+    // we hook into this lifecycle event to mutate the final _worldMatrix before it is
+    // settled
+    _afterComputeWorldMatrix() {
+        const camera = this.getScene().activeCamera;
+        if (this.appliedComponents.billboard && camera) {
+            const billboardMode = this.appliedComponents.billboard.billboardMode ?? billboard_gen_1.BillboardMode.BM_ALL;
+            // save translation and scaling components of the world matrix calculated by Babylon
+            const position = core_1.Vector3.Zero();
+            const scale = core_1.Vector3.One();
+            this._worldMatrix.decompose(scale, undefined, position);
+            // compute the global position of the world matrix
+            const entityGlobalPosition = core_1.Vector3.TransformCoordinates(core_1.Vector3.Zero(), this._worldMatrix);
+            // get the direction vector from the camera to the entity position
+            const directionVector = camera.globalPosition.subtract(entityGlobalPosition);
+            // calculate the LookAt matrix from the direction vector towards zero
+            const rotMatrix = core_1.Matrix.LookAtLH(directionVector, core_1.Vector3.Zero(), camera.upVector).invert();
+            const rotation = core_1.Quaternion.FromRotationMatrix(rotMatrix);
+            if ((0, billboards_1.isValidBillboardCombination)(billboardMode)) {
+                const eulerAngles = rotation.toEulerAngles();
+                if (!(billboardMode & billboard_gen_1.BillboardMode.BM_X)) {
+                    eulerAngles.x = 0;
+                }
+                if (!(billboardMode & billboard_gen_1.BillboardMode.BM_Y)) {
+                    eulerAngles.y = 0;
+                }
+                if (!(billboardMode & billboard_gen_1.BillboardMode.BM_Z)) {
+                    eulerAngles.z = 0;
+                }
+                core_1.Matrix.RotationYawPitchRollToRef(eulerAngles.y, eulerAngles.x, eulerAngles.z, rotMatrix);
+            }
+            // restore the scale to a blank scaling matrix
+            const scalingMatrix = core_1.Matrix.Scaling(scale.x, scale.y, scale.z);
+            // apply the scale to the rotation matrix, into _worldMatrix
+            scalingMatrix.multiplyToRef(rotMatrix, this._worldMatrix);
+            // finally restore the translation into _worldMatrix
+            this._worldMatrix.setTranslation(position);
+        }
+        return super._afterComputeWorldMatrix();
+    }
+    // this function should return false if the world matrix needs to be recalculated
+    // it is called internally by Babylon.js internal code
+    _isSynchronized() {
+        const hasBillboard = !!this.appliedComponents.billboard;
+        return !hasBillboard && super._isSynchronized();
+    }
+    /**
+     * Returns the parentEntity set by the Transform Component.
+     * Defaults to ROOT_ENTITY(0)
+     */
+    get expectedParentEntityId() {
+        return this.appliedComponents.transform?.parent ?? static_entities_1.StaticEntities.RootEntity;
+    }
+    /**
+     * Returns the children that extends EcsEntity, filtering any other Object3D
+     */
+    *childrenEntities() {
+        if (this._children)
+            for (let i = 0; i < this._children.length; i++) {
+                const element = this._children[i];
+                if (element.isDCLEntity) {
+                    yield element;
+                }
+            }
+    }
+    dispose(_doNotRecurse, _disposeMaterialAndTextures) {
+        // first dispose all components
+        for (const [_, component] of this.usedComponents) {
+            // mark the component as deleted in the component
+            component.entityDeleted(this.entityId, false);
+            // then perform the final deletion
+            this.deleteComponent(component);
+        }
+        // and then proceed with the native engine disposal
+        super.dispose(true, false);
+    }
+}
+exports.BabylonEntity = BabylonEntity;
+//# sourceMappingURL=BabylonEntity.js.map

package/dist/lib/babylon/scene/BabylonEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BabylonEntity.js","sourceRoot":"","sources":["../../../../src/lib/babylon/scene/BabylonEntity.ts"],"names":[],"mappings":"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"}

package/dist/lib/babylon/scene/connect-context-rpc.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This function will register the EngineApi and EnvironmentApi services
+ * to the RPC server, so that the scene can call them.
+ */
+import { RpcServerPort } from "@dcl/rpc";
+import { SceneContext } from "./scene-context";
+export declare function connectContextToRpcServer(port: RpcServerPort<SceneContext>): void;
+//# sourceMappingURL=connect-context-rpc.d.ts.map

package/dist/lib/babylon/scene/connect-context-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-context-rpc.d.ts","sourceRoot":"","sources":["../../../../src/lib/babylon/scene/connect-context-rpc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AASzC,OAAO,EAA0B,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKvE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC,QAuL1E"}