alexrkass / aframe-no-click-look-controls

Intuitive controls for desktop A-frame experiences
MIT License
46 stars 7 forks source link

BROKEN DUE TO NEW VERSION OF A-FRAME!

A-Frame no-click-look-controls Component

Overview

Intuitive camera controls for desktop 3D experiences with A-Frame.

Features

Demos:

Panorama with plenty of space to explore the whole scene without anxiety of moving cursor off the canvas

User interface with restricted view angles to focus user on content.

Usage

Script

<html>
  <head>
    <!-- A-Frame standard library if needed -->
    <script src="https://aframe.io/releases/latest/aframe.js"></script>

    <!-- Component (includes A-Frame core) -->
    <script src="https://github.com/alexrkass/aframe-no-click-look-controls/raw/master/dist/aframe-no-click-look-controls.min.js"></script>
  </head>
  <body>
    <a-scene>
      <!-- ... -->
      <a-entity camera no-click-look-controls="[options]"></a-entity>
    </a-scene>
  </body>
</html>

NPM

Install.

$ npm install aframe-no-click-look-controls

Register.

var AFRAME = require('aframe-core');
var NoClickLookControls = require('aframe-no-click-look-controls');
AFRAME.registerComponent('no-click-look-controls', NoClickLookControls);

Use.

Options

(units are radians)

Property Default Description
maxyaw Controls the max y-axis rotation. Actual max viewing angle is twice the parameter, ie 3π is 3π to the right and 3π to the left.
maxpitch π/2 Controls the max x-axis rotation. Actual max viewing angle is twice the parameter, ie π/2 is π/2 up and π/2 down.
enabled true Enables controls

TODOS (PRs welcome)