@needle-tools/three 0.169.12 → 0.169.13

package/types/examples/jsm/controls/OrbitControls.d.ts

@@ -0,0 +1,251 @@
+import { Camera, Controls, MOUSE, TOUCH, Vector3 } from "three";
+
+export interface OrbitControlsEventMap {
+    /**
+     * Fires when the camera has been transformed by the controls.
+     */
+    change: {};
+
+    /**
+     * Fires when an interaction was initiated.
+     */
+    start: {};
+
+    /**
+     * Fires when an interaction has finished.
+     */
+    end: {};
+}
+
+/**
+ * Orbit controls allow the camera to orbit around a target.
+ */
+declare class OrbitControls extends Controls<OrbitControlsEventMap> {
+    /**
+     * The focus point of the controls, the {@link .object} orbits around this. It can be updated manually at any point
+     * to change the focus of the controls.
+     */
+    target: Vector3;
+
+    /**
+     * The focus point of the {@link .minTargetRadius} and {@link .maxTargetRadius} limits. It can be updated manually
+     * at any point to change the center of interest for the {@link .target}.
+     */
+    cursor: Vector3;
+
+    /**
+     * How far you can dolly in ( {@link PerspectiveCamera} only ). Default is 0.
+     */
+    minDistance: number;
+
+    /**
+     * How far you can dolly out ( {@link PerspectiveCamera} only ). Default is Infinity.
+     */
+    maxDistance: number;
+
+    /**
+     * How far you can zoom in ( {@link OrthographicCamera} only ). Default is 0.
+     */
+    minZoom: number;
+
+    /**
+     * How far you can zoom out ( {@link OrthographicCamera} only ). Default is Infinity.
+     */
+    maxZoom: number;
+
+    /**
+     * How close you can get the target to the 3D {@link .cursor}. Default is 0.
+     */
+    minTargetRadius: number;
+
+    /**
+     * How far you can move the target from the 3D {@link .cursor}. Default is Infinity.
+     */
+    maxTargetRadius: number;
+
+    /**
+     * How far you can orbit vertically, lower limit. Range is 0 to Math.PI radians, and default is 0.
+     */
+    minPolarAngle: number;
+
+    /**
+     * How far you can orbit vertically, upper limit. Range is 0 to Math.PI radians, and default is Math.PI.
+     */
+    maxPolarAngle: number;
+
+    /**
+     * How far you can orbit horizontally, lower limit. If set, the interval [ min, max ] must be a sub-interval of
+     * [ - 2 PI, 2 PI ], with ( max - min < 2 PI ). Default is Infinity.
+     */
+    minAzimuthAngle: number;
+
+    /**
+     * How far you can orbit horizontally, upper limit. If set, the interval [ min, max ] must be a sub-interval of
+     * [ - 2 PI, 2 PI ], with ( max - min < 2 PI ). Default is Infinity.
+     */
+    maxAzimuthAngle: number;
+
+    /**
+     * Set to true to enable damping (inertia), which can be used to give a sense of weight to the controls. Default is
+     * false.
+     * Note that if this is enabled, you must call {@link .update}() in your animation loop.
+     */
+    enableDamping: boolean;
+
+    /**
+     * The damping inertia used if .enableDamping is set to true. Default is `0.05`.
+     * Note that for this to work, you must call {@link .update}() in your animation loop.
+     */
+    dampingFactor: number;
+
+    /**
+     * Enable or disable zooming (dollying) of the camera.
+     */
+    enableZoom: boolean;
+
+    /**
+     * Speed of zooming / dollying. Default is 1.
+     */
+    zoomSpeed: number;
+
+    /**
+     * Enable or disable horizontal and vertical rotation of the camera. Default is true.
+     * Note that it is possible to disable a single axis by setting the min and max of the
+     * [polar angle]{@link .minPolarAngle} or [azimuth angle]{@link .minAzimuthAngle} to the same value, which will
+     * cause the vertical or horizontal rotation to be fixed at that value.
+     */
+    enableRotate: boolean;
+
+    /**
+     * Speed of rotation. Default is 1.
+     */
+    rotateSpeed: number;
+
+    /**
+     * Enable or disable camera panning. Default is true.
+     */
+    enablePan: boolean;
+
+    /**
+     * Speed of panning. Default is 1.
+     */
+    panSpeed: number;
+
+    /**
+     * Defines how the camera's position is translated when panning. If true, the camera pans in screen space.
+     * Otherwise, the camera pans in the plane orthogonal to the camera's up direction. Default is `true`.
+     */
+    screenSpacePanning: boolean;
+
+    /**
+     * How fast to pan the camera when the keyboard is used. Default is 7.0 pixels per keypress.
+     */
+    keyPanSpeed: number;
+
+    /**
+     * Setting this property to `true` allows to zoom to the cursor's position. Default is `false`.
+     */
+    zoomToCursor: boolean;
+
+    /**
+     * Set to true to automatically rotate around the target.
+     * Note that if this is enabled, you must call {@link .update}() in your animation loop. If you want the auto-rotate speed
+     * to be independent of the frame rate (the refresh rate of the display), you must pass the time `deltaTime`, in
+     * seconds, to {@link .update}().
+     */
+    autoRotate: boolean;
+
+    /**
+     * How fast to rotate around the target if {@link .autoRotate} is true. Default is 2.0, which equates to 30 seconds
+     * per orbit at 60fps.
+     * Note that if {@link .autoRotate} is enabled, you must call {@link .update}() in your animation loop.
+     */
+    autoRotateSpeed: number;
+
+    /**
+     * This object contains references to the keycodes for controlling camera panning. Default is the 4 arrow keys.
+     */
+    keys: { LEFT: string; UP: string; RIGHT: string; BOTTOM: string };
+
+    /**
+     * This object contains references to the mouse actions used by the controls.
+     */
+    mouseButtons: {
+        LEFT?: MOUSE | null | undefined;
+        MIDDLE?: MOUSE | null | undefined;
+        RIGHT?: MOUSE | null | undefined;
+    };
+
+    /**
+     * This object contains references to the touch actions used by the controls.
+     */
+    touches: { ONE?: TOUCH | null | undefined; TWO?: TOUCH | null | undefined };
+
+    /**
+     * Used internally by the {@link .saveState} and {@link .reset} methods.
+     */
+    target0: Vector3;
+
+    /**
+     * Used internally by the {@link .saveState} and {@link .reset} methods.
+     */
+    position0: Vector3;
+
+    /**
+     * Used internally by the {@link .saveState} and {@link .reset} methods.
+     */
+    zoom0: number;
+
+    /**
+     * @param object The camera to be controlled. The camera must not be a child of another object, unless that object
+     * is the scene itself.
+     * @param domElement The HTML element used for event listeners. (optional)
+     */
+    constructor(object: Camera, domElement?: HTMLElement | null);
+
+    /**
+     * Get the current vertical rotation, in radians.
+     */
+    getPolarAngle(): number;
+
+    /**
+     * Get the current horizontal rotation, in radians.
+     */
+    getAzimuthalAngle(): number;
+
+    /**
+     * Returns the distance from the camera to the target.
+     */
+    getDistance(): number;
+
+    /**
+     * Adds key event listeners to the given DOM element. `window` is a recommended argument for using this method.
+     * @param domElement
+     */
+    listenToKeyEvents(domElement: HTMLElement | Window): void;
+
+    /**
+     * Removes the key event listener previously defined with {@link .listenToKeyEvents}().
+     */
+    stopListenToKeyEvents(): void;
+
+    /**
+     * Save the current state of the controls. This can later be recovered with {@link .reset}.
+     */
+    saveState(): void;
+
+    /**
+     * Reset the controls to their state from either the last time the {@link .saveState} was called, or the initial
+     * state.
+     */
+    reset(): void;
+
+    /**
+     * Update the controls. Must be called after any manual changes to the camera's transform, or in the update loop if
+     * {@link .autoRotate} or {@link .enableDamping} are set. `deltaTime`, in seconds, is optional, and is only required
+     * if you want the auto-rotate speed to be independent of the frame rate (the refresh rate of the display).
+     */
+    update(deltaTime?: number | null): boolean;
+}
+
+export { OrbitControls };

