@aura3d/controls 3.0.0 → 4.0.0

package/dist/engine/FirstPersonControls.js

@@ -0,0 +1,44 @@
+import { clamp } from "./ControlTypes.js";
+export class FirstPersonControls {
+    camera;
+    enabled = true;
+    yaw = 0;
+    pitch = 0;
+    moveSpeed;
+    lookSpeed;
+    minPitch;
+    maxPitch;
+    constructor(camera, options = {}) {
+        this.camera = camera;
+        this.moveSpeed = options.moveSpeed ?? 1;
+        this.lookSpeed = options.lookSpeed ?? 0.002;
+        this.minPitch = options.minPitch ?? -Math.PI / 2 + 0.001;
+        this.maxPitch = options.maxPitch ?? Math.PI / 2 - 0.001;
+        this.pitch = clamp(camera.rotation?.x ?? 0, this.minPitch, this.maxPitch);
+        this.yaw = camera.rotation?.y ?? 0;
+    }
+    update(snapshot, deltaSeconds) {
+        if (!this.enabled) {
+            return;
+        }
+        if (snapshot.button(0).down) {
+            this.yaw -= snapshot.pointer.deltaX * this.lookSpeed;
+            this.pitch = clamp(this.pitch - snapshot.pointer.deltaY * this.lookSpeed, this.minPitch, this.maxPitch);
+            if (this.camera.rotation) {
+                this.camera.rotation.x = this.pitch;
+                this.camera.rotation.y = this.yaw;
+            }
+        }
+        const forward = (snapshot.key("KeyW").down ? 1 : 0) - (snapshot.key("KeyS").down ? 1 : 0);
+        const strafe = (snapshot.key("KeyD").down ? 1 : 0) - (snapshot.key("KeyA").down ? 1 : 0);
+        const step = this.moveSpeed * deltaSeconds;
+        const sin = Math.sin(this.yaw);
+        const cos = Math.cos(this.yaw);
+        this.camera.position.x += (strafe * cos + forward * sin) * step;
+        this.camera.position.z += (forward * cos - strafe * sin) * step;
+    }
+    dispose() {
+        this.enabled = false;
+    }
+}
+//# sourceMappingURL=FirstPersonControls.js.map

package/dist/engine/FirstPersonControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirstPersonControls.js","sourceRoot":"","sources":["../../../../../packages/controls/src/engine/FirstPersonControls.ts"],"names":[],"mappings":"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"}

package/dist/engine/OrbitControls.d.ts

