@needle-tools/engine 2.58.0-pre → 2.58.1-pre

package/CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [2.58.1-pre] - 2023-01-09
+- Add: Prewarm rendering of newly loaded objects to remove lag/jitter when they become visible for the first time
+- Change: renderer now warns when sharedMaterials have missing entries. It then tries to remap those values when accessing them by index (e.g. when another component has a material index serialized and relies on that index to be pointing to the correct object)
+
 ## [2.58.0-pre] - 2023-01-09
 - Add: EventSystem input events (e.g. IPointerClick) are now invoked for all buttons (e.g. right click)
 - Add: Hot reload for components

package/dist/needle-engine.d.ts

@@ -700,6 +700,9 @@ declare module "engine/engine_mainloop_utils" {
     export function removeScriptFromContext(script: any, context: Context): void;
     export function updateIsActive(obj?: Object3D): void;
     export function updateActiveInHierarchyWithoutEventCall(go: THREE.Object3D): void;
+    export function registerPrewarmObject(obj: Object3D, context: Context): void;
+    export function runPrewarm(context: Context): void;
+    export function clearPrewarmList(context: Context): void;
 }
 declare module "engine/engine_networking_types" {
     export interface IModel {
@@ -3970,7 +3973,7 @@ declare module "engine/js-extensions/Layers" {
 declare module "engine-components/Renderer" {
     import { Behaviour } from "engine-components/Component";
     import * as THREE from "three";
-    import { Mesh, Object3D, Texture } from "three";
+    import { Material, Mesh, Object3D, Texture } from "three";
     import { IRenderer, ISharedMaterials } from "engine/engine_types";
     export { InstancingUtil } from "engine/engine_instancing";
     export enum ReflectionProbeUsage {
@@ -3993,9 +3996,12 @@ declare module "engine-components/Renderer" {
         [num: number]: THREE.Material;
         private _renderer;
         private _targets;
+        private _indexMapMaxIndex?;
+        private _indexMap?;
         is(renderer: Renderer): boolean;
-        constructor(renderer: Renderer);
+        constructor(renderer: Renderer, originalMaterials: Material[]);
         get length(): number;
+        private resolveIndex;
         private setMaterial;
         private getMaterial;
     }
@@ -4022,6 +4028,8 @@ declare module "engine-components/Renderer" {
         /**@deprecated please use sharedMaterial */
         set material(mat: THREE.Material);
         private _sharedMaterials;
+        private _originalMaterials;
+        private set sharedMaterials(value);
         get sharedMaterials(): SharedMaterialArray;
         static get shouldSuppressInstancing(): string | number | boolean;
         private _lightmapTextureOverride;