@needle-tools/engine 3.31.0 → 3.31.1

package/src/engine/engine_gameobject.ts

@@ -28,21 +28,50 @@ export enum HideFlags {
     HideAndDontSave = DontSave | NotEditable | HideInHierarchy, // 0x0000003D
 }
 
+export type IInstantiateOptions = {
+    idProvider?: UIDProvider;
+    //** parent guid or object */
+    parent?: string | Object3D;
+    position?: Vector3;
+    /** for duplicatable parenting */
+    keepWorldPosition?: boolean;
+    rotation?: Quaternion;
+    scale?: Vector3;
+    /** if the instantiated object should be visible */
+    visible?: boolean;
+    context?: Context;
+}
 
-export class InstantiateOptions {
+export class InstantiateOptions implements IInstantiateOptions {
     idProvider?: UIDProvider | undefined;
-
-    //** parent guid */
     parent?: string | undefined | Object3D;
-    /** for duplicatable parenting */
     keepWorldPosition?: boolean
     position?: Vector3 | undefined;
     rotation?: Quaternion | undefined;
     scale?: Vector3 | undefined;
-
     visible?: boolean | undefined;
-
     context?: Context | undefined;
+
+    clone(){
+        const clone = new InstantiateOptions();
+        clone.idProvider = this.idProvider;
+        clone.parent = this.parent;
+        clone.keepWorldPosition = this.keepWorldPosition;
+        clone.position = this.position?.clone();
+        clone.rotation = this.rotation?.clone();
+        clone.scale = this.scale?.clone();
+        return clone;
+    }
+
+    /** Copy fields from another object, clone field references */
+    cloneAssign(other: InstantiateOptions | IInstantiateOptions){
+        this.idProvider = other.idProvider;
+        this.parent = other.parent;
+        this.keepWorldPosition = other.keepWorldPosition;
+        this.position = other.position?.clone();
+        this.rotation = other.rotation?.clone();
+        this.scale = other.scale?.clone();
+    }
 }
 
 
@@ -237,7 +266,7 @@ declare class NewGameObjectReferenceInfo {
     clone: Object3D;
 }
 
-export function instantiate(instance: GameObject | Object3D | null, opts: InstantiateOptions | null = null): GameObject | null {
+export function instantiate(instance: GameObject | Object3D | null, opts: IInstantiateOptions | null = null): GameObject | null {
     if (instance === null) return null;
 
     let options: InstantiateOptions | null = null;
@@ -256,6 +285,7 @@ export function instantiate(instance: GameObject | Object3D | null, opts: Instan
             // }
         }
     }
+    console.log(options?.position)
 
     let context = Context.Current;
     if (options?.context) context = options.context;
@@ -311,7 +341,7 @@ export function instantiate(instance: GameObject | Object3D | null, opts: Instan
 
 
 function internalInstantiate(
-    context: Context, instance: GameObject | Object3D, opts: InstantiateOptions | null,
+    context: Context, instance: GameObject | Object3D, opts: IInstantiateOptions | InstantiateOptions | null,
     componentsList: Array<Component>,
     newGameObjectsMap: { [key: string]: NewGameObjectReferenceInfo },
     skinnedMeshesMap: { [key: string]: NewGameObjectReferenceInfo }

package/src/engine/engine_networking_instantiate.ts

@@ -11,7 +11,7 @@ import { v5 } from 'uuid';
 import type { UIDProvider } from "./engine_types.js";
 import type { IModel } from "./engine_networking_types.js";
 import { SendQueue } from "./engine_networking_types.js";
-import { destroy, findByGuid, instantiate } from "./engine_gameobject.js";
+import { IInstantiateOptions, destroy, findByGuid, instantiate } from "./engine_gameobject.js";
 import { Object3D } from "three";
 import { InstantiateOptions } from "./engine_gameobject.js";
 import { ContextEvent, ContextRegistry } from "../engine/engine_context_registry.js";
@@ -182,7 +182,7 @@ class NewInstanceModel implements IModel {
     }
 }
 
-export function syncInstantiate(object: GameObject | Object3D, opts: InstantiateOptions, hostData?: HostData, save?: boolean): GameObject | null {
+export function syncInstantiate(object: GameObject | Object3D, opts: IInstantiateOptions, hostData?: HostData, save?: boolean): GameObject | null {
 
     const obj: GameObject = object as GameObject;
 
@@ -285,7 +285,7 @@ export function beginListenInstantiate(context: Context) {
 
 }
 
-function instantiateSeeded(obj: GameObject, opts: InstantiateOptions | null): { instance: GameObject | null, seed: number } {
+function instantiateSeeded(obj: GameObject, opts: IInstantiateOptions | null): { instance: GameObject | null, seed: number } {
     const seed = generateSeed();
     const options = opts ?? new InstantiateOptions();
     options.idProvider = new InstantiateIdProvider(seed);

package/src/engine-components/Component.ts

@@ -6,7 +6,7 @@ import * as main from "../engine/engine_mainloop_utils.js";
 import { syncDestroy, syncInstantiate } from "../engine/engine_networking_instantiate.js";
 import type { ConstructorConcrete, SourceIdentifier, IComponent, IGameObject, Constructor, GuidsMap, Collision, ICollider } from "../engine/engine_types.js";
 import { addNewComponent, destroyComponentInstance, findObjectOfType, findObjectsOfType, getComponent, getComponentInChildren, getComponentInParent, getComponents, getComponentsInChildren, getComponentsInParent, getOrAddComponent, moveComponentInstance, removeComponent } from "../engine/engine_components.js";
-import { findByGuid, destroy, InstantiateOptions, instantiate, HideFlags, foreachComponent, markAsInstancedRendered, isActiveInHierarchy, isActiveSelf, isUsingInstancing, setActive, isDestroyed } from "../engine/engine_gameobject.js";
+import { findByGuid, destroy, InstantiateOptions, instantiate, HideFlags, foreachComponent, markAsInstancedRendered, isActiveInHierarchy, isActiveSelf, isUsingInstancing, setActive, isDestroyed, IInstantiateOptions } from "../engine/engine_gameobject.js";
 
 import { Euler, Object3D, Quaternion, Scene, Vector3 } from "three";
 import { showBalloonWarning, isDevEnvironment } from "../engine/debug/index.js";
@@ -72,7 +72,7 @@ export abstract class GameObject extends Object3D implements Object3D, IGameObje
      * @param instance object to instantiate
      * @param opts options for the instantiation
      */
-    public static instantiateSynced(instance: GameObject | Object3D | null, opts: InstantiateOptions): GameObject | null {
+    public static instantiateSynced(instance: GameObject | Object3D | null, opts: IInstantiateOptions): GameObject | null {
         if (!instance) return null;
         return syncInstantiate(instance as any, opts) as GameObject | null;
     }
@@ -81,7 +81,7 @@ export abstract class GameObject extends Object3D implements Object3D, IGameObje
      * @param instance object to instantiate
      * @param opts options for the instantiation (e.g. with what parent, position, etc.)
     */
-    public static instantiate(instance: GameObject | Object3D | null, opts: InstantiateOptions | null = null): GameObject | null {
+    public static instantiate(instance: GameObject | Object3D | null, opts: IInstantiateOptions | null = null): GameObject | null {
         return instantiate(instance, opts) as GameObject | null;
     }