package/types/examples/jsm/controls/PointerLockControls.d.ts

@@ -0,0 +1,86 @@
+import { Camera, Controls, Vector3 } from "three";
+
+export interface PointerLockControlsEventMap {
+    /**
+     * Fires when the user moves the mouse.
+     */
+    change: {};
+
+    /**
+     * Fires when the pointer lock status is "locked" (in other words: the mouse is captured).
+     */
+    lock: {};
+
+    /**
+     * Fires when the pointer lock status is "unlocked" (in other words: the mouse is not captured anymore).
+     */
+    unlock: {};
+}
+
+/**
+ * The implementation of this class is based on the [Pointer Lock API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API}.
+ * {@link PointerLockControls} is a perfect choice for first person 3D games.
+ */
+declare class PointerLockControls extends Controls<PointerLockControlsEventMap> {
+    /**
+     * Whether or not the controls are locked.
+     */
+    isLocked: boolean;
+
+    /**
+     * Camera pitch, lower limit. Range is 0 to Math.PI radians. Default is 0.
+     */
+    minPolarAngle: number;
+
+    /**
+     * Camera pitch, upper limit. Range is 0 to Math.PI radians. Default is Math.PI.
+     */
+    maxPolarAngle: number;
+
+    /**
+     * Multiplier for how much the pointer movement influences the camera rotation. Default is 1.
+     */
+    pointerSpeed: number;
+
+    /**
+     * Creates a new instance of {@link PointerLockControls}.
+     * @param camera The camera of the rendered scene.
+     * @param domElement The HTML element used for event listeners.
+     */
+    constructor(camera: Camera, domElement?: HTMLElement | null);
+
+    /**
+     * @deprecated getObject() has been deprecated. Use controls.object instead.
+     */
+    getObject(): Camera;
+
+    /**
+     * Returns the look direction of the camera.
+     * @param v The target vector.
+     */
+    getDirection(v: Vector3): Vector3;
+
+    /**
+     * Moves the camera forward parallel to the xz-plane. Assumes camera.up is y-up.
+     * @param distance The signed distance.
+     */
+    moveForward(distance: number): void;
+
+    /**
+     * Moves the camera sidewards parallel to the xz-plane.
+     * @param distance The signed distance.
+     */
+    moveRight(distance: number): void;
+
+    /**
+     * Activates the pointer lock.
+     */
+    lock(): void;
+
+    /**
+     * Exits the pointer lock.
+     */
+    unlock(): void;
+}
+
+export { PointerLockControls };

