1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861 |
- import {
- Controls,
- MOUSE,
- Quaternion,
- Spherical,
- TOUCH,
- Vector2,
- Vector3,
- Plane,
- Ray,
- MathUtils
- } from 'three';
- /**
- * Fires when the camera has been transformed by the controls.
- *
- * @event OrbitControls#change
- * @type {Object}
- */
- const _changeEvent = { type: 'change' };
- /**
- * Fires when an interaction was initiated.
- *
- * @event OrbitControls#start
- * @type {Object}
- */
- const _startEvent = { type: 'start' };
- /**
- * Fires when an interaction has finished.
- *
- * @event OrbitControls#end
- * @type {Object}
- */
- const _endEvent = { type: 'end' };
- const _ray = new Ray();
- const _plane = new Plane();
- const _TILT_LIMIT = Math.cos( 70 * MathUtils.DEG2RAD );
- const _v = new Vector3();
- const _twoPI = 2 * Math.PI;
- const _STATE = {
- NONE: - 1,
- ROTATE: 0,
- DOLLY: 1,
- PAN: 2,
- TOUCH_ROTATE: 3,
- TOUCH_PAN: 4,
- TOUCH_DOLLY_PAN: 5,
- TOUCH_DOLLY_ROTATE: 6
- };
- const _EPS = 0.000001;
- /**
- * Orbit controls allow the camera to orbit around a target.
- *
- * OrbitControls performs orbiting, dollying (zooming), and panning. Unlike {@link TrackballControls},
- * it maintains the "up" direction `object.up` (+Y by default).
- *
- * - Orbit: Left mouse / touch: one-finger move.
- * - Zoom: Middle mouse, or mousewheel / touch: two-finger spread or squish.
- * - Pan: Right mouse, or left mouse + ctrl/meta/shiftKey, or arrow keys / touch: two-finger move.
- *
- * ```js
- * const controls = new OrbitControls( camera, renderer.domElement );
- *
- * // controls.update() must be called after any manual changes to the camera's transform
- * camera.position.set( 0, 20, 100 );
- * controls.update();
- *
- * function animate() {
- *
- * // required if controls.enableDamping or controls.autoRotate are set to true
- * controls.update();
- *
- * renderer.render( scene, camera );
- *
- * }
- * ```
- *
- * @augments Controls
- * @three_import import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
- */
- class OrbitControls extends Controls {
- /**
- * Constructs a new controls instance.
- *
- * @param {Object3D} object - The object that is managed by the controls.
- * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.
- */
- constructor( object, domElement = null ) {
- super( object, domElement );
- this.state = _STATE.NONE;
- /**
- * The focus point of the controls, the `object` orbits around this.
- * It can be updated manually at any point to change the focus of the controls.
- *
- * @type {Vector3}
- */
- this.target = new Vector3();
- /**
- * The focus point of the `minTargetRadius` and `maxTargetRadius` limits.
- * It can be updated manually at any point to change the center of interest
- * for the `target`.
- *
- * @type {Vector3}
- */
- this.cursor = new Vector3();
- /**
- * How far you can dolly in (perspective camera only).
- *
- * @type {number}
- * @default 0
- */
- this.minDistance = 0;
- /**
- * How far you can dolly out (perspective camera only).
- *
- * @type {number}
- * @default Infinity
- */
- this.maxDistance = Infinity;
- /**
- * How far you can zoom in (orthographic camera only).
- *
- * @type {number}
- * @default 0
- */
- this.minZoom = 0;
- /**
- * How far you can zoom out (orthographic camera only).
- *
- * @type {number}
- * @default Infinity
- */
- this.maxZoom = Infinity;
- /**
- * How close you can get the target to the 3D `cursor`.
- *
- * @type {number}
- * @default 0
- */
- this.minTargetRadius = 0;
- /**
- * How far you can move the target from the 3D `cursor`.
- *
- * @type {number}
- * @default Infinity
- */
- this.maxTargetRadius = Infinity;
- /**
- * How far you can orbit vertically, lower limit. Range is `[0, Math.PI]` radians.
- *
- * @type {number}
- * @default 0
- */
- this.minPolarAngle = 0;
- /**
- * How far you can orbit vertically, upper limit. Range is `[0, Math.PI]` radians.
- *
- * @type {number}
- * @default Math.PI
- */
- this.maxPolarAngle = Math.PI;
- /**
- * 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 )`.
- *
- * @type {number}
- * @default -Infinity
- */
- this.minAzimuthAngle = - Infinity;
- /**
- * 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 )`.
- *
- * @type {number}
- * @default -Infinity
- */
- this.maxAzimuthAngle = Infinity;
- /**
- * Set to `true` to enable damping (inertia), which can be used to give a sense of weight
- * to the controls. Note that if this is enabled, you must call `update()` in your animation
- * loop.
- *
- * @type {boolean}
- * @default false
- */
- this.enableDamping = false;
- /**
- * The damping inertia used if `enableDamping` is set to `true`.
- *
- * Note that for this to work, you must call `update()` in your animation loop.
- *
- * @type {number}
- * @default 0.05
- */
- this.dampingFactor = 0.05;
- /**
- * Enable or disable zooming (dollying) of the camera.
- *
- * @type {boolean}
- * @default true
- */
- this.enableZoom = true;
- /**
- * Speed of zooming / dollying.
- *
- * @type {number}
- * @default 1
- */
- this.zoomSpeed = 1.0;
- /**
- * Enable or disable horizontal and vertical rotation of the camera.
- *
- * Note that it is possible to disable a single axis by setting the min and max of the
- * `minPolarAngle` or `minAzimuthAngle` to the same value, which will cause the vertical
- * or horizontal rotation to be fixed at that value.
- *
- * @type {boolean}
- * @default true
- */
- this.enableRotate = true;
- /**
- * Speed of rotation.
- *
- * @type {number}
- * @default 1
- */
- this.rotateSpeed = 1.0;
- /**
- * How fast to rotate the camera when the keyboard is used.
- *
- * @type {number}
- * @default 1
- */
- this.keyRotateSpeed = 1.0;
- /**
- * Enable or disable camera panning.
- *
- * @type {boolean}
- * @default true
- */
- this.enablePan = true;
- /**
- * Speed of panning.
- *
- * @type {number}
- * @default 1
- */
- this.panSpeed = 1.0;
- /**
- * 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.
- *
- * @type {boolean}
- * @default true
- */
- this.screenSpacePanning = true;
- /**
- * How fast to pan the camera when the keyboard is used in
- * pixels per keypress.
- *
- * @type {number}
- * @default 7
- */
- this.keyPanSpeed = 7.0;
- /**
- * Setting this property to `true` allows to zoom to the cursor's position.
- *
- * @type {boolean}
- * @default false
- */
- this.zoomToCursor = false;
- /**
- * Set to true to automatically rotate around the target
- *
- * Note that if this is enabled, you must call `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 `update()`.
- *
- * @type {boolean}
- * @default false
- */
- this.autoRotate = false;
- /**
- * How fast to rotate around the target if `autoRotate` is `true`. The default equates to 30 seconds
- * per orbit at 60fps.
- *
- * Note that if `autoRotate` is enabled, you must call `update()` in your animation loop.
- *
- * @type {number}
- * @default 2
- */
- this.autoRotateSpeed = 2.0;
- /**
- * This object contains references to the keycodes for controlling camera panning.
- *
- * ```js
- * controls.keys = {
- * LEFT: 'ArrowLeft', //left arrow
- * UP: 'ArrowUp', // up arrow
- * RIGHT: 'ArrowRight', // right arrow
- * BOTTOM: 'ArrowDown' // down arrow
- * }
- * ```
- * @type {Object}
- */
- this.keys = { LEFT: 'ArrowLeft', UP: 'ArrowUp', RIGHT: 'ArrowRight', BOTTOM: 'ArrowDown' };
- /**
- * This object contains references to the mouse actions used by the controls.
- *
- * ```js
- * controls.mouseButtons = {
- * LEFT: THREE.MOUSE.ROTATE,
- * MIDDLE: THREE.MOUSE.DOLLY,
- * RIGHT: THREE.MOUSE.PAN
- * }
- * ```
- * @type {Object}
- */
- this.mouseButtons = { LEFT: MOUSE.ROTATE, MIDDLE: MOUSE.DOLLY, RIGHT: MOUSE.PAN };
- /**
- * This object contains references to the touch actions used by the controls.
- *
- * ```js
- * controls.mouseButtons = {
- * ONE: THREE.TOUCH.ROTATE,
- * TWO: THREE.TOUCH.DOLLY_PAN
- * }
- * ```
- * @type {Object}
- */
- this.touches = { ONE: TOUCH.ROTATE, TWO: TOUCH.DOLLY_PAN };
- /**
- * Used internally by `saveState()` and `reset()`.
- *
- * @type {Vector3}
- */
- this.target0 = this.target.clone();
- /**
- * Used internally by `saveState()` and `reset()`.
- *
- * @type {Vector3}
- */
- this.position0 = this.object.position.clone();
- /**
- * Used internally by `saveState()` and `reset()`.
- *
- * @type {number}
- */
- this.zoom0 = this.object.zoom;
- // the target DOM element for key events
- this._domElementKeyEvents = null;
- // internals
- this._lastPosition = new Vector3();
- this._lastQuaternion = new Quaternion();
- this._lastTargetPosition = new Vector3();
- // so camera.up is the orbit axis
- this._quat = new Quaternion().setFromUnitVectors( object.up, new Vector3( 0, 1, 0 ) );
- this._quatInverse = this._quat.clone().invert();
- // current position in spherical coordinates
- this._spherical = new Spherical();
- this._sphericalDelta = new Spherical();
- this._scale = 1;
- this._panOffset = new Vector3();
- this._rotateStart = new Vector2();
- this._rotateEnd = new Vector2();
- this._rotateDelta = new Vector2();
- this._panStart = new Vector2();
- this._panEnd = new Vector2();
- this._panDelta = new Vector2();
- this._dollyStart = new Vector2();
- this._dollyEnd = new Vector2();
- this._dollyDelta = new Vector2();
- this._dollyDirection = new Vector3();
- this._mouse = new Vector2();
- this._performCursorZoom = false;
- this._pointers = [];
- this._pointerPositions = {};
- this._controlActive = false;
- // event listeners
- this._onPointerMove = onPointerMove.bind( this );
- this._onPointerDown = onPointerDown.bind( this );
- this._onPointerUp = onPointerUp.bind( this );
- this._onContextMenu = onContextMenu.bind( this );
- this._onMouseWheel = onMouseWheel.bind( this );
- this._onKeyDown = onKeyDown.bind( this );
- this._onTouchStart = onTouchStart.bind( this );
- this._onTouchMove = onTouchMove.bind( this );
- this._onMouseDown = onMouseDown.bind( this );
- this._onMouseMove = onMouseMove.bind( this );
- this._interceptControlDown = interceptControlDown.bind( this );
- this._interceptControlUp = interceptControlUp.bind( this );
- //
- if ( this.domElement !== null ) {
- this.connect( this.domElement );
- }
- this.update();
- }
- connect( element ) {
- super.connect( element );
- this.domElement.addEventListener( 'pointerdown', this._onPointerDown );
- this.domElement.addEventListener( 'pointercancel', this._onPointerUp );
- this.domElement.addEventListener( 'contextmenu', this._onContextMenu );
- this.domElement.addEventListener( 'wheel', this._onMouseWheel, { passive: false } );
- const document = this.domElement.getRootNode(); // offscreen canvas compatibility
- document.addEventListener( 'keydown', this._interceptControlDown, { passive: true, capture: true } );
- this.domElement.style.touchAction = 'none'; // disable touch scroll
- }
- disconnect() {
- this.domElement.removeEventListener( 'pointerdown', this._onPointerDown );
- this.domElement.removeEventListener( 'pointermove', this._onPointerMove );
- this.domElement.removeEventListener( 'pointerup', this._onPointerUp );
- this.domElement.removeEventListener( 'pointercancel', this._onPointerUp );
- this.domElement.removeEventListener( 'wheel', this._onMouseWheel );
- this.domElement.removeEventListener( 'contextmenu', this._onContextMenu );
- this.stopListenToKeyEvents();
- const document = this.domElement.getRootNode(); // offscreen canvas compatibility
- document.removeEventListener( 'keydown', this._interceptControlDown, { capture: true } );
- this.domElement.style.touchAction = 'auto';
- }
- dispose() {
- this.disconnect();
- }
- /**
- * Get the current vertical rotation, in radians.
- *
- * @return {number} The current vertical rotation, in radians.
- */
- getPolarAngle() {
- return this._spherical.phi;
- }
- /**
- * Get the current horizontal rotation, in radians.
- *
- * @return {number} The current horizontal rotation, in radians.
- */
- getAzimuthalAngle() {
- return this._spherical.theta;
- }
- /**
- * Returns the distance from the camera to the target.
- *
- * @return {number} The distance from the camera to the target.
- */
- getDistance() {
- return this.object.position.distanceTo( this.target );
- }
- /**
- * Adds key event listeners to the given DOM element.
- * `window` is a recommended argument for using this method.
- *
- * @param {HTMLDOMElement} domElement - The DOM element
- */
- listenToKeyEvents( domElement ) {
- domElement.addEventListener( 'keydown', this._onKeyDown );
- this._domElementKeyEvents = domElement;
- }
- /**
- * Removes the key event listener previously defined with `listenToKeyEvents()`.
- */
- stopListenToKeyEvents() {
- if ( this._domElementKeyEvents !== null ) {
- this._domElementKeyEvents.removeEventListener( 'keydown', this._onKeyDown );
- this._domElementKeyEvents = null;
- }
- }
- /**
- * Save the current state of the controls. This can later be recovered with `reset()`.
- */
- saveState() {
- this.target0.copy( this.target );
- this.position0.copy( this.object.position );
- this.zoom0 = this.object.zoom;
- }
- /**
- * Reset the controls to their state from either the last time the `saveState()`
- * was called, or the initial state.
- */
- reset() {
- this.target.copy( this.target0 );
- this.object.position.copy( this.position0 );
- this.object.zoom = this.zoom0;
- this.object.updateProjectionMatrix();
- this.dispatchEvent( _changeEvent );
- this.update();
- this.state = _STATE.NONE;
- }
- update( deltaTime = null ) {
- const position = this.object.position;
- _v.copy( position ).sub( this.target );
- // rotate offset to "y-axis-is-up" space
- _v.applyQuaternion( this._quat );
- // angle from z-axis around y-axis
- this._spherical.setFromVector3( _v );
- if ( this.autoRotate && this.state === _STATE.NONE ) {
- this._rotateLeft( this._getAutoRotationAngle( deltaTime ) );
- }
- if ( this.enableDamping ) {
- this._spherical.theta += this._sphericalDelta.theta * this.dampingFactor;
- this._spherical.phi += this._sphericalDelta.phi * this.dampingFactor;
- } else {
- this._spherical.theta += this._sphericalDelta.theta;
- this._spherical.phi += this._sphericalDelta.phi;
- }
- // restrict theta to be between desired limits
- let min = this.minAzimuthAngle;
- let max = this.maxAzimuthAngle;
- if ( isFinite( min ) && isFinite( max ) ) {
- if ( min < - Math.PI ) min += _twoPI; else if ( min > Math.PI ) min -= _twoPI;
- if ( max < - Math.PI ) max += _twoPI; else if ( max > Math.PI ) max -= _twoPI;
- if ( min <= max ) {
- this._spherical.theta = Math.max( min, Math.min( max, this._spherical.theta ) );
- } else {
- this._spherical.theta = ( this._spherical.theta > ( min + max ) / 2 ) ?
- Math.max( min, this._spherical.theta ) :
- Math.min( max, this._spherical.theta );
- }
- }
- // restrict phi to be between desired limits
- this._spherical.phi = Math.max( this.minPolarAngle, Math.min( this.maxPolarAngle, this._spherical.phi ) );
- this._spherical.makeSafe();
- // move target to panned location
- if ( this.enableDamping === true ) {
- this.target.addScaledVector( this._panOffset, this.dampingFactor );
- } else {
- this.target.add( this._panOffset );
- }
- // Limit the target distance from the cursor to create a sphere around the center of interest
- this.target.sub( this.cursor );
- this.target.clampLength( this.minTargetRadius, this.maxTargetRadius );
- this.target.add( this.cursor );
- let zoomChanged = false;
- // adjust the camera position based on zoom only if we're not zooming to the cursor or if it's an ortho camera
- // we adjust zoom later in these cases
- if ( this.zoomToCursor && this._performCursorZoom || this.object.isOrthographicCamera ) {
- this._spherical.radius = this._clampDistance( this._spherical.radius );
- } else {
- const prevRadius = this._spherical.radius;
- this._spherical.radius = this._clampDistance( this._spherical.radius * this._scale );
- zoomChanged = prevRadius != this._spherical.radius;
- }
- _v.setFromSpherical( this._spherical );
- // rotate offset back to "camera-up-vector-is-up" space
- _v.applyQuaternion( this._quatInverse );
- position.copy( this.target ).add( _v );
- this.object.lookAt( this.target );
- if ( this.enableDamping === true ) {
- this._sphericalDelta.theta *= ( 1 - this.dampingFactor );
- this._sphericalDelta.phi *= ( 1 - this.dampingFactor );
- this._panOffset.multiplyScalar( 1 - this.dampingFactor );
- } else {
- this._sphericalDelta.set( 0, 0, 0 );
- this._panOffset.set( 0, 0, 0 );
- }
- // adjust camera position
- if ( this.zoomToCursor && this._performCursorZoom ) {
- let newRadius = null;
- if ( this.object.isPerspectiveCamera ) {
- // move the camera down the pointer ray
- // this method avoids floating point error
- const prevRadius = _v.length();
- newRadius = this._clampDistance( prevRadius * this._scale );
- const radiusDelta = prevRadius - newRadius;
- this.object.position.addScaledVector( this._dollyDirection, radiusDelta );
- this.object.updateMatrixWorld();
- zoomChanged = !! radiusDelta;
- } else if ( this.object.isOrthographicCamera ) {
- // adjust the ortho camera position based on zoom changes
- const mouseBefore = new Vector3( this._mouse.x, this._mouse.y, 0 );
- mouseBefore.unproject( this.object );
- const prevZoom = this.object.zoom;
- this.object.zoom = Math.max( this.minZoom, Math.min( this.maxZoom, this.object.zoom / this._scale ) );
- this.object.updateProjectionMatrix();
- zoomChanged = prevZoom !== this.object.zoom;
- const mouseAfter = new Vector3( this._mouse.x, this._mouse.y, 0 );
- mouseAfter.unproject( this.object );
- this.object.position.sub( mouseAfter ).add( mouseBefore );
- this.object.updateMatrixWorld();
- newRadius = _v.length();
- } else {
- console.warn( 'WARNING: OrbitControls.js encountered an unknown camera type - zoom to cursor disabled.' );
- this.zoomToCursor = false;
- }
- // handle the placement of the target
- if ( newRadius !== null ) {
- if ( this.screenSpacePanning ) {
- // position the orbit target in front of the new camera position
- this.target.set( 0, 0, - 1 )
- .transformDirection( this.object.matrix )
- .multiplyScalar( newRadius )
- .add( this.object.position );
- } else {
- // get the ray and translation plane to compute target
- _ray.origin.copy( this.object.position );
- _ray.direction.set( 0, 0, - 1 ).transformDirection( this.object.matrix );
- // if the camera is 20 degrees above the horizon then don't adjust the focus target to avoid
- // extremely large values
- if ( Math.abs( this.object.up.dot( _ray.direction ) ) < _TILT_LIMIT ) {
- this.object.lookAt( this.target );
- } else {
- _plane.setFromNormalAndCoplanarPoint( this.object.up, this.target );
- _ray.intersectPlane( _plane, this.target );
- }
- }
- }
- } else if ( this.object.isOrthographicCamera ) {
- const prevZoom = this.object.zoom;
- this.object.zoom = Math.max( this.minZoom, Math.min( this.maxZoom, this.object.zoom / this._scale ) );
- if ( prevZoom !== this.object.zoom ) {
- this.object.updateProjectionMatrix();
- zoomChanged = true;
- }
- }
- this._scale = 1;
- this._performCursorZoom = false;
- // update condition is:
- // min(camera displacement, camera rotation in radians)^2 > EPS
- // using small-angle approximation cos(x/2) = 1 - x^2 / 8
- if ( zoomChanged ||
- this._lastPosition.distanceToSquared( this.object.position ) > _EPS ||
- 8 * ( 1 - this._lastQuaternion.dot( this.object.quaternion ) ) > _EPS ||
- this._lastTargetPosition.distanceToSquared( this.target ) > _EPS ) {
- this.dispatchEvent( _changeEvent );
- this._lastPosition.copy( this.object.position );
- this._lastQuaternion.copy( this.object.quaternion );
- this._lastTargetPosition.copy( this.target );
- return true;
- }
- return false;
- }
- _getAutoRotationAngle( deltaTime ) {
- if ( deltaTime !== null ) {
- return ( _twoPI / 60 * this.autoRotateSpeed ) * deltaTime;
- } else {
- return _twoPI / 60 / 60 * this.autoRotateSpeed;
- }
- }
- _getZoomScale( delta ) {
- const normalizedDelta = Math.abs( delta * 0.01 );
- return Math.pow( 0.95, this.zoomSpeed * normalizedDelta );
- }
- _rotateLeft( angle ) {
- this._sphericalDelta.theta -= angle;
- }
- _rotateUp( angle ) {
- this._sphericalDelta.phi -= angle;
- }
- _panLeft( distance, objectMatrix ) {
- _v.setFromMatrixColumn( objectMatrix, 0 ); // get X column of objectMatrix
- _v.multiplyScalar( - distance );
- this._panOffset.add( _v );
- }
- _panUp( distance, objectMatrix ) {
- if ( this.screenSpacePanning === true ) {
- _v.setFromMatrixColumn( objectMatrix, 1 );
- } else {
- _v.setFromMatrixColumn( objectMatrix, 0 );
- _v.crossVectors( this.object.up, _v );
- }
- _v.multiplyScalar( distance );
- this._panOffset.add( _v );
- }
- // deltaX and deltaY are in pixels; right and down are positive
- _pan( deltaX, deltaY ) {
- const element = this.domElement;
- if ( this.object.isPerspectiveCamera ) {
- // perspective
- const position = this.object.position;
- _v.copy( position ).sub( this.target );
- let targetDistance = _v.length();
- // half of the fov is center to top of screen
- targetDistance *= Math.tan( ( this.object.fov / 2 ) * Math.PI / 180.0 );
- // we use only clientHeight here so aspect ratio does not distort speed
- this._panLeft( 2 * deltaX * targetDistance / element.clientHeight, this.object.matrix );
- this._panUp( 2 * deltaY * targetDistance / element.clientHeight, this.object.matrix );
- } else if ( this.object.isOrthographicCamera ) {
- // orthographic
- this._panLeft( deltaX * ( this.object.right - this.object.left ) / this.object.zoom / element.clientWidth, this.object.matrix );
- this._panUp( deltaY * ( this.object.top - this.object.bottom ) / this.object.zoom / element.clientHeight, this.object.matrix );
- } else {
- // camera neither orthographic nor perspective
- console.warn( 'WARNING: OrbitControls.js encountered an unknown camera type - pan disabled.' );
- this.enablePan = false;
- }
- }
- _dollyOut( dollyScale ) {
- if ( this.object.isPerspectiveCamera || this.object.isOrthographicCamera ) {
- this._scale /= dollyScale;
- } else {
- console.warn( 'WARNING: OrbitControls.js encountered an unknown camera type - dolly/zoom disabled.' );
- this.enableZoom = false;
- }
- }
- _dollyIn( dollyScale ) {
- if ( this.object.isPerspectiveCamera || this.object.isOrthographicCamera ) {
- this._scale *= dollyScale;
- } else {
- console.warn( 'WARNING: OrbitControls.js encountered an unknown camera type - dolly/zoom disabled.' );
- this.enableZoom = false;
- }
- }
- _updateZoomParameters( x, y ) {
- if ( ! this.zoomToCursor ) {
- return;
- }
- this._performCursorZoom = true;
- const rect = this.domElement.getBoundingClientRect();
- const dx = x - rect.left;
- const dy = y - rect.top;
- const w = rect.width;
- const h = rect.height;
- this._mouse.x = ( dx / w ) * 2 - 1;
- this._mouse.y = - ( dy / h ) * 2 + 1;
- this._dollyDirection.set( this._mouse.x, this._mouse.y, 1 ).unproject( this.object ).sub( this.object.position ).normalize();
- }
- _clampDistance( dist ) {
- return Math.max( this.minDistance, Math.min( this.maxDistance, dist ) );
- }
- //
- // event callbacks - update the object state
- //
- _handleMouseDownRotate( event ) {
- this._rotateStart.set( event.clientX, event.clientY );
- }
- _handleMouseDownDolly( event ) {
- this._updateZoomParameters( event.clientX, event.clientX );
- this._dollyStart.set( event.clientX, event.clientY );
- }
- _handleMouseDownPan( event ) {
- this._panStart.set( event.clientX, event.clientY );
- }
- _handleMouseMoveRotate( event ) {
- this._rotateEnd.set( event.clientX, event.clientY );
- this._rotateDelta.subVectors( this._rotateEnd, this._rotateStart ).multiplyScalar( this.rotateSpeed );
- const element = this.domElement;
- this._rotateLeft( _twoPI * this._rotateDelta.x / element.clientHeight ); // yes, height
- this._rotateUp( _twoPI * this._rotateDelta.y / element.clientHeight );
- this._rotateStart.copy( this._rotateEnd );
- this.update();
- }
- _handleMouseMoveDolly( event ) {
- this._dollyEnd.set( event.clientX, event.clientY );
- this._dollyDelta.subVectors( this._dollyEnd, this._dollyStart );
- if ( this._dollyDelta.y > 0 ) {
- this._dollyOut( this._getZoomScale( this._dollyDelta.y ) );
- } else if ( this._dollyDelta.y < 0 ) {
- this._dollyIn( this._getZoomScale( this._dollyDelta.y ) );
- }
- this._dollyStart.copy( this._dollyEnd );
- this.update();
- }
- _handleMouseMovePan( event ) {
- this._panEnd.set( event.clientX, event.clientY );
- this._panDelta.subVectors( this._panEnd, this._panStart ).multiplyScalar( this.panSpeed );
- this._pan( this._panDelta.x, this._panDelta.y );
- this._panStart.copy( this._panEnd );
- this.update();
- }
- _handleMouseWheel( event ) {
- this._updateZoomParameters( event.clientX, event.clientY );
- if ( event.deltaY < 0 ) {
- this._dollyIn( this._getZoomScale( event.deltaY ) );
- } else if ( event.deltaY > 0 ) {
- this._dollyOut( this._getZoomScale( event.deltaY ) );
- }
- this.update();
- }
- _handleKeyDown( event ) {
- let needsUpdate = false;
- switch ( event.code ) {
- case this.keys.UP:
- if ( event.ctrlKey || event.metaKey || event.shiftKey ) {
- if ( this.enableRotate ) {
- this._rotateUp( _twoPI * this.keyRotateSpeed / this.domElement.clientHeight );
- }
- } else {
- if ( this.enablePan ) {
- this._pan( 0, this.keyPanSpeed );
- }
- }
- needsUpdate = true;
- break;
- case this.keys.BOTTOM:
- if ( event.ctrlKey || event.metaKey || event.shiftKey ) {
- if ( this.enableRotate ) {
- this._rotateUp( - _twoPI * this.keyRotateSpeed / this.domElement.clientHeight );
- }
- } else {
- if ( this.enablePan ) {
- this._pan( 0, - this.keyPanSpeed );
- }
- }
- needsUpdate = true;
- break;
- case this.keys.LEFT:
- if ( event.ctrlKey || event.metaKey || event.shiftKey ) {
- if ( this.enableRotate ) {
- this._rotateLeft( _twoPI * this.keyRotateSpeed / this.domElement.clientHeight );
- }
- } else {
- if ( this.enablePan ) {
- this._pan( this.keyPanSpeed, 0 );
- }
- }
- needsUpdate = true;
- break;
- case this.keys.RIGHT:
- if ( event.ctrlKey || event.metaKey || event.shiftKey ) {
- if ( this.enableRotate ) {
- this._rotateLeft( - _twoPI * this.keyRotateSpeed / this.domElement.clientHeight );
- }
- } else {
- if ( this.enablePan ) {
- this._pan( - this.keyPanSpeed, 0 );
- }
- }
- needsUpdate = true;
- break;
- }
- if ( needsUpdate ) {
- // prevent the browser from scrolling on cursor keys
- event.preventDefault();
- this.update();
- }
- }
- _handleTouchStartRotate( event ) {
- if ( this._pointers.length === 1 ) {
- this._rotateStart.set( event.pageX, event.pageY );
- } else {
- const position = this._getSecondPointerPosition( event );
- const x = 0.5 * ( event.pageX + position.x );
- const y = 0.5 * ( event.pageY + position.y );
- this._rotateStart.set( x, y );
- }
- }
- _handleTouchStartPan( event ) {
- if ( this._pointers.length === 1 ) {
- this._panStart.set( event.pageX, event.pageY );
- } else {
- const position = this._getSecondPointerPosition( event );
- const x = 0.5 * ( event.pageX + position.x );
- const y = 0.5 * ( event.pageY + position.y );
- this._panStart.set( x, y );
- }
- }
- _handleTouchStartDolly( event ) {
- const position = this._getSecondPointerPosition( event );
- const dx = event.pageX - position.x;
- const dy = event.pageY - position.y;
- const distance = Math.sqrt( dx * dx + dy * dy );
- this._dollyStart.set( 0, distance );
- }
- _handleTouchStartDollyPan( event ) {
- if ( this.enableZoom ) this._handleTouchStartDolly( event );
- if ( this.enablePan ) this._handleTouchStartPan( event );
- }
- _handleTouchStartDollyRotate( event ) {
- if ( this.enableZoom ) this._handleTouchStartDolly( event );
- if ( this.enableRotate ) this._handleTouchStartRotate( event );
- }
- _handleTouchMoveRotate( event ) {
- if ( this._pointers.length == 1 ) {
- this._rotateEnd.set( event.pageX, event.pageY );
- } else {
- const position = this._getSecondPointerPosition( event );
- const x = 0.5 * ( event.pageX + position.x );
- const y = 0.5 * ( event.pageY + position.y );
- this._rotateEnd.set( x, y );
- }
- this._rotateDelta.subVectors( this._rotateEnd, this._rotateStart ).multiplyScalar( this.rotateSpeed );
- const element = this.domElement;
- this._rotateLeft( _twoPI * this._rotateDelta.x / element.clientHeight ); // yes, height
- this._rotateUp( _twoPI * this._rotateDelta.y / element.clientHeight );
- this._rotateStart.copy( this._rotateEnd );
- }
- _handleTouchMovePan( event ) {
- if ( this._pointers.length === 1 ) {
- this._panEnd.set( event.pageX, event.pageY );
- } else {
- const position = this._getSecondPointerPosition( event );
- const x = 0.5 * ( event.pageX + position.x );
- const y = 0.5 * ( event.pageY + position.y );
- this._panEnd.set( x, y );
- }
- this._panDelta.subVectors( this._panEnd, this._panStart ).multiplyScalar( this.panSpeed );
- this._pan( this._panDelta.x, this._panDelta.y );
- this._panStart.copy( this._panEnd );
- }
- _handleTouchMoveDolly( event ) {
- const position = this._getSecondPointerPosition( event );
- const dx = event.pageX - position.x;
- const dy = event.pageY - position.y;
- const distance = Math.sqrt( dx * dx + dy * dy );
- this._dollyEnd.set( 0, distance );
- this._dollyDelta.set( 0, Math.pow( this._dollyEnd.y / this._dollyStart.y, this.zoomSpeed ) );
- this._dollyOut( this._dollyDelta.y );
- this._dollyStart.copy( this._dollyEnd );
- const centerX = ( event.pageX + position.x ) * 0.5;
- const centerY = ( event.pageY + position.y ) * 0.5;
- this._updateZoomParameters( centerX, centerY );
- }
- _handleTouchMoveDollyPan( event ) {
- if ( this.enableZoom ) this._handleTouchMoveDolly( event );
- if ( this.enablePan ) this._handleTouchMovePan( event );
- }
- _handleTouchMoveDollyRotate( event ) {
- if ( this.enableZoom ) this._handleTouchMoveDolly( event );
- if ( this.enableRotate ) this._handleTouchMoveRotate( event );
- }
- // pointers
- _addPointer( event ) {
- this._pointers.push( event.pointerId );
- }
- _removePointer( event ) {
- delete this._pointerPositions[ event.pointerId ];
- for ( let i = 0; i < this._pointers.length; i ++ ) {
- if ( this._pointers[ i ] == event.pointerId ) {
- this._pointers.splice( i, 1 );
- return;
- }
- }
- }
- _isTrackingPointer( event ) {
- for ( let i = 0; i < this._pointers.length; i ++ ) {
- if ( this._pointers[ i ] == event.pointerId ) return true;
- }
- return false;
- }
- _trackPointer( event ) {
- let position = this._pointerPositions[ event.pointerId ];
- if ( position === undefined ) {
- position = new Vector2();
- this._pointerPositions[ event.pointerId ] = position;
- }
- position.set( event.pageX, event.pageY );
- }
- _getSecondPointerPosition( event ) {
- const pointerId = ( event.pointerId === this._pointers[ 0 ] ) ? this._pointers[ 1 ] : this._pointers[ 0 ];
- return this._pointerPositions[ pointerId ];
- }
- //
- _customWheelEvent( event ) {
- const mode = event.deltaMode;
- // minimal wheel event altered to meet delta-zoom demand
- const newEvent = {
- clientX: event.clientX,
- clientY: event.clientY,
- deltaY: event.deltaY,
- };
- switch ( mode ) {
- case 1: // LINE_MODE
- newEvent.deltaY *= 16;
- break;
- case 2: // PAGE_MODE
- newEvent.deltaY *= 100;
- break;
- }
- // detect if event was triggered by pinching
- if ( event.ctrlKey && ! this._controlActive ) {
- newEvent.deltaY *= 10;
- }
- return newEvent;
- }
- }
- function onPointerDown( event ) {
- if ( this.enabled === false ) return;
- if ( this._pointers.length === 0 ) {
- this.domElement.setPointerCapture( event.pointerId );
- this.domElement.addEventListener( 'pointermove', this._onPointerMove );
- this.domElement.addEventListener( 'pointerup', this._onPointerUp );
- }
- //
- if ( this._isTrackingPointer( event ) ) return;
- //
- this._addPointer( event );
- if ( event.pointerType === 'touch' ) {
- this._onTouchStart( event );
- } else {
- this._onMouseDown( event );
- }
- }
- function onPointerMove( event ) {
- if ( this.enabled === false ) return;
- if ( event.pointerType === 'touch' ) {
- this._onTouchMove( event );
- } else {
- this._onMouseMove( event );
- }
- }
- function onPointerUp( event ) {
- this._removePointer( event );
- switch ( this._pointers.length ) {
- case 0:
- this.domElement.releasePointerCapture( event.pointerId );
- this.domElement.removeEventListener( 'pointermove', this._onPointerMove );
- this.domElement.removeEventListener( 'pointerup', this._onPointerUp );
- this.dispatchEvent( _endEvent );
- this.state = _STATE.NONE;
- break;
- case 1:
- const pointerId = this._pointers[ 0 ];
- const position = this._pointerPositions[ pointerId ];
- // minimal placeholder event - allows state correction on pointer-up
- this._onTouchStart( { pointerId: pointerId, pageX: position.x, pageY: position.y } );
- break;
- }
- }
- function onMouseDown( event ) {
- let mouseAction;
- switch ( event.button ) {
- case 0:
- mouseAction = this.mouseButtons.LEFT;
- break;
- case 1:
- mouseAction = this.mouseButtons.MIDDLE;
- break;
- case 2:
- mouseAction = this.mouseButtons.RIGHT;
- break;
- default:
- mouseAction = - 1;
- }
- switch ( mouseAction ) {
- case MOUSE.DOLLY:
- if ( this.enableZoom === false ) return;
- this._handleMouseDownDolly( event );
- this.state = _STATE.DOLLY;
- break;
- case MOUSE.ROTATE:
- if ( event.ctrlKey || event.metaKey || event.shiftKey ) {
- if ( this.enablePan === false ) return;
- this._handleMouseDownPan( event );
- this.state = _STATE.PAN;
- } else {
- if ( this.enableRotate === false ) return;
- this._handleMouseDownRotate( event );
- this.state = _STATE.ROTATE;
- }
- break;
- case MOUSE.PAN:
- if ( event.ctrlKey || event.metaKey || event.shiftKey ) {
- if ( this.enableRotate === false ) return;
- this._handleMouseDownRotate( event );
- this.state = _STATE.ROTATE;
- } else {
- if ( this.enablePan === false ) return;
- this._handleMouseDownPan( event );
- this.state = _STATE.PAN;
- }
- break;
- default:
- this.state = _STATE.NONE;
- }
- if ( this.state !== _STATE.NONE ) {
- this.dispatchEvent( _startEvent );
- }
- }
- function onMouseMove( event ) {
- switch ( this.state ) {
- case _STATE.ROTATE:
- if ( this.enableRotate === false ) return;
- this._handleMouseMoveRotate( event );
- break;
- case _STATE.DOLLY:
- if ( this.enableZoom === false ) return;
- this._handleMouseMoveDolly( event );
- break;
- case _STATE.PAN:
- if ( this.enablePan === false ) return;
- this._handleMouseMovePan( event );
- break;
- }
- }
- function onMouseWheel( event ) {
- if ( this.enabled === false || this.enableZoom === false || this.state !== _STATE.NONE ) return;
- event.preventDefault();
- this.dispatchEvent( _startEvent );
- this._handleMouseWheel( this._customWheelEvent( event ) );
- this.dispatchEvent( _endEvent );
- }
- function onKeyDown( event ) {
- if ( this.enabled === false ) return;
- this._handleKeyDown( event );
- }
- function onTouchStart( event ) {
- this._trackPointer( event );
- switch ( this._pointers.length ) {
- case 1:
- switch ( this.touches.ONE ) {
- case TOUCH.ROTATE:
- if ( this.enableRotate === false ) return;
- this._handleTouchStartRotate( event );
- this.state = _STATE.TOUCH_ROTATE;
- break;
- case TOUCH.PAN:
- if ( this.enablePan === false ) return;
- this._handleTouchStartPan( event );
- this.state = _STATE.TOUCH_PAN;
- break;
- default:
- this.state = _STATE.NONE;
- }
- break;
- case 2:
- switch ( this.touches.TWO ) {
- case TOUCH.DOLLY_PAN:
- if ( this.enableZoom === false && this.enablePan === false ) return;
- this._handleTouchStartDollyPan( event );
- this.state = _STATE.TOUCH_DOLLY_PAN;
- break;
- case TOUCH.DOLLY_ROTATE:
- if ( this.enableZoom === false && this.enableRotate === false ) return;
- this._handleTouchStartDollyRotate( event );
- this.state = _STATE.TOUCH_DOLLY_ROTATE;
- break;
- default:
- this.state = _STATE.NONE;
- }
- break;
- default:
- this.state = _STATE.NONE;
- }
- if ( this.state !== _STATE.NONE ) {
- this.dispatchEvent( _startEvent );
- }
- }
- function onTouchMove( event ) {
- this._trackPointer( event );
- switch ( this.state ) {
- case _STATE.TOUCH_ROTATE:
- if ( this.enableRotate === false ) return;
- this._handleTouchMoveRotate( event );
- this.update();
- break;
- case _STATE.TOUCH_PAN:
- if ( this.enablePan === false ) return;
- this._handleTouchMovePan( event );
- this.update();
- break;
- case _STATE.TOUCH_DOLLY_PAN:
- if ( this.enableZoom === false && this.enablePan === false ) return;
- this._handleTouchMoveDollyPan( event );
- this.update();
- break;
- case _STATE.TOUCH_DOLLY_ROTATE:
- if ( this.enableZoom === false && this.enableRotate === false ) return;
- this._handleTouchMoveDollyRotate( event );
- this.update();
- break;
- default:
- this.state = _STATE.NONE;
- }
- }
- function onContextMenu( event ) {
- if ( this.enabled === false ) return;
- event.preventDefault();
- }
- function interceptControlDown( event ) {
- if ( event.key === 'Control' ) {
- this._controlActive = true;
- const document = this.domElement.getRootNode(); // offscreen canvas compatibility
- document.addEventListener( 'keyup', this._interceptControlUp, { passive: true, capture: true } );
- }
- }
- function interceptControlUp( event ) {
- if ( event.key === 'Control' ) {
- this._controlActive = false;
- const document = this.domElement.getRootNode(); // offscreen canvas compatibility
- document.removeEventListener( 'keyup', this._interceptControlUp, { passive: true, capture: true } );
- }
- }
- export { OrbitControls };
|