Skip to content

chrisdickinson/spatial-events

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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