This project is no longer maintained
This repo may still work, but it is recommended to use one of the forked versions. Some forked versions have offered fixes and enhancements.
multitouch-look-controls
This is an AFrame free-look camera controller for touchscreen devices. This controller only listens to touch events, however on desktops and in VR mode it will automatically switch over to a normal AFrame look-controls, meaning it will listen to mouse and deviceorientation events. Thus, this controller can be used as a drop-in replacement for look-controls.
The touch gestures are:
- Single touch drag for pich and yaw
- Two finger drag to dolly left/right (perpendicular to look direction) and up/down
- Pinch to zoom (implemented as dolly)
AFrame's default look-controls support touch to yaw, but not the other touch gestures.
Updates
The original developer (morandd) is not actively maintaining this project. Pull requests are welcome and will be merged in. If someone else would like to take ownership of this module just let me know and I will update this README to direct readers to your new repo. For example, this project has made some updates: https://github.com/traleven/aframe-multitouch-look-controls
API
| Attribute | Description | Default |
|---|---|---|
| enabled | Is the controller enabled or not? | true |
| maxPitch | Maximum pitch up angle, in degrees | 15 |
| minPitch | Maximum pitch down angle, in degrees | -20 |
| xrange | Maximum, or min/max, dolly distance from starting point along X axis | 5 |
| yrange | Maximum, or min/max, dolly distance from starting point along Y axis | -1 1 |
| zrange | Maximum, or min/max, dolly distance from starting point along Z axis | 5 |
the [x|y|z]range can be specified as a single number or as a pair of numbers. A single value means the range is
bounded as x±xrange, and a pair of values means the bounds will be from x-xrange[0] to x+xrange[1].
Using
Include in page, then use as a drop-in replacement for look-controls.
You can optionally provide look-controls on the camera with specific parameter settings, e.g. <a-entity camera multitouch-look-controls look-controls="standing:false"></a-entity>. If you do not specify any, a look-controls with default settings will be created automatically. This usually works fine.
<script src="https://morandd.github.io/aframe-multitouch-look-controls/multitouch-look-controls.js"></script>
...
<a-entity camera multitouch-look-controls></a-entity>