package/types/examples/jsm/controls/TrackballControls.d.ts

@@ -0,0 +1,142 @@
+import { Camera, Controls, MOUSE, Vector3 } from "three";
+
+export interface TrackballControlsEventMap {
+    /**
+     * Fires when the camera has been transformed by the controls.
+     */
+    change: {};
+
+    /**
+     * Fires when an interaction (e.g. touch) was initiated.
+     */
+    start: {};
+
+    /**
+     * Fires when an interaction has finished.
+     */
+    end: {};
+}
+
+/**
+ * TrackballControls is similar to {@link OrbitControls}. However, it does not maintain a constant camera
+ * [up]{@link Object3D.up} vector. That means if the camera orbits over the “north” and “south” poles, it does not flip
+ * to stay "right side up".
+ */
+declare class TrackballControls extends Controls<TrackballControlsEventMap> {
+    /**
+     * Represents the properties of the screen. Automatically set when {@link .handleResize}() is called.
+     *  - left: Represents the offset in pixels to the screen's left boundary.
+     *  - top: Represents the offset in pixels to the screen's top boundary.
+     *  - width: Represents the screen width in pixels.
+     *  - height: Represents the screen height in pixels.
+     */
+    screen: { left: number; top: number; width: number; height: number };
+
+    /**
+     * The rotation speed. Default is `1.0`.
+     */
+    rotateSpeed: number;
+
+    /**
+     * The zoom speed. Default is `1.2`.
+     */
+    zoomSpeed: number;
+
+    /**
+     * The pan speed. Default is `0.3`.
+     */
+    panSpeed: number;
+
+    /**
+     * Whether or not rotation is disabled. Default is `false`.
+     */
+    noRotate: boolean;
+
+    /**
+     * Whether or not zooming is disabled. Default is `false`.
+     */
+    noZoom: boolean;
+
+    /**
+     * Whether or not panning is disabled. Default is `false`.
+     */
+    noPan: boolean;
+
+    /**
+     * Whether or not damping is disabled. Default is `false`.
+     */
+    staticMoving: boolean;
+
+    /**
+     * Defines the intensity of damping. Only considered if {@link .staticMoving} is set to `false`. Default is `0.2`.
+     */
+    dynamicDampingFactor: number;
+
+    /**
+     * How far you can dolly in ( {@link PerspectiveCamera} only ). Default is *0*.
+     */
+    minDistance: number;
+
+    /**
+     * How far you can dolly out ( {@link PerspectiveCamera} only ). Default is `Infinity`.
+     */
+    maxDistance: number;
+
+    /**
+     * How far you can zoom out ( {@link OrthographicCamera} only ). Default is `Infinity`.
+     */
+    minZoom: number;
+
+    /**
+     * How far you can zoom in ( {@link OrthographicCamera} only ). Default is *0*.
+     */
+    maxZoom: number;
+
+    /**
+     * This array holds keycodes for controlling interactions.
+     *  - When the first defined key is pressed, all mouse interactions (left, middle, right) performs orbiting.
+     *  - When the second defined key is pressed, all mouse interactions (left, middle, right) performs zooming.
+     *  - When the third defined key is pressed, all mouse interactions (left, middle, right) performs panning.
+     *
+     * Default is *KeyA, KeyS, KeyD* which represents A, S, D.
+     */
+    keys: [string, string, string];
+
+    /**
+     * This object contains references to the mouse actions used by the controls.
+     *  - .LEFT is assigned with `THREE.MOUSE.ROTATE`
+     *  - .MIDDLE is assigned with `THREE.MOUSE.ZOOM`
+     *  - .RIGHT is assigned with `THREE.MOUSE.PAN`
+     */
+    mouseButtons: {
+        LEFT?: MOUSE | null | undefined;
+        MIDDLE?: MOUSE | null | undefined;
+        RIGHT?: MOUSE | null | undefined;
+    };
+
+    /**
+     * The focus point of the controls.
+     */
+    target: Vector3;
+
+    /**
+     * Creates a new instance of TrackballControls.
+     * @param camera The camera of the rendered scene.
+     * @param domElement The HTML element used for event listeners. (optional)
+     */
+    constructor(camera: Camera, domElement?: HTMLElement | null);
+
+    /**
+     * Should be called if the application window is resized.
+     */
+    handleResize(): void;
+
+    update(): void;
+
+    /**
+     * Resets the controls to its initial state.
+     */
+    reset(): void;
+}
+
+export { TrackballControls };