Create continuous "chunked" grids/volumes with ndarrays
An experiment with creating continuous grids/volumes from "chunked" ndarrays. Ideally, this could make it easy to work with infinite terrain, or simply splitting a large area into smaller chunks to conserve memory - while still taking advantage of the modules designed to work with ndarrays.
The interface supports both asynchronous and synchronous getters, in case you want to back the chunks with a local storage mechanism such as level.js.
Takes an options object, with the following properties:
shape: the shape (dimensions) of each chunk.
getter: a function that is called when a new chunk is required.
getter function takes two arguments,
done. The former
is the chunk's position (in chunks, not units), and the latter is a Node-style
callback for returning the new array. If you want to retrieve chunks
synchronously you can return the array as well. All chunks must be the same
shape as specified in the
Retrieves a single chunk, by its position in chunkspace.
Retrieves a proxy array
combining the chunks between
Retrieve a proxy array that represents the points (in units) between
chunk, you can use this to select an arbitrary area
The local chunk cache - an object containing each chunk, indexed by their positions.
Clears a chunk from the local object cache - you should be doing this when you're no longer using a chunk to conserve memory.
var field = require'ndarray-continuous'shape: 50 50 50return donenull zeros50 50var array = fieldgroup-5 -5 -5 5 5 5require'cave-automata-2d'array10// things happen...setTimeoutfieldeachfieldremovechunkposition1000
A shorthand method for getting individual values directly by their position on the continuous ndarray.
A shorthand method for setting individual values directly by their position on the continuous ndarray.
iterator for each currently instantiated chunk, passing the chunk as
the first argument.
Returns the amount of chunks currently instantiated.
Called when a fresh chunk has been loaded - passing the chunk as an argument to the callback.
Called when a chunk has been removed - passing the chunk as an argument to the callback.