@needle-tools/engine 2.55.0-pre → 2.55.2-pre

package/CHANGELOG.md

@@ -4,6 +4,19 @@ 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.2-pre] - 2023-01-02
+- Add: Rigidbody.gravityScale property
+- Add: Gizmos.DrawArrow method
+- Add: Rigidbody.getAngularVelocity method
+- Fix: Mesh collider center of mass
+
+## [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

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;
@@ -225,6 +227,7 @@ declare module "engine/engine_types" {
         drag: number;
         angularDrag: number;
         useGravity: boolean;
+        gravityScale: number;
         collisionDetectionMode: CollisionDetectionMode;
         lockPositionX: boolean;
         lockPositionY: boolean;
@@ -834,6 +837,8 @@ declare module "engine/engine_gizmos" {
         static DrawSphere(center: Vec3, radius: number, color?: ColorRepresentation, duration?: number, depthTest?: boolean): void;
         static DrawBox(center: Vec3, size: Vec3, color?: ColorRepresentation, duration?: number, depthTest?: boolean): void;
         static DrawBox3(box: Box3, color?: ColorRepresentation, duration?: number, depthTest?: boolean): void;
+        private static _up;
+        static DrawArrow(pt0: Vec3, pt1: Vec3, color?: ColorRepresentation, duration?: number, depthTest?: boolean, wireframe?: boolean): void;
     }
     export function CreateWireCube(col?: THREE.ColorRepresentation | null): THREE.LineSegments;
 }
