spatial-events

3d spatially-aware event emitter

npm install spatial-events
3 downloads in the last day
27 downloads in the last week
139 downloads in the last month

spatial-events

a spatially-aware event emitter, designed to work in 3d space with axis aligned bounding boxes.

listeners may be attached with a name and a bounding box, and events may be emitted with a name, bounding box or point, and arguments.


var spatial = require('spatial-events')
  , aabb = require('aabb-3d')

var ee = new spatial

ee.on('explosion', aabb([0, 0, 0], [40, 40, 40]), function(arg) {
  console.log('an explosion happened and it was '+arg)
})

ee.emit('explosion', [20, 20, 20], 'overrated')

ee.emit('explosion', aabb([-Infinity, -Infinity, -Infinity], [Infinity, Infinity, Infinity]), 'without measure')

ee.emit('explosion', aabb([-20, -20, -20], [10, 10, 10]), 'never heard')

The event emitter creates an Octree under the covers, which exponentially increases the size of its coordinate system to fit bounding box listeners that are added.

Infinite listeners are stored in a separate structure.

In practice, this means that any "large" listener will be fired after any "small" listener, generally speaking -- events bubble up.

license

MIT

npm loves you