A Camera Control Library for three.js

Transcript

1. 1.

   A Camera Control Library for three.js @yomotsu 2019-11-20

2. 2.

   FrontEnd dev at PixelGrid, Inc. Akihiro Oyamada @yomotsu

3. 3.

   Also, an occasional three.js contributor

4. 4.

   None
5. 5.

   • DeviceOrientationControls • FirstPersonControls • FlyControls Camera Controls of three.js

   • OrbitControls • PointerLockControls • TrackballControls https://github.com/mrdoob/three.js/tree/dev/examples/js/controls https://threejs.org/examples/?q=controls
6. 6.

   5% 20% 75% OrbitControls Other controls No Controls ˒According to

   my feeling
7. 7.

   • DeviceOrientationControls • FirstPersonControls • FlyControls Camera Controls of three.js

   • OrbitControls • PointerLockControls • TrackballControls https://github.com/mrdoob/three.js/tree/dev/examples/js/controls https://threejs.org/examples/?q=controls
8. 8.

   • Orbital rotate via methods
 e.g. when user pressed a

   HTML button, point of view changes. • Fit view to the target object • Boundary area of movement • Dolly to cursor You may also need:
9. 9.

   camera-controls

10. 10.

    FYI: Names of
 camera movement

11. 11.

    https://github.com/yomotsu/camera-movement-comparison#readme

12. 12.

    camera-controls https://www.npmjs.com/package/camera-controls

13. 13.

    • Drag to rotate • Rotate and translate via methods

    • Fit the object to view • Boundary (thanks to @FMS_Cat) • Dolly to cursor (thanks to @FMS_Cat) and more… Features
14. 14.

    Usage of
 camera-controls

15. 15.

    $ npm install --save three camera-controls Install three.js and camera-controls

    Standalone script file is also available (on github)
16. 16.

    import * as THREE from 'three'; import CameraControls from 'camera-controls';

    CameraControls.install( { THREE } ); Import packages
17. 17.

    const clock = new THREE.Clock(); const scene = new THREE.Scene();

    const camera = new THREE.PerspectiveCamera( 60, width / height, 0.01, 1000 ); camera.position.set( 0, 0, 5 ); const renderer = new THREE.WebGLRenderer(); renderer.setSize( width, height ); document.body.appendChild( renderer.domElement ); Make your scene
18. 18.

    const controls = new CameraControls( camera, renderer.domElement ); Make a

    CameraControls instance
19. 19.

    ( function anim () { const delta = clock.getDelta(); const

    elapsed = clock.getElapsedTime(); requestAnimationFrame( anim );
 controls.update( delta ); renderer.render( scene, camera ); } )(); Update the instance in tick function
20. 20.

    const azimuthAngle = 30 * THREE.Math.DEG2RAD; const polarAngle = 90

    * THREE.Math.DEG2RAD; const moveSmoothly = true;
 controls.rotateTo( azimuthAngle, polarAngle, moveSmoothly ); Run methods whenever
21. 21.

    Demo

22. 22.

    • Zoom(FOV) controls • Mouse button (touch) config #51 •

    Write in TypeScript • Path animation TODOs
23. 23.

    • camera-control fills the missing features of official controls. •

    Available on NPM and GitHub. • Published under the MIT License. Conclusion
24. 24.

    I hope this was useful.

25. 25.

    Issues and PRs are welcome

26. 26.

    • NPM:
 https://www.npmjs.com/package/camera-controls • GitHub:
 https://github.com/yomotsu/camera-controls/

27. 27.

    gl.finish(); @yomotsu