@tonybfox/threejs-tools 1.0.5 → 1.0.7

package/dist/chunk-XA7OKYSM.mjs

@@ -1,357 +0,0 @@
-// packages/camera/src/DualCameraControls.ts
-import * as THREE from "three";
-import CameraControls from "camera-controls";
-var controlsInstalled = false;
-var tempVec3A = new THREE.Vector3();
-var tempVec3B = new THREE.Vector3();
-var tempVec2 = new THREE.Vector2();
-function ensureCameraControlsInstalled() {
-  if (!controlsInstalled) {
-    CameraControls.install({ THREE });
-    controlsInstalled = true;
-  }
-}
-function toVector3(value, fallback, target) {
-  if (!value) {
-    target.set(fallback[0], fallback[1], fallback[2]);
-    return target;
-  }
-  if (Array.isArray(value)) {
-    target.set(value[0], value[1], value[2]);
-    return target;
-  }
-  target.copy(value);
-  return target;
-}
-var DualCameraControls = class extends CameraControls {
-  constructor(renderer, options = {}) {
-    ensureCameraControlsInstalled();
-    const { domElement = renderer.domElement } = options;
-    const aspect = resolveAspect(renderer, domElement);
-    const perspectiveConfig = options.perspective ?? {};
-    const orthographicConfig = options.orthographic ?? {};
-    const perspectiveCamera = new THREE.PerspectiveCamera(
-      perspectiveConfig.fov ?? 60,
-      aspect,
-      perspectiveConfig.near ?? 0.1,
-      perspectiveConfig.far ?? 2e3
-    );
-    perspectiveCamera.position.copy(
-      toVector3(perspectiveConfig.position, [12, 12, 12], new THREE.Vector3())
-    );
-    if (perspectiveConfig.zoom !== void 0) {
-      perspectiveCamera.zoom = perspectiveConfig.zoom;
-      perspectiveCamera.updateProjectionMatrix();
-    }
-    const orthoHalfHeight = Math.max(orthographicConfig.size ?? 20, 1e-3) * 0.5;
-    const orthoHalfWidth = orthoHalfHeight * aspect;
-    const orthographicCamera = new THREE.OrthographicCamera(
-      -orthoHalfWidth,
-      orthoHalfWidth,
-      orthoHalfHeight,
-      -orthoHalfHeight,
-      orthographicConfig.near ?? 0.1,
-      orthographicConfig.far ?? 2e3
-    );
-    orthographicCamera.position.copy(
-      toVector3(orthographicConfig.position, [12, 12, 12], new THREE.Vector3())
-    );
-    if (orthographicConfig.zoom !== void 0) {
-      orthographicCamera.zoom = orthographicConfig.zoom;
-      orthographicCamera.updateProjectionMatrix();
-    }
-    const initialMode = options.initialMode ?? "perspective";
-    const initialCamera = initialMode === "orthographic" ? orthographicCamera : perspectiveCamera;
-    super(initialCamera, domElement);
-    this.updateClock = new THREE.Clock();
-    this.externalCamera = null;
-    const initialTarget = toVector3(
-      options.initialTarget,
-      [0, 0, 0],
-      new THREE.Vector3()
-    );
-    void this.setLookAt(
-      initialCamera.position.x,
-      initialCamera.position.y,
-      initialCamera.position.z,
-      initialTarget.x,
-      initialTarget.y,
-      initialTarget.z,
-      false
-    );
-    this.renderer = renderer;
-    this.domElementRef = domElement;
-    this.perspectiveCamera = perspectiveCamera;
-    this.orthographicCamera = orthographicCamera;
-    this.activeMode = initialMode;
-    this.minOrthoHalfHeight = orthoHalfHeight;
-    this.updateInputBindingsForMode(initialMode);
-  }
-  get mode() {
-    return this.activeMode;
-  }
-  /**
-   * Returns the currently active camera instance.
-   */
-  get activeCamera() {
-    return this.camera;
-  }
-  /**
-   * Switch to the perspective camera while keeping the current framing.
-   */
-  switchToPerspective(enableTransition = false) {
-    if (this.activeMode === "perspective" && !this.externalCamera) {
-      return;
-    }
-    this.externalCamera = null;
-    const target = this.getTarget(tempVec3A);
-    const position = this.getPosition(tempVec3B);
-    const aspect = resolveAspect(this.renderer, this.domElementRef);
-    this.perspectiveCamera.aspect = aspect;
-    this.perspectiveCamera.position.copy(position);
-    this.perspectiveCamera.quaternion.copy(this.camera.quaternion);
-    this.perspectiveCamera.up.copy(this.camera.up);
-    this.perspectiveCamera.updateProjectionMatrix();
-    this.camera = this.perspectiveCamera;
-    this.activeMode = "perspective";
-    this.updateInputBindingsForMode("perspective");
-    void this.setLookAt(
-      position.x,
-      position.y,
-      position.z,
-      target.x,
-      target.y,
-      target.z,
-      enableTransition
-    );
-    this.dispatchEvent({
-      type: "modechange",
-      mode: this.activeMode,
-      previousMode: "orthographic",
-      camera: this.perspectiveCamera
-    });
-  }
-  /**
-   * Switch to the orthographic camera while keeping the current framing.
-   */
-  switchToOrthographic(enableTransition = false) {
-    if (this.activeMode === "orthographic" && !this.externalCamera) {
-      return;
-    }
-    this.externalCamera = null;
-    const target = this.getTarget(tempVec3A);
-    const position = this.getPosition(tempVec3B);
-    const aspect = resolveAspect(this.renderer, this.domElementRef);
-    this.updateOrthographicFrustum(position, target, aspect);
-    this.orthographicCamera.position.copy(position);
-    this.orthographicCamera.quaternion.copy(this.camera.quaternion);
-    this.orthographicCamera.up.copy(this.camera.up);
-    this.orthographicCamera.updateProjectionMatrix();
-    this.camera = this.orthographicCamera;
-    this.activeMode = "orthographic";
-    this.updateInputBindingsForMode("orthographic");
-    void this.setLookAt(
-      position.x,
-      position.y,
-      position.z,
-      target.x,
-      target.y,
-      target.z,
-      enableTransition
-    );
-    this.dispatchEvent({
-      type: "modechange",
-      mode: this.activeMode,
-      previousMode: "perspective",
-      camera: this.orthographicCamera
-    });
-  }
-  /**
-   * Toggles between perspective and orthographic camera modes.
-   */
-  toggleCameraMode(enableTransition = false) {
-    if (this.activeMode === "perspective") {
-      this.switchToOrthographic(enableTransition);
-    } else {
-      this.switchToPerspective(enableTransition);
-    }
-  }
-  /**
-   * Returns true if currently using an external camera.
-   */
-  get isUsingExternalCamera() {
-    return this.externalCamera !== null;
-  }
-  /**
-   * Sets an external camera to use with the controls.
-   * This allows using a camera created outside of DualCameraControls.
-   * Call `clearExternalCamera()` to return to the internal cameras.
-   */
-  setCamera(camera, target, enableTransition = false) {
-    const previousCamera = this.camera;
-    this.externalCamera = camera;
-    const aspect = resolveAspect(this.renderer, this.domElementRef);
-    if (camera.type === "PerspectiveCamera") {
-      ;
-      camera.aspect = aspect;
-      camera.updateProjectionMatrix();
-    } else if (camera.type === "OrthographicCamera") {
-      const ortho = camera;
-      const currentHeight = (ortho.top - ortho.bottom) * 0.5;
-      const newHalfWidth = currentHeight * aspect;
-      ortho.left = -newHalfWidth;
-      ortho.right = newHalfWidth;
-      ortho.updateProjectionMatrix();
-    }
-    this.camera = camera;
-    const mode = camera.type === "PerspectiveCamera" ? "perspective" : "orthographic";
-    this.activeMode = mode;
-    this.updateInputBindingsForMode(mode);
-    const targetVec = toVector3(target, [0, 0, 0], tempVec3A);
-    void this.setLookAt(
-      camera.position.x,
-      camera.position.y,
-      camera.position.z,
-      targetVec.x,
-      targetVec.y,
-      targetVec.z,
-      enableTransition
-    );
-    this.dispatchEvent({
-      type: "externalcamerachange",
-      camera,
-      previousCamera
-    });
-  }
-  /**
-   * Clears the external camera and returns to using the internal cameras.
-   * Will switch to the camera matching the current mode.
-   */
-  clearExternalCamera(enableTransition = false) {
-    if (!this.externalCamera) {
-      return;
-    }
-    const target = this.getTarget(tempVec3A);
-    const position = this.getPosition(tempVec3B);
-    this.externalCamera = null;
-    const internalCamera = this.activeMode === "orthographic" ? this.orthographicCamera : this.perspectiveCamera;
-    internalCamera.position.copy(position);
-    internalCamera.quaternion.copy(this.camera.quaternion);
-    internalCamera.up.copy(this.camera.up);
-    const aspect = resolveAspect(this.renderer, this.domElementRef);
-    if (this.activeMode === "orthographic") {
-      this.updateOrthographicFrustum(position, target, aspect);
-    } else {
-      this.perspectiveCamera.aspect = aspect;
-      this.perspectiveCamera.updateProjectionMatrix();
-    }
-    this.camera = internalCamera;
-    void this.setLookAt(
-      position.x,
-      position.y,
-      position.z,
-      target.x,
-      target.y,
-      target.z,
-      enableTransition
-    );
-    this.dispatchEvent({
-      type: "modechange",
-      mode: this.activeMode,
-      previousMode: this.activeMode,
-      camera: internalCamera
-    });
-  }
-  /**
-   * Update camera projection parameters when the viewport size changes.
-   */
-  handleResize(width, height) {
-    const aspect = height === 0 ? 1 : width / height;
-    this.perspectiveCamera.aspect = aspect;
-    this.perspectiveCamera.updateProjectionMatrix();
-    const target = this.getTarget(tempVec3A);
-    const position = this.getPosition(tempVec3B);
-    this.updateOrthographicFrustum(position, target, aspect);
-    if (this.activeMode === "orthographic") {
-      this.camera = this.orthographicCamera;
-      void this.setLookAt(
-        position.x,
-        position.y,
-        position.z,
-        target.x,
-        target.y,
-        target.z,
-        false
-      );
-    }
-  }
-  /**
-   * Moves the camera to a new position and target.
-   */
-  moveCamera(position, target, enableTransition = true) {
-    toVector3(position, [0, 0, 0], tempVec3A);
-    toVector3(target, [0, 0, 0], tempVec3B);
-    return this.setLookAt(
-      tempVec3A.x,
-      tempVec3A.y,
-      tempVec3A.z,
-      tempVec3B.x,
-      tempVec3B.y,
-      tempVec3B.z,
-      enableTransition
-    );
-  }
-  /**
-   * Updates the controls using an internally managed clock.
-   * Useful when you don't want to pass delta time each frame.
-   */
-  updateDelta() {
-    const delta = this.updateClock.getDelta();
-    return super.update(delta);
-  }
-  updateInputBindingsForMode(mode) {
-    const { ACTION } = CameraControls;
-    if (mode === "orthographic") {
-      this.mouseButtons.left = ACTION.TRUCK;
-      this.mouseButtons.right = ACTION.ROTATE;
-      this.mouseButtons.wheel = ACTION.ZOOM;
-      this.touches.one = ACTION.TOUCH_TRUCK;
-      this.touches.two = ACTION.TOUCH_ZOOM_TRUCK;
-    } else {
-      this.mouseButtons.left = ACTION.ROTATE;
-      this.mouseButtons.right = ACTION.TRUCK;
-      this.mouseButtons.wheel = ACTION.DOLLY;
-      this.touches.one = ACTION.TOUCH_ROTATE;
-      this.touches.two = ACTION.TOUCH_DOLLY_TRUCK;
-    }
-  }
-  updateOrthographicFrustum(position, target, aspect) {
-    const distance = Math.max(position.distanceTo(target), 1e-3);
-    const fov = this.perspectiveCamera.fov;
-    const halfHeight = Math.max(
-      distance * Math.tan(THREE.MathUtils.degToRad(fov * 0.5)),
-      this.minOrthoHalfHeight
-    );
-    const halfWidth = halfHeight * aspect;
-    this.orthographicCamera.left = -halfWidth;
-    this.orthographicCamera.right = halfWidth;
-    this.orthographicCamera.top = halfHeight;
-    this.orthographicCamera.bottom = -halfHeight;
-    this.orthographicCamera.updateProjectionMatrix();
-  }
-};
-function resolveAspect(renderer, domElement) {
-  const size = renderer.getSize(tempVec2);
-  if (size.y > 0) {
-    return size.x / size.y;
-  }
-  const { clientWidth, clientHeight } = domElement;
-  if (clientHeight > 0) {
-    return clientWidth / clientHeight;
-  }
-  return 1;
-}
-
-export {
-  DualCameraControls
-};