aframe-testras

A-Frame Extras

Add-ons and helpers for A-Frame VR.

Usage (Scripts)

In the dist/ folder, download any package(s) you need. Include the scripts on your page, and all components are automatically registered for you:

<script src="//cdn.rawgit.com/donmccurdy/aframe-extras/v2.5.3/dist/aframe-extras.min.js"></script>

CDN builds for aframe-extras/v2.5.3:

• aframe-extras.js (development)
• aframe-extras.min.js (production)

For partial builds, use a subpackage like aframe-extras.physics.min.js. Full list of packages below.

A-Frame Version Compatibility

A-Frame	Extras
>= v0.3.0	aframe-extras/v2.5.3
< v0.2.0	*/v1.17.0

Usage (NPM)

npm install --save aframe-extras

// custom-extras.js
 
var extras = require('aframe-extras');
AFRAME.registerComponent('velocity', extras.math.velocity); // Register a single component.
extras.physics.registerAll();                               // Register a particular package, and its dependencies.
extras.registerAll();                                       // Register everything.

Once installed, you'll need to compile your JavaScript using something like Browserify or Webpack. Example:

npm install -g browserify
browserify custom-extras.js -o bundle.js

bundle.js may then be included in your page. See here for a better introduction to Browserify.

Add-ons

src
├── controls/ (Documentation)
│   ├── checkpoint-controls.js
│   ├── gamepad-controls.js
│   ├── hmd-controls.js
│   ├── keyboard-controls.js
│   ├── mouse-controls.js
│   ├── touch-controls.js
│   └── universal-controls.js
├── loaders/ (Documentation)
│   ├── ply-model.js
│   └── three-model.js
├── math/ (Documentation)
│   ├── quaternion.js
│   └── velocity.js
├── misc/ (Documentation)
│   ├── checkpoint.js
│   ├── grab.js                 
│   ├── jump-ability.js
│   ├── sphere-collider.js      
│   └── toggle-velocity.js
├── physics/ (Documentation)
│   ├── body.js
│   ├── dynamic-body.js
│   ├── kinematic-body.js       
│   ├── physics.js
│   ├── static-body.js
│   └── system
│       └── physics.js
├── primitives/ (Documentation)
│   ├── a-grid.js
│   ├── a-ocean.js
│   └── a-tube.js
└── shadows/ (Documentation)    
    ├── shadow-light.js
    └── shadow.js