@@ -0,0 +1,92 @@
+import type { InputSnapshot } from "@aura3d/input";
+import { type CameraTransformLike, type Vec3Like } from "./ControlTypes.js";
+export declare const DEFAULT_ORBIT_MAX_POLAR: number;
+export interface OrbitControlsOptions {
+    /** Opt in to time-based decay; dampingFactor is the fraction consumed at 60Hz. */
+    readonly enableDamping?: boolean;
+    readonly dampingFactor?: number;
+    readonly zoomToCursor?: boolean;
+    /** Pointer coordinates and this rectangle must use the same CSS-pixel space. */
+    readonly viewport?: () => {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    readonly panBounds?: {
+        readonly min: Vec3Like;
+        readonly max: Vec3Like;
+    };
+    readonly screenSpacePanning?: boolean;
+    readonly oneFingerAction?: "rotate" | "pan";
+    readonly enabled?: boolean;
+    readonly enablePan?: boolean;
+    readonly enableZoom?: boolean;
+    readonly enableRotate?: boolean;
+    readonly target?: Vec3Like;
+    readonly distance?: number;
+    readonly minDistance?: number;
+    readonly maxDistance?: number;
+    readonly minZoom?: number;
+    readonly maxZoom?: number;
+    readonly minPolar?: number;
+    readonly maxPolar?: number;
+    readonly rotateSpeed?: number;
+    readonly zoomSpeed?: number;
+    readonly panSpeed?: number;
+}
+/** Structural projection adapter; fov is vertical degrees, orthographic extents are world units. */
+export interface OrbitCameraTransformLike extends CameraTransformLike {
+    readonly fov?: number;
+    readonly aspect?: number;
+    readonly isOrthographicCamera?: boolean;
+    readonly left?: number;
+    readonly right?: number;
+    readonly top?: number;
+    readonly bottom?: number;
+    zoom?: number;
+    updateProjectionMatrix?(): void;
+}
+export declare class OrbitControls {
+    private readonly camera;
+    enableDamping: boolean;
+    dampingFactor: number;
+    zoomToCursor: boolean;
+    enabled: boolean;
+    enablePan: boolean;
+    enableZoom: boolean;
+    enableRotate: boolean;
+    readonly target: Vec3Like;
+    private azimuth;
+    private polar;
+    private distance;
+    private readonly initial;
+    private disposed;
+    private pendingAzimuth;
+    private pendingPolar;
+    private pendingPan;
+    private previousTouches;
+    private readonly minDistance;
+    private readonly maxDistance;
+    private readonly minPolar;
+    private readonly maxPolar;
+    private readonly rotateSpeed;
+    private readonly zoomSpeed;
+    private readonly panSpeed;
+    private readonly options;
+    constructor(camera: CameraTransformLike, options?: OrbitControlsOptions);
+    update(snapshot: InputSnapshot, deltaSeconds?: number): void;
+    getPolarAngle(): number;
+    getAzimuthalAngle(): number;
+    getDistance(): number;
+    saveState(): void;
+    reset(): void;
+    dispose(): void;
+    private clearPending;
+    private pan;
+    private dollyFromWheel;
+    private cursorOffset;
+    private touch;
+    private apply;
+}
+//# sourceMappingURL=OrbitControls.d.ts.map

package/dist/engine/OrbitControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrbitControls.d.ts","sourceRoot":"","sources":["../../../../../packages/controls/src/engine/OrbitControls.ts"],"names":[],"mappings":"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"}

package/dist/engine/OrbitControls.js

@@ -0,0 +1,270 @@
+import { clamp } from "./ControlTypes.js";
+export const DEFAULT_ORBIT_MAX_POLAR = Math.PI * 0.37;
+export class OrbitControls {
+    camera;
+    enableDamping;
+    dampingFactor;
+    zoomToCursor;
+    enabled;
+    enablePan;
+    enableZoom;
+    enableRotate;
+    target;
+    azimuth = 0;
+    polar = Math.PI / 2;
+    distance;
+    initial;
+    disposed = false;
+    pendingAzimuth = 0;
+    pendingPolar = 0;
+    pendingPan = { x: 0, y: 0, z: 0 };
+    previousTouches = [];
+    minDistance;
+    maxDistance;
+    minPolar;
+    maxPolar;
+    rotateSpeed;
+    zoomSpeed;
+    panSpeed;
+    options;
+    constructor(camera, options = {}) {
+        this.camera = camera;
+        this.options = options;
+        this.enableDamping = options.enableDamping ?? false;
+        this.dampingFactor = options.dampingFactor ?? 0.05;
+        this.zoomToCursor = options.zoomToCursor ?? false;
+        this.enabled = options.enabled ?? true;
+        this.enablePan = options.enablePan ?? true;
+        this.enableZoom = options.enableZoom ?? true;
+        this.enableRotate = options.enableRotate ?? true;
+        this.target = { ...(options.target ?? { x: 0, y: 0, z: 0 }) };
+        this.minDistance = options.minDistance ?? 0.1;
+        this.maxDistance = options.maxDistance ?? 1_000;
+        this.minPolar = options.minPolar ?? 0.001;
+        this.maxPolar = options.maxPolar ?? DEFAULT_ORBIT_MAX_POLAR;
+        this.rotateSpeed = options.rotateSpeed ?? 0.005;
+        this.zoomSpeed = options.zoomSpeed ?? 1;
+        this.panSpeed = options.panSpeed ?? 0.002;
+        const current = orbitStateFromCamera(camera, this.target);
+        this.distance = clamp(options.distance ?? current.distance, this.minDistance, this.maxDistance);
+        this.azimuth = current.azimuth;
+        this.polar = clamp(current.polar, this.minPolar, this.maxPolar);
+        this.initial = {
+            target: { ...this.target },
+            azimuth: this.azimuth,
+            polar: this.polar,
+            distance: this.distance,
+            zoom: camera.zoom ?? 1
+        };
+        this.apply();
+    }
+    update(snapshot, deltaSeconds = 1 / 60) {
+        if (!this.enabled || this.disposed || !Number.isFinite(deltaSeconds) || deltaSeconds <= 0) {
+            return;
+        }
+        const leftButton = snapshot.button(0);
+        const middleButton = snapshot.button(1);
+        const rightButton = snapshot.button(2);
+        const panModifier = snapshot.keys.has("ShiftLeft") || snapshot.keys.has("ShiftRight") || snapshot.keys.has("ControlLeft") || snapshot.keys.has("ControlRight") || snapshot.keys.has("MetaLeft") || snapshot.keys.has("MetaRight");
+        const dx = finite(snapshot.pointer.deltaX);
+        const dy = finite(snapshot.pointer.deltaY);
+        const touching = snapshot.pointer.touches.length > 0;
+        if (!this.enableRotate)
+            this.pendingAzimuth = this.pendingPolar = 0;
+        if (!this.enablePan)
+            this.pendingPan = { x: 0, y: 0, z: 0 };
+        if (this.enableRotate && leftButton.down && !panModifier && !touching) {
+            this.pendingAzimuth -= dx * this.rotateSpeed;
+            this.pendingPolar -= dy * this.rotateSpeed;
+        }
+        if (this.enablePan && !touching && (rightButton.down || middleButton.down || (leftButton.down && panModifier))) {
+            this.pan(dx, dy);
+        }
+        this.touch(snapshot);
+        const factor = this.enableDamping
+            ? 1 - Math.pow(1 - clamp(finite(this.dampingFactor), 0.000001, 1), deltaSeconds * 60)
+            : 1;
+        this.azimuth += this.pendingAzimuth * factor;
+        this.polar = clamp(this.polar + this.pendingPolar * factor, this.minPolar, this.maxPolar);
+        for (const axis of ["x", "y", "z"]) {
+            this.target[axis] += this.pendingPan[axis] * factor;
+            this.pendingPan[axis] *= 1 - factor;
+        }
+        this.pendingAzimuth *= 1 - factor;
+        this.pendingPolar *= 1 - factor;
+        if (this.enableZoom && snapshot.pointer.wheelY !== 0) {
+            this.dollyFromWheel(finite(snapshot.pointer.wheelY), snapshot.pointer.x, snapshot.pointer.y);
+        }
+        this.apply();
+    }
+    getPolarAngle() {
+        return this.polar;
+    }
+    getAzimuthalAngle() {
+        return this.azimuth;
+    }
+    getDistance() {
+        return this.distance;
+    }
+    saveState() {
+        if (this.disposed)
+            return;
+        this.initial.target.x = this.target.x;
+        this.initial.target.y = this.target.y;
+        this.initial.target.z = this.target.z;
+        this.initial.azimuth = this.azimuth;
+        this.initial.polar = this.polar;
+        this.initial.distance = this.distance;
+        this.initial.zoom = this.camera.zoom ?? 1;
+    }
+    reset() {
+        if (this.disposed)
+            return;
+        this.clearPending();
+        this.target.x = this.initial.target.x;
+        this.target.y = this.initial.target.y;
+        this.target.z = this.initial.target.z;
+        this.azimuth = this.initial.azimuth;
+        this.polar = this.initial.polar;
+        this.distance = this.initial.distance;
+        const camera = this.camera;
+        if (camera.isOrthographicCamera) {
+            camera.zoom = this.initial.zoom;
+            camera.updateProjectionMatrix?.();
+        }
+        this.apply();
+    }
+    dispose() {
+        this.disposed = true;
+        this.enabled = false;
+        this.clearPending();
+    }
+    clearPending() {
+        this.pendingAzimuth = this.pendingPolar = 0;
+        this.pendingPan = { x: 0, y: 0, z: 0 };
+        this.previousTouches = [];
+    }
+    pan(deltaX, deltaY) {
+        const scale = this.distance * this.panSpeed;
+        if (this.options.screenSpacePanning === false) {
+            this.pendingPan.x += (-deltaX * Math.cos(this.azimuth) + deltaY * Math.sin(this.azimuth)) * scale;
+            this.pendingPan.z += (deltaX * Math.sin(this.azimuth) + deltaY * Math.cos(this.azimuth)) * scale;
+        }
+        else {
+            // Preserve legacy world-XY pan unless ground-plane semantics are requested.
+            this.pendingPan.x -= deltaX * scale;
+            this.pendingPan.y += deltaY * scale;
+        }
+    }
+    dollyFromWheel(deltaY, x = 0, y = 0) {
+        const anchor = this.cursorOffset(x, y);
+        const oldDistance = this.distance;
+        const camera = this.camera;
+        const oldZoom = camera.zoom ?? 1;
+        const normalizedDelta = Math.abs(deltaY * 0.01);
+        const zoomScale = Math.pow(0.95, this.zoomSpeed * normalizedDelta);
+        const nextDistance = deltaY < 0
+            ? this.distance * zoomScale
+            : this.distance / zoomScale;
+        this.distance = clamp(nextDistance, this.minDistance, this.maxDistance);
+        let ratio = this.distance / oldDistance;
+        if (camera.isOrthographicCamera) {
+            const requestedRatio = deltaY < 0 ? zoomScale : 1 / zoomScale;
+            camera.zoom = clamp(oldZoom / requestedRatio, this.options.minZoom ?? 1e-6, this.options.maxZoom ?? 1e6);
+            ratio = oldZoom / camera.zoom;
+            this.distance = oldDistance;
+            camera.updateProjectionMatrix?.();
+        }
+        if (anchor)
+            for (const axis of ["x", "y", "z"])
+                this.target[axis] += anchor[axis] * (1 - ratio);
+    }
+    cursorOffset(x, y) {
+        const viewport = this.options.viewport?.();
+        if (!this.zoomToCursor || !viewport || viewport.width <= 0 || viewport.height <= 0 ||
+            ![x, y, viewport.x, viewport.y, viewport.width, viewport.height].every(Number.isFinite))
+            return;
+        const nx = 2 * (x - viewport.x) / viewport.width - 1;
+        const ny = 1 - 2 * (y - viewport.y) / viewport.height;
+        const cam = this.camera;
+        let horizontal;
+        let vertical;
+        if (cam.isOrthographicCamera) {
+            if (![cam.left, cam.right, cam.top, cam.bottom].every(value => typeof value === "number" && Number.isFinite(value)))
+                return;
+            horizontal = (nx * (cam.right - cam.left) + cam.right + cam.left) / (2 * (cam.zoom ?? 1));
+            vertical = (ny * (cam.top - cam.bottom) + cam.top + cam.bottom) / (2 * (cam.zoom ?? 1));
+        }
+        else {
+            if (!Number.isFinite(cam.fov) || cam.fov <= 0 || cam.fov >= 180)
+                return;
+            const halfHeight = this.distance * Math.tan(cam.fov * Math.PI / 360) / (cam.zoom ?? 1);
+            horizontal = nx * halfHeight * (cam.aspect ?? viewport.width / viewport.height);
+            vertical = ny * halfHeight;
+        }
+        const c = Math.cos(this.azimuth), s = Math.sin(this.azimuth);
+        const cp = Math.cos(this.polar), sp = Math.sin(this.polar);
+        return { x: horizontal * c - vertical * cp * s, y: vertical * sp, z: -horizontal * s - vertical * cp * c };
+    }
+    touch(snapshot) {
+        const touches = snapshot.pointer.touches.filter(t => Number.isFinite(t.x) && Number.isFinite(t.y));
+        const previous = this.previousTouches;
+        this.previousTouches = touches;
+        if (touches.length !== previous.length || !touches.every((t, i) => t.id === previous[i]?.id))
+            return;
+        if (touches.length === 1) {
+            const dx = touches[0].x - previous[0].x, dy = touches[0].y - previous[0].y;
+            if (this.options.oneFingerAction === "pan") {
+                if (this.enablePan)
+                    this.pan(dx, dy);
+            }
+            else if (this.enableRotate) {
+                this.pendingAzimuth -= dx * this.rotateSpeed;
+                this.pendingPolar -= dy * this.rotateSpeed;
+            }
+        }
+        else if (touches.length === 2) {
+            const a = touches[0], b = touches[1], pa = previous[0], pb = previous[1];
+            const x = (a.x + b.x) / 2, y = (a.y + b.y) / 2;
+            if (this.enablePan)
+                this.pan(x - (pa.x + pb.x) / 2, y - (pa.y + pb.y) / 2);
+            const before = Math.hypot(pa.x - pb.x, pa.y - pb.y), after = Math.hypot(a.x - b.x, a.y - b.y);
+            if (this.enableZoom && before > 0 && after > 0)
+                this.dollyFromWheel(Math.log(after / before) / Math.log(0.95) * 100, x, y);
+        }
+    }
+    apply() {
+        const bounds = this.options.panBounds;
+        if (bounds)
+            for (const axis of ["x", "y", "z"]) {
+                const min = bounds.min[axis], max = bounds.max[axis];
+                if (Number.isFinite(min) && Number.isFinite(max) && min <= max) {
+                    const next = clamp(this.target[axis], min, max);
+                    if (next !== this.target[axis])
+                        this.pendingPan[axis] = 0;
+                    this.target[axis] = next;
+                }
+            }
+        const sinPolar = Math.sin(this.polar);
+        this.camera.position.x = this.target.x + this.distance * sinPolar * Math.sin(this.azimuth);
+        this.camera.position.y = this.target.y + this.distance * Math.cos(this.polar);
+        this.camera.position.z = this.target.z + this.distance * sinPolar * Math.cos(this.azimuth);
+        this.camera.lookAt?.(this.target);
+    }
+}
+function finite(value) { return Number.isFinite(value) ? value : 0; }
+function orbitStateFromCamera(camera, target) {
+    const dx = camera.position.x - target.x;
+    const dy = camera.position.y - target.y;
+    const dz = camera.position.z - target.z;
+    const distance = Math.hypot(dx, dy, dz);
+    if (!Number.isFinite(distance) || distance <= 1e-6) {
+        return { azimuth: 0, polar: Math.PI / 2, distance: 5 };
+    }
+    return {
+        azimuth: Math.atan2(dx, dz),
+        polar: Math.acos(clamp(dy / distance, -1, 1)),
+        distance
+    };
+}
+//# sourceMappingURL=OrbitControls.js.map

package/dist/engine/OrbitControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrbitControls.js","sourceRoot":"","sources":["../../../../../packages/controls/src/engine/OrbitControls.ts"],"names":[],"mappings":"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"}

package/dist/engine/PointerLockControls.d.ts

@@ -0,0 +1,11 @@
+import { InputSnapshot } from "@aura3d/input";
+import { FirstPersonControls, type FirstPersonControlsOptions } from "./FirstPersonControls.js";
+import type { CameraTransformLike } from "./ControlTypes.js";
+export declare class PointerLockControls extends FirstPersonControls {
+    locked: boolean;
+    constructor(camera: CameraTransformLike, options?: FirstPersonControlsOptions);
+    lock(): void;
+    unlock(): void;
+    update(snapshot: InputSnapshot, deltaSeconds: number): void;
+}
+//# sourceMappingURL=PointerLockControls.d.ts.map

package/dist/engine/PointerLockControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointerLockControls.d.ts","sourceRoot":"","sources":["../../../../../packages/controls/src/engine/PointerLockControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,qBAAa,mBAAoB,SAAQ,mBAAmB;IAC1D,MAAM,UAAS;gBAEH,MAAM,EAAE,mBAAmB,EAAE,OAAO,GAAE,0BAA+B;IAIjF,IAAI,IAAI,IAAI;IAIZ,MAAM,IAAI,IAAI;IAIL,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;CAiBrE"}

package/dist/engine/PointerLockControls.js

@@ -0,0 +1,31 @@
+import { InputSnapshot } from "@aura3d/input";
+import { FirstPersonControls } from "./FirstPersonControls.js";
+export class PointerLockControls extends FirstPersonControls {
+    locked = false;
+    constructor(camera, options = {}) {
+        super(camera, options);
+    }
+    lock() {
+        this.locked = true;
+    }
+    unlock() {
+        this.locked = false;
+    }
+    update(snapshot, deltaSeconds) {
+        if (!this.locked)
+            return;
+        if ((snapshot.pointer.deltaX !== 0 || snapshot.pointer.deltaY !== 0)
+            && !snapshot.button(0).down) {
+            const buttons = new Map(snapshot.pointer.buttons);
+            buttons.set(0, { down: true, pressed: false, released: false });
+            super.update(new InputSnapshot({
+                keys: snapshot.keys,
+                pointer: { ...snapshot.pointer, buttons },
+                gamepads: snapshot.gamepads
+            }), deltaSeconds);
+            return;
+        }
+        super.update(snapshot, deltaSeconds);
+    }
+}
+//# sourceMappingURL=PointerLockControls.js.map

package/dist/engine/PointerLockControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointerLockControls.js","sourceRoot":"","sources":["../../../../../packages/controls/src/engine/PointerLockControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAmC,MAAM,uBAAuB,CAAC;AAG7F,MAAM,OAAO,mBAAoB,SAAQ,mBAAmB;IAC1D,MAAM,GAAG,KAAK,CAAC;IAEf,YAAY,MAA2B,EAAE,UAAsC,EAAE;QAC/E,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAEQ,MAAM,CAAC,QAAuB,EAAE,YAAoB;QAC3D,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IACE,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;eAC7D,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAC3B,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,KAAK,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC;gBAC7B,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE;gBACzC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B,CAAC,EAAE,YAAY,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/engine/SceneCameraAdapter.d.ts

@@ -0,0 +1,10 @@
+import { type Camera } from "@aura3d/scene";
+import { type CameraTransformLike, type EulerLike, type Vec3Like } from "./ControlTypes.js";
+export interface SceneCameraControlAdapter extends CameraTransformLike {
+    readonly camera: Camera;
+    readonly position: Vec3Like;
+    readonly rotation: EulerLike;
+    lookAt(target: Vec3Like): void;
+}
+export declare function createSceneCameraControlAdapter(camera: Camera): SceneCameraControlAdapter;
+//# sourceMappingURL=SceneCameraAdapter.d.ts.map

package/dist/engine/SceneCameraAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneCameraAdapter.d.ts","sourceRoot":"","sources":["../../../../../packages/controls/src/engine/SceneCameraAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEzF,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,yBAAyB,CAkEzF"}

package/dist/engine/SceneCameraAdapter.js

@@ -0,0 +1,90 @@
+import { Quaternion, Vector3 } from "@aura3d/math";
+import {} from "@aura3d/scene";
+import {} from "./ControlTypes.js";
+export function createSceneCameraControlAdapter(camera) {
+    const euler = quaternionToEuler(camera.transform.rotation);
+    const position = {
+        get x() {
+            return camera.transform.position[0];
+        },
+        set x(value) {
+            camera.transform.setPosition(value, camera.transform.position[1], camera.transform.position[2]);
+            syncCamera(camera);
+        },
+        get y() {
+            return camera.transform.position[1];
+        },
+        set y(value) {
+            camera.transform.setPosition(camera.transform.position[0], value, camera.transform.position[2]);
+            syncCamera(camera);
+        },
+        get z() {
+            return camera.transform.position[2];
+        },
+        set z(value) {
+            camera.transform.setPosition(camera.transform.position[0], camera.transform.position[1], value);
+            syncCamera(camera);
+        }
+    };
+    const rotation = {
+        get x() {
+            return euler.x;
+        },
+        set x(value) {
+            euler.x = value;
+            applyEuler(camera, euler);
+        },
+        get y() {
+            return euler.y;
+        },
+        set y(value) {
+            euler.y = value;
+            applyEuler(camera, euler);
+        },
+        get z() {
+            return euler.z;
+        },
+        set z(value) {
+            euler.z = value;
+            applyEuler(camera, euler);
+        }
+    };
+    return {
+        camera,
+        position,
+        rotation,
+        lookAt(target) {
+            const origin = new Vector3(camera.transform.position[0], camera.transform.position[1], camera.transform.position[2]);
+            const direction = new Vector3(target.x, target.y, target.z).subtract(origin).normalize();
+            if (direction.lengthSquared() === 0)
+                return;
+            const q = Quaternion.fromUnitVectors(Vector3.forward, direction);
+            camera.transform.setRotation(q.x, q.y, q.z, q.w);
+            const nextEuler = quaternionToEuler([q.x, q.y, q.z, q.w]);
+            euler.x = nextEuler.x;
+            euler.y = nextEuler.y;
+            euler.z = nextEuler.z;
+            syncCamera(camera);
+        }
+    };
+}
+function applyEuler(camera, euler) {
+    const yaw = Quaternion.fromAxisAngle(Vector3.up, euler.y);
+    const pitch = Quaternion.fromAxisAngle(Vector3.right, euler.x);
+    const roll = Quaternion.fromAxisAngle(new Vector3(0, 0, 1), euler.z);
+    const q = yaw.multiply(pitch).multiply(roll).normalize();
+    camera.transform.setRotation(q.x, q.y, q.z, q.w);
+    syncCamera(camera);
+}
+function syncCamera(camera) {
+    camera.updateCameraMatrices();
+}
+function quaternionToEuler(rotation) {
+    const [x, y, z, w] = rotation;
+    const sinPitch = 2 * (w * x - z * y);
+    const pitch = Math.abs(sinPitch) >= 1 ? Math.sign(sinPitch) * Math.PI / 2 : Math.asin(sinPitch);
+    const yaw = Math.atan2(2 * (w * y + x * z), 1 - 2 * (x * x + y * y));
+    const roll = Math.atan2(2 * (w * z + x * y), 1 - 2 * (x * x + z * z));
+    return { x: pitch, y: yaw, z: roll };
+}
+//# sourceMappingURL=SceneCameraAdapter.js.map

package/dist/engine/SceneCameraAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneCameraAdapter.js","sourceRoot":"","sources":["../../../../../packages/controls/src/engine/SceneCameraAdapter.ts"],"names":[],"mappings":"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"}

package/dist/engine/ThirdPersonFollowControls.d.ts

@@ -0,0 +1,20 @@
+import { type CameraTransformLike, type Vec3Like } from "./ControlTypes.js";
+export interface ThirdPersonFollowControlsOptions {
+    readonly offset?: Vec3Like;
+    readonly damping?: number;
+}
+export declare class ThirdPersonFollowControls {
+    private readonly camera;
+    enabled: boolean;
+    target?: {
+        readonly position: Vec3Like;
+    };
+    readonly offset: Vec3Like;
+    damping: number;
+    constructor(camera: CameraTransformLike, target?: {
+        readonly position: Vec3Like;
+    }, options?: ThirdPersonFollowControlsOptions);
+    update(deltaSeconds: number): void;
+    dispose(): void;
+}
+//# sourceMappingURL=ThirdPersonFollowControls.d.ts.map

package/dist/engine/ThirdPersonFollowControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThirdPersonFollowControls.d.ts","sourceRoot":"","sources":["../../../../../packages/controls/src/engine/ThirdPersonFollowControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,yBAAyB;IAOlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,UAAQ;IACf,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;gBAGG,MAAM,EAAE,mBAAmB,EAC5C,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,EACxC,OAAO,GAAE,gCAAqC;IAOhD,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAclC,OAAO,IAAI,IAAI;CAIhB"}