@needle-tools/engine 2.54.2-pre → 2.55.1-pre

package/CHANGELOG.md

@@ -4,6 +4,23 @@ 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.55.1-pre] - 2022-12-30
+- Add: Warning when serialized component field name is starting with uppercase letter
+- Change: bump component compiler dependency
+- Fix: Particle rotation over lifetime
+- Fix: Particles should not emit when emission module is disabled
+- Fix: LODGroup breaking rendering when used with multi-material objects or added on mesh to be culled directly
+
+## [2.55.0-pre] - 2022-12-21
+- Add: PhysicsMaterial support
+- Add: ``Time.timesScale`` factor
+- Change: VideoPlayer exposes underlying HTML video element
+- Change: EffectComposer check if ``setPixelRatio`` method exists before calling
+- Change: WebARSessionRoot and Rig rotation
+- Fix: WebXRController raycast line not being visible in Quest AR
+- Fix: Renderer that is disabled initially now hides object
+- Fix: Some ParticleSystem worldspace settings when calling emit directly
+
 ## [2.54.2-pre] - 2022-12-19
 - Change: debug parameter can now take ``=0`` for disabling them (e.g. ``freecam=0``)
 - Fix: InputField opens keyboard on iOS

package/dist/needle-engine.d.ts

@@ -21,6 +21,8 @@ declare module "engine-components/js-extensions/RGBAColor" {
     export class RGBAColor extends Color {
         alpha: number;
         get isRGBAColor(): boolean;
+        set a(val: number);
+        get a(): number;
         constructor(r: number, g: number, b: number, a: number);
         clone(): this;
         copy(col: RGBAColor | Color): this;
@@ -30,6 +32,19 @@ declare module "engine-components/js-extensions/RGBAColor" {
     }
 }
 declare module "engine/engine_physics.types" {
+    export enum PhysicsMaterialCombine {
+        Average = 0,
+        Multiply = 1,
+        Minimum = 2,
+        Maximum = 3
+    }
+    export type PhysicsMaterial = {
+        bounceCombine: PhysicsMaterialCombine;
+        bounciness: number;
+        frictionCombine: PhysicsMaterialCombine;
+        dynamicFriction: number;
+        staticFriction: number;
+    };
     export enum CollisionDetectionMode {
         Discrete = 0,
         Continuous = 1
@@ -96,7 +111,7 @@ declare module "engine/engine_three_utils" {
 declare module "engine/engine_types" {
     import { Camera, Color, Material, Object3D, Vector3, Quaternion, Ray } from "three";
     import { RGBAColor } from "engine-components/js-extensions/RGBAColor";
-    import { CollisionDetectionMode, RigidbodyConstraints } from "engine/engine_physics.types";
+    import { CollisionDetectionMode, PhysicsMaterial, RigidbodyConstraints } from "engine/engine_physics.types";
     /** used to find data registered via gltf files e.g. find lightmaps for a Renderer component that were shipped inside a gltf */
     export type SourceIdentifier = string;
     export type Constructor<T> = abstract new (...args: any[]) => T;
@@ -145,6 +160,8 @@ declare module "engine/engine_types" {
         __internalDisable(): any;
         __internalDestroy(): any;
         resolveGuids?(guidsMap: GuidsMap): void;
+        /** experimental, called when the script is registered for the first time, this is called even if the component is not enabled. */
+        registering?(): any;
         awake(): any;
         onEnable(): any;
         onDisable(): any;
@@ -201,6 +218,7 @@ declare module "engine/engine_types" {
         get isCollider(): any;
         attachedRigidbody: IRigidbody | null;
         isTrigger: boolean;
+        sharedMaterial?: PhysicsMaterial;
     }
     export interface IRigidbody extends IComponent {
         constraints: RigidbodyConstraints;
@@ -310,6 +328,7 @@ declare module "engine/engine_utils" {
     export function isMozillaXR(): boolean;
     export function isiOS(): boolean;
     export function isSafari(): boolean;
+    export function isQuest(): boolean;
 }
 declare module "engine/engine_networking_utils" {
     export function isLocalNetwork(hostname?: string): boolean;
@@ -903,7 +922,7 @@ declare module "engine/engine_physics" {
         internal_getRigidbody(rb: IRigidbody): RigidBody | null;
         private internalUpdateProperties;
         private lines?;
-        step(_deltaTime?: number): void;
+        step(dt?: number): void;
         private updateDebugRendering;
         postStep(): void;
         /** sync rendered objects with physics world (except for colliders without rigidbody) */
@@ -930,6 +949,7 @@ declare module "engine/engine_time" {
     export class Time {
         deltaTime: number;
         time: number;
+        timeScale: number;
         /** same as frameCount */
         frame: number;
         get realtimeSinceStartup(): number;
@@ -2803,10 +2823,9 @@ declare module "engine-components/AudioSource" {
 }
 declare module "engine-components/Camera" {
     import { Behaviour } from "engine-components/Component";
-    import * as THREE from "three";
     import { RGBAColor } from "engine-components/js-extensions/RGBAColor";
-    import { Ray } from "three";
     import { ICamera } from "engine/engine_types";
+    import { Ray } from "three";
     export enum ClearFlags {
         Skybox = 1,
         SolidColor = 2,
@@ -3729,12 +3748,12 @@ declare module "engine-components/LookAtConstraint" {
 }
 declare module "engine-components/OrbitControls" {
     import { Behaviour } from "engine-components/Component";
-    import { OrbitControls as ThreeOrbitControls } from "three/examples/jsm/controls/OrbitControls";
     import { LookAtConstraint } from "engine-components/LookAtConstraint";
-    import * as THREE from "three";
+    import { Object3D, Vector3 } from "three";
+    import { OrbitControls as ThreeOrbitControls } from "three/examples/jsm/controls/OrbitControls";
     export class OrbitControls extends Behaviour {
         get controls(): ThreeOrbitControls | null;
-        get controllerObject(): THREE.Object3D | null;
+        get controllerObject(): Object3D | null;
         onStartInteraction(func: Function): void;
         autoRotate: boolean;
         autoRotateSpeed: number;
@@ -3768,12 +3787,13 @@ declare module "engine-components/OrbitControls" {
         start(): void;
         private startRaycastDelayed;
         onBeforeRender(): void;
-        setCameraTarget(position?: THREE.Vector3 | null, immediate?: boolean): void;
+        setCameraTarget(position?: Vector3 | null, immediate?: boolean): void;
         setFromTargetPosition(index?: number, t?: number): boolean;
-        setTarget(position?: THREE.Vector3 | null, immediate?: boolean): void;
-        lerpTarget(position: THREE.Vector3, delta: number): void;
-        distanceToTarget(position: THREE.Vector3): number;
+        setTarget(position?: Vector3 | null, immediate?: boolean): void;
+        lerpTarget(position: Vector3, delta: number): void;
+        distanceToTarget(position: Vector3): number;
         private setTargetFromRaycast;
+        fitCameraToObjects(objects: Array<Object3D>, fitOffset?: number): void;
     }
 }
 declare module "engine-components/ui/Raycaster" {
@@ -3990,6 +4010,7 @@ declare module "engine-components/Renderer" {
         set lightmap(tex: Texture | null | undefined);
         get hasLightmap(): boolean;
         allowProgressiveLoading: boolean;
+        registering(): void;
         awake(): void;
         private _isInstancingEnabled;
         private handles;
@@ -4293,10 +4314,12 @@ declare module "engine-components/Collider" {
     import { Rigidbody } from "engine-components/RigidBody";
     import { Mesh, Vector3 } from "three";
     import { ICollider } from "engine/engine_types";
+    import { PhysicsMaterial } from "engine/engine_physics.types";
     export class Collider extends Behaviour implements ICollider {
         get isCollider(): any;
         attachedRigidbody: Rigidbody | null;
         isTrigger: boolean;
+        sharedMaterial?: PhysicsMaterial;
         awake(): void;
         start(): void;
         onEnable(): void;
@@ -4895,7 +4918,7 @@ declare module "engine-components/ParticleSystemModules" {
         get vector(): Vector3;
         getPosition(): void;
         private _dir;
-        getDirection(position: any): Vector3;
+        getDirection(pos: Vec3): Vector3;
         private static _randomQuat;
         private static _tempVec;
         private randomizePosition;
@@ -5032,7 +5055,7 @@ declare module "engine-components/ParticleSystemModules" {
         yMultiplier: number;
         z: MinMaxCurve;
         zMultiplier: number;
-        evaluate(t01: number): number;
+        evaluate(t01: number, t: number): number;
     }
     export class RotationBySpeedModule {
         enabled: boolean;
@@ -5748,6 +5771,7 @@ declare module "engine-components/ParticleSystem" {
         onEnable(): void;
         onDisable(): void;
         onBeforeRender(): void;
+        private onUpdate;
         private addSubParticleSystems;
     }
 }
@@ -5875,12 +5899,13 @@ declare module "engine-components/VideoPlayer" {
         get crossOrigin(): string | null;
         set crossOrigin(val: string | null);
         get videoTexture(): THREE.VideoTexture | null;
+        get videoElement(): HTMLVideoElement | null;
         private _crossOrigin;
         private audioOutputMode;
         private source;
         private clip?;
         private url?;
-        private videoElement;
+        private _videoElement;
         private _videoTexture;
         private videoMaterial;
         private _isPlaying;