@@ -931,6 +936,7 @@ declare module "engine/engine_physics" {
         private static centerConnectionPos;
         private static centerConnectionRot;
         addFixedJoint(body1: IRigidbody, body2: IRigidbody): void;
+        /** The joint prevents any relative movement between two rigid-bodies, except for relative rotations along one axis. This is typically used to simulate wheels, fans, etc. They are characterized by one local anchor as well as one local axis on each rigid-body. */
         addHingeJoint(body1: IRigidbody, body2: IRigidbody, anchor: {
             x: number;
             y: number;
@@ -1796,6 +1802,138 @@ declare module "engine/engine_playerview" {
         removePlayerView(id: string, device: ViewDevice): void;
     }
 }
+declare module "engine/engine_serialization_decorator" {
+    import { Constructor } from "engine/engine_types";
+    export type TypeResolver<T> = (data: any) => Constructor<T> | null;
+    /** Please use "@serializable" - this version has a typo and will be removed in future versions */
+    export const serializeable: <T>(type?: Constructor<T> | TypeResolver<T> | (Constructor<any> | TypeResolver<T>)[] | null | undefined) => (_target: any, _propertyKey: string) => void;
+    export const serializable: <T>(type?: Constructor<T> | TypeResolver<T> | (Constructor<any> | TypeResolver<T>)[] | null | undefined) => (_target: any, _propertyKey: string) => void;
+    export const ALL_PROPERTIES_MARKER = "__NEEDLE__ALL_PROPERTIES";
+    /** @deprecated current not used */
+    export function allProperties(constructor: Function): void;
+    export const STRICT_MARKER = "__NEEDLE__STRICT";
+    /** @deprecated  current not used */
+    export function strict(constructor: Function): void;
+}
+declare module "engine-components/Camera" {
+    import { Behaviour } from "engine-components/Component";
+    import { RGBAColor } from "engine-components/js-extensions/RGBAColor";
+    import { ICamera } from "engine/engine_types";
+    import { Ray } from "three";
+    export enum ClearFlags {
+        Skybox = 1,
+        SolidColor = 2,
+        Uninitialized = 4
+    }
+    export class Camera extends Behaviour implements ICamera {
+        get isCamera(): boolean;
+        get aspect(): number;
+        get fieldOfView(): number;
+        set fieldOfView(val: number);
+        get nearClipPlane(): number;
+        set nearClipPlane(val: number);
+        private _nearClipPlane;
+        get farClipPlane(): number;
+        set farClipPlane(val: number);
+        private _farClipPlane;
+        get clearFlags(): ClearFlags;
+        set clearFlags(val: ClearFlags);
+        orthographic: boolean;
+        orthographicSize: number;
+        ARBackgroundAlpha: number;
+        set cullingMask(val: number);
+        get cullingMask(): number;
+        private _cullingMask;
+        set backgroundBlurriness(val: number | undefined);
+        get backgroundBlurriness(): number | undefined;
+        private _backgroundBlurriness?;
+        set backgroundIntensity(val: number | undefined);
+        get backgroundIntensity(): number | undefined;
+        private _backgroundIntensity?;
+        get backgroundColor(): RGBAColor | null;
+        set backgroundColor(val: RGBAColor | null);
+        private _backgroundColor?;
+        private _fov;
+        private _cam;
+        private _clearFlags;
+        private _skybox?;
+        get cam(): THREE.PerspectiveCamera | THREE.OrthographicCamera;
+        private static _origin;
+        private static _direction;
+        screenPointToRay(x: number, y: number, ray?: Ray): Ray;
+        awake(): void;
+        onEnable(): void;
+        onDisable(): void;
+        buildCamera(): void;
+        applyClearFlagsIfIsActiveCamera(): void;
+        private environmentIsTransparent;
+        private enableSkybox;
+    }
+}
+declare module "engine-components/LookAtConstraint" {
+    import { Behaviour } from "engine-components/Component";
+    import * as THREE from "three";
+    export class LookAtConstraint extends Behaviour {
+        constraintActive: boolean;
+        locked: boolean;
+        sources: THREE.Object3D[];
+    }
+}
+declare module "engine-components/OrbitControls" {
+    import { Behaviour } from "engine-components/Component";
+    import { LookAtConstraint } from "engine-components/LookAtConstraint";
+    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(): Object3D | null;
+        onStartInteraction(func: Function): void;
+        autoRotate: boolean;
+        autoRotateSpeed: number;
+        enableKeys: boolean;
+        enableDamping: boolean;
+        dampingFactor: number;
+        enableZoom: boolean;
+        minZoom: number;
+        maxZoom: number;
+        enablePan: boolean;
+        lookAtConstraint: LookAtConstraint | null;
+        lookAtConstraint01: number;
+        middleClickToFocus: boolean;
+        doubleClickToFocus: boolean;
+        useSlerp: boolean;
+        debugLog: boolean;
+        targetLerpSpeed: number;
+        private _lookTargetPosition;
+        private _controls;
+        private _cameraObject;
+        private _lerpToTargetPosition;
+        private _lerpCameraToTarget;
+        private _cameraTargetPosition;
+        private _inputs;
+        private _enableTime;
+        private _startedListeningToKeyEvents;
+        awake(): void;
+        onEnable(): void;
+        onDisable(): void;
+        onDestroy(): void;
+        start(): void;
+        private startRaycastDelayed;
+        onBeforeRender(): void;
+        setCameraTarget(position?: Vector3 | null, immediate?: boolean): void;
+        setFromTargetPosition(index?: number, t?: number): boolean;
+        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/CameraUtils" {
+    import { Scene } from "three";
+    import { ICamera, SourceIdentifier } from "engine/engine_types";
+    export function createCameraWithOrbitControl(scene: Scene, source: SourceIdentifier): ICamera;
+}
 declare module "engine/engine_setup" {
     import * as THREE from 'three';
     import { Input } from "engine/engine_input";
@@ -2211,19 +2349,6 @@ declare module "engine-components/AnimatorController" {
         private rootMotionHandler?;
     }
 }
-declare module "engine/engine_serialization_decorator" {
-    import { Constructor } from "engine/engine_types";
-    export type TypeResolver<T> = (data: any) => Constructor<T> | null;
-    /** Please use "@serializable" - this version has a typo and will be removed in future versions */
-    export const serializeable: <T>(type?: Constructor<T> | TypeResolver<T> | (Constructor<any> | TypeResolver<T>)[] | null | undefined) => (_target: any, _propertyKey: string) => void;
-    export const serializable: <T>(type?: Constructor<T> | TypeResolver<T> | (Constructor<any> | TypeResolver<T>)[] | null | undefined) => (_target: any, _propertyKey: string) => void;
-    export const ALL_PROPERTIES_MARKER = "__NEEDLE__ALL_PROPERTIES";
-    /** @deprecated current not used */
-    export function allProperties(constructor: Function): void;
-    export const STRICT_MARKER = "__NEEDLE__STRICT";
-    /** @deprecated  current not used */
-    export function strict(constructor: Function): void;
-}
 declare module "engine-components/Animator" {
     import { Behaviour } from "engine-components/Component";
     import * as THREE from 'three';
@@ -2819,62 +2944,6 @@ declare module "engine-components/AudioSource" {
         update(): void;
     }
 }
-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";
-    export enum ClearFlags {
-        Skybox = 1,
-        SolidColor = 2,
-        Uninitialized = 4
-    }
-    export class Camera extends Behaviour implements ICamera {
-        get isCamera(): boolean;
-        get aspect(): number;
-        get fieldOfView(): number;
-        set fieldOfView(val: number);
-        get nearClipPlane(): number;
-        set nearClipPlane(val: number);
-        private _nearClipPlane;
-        get farClipPlane(): number;
-        set farClipPlane(val: number);
-        private _farClipPlane;
-        get clearFlags(): ClearFlags;
-        set clearFlags(val: ClearFlags);
-        orthographic: boolean;
-        orthographicSize: number;
-        ARBackgroundAlpha: number;
-        set cullingMask(val: number);
-        get cullingMask(): number;
-        private _cullingMask;
-        set backgroundBlurriness(val: number | undefined);
-        get backgroundBlurriness(): number | undefined;
-        private _backgroundBlurriness?;
-        set backgroundIntensity(val: number | undefined);
-        get backgroundIntensity(): number | undefined;
-        private _backgroundIntensity?;
-        get backgroundColor(): RGBAColor | null;
-        set backgroundColor(val: RGBAColor | null);
-        private _backgroundColor?;
-        private _fov;
-        private _cam;
-        private _clearFlags;
-        private _skybox?;
-        get cam(): THREE.PerspectiveCamera | THREE.OrthographicCamera;
-        private static _origin;
-        private static _direction;
-        screenPointToRay(x: number, y: number, ray?: Ray): Ray;
-        awake(): void;
-        onEnable(): void;
-        onDisable(): void;
-        buildCamera(): void;
-        applyClearFlagsIfIsActiveCamera(): void;
-        private environmentIsTransparent;
-        private enableSkybox;
-    }
-}
 declare module "engine-components/AudioListener" {
     import { Behaviour } from "engine-components/Component";
     import * as THREE from "three";
@@ -3656,6 +3725,9 @@ declare module "engine-components/RigidBody" {
         set lockRotationX(v: boolean);
         set lockRotationY(v: boolean);
         set lockRotationZ(v: boolean);
+        set gravityScale(val: number);
+        get gravityScale(): number;
+        private _gravityScale;
         private static tempPosition;
         private _propertiesChanged;
         private _currentVelocity;
@@ -3686,6 +3758,7 @@ declare module "engine-components/RigidBody" {
         getVelocity(): Vector3;
         setVelocity(x: number | Vector3, y?: number, z?: number): void;
         setAngularVelocity(x: number | Vector3, y?: number, z?: number): void;
+        getAngularVelocity(): Vector3;
         setTorque(x: number | Vector3, y: number, z: number): void;
         get smoothedVelocity(): Vector3;
         /**d
@@ -3736,64 +3809,6 @@ declare module "engine-components/SyncedTransform" {
         onBeforeRender(): void;
     }
 }
-declare module "engine-components/LookAtConstraint" {
-    import { Behaviour } from "engine-components/Component";
-    import * as THREE from "three";
-    export class LookAtConstraint extends Behaviour {
-        constraintActive: boolean;
-        locked: boolean;
-        sources: THREE.Object3D[];
-    }
-}
-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";
-    export class OrbitControls extends Behaviour {
-        get controls(): ThreeOrbitControls | null;
-        get controllerObject(): THREE.Object3D | null;
-        onStartInteraction(func: Function): void;
-        autoRotate: boolean;
-        autoRotateSpeed: number;
-        enableKeys: boolean;
-        enableDamping: boolean;
-        dampingFactor: number;
-        enableZoom: boolean;
-        minZoom: number;
-        maxZoom: number;
-        enablePan: boolean;
-        lookAtConstraint: LookAtConstraint | null;
-        lookAtConstraint01: number;
-        middleClickToFocus: boolean;
-        doubleClickToFocus: boolean;
-        useSlerp: boolean;
-        debugLog: boolean;
-        targetLerpSpeed: number;
-        private _lookTargetPosition;
-        private _controls;
-        private _cameraObject;
-        private _lerpToTargetPosition;
-        private _lerpCameraToTarget;
-        private _cameraTargetPosition;
-        private _inputs;
-        private _enableTime;
-        private _startedListeningToKeyEvents;
-        awake(): void;
-        onEnable(): void;
-        onDisable(): void;
-        onDestroy(): void;
-        start(): void;
-        private startRaycastDelayed;
-        onBeforeRender(): void;
-        setCameraTarget(position?: THREE.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;
-        private setTargetFromRaycast;
-    }
-}
 declare module "engine-components/ui/Raycaster" {
     import { RaycastOptions } from "engine/engine_physics";
     import { Behaviour } from "engine-components/Component";
@@ -5053,7 +5068,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;
@@ -6551,11 +6566,6 @@ declare module "engine-components/BoxCollider" {
     import { BoxCollider } from "engine-components/Collider";
     export default BoxCollider;
 }
-declare module "engine-components/CameraUtils" {
-    import { Camera } from "engine-components/Camera";
-    import { Scene } from "three";
-    export function createCameraWithOrbitControl(scene: Scene): Camera;
-}
 declare module "engine-components/SphereCollider" {
     import { SphereCollider } from "engine-components/Collider";
     export default SphereCollider;