mirror of
https://github.com/overleaf/overleaf.git
synced 2024-10-24 21:12:38 -04:00
e035d526d6
Restructure frontend directories GitOrigin-RevId: 5a1224ca186f4809df45680a80d374c1c318d7bf
12184 lines
347 KiB
JavaScript
12184 lines
347 KiB
JavaScript
;(function(undefined) {
|
|
'use strict';
|
|
|
|
var __instances = {};
|
|
|
|
/**
|
|
* This is the sigma instances constructor. One instance of sigma represent
|
|
* one graph. It is possible to represent this grapĥ with several renderers
|
|
* at the same time. By default, the default renderer (WebGL + Canvas
|
|
* polyfill) will be used as the only renderer, with the container specified
|
|
* in the configuration.
|
|
*
|
|
* @param {?*} conf The configuration of the instance. There are a lot of
|
|
* different recognized forms to instantiate sigma, check
|
|
* example files, documentation in this file and unit
|
|
* tests to know more.
|
|
* @return {sigma} The fresh new sigma instance.
|
|
*
|
|
* Instanciating sigma:
|
|
* ********************
|
|
* If no parameter is given to the constructor, the instance will be created
|
|
* without any renderer or camera. It will just instantiate the graph, and
|
|
* other modules will have to be instantiated through the public methods,
|
|
* like "addRenderer" etc:
|
|
*
|
|
* > s0 = new sigma();
|
|
* > s0.addRenderer({
|
|
* > type: 'canvas',
|
|
* > container: 'my-container-id'
|
|
* > });
|
|
*
|
|
* In most of the cases, sigma will simply be used with the default renderer.
|
|
* Then, since the only required parameter is the DOM container, there are
|
|
* some simpler way to call the constructor. The four following calls do the
|
|
* exact same things:
|
|
*
|
|
* > s1 = new sigma('my-container-id');
|
|
* > s2 = new sigma(document.getElementById('my-container-id'));
|
|
* > s3 = new sigma({
|
|
* > container: document.getElementById('my-container-id')
|
|
* > });
|
|
* > s4 = new sigma({
|
|
* > renderers: [{
|
|
* > container: document.getElementById('my-container-id')
|
|
* > }]
|
|
* > });
|
|
*
|
|
* Recognized parameters:
|
|
* **********************
|
|
* Here is the exhaustive list of every accepted parameters, when calling the
|
|
* constructor with to top level configuration object (fourth case in the
|
|
* previous examples):
|
|
*
|
|
* {?string} id The id of the instance. It will be generated
|
|
* automatically if not specified.
|
|
* {?array} renderers An array containing objects describing renderers.
|
|
* {?object} graph An object containing an array of nodes and an array
|
|
* of edges, to avoid having to add them by hand later.
|
|
* {?object} settings An object containing instance specific settings that
|
|
* will override the default ones defined in the object
|
|
* sigma.settings.
|
|
*/
|
|
var sigma = function(conf) {
|
|
// Local variables:
|
|
// ****************
|
|
var i,
|
|
l,
|
|
a,
|
|
c,
|
|
o,
|
|
id;
|
|
|
|
sigma.classes.dispatcher.extend(this);
|
|
|
|
// Private attributes:
|
|
// *******************
|
|
var _self = this,
|
|
_conf = conf || {};
|
|
|
|
// Little shortcut:
|
|
// ****************
|
|
// The configuration is supposed to have a list of the configuration
|
|
// objects for each renderer.
|
|
// - If there are no configuration at all, then nothing is done.
|
|
// - If there are no renderer list, the given configuration object will be
|
|
// considered as describing the first and only renderer.
|
|
// - If there are no renderer list nor "container" object, it will be
|
|
// considered as the container itself (a DOM element).
|
|
// - If the argument passed to sigma() is a string, it will be considered
|
|
// as the ID of the DOM container.
|
|
if (
|
|
typeof _conf === 'string' ||
|
|
_conf instanceof HTMLElement
|
|
)
|
|
_conf = {
|
|
renderers: [_conf]
|
|
};
|
|
else if (Object.prototype.toString.call(_conf) === '[object Array]')
|
|
_conf = {
|
|
renderers: _conf
|
|
};
|
|
|
|
// Also check "renderer" and "container" keys:
|
|
o = _conf.renderers || _conf.renderer || _conf.container;
|
|
if (!_conf.renderers || _conf.renderers.length === 0)
|
|
if (
|
|
typeof o === 'string' ||
|
|
o instanceof HTMLElement ||
|
|
(typeof o === 'object' && 'container' in o)
|
|
)
|
|
_conf.renderers = [o];
|
|
|
|
// Recense the instance:
|
|
if (_conf.id) {
|
|
if (__instances[_conf.id])
|
|
throw 'sigma: Instance "' + _conf.id + '" already exists.';
|
|
Object.defineProperty(this, 'id', {
|
|
value: _conf.id
|
|
});
|
|
} else {
|
|
id = 0;
|
|
while (__instances[id])
|
|
id++;
|
|
Object.defineProperty(this, 'id', {
|
|
value: '' + id
|
|
});
|
|
}
|
|
__instances[this.id] = this;
|
|
|
|
// Initialize settings function:
|
|
this.settings = new sigma.classes.configurable(
|
|
sigma.settings,
|
|
_conf.settings || {}
|
|
);
|
|
|
|
// Initialize locked attributes:
|
|
Object.defineProperty(this, 'graph', {
|
|
value: new sigma.classes.graph(this.settings),
|
|
configurable: true
|
|
});
|
|
Object.defineProperty(this, 'middlewares', {
|
|
value: [],
|
|
configurable: true
|
|
});
|
|
Object.defineProperty(this, 'cameras', {
|
|
value: {},
|
|
configurable: true
|
|
});
|
|
Object.defineProperty(this, 'renderers', {
|
|
value: {},
|
|
configurable: true
|
|
});
|
|
Object.defineProperty(this, 'renderersPerCamera', {
|
|
value: {},
|
|
configurable: true
|
|
});
|
|
Object.defineProperty(this, 'cameraFrames', {
|
|
value: {},
|
|
configurable: true
|
|
});
|
|
Object.defineProperty(this, 'camera', {
|
|
get: function() {
|
|
return this.cameras[0];
|
|
}
|
|
});
|
|
Object.defineProperty(this, 'events', {
|
|
value: [
|
|
'click',
|
|
'rightClick',
|
|
'clickStage',
|
|
'doubleClickStage',
|
|
'rightClickStage',
|
|
'clickNode',
|
|
'clickNodes',
|
|
'doubleClickNode',
|
|
'doubleClickNodes',
|
|
'rightClickNode',
|
|
'rightClickNodes',
|
|
'overNode',
|
|
'overNodes',
|
|
'outNode',
|
|
'outNodes',
|
|
'downNode',
|
|
'downNodes',
|
|
'upNode',
|
|
'upNodes'
|
|
],
|
|
configurable: true
|
|
});
|
|
|
|
// Add a custom handler, to redispatch events from renderers:
|
|
this._handler = (function(e) {
|
|
var k,
|
|
data = {};
|
|
|
|
for (k in e.data)
|
|
data[k] = e.data[k];
|
|
|
|
data.renderer = e.target;
|
|
this.dispatchEvent(e.type, data);
|
|
}).bind(this);
|
|
|
|
// Initialize renderers:
|
|
a = _conf.renderers || [];
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
this.addRenderer(a[i]);
|
|
|
|
// Initialize middlewares:
|
|
a = _conf.middlewares || [];
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
this.middlewares.push(
|
|
typeof a[i] === 'string' ?
|
|
sigma.middlewares[a[i]] :
|
|
a[i]
|
|
);
|
|
|
|
// Check if there is already a graph to fill in:
|
|
if (typeof _conf.graph === 'object' && _conf.graph) {
|
|
this.graph.read(_conf.graph);
|
|
|
|
// If a graph is given to the to the instance, the "refresh" method is
|
|
// directly called:
|
|
this.refresh();
|
|
}
|
|
|
|
// Deal with resize:
|
|
window.addEventListener('resize', function() {
|
|
if (_self.settings)
|
|
_self.refresh();
|
|
});
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This methods will instantiate and reference a new camera. If no id is
|
|
* specified, then an automatic id will be generated.
|
|
*
|
|
* @param {?string} id Eventually the camera id.
|
|
* @return {sigma.classes.camera} The fresh new camera instance.
|
|
*/
|
|
sigma.prototype.addCamera = function(id) {
|
|
var self = this,
|
|
camera;
|
|
|
|
if (!arguments.length) {
|
|
id = 0;
|
|
while (this.cameras['' + id])
|
|
id++;
|
|
id = '' + id;
|
|
}
|
|
|
|
if (this.cameras[id])
|
|
throw 'sigma.addCamera: The camera "' + id + '" already exists.';
|
|
|
|
camera = new sigma.classes.camera(id, this.graph, this.settings);
|
|
this.cameras[id] = camera;
|
|
|
|
// Add a quadtree to the camera:
|
|
camera.quadtree = new sigma.classes.quad();
|
|
|
|
// Add an edgequadtree to the camera:
|
|
if (sigma.classes.edgequad !== undefined) {
|
|
camera.edgequadtree = new sigma.classes.edgequad();
|
|
}
|
|
|
|
camera.bind('coordinatesUpdated', function(e) {
|
|
self.renderCamera(camera, camera.isAnimated);
|
|
});
|
|
|
|
this.renderersPerCamera[id] = [];
|
|
|
|
return camera;
|
|
};
|
|
|
|
/**
|
|
* This method kills a camera, and every renderer attached to it.
|
|
*
|
|
* @param {string|camera} v The camera to kill or its ID.
|
|
* @return {sigma} Returns the instance.
|
|
*/
|
|
sigma.prototype.killCamera = function(v) {
|
|
v = typeof v === 'string' ? this.cameras[v] : v;
|
|
|
|
if (!v)
|
|
throw 'sigma.killCamera: The camera is undefined.';
|
|
|
|
var i,
|
|
l,
|
|
a = this.renderersPerCamera[v.id];
|
|
|
|
for (l = a.length, i = l - 1; i >= 0; i--)
|
|
this.killRenderer(a[i]);
|
|
|
|
delete this.renderersPerCamera[v.id];
|
|
delete this.cameraFrames[v.id];
|
|
delete this.cameras[v.id];
|
|
|
|
if (v.kill)
|
|
v.kill();
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This methods will instantiate and reference a new renderer. The "type"
|
|
* argument can be the constructor or its name in the "sigma.renderers"
|
|
* package. If no type is specified, then "sigma.renderers.def" will be used.
|
|
* If no id is specified, then an automatic id will be generated.
|
|
*
|
|
* @param {?object} options Eventually some options to give to the renderer
|
|
* constructor.
|
|
* @return {renderer} The fresh new renderer instance.
|
|
*
|
|
* Recognized parameters:
|
|
* **********************
|
|
* Here is the exhaustive list of every accepted parameters in the "options"
|
|
* object:
|
|
*
|
|
* {?string} id Eventually the renderer id.
|
|
* {?(function|string)} type Eventually the renderer constructor or its
|
|
* name in the "sigma.renderers" package.
|
|
* {?(camera|string)} camera Eventually the renderer camera or its
|
|
* id.
|
|
*/
|
|
sigma.prototype.addRenderer = function(options) {
|
|
var id,
|
|
fn,
|
|
camera,
|
|
renderer,
|
|
o = options || {};
|
|
|
|
// Polymorphism:
|
|
if (typeof o === 'string')
|
|
o = {
|
|
container: document.getElementById(o)
|
|
};
|
|
else if (o instanceof HTMLElement)
|
|
o = {
|
|
container: o
|
|
};
|
|
|
|
// If the container still is a string, we get it by id
|
|
if (typeof o.container === 'string')
|
|
o.container = document.getElementById(o.container);
|
|
|
|
// Reference the new renderer:
|
|
if (!('id' in o)) {
|
|
id = 0;
|
|
while (this.renderers['' + id])
|
|
id++;
|
|
id = '' + id;
|
|
} else
|
|
id = o.id;
|
|
|
|
if (this.renderers[id])
|
|
throw 'sigma.addRenderer: The renderer "' + id + '" already exists.';
|
|
|
|
// Find the good constructor:
|
|
fn = typeof o.type === 'function' ? o.type : sigma.renderers[o.type];
|
|
fn = fn || sigma.renderers.def;
|
|
|
|
// Find the good camera:
|
|
camera = 'camera' in o ?
|
|
(
|
|
o.camera instanceof sigma.classes.camera ?
|
|
o.camera :
|
|
this.cameras[o.camera] || this.addCamera(o.camera)
|
|
) :
|
|
this.addCamera();
|
|
|
|
if (this.cameras[camera.id] !== camera)
|
|
throw 'sigma.addRenderer: The camera is not properly referenced.';
|
|
|
|
// Instantiate:
|
|
renderer = new fn(this.graph, camera, this.settings, o);
|
|
this.renderers[id] = renderer;
|
|
Object.defineProperty(renderer, 'id', {
|
|
value: id
|
|
});
|
|
|
|
// Bind events:
|
|
if (renderer.bind)
|
|
renderer.bind(
|
|
[
|
|
'click',
|
|
'rightClick',
|
|
'clickStage',
|
|
'doubleClickStage',
|
|
'rightClickStage',
|
|
'clickNode',
|
|
'clickNodes',
|
|
'clickEdge',
|
|
'clickEdges',
|
|
'doubleClickNode',
|
|
'doubleClickNodes',
|
|
'doubleClickEdge',
|
|
'doubleClickEdges',
|
|
'rightClickNode',
|
|
'rightClickNodes',
|
|
'rightClickEdge',
|
|
'rightClickEdges',
|
|
'overNode',
|
|
'overNodes',
|
|
'overEdge',
|
|
'overEdges',
|
|
'outNode',
|
|
'outNodes',
|
|
'outEdge',
|
|
'outEdges',
|
|
'downNode',
|
|
'downNodes',
|
|
'downEdge',
|
|
'downEdges',
|
|
'upNode',
|
|
'upNodes',
|
|
'upEdge',
|
|
'upEdges'
|
|
],
|
|
this._handler
|
|
);
|
|
|
|
// Reference the renderer by its camera:
|
|
this.renderersPerCamera[camera.id].push(renderer);
|
|
|
|
return renderer;
|
|
};
|
|
|
|
/**
|
|
* This method kills a renderer.
|
|
*
|
|
* @param {string|renderer} v The renderer to kill or its ID.
|
|
* @return {sigma} Returns the instance.
|
|
*/
|
|
sigma.prototype.killRenderer = function(v) {
|
|
v = typeof v === 'string' ? this.renderers[v] : v;
|
|
|
|
if (!v)
|
|
throw 'sigma.killRenderer: The renderer is undefined.';
|
|
|
|
var a = this.renderersPerCamera[v.camera.id],
|
|
i = a.indexOf(v);
|
|
|
|
if (i >= 0)
|
|
a.splice(i, 1);
|
|
|
|
if (v.kill)
|
|
v.kill();
|
|
|
|
delete this.renderers[v.id];
|
|
|
|
return this;
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This method calls the "render" method of each renderer, with the same
|
|
* arguments than the "render" method, but will also check if the renderer
|
|
* has a "process" method, and call it if it exists.
|
|
*
|
|
* It is useful for quadtrees or WebGL processing, for instance.
|
|
*
|
|
* @param {?object} options Eventually some options to give to the refresh
|
|
* method.
|
|
* @return {sigma} Returns the instance itself.
|
|
*
|
|
* Recognized parameters:
|
|
* **********************
|
|
* Here is the exhaustive list of every accepted parameters in the "options"
|
|
* object:
|
|
*
|
|
* {?boolean} skipIndexation A flag specifying wether or not the refresh
|
|
* function should reindex the graph in the
|
|
* quadtrees or not (default: false).
|
|
*/
|
|
sigma.prototype.refresh = function(options) {
|
|
var i,
|
|
l,
|
|
k,
|
|
a,
|
|
c,
|
|
bounds,
|
|
prefix = 0;
|
|
|
|
options = options || {};
|
|
|
|
// Call each middleware:
|
|
a = this.middlewares || [];
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
a[i].call(
|
|
this,
|
|
(i === 0) ? '' : 'tmp' + prefix + ':',
|
|
(i === l - 1) ? 'ready:' : ('tmp' + (++prefix) + ':')
|
|
);
|
|
|
|
// Then, for each camera, call the "rescale" middleware, unless the
|
|
// settings specify not to:
|
|
for (k in this.cameras) {
|
|
c = this.cameras[k];
|
|
if (
|
|
c.settings('autoRescale') &&
|
|
this.renderersPerCamera[c.id] &&
|
|
this.renderersPerCamera[c.id].length
|
|
)
|
|
sigma.middlewares.rescale.call(
|
|
this,
|
|
a.length ? 'ready:' : '',
|
|
c.readPrefix,
|
|
{
|
|
width: this.renderersPerCamera[c.id][0].width,
|
|
height: this.renderersPerCamera[c.id][0].height
|
|
}
|
|
);
|
|
else
|
|
sigma.middlewares.copy.call(
|
|
this,
|
|
a.length ? 'ready:' : '',
|
|
c.readPrefix
|
|
);
|
|
|
|
if (!options.skipIndexation) {
|
|
// Find graph boundaries:
|
|
bounds = sigma.utils.getBoundaries(
|
|
this.graph,
|
|
c.readPrefix
|
|
);
|
|
|
|
// Refresh quadtree:
|
|
c.quadtree.index(this.graph.nodes(), {
|
|
prefix: c.readPrefix,
|
|
bounds: {
|
|
x: bounds.minX,
|
|
y: bounds.minY,
|
|
width: bounds.maxX - bounds.minX,
|
|
height: bounds.maxY - bounds.minY
|
|
}
|
|
});
|
|
|
|
// Refresh edgequadtree:
|
|
if (
|
|
c.edgequadtree !== undefined &&
|
|
c.settings('drawEdges') &&
|
|
c.settings('enableEdgeHovering')
|
|
) {
|
|
c.edgequadtree.index(this.graph, {
|
|
prefix: c.readPrefix,
|
|
bounds: {
|
|
x: bounds.minX,
|
|
y: bounds.minY,
|
|
width: bounds.maxX - bounds.minX,
|
|
height: bounds.maxY - bounds.minY
|
|
}
|
|
});
|
|
}
|
|
}
|
|
}
|
|
|
|
// Call each renderer:
|
|
a = Object.keys(this.renderers);
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
if (this.renderers[a[i]].process) {
|
|
if (this.settings('skipErrors'))
|
|
try {
|
|
this.renderers[a[i]].process();
|
|
} catch (e) {
|
|
console.log(
|
|
'Warning: The renderer "' + a[i] + '" crashed on ".process()"'
|
|
);
|
|
}
|
|
else
|
|
this.renderers[a[i]].process();
|
|
}
|
|
|
|
this.render();
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method calls the "render" method of each renderer.
|
|
*
|
|
* @return {sigma} Returns the instance itself.
|
|
*/
|
|
sigma.prototype.render = function() {
|
|
var i,
|
|
l,
|
|
a,
|
|
prefix = 0;
|
|
|
|
// Call each renderer:
|
|
a = Object.keys(this.renderers);
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
if (this.settings('skipErrors'))
|
|
try {
|
|
this.renderers[a[i]].render();
|
|
} catch (e) {
|
|
if (this.settings('verbose'))
|
|
console.log(
|
|
'Warning: The renderer "' + a[i] + '" crashed on ".render()"'
|
|
);
|
|
}
|
|
else
|
|
this.renderers[a[i]].render();
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method calls the "render" method of each renderer that is bound to
|
|
* the specified camera. To improve the performances, if this method is
|
|
* called too often, the number of effective renderings is limitated to one
|
|
* per frame, unless you are using the "force" flag.
|
|
*
|
|
* @param {sigma.classes.camera} camera The camera to render.
|
|
* @param {?boolean} force If true, will render the camera
|
|
* directly.
|
|
* @return {sigma} Returns the instance itself.
|
|
*/
|
|
sigma.prototype.renderCamera = function(camera, force) {
|
|
var i,
|
|
l,
|
|
a,
|
|
self = this;
|
|
|
|
if (force) {
|
|
a = this.renderersPerCamera[camera.id];
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
if (this.settings('skipErrors'))
|
|
try {
|
|
a[i].render();
|
|
} catch (e) {
|
|
if (this.settings('verbose'))
|
|
console.log(
|
|
'Warning: The renderer "' + a[i].id + '" crashed on ".render()"'
|
|
);
|
|
}
|
|
else
|
|
a[i].render();
|
|
} else {
|
|
if (!this.cameraFrames[camera.id]) {
|
|
a = this.renderersPerCamera[camera.id];
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
if (this.settings('skipErrors'))
|
|
try {
|
|
a[i].render();
|
|
} catch (e) {
|
|
if (this.settings('verbose'))
|
|
console.log(
|
|
'Warning: The renderer "' +
|
|
a[i].id +
|
|
'" crashed on ".render()"'
|
|
);
|
|
}
|
|
else
|
|
a[i].render();
|
|
|
|
this.cameraFrames[camera.id] = requestAnimationFrame(function() {
|
|
delete self.cameraFrames[camera.id];
|
|
});
|
|
}
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method calls the "kill" method of each module and destroys any
|
|
* reference from the instance.
|
|
*/
|
|
sigma.prototype.kill = function() {
|
|
var k;
|
|
|
|
// Dispatching event
|
|
this.dispatchEvent('kill');
|
|
|
|
// Kill graph:
|
|
this.graph.kill();
|
|
|
|
// Kill middlewares:
|
|
delete this.middlewares;
|
|
|
|
// Kill each renderer:
|
|
for (k in this.renderers)
|
|
this.killRenderer(this.renderers[k]);
|
|
|
|
// Kill each camera:
|
|
for (k in this.cameras)
|
|
this.killCamera(this.cameras[k]);
|
|
|
|
delete this.renderers;
|
|
delete this.cameras;
|
|
|
|
// Kill everything else:
|
|
for (k in this)
|
|
if (this.hasOwnProperty(k))
|
|
delete this[k];
|
|
|
|
delete __instances[this.id];
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* Returns a clone of the instances object or a specific running instance.
|
|
*
|
|
* @param {?string} id Eventually an instance ID.
|
|
* @return {object} The related instance or a clone of the instances
|
|
* object.
|
|
*/
|
|
sigma.instances = function(id) {
|
|
return arguments.length ?
|
|
__instances[id] :
|
|
sigma.utils.extend({}, __instances);
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
* The current version of sigma:
|
|
*/
|
|
sigma.version = '1.0.3';
|
|
|
|
|
|
|
|
|
|
/**
|
|
* EXPORT:
|
|
* *******
|
|
*/
|
|
if (typeof this.sigma !== 'undefined')
|
|
throw 'An object called sigma is already in the global scope.';
|
|
|
|
this.sigma = sigma;
|
|
|
|
}).call(this);
|
|
|
|
/**
|
|
* conrad.js is a tiny JavaScript jobs scheduler,
|
|
*
|
|
* Version: 0.1.0
|
|
* Sources: http://github.com/jacomyal/conrad.js
|
|
* Doc: http://github.com/jacomyal/conrad.js#readme
|
|
*
|
|
* License:
|
|
* --------
|
|
* Copyright © 2013 Alexis Jacomy, Sciences-Po médialab
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to
|
|
* deal in the Software without restriction, including without limitation the
|
|
* rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
|
|
* sell copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* The Software is provided "as is", without warranty of any kind, express or
|
|
* implied, including but not limited to the warranties of merchantability,
|
|
* fitness for a particular purpose and noninfringement. In no event shall the
|
|
* authors or copyright holders be liable for any claim, damages or other
|
|
* liability, whether in an action of contract, tort or otherwise, arising
|
|
* from, out of or in connection with the software or the use or other dealings
|
|
* in the Software.
|
|
*/
|
|
(function(global) {
|
|
'use strict';
|
|
|
|
// Check that conrad.js has not been loaded yet:
|
|
if (global.conrad)
|
|
throw new Error('conrad already exists');
|
|
|
|
|
|
/**
|
|
* PRIVATE VARIABLES:
|
|
* ******************
|
|
*/
|
|
|
|
/**
|
|
* A flag indicating whether conrad is running or not.
|
|
*
|
|
* @type {Number}
|
|
*/
|
|
var _lastFrameTime;
|
|
|
|
/**
|
|
* A flag indicating whether conrad is running or not.
|
|
*
|
|
* @type {Boolean}
|
|
*/
|
|
var _isRunning = false;
|
|
|
|
/**
|
|
* The hash of registered jobs. Each job must at least have a unique ID
|
|
* under the key "id" and a function under the key "job". This hash
|
|
* contains each running job and each waiting job.
|
|
*
|
|
* @type {Object}
|
|
*/
|
|
var _jobs = {};
|
|
|
|
/**
|
|
* The hash of currently running jobs.
|
|
*
|
|
* @type {Object}
|
|
*/
|
|
var _runningJobs = {};
|
|
|
|
/**
|
|
* The array of currently running jobs, sorted by priority.
|
|
*
|
|
* @type {Array}
|
|
*/
|
|
var _sortedByPriorityJobs = [];
|
|
|
|
/**
|
|
* The array of currently waiting jobs.
|
|
*
|
|
* @type {Object}
|
|
*/
|
|
var _waitingJobs = {};
|
|
|
|
/**
|
|
* The array of finished jobs. They are stored in an array, since two jobs
|
|
* with the same "id" can happen at two different times.
|
|
*
|
|
* @type {Array}
|
|
*/
|
|
var _doneJobs = [];
|
|
|
|
/**
|
|
* A dirty flag to keep conrad from starting: Indeed, when addJob() is called
|
|
* with several jobs, conrad must be started only at the end. This flag keeps
|
|
* me from duplicating the code that effectively adds a job.
|
|
*
|
|
* @type {Boolean}
|
|
*/
|
|
var _noStart = false;
|
|
|
|
/**
|
|
* An hash containing some global settings about how conrad.js should
|
|
* behave.
|
|
*
|
|
* @type {Object}
|
|
*/
|
|
var _parameters = {
|
|
frameDuration: 20,
|
|
history: true
|
|
};
|
|
|
|
/**
|
|
* This object contains every handlers bound to conrad events. It does not
|
|
* requirea any DOM implementation, since the events are all JavaScript.
|
|
*
|
|
* @type {Object}
|
|
*/
|
|
var _handlers = Object.create(null);
|
|
|
|
|
|
/**
|
|
* PRIVATE FUNCTIONS:
|
|
* ******************
|
|
*/
|
|
|
|
/**
|
|
* Will execute the handler everytime that the indicated event (or the
|
|
* indicated events) will be triggered.
|
|
*
|
|
* @param {string|array|object} events The name of the event (or the events
|
|
* separated by spaces).
|
|
* @param {function(Object)} handler The handler to bind.
|
|
* @return {Object} Returns conrad.
|
|
*/
|
|
function _bind(events, handler) {
|
|
var i,
|
|
i_end,
|
|
event,
|
|
eArray;
|
|
|
|
if (!arguments.length)
|
|
return;
|
|
else if (
|
|
arguments.length === 1 &&
|
|
Object(arguments[0]) === arguments[0]
|
|
)
|
|
for (events in arguments[0])
|
|
_bind(events, arguments[0][events]);
|
|
else if (arguments.length > 1) {
|
|
eArray =
|
|
Array.isArray(events) ?
|
|
events :
|
|
events.split(/ /);
|
|
|
|
for (i = 0, i_end = eArray.length; i !== i_end; i += 1) {
|
|
event = eArray[i];
|
|
|
|
if (!_handlers[event])
|
|
_handlers[event] = [];
|
|
|
|
// Using an object instead of directly the handler will make possible
|
|
// later to add flags
|
|
_handlers[event].push({
|
|
handler: handler
|
|
});
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Removes the handler from a specified event (or specified events).
|
|
*
|
|
* @param {?string} events The name of the event (or the events
|
|
* separated by spaces). If undefined,
|
|
* then all handlers are removed.
|
|
* @param {?function(Object)} handler The handler to unbind. If undefined,
|
|
* each handler bound to the event or the
|
|
* events will be removed.
|
|
* @return {Object} Returns conrad.
|
|
*/
|
|
function _unbind(events, handler) {
|
|
var i,
|
|
i_end,
|
|
j,
|
|
j_end,
|
|
a,
|
|
event,
|
|
eArray = Array.isArray(events) ?
|
|
events :
|
|
events.split(/ /);
|
|
|
|
if (!arguments.length)
|
|
_handlers = Object.create(null);
|
|
else if (handler) {
|
|
for (i = 0, i_end = eArray.length; i !== i_end; i += 1) {
|
|
event = eArray[i];
|
|
if (_handlers[event]) {
|
|
a = [];
|
|
for (j = 0, j_end = _handlers[event].length; j !== j_end; j += 1)
|
|
if (_handlers[event][j].handler !== handler)
|
|
a.push(_handlers[event][j]);
|
|
|
|
_handlers[event] = a;
|
|
}
|
|
|
|
if (_handlers[event] && _handlers[event].length === 0)
|
|
delete _handlers[event];
|
|
}
|
|
} else
|
|
for (i = 0, i_end = eArray.length; i !== i_end; i += 1)
|
|
delete _handlers[eArray[i]];
|
|
}
|
|
|
|
/**
|
|
* Executes each handler bound to the event.
|
|
*
|
|
* @param {string} events The name of the event (or the events separated
|
|
* by spaces).
|
|
* @param {?Object} data The content of the event (optional).
|
|
* @return {Object} Returns conrad.
|
|
*/
|
|
function _dispatch(events, data) {
|
|
var i,
|
|
j,
|
|
i_end,
|
|
j_end,
|
|
event,
|
|
eventName,
|
|
eArray = Array.isArray(events) ?
|
|
events :
|
|
events.split(/ /);
|
|
|
|
data = data === undefined ? {} : data;
|
|
|
|
for (i = 0, i_end = eArray.length; i !== i_end; i += 1) {
|
|
eventName = eArray[i];
|
|
|
|
if (_handlers[eventName]) {
|
|
event = {
|
|
type: eventName,
|
|
data: data || {}
|
|
};
|
|
|
|
for (j = 0, j_end = _handlers[eventName].length; j !== j_end; j += 1)
|
|
try {
|
|
_handlers[eventName][j].handler(event);
|
|
} catch (e) {}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Executes the most prioritary job once, and deals with filling the stats
|
|
* (done, time, averageTime, currentTime, etc...).
|
|
*
|
|
* @return {?Object} Returns the job object if it has to be killed, null else.
|
|
*/
|
|
function _executeFirstJob() {
|
|
var i,
|
|
l,
|
|
test,
|
|
kill,
|
|
pushed = false,
|
|
time = __dateNow(),
|
|
job = _sortedByPriorityJobs.shift();
|
|
|
|
// Execute the job and look at the result:
|
|
test = job.job();
|
|
|
|
// Deal with stats:
|
|
time = __dateNow() - time;
|
|
job.done++;
|
|
job.time += time;
|
|
job.currentTime += time;
|
|
job.weightTime = job.currentTime / (job.weight || 1);
|
|
job.averageTime = job.time / job.done;
|
|
|
|
// Check if the job has to be killed:
|
|
kill = job.count ? (job.count <= job.done) : !test;
|
|
|
|
// Reset priorities:
|
|
if (!kill) {
|
|
for (i = 0, l = _sortedByPriorityJobs.length; i < l; i++)
|
|
if (_sortedByPriorityJobs[i].weightTime > job.weightTime) {
|
|
_sortedByPriorityJobs.splice(i, 0, job);
|
|
pushed = true;
|
|
break;
|
|
}
|
|
|
|
if (!pushed)
|
|
_sortedByPriorityJobs.push(job);
|
|
}
|
|
|
|
return kill ? job : null;
|
|
}
|
|
|
|
/**
|
|
* Activates a job, by adding it to the _runningJobs object and the
|
|
* _sortedByPriorityJobs array. It also initializes its currentTime value.
|
|
*
|
|
* @param {Object} job The job to activate.
|
|
*/
|
|
function _activateJob(job) {
|
|
var l = _sortedByPriorityJobs.length;
|
|
|
|
// Add the job to the running jobs:
|
|
_runningJobs[job.id] = job;
|
|
job.status = 'running';
|
|
|
|
// Add the job to the priorities:
|
|
if (l) {
|
|
job.weightTime = _sortedByPriorityJobs[l - 1].weightTime;
|
|
job.currentTime = job.weightTime * (job.weight || 1);
|
|
}
|
|
|
|
// Initialize the job and dispatch:
|
|
job.startTime = __dateNow();
|
|
_dispatch('jobStarted', __clone(job));
|
|
|
|
_sortedByPriorityJobs.push(job);
|
|
}
|
|
|
|
/**
|
|
* The main loop of conrad.js:
|
|
* . It executes job such that they all occupate the same processing time.
|
|
* . It stops jobs that do not need to be executed anymore.
|
|
* . It triggers callbacks when it is relevant.
|
|
* . It starts waiting jobs when they need to be started.
|
|
* . It injects frames to keep a constant frapes per second ratio.
|
|
* . It stops itself when there are no more jobs to execute.
|
|
*/
|
|
function _loop() {
|
|
var k,
|
|
o,
|
|
l,
|
|
job,
|
|
time,
|
|
deadJob;
|
|
|
|
// Deal with the newly added jobs (the _jobs object):
|
|
for (k in _jobs) {
|
|
job = _jobs[k];
|
|
|
|
if (job.after)
|
|
_waitingJobs[k] = job;
|
|
else
|
|
_activateJob(job);
|
|
|
|
delete _jobs[k];
|
|
}
|
|
|
|
// Set the _isRunning flag to false if there are no running job:
|
|
_isRunning = !!_sortedByPriorityJobs.length;
|
|
|
|
// Deal with the running jobs (the _runningJobs object):
|
|
while (
|
|
_sortedByPriorityJobs.length &&
|
|
__dateNow() - _lastFrameTime < _parameters.frameDuration
|
|
) {
|
|
deadJob = _executeFirstJob();
|
|
|
|
// Deal with the case where the job has ended:
|
|
if (deadJob) {
|
|
_killJob(deadJob.id);
|
|
|
|
// Check for waiting jobs:
|
|
for (k in _waitingJobs)
|
|
if (_waitingJobs[k].after === deadJob.id) {
|
|
_activateJob(_waitingJobs[k]);
|
|
delete _waitingJobs[k];
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check if conrad still has jobs to deal with, and kill it if not:
|
|
if (_isRunning) {
|
|
// Update the _lastFrameTime:
|
|
_lastFrameTime = __dateNow();
|
|
|
|
_dispatch('enterFrame');
|
|
setTimeout(_loop, 0);
|
|
} else
|
|
_dispatch('stop');
|
|
}
|
|
|
|
/**
|
|
* Adds one or more jobs, and starts the loop if no job was running before. A
|
|
* job is at least a unique string "id" and a function, and there are some
|
|
* parameters that you can specify for each job to modify the way conrad will
|
|
* execute it. If a job is added with the "id" of another job that is waiting
|
|
* or still running, an error will be thrown.
|
|
*
|
|
* When a job is added, it is referenced in the _jobs object, by its id.
|
|
* Then, if it has to be executed right now, it will be also referenced in
|
|
* the _runningJobs object. If it has to wait, then it will be added into the
|
|
* _waitingJobs object, until it can start.
|
|
*
|
|
* Keep reading this documentation to see how to call this method.
|
|
*
|
|
* @return {Object} Returns conrad.
|
|
*
|
|
* Adding one job:
|
|
* ***************
|
|
* Basically, a job is defined by its string id and a function (the job). It
|
|
* is also possible to add some parameters:
|
|
*
|
|
* > conrad.addJob('myJobId', myJobFunction);
|
|
* > conrad.addJob('myJobId', {
|
|
* > job: myJobFunction,
|
|
* > someParameter: someValue
|
|
* > });
|
|
* > conrad.addJob({
|
|
* > id: 'myJobId',
|
|
* > job: myJobFunction,
|
|
* > someParameter: someValue
|
|
* > });
|
|
*
|
|
* Adding several jobs:
|
|
* ********************
|
|
* When adding several jobs at the same time, it is possible to specify
|
|
* parameters for each one individually or for all:
|
|
*
|
|
* > conrad.addJob([
|
|
* > {
|
|
* > id: 'myJobId1',
|
|
* > job: myJobFunction1,
|
|
* > someParameter1: someValue1
|
|
* > },
|
|
* > {
|
|
* > id: 'myJobId2',
|
|
* > job: myJobFunction2,
|
|
* > someParameter2: someValue2
|
|
* > }
|
|
* > ], {
|
|
* > someCommonParameter: someCommonValue
|
|
* > });
|
|
* > conrad.addJob({
|
|
* > myJobId1: {,
|
|
* > job: myJobFunction1,
|
|
* > someParameter1: someValue1
|
|
* > },
|
|
* > myJobId2: {,
|
|
* > job: myJobFunction2,
|
|
* > someParameter2: someValue2
|
|
* > }
|
|
* > }, {
|
|
* > someCommonParameter: someCommonValue
|
|
* > });
|
|
* > conrad.addJob({
|
|
* > myJobId1: myJobFunction1,
|
|
* > myJobId2: myJobFunction2
|
|
* > }, {
|
|
* > someCommonParameter: someCommonValue
|
|
* > });
|
|
*
|
|
* Recognized parameters:
|
|
* **********************
|
|
* Here is the exhaustive list of every accepted parameters:
|
|
*
|
|
* {?Function} end A callback to execute when the job is ended. It is
|
|
* not executed if the job is killed instead of ended
|
|
* "naturally".
|
|
* {?Integer} count The number of time the job has to be executed.
|
|
* {?Number} weight If specified, the job will be executed as it was
|
|
* added "weight" times.
|
|
* {?String} after The id of another job (eventually not added yet).
|
|
* If specified, this job will start only when the
|
|
* specified "after" job is ended.
|
|
*/
|
|
function _addJob(v1, v2) {
|
|
var i,
|
|
l,
|
|
o;
|
|
|
|
// Array of jobs:
|
|
if (Array.isArray(v1)) {
|
|
// Keep conrad to start until the last job is added:
|
|
_noStart = true;
|
|
|
|
for (i = 0, l = v1.length; i < l; i++)
|
|
_addJob(v1[i].id, __extend(v1[i], v2));
|
|
|
|
_noStart = false;
|
|
if (!_isRunning) {
|
|
// Update the _lastFrameTime:
|
|
_lastFrameTime = __dateNow();
|
|
|
|
_dispatch('start');
|
|
_loop();
|
|
}
|
|
} else if (typeof v1 === 'object') {
|
|
// One job (object):
|
|
if (typeof v1.id === 'string')
|
|
_addJob(v1.id, v1);
|
|
|
|
// Hash of jobs:
|
|
else {
|
|
// Keep conrad to start until the last job is added:
|
|
_noStart = true;
|
|
|
|
for (i in v1)
|
|
if (typeof v1[i] === 'function')
|
|
_addJob(i, __extend({
|
|
job: v1[i]
|
|
}, v2));
|
|
else
|
|
_addJob(i, __extend(v1[i], v2));
|
|
|
|
_noStart = false;
|
|
if (!_isRunning) {
|
|
// Update the _lastFrameTime:
|
|
_lastFrameTime = __dateNow();
|
|
|
|
_dispatch('start');
|
|
_loop();
|
|
}
|
|
}
|
|
|
|
// One job (string, *):
|
|
} else if (typeof v1 === 'string') {
|
|
if (_hasJob(v1))
|
|
throw new Error(
|
|
'[conrad.addJob] Job with id "' + v1 + '" already exists.'
|
|
);
|
|
|
|
// One job (string, function):
|
|
if (typeof v2 === 'function') {
|
|
o = {
|
|
id: v1,
|
|
done: 0,
|
|
time: 0,
|
|
status: 'waiting',
|
|
currentTime: 0,
|
|
averageTime: 0,
|
|
weightTime: 0,
|
|
job: v2
|
|
};
|
|
|
|
// One job (string, object):
|
|
} else if (typeof v2 === 'object') {
|
|
o = __extend(
|
|
{
|
|
id: v1,
|
|
done: 0,
|
|
time: 0,
|
|
status: 'waiting',
|
|
currentTime: 0,
|
|
averageTime: 0,
|
|
weightTime: 0
|
|
},
|
|
v2
|
|
);
|
|
|
|
// If none of those cases, throw an error:
|
|
} else
|
|
throw new Error('[conrad.addJob] Wrong arguments.');
|
|
|
|
// Effectively add the job:
|
|
_jobs[v1] = o;
|
|
_dispatch('jobAdded', __clone(o));
|
|
|
|
// Check if the loop has to be started:
|
|
if (!_isRunning && !_noStart) {
|
|
// Update the _lastFrameTime:
|
|
_lastFrameTime = __dateNow();
|
|
|
|
_dispatch('start');
|
|
_loop();
|
|
}
|
|
|
|
// If none of those cases, throw an error:
|
|
} else
|
|
throw new Error('[conrad.addJob] Wrong arguments.');
|
|
|
|
return this;
|
|
}
|
|
|
|
/**
|
|
* Kills one or more jobs, indicated by their ids. It is only possible to
|
|
* kill running jobs or waiting jobs. If you try to kill a job that does not
|
|
* exists or that is already killed, a warning will be thrown.
|
|
*
|
|
* @param {Array|String} v1 A string job id or an array of job ids.
|
|
* @return {Object} Returns conrad.
|
|
*/
|
|
function _killJob(v1) {
|
|
var i,
|
|
l,
|
|
k,
|
|
a,
|
|
job,
|
|
found = false;
|
|
|
|
// Array of job ids:
|
|
if (Array.isArray(v1))
|
|
for (i = 0, l = v1.length; i < l; i++)
|
|
_killJob(v1[i]);
|
|
|
|
// One job's id:
|
|
else if (typeof v1 === 'string') {
|
|
a = [_runningJobs, _waitingJobs, _jobs];
|
|
|
|
// Remove the job from the hashes:
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
if (v1 in a[i]) {
|
|
job = a[i][v1];
|
|
|
|
if (_parameters.history) {
|
|
job.status = 'done';
|
|
_doneJobs.push(job);
|
|
}
|
|
|
|
_dispatch('jobEnded', __clone(job));
|
|
delete a[i][v1];
|
|
|
|
if (typeof job.end === 'function')
|
|
job.end();
|
|
|
|
found = true;
|
|
}
|
|
|
|
// Remove the priorities array:
|
|
a = _sortedByPriorityJobs;
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
if (a[i].id === v1) {
|
|
a.splice(i, 1);
|
|
break;
|
|
}
|
|
|
|
if (!found)
|
|
throw new Error('[conrad.killJob] Job "' + v1 + '" not found.');
|
|
|
|
// If none of those cases, throw an error:
|
|
} else
|
|
throw new Error('[conrad.killJob] Wrong arguments.');
|
|
|
|
return this;
|
|
}
|
|
|
|
/**
|
|
* Kills every running, waiting, and just added jobs.
|
|
*
|
|
* @return {Object} Returns conrad.
|
|
*/
|
|
function _killAll() {
|
|
var k,
|
|
jobs = __extend(_jobs, _runningJobs, _waitingJobs);
|
|
|
|
// Take every jobs and push them into the _doneJobs object:
|
|
if (_parameters.history)
|
|
for (k in jobs) {
|
|
jobs[k].status = 'done';
|
|
_doneJobs.push(jobs[k]);
|
|
|
|
if (typeof jobs[k].end === 'function')
|
|
jobs[k].end();
|
|
}
|
|
|
|
// Reinitialize the different jobs lists:
|
|
_jobs = {};
|
|
_waitingJobs = {};
|
|
_runningJobs = {};
|
|
_sortedByPriorityJobs = [];
|
|
|
|
// In case some jobs are added right after the kill:
|
|
_isRunning = false;
|
|
|
|
return this;
|
|
}
|
|
|
|
/**
|
|
* Returns true if a job with the specified id is currently running or
|
|
* waiting, and false else.
|
|
*
|
|
* @param {String} id The id of the job.
|
|
* @return {?Object} Returns the job object if it exists.
|
|
*/
|
|
function _hasJob(id) {
|
|
var job = _jobs[id] || _runningJobs[id] || _waitingJobs[id];
|
|
return job ? __extend(job) : null;
|
|
}
|
|
|
|
/**
|
|
* This method will set the setting specified by "v1" to the value specified
|
|
* by "v2" if both are given, and else return the current value of the
|
|
* settings "v1".
|
|
*
|
|
* @param {String} v1 The name of the property.
|
|
* @param {?*} v2 Eventually, a value to set to the specified
|
|
* property.
|
|
* @return {Object|*} Returns the specified settings value if "v2" is not
|
|
* given, and conrad else.
|
|
*/
|
|
function _settings(v1, v2) {
|
|
var o;
|
|
|
|
if (typeof a1 === 'string' && arguments.length === 1)
|
|
return _parameters[a1];
|
|
else {
|
|
o = (typeof a1 === 'object' && arguments.length === 1) ?
|
|
a1 || {} :
|
|
{};
|
|
if (typeof a1 === 'string')
|
|
o[a1] = a2;
|
|
|
|
for (var k in o)
|
|
if (o[k] !== undefined)
|
|
_parameters[k] = o[k];
|
|
else
|
|
delete _parameters[k];
|
|
|
|
return this;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns true if conrad is currently running, and false else.
|
|
*
|
|
* @return {Boolean} Returns _isRunning.
|
|
*/
|
|
function _getIsRunning() {
|
|
return _isRunning;
|
|
}
|
|
|
|
/**
|
|
* Unreference every jobs that are stored in the _doneJobs object. It will
|
|
* not be possible anymore to get stats about these jobs, but it will release
|
|
* the memory.
|
|
*
|
|
* @return {Object} Returns conrad.
|
|
*/
|
|
function _clearHistory() {
|
|
_doneJobs = [];
|
|
return this;
|
|
}
|
|
|
|
/**
|
|
* Returns a snapshot of every data about jobs that wait to be started, are
|
|
* currently running or are done.
|
|
*
|
|
* It is possible to get only running, waiting or done jobs by giving
|
|
* "running", "waiting" or "done" as fist argument.
|
|
*
|
|
* It is also possible to get every job with a specified id by giving it as
|
|
* first argument. Also, using a RegExp instead of an id will return every
|
|
* jobs whose ids match the RegExp. And these two last use cases work as well
|
|
* by giving before "running", "waiting" or "done".
|
|
*
|
|
* @return {Array} The array of the matching jobs.
|
|
*
|
|
* Some call examples:
|
|
* *******************
|
|
* > conrad.getStats('running')
|
|
* > conrad.getStats('waiting')
|
|
* > conrad.getStats('done')
|
|
* > conrad.getStats('myJob')
|
|
* > conrad.getStats(/test/)
|
|
* > conrad.getStats('running', 'myRunningJob')
|
|
* > conrad.getStats('running', /test/)
|
|
*/
|
|
function _getStats(v1, v2) {
|
|
var a,
|
|
k,
|
|
i,
|
|
l,
|
|
stats,
|
|
pattern,
|
|
isPatternString;
|
|
|
|
if (!arguments.length) {
|
|
stats = [];
|
|
|
|
for (k in _jobs)
|
|
stats.push(_jobs[k]);
|
|
|
|
for (k in _waitingJobs)
|
|
stats.push(_waitingJobs[k]);
|
|
|
|
for (k in _runningJobs)
|
|
stats.push(_runningJobs[k]);
|
|
|
|
stats = stats.concat(_doneJobs);
|
|
}
|
|
|
|
if (typeof v1 === 'string')
|
|
switch (v1) {
|
|
case 'waiting':
|
|
stats = __objectValues(_waitingJobs);
|
|
break;
|
|
case 'running':
|
|
stats = __objectValues(_runningJobs);
|
|
break;
|
|
case 'done':
|
|
stats = _doneJobs;
|
|
break;
|
|
default:
|
|
pattern = v1;
|
|
}
|
|
|
|
if (v1 instanceof RegExp)
|
|
pattern = v1;
|
|
|
|
if (!pattern && (typeof v2 === 'string' || v2 instanceof RegExp))
|
|
pattern = v2;
|
|
|
|
// Filter jobs if a pattern is given:
|
|
if (pattern) {
|
|
isPatternString = typeof pattern === 'string';
|
|
|
|
if (stats instanceof Array) {
|
|
a = stats;
|
|
} else if (typeof stats === 'object') {
|
|
a = [];
|
|
|
|
for (k in stats)
|
|
a = a.concat(stats[k]);
|
|
} else {
|
|
a = [];
|
|
|
|
for (k in _jobs)
|
|
a.push(_jobs[k]);
|
|
|
|
for (k in _waitingJobs)
|
|
a.push(_waitingJobs[k]);
|
|
|
|
for (k in _runningJobs)
|
|
a.push(_runningJobs[k]);
|
|
|
|
a = a.concat(_doneJobs);
|
|
}
|
|
|
|
stats = [];
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
if (isPatternString ? a[i].id === pattern : a[i].id.match(pattern))
|
|
stats.push(a[i]);
|
|
}
|
|
|
|
return __clone(stats);
|
|
}
|
|
|
|
|
|
/**
|
|
* TOOLS FUNCTIONS:
|
|
* ****************
|
|
*/
|
|
|
|
/**
|
|
* This function takes any number of objects as arguments, copies from each
|
|
* of these objects each pair key/value into a new object, and finally
|
|
* returns this object.
|
|
*
|
|
* The arguments are parsed from the last one to the first one, such that
|
|
* when two objects have keys in common, the "earliest" object wins.
|
|
*
|
|
* Example:
|
|
* ********
|
|
* > var o1 = {
|
|
* > a: 1,
|
|
* > b: 2,
|
|
* > c: '3'
|
|
* > },
|
|
* > o2 = {
|
|
* > c: '4',
|
|
* > d: [ 5 ]
|
|
* > };
|
|
* > __extend(o1, o2);
|
|
* > // Returns: {
|
|
* > // a: 1,
|
|
* > // b: 2,
|
|
* > // c: '3',
|
|
* > // d: [ 5 ]
|
|
* > // };
|
|
*
|
|
* @param {Object+} Any number of objects.
|
|
* @return {Object} The merged object.
|
|
*/
|
|
function __extend() {
|
|
var i,
|
|
k,
|
|
res = {},
|
|
l = arguments.length;
|
|
|
|
for (i = l - 1; i >= 0; i--)
|
|
for (k in arguments[i])
|
|
res[k] = arguments[i][k];
|
|
|
|
return res;
|
|
}
|
|
|
|
/**
|
|
* This function simply clones an object. This object must contain only
|
|
* objects, arrays and immutable values. Since it is not public, it does not
|
|
* deal with cyclic references, DOM elements and instantiated objects - so
|
|
* use it carefully.
|
|
*
|
|
* @param {Object} The object to clone.
|
|
* @return {Object} The clone.
|
|
*/
|
|
function __clone(item) {
|
|
var result, i, k, l;
|
|
|
|
if (!item)
|
|
return item;
|
|
|
|
if (Array.isArray(item)) {
|
|
result = [];
|
|
for (i = 0, l = item.length; i < l; i++)
|
|
result.push(__clone(item[i]));
|
|
} else if (typeof item === 'object') {
|
|
result = {};
|
|
for (i in item)
|
|
result[i] = __clone(item[i]);
|
|
} else
|
|
result = item;
|
|
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* Returns an array containing the values of an object.
|
|
*
|
|
* @param {Object} The object.
|
|
* @return {Array} The array of values.
|
|
*/
|
|
function __objectValues(o) {
|
|
var k,
|
|
a = [];
|
|
|
|
for (k in o)
|
|
a.push(o[k]);
|
|
|
|
return a;
|
|
}
|
|
|
|
/**
|
|
* A short "Date.now()" polyfill.
|
|
*
|
|
* @return {Number} The current time (in ms).
|
|
*/
|
|
function __dateNow() {
|
|
return Date.now ? Date.now() : new Date().getTime();
|
|
}
|
|
|
|
/**
|
|
* Polyfill for the Array.isArray function:
|
|
*/
|
|
if (!Array.isArray)
|
|
Array.isArray = function(v) {
|
|
return Object.prototype.toString.call(v) === '[object Array]';
|
|
};
|
|
|
|
|
|
/**
|
|
* EXPORT PUBLIC API:
|
|
* ******************
|
|
*/
|
|
var conrad = {
|
|
hasJob: _hasJob,
|
|
addJob: _addJob,
|
|
killJob: _killJob,
|
|
killAll: _killAll,
|
|
settings: _settings,
|
|
getStats: _getStats,
|
|
isRunning: _getIsRunning,
|
|
clearHistory: _clearHistory,
|
|
|
|
// Events management:
|
|
bind: _bind,
|
|
unbind: _unbind,
|
|
|
|
// Version:
|
|
version: '0.1.0'
|
|
};
|
|
|
|
if (typeof exports !== 'undefined') {
|
|
if (typeof module !== 'undefined' && module.exports)
|
|
exports = module.exports = conrad;
|
|
exports.conrad = conrad;
|
|
}
|
|
global.conrad = conrad;
|
|
})(this);
|
|
|
|
// Hardcoded export for the node.js version:
|
|
var sigma = this.sigma,
|
|
conrad = this.conrad;
|
|
|
|
sigma.conrad = conrad;
|
|
|
|
// Dirty polyfills to permit sigma usage in node
|
|
if (HTMLElement === undefined)
|
|
var HTMLElement = function() {};
|
|
|
|
if (window === undefined)
|
|
var window = {
|
|
addEventListener: function() {}
|
|
};
|
|
|
|
if (typeof exports !== 'undefined') {
|
|
if (typeof module !== 'undefined' && module.exports)
|
|
exports = module.exports = sigma;
|
|
exports.sigma = sigma;
|
|
}
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
var _root = this;
|
|
|
|
// Initialize packages:
|
|
sigma.utils = sigma.utils || {};
|
|
|
|
/**
|
|
* MISC UTILS:
|
|
*/
|
|
/**
|
|
* This function takes any number of objects as arguments, copies from each
|
|
* of these objects each pair key/value into a new object, and finally
|
|
* returns this object.
|
|
*
|
|
* The arguments are parsed from the last one to the first one, such that
|
|
* when several objects have keys in common, the "earliest" object wins.
|
|
*
|
|
* Example:
|
|
* ********
|
|
* > var o1 = {
|
|
* > a: 1,
|
|
* > b: 2,
|
|
* > c: '3'
|
|
* > },
|
|
* > o2 = {
|
|
* > c: '4',
|
|
* > d: [ 5 ]
|
|
* > };
|
|
* > sigma.utils.extend(o1, o2);
|
|
* > // Returns: {
|
|
* > // a: 1,
|
|
* > // b: 2,
|
|
* > // c: '3',
|
|
* > // d: [ 5 ]
|
|
* > // };
|
|
*
|
|
* @param {object+} Any number of objects.
|
|
* @return {object} The merged object.
|
|
*/
|
|
sigma.utils.extend = function() {
|
|
var i,
|
|
k,
|
|
res = {},
|
|
l = arguments.length;
|
|
|
|
for (i = l - 1; i >= 0; i--)
|
|
for (k in arguments[i])
|
|
res[k] = arguments[i][k];
|
|
|
|
return res;
|
|
};
|
|
|
|
/**
|
|
* A short "Date.now()" polyfill.
|
|
*
|
|
* @return {Number} The current time (in ms).
|
|
*/
|
|
sigma.utils.dateNow = function() {
|
|
return Date.now ? Date.now() : new Date().getTime();
|
|
};
|
|
|
|
/**
|
|
* Takes a package name as parameter and checks at each lebel if it exists,
|
|
* and if it does not, creates it.
|
|
*
|
|
* Example:
|
|
* ********
|
|
* > sigma.utils.pkg('a.b.c');
|
|
* > a.b.c;
|
|
* > // Object {};
|
|
* >
|
|
* > sigma.utils.pkg('a.b.d');
|
|
* > a.b;
|
|
* > // Object { c: {}, d: {} };
|
|
*
|
|
* @param {string} pkgName The name of the package to create/find.
|
|
* @return {object} The related package.
|
|
*/
|
|
sigma.utils.pkg = function(pkgName) {
|
|
return (pkgName || '').split('.').reduce(function(context, objName) {
|
|
return (objName in context) ?
|
|
context[objName] :
|
|
(context[objName] = {});
|
|
}, _root);
|
|
};
|
|
|
|
/**
|
|
* Returns a unique incremental number ID.
|
|
*
|
|
* Example:
|
|
* ********
|
|
* > sigma.utils.id();
|
|
* > // 1;
|
|
* >
|
|
* > sigma.utils.id();
|
|
* > // 2;
|
|
* >
|
|
* > sigma.utils.id();
|
|
* > // 3;
|
|
*
|
|
* @param {string} pkgName The name of the package to create/find.
|
|
* @return {object} The related package.
|
|
*/
|
|
sigma.utils.id = (function() {
|
|
var i = 0;
|
|
return function() {
|
|
return ++i;
|
|
};
|
|
})();
|
|
|
|
/**
|
|
* This function takes an hexa color (for instance "#ffcc00" or "#fc0") or a
|
|
* rgb / rgba color (like "rgb(255,255,12)" or "rgba(255,255,12,1)") and
|
|
* returns an integer equal to "r * 255 * 255 + g * 255 + b", to gain some
|
|
* memory in the data given to WebGL shaders.
|
|
*
|
|
* @param {string} val The hexa or rgba color.
|
|
* @return {number} The number value.
|
|
*/
|
|
sigma.utils.floatColor = function(val) {
|
|
var result = [0, 0, 0];
|
|
|
|
if (val.match(/^#/)) {
|
|
val = (val || '').replace(/^#/, '');
|
|
result = (val.length === 3) ?
|
|
[
|
|
parseInt(val.charAt(0) + val.charAt(0), 16),
|
|
parseInt(val.charAt(1) + val.charAt(1), 16),
|
|
parseInt(val.charAt(2) + val.charAt(2), 16)
|
|
] :
|
|
[
|
|
parseInt(val.charAt(0) + val.charAt(1), 16),
|
|
parseInt(val.charAt(2) + val.charAt(3), 16),
|
|
parseInt(val.charAt(4) + val.charAt(5), 16)
|
|
];
|
|
} else if (val.match(/^ *rgba? *\(/)) {
|
|
val = val.match(
|
|
/^ *rgba? *\( *([0-9]*) *, *([0-9]*) *, *([0-9]*) *(,.*)?\) *$/
|
|
);
|
|
result = [
|
|
+val[1],
|
|
+val[2],
|
|
+val[3]
|
|
];
|
|
}
|
|
|
|
return (
|
|
result[0] * 256 * 256 +
|
|
result[1] * 256 +
|
|
result[2]
|
|
);
|
|
};
|
|
|
|
/**
|
|
* Perform a zoom into a camera, with or without animation, to the
|
|
* coordinates indicated using a specified ratio.
|
|
*
|
|
* Recognized parameters:
|
|
* **********************
|
|
* Here is the exhaustive list of every accepted parameters in the animation
|
|
* object:
|
|
*
|
|
* {?number} duration An amount of time that means the duration of the
|
|
* animation. If this parameter doesn't exist the
|
|
* zoom will be performed without animation.
|
|
* {?function} onComplete A function to perform it after the animation. It
|
|
* will be performed even if there is no duration.
|
|
*
|
|
* @param {camera} The camera where perform the zoom.
|
|
* @param {x} The X coordiantion where the zoom goes.
|
|
* @param {y} The Y coordiantion where the zoom goes.
|
|
* @param {ratio} The ratio to apply it to the current camera ratio.
|
|
* @param {?animation} A dictionary with options for a possible animation.
|
|
*/
|
|
sigma.utils.zoomTo = function(camera, x, y, ratio, animation) {
|
|
var settings = camera.settings,
|
|
count,
|
|
newRatio,
|
|
animationSettings,
|
|
coordinates;
|
|
|
|
// Create the newRatio dealing with min / max:
|
|
newRatio = Math.max(
|
|
settings('zoomMin'),
|
|
Math.min(
|
|
settings('zoomMax'),
|
|
camera.ratio * ratio
|
|
)
|
|
);
|
|
|
|
// Check that the new ratio is different from the initial one:
|
|
if (newRatio !== camera.ratio) {
|
|
// Create the coordinates variable:
|
|
ratio = newRatio / camera.ratio;
|
|
coordinates = {
|
|
x: x * (1 - ratio) + camera.x,
|
|
y: y * (1 - ratio) + camera.y,
|
|
ratio: newRatio
|
|
};
|
|
|
|
if (animation && animation.duration) {
|
|
// Complete the animation setings:
|
|
count = sigma.misc.animation.killAll(camera);
|
|
animation = sigma.utils.extend(
|
|
animation,
|
|
{
|
|
easing: count ? 'quadraticOut' : 'quadraticInOut'
|
|
}
|
|
);
|
|
|
|
sigma.misc.animation.camera(camera, coordinates, animation);
|
|
} else {
|
|
camera.goTo(coordinates);
|
|
if (animation && animation.onComplete)
|
|
animation.onComplete();
|
|
}
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Return the control point coordinates for a quadratic bezier curve.
|
|
*
|
|
* @param {number} x1 The X coordinate of the start point.
|
|
* @param {number} y1 The Y coordinate of the start point.
|
|
* @param {number} x2 The X coordinate of the end point.
|
|
* @param {number} y2 The Y coordinate of the end point.
|
|
* @return {x,y} The control point coordinates.
|
|
*/
|
|
sigma.utils.getQuadraticControlPoint = function(x1, y1, x2, y2) {
|
|
return {
|
|
x: (x1 + x2) / 2 + (y2 - y1) / 4,
|
|
y: (y1 + y2) / 2 + (x1 - x2) / 4
|
|
};
|
|
};
|
|
|
|
/**
|
|
* Compute the coordinates of the point positioned
|
|
* at length t in the quadratic bezier curve.
|
|
*
|
|
* @param {number} t In [0,1] the step percentage to reach
|
|
* the point in the curve from the context point.
|
|
* @param {number} x1 The X coordinate of the context point.
|
|
* @param {number} y1 The Y coordinate of the context point.
|
|
* @param {number} x2 The X coordinate of the ending point.
|
|
* @param {number} y2 The Y coordinate of the ending point.
|
|
* @param {number} xi The X coordinate of the control point.
|
|
* @param {number} yi The Y coordinate of the control point.
|
|
* @return {object} {x,y}.
|
|
*/
|
|
sigma.utils.getPointOnQuadraticCurve = function(t, x1, y1, x2, y2, xi, yi) {
|
|
// http://stackoverflow.com/a/5634528
|
|
return {
|
|
x: Math.pow(1 - t, 2) * x1 + 2 * (1 - t) * t * xi + Math.pow(t, 2) * x2,
|
|
y: Math.pow(1 - t, 2) * y1 + 2 * (1 - t) * t * yi + Math.pow(t, 2) * y2
|
|
};
|
|
};
|
|
|
|
/**
|
|
* Compute the coordinates of the point positioned
|
|
* at length t in the cubic bezier curve.
|
|
*
|
|
* @param {number} t In [0,1] the step percentage to reach
|
|
* the point in the curve from the context point.
|
|
* @param {number} x1 The X coordinate of the context point.
|
|
* @param {number} y1 The Y coordinate of the context point.
|
|
* @param {number} x2 The X coordinate of the end point.
|
|
* @param {number} y2 The Y coordinate of the end point.
|
|
* @param {number} cx The X coordinate of the first control point.
|
|
* @param {number} cy The Y coordinate of the first control point.
|
|
* @param {number} dx The X coordinate of the second control point.
|
|
* @param {number} dy The Y coordinate of the second control point.
|
|
* @return {object} {x,y} The point at t.
|
|
*/
|
|
sigma.utils.getPointOnBezierCurve =
|
|
function(t, x1, y1, x2, y2, cx, cy, dx, dy) {
|
|
// http://stackoverflow.com/a/15397596
|
|
// Blending functions:
|
|
var B0_t = Math.pow(1 - t, 3),
|
|
B1_t = 3 * t * Math.pow(1 - t, 2),
|
|
B2_t = 3 * Math.pow(t, 2) * (1 - t),
|
|
B3_t = Math.pow(t, 3);
|
|
|
|
return {
|
|
x: (B0_t * x1) + (B1_t * cx) + (B2_t * dx) + (B3_t * x2),
|
|
y: (B0_t * y1) + (B1_t * cy) + (B2_t * dy) + (B3_t * y2)
|
|
};
|
|
};
|
|
|
|
/**
|
|
* Return the coordinates of the two control points for a self loop (i.e.
|
|
* where the start point is also the end point) computed as a cubic bezier
|
|
* curve.
|
|
*
|
|
* @param {number} x The X coordinate of the node.
|
|
* @param {number} y The Y coordinate of the node.
|
|
* @param {number} size The node size.
|
|
* @return {x1,y1,x2,y2} The coordinates of the two control points.
|
|
*/
|
|
sigma.utils.getSelfLoopControlPoints = function(x , y, size) {
|
|
return {
|
|
x1: x - size * 7,
|
|
y1: y,
|
|
x2: x,
|
|
y2: y + size * 7
|
|
};
|
|
};
|
|
|
|
/**
|
|
* Return the euclidian distance between two points of a plane
|
|
* with an orthonormal basis.
|
|
*
|
|
* @param {number} x1 The X coordinate of the first point.
|
|
* @param {number} y1 The Y coordinate of the first point.
|
|
* @param {number} x2 The X coordinate of the second point.
|
|
* @param {number} y2 The Y coordinate of the second point.
|
|
* @return {number} The euclidian distance.
|
|
*/
|
|
sigma.utils.getDistance = function(x0, y0, x1, y1) {
|
|
return Math.sqrt(Math.pow(x1 - x0, 2) + Math.pow(y1 - y0, 2));
|
|
};
|
|
|
|
/**
|
|
* Return the coordinates of the intersection points of two circles.
|
|
*
|
|
* @param {number} x0 The X coordinate of center location of the first
|
|
* circle.
|
|
* @param {number} y0 The Y coordinate of center location of the first
|
|
* circle.
|
|
* @param {number} r0 The radius of the first circle.
|
|
* @param {number} x1 The X coordinate of center location of the second
|
|
* circle.
|
|
* @param {number} y1 The Y coordinate of center location of the second
|
|
* circle.
|
|
* @param {number} r1 The radius of the second circle.
|
|
* @return {xi,yi} The coordinates of the intersection points.
|
|
*/
|
|
sigma.utils.getCircleIntersection = function(x0, y0, r0, x1, y1, r1) {
|
|
// http://stackoverflow.com/a/12219802
|
|
var a, dx, dy, d, h, rx, ry, x2, y2;
|
|
|
|
// dx and dy are the vertical and horizontal distances between the circle
|
|
// centers:
|
|
dx = x1 - x0;
|
|
dy = y1 - y0;
|
|
|
|
// Determine the straight-line distance between the centers:
|
|
d = Math.sqrt((dy * dy) + (dx * dx));
|
|
|
|
// Check for solvability:
|
|
if (d > (r0 + r1)) {
|
|
// No solution. circles do not intersect.
|
|
return false;
|
|
}
|
|
if (d < Math.abs(r0 - r1)) {
|
|
// No solution. one circle is contained in the other.
|
|
return false;
|
|
}
|
|
|
|
//'point 2' is the point where the line through the circle intersection
|
|
// points crosses the line between the circle centers.
|
|
|
|
// Determine the distance from point 0 to point 2:
|
|
a = ((r0 * r0) - (r1 * r1) + (d * d)) / (2.0 * d);
|
|
|
|
// Determine the coordinates of point 2:
|
|
x2 = x0 + (dx * a / d);
|
|
y2 = y0 + (dy * a / d);
|
|
|
|
// Determine the distance from point 2 to either of the intersection
|
|
// points:
|
|
h = Math.sqrt((r0 * r0) - (a * a));
|
|
|
|
// Determine the offsets of the intersection points from point 2:
|
|
rx = -dy * (h / d);
|
|
ry = dx * (h / d);
|
|
|
|
// Determine the absolute intersection points:
|
|
var xi = x2 + rx;
|
|
var xi_prime = x2 - rx;
|
|
var yi = y2 + ry;
|
|
var yi_prime = y2 - ry;
|
|
|
|
return {xi: xi, xi_prime: xi_prime, yi: yi, yi_prime: yi_prime};
|
|
};
|
|
|
|
/**
|
|
* Check if a point is on a line segment.
|
|
*
|
|
* @param {number} x The X coordinate of the point to check.
|
|
* @param {number} y The Y coordinate of the point to check.
|
|
* @param {number} x1 The X coordinate of the line start point.
|
|
* @param {number} y1 The Y coordinate of the line start point.
|
|
* @param {number} x2 The X coordinate of the line end point.
|
|
* @param {number} y2 The Y coordinate of the line end point.
|
|
* @param {number} epsilon The precision (consider the line thickness).
|
|
* @return {boolean} True if point is "close to" the line
|
|
* segment, false otherwise.
|
|
*/
|
|
sigma.utils.isPointOnSegment = function(x, y, x1, y1, x2, y2, epsilon) {
|
|
// http://stackoverflow.com/a/328122
|
|
var crossProduct = Math.abs((y - y1) * (x2 - x1) - (x - x1) * (y2 - y1)),
|
|
d = sigma.utils.getDistance(x1, y1, x2, y2),
|
|
nCrossProduct = crossProduct / d; // normalized cross product
|
|
|
|
return (nCrossProduct < epsilon &&
|
|
Math.min(x1, x2) <= x && x <= Math.max(x1, x2) &&
|
|
Math.min(y1, y2) <= y && y <= Math.max(y1, y2));
|
|
};
|
|
|
|
/**
|
|
* Check if a point is on a quadratic bezier curve segment with a thickness.
|
|
*
|
|
* @param {number} x The X coordinate of the point to check.
|
|
* @param {number} y The Y coordinate of the point to check.
|
|
* @param {number} x1 The X coordinate of the curve start point.
|
|
* @param {number} y1 The Y coordinate of the curve start point.
|
|
* @param {number} x2 The X coordinate of the curve end point.
|
|
* @param {number} y2 The Y coordinate of the curve end point.
|
|
* @param {number} cpx The X coordinate of the curve control point.
|
|
* @param {number} cpy The Y coordinate of the curve control point.
|
|
* @param {number} epsilon The precision (consider the line thickness).
|
|
* @return {boolean} True if (x,y) is on the curve segment,
|
|
* false otherwise.
|
|
*/
|
|
sigma.utils.isPointOnQuadraticCurve =
|
|
function(x, y, x1, y1, x2, y2, cpx, cpy, epsilon) {
|
|
// Fails if the point is too far from the extremities of the segment,
|
|
// preventing for more costly computation:
|
|
var dP1P2 = sigma.utils.getDistance(x1, y1, x2, y2);
|
|
if (Math.abs(x - x1) > dP1P2 || Math.abs(y - y1) > dP1P2) {
|
|
return false;
|
|
}
|
|
|
|
var dP1 = sigma.utils.getDistance(x, y, x1, y1),
|
|
dP2 = sigma.utils.getDistance(x, y, x2, y2),
|
|
t = 0.5,
|
|
r = (dP1 < dP2) ? -0.01 : 0.01,
|
|
rThreshold = 0.001,
|
|
i = 100,
|
|
pt = sigma.utils.getPointOnQuadraticCurve(t, x1, y1, x2, y2, cpx, cpy),
|
|
dt = sigma.utils.getDistance(x, y, pt.x, pt.y),
|
|
old_dt;
|
|
|
|
// This algorithm minimizes the distance from the point to the curve. It
|
|
// find the optimal t value where t=0 is the start point and t=1 is the end
|
|
// point of the curve, starting from t=0.5.
|
|
// It terminates because it runs a maximum of i interations.
|
|
while (i-- > 0 &&
|
|
t >= 0 && t <= 1 &&
|
|
(dt > epsilon) &&
|
|
(r > rThreshold || r < -rThreshold)) {
|
|
old_dt = dt;
|
|
pt = sigma.utils.getPointOnQuadraticCurve(t, x1, y1, x2, y2, cpx, cpy);
|
|
dt = sigma.utils.getDistance(x, y, pt.x, pt.y);
|
|
|
|
if (dt > old_dt) {
|
|
// not the right direction:
|
|
// halfstep in the opposite direction
|
|
r = -r / 2;
|
|
t += r;
|
|
}
|
|
else if (t + r < 0 || t + r > 1) {
|
|
// oops, we've gone too far:
|
|
// revert with a halfstep
|
|
r = r / 2;
|
|
dt = old_dt;
|
|
}
|
|
else {
|
|
// progress:
|
|
t += r;
|
|
}
|
|
}
|
|
|
|
return dt < epsilon;
|
|
};
|
|
|
|
|
|
/**
|
|
* Check if a point is on a cubic bezier curve segment with a thickness.
|
|
*
|
|
* @param {number} x The X coordinate of the point to check.
|
|
* @param {number} y The Y coordinate of the point to check.
|
|
* @param {number} x1 The X coordinate of the curve start point.
|
|
* @param {number} y1 The Y coordinate of the curve start point.
|
|
* @param {number} x2 The X coordinate of the curve end point.
|
|
* @param {number} y2 The Y coordinate of the curve end point.
|
|
* @param {number} cpx1 The X coordinate of the 1st curve control point.
|
|
* @param {number} cpy1 The Y coordinate of the 1st curve control point.
|
|
* @param {number} cpx2 The X coordinate of the 2nd curve control point.
|
|
* @param {number} cpy2 The Y coordinate of the 2nd curve control point.
|
|
* @param {number} epsilon The precision (consider the line thickness).
|
|
* @return {boolean} True if (x,y) is on the curve segment,
|
|
* false otherwise.
|
|
*/
|
|
sigma.utils.isPointOnBezierCurve =
|
|
function(x, y, x1, y1, x2, y2, cpx1, cpy1, cpx2, cpy2, epsilon) {
|
|
// Fails if the point is too far from the extremities of the segment,
|
|
// preventing for more costly computation:
|
|
var dP1CP1 = sigma.utils.getDistance(x1, y1, cpx1, cpy1);
|
|
if (Math.abs(x - x1) > dP1CP1 || Math.abs(y - y1) > dP1CP1) {
|
|
return false;
|
|
}
|
|
|
|
var dP1 = sigma.utils.getDistance(x, y, x1, y1),
|
|
dP2 = sigma.utils.getDistance(x, y, x2, y2),
|
|
t = 0.5,
|
|
r = (dP1 < dP2) ? -0.01 : 0.01,
|
|
rThreshold = 0.001,
|
|
i = 100,
|
|
pt = sigma.utils.getPointOnBezierCurve(
|
|
t, x1, y1, x2, y2, cpx1, cpy1, cpx2, cpy2),
|
|
dt = sigma.utils.getDistance(x, y, pt.x, pt.y),
|
|
old_dt;
|
|
|
|
// This algorithm minimizes the distance from the point to the curve. It
|
|
// find the optimal t value where t=0 is the start point and t=1 is the end
|
|
// point of the curve, starting from t=0.5.
|
|
// It terminates because it runs a maximum of i interations.
|
|
while (i-- > 0 &&
|
|
t >= 0 && t <= 1 &&
|
|
(dt > epsilon) &&
|
|
(r > rThreshold || r < -rThreshold)) {
|
|
old_dt = dt;
|
|
pt = sigma.utils.getPointOnBezierCurve(
|
|
t, x1, y1, x2, y2, cpx1, cpy1, cpx2, cpy2);
|
|
dt = sigma.utils.getDistance(x, y, pt.x, pt.y);
|
|
|
|
if (dt > old_dt) {
|
|
// not the right direction:
|
|
// halfstep in the opposite direction
|
|
r = -r / 2;
|
|
t += r;
|
|
}
|
|
else if (t + r < 0 || t + r > 1) {
|
|
// oops, we've gone too far:
|
|
// revert with a halfstep
|
|
r = r / 2;
|
|
dt = old_dt;
|
|
}
|
|
else {
|
|
// progress:
|
|
t += r;
|
|
}
|
|
}
|
|
|
|
return dt < epsilon;
|
|
};
|
|
|
|
|
|
/**
|
|
* ************
|
|
* EVENTS UTILS:
|
|
* ************
|
|
*/
|
|
/**
|
|
* Here are some useful functions to unify extraction of the information we
|
|
* need with mouse events and touch events, from different browsers:
|
|
*/
|
|
|
|
/**
|
|
* Extract the local X position from a mouse or touch event.
|
|
*
|
|
* @param {event} e A mouse or touch event.
|
|
* @return {number} The local X value of the mouse.
|
|
*/
|
|
sigma.utils.getX = function(e) {
|
|
return (
|
|
(e.offsetX !== undefined && e.offsetX) ||
|
|
(e.layerX !== undefined && e.layerX) ||
|
|
(e.clientX !== undefined && e.clientX)
|
|
);
|
|
};
|
|
|
|
/**
|
|
* Extract the local Y position from a mouse or touch event.
|
|
*
|
|
* @param {event} e A mouse or touch event.
|
|
* @return {number} The local Y value of the mouse.
|
|
*/
|
|
sigma.utils.getY = function(e) {
|
|
return (
|
|
(e.offsetY !== undefined && e.offsetY) ||
|
|
(e.layerY !== undefined && e.layerY) ||
|
|
(e.clientY !== undefined && e.clientY)
|
|
);
|
|
};
|
|
|
|
/**
|
|
* Extract the width from a mouse or touch event.
|
|
*
|
|
* @param {event} e A mouse or touch event.
|
|
* @return {number} The width of the event's target.
|
|
*/
|
|
sigma.utils.getWidth = function(e) {
|
|
var w = (!e.target.ownerSVGElement) ?
|
|
e.target.width :
|
|
e.target.ownerSVGElement.width;
|
|
|
|
return (
|
|
(typeof w === 'number' && w) ||
|
|
(w !== undefined && w.baseVal !== undefined && w.baseVal.value)
|
|
);
|
|
};
|
|
|
|
/**
|
|
* Extract the height from a mouse or touch event.
|
|
*
|
|
* @param {event} e A mouse or touch event.
|
|
* @return {number} The height of the event's target.
|
|
*/
|
|
sigma.utils.getHeight = function(e) {
|
|
var h = (!e.target.ownerSVGElement) ?
|
|
e.target.height :
|
|
e.target.ownerSVGElement.height;
|
|
|
|
return (
|
|
(typeof h === 'number' && h) ||
|
|
(h !== undefined && h.baseVal !== undefined && h.baseVal.value)
|
|
);
|
|
};
|
|
|
|
/**
|
|
* Extract the wheel delta from a mouse or touch event.
|
|
*
|
|
* @param {event} e A mouse or touch event.
|
|
* @return {number} The wheel delta of the mouse.
|
|
*/
|
|
sigma.utils.getDelta = function(e) {
|
|
return (
|
|
(e.wheelDelta !== undefined && e.wheelDelta) ||
|
|
(e.detail !== undefined && -e.detail)
|
|
);
|
|
};
|
|
|
|
/**
|
|
* Returns the offset of a DOM element.
|
|
*
|
|
* @param {DOMElement} dom The element to retrieve the position.
|
|
* @return {object} The offset of the DOM element (top, left).
|
|
*/
|
|
sigma.utils.getOffset = function(dom) {
|
|
var left = 0,
|
|
top = 0;
|
|
|
|
while (dom) {
|
|
top = top + parseInt(dom.offsetTop);
|
|
left = left + parseInt(dom.offsetLeft);
|
|
dom = dom.offsetParent;
|
|
}
|
|
|
|
return {
|
|
top: top,
|
|
left: left
|
|
};
|
|
};
|
|
|
|
/**
|
|
* Simulates a "double click" event.
|
|
*
|
|
* @param {HTMLElement} target The event target.
|
|
* @param {string} type The event type.
|
|
* @param {function} callback The callback to execute.
|
|
*/
|
|
sigma.utils.doubleClick = function(target, type, callback) {
|
|
var clicks = 0,
|
|
self = this,
|
|
handlers;
|
|
|
|
target._doubleClickHandler = target._doubleClickHandler || {};
|
|
target._doubleClickHandler[type] = target._doubleClickHandler[type] || [];
|
|
handlers = target._doubleClickHandler[type];
|
|
|
|
handlers.push(function(e) {
|
|
clicks++;
|
|
|
|
if (clicks === 2) {
|
|
clicks = 0;
|
|
return callback(e);
|
|
} else if (clicks === 1) {
|
|
setTimeout(function() {
|
|
clicks = 0;
|
|
}, sigma.settings.doubleClickTimeout);
|
|
}
|
|
});
|
|
|
|
target.addEventListener(type, handlers[handlers.length - 1], false);
|
|
};
|
|
|
|
/**
|
|
* Unbind simulated "double click" events.
|
|
*
|
|
* @param {HTMLElement} target The event target.
|
|
* @param {string} type The event type.
|
|
*/
|
|
sigma.utils.unbindDoubleClick = function(target, type) {
|
|
var handler,
|
|
handlers = (target._doubleClickHandler || {})[type] || [];
|
|
|
|
while ((handler = handlers.pop())) {
|
|
target.removeEventListener(type, handler);
|
|
}
|
|
|
|
delete (target._doubleClickHandler || {})[type];
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* Here are just some of the most basic easing functions, used for the
|
|
* animated camera "goTo" calls.
|
|
*
|
|
* If you need some more easings functions, don't hesitate to add them to
|
|
* sigma.utils.easings. But I will not add some more here or merge PRs
|
|
* containing, because I do not want sigma sources full of overkill and never
|
|
* used stuff...
|
|
*/
|
|
sigma.utils.easings = sigma.utils.easings || {};
|
|
sigma.utils.easings.linearNone = function(k) {
|
|
return k;
|
|
};
|
|
sigma.utils.easings.quadraticIn = function(k) {
|
|
return k * k;
|
|
};
|
|
sigma.utils.easings.quadraticOut = function(k) {
|
|
return k * (2 - k);
|
|
};
|
|
sigma.utils.easings.quadraticInOut = function(k) {
|
|
if ((k *= 2) < 1)
|
|
return 0.5 * k * k;
|
|
return - 0.5 * (--k * (k - 2) - 1);
|
|
};
|
|
sigma.utils.easings.cubicIn = function(k) {
|
|
return k * k * k;
|
|
};
|
|
sigma.utils.easings.cubicOut = function(k) {
|
|
return --k * k * k + 1;
|
|
};
|
|
sigma.utils.easings.cubicInOut = function(k) {
|
|
if ((k *= 2) < 1)
|
|
return 0.5 * k * k * k;
|
|
return 0.5 * ((k -= 2) * k * k + 2);
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* ************
|
|
* WEBGL UTILS:
|
|
* ************
|
|
*/
|
|
/**
|
|
* Loads a WebGL shader and returns it.
|
|
*
|
|
* @param {WebGLContext} gl The WebGLContext to use.
|
|
* @param {string} shaderSource The shader source.
|
|
* @param {number} shaderType The type of shader.
|
|
* @param {function(string): void} error Callback for errors.
|
|
* @return {WebGLShader} The created shader.
|
|
*/
|
|
sigma.utils.loadShader = function(gl, shaderSource, shaderType, error) {
|
|
var compiled,
|
|
shader = gl.createShader(shaderType);
|
|
|
|
// Load the shader source
|
|
gl.shaderSource(shader, shaderSource);
|
|
|
|
// Compile the shader
|
|
gl.compileShader(shader);
|
|
|
|
// Check the compile status
|
|
compiled = gl.getShaderParameter(shader, gl.COMPILE_STATUS);
|
|
|
|
// If something went wrong:
|
|
if (!compiled) {
|
|
if (error) {
|
|
error(
|
|
'Error compiling shader "' + shader + '":' +
|
|
gl.getShaderInfoLog(shader)
|
|
);
|
|
}
|
|
|
|
gl.deleteShader(shader);
|
|
return null;
|
|
}
|
|
|
|
return shader;
|
|
};
|
|
|
|
/**
|
|
* Creates a program, attaches shaders, binds attrib locations, links the
|
|
* program and calls useProgram.
|
|
*
|
|
* @param {Array.<WebGLShader>} shaders The shaders to attach.
|
|
* @param {Array.<string>} attribs The attribs names.
|
|
* @param {Array.<number>} locations The locations for the attribs.
|
|
* @param {function(string): void} error Callback for errors.
|
|
* @return {WebGLProgram} The created program.
|
|
*/
|
|
sigma.utils.loadProgram = function(gl, shaders, attribs, loc, error) {
|
|
var i,
|
|
linked,
|
|
program = gl.createProgram();
|
|
|
|
for (i = 0; i < shaders.length; ++i)
|
|
gl.attachShader(program, shaders[i]);
|
|
|
|
if (attribs)
|
|
for (i = 0; i < attribs.length; ++i)
|
|
gl.bindAttribLocation(
|
|
program,
|
|
locations ? locations[i] : i,
|
|
opt_attribs[i]
|
|
);
|
|
|
|
gl.linkProgram(program);
|
|
|
|
// Check the link status
|
|
linked = gl.getProgramParameter(program, gl.LINK_STATUS);
|
|
if (!linked) {
|
|
if (error)
|
|
error('Error in program linking: ' + gl.getProgramInfoLog(program));
|
|
|
|
gl.deleteProgram(program);
|
|
return null;
|
|
}
|
|
|
|
return program;
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* *********
|
|
* MATRICES:
|
|
* *********
|
|
* The following utils are just here to help generating the transformation
|
|
* matrices for the WebGL renderers.
|
|
*/
|
|
sigma.utils.pkg('sigma.utils.matrices');
|
|
|
|
/**
|
|
* The returns a 3x3 translation matrix.
|
|
*
|
|
* @param {number} dx The X translation.
|
|
* @param {number} dy The Y translation.
|
|
* @return {array} Returns the matrix.
|
|
*/
|
|
sigma.utils.matrices.translation = function(dx, dy) {
|
|
return [
|
|
1, 0, 0,
|
|
0, 1, 0,
|
|
dx, dy, 1
|
|
];
|
|
};
|
|
|
|
/**
|
|
* The returns a 3x3 or 2x2 rotation matrix.
|
|
*
|
|
* @param {number} angle The rotation angle.
|
|
* @param {boolean} m2 If true, the function will return a 2x2 matrix.
|
|
* @return {array} Returns the matrix.
|
|
*/
|
|
sigma.utils.matrices.rotation = function(angle, m2) {
|
|
var cos = Math.cos(angle),
|
|
sin = Math.sin(angle);
|
|
|
|
return m2 ? [
|
|
cos, -sin,
|
|
sin, cos
|
|
] : [
|
|
cos, -sin, 0,
|
|
sin, cos, 0,
|
|
0, 0, 1
|
|
];
|
|
};
|
|
|
|
/**
|
|
* The returns a 3x3 or 2x2 homothetic transformation matrix.
|
|
*
|
|
* @param {number} ratio The scaling ratio.
|
|
* @param {boolean} m2 If true, the function will return a 2x2 matrix.
|
|
* @return {array} Returns the matrix.
|
|
*/
|
|
sigma.utils.matrices.scale = function(ratio, m2) {
|
|
return m2 ? [
|
|
ratio, 0,
|
|
0, ratio
|
|
] : [
|
|
ratio, 0, 0,
|
|
0, ratio, 0,
|
|
0, 0, 1
|
|
];
|
|
};
|
|
|
|
/**
|
|
* The returns a 3x3 or 2x2 homothetic transformation matrix.
|
|
*
|
|
* @param {array} a The first matrix.
|
|
* @param {array} b The second matrix.
|
|
* @param {boolean} m2 If true, the function will assume both matrices are
|
|
* 2x2.
|
|
* @return {array} Returns the matrix.
|
|
*/
|
|
sigma.utils.matrices.multiply = function(a, b, m2) {
|
|
var l = m2 ? 2 : 3,
|
|
a00 = a[0 * l + 0],
|
|
a01 = a[0 * l + 1],
|
|
a02 = a[0 * l + 2],
|
|
a10 = a[1 * l + 0],
|
|
a11 = a[1 * l + 1],
|
|
a12 = a[1 * l + 2],
|
|
a20 = a[2 * l + 0],
|
|
a21 = a[2 * l + 1],
|
|
a22 = a[2 * l + 2],
|
|
b00 = b[0 * l + 0],
|
|
b01 = b[0 * l + 1],
|
|
b02 = b[0 * l + 2],
|
|
b10 = b[1 * l + 0],
|
|
b11 = b[1 * l + 1],
|
|
b12 = b[1 * l + 2],
|
|
b20 = b[2 * l + 0],
|
|
b21 = b[2 * l + 1],
|
|
b22 = b[2 * l + 2];
|
|
|
|
return m2 ? [
|
|
a00 * b00 + a01 * b10,
|
|
a00 * b01 + a01 * b11,
|
|
a10 * b00 + a11 * b10,
|
|
a10 * b01 + a11 * b11
|
|
] : [
|
|
a00 * b00 + a01 * b10 + a02 * b20,
|
|
a00 * b01 + a01 * b11 + a02 * b21,
|
|
a00 * b02 + a01 * b12 + a02 * b22,
|
|
a10 * b00 + a11 * b10 + a12 * b20,
|
|
a10 * b01 + a11 * b11 + a12 * b21,
|
|
a10 * b02 + a11 * b12 + a12 * b22,
|
|
a20 * b00 + a21 * b10 + a22 * b20,
|
|
a20 * b01 + a21 * b11 + a22 * b21,
|
|
a20 * b02 + a21 * b12 + a22 * b22
|
|
];
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(global) {
|
|
'use strict';
|
|
|
|
/**
|
|
* http://paulirish.com/2011/requestanimationframe-for-smart-animating/
|
|
* http://my.opera.com/emoller/blog/2011/12/20/requestanimationframe-for-smart-er-animating
|
|
* requestAnimationFrame polyfill by Erik Möller.
|
|
* fixes from Paul Irish and Tino Zijdel
|
|
* MIT license
|
|
*/
|
|
var x,
|
|
lastTime = 0,
|
|
vendors = ['ms', 'moz', 'webkit', 'o'];
|
|
|
|
for (x = 0; x < vendors.length && !global.requestAnimationFrame; x++) {
|
|
global.requestAnimationFrame =
|
|
global[vendors[x] + 'RequestAnimationFrame'];
|
|
global.cancelAnimationFrame =
|
|
global[vendors[x] + 'CancelAnimationFrame'] ||
|
|
global[vendors[x] + 'CancelRequestAnimationFrame'];
|
|
}
|
|
|
|
if (!global.requestAnimationFrame)
|
|
global.requestAnimationFrame = function(callback, element) {
|
|
var currTime = new Date().getTime(),
|
|
timeToCall = Math.max(0, 16 - (currTime - lastTime)),
|
|
id = global.setTimeout(
|
|
function() {
|
|
callback(currTime + timeToCall);
|
|
},
|
|
timeToCall
|
|
);
|
|
|
|
lastTime = currTime + timeToCall;
|
|
return id;
|
|
};
|
|
|
|
if (!global.cancelAnimationFrame)
|
|
global.cancelAnimationFrame = function(id) {
|
|
clearTimeout(id);
|
|
};
|
|
|
|
/**
|
|
* Function.prototype.bind polyfill found on MDN.
|
|
* https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/bind#Compatibility
|
|
* Public domain
|
|
*/
|
|
if (!Function.prototype.bind)
|
|
Function.prototype.bind = function(oThis) {
|
|
if (typeof this !== 'function')
|
|
// Closest thing possible to the ECMAScript 5 internal IsCallable
|
|
// function:
|
|
throw new TypeError(
|
|
'Function.prototype.bind - what is trying to be bound is not callable'
|
|
);
|
|
|
|
var aArgs = Array.prototype.slice.call(arguments, 1),
|
|
fToBind = this,
|
|
fNOP,
|
|
fBound;
|
|
|
|
fNOP = function() {};
|
|
fBound = function() {
|
|
return fToBind.apply(
|
|
this instanceof fNOP && oThis ?
|
|
this :
|
|
oThis,
|
|
aArgs.concat(Array.prototype.slice.call(arguments))
|
|
);
|
|
};
|
|
|
|
fNOP.prototype = this.prototype;
|
|
fBound.prototype = new fNOP();
|
|
|
|
return fBound;
|
|
};
|
|
})(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Packages initialization:
|
|
sigma.utils.pkg('sigma.settings');
|
|
|
|
var settings = {
|
|
/**
|
|
* GRAPH SETTINGS:
|
|
* ***************
|
|
*/
|
|
// {boolean} Indicates if the data have to be cloned in methods to add
|
|
// nodes or edges.
|
|
clone: true,
|
|
// {boolean} Indicates if nodes "id" values and edges "id", "source" and
|
|
// "target" values must be set as immutable.
|
|
immutable: true,
|
|
// {boolean} Indicates if sigma can log its errors and warnings.
|
|
verbose: false,
|
|
|
|
|
|
/**
|
|
* RENDERERS SETTINGS:
|
|
* *******************
|
|
*/
|
|
// {string}
|
|
classPrefix: 'sigma',
|
|
// {string}
|
|
defaultNodeType: 'def',
|
|
// {string}
|
|
defaultEdgeType: 'def',
|
|
// {string}
|
|
defaultLabelColor: '#000',
|
|
// {string}
|
|
defaultEdgeColor: '#000',
|
|
// {string}
|
|
defaultNodeColor: '#000',
|
|
// {string}
|
|
defaultLabelSize: 14,
|
|
// {string} Indicates how to choose the edges color. Available values:
|
|
// "source", "target", "default"
|
|
edgeColor: 'source',
|
|
// {number} Defines the minimal edge's arrow display size.
|
|
minArrowSize: 0,
|
|
// {string}
|
|
font: 'arial',
|
|
// {string} Example: 'bold'
|
|
fontStyle: '',
|
|
// {string} Indicates how to choose the labels color. Available values:
|
|
// "node", "default"
|
|
labelColor: 'default',
|
|
// {string} Indicates how to choose the labels size. Available values:
|
|
// "fixed", "proportional"
|
|
labelSize: 'fixed',
|
|
// {string} The ratio between the font size of the label and the node size.
|
|
labelSizeRatio: 1,
|
|
// {number} The minimum size a node must have to see its label displayed.
|
|
labelThreshold: 8,
|
|
// {number} The oversampling factor used in WebGL renderer.
|
|
webglOversamplingRatio: 2,
|
|
// {number} The size of the border of hovered nodes.
|
|
borderSize: 0,
|
|
// {number} The default hovered node border's color.
|
|
defaultNodeBorderColor: '#000',
|
|
// {number} The hovered node's label font. If not specified, will heritate
|
|
// the "font" value.
|
|
hoverFont: '',
|
|
// {boolean} If true, then only one node can be hovered at a time.
|
|
singleHover: true,
|
|
// {string} Example: 'bold'
|
|
hoverFontStyle: '',
|
|
// {string} Indicates how to choose the hovered nodes shadow color.
|
|
// Available values: "node", "default"
|
|
labelHoverShadow: 'default',
|
|
// {string}
|
|
labelHoverShadowColor: '#000',
|
|
// {string} Indicates how to choose the hovered nodes color.
|
|
// Available values: "node", "default"
|
|
nodeHoverColor: 'node',
|
|
// {string}
|
|
defaultNodeHoverColor: '#000',
|
|
// {string} Indicates how to choose the hovered nodes background color.
|
|
// Available values: "node", "default"
|
|
labelHoverBGColor: 'default',
|
|
// {string}
|
|
defaultHoverLabelBGColor: '#fff',
|
|
// {string} Indicates how to choose the hovered labels color.
|
|
// Available values: "node", "default"
|
|
labelHoverColor: 'default',
|
|
// {string}
|
|
defaultLabelHoverColor: '#000',
|
|
// {string} Indicates how to choose the edges hover color. Available values:
|
|
// "edge", "default"
|
|
edgeHoverColor: 'edge',
|
|
// {number} The size multiplicator of hovered edges.
|
|
edgeHoverSizeRatio: 1,
|
|
// {string}
|
|
defaultEdgeHoverColor: '#000',
|
|
// {boolean} Indicates if the edge extremities must be hovered when the
|
|
// edge is hovered.
|
|
edgeHoverExtremities: false,
|
|
// {booleans} The different drawing modes:
|
|
// false: Layered not displayed.
|
|
// true: Layered displayed.
|
|
drawEdges: true,
|
|
drawNodes: true,
|
|
drawLabels: true,
|
|
drawEdgeLabels: false,
|
|
// {boolean} Indicates if the edges must be drawn in several frames or in
|
|
// one frame, as the nodes and labels are drawn.
|
|
batchEdgesDrawing: false,
|
|
// {boolean} Indicates if the edges must be hidden during dragging and
|
|
// animations.
|
|
hideEdgesOnMove: false,
|
|
// {numbers} The different batch sizes, when elements are displayed in
|
|
// several frames.
|
|
canvasEdgesBatchSize: 500,
|
|
webglEdgesBatchSize: 1000,
|
|
|
|
|
|
|
|
|
|
/**
|
|
* RESCALE SETTINGS:
|
|
* *****************
|
|
*/
|
|
// {string} Indicates of to scale the graph relatively to its container.
|
|
// Available values: "inside", "outside"
|
|
scalingMode: 'inside',
|
|
// {number} The margin to keep around the graph.
|
|
sideMargin: 0,
|
|
// {number} Determine the size of the smallest and the biggest node / edges
|
|
// on the screen. This mapping makes easier to display the graph,
|
|
// avoiding too big nodes that take half of the screen, or too
|
|
// small ones that are not readable. If the two parameters are
|
|
// equals, then the minimal display size will be 0. And if they
|
|
// are both equal to 0, then there is no mapping, and the radius
|
|
// of the nodes will be their size.
|
|
minEdgeSize: 0.5,
|
|
maxEdgeSize: 1,
|
|
minNodeSize: 1,
|
|
maxNodeSize: 8,
|
|
|
|
|
|
|
|
|
|
/**
|
|
* CAPTORS SETTINGS:
|
|
* *****************
|
|
*/
|
|
// {boolean}
|
|
touchEnabled: true,
|
|
// {boolean}
|
|
mouseEnabled: true,
|
|
// {boolean}
|
|
mouseWheelEnabled: true,
|
|
// {boolean}
|
|
doubleClickEnabled: true,
|
|
// {boolean} Defines whether the custom events such as "clickNode" can be
|
|
// used.
|
|
eventsEnabled: true,
|
|
// {number} Defines by how much multiplicating the zooming level when the
|
|
// user zooms with the mouse-wheel.
|
|
zoomingRatio: 1.7,
|
|
// {number} Defines by how much multiplicating the zooming level when the
|
|
// user zooms by double clicking.
|
|
doubleClickZoomingRatio: 2.2,
|
|
// {number} The minimum zooming level.
|
|
zoomMin: 0.0625,
|
|
// {number} The maximum zooming level.
|
|
zoomMax: 2,
|
|
// {number} The duration of animations following a mouse scrolling.
|
|
mouseZoomDuration: 200,
|
|
// {number} The duration of animations following a mouse double click.
|
|
doubleClickZoomDuration: 200,
|
|
// {number} The duration of animations following a mouse dropping.
|
|
mouseInertiaDuration: 200,
|
|
// {number} The inertia power (mouse captor).
|
|
mouseInertiaRatio: 3,
|
|
// {number} The duration of animations following a touch dropping.
|
|
touchInertiaDuration: 200,
|
|
// {number} The inertia power (touch captor).
|
|
touchInertiaRatio: 3,
|
|
// {number} The maximum time between two clicks to make it a double click.
|
|
doubleClickTimeout: 300,
|
|
// {number} The maximum time between two taps to make it a double tap.
|
|
doubleTapTimeout: 300,
|
|
// {number} The maximum time of dragging to trigger intertia.
|
|
dragTimeout: 200,
|
|
|
|
|
|
|
|
|
|
/**
|
|
* GLOBAL SETTINGS:
|
|
* ****************
|
|
*/
|
|
// {boolean} Determines whether the instance has to refresh itself
|
|
// automatically when a "resize" event is dispatched from the
|
|
// window object.
|
|
autoResize: true,
|
|
// {boolean} Determines whether the "rescale" middleware has to be called
|
|
// automatically for each camera on refresh.
|
|
autoRescale: true,
|
|
// {boolean} If set to false, the camera method "goTo" will basically do
|
|
// nothing.
|
|
enableCamera: true,
|
|
// {boolean} If set to false, the nodes cannot be hovered.
|
|
enableHovering: true,
|
|
// {boolean} If set to true, the edges can be hovered.
|
|
enableEdgeHovering: false,
|
|
// {number} The size of the area around the edges to activate hovering.
|
|
edgeHoverPrecision: 5,
|
|
// {boolean} If set to true, the rescale middleware will ignore node sizes
|
|
// to determine the graphs boundings.
|
|
rescaleIgnoreSize: false,
|
|
// {boolean} Determines if the core has to try to catch errors on
|
|
// rendering.
|
|
skipErrors: false,
|
|
|
|
|
|
|
|
|
|
/**
|
|
* CAMERA SETTINGS:
|
|
* ****************
|
|
*/
|
|
// {number} The power degrees applied to the nodes/edges size relatively to
|
|
// the zooming level. Basically:
|
|
// > onScreenR = Math.pow(zoom, nodesPowRatio) * R
|
|
// > onScreenT = Math.pow(zoom, edgesPowRatio) * T
|
|
nodesPowRatio: 0.5,
|
|
edgesPowRatio: 0.5,
|
|
|
|
|
|
|
|
|
|
/**
|
|
* ANIMATIONS SETTINGS:
|
|
* ********************
|
|
*/
|
|
// {number} The default animation time.
|
|
animationsTime: 200
|
|
};
|
|
|
|
// Export the previously designed settings:
|
|
sigma.settings = sigma.utils.extend(sigma.settings || {}, settings);
|
|
}).call(this);
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
/**
|
|
* Dispatcher constructor.
|
|
*
|
|
* @return {dispatcher} The new dispatcher instance.
|
|
*/
|
|
var dispatcher = function() {
|
|
Object.defineProperty(this, '_handlers', {
|
|
value: {}
|
|
});
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* Will execute the handler everytime that the indicated event (or the
|
|
* indicated events) will be triggered.
|
|
*
|
|
* @param {string} events The name of the event (or the events
|
|
* separated by spaces).
|
|
* @param {function(Object)} handler The handler to bind.
|
|
* @return {dispatcher} Returns the instance itself.
|
|
*/
|
|
dispatcher.prototype.bind = function(events, handler) {
|
|
var i,
|
|
l,
|
|
event,
|
|
eArray;
|
|
|
|
if (
|
|
arguments.length === 1 &&
|
|
typeof arguments[0] === 'object'
|
|
)
|
|
for (events in arguments[0])
|
|
this.bind(events, arguments[0][events]);
|
|
else if (
|
|
arguments.length === 2 &&
|
|
typeof arguments[1] === 'function'
|
|
) {
|
|
eArray = typeof events === 'string' ? events.split(' ') : events;
|
|
|
|
for (i = 0, l = eArray.length; i !== l; i += 1) {
|
|
event = eArray[i];
|
|
|
|
// Check that event is not '':
|
|
if (!event)
|
|
continue;
|
|
|
|
if (!this._handlers[event])
|
|
this._handlers[event] = [];
|
|
|
|
// Using an object instead of directly the handler will make possible
|
|
// later to add flags
|
|
this._handlers[event].push({
|
|
handler: handler
|
|
});
|
|
}
|
|
} else
|
|
throw 'bind: Wrong arguments.';
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Removes the handler from a specified event (or specified events).
|
|
*
|
|
* @param {?string} events The name of the event (or the events
|
|
* separated by spaces). If undefined,
|
|
* then all handlers are removed.
|
|
* @param {?function(object)} handler The handler to unbind. If undefined,
|
|
* each handler bound to the event or the
|
|
* events will be removed.
|
|
* @return {dispatcher} Returns the instance itself.
|
|
*/
|
|
dispatcher.prototype.unbind = function(events, handler) {
|
|
var i,
|
|
n,
|
|
j,
|
|
m,
|
|
k,
|
|
a,
|
|
event,
|
|
eArray = typeof events === 'string' ? events.split(' ') : events;
|
|
|
|
if (!arguments.length) {
|
|
for (k in this._handlers)
|
|
delete this._handlers[k];
|
|
return this;
|
|
}
|
|
|
|
if (handler) {
|
|
for (i = 0, n = eArray.length; i !== n; i += 1) {
|
|
event = eArray[i];
|
|
if (this._handlers[event]) {
|
|
a = [];
|
|
for (j = 0, m = this._handlers[event].length; j !== m; j += 1)
|
|
if (this._handlers[event][j].handler !== handler)
|
|
a.push(this._handlers[event][j]);
|
|
|
|
this._handlers[event] = a;
|
|
}
|
|
|
|
if (this._handlers[event] && this._handlers[event].length === 0)
|
|
delete this._handlers[event];
|
|
}
|
|
} else
|
|
for (i = 0, n = eArray.length; i !== n; i += 1)
|
|
delete this._handlers[eArray[i]];
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Executes each handler bound to the event
|
|
*
|
|
* @param {string} events The name of the event (or the events separated
|
|
* by spaces).
|
|
* @param {?object} data The content of the event (optional).
|
|
* @return {dispatcher} Returns the instance itself.
|
|
*/
|
|
dispatcher.prototype.dispatchEvent = function(events, data) {
|
|
var i,
|
|
n,
|
|
j,
|
|
m,
|
|
a,
|
|
event,
|
|
eventName,
|
|
self = this,
|
|
eArray = typeof events === 'string' ? events.split(' ') : events;
|
|
|
|
data = data === undefined ? {} : data;
|
|
|
|
for (i = 0, n = eArray.length; i !== n; i += 1) {
|
|
eventName = eArray[i];
|
|
|
|
if (this._handlers[eventName]) {
|
|
event = self.getEvent(eventName, data);
|
|
a = [];
|
|
|
|
for (j = 0, m = this._handlers[eventName].length; j !== m; j += 1) {
|
|
this._handlers[eventName][j].handler(event);
|
|
if (!this._handlers[eventName][j].one)
|
|
a.push(this._handlers[eventName][j]);
|
|
}
|
|
|
|
this._handlers[eventName] = a;
|
|
}
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Return an event object.
|
|
*
|
|
* @param {string} events The name of the event.
|
|
* @param {?object} data The content of the event (optional).
|
|
* @return {object} Returns the instance itself.
|
|
*/
|
|
dispatcher.prototype.getEvent = function(event, data) {
|
|
return {
|
|
type: event,
|
|
data: data || {},
|
|
target: this
|
|
};
|
|
};
|
|
|
|
/**
|
|
* A useful function to deal with inheritance. It will make the target
|
|
* inherit the prototype of the class dispatcher as well as its constructor.
|
|
*
|
|
* @param {object} target The target.
|
|
*/
|
|
dispatcher.extend = function(target, args) {
|
|
var k;
|
|
|
|
for (k in dispatcher.prototype)
|
|
if (dispatcher.prototype.hasOwnProperty(k))
|
|
target[k] = dispatcher.prototype[k];
|
|
|
|
dispatcher.apply(target, args);
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* EXPORT:
|
|
* *******
|
|
*/
|
|
if (typeof this.sigma !== 'undefined') {
|
|
this.sigma.classes = this.sigma.classes || {};
|
|
this.sigma.classes.dispatcher = dispatcher;
|
|
} else if (typeof exports !== 'undefined') {
|
|
if (typeof module !== 'undefined' && module.exports)
|
|
exports = module.exports = dispatcher;
|
|
exports.dispatcher = dispatcher;
|
|
} else
|
|
this.dispatcher = dispatcher;
|
|
}).call(this);
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
/**
|
|
* This utils aims to facilitate the manipulation of each instance setting.
|
|
* Using a function instead of an object brings two main advantages: First,
|
|
* it will be easier in the future to catch settings updates through a
|
|
* function than an object. Second, giving it a full object will "merge" it
|
|
* to the settings object properly, keeping us to have to always add a loop.
|
|
*
|
|
* @return {configurable} The "settings" function.
|
|
*/
|
|
var configurable = function() {
|
|
var i,
|
|
l,
|
|
data = {},
|
|
datas = Array.prototype.slice.call(arguments, 0);
|
|
|
|
/**
|
|
* The method to use to set or get any property of this instance.
|
|
*
|
|
* @param {string|object} a1 If it is a string and if a2 is undefined,
|
|
* then it will return the corresponding
|
|
* property. If it is a string and if a2 is
|
|
* set, then it will set a2 as the property
|
|
* corresponding to a1, and return this. If
|
|
* it is an object, then each pair string +
|
|
* object(or any other type) will be set as a
|
|
* property.
|
|
* @param {*?} a2 The new property corresponding to a1 if a1
|
|
* is a string.
|
|
* @return {*|configurable} Returns itself or the corresponding
|
|
* property.
|
|
*
|
|
* Polymorphism:
|
|
* *************
|
|
* Here are some basic use examples:
|
|
*
|
|
* > settings = new configurable();
|
|
* > settings('mySetting', 42);
|
|
* > settings('mySetting'); // Logs: 42
|
|
* > settings('mySetting', 123);
|
|
* > settings('mySetting'); // Logs: 123
|
|
* > settings({mySetting: 456});
|
|
* > settings('mySetting'); // Logs: 456
|
|
*
|
|
* Also, it is possible to use the function as a fallback:
|
|
* > settings({mySetting: 'abc'}, 'mySetting'); // Logs: 'abc'
|
|
* > settings({hisSetting: 'abc'}, 'mySetting'); // Logs: 456
|
|
*/
|
|
var settings = function(a1, a2) {
|
|
var o,
|
|
i,
|
|
l,
|
|
k;
|
|
|
|
if (arguments.length === 1 && typeof a1 === 'string') {
|
|
if (data[a1] !== undefined)
|
|
return data[a1];
|
|
for (i = 0, l = datas.length; i < l; i++)
|
|
if (datas[i][a1] !== undefined)
|
|
return datas[i][a1];
|
|
return undefined;
|
|
} else if (typeof a1 === 'object' && typeof a2 === 'string') {
|
|
return (a1 || {})[a2] !== undefined ? a1[a2] : settings(a2);
|
|
} else {
|
|
o = (typeof a1 === 'object' && a2 === undefined) ? a1 : {};
|
|
|
|
if (typeof a1 === 'string')
|
|
o[a1] = a2;
|
|
|
|
for (i = 0, k = Object.keys(o), l = k.length; i < l; i++)
|
|
data[k[i]] = o[k[i]];
|
|
|
|
return this;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* This method returns a new configurable function, with new objects
|
|
*
|
|
* @param {object*} Any number of objects to search in.
|
|
* @return {function} Returns the function. Check its documentation to know
|
|
* more about how it works.
|
|
*/
|
|
settings.embedObjects = function() {
|
|
var args = datas.concat(
|
|
data
|
|
).concat(
|
|
Array.prototype.splice.call(arguments, 0)
|
|
);
|
|
|
|
return configurable.apply({}, args);
|
|
};
|
|
|
|
// Initialize
|
|
for (i = 0, l = arguments.length; i < l; i++)
|
|
settings(arguments[i]);
|
|
|
|
return settings;
|
|
};
|
|
|
|
/**
|
|
* EXPORT:
|
|
* *******
|
|
*/
|
|
if (typeof this.sigma !== 'undefined') {
|
|
this.sigma.classes = this.sigma.classes || {};
|
|
this.sigma.classes.configurable = configurable;
|
|
} else if (typeof exports !== 'undefined') {
|
|
if (typeof module !== 'undefined' && module.exports)
|
|
exports = module.exports = configurable;
|
|
exports.configurable = configurable;
|
|
} else
|
|
this.configurable = configurable;
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
var _methods = Object.create(null),
|
|
_indexes = Object.create(null),
|
|
_initBindings = Object.create(null),
|
|
_methodBindings = Object.create(null),
|
|
_methodBeforeBindings = Object.create(null),
|
|
_defaultSettings = {
|
|
immutable: true,
|
|
clone: true
|
|
},
|
|
_defaultSettingsFunction = function(key) {
|
|
return _defaultSettings[key];
|
|
};
|
|
|
|
/**
|
|
* The graph constructor. It initializes the data and the indexes, and binds
|
|
* the custom indexes and methods to its own scope.
|
|
*
|
|
* Recognized parameters:
|
|
* **********************
|
|
* Here is the exhaustive list of every accepted parameters in the settings
|
|
* object:
|
|
*
|
|
* {boolean} clone Indicates if the data have to be cloned in methods
|
|
* to add nodes or edges.
|
|
* {boolean} immutable Indicates if nodes "id" values and edges "id",
|
|
* "source" and "target" values must be set as
|
|
* immutable.
|
|
*
|
|
* @param {?configurable} settings Eventually a settings function.
|
|
* @return {graph} The new graph instance.
|
|
*/
|
|
var graph = function(settings) {
|
|
var k,
|
|
fn,
|
|
data;
|
|
|
|
/**
|
|
* DATA:
|
|
* *****
|
|
* Every data that is callable from graph methods are stored in this "data"
|
|
* object. This object will be served as context for all these methods,
|
|
* and it is possible to add other type of data in it.
|
|
*/
|
|
data = {
|
|
/**
|
|
* SETTINGS FUNCTION:
|
|
* ******************
|
|
*/
|
|
settings: settings || _defaultSettingsFunction,
|
|
|
|
/**
|
|
* MAIN DATA:
|
|
* **********
|
|
*/
|
|
nodesArray: [],
|
|
edgesArray: [],
|
|
|
|
/**
|
|
* GLOBAL INDEXES:
|
|
* ***************
|
|
* These indexes just index data by ids.
|
|
*/
|
|
nodesIndex: Object.create(null),
|
|
edgesIndex: Object.create(null),
|
|
|
|
/**
|
|
* LOCAL INDEXES:
|
|
* **************
|
|
* These indexes refer from node to nodes. Each key is an id, and each
|
|
* value is the array of the ids of related nodes.
|
|
*/
|
|
inNeighborsIndex: Object.create(null),
|
|
outNeighborsIndex: Object.create(null),
|
|
allNeighborsIndex: Object.create(null),
|
|
|
|
inNeighborsCount: Object.create(null),
|
|
outNeighborsCount: Object.create(null),
|
|
allNeighborsCount: Object.create(null)
|
|
};
|
|
|
|
// Execute bindings:
|
|
for (k in _initBindings)
|
|
_initBindings[k].call(data);
|
|
|
|
// Add methods to both the scope and the data objects:
|
|
for (k in _methods) {
|
|
fn = __bindGraphMethod(k, data, _methods[k]);
|
|
this[k] = fn;
|
|
data[k] = fn;
|
|
}
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* A custom tool to bind methods such that function that are bound to it will
|
|
* be executed anytime the method is called.
|
|
*
|
|
* @param {string} methodName The name of the method to bind.
|
|
* @param {object} scope The scope where the method must be executed.
|
|
* @param {function} fn The method itself.
|
|
* @return {function} The new method.
|
|
*/
|
|
function __bindGraphMethod(methodName, scope, fn) {
|
|
var result = function() {
|
|
var k,
|
|
res;
|
|
|
|
// Execute "before" bound functions:
|
|
for (k in _methodBeforeBindings[methodName])
|
|
_methodBeforeBindings[methodName][k].apply(scope, arguments);
|
|
|
|
// Apply the method:
|
|
res = fn.apply(scope, arguments);
|
|
|
|
// Execute bound functions:
|
|
for (k in _methodBindings[methodName])
|
|
_methodBindings[methodName][k].apply(scope, arguments);
|
|
|
|
// Return res:
|
|
return res;
|
|
};
|
|
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* This custom tool function removes every pair key/value from an hash. The
|
|
* goal is to avoid creating a new object while some other references are
|
|
* still hanging in some scopes...
|
|
*
|
|
* @param {object} obj The object to empty.
|
|
* @return {object} The empty object.
|
|
*/
|
|
function __emptyObject(obj) {
|
|
var k;
|
|
|
|
for (k in obj)
|
|
if (!('hasOwnProperty' in obj) || obj.hasOwnProperty(k))
|
|
delete obj[k];
|
|
|
|
return obj;
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This global method adds a method that will be bound to the futurly created
|
|
* graph instances.
|
|
*
|
|
* Since these methods will be bound to their scope when the instances are
|
|
* created, it does not use the prototype. Because of that, methods have to
|
|
* be added before instances are created to make them available.
|
|
*
|
|
* Here is an example:
|
|
*
|
|
* > graph.addMethod('getNodesCount', function() {
|
|
* > return this.nodesArray.length;
|
|
* > });
|
|
* >
|
|
* > var myGraph = new graph();
|
|
* > console.log(myGraph.getNodesCount()); // outputs 0
|
|
*
|
|
* @param {string} methodName The name of the method.
|
|
* @param {function} fn The method itself.
|
|
* @return {object} The global graph constructor.
|
|
*/
|
|
graph.addMethod = function(methodName, fn) {
|
|
if (
|
|
typeof methodName !== 'string' ||
|
|
typeof fn !== 'function' ||
|
|
arguments.length !== 2
|
|
)
|
|
throw 'addMethod: Wrong arguments.';
|
|
|
|
if (_methods[methodName] || graph[methodName])
|
|
throw 'The method "' + methodName + '" already exists.';
|
|
|
|
_methods[methodName] = fn;
|
|
_methodBindings[methodName] = Object.create(null);
|
|
_methodBeforeBindings[methodName] = Object.create(null);
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This global method returns true if the method has already been added, and
|
|
* false else.
|
|
*
|
|
* Here are some examples:
|
|
*
|
|
* > graph.hasMethod('addNode'); // returns true
|
|
* > graph.hasMethod('hasMethod'); // returns true
|
|
* > graph.hasMethod('unexistingMethod'); // returns false
|
|
*
|
|
* @param {string} methodName The name of the method.
|
|
* @return {boolean} The result.
|
|
*/
|
|
graph.hasMethod = function(methodName) {
|
|
return !!(_methods[methodName] || graph[methodName]);
|
|
};
|
|
|
|
/**
|
|
* This global methods attaches a function to a method. Anytime the specified
|
|
* method is called, the attached function is called right after, with the
|
|
* same arguments and in the same scope. The attached function is called
|
|
* right before if the last argument is true, unless the method is the graph
|
|
* constructor.
|
|
*
|
|
* To attach a function to the graph constructor, use 'constructor' as the
|
|
* method name (first argument).
|
|
*
|
|
* The main idea is to have a clean way to keep custom indexes up to date,
|
|
* for instance:
|
|
*
|
|
* > var timesAddNodeCalled = 0;
|
|
* > graph.attach('addNode', 'timesAddNodeCalledInc', function() {
|
|
* > timesAddNodeCalled++;
|
|
* > });
|
|
* >
|
|
* > var myGraph = new graph();
|
|
* > console.log(timesAddNodeCalled); // outputs 0
|
|
* >
|
|
* > myGraph.addNode({ id: '1' }).addNode({ id: '2' });
|
|
* > console.log(timesAddNodeCalled); // outputs 2
|
|
*
|
|
* The idea for calling a function before is to provide pre-processors, for
|
|
* instance:
|
|
*
|
|
* > var colorPalette = { Person: '#C3CBE1', Place: '#9BDEBD' };
|
|
* > graph.attach('addNode', 'applyNodeColorPalette', function(n) {
|
|
* > n.color = colorPalette[n.category];
|
|
* > }, true);
|
|
* >
|
|
* > var myGraph = new graph();
|
|
* > myGraph.addNode({ id: 'n0', category: 'Person' });
|
|
* > console.log(myGraph.nodes('n0').color); // outputs '#C3CBE1'
|
|
*
|
|
* @param {string} methodName The name of the related method or
|
|
* "constructor".
|
|
* @param {string} key The key to identify the function to attach.
|
|
* @param {function} fn The function to bind.
|
|
* @param {boolean} before If true the function is called right before.
|
|
* @return {object} The global graph constructor.
|
|
*/
|
|
graph.attach = function(methodName, key, fn, before) {
|
|
if (
|
|
typeof methodName !== 'string' ||
|
|
typeof key !== 'string' ||
|
|
typeof fn !== 'function' ||
|
|
arguments.length < 3 ||
|
|
arguments.length > 4
|
|
)
|
|
throw 'attach: Wrong arguments.';
|
|
|
|
var bindings;
|
|
|
|
if (methodName === 'constructor')
|
|
bindings = _initBindings;
|
|
else {
|
|
if (before) {
|
|
if (!_methodBeforeBindings[methodName])
|
|
throw 'The method "' + methodName + '" does not exist.';
|
|
|
|
bindings = _methodBeforeBindings[methodName];
|
|
}
|
|
else {
|
|
if (!_methodBindings[methodName])
|
|
throw 'The method "' + methodName + '" does not exist.';
|
|
|
|
bindings = _methodBindings[methodName];
|
|
}
|
|
}
|
|
|
|
if (bindings[key])
|
|
throw 'A function "' + key + '" is already attached ' +
|
|
'to the method "' + methodName + '".';
|
|
|
|
bindings[key] = fn;
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Alias of attach(methodName, key, fn, true).
|
|
*/
|
|
graph.attachBefore = function(methodName, key, fn) {
|
|
return this.attach(methodName, key, fn, true);
|
|
};
|
|
|
|
/**
|
|
* This methods is just an helper to deal with custom indexes. It takes as
|
|
* arguments the name of the index and an object containing all the different
|
|
* functions to bind to the methods.
|
|
*
|
|
* Here is a basic example, that creates an index to keep the number of nodes
|
|
* in the current graph. It also adds a method to provide a getter on that
|
|
* new index:
|
|
*
|
|
* > sigma.classes.graph.addIndex('nodesCount', {
|
|
* > constructor: function() {
|
|
* > this.nodesCount = 0;
|
|
* > },
|
|
* > addNode: function() {
|
|
* > this.nodesCount++;
|
|
* > },
|
|
* > dropNode: function() {
|
|
* > this.nodesCount--;
|
|
* > }
|
|
* > });
|
|
* >
|
|
* > sigma.classes.graph.addMethod('getNodesCount', function() {
|
|
* > return this.nodesCount;
|
|
* > });
|
|
* >
|
|
* > var myGraph = new sigma.classes.graph();
|
|
* > console.log(myGraph.getNodesCount()); // outputs 0
|
|
* >
|
|
* > myGraph.addNode({ id: '1' }).addNode({ id: '2' });
|
|
* > console.log(myGraph.getNodesCount()); // outputs 2
|
|
*
|
|
* @param {string} name The name of the index.
|
|
* @param {object} bindings The object containing the functions to bind.
|
|
* @return {object} The global graph constructor.
|
|
*/
|
|
graph.addIndex = function(name, bindings) {
|
|
if (
|
|
typeof name !== 'string' ||
|
|
Object(bindings) !== bindings ||
|
|
arguments.length !== 2
|
|
)
|
|
throw 'addIndex: Wrong arguments.';
|
|
|
|
if (_indexes[name])
|
|
throw 'The index "' + name + '" already exists.';
|
|
|
|
var k;
|
|
|
|
// Store the bindings:
|
|
_indexes[name] = bindings;
|
|
|
|
// Attach the bindings:
|
|
for (k in bindings)
|
|
if (typeof bindings[k] !== 'function')
|
|
throw 'The bindings must be functions.';
|
|
else
|
|
graph.attach(k, name, bindings[k]);
|
|
|
|
return this;
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This method adds a node to the graph. The node must be an object, with a
|
|
* string under the key "id". Except for this, it is possible to add any
|
|
* other attribute, that will be preserved all along the manipulations.
|
|
*
|
|
* If the graph option "clone" has a truthy value, the node will be cloned
|
|
* when added to the graph. Also, if the graph option "immutable" has a
|
|
* truthy value, its id will be defined as immutable.
|
|
*
|
|
* @param {object} node The node to add.
|
|
* @return {object} The graph instance.
|
|
*/
|
|
graph.addMethod('addNode', function(node) {
|
|
// Check that the node is an object and has an id:
|
|
if (Object(node) !== node || arguments.length !== 1)
|
|
throw 'addNode: Wrong arguments.';
|
|
|
|
if (typeof node.id !== 'string' && typeof node.id !== 'number')
|
|
throw 'The node must have a string or number id.';
|
|
|
|
if (this.nodesIndex[node.id])
|
|
throw 'The node "' + node.id + '" already exists.';
|
|
|
|
var k,
|
|
id = node.id,
|
|
validNode = Object.create(null);
|
|
|
|
// Check the "clone" option:
|
|
if (this.settings('clone')) {
|
|
for (k in node)
|
|
if (k !== 'id')
|
|
validNode[k] = node[k];
|
|
} else
|
|
validNode = node;
|
|
|
|
// Check the "immutable" option:
|
|
if (this.settings('immutable'))
|
|
Object.defineProperty(validNode, 'id', {
|
|
value: id,
|
|
enumerable: true
|
|
});
|
|
else
|
|
validNode.id = id;
|
|
|
|
// Add empty containers for edges indexes:
|
|
this.inNeighborsIndex[id] = Object.create(null);
|
|
this.outNeighborsIndex[id] = Object.create(null);
|
|
this.allNeighborsIndex[id] = Object.create(null);
|
|
|
|
this.inNeighborsCount[id] = 0;
|
|
this.outNeighborsCount[id] = 0;
|
|
this.allNeighborsCount[id] = 0;
|
|
|
|
// Add the node to indexes:
|
|
this.nodesArray.push(validNode);
|
|
this.nodesIndex[validNode.id] = validNode;
|
|
|
|
// Return the current instance:
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* This method adds an edge to the graph. The edge must be an object, with a
|
|
* string under the key "id", and strings under the keys "source" and
|
|
* "target" that design existing nodes. Except for this, it is possible to
|
|
* add any other attribute, that will be preserved all along the
|
|
* manipulations.
|
|
*
|
|
* If the graph option "clone" has a truthy value, the edge will be cloned
|
|
* when added to the graph. Also, if the graph option "immutable" has a
|
|
* truthy value, its id, source and target will be defined as immutable.
|
|
*
|
|
* @param {object} edge The edge to add.
|
|
* @return {object} The graph instance.
|
|
*/
|
|
graph.addMethod('addEdge', function(edge) {
|
|
// Check that the edge is an object and has an id:
|
|
if (Object(edge) !== edge || arguments.length !== 1)
|
|
throw 'addEdge: Wrong arguments.';
|
|
|
|
if (typeof edge.id !== 'string' && typeof edge.id !== 'number')
|
|
throw 'The edge must have a string or number id.';
|
|
|
|
if ((typeof edge.source !== 'string' && typeof edge.source !== 'number') ||
|
|
!this.nodesIndex[edge.source])
|
|
throw 'The edge source must have an existing node id.';
|
|
|
|
if ((typeof edge.target !== 'string' && typeof edge.target !== 'number') ||
|
|
!this.nodesIndex[edge.target])
|
|
throw 'The edge target must have an existing node id.';
|
|
|
|
if (this.edgesIndex[edge.id])
|
|
throw 'The edge "' + edge.id + '" already exists.';
|
|
|
|
var k,
|
|
validEdge = Object.create(null);
|
|
|
|
// Check the "clone" option:
|
|
if (this.settings('clone')) {
|
|
for (k in edge)
|
|
if (k !== 'id' && k !== 'source' && k !== 'target')
|
|
validEdge[k] = edge[k];
|
|
} else
|
|
validEdge = edge;
|
|
|
|
// Check the "immutable" option:
|
|
if (this.settings('immutable')) {
|
|
Object.defineProperty(validEdge, 'id', {
|
|
value: edge.id,
|
|
enumerable: true
|
|
});
|
|
|
|
Object.defineProperty(validEdge, 'source', {
|
|
value: edge.source,
|
|
enumerable: true
|
|
});
|
|
|
|
Object.defineProperty(validEdge, 'target', {
|
|
value: edge.target,
|
|
enumerable: true
|
|
});
|
|
} else {
|
|
validEdge.id = edge.id;
|
|
validEdge.source = edge.source;
|
|
validEdge.target = edge.target;
|
|
}
|
|
|
|
// Add the edge to indexes:
|
|
this.edgesArray.push(validEdge);
|
|
this.edgesIndex[validEdge.id] = validEdge;
|
|
|
|
if (!this.inNeighborsIndex[validEdge.target][validEdge.source])
|
|
this.inNeighborsIndex[validEdge.target][validEdge.source] =
|
|
Object.create(null);
|
|
this.inNeighborsIndex[validEdge.target][validEdge.source][validEdge.id] =
|
|
validEdge;
|
|
|
|
if (!this.outNeighborsIndex[validEdge.source][validEdge.target])
|
|
this.outNeighborsIndex[validEdge.source][validEdge.target] =
|
|
Object.create(null);
|
|
this.outNeighborsIndex[validEdge.source][validEdge.target][validEdge.id] =
|
|
validEdge;
|
|
|
|
if (!this.allNeighborsIndex[validEdge.source][validEdge.target])
|
|
this.allNeighborsIndex[validEdge.source][validEdge.target] =
|
|
Object.create(null);
|
|
this.allNeighborsIndex[validEdge.source][validEdge.target][validEdge.id] =
|
|
validEdge;
|
|
|
|
if (validEdge.target !== validEdge.source) {
|
|
if (!this.allNeighborsIndex[validEdge.target][validEdge.source])
|
|
this.allNeighborsIndex[validEdge.target][validEdge.source] =
|
|
Object.create(null);
|
|
this.allNeighborsIndex[validEdge.target][validEdge.source][validEdge.id] =
|
|
validEdge;
|
|
}
|
|
|
|
// Keep counts up to date:
|
|
this.inNeighborsCount[validEdge.target]++;
|
|
this.outNeighborsCount[validEdge.source]++;
|
|
this.allNeighborsCount[validEdge.target]++;
|
|
this.allNeighborsCount[validEdge.source]++;
|
|
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* This method drops a node from the graph. It also removes each edge that is
|
|
* bound to it, through the dropEdge method. An error is thrown if the node
|
|
* does not exist.
|
|
*
|
|
* @param {string} id The node id.
|
|
* @return {object} The graph instance.
|
|
*/
|
|
graph.addMethod('dropNode', function(id) {
|
|
// Check that the arguments are valid:
|
|
if ((typeof id !== 'string' && typeof id !== 'number') ||
|
|
arguments.length !== 1)
|
|
throw 'dropNode: Wrong arguments.';
|
|
|
|
if (!this.nodesIndex[id])
|
|
throw 'The node "' + id + '" does not exist.';
|
|
|
|
var i, k, l;
|
|
|
|
// Remove the node from indexes:
|
|
delete this.nodesIndex[id];
|
|
for (i = 0, l = this.nodesArray.length; i < l; i++)
|
|
if (this.nodesArray[i].id === id) {
|
|
this.nodesArray.splice(i, 1);
|
|
break;
|
|
}
|
|
|
|
// Remove related edges:
|
|
for (i = this.edgesArray.length - 1; i >= 0; i--)
|
|
if (this.edgesArray[i].source === id || this.edgesArray[i].target === id)
|
|
this.dropEdge(this.edgesArray[i].id);
|
|
|
|
// Remove related edge indexes:
|
|
delete this.inNeighborsIndex[id];
|
|
delete this.outNeighborsIndex[id];
|
|
delete this.allNeighborsIndex[id];
|
|
|
|
delete this.inNeighborsCount[id];
|
|
delete this.outNeighborsCount[id];
|
|
delete this.allNeighborsCount[id];
|
|
|
|
for (k in this.nodesIndex) {
|
|
delete this.inNeighborsIndex[k][id];
|
|
delete this.outNeighborsIndex[k][id];
|
|
delete this.allNeighborsIndex[k][id];
|
|
}
|
|
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* This method drops an edge from the graph. An error is thrown if the edge
|
|
* does not exist.
|
|
*
|
|
* @param {string} id The edge id.
|
|
* @return {object} The graph instance.
|
|
*/
|
|
graph.addMethod('dropEdge', function(id) {
|
|
// Check that the arguments are valid:
|
|
if ((typeof id !== 'string' && typeof id !== 'number') ||
|
|
arguments.length !== 1)
|
|
throw 'dropEdge: Wrong arguments.';
|
|
|
|
if (!this.edgesIndex[id])
|
|
throw 'The edge "' + id + '" does not exist.';
|
|
|
|
var i, l, edge;
|
|
|
|
// Remove the edge from indexes:
|
|
edge = this.edgesIndex[id];
|
|
delete this.edgesIndex[id];
|
|
for (i = 0, l = this.edgesArray.length; i < l; i++)
|
|
if (this.edgesArray[i].id === id) {
|
|
this.edgesArray.splice(i, 1);
|
|
break;
|
|
}
|
|
|
|
delete this.inNeighborsIndex[edge.target][edge.source][edge.id];
|
|
if (!Object.keys(this.inNeighborsIndex[edge.target][edge.source]).length)
|
|
delete this.inNeighborsIndex[edge.target][edge.source];
|
|
|
|
delete this.outNeighborsIndex[edge.source][edge.target][edge.id];
|
|
if (!Object.keys(this.outNeighborsIndex[edge.source][edge.target]).length)
|
|
delete this.outNeighborsIndex[edge.source][edge.target];
|
|
|
|
delete this.allNeighborsIndex[edge.source][edge.target][edge.id];
|
|
if (!Object.keys(this.allNeighborsIndex[edge.source][edge.target]).length)
|
|
delete this.allNeighborsIndex[edge.source][edge.target];
|
|
|
|
if (edge.target !== edge.source) {
|
|
delete this.allNeighborsIndex[edge.target][edge.source][edge.id];
|
|
if (!Object.keys(this.allNeighborsIndex[edge.target][edge.source]).length)
|
|
delete this.allNeighborsIndex[edge.target][edge.source];
|
|
}
|
|
|
|
this.inNeighborsCount[edge.target]--;
|
|
this.outNeighborsCount[edge.source]--;
|
|
this.allNeighborsCount[edge.source]--;
|
|
this.allNeighborsCount[edge.target]--;
|
|
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* This method destroys the current instance. It basically empties each index
|
|
* and methods attached to the graph.
|
|
*/
|
|
graph.addMethod('kill', function() {
|
|
// Delete arrays:
|
|
this.nodesArray.length = 0;
|
|
this.edgesArray.length = 0;
|
|
delete this.nodesArray;
|
|
delete this.edgesArray;
|
|
|
|
// Delete indexes:
|
|
delete this.nodesIndex;
|
|
delete this.edgesIndex;
|
|
delete this.inNeighborsIndex;
|
|
delete this.outNeighborsIndex;
|
|
delete this.allNeighborsIndex;
|
|
delete this.inNeighborsCount;
|
|
delete this.outNeighborsCount;
|
|
delete this.allNeighborsCount;
|
|
});
|
|
|
|
/**
|
|
* This method empties the nodes and edges arrays, as well as the different
|
|
* indexes.
|
|
*
|
|
* @return {object} The graph instance.
|
|
*/
|
|
graph.addMethod('clear', function() {
|
|
this.nodesArray.length = 0;
|
|
this.edgesArray.length = 0;
|
|
|
|
// Due to GC issues, I prefer not to create new object. These objects are
|
|
// only available from the methods and attached functions, but still, it is
|
|
// better to prevent ghost references to unrelevant data...
|
|
__emptyObject(this.nodesIndex);
|
|
__emptyObject(this.edgesIndex);
|
|
__emptyObject(this.nodesIndex);
|
|
__emptyObject(this.inNeighborsIndex);
|
|
__emptyObject(this.outNeighborsIndex);
|
|
__emptyObject(this.allNeighborsIndex);
|
|
__emptyObject(this.inNeighborsCount);
|
|
__emptyObject(this.outNeighborsCount);
|
|
__emptyObject(this.allNeighborsCount);
|
|
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* This method reads an object and adds the nodes and edges, through the
|
|
* proper methods "addNode" and "addEdge".
|
|
*
|
|
* Here is an example:
|
|
*
|
|
* > var myGraph = new graph();
|
|
* > myGraph.read({
|
|
* > nodes: [
|
|
* > { id: 'n0' },
|
|
* > { id: 'n1' }
|
|
* > ],
|
|
* > edges: [
|
|
* > {
|
|
* > id: 'e0',
|
|
* > source: 'n0',
|
|
* > target: 'n1'
|
|
* > }
|
|
* > ]
|
|
* > });
|
|
* >
|
|
* > console.log(
|
|
* > myGraph.nodes().length,
|
|
* > myGraph.edges().length
|
|
* > ); // outputs 2 1
|
|
*
|
|
* @param {object} g The graph object.
|
|
* @return {object} The graph instance.
|
|
*/
|
|
graph.addMethod('read', function(g) {
|
|
var i,
|
|
a,
|
|
l;
|
|
|
|
a = g.nodes || [];
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
this.addNode(a[i]);
|
|
|
|
a = g.edges || [];
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
this.addEdge(a[i]);
|
|
|
|
return this;
|
|
});
|
|
|
|
/**
|
|
* This methods returns one or several nodes, depending on how it is called.
|
|
*
|
|
* To get the array of nodes, call "nodes" without argument. To get a
|
|
* specific node, call it with the id of the node. The get multiple node,
|
|
* call it with an array of ids, and it will return the array of nodes, in
|
|
* the same order.
|
|
*
|
|
* @param {?(string|array)} v Eventually one id, an array of ids.
|
|
* @return {object|array} The related node or array of nodes.
|
|
*/
|
|
graph.addMethod('nodes', function(v) {
|
|
// Clone the array of nodes and return it:
|
|
if (!arguments.length)
|
|
return this.nodesArray.slice(0);
|
|
|
|
// Return the related node:
|
|
if (arguments.length === 1 &&
|
|
(typeof v === 'string' || typeof v === 'number'))
|
|
return this.nodesIndex[v];
|
|
|
|
// Return an array of the related node:
|
|
if (
|
|
arguments.length === 1 &&
|
|
Object.prototype.toString.call(v) === '[object Array]'
|
|
) {
|
|
var i,
|
|
l,
|
|
a = [];
|
|
|
|
for (i = 0, l = v.length; i < l; i++)
|
|
if (typeof v[i] === 'string' || typeof v[i] === 'number')
|
|
a.push(this.nodesIndex[v[i]]);
|
|
else
|
|
throw 'nodes: Wrong arguments.';
|
|
|
|
return a;
|
|
}
|
|
|
|
throw 'nodes: Wrong arguments.';
|
|
});
|
|
|
|
/**
|
|
* This methods returns the degree of one or several nodes, depending on how
|
|
* it is called. It is also possible to get incoming or outcoming degrees
|
|
* instead by specifying 'in' or 'out' as a second argument.
|
|
*
|
|
* @param {string|array} v One id, an array of ids.
|
|
* @param {?string} which Which degree is required. Values are 'in',
|
|
* 'out', and by default the normal degree.
|
|
* @return {number|array} The related degree or array of degrees.
|
|
*/
|
|
graph.addMethod('degree', function(v, which) {
|
|
// Check which degree is required:
|
|
which = {
|
|
'in': this.inNeighborsCount,
|
|
'out': this.outNeighborsCount
|
|
}[which || ''] || this.allNeighborsCount;
|
|
|
|
// Return the related node:
|
|
if (typeof v === 'string' || typeof v === 'number')
|
|
return which[v];
|
|
|
|
// Return an array of the related node:
|
|
if (Object.prototype.toString.call(v) === '[object Array]') {
|
|
var i,
|
|
l,
|
|
a = [];
|
|
|
|
for (i = 0, l = v.length; i < l; i++)
|
|
if (typeof v[i] === 'string' || typeof v[i] === 'number')
|
|
a.push(which[v[i]]);
|
|
else
|
|
throw 'degree: Wrong arguments.';
|
|
|
|
return a;
|
|
}
|
|
|
|
throw 'degree: Wrong arguments.';
|
|
});
|
|
|
|
/**
|
|
* This methods returns one or several edges, depending on how it is called.
|
|
*
|
|
* To get the array of edges, call "edges" without argument. To get a
|
|
* specific edge, call it with the id of the edge. The get multiple edge,
|
|
* call it with an array of ids, and it will return the array of edges, in
|
|
* the same order.
|
|
*
|
|
* @param {?(string|array)} v Eventually one id, an array of ids.
|
|
* @return {object|array} The related edge or array of edges.
|
|
*/
|
|
graph.addMethod('edges', function(v) {
|
|
// Clone the array of edges and return it:
|
|
if (!arguments.length)
|
|
return this.edgesArray.slice(0);
|
|
|
|
// Return the related edge:
|
|
if (arguments.length === 1 &&
|
|
(typeof v === 'string' || typeof v === 'number'))
|
|
return this.edgesIndex[v];
|
|
|
|
// Return an array of the related edge:
|
|
if (
|
|
arguments.length === 1 &&
|
|
Object.prototype.toString.call(v) === '[object Array]'
|
|
) {
|
|
var i,
|
|
l,
|
|
a = [];
|
|
|
|
for (i = 0, l = v.length; i < l; i++)
|
|
if (typeof v[i] === 'string' || typeof v[i] === 'number')
|
|
a.push(this.edgesIndex[v[i]]);
|
|
else
|
|
throw 'edges: Wrong arguments.';
|
|
|
|
return a;
|
|
}
|
|
|
|
throw 'edges: Wrong arguments.';
|
|
});
|
|
|
|
|
|
/**
|
|
* EXPORT:
|
|
* *******
|
|
*/
|
|
if (typeof sigma !== 'undefined') {
|
|
sigma.classes = sigma.classes || Object.create(null);
|
|
sigma.classes.graph = graph;
|
|
} else if (typeof exports !== 'undefined') {
|
|
if (typeof module !== 'undefined' && module.exports)
|
|
exports = module.exports = graph;
|
|
exports.graph = graph;
|
|
} else
|
|
this.graph = graph;
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
sigma.utils.pkg('sigma.classes');
|
|
|
|
/**
|
|
* The camera constructor. It just initializes its attributes and methods.
|
|
*
|
|
* @param {string} id The id.
|
|
* @param {sigma.classes.graph} graph The graph.
|
|
* @param {configurable} settings The settings function.
|
|
* @param {?object} options Eventually some overriding options.
|
|
* @return {camera} Returns the fresh new camera instance.
|
|
*/
|
|
sigma.classes.camera = function(id, graph, settings, options) {
|
|
sigma.classes.dispatcher.extend(this);
|
|
|
|
Object.defineProperty(this, 'graph', {
|
|
value: graph
|
|
});
|
|
Object.defineProperty(this, 'id', {
|
|
value: id
|
|
});
|
|
Object.defineProperty(this, 'readPrefix', {
|
|
value: 'read_cam' + id + ':'
|
|
});
|
|
Object.defineProperty(this, 'prefix', {
|
|
value: 'cam' + id + ':'
|
|
});
|
|
|
|
this.x = 0;
|
|
this.y = 0;
|
|
this.ratio = 1;
|
|
this.angle = 0;
|
|
this.isAnimated = false;
|
|
this.settings = (typeof options === 'object' && options) ?
|
|
settings.embedObject(options) :
|
|
settings;
|
|
};
|
|
|
|
/**
|
|
* Updates the camera position.
|
|
*
|
|
* @param {object} coordinates The new coordinates object.
|
|
* @return {camera} Returns the camera.
|
|
*/
|
|
sigma.classes.camera.prototype.goTo = function(coordinates) {
|
|
if (!this.settings('enableCamera'))
|
|
return this;
|
|
|
|
var i,
|
|
l,
|
|
c = coordinates || {},
|
|
keys = ['x', 'y', 'ratio', 'angle'];
|
|
|
|
for (i = 0, l = keys.length; i < l; i++)
|
|
if (c[keys[i]] !== undefined) {
|
|
if (typeof c[keys[i]] === 'number' && !isNaN(c[keys[i]]))
|
|
this[keys[i]] = c[keys[i]];
|
|
else
|
|
throw 'Value for "' + keys[i] + '" is not a number.';
|
|
}
|
|
|
|
this.dispatchEvent('coordinatesUpdated');
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method takes a graph and computes for each node and edges its
|
|
* coordinates relatively to the center of the camera. Basically, it will
|
|
* compute the coordinates that will be used by the graphic renderers.
|
|
*
|
|
* Since it should be possible to use different cameras and different
|
|
* renderers, it is possible to specify a prefix to put before the new
|
|
* coordinates (to get something like "node.camera1_x")
|
|
*
|
|
* @param {?string} read The prefix of the coordinates to read.
|
|
* @param {?string} write The prefix of the coordinates to write.
|
|
* @param {?object} options Eventually an object of options. Those can be:
|
|
* - A restricted nodes array.
|
|
* - A restricted edges array.
|
|
* - A width.
|
|
* - A height.
|
|
* @return {camera} Returns the camera.
|
|
*/
|
|
sigma.classes.camera.prototype.applyView = function(read, write, options) {
|
|
options = options || {};
|
|
write = write !== undefined ? write : this.prefix;
|
|
read = read !== undefined ? read : this.readPrefix;
|
|
|
|
var nodes = options.nodes || this.graph.nodes(),
|
|
edges = options.edges || this.graph.edges();
|
|
|
|
var i,
|
|
l,
|
|
node,
|
|
cos = Math.cos(this.angle),
|
|
sin = Math.sin(this.angle);
|
|
|
|
for (i = 0, l = nodes.length; i < l; i++) {
|
|
node = nodes[i];
|
|
node[write + 'x'] =
|
|
(
|
|
((node[read + 'x'] || 0) - this.x) * cos +
|
|
((node[read + 'y'] || 0) - this.y) * sin
|
|
) / this.ratio + (options.width || 0) / 2;
|
|
node[write + 'y'] =
|
|
(
|
|
((node[read + 'y'] || 0) - this.y) * cos -
|
|
((node[read + 'x'] || 0) - this.x) * sin
|
|
) / this.ratio + (options.height || 0) / 2;
|
|
node[write + 'size'] =
|
|
(node[read + 'size'] || 0) /
|
|
Math.pow(this.ratio, this.settings('nodesPowRatio'));
|
|
}
|
|
|
|
for (i = 0, l = edges.length; i < l; i++) {
|
|
edges[i][write + 'size'] =
|
|
(edges[i][read + 'size'] || 0) /
|
|
Math.pow(this.ratio, this.settings('edgesPowRatio'));
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This function converts the coordinates of a point from the frame of the
|
|
* camera to the frame of the graph.
|
|
*
|
|
* @param {number} x The X coordinate of the point in the frame of the
|
|
* camera.
|
|
* @param {number} y The Y coordinate of the point in the frame of the
|
|
* camera.
|
|
* @return {object} The point coordinates in the frame of the graph.
|
|
*/
|
|
sigma.classes.camera.prototype.graphPosition = function(x, y, vector) {
|
|
var X = 0,
|
|
Y = 0,
|
|
cos = Math.cos(this.angle),
|
|
sin = Math.sin(this.angle);
|
|
|
|
// Revert the origin differential vector:
|
|
if (!vector) {
|
|
X = - (this.x * cos + this.y * sin) / this.ratio;
|
|
Y = - (this.y * cos - this.x * sin) / this.ratio;
|
|
}
|
|
|
|
return {
|
|
x: (x * cos + y * sin) / this.ratio + X,
|
|
y: (y * cos - x * sin) / this.ratio + Y
|
|
};
|
|
};
|
|
|
|
/**
|
|
* This function converts the coordinates of a point from the frame of the
|
|
* graph to the frame of the camera.
|
|
*
|
|
* @param {number} x The X coordinate of the point in the frame of the
|
|
* graph.
|
|
* @param {number} y The Y coordinate of the point in the frame of the
|
|
* graph.
|
|
* @return {object} The point coordinates in the frame of the camera.
|
|
*/
|
|
sigma.classes.camera.prototype.cameraPosition = function(x, y, vector) {
|
|
var X = 0,
|
|
Y = 0,
|
|
cos = Math.cos(this.angle),
|
|
sin = Math.sin(this.angle);
|
|
|
|
// Revert the origin differential vector:
|
|
if (!vector) {
|
|
X = - (this.x * cos + this.y * sin) / this.ratio;
|
|
Y = - (this.y * cos - this.x * sin) / this.ratio;
|
|
}
|
|
|
|
return {
|
|
x: ((x - X) * cos - (y - Y) * sin) * this.ratio,
|
|
y: ((y - Y) * cos + (x - X) * sin) * this.ratio
|
|
};
|
|
};
|
|
|
|
/**
|
|
* This method returns the transformation matrix of the camera. This is
|
|
* especially useful to apply the camera view directly in shaders, in case of
|
|
* WebGL rendering.
|
|
*
|
|
* @return {array} The transformation matrix.
|
|
*/
|
|
sigma.classes.camera.prototype.getMatrix = function() {
|
|
var scale = sigma.utils.matrices.scale(1 / this.ratio),
|
|
rotation = sigma.utils.matrices.rotation(this.angle),
|
|
translation = sigma.utils.matrices.translation(-this.x, -this.y),
|
|
matrix = sigma.utils.matrices.multiply(
|
|
translation,
|
|
sigma.utils.matrices.multiply(
|
|
rotation,
|
|
scale
|
|
)
|
|
);
|
|
|
|
return matrix;
|
|
};
|
|
|
|
/**
|
|
* Taking a width and a height as parameters, this method returns the
|
|
* coordinates of the rectangle representing the camera on screen, in the
|
|
* graph's referentiel.
|
|
*
|
|
* To keep displaying labels of nodes going out of the screen, the method
|
|
* keeps a margin around the screen in the returned rectangle.
|
|
*
|
|
* @param {number} width The width of the screen.
|
|
* @param {number} height The height of the screen.
|
|
* @return {object} The rectangle as x1, y1, x2 and y2, representing
|
|
* two opposite points.
|
|
*/
|
|
sigma.classes.camera.prototype.getRectangle = function(width, height) {
|
|
var widthVect = this.cameraPosition(width, 0, true),
|
|
heightVect = this.cameraPosition(0, height, true),
|
|
centerVect = this.cameraPosition(width / 2, height / 2, true),
|
|
marginX = this.cameraPosition(width / 4, 0, true).x,
|
|
marginY = this.cameraPosition(0, height / 4, true).y;
|
|
|
|
return {
|
|
x1: this.x - centerVect.x - marginX,
|
|
y1: this.y - centerVect.y - marginY,
|
|
x2: this.x - centerVect.x + marginX + widthVect.x,
|
|
y2: this.y - centerVect.y - marginY + widthVect.y,
|
|
height: Math.sqrt(
|
|
Math.pow(heightVect.x, 2) +
|
|
Math.pow(heightVect.y + 2 * marginY, 2)
|
|
)
|
|
};
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
/**
|
|
* Sigma Quadtree Module
|
|
* =====================
|
|
*
|
|
* Author: Guillaume Plique (Yomguithereal)
|
|
* Version: 0.2
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
* Quad Geometric Operations
|
|
* -------------------------
|
|
*
|
|
* A useful batch of geometric operations used by the quadtree.
|
|
*/
|
|
|
|
var _geom = {
|
|
|
|
/**
|
|
* Transforms a graph node with x, y and size into an
|
|
* axis-aligned square.
|
|
*
|
|
* @param {object} A graph node with at least a point (x, y) and a size.
|
|
* @return {object} A square: two points (x1, y1), (x2, y2) and height.
|
|
*/
|
|
pointToSquare: function(n) {
|
|
return {
|
|
x1: n.x - n.size,
|
|
y1: n.y - n.size,
|
|
x2: n.x + n.size,
|
|
y2: n.y - n.size,
|
|
height: n.size * 2
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Checks whether a rectangle is axis-aligned.
|
|
*
|
|
* @param {object} A rectangle defined by two points
|
|
* (x1, y1) and (x2, y2).
|
|
* @return {boolean} True if the rectangle is axis-aligned.
|
|
*/
|
|
isAxisAligned: function(r) {
|
|
return r.x1 === r.x2 || r.y1 === r.y2;
|
|
},
|
|
|
|
/**
|
|
* Compute top points of an axis-aligned rectangle. This is useful in
|
|
* cases when the rectangle has been rotated (left, right or bottom up) and
|
|
* later operations need to know the top points.
|
|
*
|
|
* @param {object} An axis-aligned rectangle defined by two points
|
|
* (x1, y1), (x2, y2) and height.
|
|
* @return {object} A rectangle: two points (x1, y1), (x2, y2) and height.
|
|
*/
|
|
axisAlignedTopPoints: function(r) {
|
|
|
|
// Basic
|
|
if (r.y1 === r.y2 && r.x1 < r.x2)
|
|
return r;
|
|
|
|
// Rotated to right
|
|
if (r.x1 === r.x2 && r.y2 > r.y1)
|
|
return {
|
|
x1: r.x1 - r.height, y1: r.y1,
|
|
x2: r.x1, y2: r.y1,
|
|
height: r.height
|
|
};
|
|
|
|
// Rotated to left
|
|
if (r.x1 === r.x2 && r.y2 < r.y1)
|
|
return {
|
|
x1: r.x1, y1: r.y2,
|
|
x2: r.x2 + r.height, y2: r.y2,
|
|
height: r.height
|
|
};
|
|
|
|
// Bottom's up
|
|
return {
|
|
x1: r.x2, y1: r.y1 - r.height,
|
|
x2: r.x1, y2: r.y1 - r.height,
|
|
height: r.height
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Get coordinates of a rectangle's lower left corner from its top points.
|
|
*
|
|
* @param {object} A rectangle defined by two points (x1, y1) and (x2, y2).
|
|
* @return {object} Coordinates of the corner (x, y).
|
|
*/
|
|
lowerLeftCoor: function(r) {
|
|
var width = (
|
|
Math.sqrt(
|
|
Math.pow(r.x2 - r.x1, 2) +
|
|
Math.pow(r.y2 - r.y1, 2)
|
|
)
|
|
);
|
|
|
|
return {
|
|
x: r.x1 - (r.y2 - r.y1) * r.height / width,
|
|
y: r.y1 + (r.x2 - r.x1) * r.height / width
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Get coordinates of a rectangle's lower right corner from its top points
|
|
* and its lower left corner.
|
|
*
|
|
* @param {object} A rectangle defined by two points (x1, y1) and (x2, y2).
|
|
* @param {object} A corner's coordinates (x, y).
|
|
* @return {object} Coordinates of the corner (x, y).
|
|
*/
|
|
lowerRightCoor: function(r, llc) {
|
|
return {
|
|
x: llc.x - r.x1 + r.x2,
|
|
y: llc.y - r.y1 + r.y2
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Get the coordinates of all the corners of a rectangle from its top point.
|
|
*
|
|
* @param {object} A rectangle defined by two points (x1, y1) and (x2, y2).
|
|
* @return {array} An array of the four corners' coordinates (x, y).
|
|
*/
|
|
rectangleCorners: function(r) {
|
|
var llc = this.lowerLeftCoor(r),
|
|
lrc = this.lowerRightCoor(r, llc);
|
|
|
|
return [
|
|
{x: r.x1, y: r.y1},
|
|
{x: r.x2, y: r.y2},
|
|
{x: llc.x, y: llc.y},
|
|
{x: lrc.x, y: lrc.y}
|
|
];
|
|
},
|
|
|
|
/**
|
|
* Split a square defined by its boundaries into four.
|
|
*
|
|
* @param {object} Boundaries of the square (x, y, width, height).
|
|
* @return {array} An array containing the four new squares, themselves
|
|
* defined by an array of their four corners (x, y).
|
|
*/
|
|
splitSquare: function(b) {
|
|
return [
|
|
[
|
|
{x: b.x, y: b.y},
|
|
{x: b.x + b.width / 2, y: b.y},
|
|
{x: b.x, y: b.y + b.height / 2},
|
|
{x: b.x + b.width / 2, y: b.y + b.height / 2}
|
|
],
|
|
[
|
|
{x: b.x + b.width / 2, y: b.y},
|
|
{x: b.x + b.width, y: b.y},
|
|
{x: b.x + b.width / 2, y: b.y + b.height / 2},
|
|
{x: b.x + b.width, y: b.y + b.height / 2}
|
|
],
|
|
[
|
|
{x: b.x, y: b.y + b.height / 2},
|
|
{x: b.x + b.width / 2, y: b.y + b.height / 2},
|
|
{x: b.x, y: b.y + b.height},
|
|
{x: b.x + b.width / 2, y: b.y + b.height}
|
|
],
|
|
[
|
|
{x: b.x + b.width / 2, y: b.y + b.height / 2},
|
|
{x: b.x + b.width, y: b.y + b.height / 2},
|
|
{x: b.x + b.width / 2, y: b.y + b.height},
|
|
{x: b.x + b.width, y: b.y + b.height}
|
|
]
|
|
];
|
|
},
|
|
|
|
/**
|
|
* Compute the four axis between corners of rectangle A and corners of
|
|
* rectangle B. This is needed later to check an eventual collision.
|
|
*
|
|
* @param {array} An array of rectangle A's four corners (x, y).
|
|
* @param {array} An array of rectangle B's four corners (x, y).
|
|
* @return {array} An array of four axis defined by their coordinates (x,y).
|
|
*/
|
|
axis: function(c1, c2) {
|
|
return [
|
|
{x: c1[1].x - c1[0].x, y: c1[1].y - c1[0].y},
|
|
{x: c1[1].x - c1[3].x, y: c1[1].y - c1[3].y},
|
|
{x: c2[0].x - c2[2].x, y: c2[0].y - c2[2].y},
|
|
{x: c2[0].x - c2[1].x, y: c2[0].y - c2[1].y}
|
|
];
|
|
},
|
|
|
|
/**
|
|
* Project a rectangle's corner on an axis.
|
|
*
|
|
* @param {object} Coordinates of a corner (x, y).
|
|
* @param {object} Coordinates of an axis (x, y).
|
|
* @return {object} The projection defined by coordinates (x, y).
|
|
*/
|
|
projection: function(c, a) {
|
|
var l = (
|
|
(c.x * a.x + c.y * a.y) /
|
|
(Math.pow(a.x, 2) + Math.pow(a.y, 2))
|
|
);
|
|
|
|
return {
|
|
x: l * a.x,
|
|
y: l * a.y
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Check whether two rectangles collide on one particular axis.
|
|
*
|
|
* @param {object} An axis' coordinates (x, y).
|
|
* @param {array} Rectangle A's corners.
|
|
* @param {array} Rectangle B's corners.
|
|
* @return {boolean} True if the rectangles collide on the axis.
|
|
*/
|
|
axisCollision: function(a, c1, c2) {
|
|
var sc1 = [],
|
|
sc2 = [];
|
|
|
|
for (var ci = 0; ci < 4; ci++) {
|
|
var p1 = this.projection(c1[ci], a),
|
|
p2 = this.projection(c2[ci], a);
|
|
|
|
sc1.push(p1.x * a.x + p1.y * a.y);
|
|
sc2.push(p2.x * a.x + p2.y * a.y);
|
|
}
|
|
|
|
var maxc1 = Math.max.apply(Math, sc1),
|
|
maxc2 = Math.max.apply(Math, sc2),
|
|
minc1 = Math.min.apply(Math, sc1),
|
|
minc2 = Math.min.apply(Math, sc2);
|
|
|
|
return (minc2 <= maxc1 && maxc2 >= minc1);
|
|
},
|
|
|
|
/**
|
|
* Check whether two rectangles collide on each one of their four axis. If
|
|
* all axis collide, then the two rectangles do collide on the plane.
|
|
*
|
|
* @param {array} Rectangle A's corners.
|
|
* @param {array} Rectangle B's corners.
|
|
* @return {boolean} True if the rectangles collide.
|
|
*/
|
|
collision: function(c1, c2) {
|
|
var axis = this.axis(c1, c2),
|
|
col = true;
|
|
|
|
for (var i = 0; i < 4; i++)
|
|
col = col && this.axisCollision(axis[i], c1, c2);
|
|
|
|
return col;
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* Quad Functions
|
|
* ------------
|
|
*
|
|
* The Quadtree functions themselves.
|
|
* For each of those functions, we consider that in a splitted quad, the
|
|
* index of each node is the following:
|
|
* 0: top left
|
|
* 1: top right
|
|
* 2: bottom left
|
|
* 3: bottom right
|
|
*
|
|
* Moreover, the hereafter quad's philosophy is to consider that if an element
|
|
* collides with more than one nodes, this element belongs to each of the
|
|
* nodes it collides with where other would let it lie on a higher node.
|
|
*/
|
|
|
|
/**
|
|
* Get the index of the node containing the point in the quad
|
|
*
|
|
* @param {object} point A point defined by coordinates (x, y).
|
|
* @param {object} quadBounds Boundaries of the quad (x, y, width, heigth).
|
|
* @return {integer} The index of the node containing the point.
|
|
*/
|
|
function _quadIndex(point, quadBounds) {
|
|
var xmp = quadBounds.x + quadBounds.width / 2,
|
|
ymp = quadBounds.y + quadBounds.height / 2,
|
|
top = (point.y < ymp),
|
|
left = (point.x < xmp);
|
|
|
|
if (top) {
|
|
if (left)
|
|
return 0;
|
|
else
|
|
return 1;
|
|
}
|
|
else {
|
|
if (left)
|
|
return 2;
|
|
else
|
|
return 3;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get a list of indexes of nodes containing an axis-aligned rectangle
|
|
*
|
|
* @param {object} rectangle A rectangle defined by two points (x1, y1),
|
|
* (x2, y2) and height.
|
|
* @param {array} quadCorners An array of the quad nodes' corners.
|
|
* @return {array} An array of indexes containing one to
|
|
* four integers.
|
|
*/
|
|
function _quadIndexes(rectangle, quadCorners) {
|
|
var indexes = [];
|
|
|
|
// Iterating through quads
|
|
for (var i = 0; i < 4; i++)
|
|
if ((rectangle.x2 >= quadCorners[i][0].x) &&
|
|
(rectangle.x1 <= quadCorners[i][1].x) &&
|
|
(rectangle.y1 + rectangle.height >= quadCorners[i][0].y) &&
|
|
(rectangle.y1 <= quadCorners[i][2].y))
|
|
indexes.push(i);
|
|
|
|
return indexes;
|
|
}
|
|
|
|
/**
|
|
* Get a list of indexes of nodes containing a non-axis-aligned rectangle
|
|
*
|
|
* @param {array} corners An array containing each corner of the
|
|
* rectangle defined by its coordinates (x, y).
|
|
* @param {array} quadCorners An array of the quad nodes' corners.
|
|
* @return {array} An array of indexes containing one to
|
|
* four integers.
|
|
*/
|
|
function _quadCollision(corners, quadCorners) {
|
|
var indexes = [];
|
|
|
|
// Iterating through quads
|
|
for (var i = 0; i < 4; i++)
|
|
if (_geom.collision(corners, quadCorners[i]))
|
|
indexes.push(i);
|
|
|
|
return indexes;
|
|
}
|
|
|
|
/**
|
|
* Subdivide a quad by creating a node at a precise index. The function does
|
|
* not generate all four nodes not to potentially create unused nodes.
|
|
*
|
|
* @param {integer} index The index of the node to create.
|
|
* @param {object} quad The quad object to subdivide.
|
|
* @return {object} A new quad representing the node created.
|
|
*/
|
|
function _quadSubdivide(index, quad) {
|
|
var next = quad.level + 1,
|
|
subw = Math.round(quad.bounds.width / 2),
|
|
subh = Math.round(quad.bounds.height / 2),
|
|
qx = Math.round(quad.bounds.x),
|
|
qy = Math.round(quad.bounds.y),
|
|
x,
|
|
y;
|
|
|
|
switch (index) {
|
|
case 0:
|
|
x = qx;
|
|
y = qy;
|
|
break;
|
|
case 1:
|
|
x = qx + subw;
|
|
y = qy;
|
|
break;
|
|
case 2:
|
|
x = qx;
|
|
y = qy + subh;
|
|
break;
|
|
case 3:
|
|
x = qx + subw;
|
|
y = qy + subh;
|
|
break;
|
|
}
|
|
|
|
return _quadTree(
|
|
{x: x, y: y, width: subw, height: subh},
|
|
next,
|
|
quad.maxElements,
|
|
quad.maxLevel
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Recursively insert an element into the quadtree. Only points
|
|
* with size, i.e. axis-aligned squares, may be inserted with this
|
|
* method.
|
|
*
|
|
* @param {object} el The element to insert in the quadtree.
|
|
* @param {object} sizedPoint A sized point defined by two top points
|
|
* (x1, y1), (x2, y2) and height.
|
|
* @param {object} quad The quad in which to insert the element.
|
|
* @return {undefined} The function does not return anything.
|
|
*/
|
|
function _quadInsert(el, sizedPoint, quad) {
|
|
if (quad.level < quad.maxLevel) {
|
|
|
|
// Searching appropriate quads
|
|
var indexes = _quadIndexes(sizedPoint, quad.corners);
|
|
|
|
// Iterating
|
|
for (var i = 0, l = indexes.length; i < l; i++) {
|
|
|
|
// Subdividing if necessary
|
|
if (quad.nodes[indexes[i]] === undefined)
|
|
quad.nodes[indexes[i]] = _quadSubdivide(indexes[i], quad);
|
|
|
|
// Recursion
|
|
_quadInsert(el, sizedPoint, quad.nodes[indexes[i]]);
|
|
}
|
|
}
|
|
else {
|
|
|
|
// Pushing the element in a leaf node
|
|
quad.elements.push(el);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Recursively retrieve every elements held by the node containing the
|
|
* searched point.
|
|
*
|
|
* @param {object} point The searched point (x, y).
|
|
* @param {object} quad The searched quad.
|
|
* @return {array} An array of elements contained in the relevant
|
|
* node.
|
|
*/
|
|
function _quadRetrievePoint(point, quad) {
|
|
if (quad.level < quad.maxLevel) {
|
|
var index = _quadIndex(point, quad.bounds);
|
|
|
|
// If node does not exist we return an empty list
|
|
if (quad.nodes[index] !== undefined) {
|
|
return _quadRetrievePoint(point, quad.nodes[index]);
|
|
}
|
|
else {
|
|
return [];
|
|
}
|
|
}
|
|
else {
|
|
return quad.elements;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Recursively retrieve every elements contained within an rectangular area
|
|
* that may or may not be axis-aligned.
|
|
*
|
|
* @param {object|array} rectData The searched area defined either by
|
|
* an array of four corners (x, y) in
|
|
* the case of a non-axis-aligned
|
|
* rectangle or an object with two top
|
|
* points (x1, y1), (x2, y2) and height.
|
|
* @param {object} quad The searched quad.
|
|
* @param {function} collisionFunc The collision function used to search
|
|
* for node indexes.
|
|
* @param {array?} els The retrieved elements.
|
|
* @return {array} An array of elements contained in the
|
|
* area.
|
|
*/
|
|
function _quadRetrieveArea(rectData, quad, collisionFunc, els) {
|
|
els = els || {};
|
|
|
|
if (quad.level < quad.maxLevel) {
|
|
var indexes = collisionFunc(rectData, quad.corners);
|
|
|
|
for (var i = 0, l = indexes.length; i < l; i++)
|
|
if (quad.nodes[indexes[i]] !== undefined)
|
|
_quadRetrieveArea(
|
|
rectData,
|
|
quad.nodes[indexes[i]],
|
|
collisionFunc,
|
|
els
|
|
);
|
|
} else
|
|
for (var j = 0, m = quad.elements.length; j < m; j++)
|
|
if (els[quad.elements[j].id] === undefined)
|
|
els[quad.elements[j].id] = quad.elements[j];
|
|
|
|
return els;
|
|
}
|
|
|
|
/**
|
|
* Creates the quadtree object itself.
|
|
*
|
|
* @param {object} bounds The boundaries of the quad defined by an
|
|
* origin (x, y), width and heigth.
|
|
* @param {integer} level The level of the quad in the tree.
|
|
* @param {integer} maxElements The max number of element in a leaf node.
|
|
* @param {integer} maxLevel The max recursion level of the tree.
|
|
* @return {object} The quadtree object.
|
|
*/
|
|
function _quadTree(bounds, level, maxElements, maxLevel) {
|
|
return {
|
|
level: level || 0,
|
|
bounds: bounds,
|
|
corners: _geom.splitSquare(bounds),
|
|
maxElements: maxElements || 20,
|
|
maxLevel: maxLevel || 4,
|
|
elements: [],
|
|
nodes: []
|
|
};
|
|
}
|
|
|
|
|
|
/**
|
|
* Sigma Quad Constructor
|
|
* ----------------------
|
|
*
|
|
* The quad API as exposed to sigma.
|
|
*/
|
|
|
|
/**
|
|
* The quad core that will become the sigma interface with the quadtree.
|
|
*
|
|
* property {object} _tree Property holding the quadtree object.
|
|
* property {object} _geom Exposition of the _geom namespace for testing.
|
|
* property {object} _cache Cache for the area method.
|
|
*/
|
|
var quad = function() {
|
|
this._geom = _geom;
|
|
this._tree = null;
|
|
this._cache = {
|
|
query: false,
|
|
result: false
|
|
};
|
|
};
|
|
|
|
/**
|
|
* Index a graph by inserting its nodes into the quadtree.
|
|
*
|
|
* @param {array} nodes An array of nodes to index.
|
|
* @param {object} params An object of parameters with at least the quad
|
|
* bounds.
|
|
* @return {object} The quadtree object.
|
|
*
|
|
* Parameters:
|
|
* ----------
|
|
* bounds: {object} boundaries of the quad defined by its origin (x, y)
|
|
* width and heigth.
|
|
* prefix: {string?} a prefix for node geometric attributes.
|
|
* maxElements: {integer?} the max number of elements in a leaf node.
|
|
* maxLevel: {integer?} the max recursion level of the tree.
|
|
*/
|
|
quad.prototype.index = function(nodes, params) {
|
|
|
|
// Enforcing presence of boundaries
|
|
if (!params.bounds)
|
|
throw 'sigma.classes.quad.index: bounds information not given.';
|
|
|
|
// Prefix
|
|
var prefix = params.prefix || '';
|
|
|
|
// Building the tree
|
|
this._tree = _quadTree(
|
|
params.bounds,
|
|
0,
|
|
params.maxElements,
|
|
params.maxLevel
|
|
);
|
|
|
|
// Inserting graph nodes into the tree
|
|
for (var i = 0, l = nodes.length; i < l; i++) {
|
|
|
|
// Inserting node
|
|
_quadInsert(
|
|
nodes[i],
|
|
_geom.pointToSquare({
|
|
x: nodes[i][prefix + 'x'],
|
|
y: nodes[i][prefix + 'y'],
|
|
size: nodes[i][prefix + 'size']
|
|
}),
|
|
this._tree
|
|
);
|
|
}
|
|
|
|
// Reset cache:
|
|
this._cache = {
|
|
query: false,
|
|
result: false
|
|
};
|
|
|
|
// remove?
|
|
return this._tree;
|
|
};
|
|
|
|
/**
|
|
* Retrieve every graph nodes held by the quadtree node containing the
|
|
* searched point.
|
|
*
|
|
* @param {number} x of the point.
|
|
* @param {number} y of the point.
|
|
* @return {array} An array of nodes retrieved.
|
|
*/
|
|
quad.prototype.point = function(x, y) {
|
|
return this._tree ?
|
|
_quadRetrievePoint({x: x, y: y}, this._tree) || [] :
|
|
[];
|
|
};
|
|
|
|
/**
|
|
* Retrieve every graph nodes within a rectangular area. The methods keep the
|
|
* last area queried in cache for optimization reason and will act differently
|
|
* for the same reason if the area is axis-aligned or not.
|
|
*
|
|
* @param {object} A rectangle defined by two top points (x1, y1), (x2, y2)
|
|
* and height.
|
|
* @return {array} An array of nodes retrieved.
|
|
*/
|
|
quad.prototype.area = function(rect) {
|
|
var serialized = JSON.stringify(rect),
|
|
collisionFunc,
|
|
rectData;
|
|
|
|
// Returning cache?
|
|
if (this._cache.query === serialized)
|
|
return this._cache.result;
|
|
|
|
// Axis aligned ?
|
|
if (_geom.isAxisAligned(rect)) {
|
|
collisionFunc = _quadIndexes;
|
|
rectData = _geom.axisAlignedTopPoints(rect);
|
|
}
|
|
else {
|
|
collisionFunc = _quadCollision;
|
|
rectData = _geom.rectangleCorners(rect);
|
|
}
|
|
|
|
// Retrieving nodes
|
|
var nodes = this._tree ?
|
|
_quadRetrieveArea(
|
|
rectData,
|
|
this._tree,
|
|
collisionFunc
|
|
) :
|
|
[];
|
|
|
|
// Object to array
|
|
var nodesArray = [];
|
|
for (var i in nodes)
|
|
nodesArray.push(nodes[i]);
|
|
|
|
// Caching
|
|
this._cache.query = serialized;
|
|
this._cache.result = nodesArray;
|
|
|
|
return nodesArray;
|
|
};
|
|
|
|
|
|
/**
|
|
* EXPORT:
|
|
* *******
|
|
*/
|
|
if (typeof this.sigma !== 'undefined') {
|
|
this.sigma.classes = this.sigma.classes || {};
|
|
this.sigma.classes.quad = quad;
|
|
} else if (typeof exports !== 'undefined') {
|
|
if (typeof module !== 'undefined' && module.exports)
|
|
exports = module.exports = quad;
|
|
exports.quad = quad;
|
|
} else
|
|
this.quad = quad;
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
/**
|
|
* Sigma Quadtree Module for edges
|
|
* ===============================
|
|
*
|
|
* Author: Sébastien Heymann,
|
|
* from the quad of Guillaume Plique (Yomguithereal)
|
|
* Version: 0.2
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
* Quad Geometric Operations
|
|
* -------------------------
|
|
*
|
|
* A useful batch of geometric operations used by the quadtree.
|
|
*/
|
|
|
|
var _geom = {
|
|
|
|
/**
|
|
* Transforms a graph node with x, y and size into an
|
|
* axis-aligned square.
|
|
*
|
|
* @param {object} A graph node with at least a point (x, y) and a size.
|
|
* @return {object} A square: two points (x1, y1), (x2, y2) and height.
|
|
*/
|
|
pointToSquare: function(n) {
|
|
return {
|
|
x1: n.x - n.size,
|
|
y1: n.y - n.size,
|
|
x2: n.x + n.size,
|
|
y2: n.y - n.size,
|
|
height: n.size * 2
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Transforms a graph edge with x1, y1, x2, y2 and size into an
|
|
* axis-aligned square.
|
|
*
|
|
* @param {object} A graph edge with at least two points
|
|
* (x1, y1), (x2, y2) and a size.
|
|
* @return {object} A square: two points (x1, y1), (x2, y2) and height.
|
|
*/
|
|
lineToSquare: function(e) {
|
|
if (e.y1 < e.y2) {
|
|
// (e.x1, e.y1) on top
|
|
if (e.x1 < e.x2) {
|
|
// (e.x1, e.y1) on left
|
|
return {
|
|
x1: e.x1 - e.size,
|
|
y1: e.y1 - e.size,
|
|
x2: e.x2 + e.size,
|
|
y2: e.y1 - e.size,
|
|
height: e.y2 - e.y1 + e.size * 2
|
|
};
|
|
}
|
|
// (e.x1, e.y1) on right
|
|
return {
|
|
x1: e.x2 - e.size,
|
|
y1: e.y1 - e.size,
|
|
x2: e.x1 + e.size,
|
|
y2: e.y1 - e.size,
|
|
height: e.y2 - e.y1 + e.size * 2
|
|
};
|
|
}
|
|
|
|
// (e.x2, e.y2) on top
|
|
if (e.x1 < e.x2) {
|
|
// (e.x1, e.y1) on left
|
|
return {
|
|
x1: e.x1 - e.size,
|
|
y1: e.y2 - e.size,
|
|
x2: e.x2 + e.size,
|
|
y2: e.y2 - e.size,
|
|
height: e.y1 - e.y2 + e.size * 2
|
|
};
|
|
}
|
|
// (e.x2, e.y2) on right
|
|
return {
|
|
x1: e.x2 - e.size,
|
|
y1: e.y2 - e.size,
|
|
x2: e.x1 + e.size,
|
|
y2: e.y2 - e.size,
|
|
height: e.y1 - e.y2 + e.size * 2
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Transforms a graph edge of type 'curve' with x1, y1, x2, y2,
|
|
* control point and size into an axis-aligned square.
|
|
*
|
|
* @param {object} e A graph edge with at least two points
|
|
* (x1, y1), (x2, y2) and a size.
|
|
* @param {object} cp A control point (x,y).
|
|
* @return {object} A square: two points (x1, y1), (x2, y2) and height.
|
|
*/
|
|
quadraticCurveToSquare: function(e, cp) {
|
|
var pt = sigma.utils.getPointOnQuadraticCurve(
|
|
0.5,
|
|
e.x1,
|
|
e.y1,
|
|
e.x2,
|
|
e.y2,
|
|
cp.x,
|
|
cp.y
|
|
);
|
|
|
|
// Bounding box of the two points and the point at the middle of the
|
|
// curve:
|
|
var minX = Math.min(e.x1, e.x2, pt.x),
|
|
maxX = Math.max(e.x1, e.x2, pt.x),
|
|
minY = Math.min(e.y1, e.y2, pt.y),
|
|
maxY = Math.max(e.y1, e.y2, pt.y);
|
|
|
|
return {
|
|
x1: minX - e.size,
|
|
y1: minY - e.size,
|
|
x2: maxX + e.size,
|
|
y2: minY - e.size,
|
|
height: maxY - minY + e.size * 2
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Transforms a graph self loop into an axis-aligned square.
|
|
*
|
|
* @param {object} n A graph node with a point (x, y) and a size.
|
|
* @return {object} A square: two points (x1, y1), (x2, y2) and height.
|
|
*/
|
|
selfLoopToSquare: function(n) {
|
|
// Fitting to the curve is too costly, we compute a larger bounding box
|
|
// using the control points:
|
|
var cp = sigma.utils.getSelfLoopControlPoints(n.x, n.y, n.size);
|
|
|
|
// Bounding box of the point and the two control points:
|
|
var minX = Math.min(n.x, cp.x1, cp.x2),
|
|
maxX = Math.max(n.x, cp.x1, cp.x2),
|
|
minY = Math.min(n.y, cp.y1, cp.y2),
|
|
maxY = Math.max(n.y, cp.y1, cp.y2);
|
|
|
|
return {
|
|
x1: minX - n.size,
|
|
y1: minY - n.size,
|
|
x2: maxX + n.size,
|
|
y2: minY - n.size,
|
|
height: maxY - minY + n.size * 2
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Checks whether a rectangle is axis-aligned.
|
|
*
|
|
* @param {object} A rectangle defined by two points
|
|
* (x1, y1) and (x2, y2).
|
|
* @return {boolean} True if the rectangle is axis-aligned.
|
|
*/
|
|
isAxisAligned: function(r) {
|
|
return r.x1 === r.x2 || r.y1 === r.y2;
|
|
},
|
|
|
|
/**
|
|
* Compute top points of an axis-aligned rectangle. This is useful in
|
|
* cases when the rectangle has been rotated (left, right or bottom up) and
|
|
* later operations need to know the top points.
|
|
*
|
|
* @param {object} An axis-aligned rectangle defined by two points
|
|
* (x1, y1), (x2, y2) and height.
|
|
* @return {object} A rectangle: two points (x1, y1), (x2, y2) and height.
|
|
*/
|
|
axisAlignedTopPoints: function(r) {
|
|
|
|
// Basic
|
|
if (r.y1 === r.y2 && r.x1 < r.x2)
|
|
return r;
|
|
|
|
// Rotated to right
|
|
if (r.x1 === r.x2 && r.y2 > r.y1)
|
|
return {
|
|
x1: r.x1 - r.height, y1: r.y1,
|
|
x2: r.x1, y2: r.y1,
|
|
height: r.height
|
|
};
|
|
|
|
// Rotated to left
|
|
if (r.x1 === r.x2 && r.y2 < r.y1)
|
|
return {
|
|
x1: r.x1, y1: r.y2,
|
|
x2: r.x2 + r.height, y2: r.y2,
|
|
height: r.height
|
|
};
|
|
|
|
// Bottom's up
|
|
return {
|
|
x1: r.x2, y1: r.y1 - r.height,
|
|
x2: r.x1, y2: r.y1 - r.height,
|
|
height: r.height
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Get coordinates of a rectangle's lower left corner from its top points.
|
|
*
|
|
* @param {object} A rectangle defined by two points (x1, y1) and (x2, y2).
|
|
* @return {object} Coordinates of the corner (x, y).
|
|
*/
|
|
lowerLeftCoor: function(r) {
|
|
var width = (
|
|
Math.sqrt(
|
|
Math.pow(r.x2 - r.x1, 2) +
|
|
Math.pow(r.y2 - r.y1, 2)
|
|
)
|
|
);
|
|
|
|
return {
|
|
x: r.x1 - (r.y2 - r.y1) * r.height / width,
|
|
y: r.y1 + (r.x2 - r.x1) * r.height / width
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Get coordinates of a rectangle's lower right corner from its top points
|
|
* and its lower left corner.
|
|
*
|
|
* @param {object} A rectangle defined by two points (x1, y1) and (x2, y2).
|
|
* @param {object} A corner's coordinates (x, y).
|
|
* @return {object} Coordinates of the corner (x, y).
|
|
*/
|
|
lowerRightCoor: function(r, llc) {
|
|
return {
|
|
x: llc.x - r.x1 + r.x2,
|
|
y: llc.y - r.y1 + r.y2
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Get the coordinates of all the corners of a rectangle from its top point.
|
|
*
|
|
* @param {object} A rectangle defined by two points (x1, y1) and (x2, y2).
|
|
* @return {array} An array of the four corners' coordinates (x, y).
|
|
*/
|
|
rectangleCorners: function(r) {
|
|
var llc = this.lowerLeftCoor(r),
|
|
lrc = this.lowerRightCoor(r, llc);
|
|
|
|
return [
|
|
{x: r.x1, y: r.y1},
|
|
{x: r.x2, y: r.y2},
|
|
{x: llc.x, y: llc.y},
|
|
{x: lrc.x, y: lrc.y}
|
|
];
|
|
},
|
|
|
|
/**
|
|
* Split a square defined by its boundaries into four.
|
|
*
|
|
* @param {object} Boundaries of the square (x, y, width, height).
|
|
* @return {array} An array containing the four new squares, themselves
|
|
* defined by an array of their four corners (x, y).
|
|
*/
|
|
splitSquare: function(b) {
|
|
return [
|
|
[
|
|
{x: b.x, y: b.y},
|
|
{x: b.x + b.width / 2, y: b.y},
|
|
{x: b.x, y: b.y + b.height / 2},
|
|
{x: b.x + b.width / 2, y: b.y + b.height / 2}
|
|
],
|
|
[
|
|
{x: b.x + b.width / 2, y: b.y},
|
|
{x: b.x + b.width, y: b.y},
|
|
{x: b.x + b.width / 2, y: b.y + b.height / 2},
|
|
{x: b.x + b.width, y: b.y + b.height / 2}
|
|
],
|
|
[
|
|
{x: b.x, y: b.y + b.height / 2},
|
|
{x: b.x + b.width / 2, y: b.y + b.height / 2},
|
|
{x: b.x, y: b.y + b.height},
|
|
{x: b.x + b.width / 2, y: b.y + b.height}
|
|
],
|
|
[
|
|
{x: b.x + b.width / 2, y: b.y + b.height / 2},
|
|
{x: b.x + b.width, y: b.y + b.height / 2},
|
|
{x: b.x + b.width / 2, y: b.y + b.height},
|
|
{x: b.x + b.width, y: b.y + b.height}
|
|
]
|
|
];
|
|
},
|
|
|
|
/**
|
|
* Compute the four axis between corners of rectangle A and corners of
|
|
* rectangle B. This is needed later to check an eventual collision.
|
|
*
|
|
* @param {array} An array of rectangle A's four corners (x, y).
|
|
* @param {array} An array of rectangle B's four corners (x, y).
|
|
* @return {array} An array of four axis defined by their coordinates (x,y).
|
|
*/
|
|
axis: function(c1, c2) {
|
|
return [
|
|
{x: c1[1].x - c1[0].x, y: c1[1].y - c1[0].y},
|
|
{x: c1[1].x - c1[3].x, y: c1[1].y - c1[3].y},
|
|
{x: c2[0].x - c2[2].x, y: c2[0].y - c2[2].y},
|
|
{x: c2[0].x - c2[1].x, y: c2[0].y - c2[1].y}
|
|
];
|
|
},
|
|
|
|
/**
|
|
* Project a rectangle's corner on an axis.
|
|
*
|
|
* @param {object} Coordinates of a corner (x, y).
|
|
* @param {object} Coordinates of an axis (x, y).
|
|
* @return {object} The projection defined by coordinates (x, y).
|
|
*/
|
|
projection: function(c, a) {
|
|
var l = (
|
|
(c.x * a.x + c.y * a.y) /
|
|
(Math.pow(a.x, 2) + Math.pow(a.y, 2))
|
|
);
|
|
|
|
return {
|
|
x: l * a.x,
|
|
y: l * a.y
|
|
};
|
|
},
|
|
|
|
/**
|
|
* Check whether two rectangles collide on one particular axis.
|
|
*
|
|
* @param {object} An axis' coordinates (x, y).
|
|
* @param {array} Rectangle A's corners.
|
|
* @param {array} Rectangle B's corners.
|
|
* @return {boolean} True if the rectangles collide on the axis.
|
|
*/
|
|
axisCollision: function(a, c1, c2) {
|
|
var sc1 = [],
|
|
sc2 = [];
|
|
|
|
for (var ci = 0; ci < 4; ci++) {
|
|
var p1 = this.projection(c1[ci], a),
|
|
p2 = this.projection(c2[ci], a);
|
|
|
|
sc1.push(p1.x * a.x + p1.y * a.y);
|
|
sc2.push(p2.x * a.x + p2.y * a.y);
|
|
}
|
|
|
|
var maxc1 = Math.max.apply(Math, sc1),
|
|
maxc2 = Math.max.apply(Math, sc2),
|
|
minc1 = Math.min.apply(Math, sc1),
|
|
minc2 = Math.min.apply(Math, sc2);
|
|
|
|
return (minc2 <= maxc1 && maxc2 >= minc1);
|
|
},
|
|
|
|
/**
|
|
* Check whether two rectangles collide on each one of their four axis. If
|
|
* all axis collide, then the two rectangles do collide on the plane.
|
|
*
|
|
* @param {array} Rectangle A's corners.
|
|
* @param {array} Rectangle B's corners.
|
|
* @return {boolean} True if the rectangles collide.
|
|
*/
|
|
collision: function(c1, c2) {
|
|
var axis = this.axis(c1, c2),
|
|
col = true;
|
|
|
|
for (var i = 0; i < 4; i++)
|
|
col = col && this.axisCollision(axis[i], c1, c2);
|
|
|
|
return col;
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* Quad Functions
|
|
* ------------
|
|
*
|
|
* The Quadtree functions themselves.
|
|
* For each of those functions, we consider that in a splitted quad, the
|
|
* index of each node is the following:
|
|
* 0: top left
|
|
* 1: top right
|
|
* 2: bottom left
|
|
* 3: bottom right
|
|
*
|
|
* Moreover, the hereafter quad's philosophy is to consider that if an element
|
|
* collides with more than one nodes, this element belongs to each of the
|
|
* nodes it collides with where other would let it lie on a higher node.
|
|
*/
|
|
|
|
/**
|
|
* Get the index of the node containing the point in the quad
|
|
*
|
|
* @param {object} point A point defined by coordinates (x, y).
|
|
* @param {object} quadBounds Boundaries of the quad (x, y, width, heigth).
|
|
* @return {integer} The index of the node containing the point.
|
|
*/
|
|
function _quadIndex(point, quadBounds) {
|
|
var xmp = quadBounds.x + quadBounds.width / 2,
|
|
ymp = quadBounds.y + quadBounds.height / 2,
|
|
top = (point.y < ymp),
|
|
left = (point.x < xmp);
|
|
|
|
if (top) {
|
|
if (left)
|
|
return 0;
|
|
else
|
|
return 1;
|
|
}
|
|
else {
|
|
if (left)
|
|
return 2;
|
|
else
|
|
return 3;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get a list of indexes of nodes containing an axis-aligned rectangle
|
|
*
|
|
* @param {object} rectangle A rectangle defined by two points (x1, y1),
|
|
* (x2, y2) and height.
|
|
* @param {array} quadCorners An array of the quad nodes' corners.
|
|
* @return {array} An array of indexes containing one to
|
|
* four integers.
|
|
*/
|
|
function _quadIndexes(rectangle, quadCorners) {
|
|
var indexes = [];
|
|
|
|
// Iterating through quads
|
|
for (var i = 0; i < 4; i++)
|
|
if ((rectangle.x2 >= quadCorners[i][0].x) &&
|
|
(rectangle.x1 <= quadCorners[i][1].x) &&
|
|
(rectangle.y1 + rectangle.height >= quadCorners[i][0].y) &&
|
|
(rectangle.y1 <= quadCorners[i][2].y))
|
|
indexes.push(i);
|
|
|
|
return indexes;
|
|
}
|
|
|
|
/**
|
|
* Get a list of indexes of nodes containing a non-axis-aligned rectangle
|
|
*
|
|
* @param {array} corners An array containing each corner of the
|
|
* rectangle defined by its coordinates (x, y).
|
|
* @param {array} quadCorners An array of the quad nodes' corners.
|
|
* @return {array} An array of indexes containing one to
|
|
* four integers.
|
|
*/
|
|
function _quadCollision(corners, quadCorners) {
|
|
var indexes = [];
|
|
|
|
// Iterating through quads
|
|
for (var i = 0; i < 4; i++)
|
|
if (_geom.collision(corners, quadCorners[i]))
|
|
indexes.push(i);
|
|
|
|
return indexes;
|
|
}
|
|
|
|
/**
|
|
* Subdivide a quad by creating a node at a precise index. The function does
|
|
* not generate all four nodes not to potentially create unused nodes.
|
|
*
|
|
* @param {integer} index The index of the node to create.
|
|
* @param {object} quad The quad object to subdivide.
|
|
* @return {object} A new quad representing the node created.
|
|
*/
|
|
function _quadSubdivide(index, quad) {
|
|
var next = quad.level + 1,
|
|
subw = Math.round(quad.bounds.width / 2),
|
|
subh = Math.round(quad.bounds.height / 2),
|
|
qx = Math.round(quad.bounds.x),
|
|
qy = Math.round(quad.bounds.y),
|
|
x,
|
|
y;
|
|
|
|
switch (index) {
|
|
case 0:
|
|
x = qx;
|
|
y = qy;
|
|
break;
|
|
case 1:
|
|
x = qx + subw;
|
|
y = qy;
|
|
break;
|
|
case 2:
|
|
x = qx;
|
|
y = qy + subh;
|
|
break;
|
|
case 3:
|
|
x = qx + subw;
|
|
y = qy + subh;
|
|
break;
|
|
}
|
|
|
|
return _quadTree(
|
|
{x: x, y: y, width: subw, height: subh},
|
|
next,
|
|
quad.maxElements,
|
|
quad.maxLevel
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Recursively insert an element into the quadtree. Only points
|
|
* with size, i.e. axis-aligned squares, may be inserted with this
|
|
* method.
|
|
*
|
|
* @param {object} el The element to insert in the quadtree.
|
|
* @param {object} sizedPoint A sized point defined by two top points
|
|
* (x1, y1), (x2, y2) and height.
|
|
* @param {object} quad The quad in which to insert the element.
|
|
* @return {undefined} The function does not return anything.
|
|
*/
|
|
function _quadInsert(el, sizedPoint, quad) {
|
|
if (quad.level < quad.maxLevel) {
|
|
|
|
// Searching appropriate quads
|
|
var indexes = _quadIndexes(sizedPoint, quad.corners);
|
|
|
|
// Iterating
|
|
for (var i = 0, l = indexes.length; i < l; i++) {
|
|
|
|
// Subdividing if necessary
|
|
if (quad.nodes[indexes[i]] === undefined)
|
|
quad.nodes[indexes[i]] = _quadSubdivide(indexes[i], quad);
|
|
|
|
// Recursion
|
|
_quadInsert(el, sizedPoint, quad.nodes[indexes[i]]);
|
|
}
|
|
}
|
|
else {
|
|
|
|
// Pushing the element in a leaf node
|
|
quad.elements.push(el);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Recursively retrieve every elements held by the node containing the
|
|
* searched point.
|
|
*
|
|
* @param {object} point The searched point (x, y).
|
|
* @param {object} quad The searched quad.
|
|
* @return {array} An array of elements contained in the relevant
|
|
* node.
|
|
*/
|
|
function _quadRetrievePoint(point, quad) {
|
|
if (quad.level < quad.maxLevel) {
|
|
var index = _quadIndex(point, quad.bounds);
|
|
|
|
// If node does not exist we return an empty list
|
|
if (quad.nodes[index] !== undefined) {
|
|
return _quadRetrievePoint(point, quad.nodes[index]);
|
|
}
|
|
else {
|
|
return [];
|
|
}
|
|
}
|
|
else {
|
|
return quad.elements;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Recursively retrieve every elements contained within an rectangular area
|
|
* that may or may not be axis-aligned.
|
|
*
|
|
* @param {object|array} rectData The searched area defined either by
|
|
* an array of four corners (x, y) in
|
|
* the case of a non-axis-aligned
|
|
* rectangle or an object with two top
|
|
* points (x1, y1), (x2, y2) and height.
|
|
* @param {object} quad The searched quad.
|
|
* @param {function} collisionFunc The collision function used to search
|
|
* for node indexes.
|
|
* @param {array?} els The retrieved elements.
|
|
* @return {array} An array of elements contained in the
|
|
* area.
|
|
*/
|
|
function _quadRetrieveArea(rectData, quad, collisionFunc, els) {
|
|
els = els || {};
|
|
|
|
if (quad.level < quad.maxLevel) {
|
|
var indexes = collisionFunc(rectData, quad.corners);
|
|
|
|
for (var i = 0, l = indexes.length; i < l; i++)
|
|
if (quad.nodes[indexes[i]] !== undefined)
|
|
_quadRetrieveArea(
|
|
rectData,
|
|
quad.nodes[indexes[i]],
|
|
collisionFunc,
|
|
els
|
|
);
|
|
} else
|
|
for (var j = 0, m = quad.elements.length; j < m; j++)
|
|
if (els[quad.elements[j].id] === undefined)
|
|
els[quad.elements[j].id] = quad.elements[j];
|
|
|
|
return els;
|
|
}
|
|
|
|
/**
|
|
* Creates the quadtree object itself.
|
|
*
|
|
* @param {object} bounds The boundaries of the quad defined by an
|
|
* origin (x, y), width and heigth.
|
|
* @param {integer} level The level of the quad in the tree.
|
|
* @param {integer} maxElements The max number of element in a leaf node.
|
|
* @param {integer} maxLevel The max recursion level of the tree.
|
|
* @return {object} The quadtree object.
|
|
*/
|
|
function _quadTree(bounds, level, maxElements, maxLevel) {
|
|
return {
|
|
level: level || 0,
|
|
bounds: bounds,
|
|
corners: _geom.splitSquare(bounds),
|
|
maxElements: maxElements || 40,
|
|
maxLevel: maxLevel || 8,
|
|
elements: [],
|
|
nodes: []
|
|
};
|
|
}
|
|
|
|
|
|
/**
|
|
* Sigma Quad Constructor
|
|
* ----------------------
|
|
*
|
|
* The edgequad API as exposed to sigma.
|
|
*/
|
|
|
|
/**
|
|
* The edgequad core that will become the sigma interface with the quadtree.
|
|
*
|
|
* property {object} _tree Property holding the quadtree object.
|
|
* property {object} _geom Exposition of the _geom namespace for testing.
|
|
* property {object} _cache Cache for the area method.
|
|
* property {boolean} _enabled Can index and retreive elements.
|
|
*/
|
|
var edgequad = function() {
|
|
this._geom = _geom;
|
|
this._tree = null;
|
|
this._cache = {
|
|
query: false,
|
|
result: false
|
|
};
|
|
this._enabled = true;
|
|
};
|
|
|
|
/**
|
|
* Index a graph by inserting its edges into the quadtree.
|
|
*
|
|
* @param {object} graph A graph instance.
|
|
* @param {object} params An object of parameters with at least the quad
|
|
* bounds.
|
|
* @return {object} The quadtree object.
|
|
*
|
|
* Parameters:
|
|
* ----------
|
|
* bounds: {object} boundaries of the quad defined by its origin (x, y)
|
|
* width and heigth.
|
|
* prefix: {string?} a prefix for edge geometric attributes.
|
|
* maxElements: {integer?} the max number of elements in a leaf node.
|
|
* maxLevel: {integer?} the max recursion level of the tree.
|
|
*/
|
|
edgequad.prototype.index = function(graph, params) {
|
|
if (!this._enabled)
|
|
return this._tree;
|
|
|
|
// Enforcing presence of boundaries
|
|
if (!params.bounds)
|
|
throw 'sigma.classes.edgequad.index: bounds information not given.';
|
|
|
|
// Prefix
|
|
var prefix = params.prefix || '',
|
|
cp,
|
|
source,
|
|
target,
|
|
n,
|
|
e;
|
|
|
|
// Building the tree
|
|
this._tree = _quadTree(
|
|
params.bounds,
|
|
0,
|
|
params.maxElements,
|
|
params.maxLevel
|
|
);
|
|
|
|
var edges = graph.edges();
|
|
|
|
// Inserting graph edges into the tree
|
|
for (var i = 0, l = edges.length; i < l; i++) {
|
|
source = graph.nodes(edges[i].source);
|
|
target = graph.nodes(edges[i].target);
|
|
e = {
|
|
x1: source[prefix + 'x'],
|
|
y1: source[prefix + 'y'],
|
|
x2: target[prefix + 'x'],
|
|
y2: target[prefix + 'y'],
|
|
size: edges[i][prefix + 'size'] || 0
|
|
};
|
|
|
|
// Inserting edge
|
|
if (edges[i].type === 'curve' || edges[i].type === 'curvedArrow') {
|
|
if (source.id === target.id) {
|
|
n = {
|
|
x: source[prefix + 'x'],
|
|
y: source[prefix + 'y'],
|
|
size: source[prefix + 'size'] || 0
|
|
};
|
|
_quadInsert(
|
|
edges[i],
|
|
_geom.selfLoopToSquare(n),
|
|
this._tree);
|
|
}
|
|
else {
|
|
cp = sigma.utils.getQuadraticControlPoint(e.x1, e.y1, e.x2, e.y2);
|
|
_quadInsert(
|
|
edges[i],
|
|
_geom.quadraticCurveToSquare(e, cp),
|
|
this._tree);
|
|
}
|
|
}
|
|
else {
|
|
_quadInsert(
|
|
edges[i],
|
|
_geom.lineToSquare(e),
|
|
this._tree);
|
|
}
|
|
}
|
|
|
|
// Reset cache:
|
|
this._cache = {
|
|
query: false,
|
|
result: false
|
|
};
|
|
|
|
// remove?
|
|
return this._tree;
|
|
};
|
|
|
|
/**
|
|
* Retrieve every graph edges held by the quadtree node containing the
|
|
* searched point.
|
|
*
|
|
* @param {number} x of the point.
|
|
* @param {number} y of the point.
|
|
* @return {array} An array of edges retrieved.
|
|
*/
|
|
edgequad.prototype.point = function(x, y) {
|
|
if (!this._enabled)
|
|
return [];
|
|
|
|
return this._tree ?
|
|
_quadRetrievePoint({x: x, y: y}, this._tree) || [] :
|
|
[];
|
|
};
|
|
|
|
/**
|
|
* Retrieve every graph edges within a rectangular area. The methods keep the
|
|
* last area queried in cache for optimization reason and will act differently
|
|
* for the same reason if the area is axis-aligned or not.
|
|
*
|
|
* @param {object} A rectangle defined by two top points (x1, y1), (x2, y2)
|
|
* and height.
|
|
* @return {array} An array of edges retrieved.
|
|
*/
|
|
edgequad.prototype.area = function(rect) {
|
|
if (!this._enabled)
|
|
return [];
|
|
|
|
var serialized = JSON.stringify(rect),
|
|
collisionFunc,
|
|
rectData;
|
|
|
|
// Returning cache?
|
|
if (this._cache.query === serialized)
|
|
return this._cache.result;
|
|
|
|
// Axis aligned ?
|
|
if (_geom.isAxisAligned(rect)) {
|
|
collisionFunc = _quadIndexes;
|
|
rectData = _geom.axisAlignedTopPoints(rect);
|
|
}
|
|
else {
|
|
collisionFunc = _quadCollision;
|
|
rectData = _geom.rectangleCorners(rect);
|
|
}
|
|
|
|
// Retrieving edges
|
|
var edges = this._tree ?
|
|
_quadRetrieveArea(
|
|
rectData,
|
|
this._tree,
|
|
collisionFunc
|
|
) :
|
|
[];
|
|
|
|
// Object to array
|
|
var edgesArray = [];
|
|
for (var i in edges)
|
|
edgesArray.push(edges[i]);
|
|
|
|
// Caching
|
|
this._cache.query = serialized;
|
|
this._cache.result = edgesArray;
|
|
|
|
return edgesArray;
|
|
};
|
|
|
|
|
|
/**
|
|
* EXPORT:
|
|
* *******
|
|
*/
|
|
if (typeof this.sigma !== 'undefined') {
|
|
this.sigma.classes = this.sigma.classes || {};
|
|
this.sigma.classes.edgequad = edgequad;
|
|
} else if (typeof exports !== 'undefined') {
|
|
if (typeof module !== 'undefined' && module.exports)
|
|
exports = module.exports = edgequad;
|
|
exports.edgequad = edgequad;
|
|
} else
|
|
this.edgequad = edgequad;
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.captors');
|
|
|
|
/**
|
|
* The user inputs default captor. It deals with mouse events, keyboards
|
|
* events and touch events.
|
|
*
|
|
* @param {DOMElement} target The DOM element where the listeners will be
|
|
* bound.
|
|
* @param {camera} camera The camera related to the target.
|
|
* @param {configurable} settings The settings function.
|
|
* @return {sigma.captor} The fresh new captor instance.
|
|
*/
|
|
sigma.captors.mouse = function(target, camera, settings) {
|
|
var _self = this,
|
|
_target = target,
|
|
_camera = camera,
|
|
_settings = settings,
|
|
|
|
// CAMERA MANAGEMENT:
|
|
// ******************
|
|
// The camera position when the user starts dragging:
|
|
_startCameraX,
|
|
_startCameraY,
|
|
_startCameraAngle,
|
|
|
|
// The latest stage position:
|
|
_lastCameraX,
|
|
_lastCameraY,
|
|
_lastCameraAngle,
|
|
_lastCameraRatio,
|
|
|
|
// MOUSE MANAGEMENT:
|
|
// *****************
|
|
// The mouse position when the user starts dragging:
|
|
_startMouseX,
|
|
_startMouseY,
|
|
|
|
_isMouseDown,
|
|
_isMoving,
|
|
_hasDragged,
|
|
_downStartTime,
|
|
_movingTimeoutId;
|
|
|
|
sigma.classes.dispatcher.extend(this);
|
|
|
|
sigma.utils.doubleClick(_target, 'click', _doubleClickHandler);
|
|
_target.addEventListener('DOMMouseScroll', _wheelHandler, false);
|
|
_target.addEventListener('mousewheel', _wheelHandler, false);
|
|
_target.addEventListener('mousemove', _moveHandler, false);
|
|
_target.addEventListener('mousedown', _downHandler, false);
|
|
_target.addEventListener('click', _clickHandler, false);
|
|
_target.addEventListener('mouseout', _outHandler, false);
|
|
document.addEventListener('mouseup', _upHandler, false);
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This method unbinds every handlers that makes the captor work.
|
|
*/
|
|
this.kill = function() {
|
|
sigma.utils.unbindDoubleClick(_target, 'click');
|
|
_target.removeEventListener('DOMMouseScroll', _wheelHandler);
|
|
_target.removeEventListener('mousewheel', _wheelHandler);
|
|
_target.removeEventListener('mousemove', _moveHandler);
|
|
_target.removeEventListener('mousedown', _downHandler);
|
|
_target.removeEventListener('click', _clickHandler);
|
|
_target.removeEventListener('mouseout', _outHandler);
|
|
document.removeEventListener('mouseup', _upHandler);
|
|
};
|
|
|
|
|
|
|
|
|
|
// MOUSE EVENTS:
|
|
// *************
|
|
|
|
/**
|
|
* The handler listening to the 'move' mouse event. It will effectively
|
|
* drag the graph.
|
|
*
|
|
* @param {event} e A mouse event.
|
|
*/
|
|
function _moveHandler(e) {
|
|
var x,
|
|
y,
|
|
pos;
|
|
|
|
// Dispatch event:
|
|
if (_settings('mouseEnabled'))
|
|
_self.dispatchEvent('mousemove', {
|
|
x: sigma.utils.getX(e) - sigma.utils.getWidth(e) / 2,
|
|
y: sigma.utils.getY(e) - sigma.utils.getHeight(e) / 2,
|
|
clientX: e.clientX,
|
|
clientY: e.clientY,
|
|
ctrlKey: e.ctrlKey,
|
|
metaKey: e.metaKey,
|
|
altKey: e.altKey,
|
|
shiftKey: e.shiftKey
|
|
});
|
|
|
|
if (_settings('mouseEnabled') && _isMouseDown) {
|
|
_isMoving = true;
|
|
_hasDragged = true;
|
|
|
|
if (_movingTimeoutId)
|
|
clearTimeout(_movingTimeoutId);
|
|
|
|
_movingTimeoutId = setTimeout(function() {
|
|
_isMoving = false;
|
|
}, _settings('dragTimeout'));
|
|
|
|
sigma.misc.animation.killAll(_camera);
|
|
|
|
_camera.isMoving = true;
|
|
pos = _camera.cameraPosition(
|
|
sigma.utils.getX(e) - _startMouseX,
|
|
sigma.utils.getY(e) - _startMouseY,
|
|
true
|
|
);
|
|
|
|
x = _startCameraX - pos.x;
|
|
y = _startCameraY - pos.y;
|
|
|
|
if (x !== _camera.x || y !== _camera.y) {
|
|
_lastCameraX = _camera.x;
|
|
_lastCameraY = _camera.y;
|
|
|
|
_camera.goTo({
|
|
x: x,
|
|
y: y
|
|
});
|
|
}
|
|
|
|
if (e.preventDefault)
|
|
e.preventDefault();
|
|
else
|
|
e.returnValue = false;
|
|
|
|
e.stopPropagation();
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The handler listening to the 'up' mouse event. It will stop dragging the
|
|
* graph.
|
|
*
|
|
* @param {event} e A mouse event.
|
|
*/
|
|
function _upHandler(e) {
|
|
if (_settings('mouseEnabled') && _isMouseDown) {
|
|
_isMouseDown = false;
|
|
if (_movingTimeoutId)
|
|
clearTimeout(_movingTimeoutId);
|
|
|
|
_camera.isMoving = false;
|
|
|
|
var x = sigma.utils.getX(e),
|
|
y = sigma.utils.getY(e);
|
|
|
|
if (_isMoving) {
|
|
sigma.misc.animation.killAll(_camera);
|
|
sigma.misc.animation.camera(
|
|
_camera,
|
|
{
|
|
x: _camera.x +
|
|
_settings('mouseInertiaRatio') * (_camera.x - _lastCameraX),
|
|
y: _camera.y +
|
|
_settings('mouseInertiaRatio') * (_camera.y - _lastCameraY)
|
|
},
|
|
{
|
|
easing: 'quadraticOut',
|
|
duration: _settings('mouseInertiaDuration')
|
|
}
|
|
);
|
|
} else if (
|
|
_startMouseX !== x ||
|
|
_startMouseY !== y
|
|
)
|
|
_camera.goTo({
|
|
x: _camera.x,
|
|
y: _camera.y
|
|
});
|
|
|
|
_self.dispatchEvent('mouseup', {
|
|
x: x - sigma.utils.getWidth(e) / 2,
|
|
y: y - sigma.utils.getHeight(e) / 2,
|
|
clientX: e.clientX,
|
|
clientY: e.clientY,
|
|
ctrlKey: e.ctrlKey,
|
|
metaKey: e.metaKey,
|
|
altKey: e.altKey,
|
|
shiftKey: e.shiftKey
|
|
});
|
|
|
|
// Update _isMoving flag:
|
|
_isMoving = false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The handler listening to the 'down' mouse event. It will start observing
|
|
* the mouse position for dragging the graph.
|
|
*
|
|
* @param {event} e A mouse event.
|
|
*/
|
|
function _downHandler(e) {
|
|
if (_settings('mouseEnabled')) {
|
|
_startCameraX = _camera.x;
|
|
_startCameraY = _camera.y;
|
|
|
|
_lastCameraX = _camera.x;
|
|
_lastCameraY = _camera.y;
|
|
|
|
_startMouseX = sigma.utils.getX(e);
|
|
_startMouseY = sigma.utils.getY(e);
|
|
|
|
_hasDragged = false;
|
|
_downStartTime = (new Date()).getTime();
|
|
|
|
switch (e.which) {
|
|
case 2:
|
|
// Middle mouse button pressed
|
|
// Do nothing.
|
|
break;
|
|
case 3:
|
|
// Right mouse button pressed
|
|
_self.dispatchEvent('rightclick', {
|
|
x: _startMouseX - sigma.utils.getWidth(e) / 2,
|
|
y: _startMouseY - sigma.utils.getHeight(e) / 2,
|
|
clientX: e.clientX,
|
|
clientY: e.clientY,
|
|
ctrlKey: e.ctrlKey,
|
|
metaKey: e.metaKey,
|
|
altKey: e.altKey,
|
|
shiftKey: e.shiftKey
|
|
});
|
|
break;
|
|
// case 1:
|
|
default:
|
|
// Left mouse button pressed
|
|
_isMouseDown = true;
|
|
|
|
_self.dispatchEvent('mousedown', {
|
|
x: _startMouseX - sigma.utils.getWidth(e) / 2,
|
|
y: _startMouseY - sigma.utils.getHeight(e) / 2,
|
|
clientX: e.clientX,
|
|
clientY: e.clientY,
|
|
ctrlKey: e.ctrlKey,
|
|
metaKey: e.metaKey,
|
|
altKey: e.altKey,
|
|
shiftKey: e.shiftKey
|
|
});
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The handler listening to the 'out' mouse event. It will just redispatch
|
|
* the event.
|
|
*
|
|
* @param {event} e A mouse event.
|
|
*/
|
|
function _outHandler(e) {
|
|
if (_settings('mouseEnabled'))
|
|
_self.dispatchEvent('mouseout');
|
|
}
|
|
|
|
/**
|
|
* The handler listening to the 'click' mouse event. It will redispatch the
|
|
* click event, but with normalized X and Y coordinates.
|
|
*
|
|
* @param {event} e A mouse event.
|
|
*/
|
|
function _clickHandler(e) {
|
|
if (_settings('mouseEnabled'))
|
|
_self.dispatchEvent('click', {
|
|
x: sigma.utils.getX(e) - sigma.utils.getWidth(e) / 2,
|
|
y: sigma.utils.getY(e) - sigma.utils.getHeight(e) / 2,
|
|
clientX: e.clientX,
|
|
clientY: e.clientY,
|
|
ctrlKey: e.ctrlKey,
|
|
metaKey: e.metaKey,
|
|
altKey: e.altKey,
|
|
shiftKey: e.shiftKey,
|
|
isDragging:
|
|
(((new Date()).getTime() - _downStartTime) > 100) &&
|
|
_hasDragged
|
|
});
|
|
|
|
if (e.preventDefault)
|
|
e.preventDefault();
|
|
else
|
|
e.returnValue = false;
|
|
|
|
e.stopPropagation();
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* The handler listening to the double click custom event. It will
|
|
* basically zoom into the graph.
|
|
*
|
|
* @param {event} e A mouse event.
|
|
*/
|
|
function _doubleClickHandler(e) {
|
|
var pos,
|
|
ratio,
|
|
animation;
|
|
|
|
if (_settings('mouseEnabled')) {
|
|
ratio = 1 / _settings('doubleClickZoomingRatio');
|
|
|
|
_self.dispatchEvent('doubleclick', {
|
|
x: _startMouseX - sigma.utils.getWidth(e) / 2,
|
|
y: _startMouseY - sigma.utils.getHeight(e) / 2,
|
|
clientX: e.clientX,
|
|
clientY: e.clientY,
|
|
ctrlKey: e.ctrlKey,
|
|
metaKey: e.metaKey,
|
|
altKey: e.altKey,
|
|
shiftKey: e.shiftKey
|
|
});
|
|
|
|
if (_settings('doubleClickEnabled')) {
|
|
pos = _camera.cameraPosition(
|
|
sigma.utils.getX(e) - sigma.utils.getWidth(e) / 2,
|
|
sigma.utils.getY(e) - sigma.utils.getHeight(e) / 2,
|
|
true
|
|
);
|
|
|
|
animation = {
|
|
duration: _settings('doubleClickZoomDuration')
|
|
};
|
|
|
|
sigma.utils.zoomTo(_camera, pos.x, pos.y, ratio, animation);
|
|
}
|
|
|
|
if (e.preventDefault)
|
|
e.preventDefault();
|
|
else
|
|
e.returnValue = false;
|
|
|
|
e.stopPropagation();
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The handler listening to the 'wheel' mouse event. It will basically zoom
|
|
* in or not into the graph.
|
|
*
|
|
* @param {event} e A mouse event.
|
|
*/
|
|
function _wheelHandler(e) {
|
|
var pos,
|
|
ratio,
|
|
animation;
|
|
|
|
if (_settings('mouseEnabled') && _settings('mouseWheelEnabled')) {
|
|
ratio = sigma.utils.getDelta(e) > 0 ?
|
|
1 / _settings('zoomingRatio') :
|
|
_settings('zoomingRatio');
|
|
|
|
pos = _camera.cameraPosition(
|
|
sigma.utils.getX(e) - sigma.utils.getWidth(e) / 2,
|
|
sigma.utils.getY(e) - sigma.utils.getHeight(e) / 2,
|
|
true
|
|
);
|
|
|
|
animation = {
|
|
duration: _settings('mouseZoomDuration')
|
|
};
|
|
|
|
sigma.utils.zoomTo(_camera, pos.x, pos.y, ratio, animation);
|
|
|
|
if (e.preventDefault)
|
|
e.preventDefault();
|
|
else
|
|
e.returnValue = false;
|
|
|
|
e.stopPropagation();
|
|
return false;
|
|
}
|
|
}
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.captors');
|
|
|
|
/**
|
|
* The user inputs default captor. It deals with mouse events, keyboards
|
|
* events and touch events.
|
|
*
|
|
* @param {DOMElement} target The DOM element where the listeners will be
|
|
* bound.
|
|
* @param {camera} camera The camera related to the target.
|
|
* @param {configurable} settings The settings function.
|
|
* @return {sigma.captor} The fresh new captor instance.
|
|
*/
|
|
sigma.captors.touch = function(target, camera, settings) {
|
|
var _self = this,
|
|
_target = target,
|
|
_camera = camera,
|
|
_settings = settings,
|
|
|
|
// CAMERA MANAGEMENT:
|
|
// ******************
|
|
// The camera position when the user starts dragging:
|
|
_startCameraX,
|
|
_startCameraY,
|
|
_startCameraAngle,
|
|
_startCameraRatio,
|
|
|
|
// The latest stage position:
|
|
_lastCameraX,
|
|
_lastCameraY,
|
|
_lastCameraAngle,
|
|
_lastCameraRatio,
|
|
|
|
// TOUCH MANAGEMENT:
|
|
// *****************
|
|
// Touches that are down:
|
|
_downTouches = [],
|
|
|
|
_startTouchX0,
|
|
_startTouchY0,
|
|
_startTouchX1,
|
|
_startTouchY1,
|
|
_startTouchAngle,
|
|
_startTouchDistance,
|
|
|
|
_touchMode,
|
|
|
|
_isMoving,
|
|
_doubleTap,
|
|
_movingTimeoutId;
|
|
|
|
sigma.classes.dispatcher.extend(this);
|
|
|
|
sigma.utils.doubleClick(_target, 'touchstart', _doubleTapHandler);
|
|
_target.addEventListener('touchstart', _handleStart, false);
|
|
_target.addEventListener('touchend', _handleLeave, false);
|
|
_target.addEventListener('touchcancel', _handleLeave, false);
|
|
_target.addEventListener('touchleave', _handleLeave, false);
|
|
_target.addEventListener('touchmove', _handleMove, false);
|
|
|
|
function position(e) {
|
|
var offset = sigma.utils.getOffset(_target);
|
|
|
|
return {
|
|
x: e.pageX - offset.left,
|
|
y: e.pageY - offset.top
|
|
};
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This method unbinds every handlers that makes the captor work.
|
|
*/
|
|
this.kill = function() {
|
|
sigma.utils.unbindDoubleClick(_target, 'touchstart');
|
|
_target.addEventListener('touchstart', _handleStart);
|
|
_target.addEventListener('touchend', _handleLeave);
|
|
_target.addEventListener('touchcancel', _handleLeave);
|
|
_target.addEventListener('touchleave', _handleLeave);
|
|
_target.addEventListener('touchmove', _handleMove);
|
|
};
|
|
|
|
|
|
|
|
|
|
// TOUCH EVENTS:
|
|
// *************
|
|
/**
|
|
* The handler listening to the 'touchstart' event. It will set the touch
|
|
* mode ("_touchMode") and start observing the user touch moves.
|
|
*
|
|
* @param {event} e A touch event.
|
|
*/
|
|
function _handleStart(e) {
|
|
if (_settings('touchEnabled')) {
|
|
var x0,
|
|
x1,
|
|
y0,
|
|
y1,
|
|
pos0,
|
|
pos1;
|
|
|
|
_downTouches = e.touches;
|
|
|
|
switch (_downTouches.length) {
|
|
case 1:
|
|
_camera.isMoving = true;
|
|
_touchMode = 1;
|
|
|
|
_startCameraX = _camera.x;
|
|
_startCameraY = _camera.y;
|
|
|
|
_lastCameraX = _camera.x;
|
|
_lastCameraY = _camera.y;
|
|
|
|
pos0 = position(_downTouches[0]);
|
|
_startTouchX0 = pos0.x;
|
|
_startTouchY0 = pos0.y;
|
|
|
|
break;
|
|
case 2:
|
|
_camera.isMoving = true;
|
|
_touchMode = 2;
|
|
|
|
pos0 = position(_downTouches[0]);
|
|
pos1 = position(_downTouches[1]);
|
|
x0 = pos0.x;
|
|
y0 = pos0.y;
|
|
x1 = pos1.x;
|
|
y1 = pos1.y;
|
|
|
|
_lastCameraX = _camera.x;
|
|
_lastCameraY = _camera.y;
|
|
|
|
_startCameraAngle = _camera.angle;
|
|
_startCameraRatio = _camera.ratio;
|
|
|
|
_startCameraX = _camera.x;
|
|
_startCameraY = _camera.y;
|
|
|
|
_startTouchX0 = x0;
|
|
_startTouchY0 = y0;
|
|
_startTouchX1 = x1;
|
|
_startTouchY1 = y1;
|
|
|
|
_startTouchAngle = Math.atan2(
|
|
_startTouchY1 - _startTouchY0,
|
|
_startTouchX1 - _startTouchX0
|
|
);
|
|
_startTouchDistance = Math.sqrt(
|
|
Math.pow(_startTouchY1 - _startTouchY0, 2) +
|
|
Math.pow(_startTouchX1 - _startTouchX0, 2)
|
|
);
|
|
|
|
e.preventDefault();
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The handler listening to the 'touchend', 'touchcancel' and 'touchleave'
|
|
* event. It will update the touch mode if there are still at least one
|
|
* finger, and stop dragging else.
|
|
*
|
|
* @param {event} e A touch event.
|
|
*/
|
|
function _handleLeave(e) {
|
|
if (_settings('touchEnabled')) {
|
|
_downTouches = e.touches;
|
|
var inertiaRatio = _settings('touchInertiaRatio');
|
|
|
|
if (_movingTimeoutId) {
|
|
_isMoving = false;
|
|
clearTimeout(_movingTimeoutId);
|
|
}
|
|
|
|
switch (_touchMode) {
|
|
case 2:
|
|
if (e.touches.length === 1) {
|
|
_handleStart(e);
|
|
|
|
e.preventDefault();
|
|
break;
|
|
}
|
|
/* falls through */
|
|
case 1:
|
|
_camera.isMoving = false;
|
|
_self.dispatchEvent('stopDrag');
|
|
|
|
if (_isMoving) {
|
|
_doubleTap = false;
|
|
sigma.misc.animation.camera(
|
|
_camera,
|
|
{
|
|
x: _camera.x +
|
|
inertiaRatio * (_camera.x - _lastCameraX),
|
|
y: _camera.y +
|
|
inertiaRatio * (_camera.y - _lastCameraY)
|
|
},
|
|
{
|
|
easing: 'quadraticOut',
|
|
duration: _settings('touchInertiaDuration')
|
|
}
|
|
);
|
|
}
|
|
|
|
_isMoving = false;
|
|
_touchMode = 0;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The handler listening to the 'touchmove' event. It will effectively drag
|
|
* the graph, and eventually zooms and turn it if the user is using two
|
|
* fingers.
|
|
*
|
|
* @param {event} e A touch event.
|
|
*/
|
|
function _handleMove(e) {
|
|
if (!_doubleTap && _settings('touchEnabled')) {
|
|
var x0,
|
|
x1,
|
|
y0,
|
|
y1,
|
|
cos,
|
|
sin,
|
|
end,
|
|
pos0,
|
|
pos1,
|
|
diff,
|
|
start,
|
|
dAngle,
|
|
dRatio,
|
|
newStageX,
|
|
newStageY,
|
|
newStageRatio,
|
|
newStageAngle;
|
|
|
|
_downTouches = e.touches;
|
|
_isMoving = true;
|
|
|
|
if (_movingTimeoutId)
|
|
clearTimeout(_movingTimeoutId);
|
|
|
|
_movingTimeoutId = setTimeout(function() {
|
|
_isMoving = false;
|
|
}, _settings('dragTimeout'));
|
|
|
|
switch (_touchMode) {
|
|
case 1:
|
|
pos0 = position(_downTouches[0]);
|
|
x0 = pos0.x;
|
|
y0 = pos0.y;
|
|
|
|
diff = _camera.cameraPosition(
|
|
x0 - _startTouchX0,
|
|
y0 - _startTouchY0,
|
|
true
|
|
);
|
|
|
|
newStageX = _startCameraX - diff.x;
|
|
newStageY = _startCameraY - diff.y;
|
|
|
|
if (newStageX !== _camera.x || newStageY !== _camera.y) {
|
|
_lastCameraX = _camera.x;
|
|
_lastCameraY = _camera.y;
|
|
|
|
_camera.goTo({
|
|
x: newStageX,
|
|
y: newStageY
|
|
});
|
|
|
|
_self.dispatchEvent('mousemove', {
|
|
x: pos0.x - sigma.utils.getWidth(e) / 2,
|
|
y: pos0.y - sigma.utils.getHeight(e) / 2,
|
|
clientX: e.clientX,
|
|
clientY: e.clientY,
|
|
ctrlKey: e.ctrlKey,
|
|
metaKey: e.metaKey,
|
|
altKey: e.altKey,
|
|
shiftKey: e.shiftKey
|
|
});
|
|
|
|
_self.dispatchEvent('drag');
|
|
}
|
|
break;
|
|
case 2:
|
|
pos0 = position(_downTouches[0]);
|
|
pos1 = position(_downTouches[1]);
|
|
x0 = pos0.x;
|
|
y0 = pos0.y;
|
|
x1 = pos1.x;
|
|
y1 = pos1.y;
|
|
|
|
start = _camera.cameraPosition(
|
|
(_startTouchX0 + _startTouchX1) / 2 -
|
|
sigma.utils.getWidth(e) / 2,
|
|
(_startTouchY0 + _startTouchY1) / 2 -
|
|
sigma.utils.getHeight(e) / 2,
|
|
true
|
|
);
|
|
end = _camera.cameraPosition(
|
|
(x0 + x1) / 2 - sigma.utils.getWidth(e) / 2,
|
|
(y0 + y1) / 2 - sigma.utils.getHeight(e) / 2,
|
|
true
|
|
);
|
|
|
|
dAngle = Math.atan2(y1 - y0, x1 - x0) - _startTouchAngle;
|
|
dRatio = Math.sqrt(
|
|
Math.pow(y1 - y0, 2) + Math.pow(x1 - x0, 2)
|
|
) / _startTouchDistance;
|
|
|
|
// Translation:
|
|
x0 = start.x;
|
|
y0 = start.y;
|
|
|
|
// Homothetic transformation:
|
|
newStageRatio = _startCameraRatio / dRatio;
|
|
x0 = x0 * dRatio;
|
|
y0 = y0 * dRatio;
|
|
|
|
// Rotation:
|
|
newStageAngle = _startCameraAngle - dAngle;
|
|
cos = Math.cos(-dAngle);
|
|
sin = Math.sin(-dAngle);
|
|
x1 = x0 * cos + y0 * sin;
|
|
y1 = y0 * cos - x0 * sin;
|
|
x0 = x1;
|
|
y0 = y1;
|
|
|
|
// Finalize:
|
|
newStageX = x0 - end.x + _startCameraX;
|
|
newStageY = y0 - end.y + _startCameraY;
|
|
|
|
if (
|
|
newStageRatio !== _camera.ratio ||
|
|
newStageAngle !== _camera.angle ||
|
|
newStageX !== _camera.x ||
|
|
newStageY !== _camera.y
|
|
) {
|
|
_lastCameraX = _camera.x;
|
|
_lastCameraY = _camera.y;
|
|
_lastCameraAngle = _camera.angle;
|
|
_lastCameraRatio = _camera.ratio;
|
|
|
|
_camera.goTo({
|
|
x: newStageX,
|
|
y: newStageY,
|
|
angle: newStageAngle,
|
|
ratio: newStageRatio
|
|
});
|
|
|
|
_self.dispatchEvent('drag');
|
|
}
|
|
|
|
break;
|
|
}
|
|
|
|
e.preventDefault();
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The handler listening to the double tap custom event. It will
|
|
* basically zoom into the graph.
|
|
*
|
|
* @param {event} e A touch event.
|
|
*/
|
|
function _doubleTapHandler(e) {
|
|
var pos,
|
|
ratio,
|
|
animation;
|
|
|
|
if (e.touches && e.touches.length === 1 && _settings('touchEnabled')) {
|
|
_doubleTap = true;
|
|
|
|
ratio = 1 / _settings('doubleClickZoomingRatio');
|
|
|
|
pos = position(e.touches[0]);
|
|
_self.dispatchEvent('doubleclick', {
|
|
x: pos.x - sigma.utils.getWidth(e) / 2,
|
|
y: pos.y - sigma.utils.getHeight(e) / 2,
|
|
clientX: e.clientX,
|
|
clientY: e.clientY,
|
|
ctrlKey: e.ctrlKey,
|
|
metaKey: e.metaKey,
|
|
altKey: e.altKey,
|
|
shiftKey: e.shiftKey
|
|
});
|
|
|
|
if (_settings('doubleClickEnabled')) {
|
|
pos = _camera.cameraPosition(
|
|
pos.x - sigma.utils.getWidth(e) / 2,
|
|
pos.y - sigma.utils.getHeight(e) / 2,
|
|
true
|
|
);
|
|
|
|
animation = {
|
|
duration: _settings('doubleClickZoomDuration'),
|
|
onComplete: function() {
|
|
_doubleTap = false;
|
|
}
|
|
};
|
|
|
|
sigma.utils.zoomTo(_camera, pos.x, pos.y, ratio, animation);
|
|
}
|
|
|
|
if (e.preventDefault)
|
|
e.preventDefault();
|
|
else
|
|
e.returnValue = false;
|
|
|
|
e.stopPropagation();
|
|
return false;
|
|
}
|
|
}
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
if (typeof conrad === 'undefined')
|
|
throw 'conrad is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.renderers');
|
|
|
|
/**
|
|
* This function is the constructor of the canvas sigma's renderer.
|
|
*
|
|
* @param {sigma.classes.graph} graph The graph to render.
|
|
* @param {sigma.classes.camera} camera The camera.
|
|
* @param {configurable} settings The sigma instance settings
|
|
* function.
|
|
* @param {object} object The options object.
|
|
* @return {sigma.renderers.canvas} The renderer instance.
|
|
*/
|
|
sigma.renderers.canvas = function(graph, camera, settings, options) {
|
|
if (typeof options !== 'object')
|
|
throw 'sigma.renderers.canvas: Wrong arguments.';
|
|
|
|
if (!(options.container instanceof HTMLElement))
|
|
throw 'Container not found.';
|
|
|
|
var k,
|
|
i,
|
|
l,
|
|
a,
|
|
fn,
|
|
self = this;
|
|
|
|
sigma.classes.dispatcher.extend(this);
|
|
|
|
// Initialize main attributes:
|
|
Object.defineProperty(this, 'conradId', {
|
|
value: sigma.utils.id()
|
|
});
|
|
this.graph = graph;
|
|
this.camera = camera;
|
|
this.contexts = {};
|
|
this.domElements = {};
|
|
this.options = options;
|
|
this.container = this.options.container;
|
|
this.settings = (
|
|
typeof options.settings === 'object' &&
|
|
options.settings
|
|
) ?
|
|
settings.embedObjects(options.settings) :
|
|
settings;
|
|
|
|
// Node indexes:
|
|
this.nodesOnScreen = [];
|
|
this.edgesOnScreen = [];
|
|
|
|
// Conrad related attributes:
|
|
this.jobs = {};
|
|
|
|
// Find the prefix:
|
|
this.options.prefix = 'renderer' + this.conradId + ':';
|
|
|
|
// Initialize the DOM elements:
|
|
if (
|
|
!this.settings('batchEdgesDrawing')
|
|
) {
|
|
this.initDOM('canvas', 'scene');
|
|
this.contexts.edges = this.contexts.scene;
|
|
this.contexts.nodes = this.contexts.scene;
|
|
this.contexts.labels = this.contexts.scene;
|
|
} else {
|
|
this.initDOM('canvas', 'edges');
|
|
this.initDOM('canvas', 'scene');
|
|
this.contexts.nodes = this.contexts.scene;
|
|
this.contexts.labels = this.contexts.scene;
|
|
}
|
|
|
|
this.initDOM('canvas', 'mouse');
|
|
this.contexts.hover = this.contexts.mouse;
|
|
|
|
// Initialize captors:
|
|
this.captors = [];
|
|
a = this.options.captors || [sigma.captors.mouse, sigma.captors.touch];
|
|
for (i = 0, l = a.length; i < l; i++) {
|
|
fn = typeof a[i] === 'function' ? a[i] : sigma.captors[a[i]];
|
|
this.captors.push(
|
|
new fn(
|
|
this.domElements.mouse,
|
|
this.camera,
|
|
this.settings
|
|
)
|
|
);
|
|
}
|
|
|
|
// Deal with sigma events:
|
|
sigma.misc.bindEvents.call(this, this.options.prefix);
|
|
sigma.misc.drawHovers.call(this, this.options.prefix);
|
|
|
|
this.resize(false);
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This method renders the graph on the canvases.
|
|
*
|
|
* @param {?object} options Eventually an object of options.
|
|
* @return {sigma.renderers.canvas} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.canvas.prototype.render = function(options) {
|
|
options = options || {};
|
|
|
|
var a,
|
|
i,
|
|
k,
|
|
l,
|
|
o,
|
|
id,
|
|
end,
|
|
job,
|
|
start,
|
|
edges,
|
|
renderers,
|
|
rendererType,
|
|
batchSize,
|
|
tempGCO,
|
|
index = {},
|
|
graph = this.graph,
|
|
nodes = this.graph.nodes,
|
|
prefix = this.options.prefix || '',
|
|
drawEdges = this.settings(options, 'drawEdges'),
|
|
drawNodes = this.settings(options, 'drawNodes'),
|
|
drawLabels = this.settings(options, 'drawLabels'),
|
|
drawEdgeLabels = this.settings(options, 'drawEdgeLabels'),
|
|
embedSettings = this.settings.embedObjects(options, {
|
|
prefix: this.options.prefix
|
|
});
|
|
|
|
// Call the resize function:
|
|
this.resize(false);
|
|
|
|
// Check the 'hideEdgesOnMove' setting:
|
|
if (this.settings(options, 'hideEdgesOnMove'))
|
|
if (this.camera.isAnimated || this.camera.isMoving)
|
|
drawEdges = false;
|
|
|
|
// Apply the camera's view:
|
|
this.camera.applyView(
|
|
undefined,
|
|
this.options.prefix,
|
|
{
|
|
width: this.width,
|
|
height: this.height
|
|
}
|
|
);
|
|
|
|
// Clear canvases:
|
|
this.clear();
|
|
|
|
// Kill running jobs:
|
|
for (k in this.jobs)
|
|
if (conrad.hasJob(k))
|
|
conrad.killJob(k);
|
|
|
|
// Find which nodes are on screen:
|
|
this.edgesOnScreen = [];
|
|
this.nodesOnScreen = this.camera.quadtree.area(
|
|
this.camera.getRectangle(this.width, this.height)
|
|
);
|
|
|
|
for (a = this.nodesOnScreen, i = 0, l = a.length; i < l; i++)
|
|
index[a[i].id] = a[i];
|
|
|
|
// Draw edges:
|
|
// - If settings('batchEdgesDrawing') is true, the edges are displayed per
|
|
// batches. If not, they are drawn in one frame.
|
|
if (drawEdges) {
|
|
// First, let's identify which edges to draw. To do this, we just keep
|
|
// every edges that have at least one extremity displayed according to
|
|
// the quadtree and the "hidden" attribute. We also do not keep hidden
|
|
// edges.
|
|
for (a = graph.edges(), i = 0, l = a.length; i < l; i++) {
|
|
o = a[i];
|
|
if (
|
|
(index[o.source] || index[o.target]) &&
|
|
(!o.hidden && !nodes(o.source).hidden && !nodes(o.target).hidden)
|
|
)
|
|
this.edgesOnScreen.push(o);
|
|
}
|
|
|
|
// If the "batchEdgesDrawing" settings is true, edges are batched:
|
|
if (this.settings(options, 'batchEdgesDrawing')) {
|
|
id = 'edges_' + this.conradId;
|
|
batchSize = embedSettings('canvasEdgesBatchSize');
|
|
|
|
edges = this.edgesOnScreen;
|
|
l = edges.length;
|
|
|
|
start = 0;
|
|
end = Math.min(edges.length, start + batchSize);
|
|
|
|
job = function() {
|
|
tempGCO = this.contexts.edges.globalCompositeOperation;
|
|
this.contexts.edges.globalCompositeOperation = 'destination-over';
|
|
|
|
renderers = sigma.canvas.edges;
|
|
for (i = start; i < end; i++) {
|
|
o = edges[i];
|
|
(renderers[
|
|
o.type || this.settings(options, 'defaultEdgeType')
|
|
] || renderers.def)(
|
|
o,
|
|
graph.nodes(o.source),
|
|
graph.nodes(o.target),
|
|
this.contexts.edges,
|
|
embedSettings
|
|
);
|
|
}
|
|
|
|
// Draw edge labels:
|
|
if (drawEdgeLabels) {
|
|
renderers = sigma.canvas.edges.labels;
|
|
for (i = start; i < end; i++) {
|
|
o = edges[i];
|
|
if (!o.hidden)
|
|
(renderers[
|
|
o.type || this.settings(options, 'defaultEdgeType')
|
|
] || renderers.def)(
|
|
o,
|
|
graph.nodes(o.source),
|
|
graph.nodes(o.target),
|
|
this.contexts.labels,
|
|
embedSettings
|
|
);
|
|
}
|
|
}
|
|
|
|
// Restore original globalCompositeOperation:
|
|
this.contexts.edges.globalCompositeOperation = tempGCO;
|
|
|
|
// Catch job's end:
|
|
if (end === edges.length) {
|
|
delete this.jobs[id];
|
|
return false;
|
|
}
|
|
|
|
start = end + 1;
|
|
end = Math.min(edges.length, start + batchSize);
|
|
return true;
|
|
};
|
|
|
|
this.jobs[id] = job;
|
|
conrad.addJob(id, job.bind(this));
|
|
|
|
// If not, they are drawn in one frame:
|
|
} else {
|
|
renderers = sigma.canvas.edges;
|
|
for (a = this.edgesOnScreen, i = 0, l = a.length; i < l; i++) {
|
|
o = a[i];
|
|
(renderers[
|
|
o.type || this.settings(options, 'defaultEdgeType')
|
|
] || renderers.def)(
|
|
o,
|
|
graph.nodes(o.source),
|
|
graph.nodes(o.target),
|
|
this.contexts.edges,
|
|
embedSettings
|
|
);
|
|
}
|
|
|
|
// Draw edge labels:
|
|
// - No batching
|
|
if (drawEdgeLabels) {
|
|
renderers = sigma.canvas.edges.labels;
|
|
for (a = this.edgesOnScreen, i = 0, l = a.length; i < l; i++)
|
|
if (!a[i].hidden)
|
|
(renderers[
|
|
a[i].type || this.settings(options, 'defaultEdgeType')
|
|
] || renderers.def)(
|
|
a[i],
|
|
graph.nodes(a[i].source),
|
|
graph.nodes(a[i].target),
|
|
this.contexts.labels,
|
|
embedSettings
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Draw nodes:
|
|
// - No batching
|
|
if (drawNodes) {
|
|
renderers = sigma.canvas.nodes;
|
|
for (a = this.nodesOnScreen, i = 0, l = a.length; i < l; i++)
|
|
if (!a[i].hidden)
|
|
(renderers[
|
|
a[i].type || this.settings(options, 'defaultNodeType')
|
|
] || renderers.def)(
|
|
a[i],
|
|
this.contexts.nodes,
|
|
embedSettings
|
|
);
|
|
}
|
|
|
|
// Draw labels:
|
|
// - No batching
|
|
if (drawLabels) {
|
|
renderers = sigma.canvas.labels;
|
|
for (a = this.nodesOnScreen, i = 0, l = a.length; i < l; i++)
|
|
if (!a[i].hidden)
|
|
(renderers[
|
|
a[i].type || this.settings(options, 'defaultNodeType')
|
|
] || renderers.def)(
|
|
a[i],
|
|
this.contexts.labels,
|
|
embedSettings
|
|
);
|
|
}
|
|
|
|
this.dispatchEvent('render');
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method creates a DOM element of the specified type, switches its
|
|
* position to "absolute", references it to the domElements attribute, and
|
|
* finally appends it to the container.
|
|
*
|
|
* @param {string} tag The label tag.
|
|
* @param {string} id The id of the element (to store it in "domElements").
|
|
*/
|
|
sigma.renderers.canvas.prototype.initDOM = function(tag, id) {
|
|
var dom = document.createElement(tag);
|
|
|
|
dom.style.position = 'absolute';
|
|
dom.setAttribute('class', 'sigma-' + id);
|
|
|
|
this.domElements[id] = dom;
|
|
this.container.appendChild(dom);
|
|
|
|
if (tag.toLowerCase() === 'canvas')
|
|
this.contexts[id] = dom.getContext('2d');
|
|
};
|
|
|
|
/**
|
|
* This method resizes each DOM elements in the container and stores the new
|
|
* dimensions. Then, it renders the graph.
|
|
*
|
|
* @param {?number} width The new width of the container.
|
|
* @param {?number} height The new height of the container.
|
|
* @return {sigma.renderers.canvas} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.canvas.prototype.resize = function(w, h) {
|
|
var k,
|
|
oldWidth = this.width,
|
|
oldHeight = this.height,
|
|
pixelRatio = 1;
|
|
// TODO:
|
|
// *****
|
|
// This pixelRatio is the solution to display with the good definition
|
|
// on canvases on Retina displays (ie oversampling). Unfortunately, it
|
|
// has a huge performance cost...
|
|
// > pixelRatio = window.devicePixelRatio || 1;
|
|
|
|
if (w !== undefined && h !== undefined) {
|
|
this.width = w;
|
|
this.height = h;
|
|
} else {
|
|
this.width = this.container.offsetWidth;
|
|
this.height = this.container.offsetHeight;
|
|
|
|
w = this.width;
|
|
h = this.height;
|
|
}
|
|
|
|
if (oldWidth !== this.width || oldHeight !== this.height) {
|
|
for (k in this.domElements) {
|
|
this.domElements[k].style.width = w + 'px';
|
|
this.domElements[k].style.height = h + 'px';
|
|
|
|
if (this.domElements[k].tagName.toLowerCase() === 'canvas') {
|
|
this.domElements[k].setAttribute('width', (w * pixelRatio) + 'px');
|
|
this.domElements[k].setAttribute('height', (h * pixelRatio) + 'px');
|
|
|
|
if (pixelRatio !== 1)
|
|
this.contexts[k].scale(pixelRatio, pixelRatio);
|
|
}
|
|
}
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method clears each canvas.
|
|
*
|
|
* @return {sigma.renderers.canvas} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.canvas.prototype.clear = function() {
|
|
var k;
|
|
|
|
for (k in this.domElements)
|
|
if (this.domElements[k].tagName === 'CANVAS')
|
|
this.domElements[k].width = this.domElements[k].width;
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method kills contexts and other attributes.
|
|
*/
|
|
sigma.renderers.canvas.prototype.kill = function() {
|
|
var k,
|
|
captor;
|
|
|
|
// Kill captors:
|
|
while ((captor = this.captors.pop()))
|
|
captor.kill();
|
|
delete this.captors;
|
|
|
|
// Kill contexts:
|
|
for (k in this.domElements) {
|
|
this.domElements[k].parentNode.removeChild(this.domElements[k]);
|
|
delete this.domElements[k];
|
|
delete this.contexts[k];
|
|
}
|
|
delete this.domElements;
|
|
delete this.contexts;
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* The labels, nodes and edges renderers are stored in the three following
|
|
* objects. When an element is drawn, its type will be checked and if a
|
|
* renderer with the same name exists, it will be used. If not found, the
|
|
* default renderer will be used instead.
|
|
*
|
|
* They are stored in different files, in the "./canvas" folder.
|
|
*/
|
|
sigma.utils.pkg('sigma.canvas.nodes');
|
|
sigma.utils.pkg('sigma.canvas.edges');
|
|
sigma.utils.pkg('sigma.canvas.labels');
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.renderers');
|
|
|
|
/**
|
|
* This function is the constructor of the canvas sigma's renderer.
|
|
*
|
|
* @param {sigma.classes.graph} graph The graph to render.
|
|
* @param {sigma.classes.camera} camera The camera.
|
|
* @param {configurable} settings The sigma instance settings
|
|
* function.
|
|
* @param {object} object The options object.
|
|
* @return {sigma.renderers.canvas} The renderer instance.
|
|
*/
|
|
sigma.renderers.webgl = function(graph, camera, settings, options) {
|
|
if (typeof options !== 'object')
|
|
throw 'sigma.renderers.webgl: Wrong arguments.';
|
|
|
|
if (!(options.container instanceof HTMLElement))
|
|
throw 'Container not found.';
|
|
|
|
var k,
|
|
i,
|
|
l,
|
|
a,
|
|
fn,
|
|
_self = this;
|
|
|
|
sigma.classes.dispatcher.extend(this);
|
|
|
|
// Conrad related attributes:
|
|
this.jobs = {};
|
|
|
|
Object.defineProperty(this, 'conradId', {
|
|
value: sigma.utils.id()
|
|
});
|
|
|
|
// Initialize main attributes:
|
|
this.graph = graph;
|
|
this.camera = camera;
|
|
this.contexts = {};
|
|
this.domElements = {};
|
|
this.options = options;
|
|
this.container = this.options.container;
|
|
this.settings = (
|
|
typeof options.settings === 'object' &&
|
|
options.settings
|
|
) ?
|
|
settings.embedObjects(options.settings) :
|
|
settings;
|
|
|
|
// Find the prefix:
|
|
this.options.prefix = this.camera.readPrefix;
|
|
|
|
// Initialize programs hash
|
|
Object.defineProperty(this, 'nodePrograms', {
|
|
value: {}
|
|
});
|
|
Object.defineProperty(this, 'edgePrograms', {
|
|
value: {}
|
|
});
|
|
Object.defineProperty(this, 'nodeFloatArrays', {
|
|
value: {}
|
|
});
|
|
Object.defineProperty(this, 'edgeFloatArrays', {
|
|
value: {}
|
|
});
|
|
|
|
// Initialize the DOM elements:
|
|
if (this.settings(options, 'batchEdgesDrawing')) {
|
|
this.initDOM('canvas', 'edges', true);
|
|
this.initDOM('canvas', 'nodes', true);
|
|
} else {
|
|
this.initDOM('canvas', 'scene', true);
|
|
this.contexts.nodes = this.contexts.scene;
|
|
this.contexts.edges = this.contexts.scene;
|
|
}
|
|
|
|
this.initDOM('canvas', 'labels');
|
|
this.initDOM('canvas', 'mouse');
|
|
this.contexts.hover = this.contexts.mouse;
|
|
|
|
// Initialize captors:
|
|
this.captors = [];
|
|
a = this.options.captors || [sigma.captors.mouse, sigma.captors.touch];
|
|
for (i = 0, l = a.length; i < l; i++) {
|
|
fn = typeof a[i] === 'function' ? a[i] : sigma.captors[a[i]];
|
|
this.captors.push(
|
|
new fn(
|
|
this.domElements.mouse,
|
|
this.camera,
|
|
this.settings
|
|
)
|
|
);
|
|
}
|
|
|
|
// Deal with sigma events:
|
|
sigma.misc.bindEvents.call(this, this.camera.prefix);
|
|
sigma.misc.drawHovers.call(this, this.camera.prefix);
|
|
|
|
this.resize();
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This method will generate the nodes and edges float arrays. This step is
|
|
* separated from the "render" method, because to keep WebGL efficient, since
|
|
* all the camera and middlewares are modelised as matrices and they do not
|
|
* require the float arrays to be regenerated.
|
|
*
|
|
* Basically, when the user moves the camera or applies some specific linear
|
|
* transformations, this process step will be skipped, and the "render"
|
|
* method will efficiently refresh the rendering.
|
|
*
|
|
* And when the user modifies the graph colors or positions (applying a new
|
|
* layout or filtering the colors, for instance), this "process" step will be
|
|
* required to regenerate the float arrays.
|
|
*
|
|
* @return {sigma.renderers.webgl} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.webgl.prototype.process = function() {
|
|
var a,
|
|
i,
|
|
l,
|
|
k,
|
|
type,
|
|
renderer,
|
|
graph = this.graph,
|
|
options = sigma.utils.extend(options, this.options);
|
|
|
|
// Empty float arrays:
|
|
for (k in this.nodeFloatArrays)
|
|
delete this.nodeFloatArrays[k];
|
|
|
|
for (k in this.edgeFloatArrays)
|
|
delete this.edgeFloatArrays[k];
|
|
|
|
// Sort edges and nodes per types:
|
|
for (a = graph.edges(), i = 0, l = a.length; i < l; i++) {
|
|
type = a[i].type || this.settings(options, 'defaultEdgeType');
|
|
k = (type && sigma.webgl.edges[type]) ? type : 'def';
|
|
|
|
if (!this.edgeFloatArrays[k])
|
|
this.edgeFloatArrays[k] = {
|
|
edges: []
|
|
};
|
|
|
|
this.edgeFloatArrays[k].edges.push(a[i]);
|
|
}
|
|
|
|
for (a = graph.nodes(), i = 0, l = a.length; i < l; i++) {
|
|
type = a[i].type || this.settings(options, 'defaultNodeType');
|
|
k = (type && sigma.webgl.nodes[type]) ? type : 'def';
|
|
|
|
if (!this.nodeFloatArrays[k])
|
|
this.nodeFloatArrays[k] = {
|
|
nodes: []
|
|
};
|
|
|
|
this.nodeFloatArrays[k].nodes.push(a[i]);
|
|
}
|
|
|
|
// Push edges:
|
|
for (k in this.edgeFloatArrays) {
|
|
renderer = sigma.webgl.edges[k];
|
|
|
|
for (a = this.edgeFloatArrays[k].edges, i = 0, l = a.length; i < l; i++) {
|
|
if (!this.edgeFloatArrays[k].array)
|
|
this.edgeFloatArrays[k].array = new Float32Array(
|
|
a.length * renderer.POINTS * renderer.ATTRIBUTES
|
|
);
|
|
|
|
// Just check that the edge and both its extremities are visible:
|
|
if (
|
|
!a[i].hidden &&
|
|
!graph.nodes(a[i].source).hidden &&
|
|
!graph.nodes(a[i].target).hidden
|
|
)
|
|
renderer.addEdge(
|
|
a[i],
|
|
graph.nodes(a[i].source),
|
|
graph.nodes(a[i].target),
|
|
this.edgeFloatArrays[k].array,
|
|
i * renderer.POINTS * renderer.ATTRIBUTES,
|
|
options.prefix,
|
|
this.settings
|
|
);
|
|
}
|
|
}
|
|
|
|
// Push nodes:
|
|
for (k in this.nodeFloatArrays) {
|
|
renderer = sigma.webgl.nodes[k];
|
|
|
|
for (a = this.nodeFloatArrays[k].nodes, i = 0, l = a.length; i < l; i++) {
|
|
if (!this.nodeFloatArrays[k].array)
|
|
this.nodeFloatArrays[k].array = new Float32Array(
|
|
a.length * renderer.POINTS * renderer.ATTRIBUTES
|
|
);
|
|
|
|
// Just check that the edge and both its extremities are visible:
|
|
if (
|
|
!a[i].hidden
|
|
)
|
|
renderer.addNode(
|
|
a[i],
|
|
this.nodeFloatArrays[k].array,
|
|
i * renderer.POINTS * renderer.ATTRIBUTES,
|
|
options.prefix,
|
|
this.settings
|
|
);
|
|
}
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This method renders the graph. It basically calls each program (and
|
|
* generate them if they do not exist yet) to render nodes and edges, batched
|
|
* per renderer.
|
|
*
|
|
* As in the canvas renderer, it is possible to display edges, nodes and / or
|
|
* labels in batches, to make the whole thing way more scalable.
|
|
*
|
|
* @param {?object} params Eventually an object of options.
|
|
* @return {sigma.renderers.webgl} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.webgl.prototype.render = function(params) {
|
|
var a,
|
|
i,
|
|
l,
|
|
k,
|
|
o,
|
|
program,
|
|
renderer,
|
|
self = this,
|
|
graph = this.graph,
|
|
nodesGl = this.contexts.nodes,
|
|
edgesGl = this.contexts.edges,
|
|
matrix = this.camera.getMatrix(),
|
|
options = sigma.utils.extend(params, this.options),
|
|
drawLabels = this.settings(options, 'drawLabels'),
|
|
drawEdges = this.settings(options, 'drawEdges'),
|
|
drawNodes = this.settings(options, 'drawNodes');
|
|
|
|
// Call the resize function:
|
|
this.resize(false);
|
|
|
|
// Check the 'hideEdgesOnMove' setting:
|
|
if (this.settings(options, 'hideEdgesOnMove'))
|
|
if (this.camera.isAnimated || this.camera.isMoving)
|
|
drawEdges = false;
|
|
|
|
// Clear canvases:
|
|
this.clear();
|
|
|
|
// Translate matrix to [width/2, height/2]:
|
|
matrix = sigma.utils.matrices.multiply(
|
|
matrix,
|
|
sigma.utils.matrices.translation(this.width / 2, this.height / 2)
|
|
);
|
|
|
|
// Kill running jobs:
|
|
for (k in this.jobs)
|
|
if (conrad.hasJob(k))
|
|
conrad.killJob(k);
|
|
|
|
if (drawEdges) {
|
|
if (this.settings(options, 'batchEdgesDrawing'))
|
|
(function() {
|
|
var a,
|
|
k,
|
|
i,
|
|
id,
|
|
job,
|
|
arr,
|
|
end,
|
|
start,
|
|
renderer,
|
|
batchSize,
|
|
currentProgram;
|
|
|
|
id = 'edges_' + this.conradId;
|
|
batchSize = this.settings(options, 'webglEdgesBatchSize');
|
|
a = Object.keys(this.edgeFloatArrays);
|
|
|
|
if (!a.length)
|
|
return;
|
|
i = 0;
|
|
renderer = sigma.webgl.edges[a[i]];
|
|
arr = this.edgeFloatArrays[a[i]].array;
|
|
start = 0;
|
|
end = Math.min(
|
|
start + batchSize * renderer.POINTS,
|
|
arr.length / renderer.ATTRIBUTES
|
|
);
|
|
|
|
job = function() {
|
|
// Check program:
|
|
if (!this.edgePrograms[a[i]])
|
|
this.edgePrograms[a[i]] = renderer.initProgram(edgesGl);
|
|
|
|
if (start < end) {
|
|
edgesGl.useProgram(this.edgePrograms[a[i]]);
|
|
renderer.render(
|
|
edgesGl,
|
|
this.edgePrograms[a[i]],
|
|
arr,
|
|
{
|
|
settings: this.settings,
|
|
matrix: matrix,
|
|
width: this.width,
|
|
height: this.height,
|
|
ratio: this.camera.ratio,
|
|
scalingRatio: this.settings(
|
|
options,
|
|
'webglOversamplingRatio'
|
|
),
|
|
start: start,
|
|
count: end - start
|
|
}
|
|
);
|
|
}
|
|
|
|
// Catch job's end:
|
|
if (
|
|
end >= arr.length / renderer.ATTRIBUTES &&
|
|
i === a.length - 1
|
|
) {
|
|
delete this.jobs[id];
|
|
return false;
|
|
}
|
|
|
|
if (end >= arr.length / renderer.ATTRIBUTES) {
|
|
i++;
|
|
arr = this.edgeFloatArrays[a[i]].array;
|
|
renderer = sigma.webgl.edges[a[i]];
|
|
start = 0;
|
|
end = Math.min(
|
|
start + batchSize * renderer.POINTS,
|
|
arr.length / renderer.ATTRIBUTES
|
|
);
|
|
} else {
|
|
start = end;
|
|
end = Math.min(
|
|
start + batchSize * renderer.POINTS,
|
|
arr.length / renderer.ATTRIBUTES
|
|
);
|
|
}
|
|
|
|
return true;
|
|
};
|
|
|
|
this.jobs[id] = job;
|
|
conrad.addJob(id, job.bind(this));
|
|
}).call(this);
|
|
else {
|
|
for (k in this.edgeFloatArrays) {
|
|
renderer = sigma.webgl.edges[k];
|
|
|
|
// Check program:
|
|
if (!this.edgePrograms[k])
|
|
this.edgePrograms[k] = renderer.initProgram(edgesGl);
|
|
|
|
// Render
|
|
if (this.edgeFloatArrays[k]) {
|
|
edgesGl.useProgram(this.edgePrograms[k]);
|
|
renderer.render(
|
|
edgesGl,
|
|
this.edgePrograms[k],
|
|
this.edgeFloatArrays[k].array,
|
|
{
|
|
settings: this.settings,
|
|
matrix: matrix,
|
|
width: this.width,
|
|
height: this.height,
|
|
ratio: this.camera.ratio,
|
|
scalingRatio: this.settings(options, 'webglOversamplingRatio')
|
|
}
|
|
);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
if (drawNodes) {
|
|
// Enable blending:
|
|
nodesGl.blendFunc(nodesGl.SRC_ALPHA, nodesGl.ONE_MINUS_SRC_ALPHA);
|
|
nodesGl.enable(nodesGl.BLEND);
|
|
|
|
for (k in this.nodeFloatArrays) {
|
|
renderer = sigma.webgl.nodes[k];
|
|
|
|
// Check program:
|
|
if (!this.nodePrograms[k])
|
|
this.nodePrograms[k] = renderer.initProgram(nodesGl);
|
|
|
|
// Render
|
|
if (this.nodeFloatArrays[k]) {
|
|
nodesGl.useProgram(this.nodePrograms[k]);
|
|
renderer.render(
|
|
nodesGl,
|
|
this.nodePrograms[k],
|
|
this.nodeFloatArrays[k].array,
|
|
{
|
|
settings: this.settings,
|
|
matrix: matrix,
|
|
width: this.width,
|
|
height: this.height,
|
|
ratio: this.camera.ratio,
|
|
scalingRatio: this.settings(options, 'webglOversamplingRatio')
|
|
}
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
if (drawLabels) {
|
|
a = this.camera.quadtree.area(
|
|
this.camera.getRectangle(this.width, this.height)
|
|
);
|
|
|
|
// Apply camera view to these nodes:
|
|
this.camera.applyView(
|
|
undefined,
|
|
undefined,
|
|
{
|
|
nodes: a,
|
|
edges: [],
|
|
width: this.width,
|
|
height: this.height
|
|
}
|
|
);
|
|
|
|
o = function(key) {
|
|
return self.settings({
|
|
prefix: self.camera.prefix
|
|
}, key);
|
|
};
|
|
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
if (!a[i].hidden)
|
|
(
|
|
sigma.canvas.labels[
|
|
a[i].type ||
|
|
this.settings(options, 'defaultNodeType')
|
|
] || sigma.canvas.labels.def
|
|
)(a[i], this.contexts.labels, o);
|
|
}
|
|
|
|
this.dispatchEvent('render');
|
|
|
|
return this;
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* This method creates a DOM element of the specified type, switches its
|
|
* position to "absolute", references it to the domElements attribute, and
|
|
* finally appends it to the container.
|
|
*
|
|
* @param {string} tag The label tag.
|
|
* @param {string} id The id of the element (to store it in
|
|
* "domElements").
|
|
* @param {?boolean} webgl Will init the WebGL context if true.
|
|
*/
|
|
sigma.renderers.webgl.prototype.initDOM = function(tag, id, webgl) {
|
|
var gl,
|
|
dom = document.createElement(tag),
|
|
self = this;
|
|
|
|
dom.style.position = 'absolute';
|
|
dom.setAttribute('class', 'sigma-' + id);
|
|
|
|
this.domElements[id] = dom;
|
|
this.container.appendChild(dom);
|
|
|
|
if (tag.toLowerCase() === 'canvas') {
|
|
this.contexts[id] = dom.getContext(webgl ? 'experimental-webgl' : '2d', {
|
|
preserveDrawingBuffer: true
|
|
});
|
|
|
|
// Adding webgl context loss listeners
|
|
if (webgl) {
|
|
dom.addEventListener('webglcontextlost', function(e) {
|
|
e.preventDefault();
|
|
}, false);
|
|
|
|
dom.addEventListener('webglcontextrestored', function(e) {
|
|
self.render();
|
|
}, false);
|
|
}
|
|
}
|
|
};
|
|
|
|
/**
|
|
* This method resizes each DOM elements in the container and stores the new
|
|
* dimensions. Then, it renders the graph.
|
|
*
|
|
* @param {?number} width The new width of the container.
|
|
* @param {?number} height The new height of the container.
|
|
* @return {sigma.renderers.webgl} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.webgl.prototype.resize = function(w, h) {
|
|
var k,
|
|
oldWidth = this.width,
|
|
oldHeight = this.height;
|
|
|
|
if (w !== undefined && h !== undefined) {
|
|
this.width = w;
|
|
this.height = h;
|
|
} else {
|
|
this.width = this.container.offsetWidth;
|
|
this.height = this.container.offsetHeight;
|
|
|
|
w = this.width;
|
|
h = this.height;
|
|
}
|
|
|
|
if (oldWidth !== this.width || oldHeight !== this.height) {
|
|
for (k in this.domElements) {
|
|
this.domElements[k].style.width = w + 'px';
|
|
this.domElements[k].style.height = h + 'px';
|
|
|
|
if (this.domElements[k].tagName.toLowerCase() === 'canvas') {
|
|
// If simple 2D canvas:
|
|
if (this.contexts[k] && this.contexts[k].scale) {
|
|
this.domElements[k].setAttribute('width', w + 'px');
|
|
this.domElements[k].setAttribute('height', h + 'px');
|
|
} else {
|
|
this.domElements[k].setAttribute(
|
|
'width',
|
|
(w * this.settings('webglOversamplingRatio')) + 'px'
|
|
);
|
|
this.domElements[k].setAttribute(
|
|
'height',
|
|
(h * this.settings('webglOversamplingRatio')) + 'px'
|
|
);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Scale:
|
|
for (k in this.contexts)
|
|
if (this.contexts[k] && this.contexts[k].viewport)
|
|
this.contexts[k].viewport(
|
|
0,
|
|
0,
|
|
this.width * this.settings('webglOversamplingRatio'),
|
|
this.height * this.settings('webglOversamplingRatio')
|
|
);
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method clears each canvas.
|
|
*
|
|
* @return {sigma.renderers.webgl} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.webgl.prototype.clear = function() {
|
|
var k;
|
|
|
|
for (k in this.domElements)
|
|
if (this.domElements[k].tagName === 'CANVAS')
|
|
this.domElements[k].width = this.domElements[k].width;
|
|
|
|
this.contexts.nodes.clear(this.contexts.nodes.COLOR_BUFFER_BIT);
|
|
this.contexts.edges.clear(this.contexts.edges.COLOR_BUFFER_BIT);
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method kills contexts and other attributes.
|
|
*/
|
|
sigma.renderers.webgl.prototype.kill = function() {
|
|
var k,
|
|
captor;
|
|
|
|
// Kill captors:
|
|
while ((captor = this.captors.pop()))
|
|
captor.kill();
|
|
delete this.captors;
|
|
|
|
// Kill contexts:
|
|
for (k in this.domElements) {
|
|
this.domElements[k].parentNode.removeChild(this.domElements[k]);
|
|
delete this.domElements[k];
|
|
delete this.contexts[k];
|
|
}
|
|
delete this.domElements;
|
|
delete this.contexts;
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
* The object "sigma.webgl.nodes" contains the different WebGL node
|
|
* renderers. The default one draw nodes as discs. Here are the attributes
|
|
* any node renderer must have:
|
|
*
|
|
* {number} POINTS The number of points required to draw a node.
|
|
* {number} ATTRIBUTES The number of attributes needed to draw one point.
|
|
* {function} addNode A function that adds a node to the data stack that
|
|
* will be given to the buffer. Here is the arguments:
|
|
* > {object} node
|
|
* > {number} index The node index in the
|
|
* nodes array.
|
|
* > {Float32Array} data The stack.
|
|
* > {object} options Some options.
|
|
* {function} render The function that will effectively render the nodes
|
|
* into the buffer.
|
|
* > {WebGLRenderingContext} gl
|
|
* > {WebGLProgram} program
|
|
* > {Float32Array} data The stack to give to the
|
|
* buffer.
|
|
* > {object} params An object containing some
|
|
* options, like width,
|
|
* height, the camera ratio.
|
|
* {function} initProgram The function that will initiate the program, with
|
|
* the relevant shaders and parameters. It must return
|
|
* the newly created program.
|
|
*
|
|
* Check sigma.webgl.nodes.def or sigma.webgl.nodes.fast to see how it
|
|
* works more precisely.
|
|
*/
|
|
sigma.utils.pkg('sigma.webgl.nodes');
|
|
|
|
|
|
|
|
|
|
/**
|
|
* The object "sigma.webgl.edges" contains the different WebGL edge
|
|
* renderers. The default one draw edges as direct lines. Here are the
|
|
* attributes any edge renderer must have:
|
|
*
|
|
* {number} POINTS The number of points required to draw an edge.
|
|
* {number} ATTRIBUTES The number of attributes needed to draw one point.
|
|
* {function} addEdge A function that adds an edge to the data stack that
|
|
* will be given to the buffer. Here is the arguments:
|
|
* > {object} edge
|
|
* > {object} source
|
|
* > {object} target
|
|
* > {Float32Array} data The stack.
|
|
* > {object} options Some options.
|
|
* {function} render The function that will effectively render the edges
|
|
* into the buffer.
|
|
* > {WebGLRenderingContext} gl
|
|
* > {WebGLProgram} program
|
|
* > {Float32Array} data The stack to give to the
|
|
* buffer.
|
|
* > {object} params An object containing some
|
|
* options, like width,
|
|
* height, the camera ratio.
|
|
* {function} initProgram The function that will initiate the program, with
|
|
* the relevant shaders and parameters. It must return
|
|
* the newly created program.
|
|
*
|
|
* Check sigma.webgl.edges.def or sigma.webgl.edges.fast to see how it
|
|
* works more precisely.
|
|
*/
|
|
sigma.utils.pkg('sigma.webgl.edges');
|
|
|
|
|
|
|
|
|
|
/**
|
|
* The object "sigma.canvas.labels" contains the different
|
|
* label renderers for the WebGL renderer. Since displaying texts in WebGL is
|
|
* definitely painful and since there a way less labels to display than nodes
|
|
* or edges, the default renderer simply renders them in a canvas.
|
|
*
|
|
* A labels renderer is a simple function, taking as arguments the related
|
|
* node, the renderer and a settings function.
|
|
*/
|
|
sigma.utils.pkg('sigma.canvas.labels');
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
if (typeof conrad === 'undefined')
|
|
throw 'conrad is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.renderers');
|
|
|
|
/**
|
|
* This function is the constructor of the svg sigma's renderer.
|
|
*
|
|
* @param {sigma.classes.graph} graph The graph to render.
|
|
* @param {sigma.classes.camera} camera The camera.
|
|
* @param {configurable} settings The sigma instance settings
|
|
* function.
|
|
* @param {object} object The options object.
|
|
* @return {sigma.renderers.svg} The renderer instance.
|
|
*/
|
|
sigma.renderers.svg = function(graph, camera, settings, options) {
|
|
if (typeof options !== 'object')
|
|
throw 'sigma.renderers.svg: Wrong arguments.';
|
|
|
|
if (!(options.container instanceof HTMLElement))
|
|
throw 'Container not found.';
|
|
|
|
var i,
|
|
l,
|
|
a,
|
|
fn,
|
|
self = this;
|
|
|
|
sigma.classes.dispatcher.extend(this);
|
|
|
|
// Initialize main attributes:
|
|
this.graph = graph;
|
|
this.camera = camera;
|
|
this.domElements = {
|
|
graph: null,
|
|
groups: {},
|
|
nodes: {},
|
|
edges: {},
|
|
labels: {},
|
|
hovers: {}
|
|
};
|
|
this.measurementCanvas = null;
|
|
this.options = options;
|
|
this.container = this.options.container;
|
|
this.settings = (
|
|
typeof options.settings === 'object' &&
|
|
options.settings
|
|
) ?
|
|
settings.embedObjects(options.settings) :
|
|
settings;
|
|
|
|
// Is the renderer meant to be freestyle?
|
|
this.settings('freeStyle', !!this.options.freeStyle);
|
|
|
|
// SVG xmlns
|
|
this.settings('xmlns', 'http://www.w3.org/2000/svg');
|
|
|
|
// Indexes:
|
|
this.nodesOnScreen = [];
|
|
this.edgesOnScreen = [];
|
|
|
|
// Find the prefix:
|
|
this.options.prefix = 'renderer' + sigma.utils.id() + ':';
|
|
|
|
// Initialize the DOM elements
|
|
this.initDOM('svg');
|
|
|
|
// Initialize captors:
|
|
this.captors = [];
|
|
a = this.options.captors || [sigma.captors.mouse, sigma.captors.touch];
|
|
for (i = 0, l = a.length; i < l; i++) {
|
|
fn = typeof a[i] === 'function' ? a[i] : sigma.captors[a[i]];
|
|
this.captors.push(
|
|
new fn(
|
|
this.domElements.graph,
|
|
this.camera,
|
|
this.settings
|
|
)
|
|
);
|
|
}
|
|
|
|
// Bind resize:
|
|
window.addEventListener('resize', function() {
|
|
self.resize();
|
|
});
|
|
|
|
// Deal with sigma events:
|
|
// TODO: keep an option to override the DOM events?
|
|
sigma.misc.bindDOMEvents.call(this, this.domElements.graph);
|
|
this.bindHovers(this.options.prefix);
|
|
|
|
// Resize
|
|
this.resize(false);
|
|
};
|
|
|
|
/**
|
|
* This method renders the graph on the svg scene.
|
|
*
|
|
* @param {?object} options Eventually an object of options.
|
|
* @return {sigma.renderers.svg} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.svg.prototype.render = function(options) {
|
|
options = options || {};
|
|
|
|
var a,
|
|
i,
|
|
k,
|
|
e,
|
|
l,
|
|
o,
|
|
source,
|
|
target,
|
|
start,
|
|
edges,
|
|
renderers,
|
|
subrenderers,
|
|
index = {},
|
|
graph = this.graph,
|
|
nodes = this.graph.nodes,
|
|
prefix = this.options.prefix || '',
|
|
drawEdges = this.settings(options, 'drawEdges'),
|
|
drawNodes = this.settings(options, 'drawNodes'),
|
|
drawLabels = this.settings(options, 'drawLabels'),
|
|
embedSettings = this.settings.embedObjects(options, {
|
|
prefix: this.options.prefix,
|
|
forceLabels: this.options.forceLabels
|
|
});
|
|
|
|
// Check the 'hideEdgesOnMove' setting:
|
|
if (this.settings(options, 'hideEdgesOnMove'))
|
|
if (this.camera.isAnimated || this.camera.isMoving)
|
|
drawEdges = false;
|
|
|
|
// Apply the camera's view:
|
|
this.camera.applyView(
|
|
undefined,
|
|
this.options.prefix,
|
|
{
|
|
width: this.width,
|
|
height: this.height
|
|
}
|
|
);
|
|
|
|
// Hiding everything
|
|
// TODO: find a more sensible way to perform this operation
|
|
this.hideDOMElements(this.domElements.nodes);
|
|
this.hideDOMElements(this.domElements.edges);
|
|
this.hideDOMElements(this.domElements.labels);
|
|
|
|
// Find which nodes are on screen
|
|
this.edgesOnScreen = [];
|
|
this.nodesOnScreen = this.camera.quadtree.area(
|
|
this.camera.getRectangle(this.width, this.height)
|
|
);
|
|
|
|
// Node index
|
|
for (a = this.nodesOnScreen, i = 0, l = a.length; i < l; i++)
|
|
index[a[i].id] = a[i];
|
|
|
|
// Find which edges are on screen
|
|
for (a = graph.edges(), i = 0, l = a.length; i < l; i++) {
|
|
o = a[i];
|
|
if (
|
|
(index[o.source] || index[o.target]) &&
|
|
(!o.hidden && !nodes(o.source).hidden && !nodes(o.target).hidden)
|
|
)
|
|
this.edgesOnScreen.push(o);
|
|
}
|
|
|
|
// Display nodes
|
|
//---------------
|
|
renderers = sigma.svg.nodes;
|
|
subrenderers = sigma.svg.labels;
|
|
|
|
//-- First we create the nodes which are not already created
|
|
if (drawNodes)
|
|
for (a = this.nodesOnScreen, i = 0, l = a.length; i < l; i++) {
|
|
if (!a[i].hidden && !this.domElements.nodes[a[i].id]) {
|
|
|
|
// Node
|
|
e = (renderers[a[i].type] || renderers.def).create(
|
|
a[i],
|
|
embedSettings
|
|
);
|
|
|
|
this.domElements.nodes[a[i].id] = e;
|
|
this.domElements.groups.nodes.appendChild(e);
|
|
|
|
// Label
|
|
e = (subrenderers[a[i].type] || subrenderers.def).create(
|
|
a[i],
|
|
embedSettings
|
|
);
|
|
|
|
this.domElements.labels[a[i].id] = e;
|
|
this.domElements.groups.labels.appendChild(e);
|
|
}
|
|
}
|
|
|
|
//-- Second we update the nodes
|
|
if (drawNodes)
|
|
for (a = this.nodesOnScreen, i = 0, l = a.length; i < l; i++) {
|
|
|
|
if (a[i].hidden)
|
|
continue;
|
|
|
|
// Node
|
|
(renderers[a[i].type] || renderers.def).update(
|
|
a[i],
|
|
this.domElements.nodes[a[i].id],
|
|
embedSettings
|
|
);
|
|
|
|
// Label
|
|
(subrenderers[a[i].type] || subrenderers.def).update(
|
|
a[i],
|
|
this.domElements.labels[a[i].id],
|
|
embedSettings
|
|
);
|
|
}
|
|
|
|
// Display edges
|
|
//---------------
|
|
renderers = sigma.svg.edges;
|
|
|
|
//-- First we create the edges which are not already created
|
|
if (drawEdges)
|
|
for (a = this.edgesOnScreen, i = 0, l = a.length; i < l; i++) {
|
|
if (!this.domElements.edges[a[i].id]) {
|
|
source = nodes(a[i].source);
|
|
target = nodes(a[i].target);
|
|
|
|
e = (renderers[a[i].type] || renderers.def).create(
|
|
a[i],
|
|
source,
|
|
target,
|
|
embedSettings
|
|
);
|
|
|
|
this.domElements.edges[a[i].id] = e;
|
|
this.domElements.groups.edges.appendChild(e);
|
|
}
|
|
}
|
|
|
|
//-- Second we update the edges
|
|
if (drawEdges)
|
|
for (a = this.edgesOnScreen, i = 0, l = a.length; i < l; i++) {
|
|
source = nodes(a[i].source);
|
|
target = nodes(a[i].target);
|
|
|
|
(renderers[a[i].type] || renderers.def).update(
|
|
a[i],
|
|
this.domElements.edges[a[i].id],
|
|
source,
|
|
target,
|
|
embedSettings
|
|
);
|
|
}
|
|
|
|
this.dispatchEvent('render');
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method creates a DOM element of the specified type, switches its
|
|
* position to "absolute", references it to the domElements attribute, and
|
|
* finally appends it to the container.
|
|
*
|
|
* @param {string} tag The label tag.
|
|
* @param {string} id The id of the element (to store it in "domElements").
|
|
*/
|
|
sigma.renderers.svg.prototype.initDOM = function(tag) {
|
|
var dom = document.createElementNS(this.settings('xmlns'), tag),
|
|
c = this.settings('classPrefix'),
|
|
g,
|
|
l,
|
|
i;
|
|
|
|
dom.style.position = 'absolute';
|
|
dom.setAttribute('class', c + '-svg');
|
|
|
|
// Setting SVG namespace
|
|
dom.setAttribute('xmlns', this.settings('xmlns'));
|
|
dom.setAttribute('xmlns:xlink', 'http://www.w3.org/1999/xlink');
|
|
dom.setAttribute('version', '1.1');
|
|
|
|
// Creating the measurement canvas
|
|
var canvas = document.createElement('canvas');
|
|
canvas.setAttribute('class', c + '-measurement-canvas');
|
|
|
|
// Appending elements
|
|
this.domElements.graph = this.container.appendChild(dom);
|
|
|
|
// Creating groups
|
|
var groups = ['edges', 'nodes', 'labels', 'hovers'];
|
|
for (i = 0, l = groups.length; i < l; i++) {
|
|
g = document.createElementNS(this.settings('xmlns'), 'g');
|
|
|
|
g.setAttributeNS(null, 'id', c + '-group-' + groups[i]);
|
|
g.setAttributeNS(null, 'class', c + '-group');
|
|
|
|
this.domElements.groups[groups[i]] =
|
|
this.domElements.graph.appendChild(g);
|
|
}
|
|
|
|
// Appending measurement canvas
|
|
this.container.appendChild(canvas);
|
|
this.measurementCanvas = canvas.getContext('2d');
|
|
};
|
|
|
|
/**
|
|
* This method hides a batch of SVG DOM elements.
|
|
*
|
|
* @param {array} elements An array of elements to hide.
|
|
* @param {object} renderer The renderer to use.
|
|
* @return {sigma.renderers.svg} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.svg.prototype.hideDOMElements = function(elements) {
|
|
var o,
|
|
i;
|
|
|
|
for (i in elements) {
|
|
o = elements[i];
|
|
sigma.svg.utils.hide(o);
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* This method binds the hover events to the renderer.
|
|
*
|
|
* @param {string} prefix The renderer prefix.
|
|
*/
|
|
// TODO: add option about whether to display hovers or not
|
|
sigma.renderers.svg.prototype.bindHovers = function(prefix) {
|
|
var renderers = sigma.svg.hovers,
|
|
self = this,
|
|
hoveredNode;
|
|
|
|
function overNode(e) {
|
|
var node = e.data.node,
|
|
embedSettings = self.settings.embedObjects({
|
|
prefix: prefix
|
|
});
|
|
|
|
if (!embedSettings('enableHovering'))
|
|
return;
|
|
|
|
var hover = (renderers[node.type] || renderers.def).create(
|
|
node,
|
|
self.domElements.nodes[node.id],
|
|
self.measurementCanvas,
|
|
embedSettings
|
|
);
|
|
|
|
self.domElements.hovers[node.id] = hover;
|
|
|
|
// Inserting the hover in the dom
|
|
self.domElements.groups.hovers.appendChild(hover);
|
|
hoveredNode = node;
|
|
}
|
|
|
|
function outNode(e) {
|
|
var node = e.data.node,
|
|
embedSettings = self.settings.embedObjects({
|
|
prefix: prefix
|
|
});
|
|
|
|
if (!embedSettings('enableHovering'))
|
|
return;
|
|
|
|
// Deleting element
|
|
self.domElements.groups.hovers.removeChild(
|
|
self.domElements.hovers[node.id]
|
|
);
|
|
hoveredNode = null;
|
|
delete self.domElements.hovers[node.id];
|
|
|
|
// Reinstate
|
|
self.domElements.groups.nodes.appendChild(
|
|
self.domElements.nodes[node.id]
|
|
);
|
|
}
|
|
|
|
// OPTIMIZE: perform a real update rather than a deletion
|
|
function update() {
|
|
if (!hoveredNode)
|
|
return;
|
|
|
|
var embedSettings = self.settings.embedObjects({
|
|
prefix: prefix
|
|
});
|
|
|
|
// Deleting element before update
|
|
self.domElements.groups.hovers.removeChild(
|
|
self.domElements.hovers[hoveredNode.id]
|
|
);
|
|
delete self.domElements.hovers[hoveredNode.id];
|
|
|
|
var hover = (renderers[hoveredNode.type] || renderers.def).create(
|
|
hoveredNode,
|
|
self.domElements.nodes[hoveredNode.id],
|
|
self.measurementCanvas,
|
|
embedSettings
|
|
);
|
|
|
|
self.domElements.hovers[hoveredNode.id] = hover;
|
|
|
|
// Inserting the hover in the dom
|
|
self.domElements.groups.hovers.appendChild(hover);
|
|
}
|
|
|
|
// Binding events
|
|
this.bind('overNode', overNode);
|
|
this.bind('outNode', outNode);
|
|
|
|
// Update on render
|
|
this.bind('render', update);
|
|
};
|
|
|
|
/**
|
|
* This method resizes each DOM elements in the container and stores the new
|
|
* dimensions. Then, it renders the graph.
|
|
*
|
|
* @param {?number} width The new width of the container.
|
|
* @param {?number} height The new height of the container.
|
|
* @return {sigma.renderers.svg} Returns the instance itself.
|
|
*/
|
|
sigma.renderers.svg.prototype.resize = function(w, h) {
|
|
var oldWidth = this.width,
|
|
oldHeight = this.height,
|
|
pixelRatio = 1;
|
|
|
|
if (w !== undefined && h !== undefined) {
|
|
this.width = w;
|
|
this.height = h;
|
|
} else {
|
|
this.width = this.container.offsetWidth;
|
|
this.height = this.container.offsetHeight;
|
|
|
|
w = this.width;
|
|
h = this.height;
|
|
}
|
|
|
|
if (oldWidth !== this.width || oldHeight !== this.height) {
|
|
this.domElements.graph.style.width = w + 'px';
|
|
this.domElements.graph.style.height = h + 'px';
|
|
|
|
if (this.domElements.graph.tagName.toLowerCase() === 'svg') {
|
|
this.domElements.graph.setAttribute('width', (w * pixelRatio));
|
|
this.domElements.graph.setAttribute('height', (h * pixelRatio));
|
|
}
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
|
|
/**
|
|
* The labels, nodes and edges renderers are stored in the three following
|
|
* objects. When an element is drawn, its type will be checked and if a
|
|
* renderer with the same name exists, it will be used. If not found, the
|
|
* default renderer will be used instead.
|
|
*
|
|
* They are stored in different files, in the "./svg" folder.
|
|
*/
|
|
sigma.utils.pkg('sigma.svg.nodes');
|
|
sigma.utils.pkg('sigma.svg.edges');
|
|
sigma.utils.pkg('sigma.svg.labels');
|
|
}).call(this);
|
|
|
|
;(function(global) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.renderers');
|
|
|
|
// Check if WebGL is enabled:
|
|
var canvas,
|
|
webgl = !!global.WebGLRenderingContext;
|
|
if (webgl) {
|
|
canvas = document.createElement('canvas');
|
|
try {
|
|
webgl = !!(
|
|
canvas.getContext('webgl') ||
|
|
canvas.getContext('experimental-webgl')
|
|
);
|
|
} catch (e) {
|
|
webgl = false;
|
|
}
|
|
}
|
|
|
|
// Copy the good renderer:
|
|
sigma.renderers.def = webgl ?
|
|
sigma.renderers.webgl :
|
|
sigma.renderers.canvas;
|
|
})(this);
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.webgl.nodes');
|
|
|
|
/**
|
|
* This node renderer will display nodes as discs, shaped in triangles with
|
|
* the gl.TRIANGLES display mode. So, to be more precise, to draw one node,
|
|
* it will store three times the center of node, with the color and the size,
|
|
* and an angle indicating which "corner" of the triangle to draw.
|
|
*
|
|
* The fragment shader does not deal with anti-aliasing, so make sure that
|
|
* you deal with it somewhere else in the code (by default, the WebGL
|
|
* renderer will oversample the rendering through the webglOversamplingRatio
|
|
* value).
|
|
*/
|
|
sigma.webgl.nodes.def = {
|
|
POINTS: 3,
|
|
ATTRIBUTES: 5,
|
|
addNode: function(node, data, i, prefix, settings) {
|
|
var color = sigma.utils.floatColor(
|
|
node.color || settings('defaultNodeColor')
|
|
);
|
|
|
|
data[i++] = node[prefix + 'x'];
|
|
data[i++] = node[prefix + 'y'];
|
|
data[i++] = node[prefix + 'size'];
|
|
data[i++] = color;
|
|
data[i++] = 0;
|
|
|
|
data[i++] = node[prefix + 'x'];
|
|
data[i++] = node[prefix + 'y'];
|
|
data[i++] = node[prefix + 'size'];
|
|
data[i++] = color;
|
|
data[i++] = 2 * Math.PI / 3;
|
|
|
|
data[i++] = node[prefix + 'x'];
|
|
data[i++] = node[prefix + 'y'];
|
|
data[i++] = node[prefix + 'size'];
|
|
data[i++] = color;
|
|
data[i++] = 4 * Math.PI / 3;
|
|
},
|
|
render: function(gl, program, data, params) {
|
|
var buffer;
|
|
|
|
// Define attributes:
|
|
var positionLocation =
|
|
gl.getAttribLocation(program, 'a_position'),
|
|
sizeLocation =
|
|
gl.getAttribLocation(program, 'a_size'),
|
|
colorLocation =
|
|
gl.getAttribLocation(program, 'a_color'),
|
|
angleLocation =
|
|
gl.getAttribLocation(program, 'a_angle'),
|
|
resolutionLocation =
|
|
gl.getUniformLocation(program, 'u_resolution'),
|
|
matrixLocation =
|
|
gl.getUniformLocation(program, 'u_matrix'),
|
|
ratioLocation =
|
|
gl.getUniformLocation(program, 'u_ratio'),
|
|
scaleLocation =
|
|
gl.getUniformLocation(program, 'u_scale');
|
|
|
|
buffer = gl.createBuffer();
|
|
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
|
|
gl.bufferData(gl.ARRAY_BUFFER, data, gl.DYNAMIC_DRAW);
|
|
|
|
gl.uniform2f(resolutionLocation, params.width, params.height);
|
|
gl.uniform1f(
|
|
ratioLocation,
|
|
1 / Math.pow(params.ratio, params.settings('nodesPowRatio'))
|
|
);
|
|
gl.uniform1f(scaleLocation, params.scalingRatio);
|
|
gl.uniformMatrix3fv(matrixLocation, false, params.matrix);
|
|
|
|
gl.enableVertexAttribArray(positionLocation);
|
|
gl.enableVertexAttribArray(sizeLocation);
|
|
gl.enableVertexAttribArray(colorLocation);
|
|
gl.enableVertexAttribArray(angleLocation);
|
|
|
|
gl.vertexAttribPointer(
|
|
positionLocation,
|
|
2,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
0
|
|
);
|
|
gl.vertexAttribPointer(
|
|
sizeLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
8
|
|
);
|
|
gl.vertexAttribPointer(
|
|
colorLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
12
|
|
);
|
|
gl.vertexAttribPointer(
|
|
angleLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
16
|
|
);
|
|
|
|
gl.drawArrays(
|
|
gl.TRIANGLES,
|
|
params.start || 0,
|
|
params.count || (data.length / this.ATTRIBUTES)
|
|
);
|
|
},
|
|
initProgram: function(gl) {
|
|
var vertexShader,
|
|
fragmentShader,
|
|
program;
|
|
|
|
vertexShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'attribute vec2 a_position;',
|
|
'attribute float a_size;',
|
|
'attribute float a_color;',
|
|
'attribute float a_angle;',
|
|
|
|
'uniform vec2 u_resolution;',
|
|
'uniform float u_ratio;',
|
|
'uniform float u_scale;',
|
|
'uniform mat3 u_matrix;',
|
|
|
|
'varying vec4 color;',
|
|
'varying vec2 center;',
|
|
'varying float radius;',
|
|
|
|
'void main() {',
|
|
// Multiply the point size twice:
|
|
'radius = a_size * u_ratio;',
|
|
|
|
// Scale from [[-1 1] [-1 1]] to the container:
|
|
'vec2 position = (u_matrix * vec3(a_position, 1)).xy;',
|
|
// 'center = (position / u_resolution * 2.0 - 1.0) * vec2(1, -1);',
|
|
'center = position * u_scale;',
|
|
'center = vec2(center.x, u_scale * u_resolution.y - center.y);',
|
|
|
|
'position = position +',
|
|
'2.0 * radius * vec2(cos(a_angle), sin(a_angle));',
|
|
'position = (position / u_resolution * 2.0 - 1.0) * vec2(1, -1);',
|
|
|
|
'radius = radius * u_scale;',
|
|
|
|
'gl_Position = vec4(position, 0, 1);',
|
|
|
|
// Extract the color:
|
|
'float c = a_color;',
|
|
'color.b = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.g = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.r = mod(c, 256.0); c = floor(c / 256.0); color /= 255.0;',
|
|
'color.a = 1.0;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.VERTEX_SHADER
|
|
);
|
|
|
|
fragmentShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'precision mediump float;',
|
|
|
|
'varying vec4 color;',
|
|
'varying vec2 center;',
|
|
'varying float radius;',
|
|
|
|
'void main(void) {',
|
|
'vec4 color0 = vec4(0.0, 0.0, 0.0, 0.0);',
|
|
|
|
'vec2 m = gl_FragCoord.xy - center;',
|
|
'float diff = radius - sqrt(m.x * m.x + m.y * m.y);',
|
|
|
|
// Here is how we draw a disc instead of a square:
|
|
'if (diff > 0.0)',
|
|
'gl_FragColor = color;',
|
|
'else',
|
|
'gl_FragColor = color0;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.FRAGMENT_SHADER
|
|
);
|
|
|
|
program = sigma.utils.loadProgram(gl, [vertexShader, fragmentShader]);
|
|
|
|
return program;
|
|
}
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.webgl.nodes');
|
|
|
|
/**
|
|
* This node renderer will display nodes in the fastest way: Nodes are basic
|
|
* squares, drawn through the gl.POINTS drawing method. The size of the nodes
|
|
* are represented with the "gl_PointSize" value in the vertex shader.
|
|
*
|
|
* It is the fastest node renderer here since the buffer just takes one line
|
|
* to draw each node (with attributes "x", "y", "size" and "color").
|
|
*
|
|
* Nevertheless, this method has some problems, especially due to some issues
|
|
* with the gl.POINTS:
|
|
* - First, if the center of a node is outside the scene, the point will not
|
|
* be drawn, even if it should be partly on screen.
|
|
* - I tried applying a fragment shader similar to the one in the default
|
|
* node renderer to display them as discs, but it did not work fine on
|
|
* some computers settings, filling the discs with weird gradients not
|
|
* depending on the actual color.
|
|
*/
|
|
sigma.webgl.nodes.fast = {
|
|
POINTS: 1,
|
|
ATTRIBUTES: 4,
|
|
addNode: function(node, data, i, prefix, settings) {
|
|
data[i++] = node[prefix + 'x'];
|
|
data[i++] = node[prefix + 'y'];
|
|
data[i++] = node[prefix + 'size'];
|
|
data[i++] = sigma.utils.floatColor(
|
|
node.color || settings('defaultNodeColor')
|
|
);
|
|
},
|
|
render: function(gl, program, data, params) {
|
|
var buffer;
|
|
|
|
// Define attributes:
|
|
var positionLocation =
|
|
gl.getAttribLocation(program, 'a_position'),
|
|
sizeLocation =
|
|
gl.getAttribLocation(program, 'a_size'),
|
|
colorLocation =
|
|
gl.getAttribLocation(program, 'a_color'),
|
|
resolutionLocation =
|
|
gl.getUniformLocation(program, 'u_resolution'),
|
|
matrixLocation =
|
|
gl.getUniformLocation(program, 'u_matrix'),
|
|
ratioLocation =
|
|
gl.getUniformLocation(program, 'u_ratio'),
|
|
scaleLocation =
|
|
gl.getUniformLocation(program, 'u_scale');
|
|
|
|
buffer = gl.createBuffer();
|
|
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
|
|
gl.bufferData(gl.ARRAY_BUFFER, data, gl.DYNAMIC_DRAW);
|
|
|
|
gl.uniform2f(resolutionLocation, params.width, params.height);
|
|
gl.uniform1f(
|
|
ratioLocation,
|
|
1 / Math.pow(params.ratio, params.settings('nodesPowRatio'))
|
|
);
|
|
gl.uniform1f(scaleLocation, params.scalingRatio);
|
|
gl.uniformMatrix3fv(matrixLocation, false, params.matrix);
|
|
|
|
gl.enableVertexAttribArray(positionLocation);
|
|
gl.enableVertexAttribArray(sizeLocation);
|
|
gl.enableVertexAttribArray(colorLocation);
|
|
|
|
gl.vertexAttribPointer(
|
|
positionLocation,
|
|
2,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
0
|
|
);
|
|
gl.vertexAttribPointer(
|
|
sizeLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
8
|
|
);
|
|
gl.vertexAttribPointer(
|
|
colorLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
12
|
|
);
|
|
|
|
gl.drawArrays(
|
|
gl.POINTS,
|
|
params.start || 0,
|
|
params.count || (data.length / this.ATTRIBUTES)
|
|
);
|
|
},
|
|
initProgram: function(gl) {
|
|
var vertexShader,
|
|
fragmentShader,
|
|
program;
|
|
|
|
vertexShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'attribute vec2 a_position;',
|
|
'attribute float a_size;',
|
|
'attribute float a_color;',
|
|
|
|
'uniform vec2 u_resolution;',
|
|
'uniform float u_ratio;',
|
|
'uniform float u_scale;',
|
|
'uniform mat3 u_matrix;',
|
|
|
|
'varying vec4 color;',
|
|
|
|
'void main() {',
|
|
// Scale from [[-1 1] [-1 1]] to the container:
|
|
'gl_Position = vec4(',
|
|
'((u_matrix * vec3(a_position, 1)).xy /',
|
|
'u_resolution * 2.0 - 1.0) * vec2(1, -1),',
|
|
'0,',
|
|
'1',
|
|
');',
|
|
|
|
// Multiply the point size twice:
|
|
// - x SCALING_RATIO to correct the canvas scaling
|
|
// - x 2 to correct the formulae
|
|
'gl_PointSize = a_size * u_ratio * u_scale * 2.0;',
|
|
|
|
// Extract the color:
|
|
'float c = a_color;',
|
|
'color.b = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.g = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.r = mod(c, 256.0); c = floor(c / 256.0); color /= 255.0;',
|
|
'color.a = 1.0;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.VERTEX_SHADER
|
|
);
|
|
|
|
fragmentShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'precision mediump float;',
|
|
|
|
'varying vec4 color;',
|
|
|
|
'void main(void) {',
|
|
'gl_FragColor = color;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.FRAGMENT_SHADER
|
|
);
|
|
|
|
program = sigma.utils.loadProgram(gl, [vertexShader, fragmentShader]);
|
|
|
|
return program;
|
|
}
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.webgl.edges');
|
|
|
|
/**
|
|
* This edge renderer will display edges as lines going from the source node
|
|
* to the target node. To deal with edge thicknesses, the lines are made of
|
|
* two triangles forming rectangles, with the gl.TRIANGLES drawing mode.
|
|
*
|
|
* It is expensive, since drawing a single edge requires 6 points, each
|
|
* having 7 attributes (source position, target position, thickness, color
|
|
* and a flag indicating which vertice of the rectangle it is).
|
|
*/
|
|
sigma.webgl.edges.def = {
|
|
POINTS: 6,
|
|
ATTRIBUTES: 7,
|
|
addEdge: function(edge, source, target, data, i, prefix, settings) {
|
|
var w = (edge[prefix + 'size'] || 1) / 2,
|
|
x1 = source[prefix + 'x'],
|
|
y1 = source[prefix + 'y'],
|
|
x2 = target[prefix + 'x'],
|
|
y2 = target[prefix + 'y'],
|
|
color = edge.color;
|
|
|
|
if (!color)
|
|
switch (settings('edgeColor')) {
|
|
case 'source':
|
|
color = source.color || settings('defaultNodeColor');
|
|
break;
|
|
case 'target':
|
|
color = target.color || settings('defaultNodeColor');
|
|
break;
|
|
default:
|
|
color = settings('defaultEdgeColor');
|
|
break;
|
|
}
|
|
|
|
// Normalize color:
|
|
color = sigma.utils.floatColor(color);
|
|
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = w;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = w;
|
|
data[i++] = 1.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = w;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = w;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = w;
|
|
data[i++] = 1.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = w;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
},
|
|
render: function(gl, program, data, params) {
|
|
var buffer;
|
|
|
|
// Define attributes:
|
|
var colorLocation =
|
|
gl.getAttribLocation(program, 'a_color'),
|
|
positionLocation1 =
|
|
gl.getAttribLocation(program, 'a_position1'),
|
|
positionLocation2 =
|
|
gl.getAttribLocation(program, 'a_position2'),
|
|
thicknessLocation =
|
|
gl.getAttribLocation(program, 'a_thickness'),
|
|
minusLocation =
|
|
gl.getAttribLocation(program, 'a_minus'),
|
|
resolutionLocation =
|
|
gl.getUniformLocation(program, 'u_resolution'),
|
|
matrixLocation =
|
|
gl.getUniformLocation(program, 'u_matrix'),
|
|
matrixHalfPiLocation =
|
|
gl.getUniformLocation(program, 'u_matrixHalfPi'),
|
|
matrixHalfPiMinusLocation =
|
|
gl.getUniformLocation(program, 'u_matrixHalfPiMinus'),
|
|
ratioLocation =
|
|
gl.getUniformLocation(program, 'u_ratio'),
|
|
scaleLocation =
|
|
gl.getUniformLocation(program, 'u_scale');
|
|
|
|
buffer = gl.createBuffer();
|
|
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
|
|
gl.bufferData(gl.ARRAY_BUFFER, data, gl.STATIC_DRAW);
|
|
|
|
gl.uniform2f(resolutionLocation, params.width, params.height);
|
|
gl.uniform1f(
|
|
ratioLocation,
|
|
params.ratio / Math.pow(params.ratio, params.settings('edgesPowRatio'))
|
|
);
|
|
gl.uniform1f(scaleLocation, params.scalingRatio);
|
|
gl.uniformMatrix3fv(matrixLocation, false, params.matrix);
|
|
gl.uniformMatrix2fv(
|
|
matrixHalfPiLocation,
|
|
false,
|
|
sigma.utils.matrices.rotation(Math.PI / 2, true)
|
|
);
|
|
gl.uniformMatrix2fv(
|
|
matrixHalfPiMinusLocation,
|
|
false,
|
|
sigma.utils.matrices.rotation(-Math.PI / 2, true)
|
|
);
|
|
|
|
gl.enableVertexAttribArray(colorLocation);
|
|
gl.enableVertexAttribArray(positionLocation1);
|
|
gl.enableVertexAttribArray(positionLocation2);
|
|
gl.enableVertexAttribArray(thicknessLocation);
|
|
gl.enableVertexAttribArray(minusLocation);
|
|
|
|
gl.vertexAttribPointer(positionLocation1,
|
|
2,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
0
|
|
);
|
|
gl.vertexAttribPointer(positionLocation2,
|
|
2,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
8
|
|
);
|
|
gl.vertexAttribPointer(thicknessLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
16
|
|
);
|
|
gl.vertexAttribPointer(minusLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
20
|
|
);
|
|
gl.vertexAttribPointer(colorLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
24
|
|
);
|
|
|
|
gl.drawArrays(
|
|
gl.TRIANGLES,
|
|
params.start || 0,
|
|
params.count || (data.length / this.ATTRIBUTES)
|
|
);
|
|
},
|
|
initProgram: function(gl) {
|
|
var vertexShader,
|
|
fragmentShader,
|
|
program;
|
|
|
|
vertexShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'attribute vec2 a_position1;',
|
|
'attribute vec2 a_position2;',
|
|
'attribute float a_thickness;',
|
|
'attribute float a_minus;',
|
|
'attribute float a_color;',
|
|
|
|
'uniform vec2 u_resolution;',
|
|
'uniform float u_ratio;',
|
|
'uniform float u_scale;',
|
|
'uniform mat3 u_matrix;',
|
|
'uniform mat2 u_matrixHalfPi;',
|
|
'uniform mat2 u_matrixHalfPiMinus;',
|
|
|
|
'varying vec4 color;',
|
|
|
|
'void main() {',
|
|
// Find the good point:
|
|
'vec2 position = a_thickness * u_ratio *',
|
|
'normalize(a_position2 - a_position1);',
|
|
|
|
'mat2 matrix = a_minus * u_matrixHalfPiMinus +',
|
|
'(1.0 - a_minus) * u_matrixHalfPi;',
|
|
|
|
'position = matrix * position + a_position1;',
|
|
|
|
// Scale from [[-1 1] [-1 1]] to the container:
|
|
'gl_Position = vec4(',
|
|
'((u_matrix * vec3(position, 1)).xy /',
|
|
'u_resolution * 2.0 - 1.0) * vec2(1, -1),',
|
|
'0,',
|
|
'1',
|
|
');',
|
|
|
|
// Extract the color:
|
|
'float c = a_color;',
|
|
'color.b = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.g = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.r = mod(c, 256.0); c = floor(c / 256.0); color /= 255.0;',
|
|
'color.a = 1.0;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.VERTEX_SHADER
|
|
);
|
|
|
|
fragmentShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'precision mediump float;',
|
|
|
|
'varying vec4 color;',
|
|
|
|
'void main(void) {',
|
|
'gl_FragColor = color;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.FRAGMENT_SHADER
|
|
);
|
|
|
|
program = sigma.utils.loadProgram(gl, [vertexShader, fragmentShader]);
|
|
|
|
return program;
|
|
}
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.webgl.edges');
|
|
|
|
/**
|
|
* This edge renderer will display edges as lines with the gl.LINES display
|
|
* mode. Since this mode does not support well thickness, edges are all drawn
|
|
* with the same thickness (3px), independantly of the edge attributes or the
|
|
* zooming ratio.
|
|
*/
|
|
sigma.webgl.edges.fast = {
|
|
POINTS: 2,
|
|
ATTRIBUTES: 3,
|
|
addEdge: function(edge, source, target, data, i, prefix, settings) {
|
|
var w = (edge[prefix + 'size'] || 1) / 2,
|
|
x1 = source[prefix + 'x'],
|
|
y1 = source[prefix + 'y'],
|
|
x2 = target[prefix + 'x'],
|
|
y2 = target[prefix + 'y'],
|
|
color = edge.color;
|
|
|
|
if (!color)
|
|
switch (settings('edgeColor')) {
|
|
case 'source':
|
|
color = source.color || settings('defaultNodeColor');
|
|
break;
|
|
case 'target':
|
|
color = target.color || settings('defaultNodeColor');
|
|
break;
|
|
default:
|
|
color = settings('defaultEdgeColor');
|
|
break;
|
|
}
|
|
|
|
// Normalize color:
|
|
color = sigma.utils.floatColor(color);
|
|
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = color;
|
|
},
|
|
render: function(gl, program, data, params) {
|
|
var buffer;
|
|
|
|
// Define attributes:
|
|
var colorLocation =
|
|
gl.getAttribLocation(program, 'a_color'),
|
|
positionLocation =
|
|
gl.getAttribLocation(program, 'a_position'),
|
|
resolutionLocation =
|
|
gl.getUniformLocation(program, 'u_resolution'),
|
|
matrixLocation =
|
|
gl.getUniformLocation(program, 'u_matrix');
|
|
|
|
buffer = gl.createBuffer();
|
|
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
|
|
gl.bufferData(gl.ARRAY_BUFFER, data, gl.DYNAMIC_DRAW);
|
|
|
|
gl.uniform2f(resolutionLocation, params.width, params.height);
|
|
gl.uniformMatrix3fv(matrixLocation, false, params.matrix);
|
|
|
|
gl.enableVertexAttribArray(positionLocation);
|
|
gl.enableVertexAttribArray(colorLocation);
|
|
|
|
gl.vertexAttribPointer(positionLocation,
|
|
2,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
0
|
|
);
|
|
gl.vertexAttribPointer(colorLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
8
|
|
);
|
|
|
|
gl.lineWidth(3);
|
|
gl.drawArrays(
|
|
gl.LINES,
|
|
params.start || 0,
|
|
params.count || (data.length / this.ATTRIBUTES)
|
|
);
|
|
},
|
|
initProgram: function(gl) {
|
|
var vertexShader,
|
|
fragmentShader,
|
|
program;
|
|
|
|
vertexShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'attribute vec2 a_position;',
|
|
'attribute float a_color;',
|
|
|
|
'uniform vec2 u_resolution;',
|
|
'uniform mat3 u_matrix;',
|
|
|
|
'varying vec4 color;',
|
|
|
|
'void main() {',
|
|
// Scale from [[-1 1] [-1 1]] to the container:
|
|
'gl_Position = vec4(',
|
|
'((u_matrix * vec3(a_position, 1)).xy /',
|
|
'u_resolution * 2.0 - 1.0) * vec2(1, -1),',
|
|
'0,',
|
|
'1',
|
|
');',
|
|
|
|
// Extract the color:
|
|
'float c = a_color;',
|
|
'color.b = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.g = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.r = mod(c, 256.0); c = floor(c / 256.0); color /= 255.0;',
|
|
'color.a = 1.0;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.VERTEX_SHADER
|
|
);
|
|
|
|
fragmentShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'precision mediump float;',
|
|
|
|
'varying vec4 color;',
|
|
|
|
'void main(void) {',
|
|
'gl_FragColor = color;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.FRAGMENT_SHADER
|
|
);
|
|
|
|
program = sigma.utils.loadProgram(gl, [vertexShader, fragmentShader]);
|
|
|
|
return program;
|
|
}
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.webgl.edges');
|
|
|
|
/**
|
|
* This edge renderer will display edges as arrows going from the source node
|
|
* to the target node. To deal with edge thicknesses, the lines are made of
|
|
* three triangles: two forming rectangles, with the gl.TRIANGLES drawing
|
|
* mode.
|
|
*
|
|
* It is expensive, since drawing a single edge requires 9 points, each
|
|
* having a lot of attributes.
|
|
*/
|
|
sigma.webgl.edges.arrow = {
|
|
POINTS: 9,
|
|
ATTRIBUTES: 11,
|
|
addEdge: function(edge, source, target, data, i, prefix, settings) {
|
|
var w = (edge[prefix + 'size'] || 1) / 2,
|
|
x1 = source[prefix + 'x'],
|
|
y1 = source[prefix + 'y'],
|
|
x2 = target[prefix + 'x'],
|
|
y2 = target[prefix + 'y'],
|
|
targetSize = target[prefix + 'size'],
|
|
color = edge.color;
|
|
|
|
if (!color)
|
|
switch (settings('edgeColor')) {
|
|
case 'source':
|
|
color = source.color || settings('defaultNodeColor');
|
|
break;
|
|
case 'target':
|
|
color = target.color || settings('defaultNodeColor');
|
|
break;
|
|
default:
|
|
color = settings('defaultEdgeColor');
|
|
break;
|
|
}
|
|
|
|
// Normalize color:
|
|
color = sigma.utils.floatColor(color);
|
|
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = w;
|
|
data[i++] = targetSize;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = w;
|
|
data[i++] = targetSize;
|
|
data[i++] = 1.0;
|
|
data[i++] = 1.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = w;
|
|
data[i++] = targetSize;
|
|
data[i++] = 1.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = w;
|
|
data[i++] = targetSize;
|
|
data[i++] = 1.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = w;
|
|
data[i++] = targetSize;
|
|
data[i++] = 0.0;
|
|
data[i++] = 1.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = w;
|
|
data[i++] = targetSize;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
// Arrow head:
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = w;
|
|
data[i++] = targetSize;
|
|
data[i++] = 1.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 1.0;
|
|
data[i++] = -1.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = w;
|
|
data[i++] = targetSize;
|
|
data[i++] = 1.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 1.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = color;
|
|
|
|
data[i++] = x2;
|
|
data[i++] = y2;
|
|
data[i++] = x1;
|
|
data[i++] = y1;
|
|
data[i++] = w;
|
|
data[i++] = targetSize;
|
|
data[i++] = 1.0;
|
|
data[i++] = 0.0;
|
|
data[i++] = 1.0;
|
|
data[i++] = 1.0;
|
|
data[i++] = color;
|
|
},
|
|
render: function(gl, program, data, params) {
|
|
var buffer;
|
|
|
|
// Define attributes:
|
|
var positionLocation1 =
|
|
gl.getAttribLocation(program, 'a_pos1'),
|
|
positionLocation2 =
|
|
gl.getAttribLocation(program, 'a_pos2'),
|
|
thicknessLocation =
|
|
gl.getAttribLocation(program, 'a_thickness'),
|
|
targetSizeLocation =
|
|
gl.getAttribLocation(program, 'a_tSize'),
|
|
delayLocation =
|
|
gl.getAttribLocation(program, 'a_delay'),
|
|
minusLocation =
|
|
gl.getAttribLocation(program, 'a_minus'),
|
|
headLocation =
|
|
gl.getAttribLocation(program, 'a_head'),
|
|
headPositionLocation =
|
|
gl.getAttribLocation(program, 'a_headPosition'),
|
|
colorLocation =
|
|
gl.getAttribLocation(program, 'a_color'),
|
|
resolutionLocation =
|
|
gl.getUniformLocation(program, 'u_resolution'),
|
|
matrixLocation =
|
|
gl.getUniformLocation(program, 'u_matrix'),
|
|
matrixHalfPiLocation =
|
|
gl.getUniformLocation(program, 'u_matrixHalfPi'),
|
|
matrixHalfPiMinusLocation =
|
|
gl.getUniformLocation(program, 'u_matrixHalfPiMinus'),
|
|
ratioLocation =
|
|
gl.getUniformLocation(program, 'u_ratio'),
|
|
nodeRatioLocation =
|
|
gl.getUniformLocation(program, 'u_nodeRatio'),
|
|
arrowHeadLocation =
|
|
gl.getUniformLocation(program, 'u_arrowHead'),
|
|
scaleLocation =
|
|
gl.getUniformLocation(program, 'u_scale');
|
|
|
|
buffer = gl.createBuffer();
|
|
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
|
|
gl.bufferData(gl.ARRAY_BUFFER, data, gl.STATIC_DRAW);
|
|
|
|
gl.uniform2f(resolutionLocation, params.width, params.height);
|
|
gl.uniform1f(
|
|
ratioLocation,
|
|
params.ratio / Math.pow(params.ratio, params.settings('edgesPowRatio'))
|
|
);
|
|
gl.uniform1f(
|
|
nodeRatioLocation,
|
|
Math.pow(params.ratio, params.settings('nodesPowRatio')) /
|
|
params.ratio
|
|
);
|
|
gl.uniform1f(arrowHeadLocation, 5.0);
|
|
gl.uniform1f(scaleLocation, params.scalingRatio);
|
|
gl.uniformMatrix3fv(matrixLocation, false, params.matrix);
|
|
gl.uniformMatrix2fv(
|
|
matrixHalfPiLocation,
|
|
false,
|
|
sigma.utils.matrices.rotation(Math.PI / 2, true)
|
|
);
|
|
gl.uniformMatrix2fv(
|
|
matrixHalfPiMinusLocation,
|
|
false,
|
|
sigma.utils.matrices.rotation(-Math.PI / 2, true)
|
|
);
|
|
|
|
gl.enableVertexAttribArray(positionLocation1);
|
|
gl.enableVertexAttribArray(positionLocation2);
|
|
gl.enableVertexAttribArray(thicknessLocation);
|
|
gl.enableVertexAttribArray(targetSizeLocation);
|
|
gl.enableVertexAttribArray(delayLocation);
|
|
gl.enableVertexAttribArray(minusLocation);
|
|
gl.enableVertexAttribArray(headLocation);
|
|
gl.enableVertexAttribArray(headPositionLocation);
|
|
gl.enableVertexAttribArray(colorLocation);
|
|
|
|
gl.vertexAttribPointer(positionLocation1,
|
|
2,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
0
|
|
);
|
|
gl.vertexAttribPointer(positionLocation2,
|
|
2,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
8
|
|
);
|
|
gl.vertexAttribPointer(thicknessLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
16
|
|
);
|
|
gl.vertexAttribPointer(targetSizeLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
20
|
|
);
|
|
gl.vertexAttribPointer(delayLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
24
|
|
);
|
|
gl.vertexAttribPointer(minusLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
28
|
|
);
|
|
gl.vertexAttribPointer(headLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
32
|
|
);
|
|
gl.vertexAttribPointer(headPositionLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
36
|
|
);
|
|
gl.vertexAttribPointer(colorLocation,
|
|
1,
|
|
gl.FLOAT,
|
|
false,
|
|
this.ATTRIBUTES * Float32Array.BYTES_PER_ELEMENT,
|
|
40
|
|
);
|
|
|
|
gl.drawArrays(
|
|
gl.TRIANGLES,
|
|
params.start || 0,
|
|
params.count || (data.length / this.ATTRIBUTES)
|
|
);
|
|
},
|
|
initProgram: function(gl) {
|
|
var vertexShader,
|
|
fragmentShader,
|
|
program;
|
|
|
|
vertexShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'attribute vec2 a_pos1;',
|
|
'attribute vec2 a_pos2;',
|
|
'attribute float a_thickness;',
|
|
'attribute float a_tSize;',
|
|
'attribute float a_delay;',
|
|
'attribute float a_minus;',
|
|
'attribute float a_head;',
|
|
'attribute float a_headPosition;',
|
|
'attribute float a_color;',
|
|
|
|
'uniform vec2 u_resolution;',
|
|
'uniform float u_ratio;',
|
|
'uniform float u_nodeRatio;',
|
|
'uniform float u_arrowHead;',
|
|
'uniform float u_scale;',
|
|
'uniform mat3 u_matrix;',
|
|
'uniform mat2 u_matrixHalfPi;',
|
|
'uniform mat2 u_matrixHalfPiMinus;',
|
|
|
|
'varying vec4 color;',
|
|
|
|
'void main() {',
|
|
// Find the good point:
|
|
'vec2 pos = normalize(a_pos2 - a_pos1);',
|
|
|
|
'mat2 matrix = (1.0 - a_head) *',
|
|
'(',
|
|
'a_minus * u_matrixHalfPiMinus +',
|
|
'(1.0 - a_minus) * u_matrixHalfPi',
|
|
') + a_head * (',
|
|
'a_headPosition * u_matrixHalfPiMinus * 0.6 +',
|
|
'(a_headPosition * a_headPosition - 1.0) * mat2(1.0)',
|
|
');',
|
|
|
|
'pos = a_pos1 + (',
|
|
// Deal with body:
|
|
'(1.0 - a_head) * a_thickness * u_ratio * matrix * pos +',
|
|
// Deal with head:
|
|
'a_head * u_arrowHead * a_thickness * u_ratio * matrix * pos +',
|
|
// Deal with delay:
|
|
'a_delay * pos * (',
|
|
'a_tSize / u_nodeRatio +',
|
|
'u_arrowHead * a_thickness * u_ratio',
|
|
')',
|
|
');',
|
|
|
|
// Scale from [[-1 1] [-1 1]] to the container:
|
|
'gl_Position = vec4(',
|
|
'((u_matrix * vec3(pos, 1)).xy /',
|
|
'u_resolution * 2.0 - 1.0) * vec2(1, -1),',
|
|
'0,',
|
|
'1',
|
|
');',
|
|
|
|
// Extract the color:
|
|
'float c = a_color;',
|
|
'color.b = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.g = mod(c, 256.0); c = floor(c / 256.0);',
|
|
'color.r = mod(c, 256.0); c = floor(c / 256.0); color /= 255.0;',
|
|
'color.a = 1.0;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.VERTEX_SHADER
|
|
);
|
|
|
|
fragmentShader = sigma.utils.loadShader(
|
|
gl,
|
|
[
|
|
'precision mediump float;',
|
|
|
|
'varying vec4 color;',
|
|
|
|
'void main(void) {',
|
|
'gl_FragColor = color;',
|
|
'}'
|
|
].join('\n'),
|
|
gl.FRAGMENT_SHADER
|
|
);
|
|
|
|
program = sigma.utils.loadProgram(gl, [vertexShader, fragmentShader]);
|
|
|
|
return program;
|
|
}
|
|
};
|
|
})();
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.canvas.labels');
|
|
|
|
/**
|
|
* This label renderer will just display the label on the right of the node.
|
|
*
|
|
* @param {object} node The node object.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.labels.def = function(node, context, settings) {
|
|
var fontSize,
|
|
prefix = settings('prefix') || '',
|
|
size = node[prefix + 'size'];
|
|
|
|
if (size < settings('labelThreshold'))
|
|
return;
|
|
|
|
if (!node.label || typeof node.label !== 'string')
|
|
return;
|
|
|
|
fontSize = (settings('labelSize') === 'fixed') ?
|
|
settings('defaultLabelSize') :
|
|
settings('labelSizeRatio') * size;
|
|
|
|
context.font = (settings('fontStyle') ? settings('fontStyle') + ' ' : '') +
|
|
fontSize + 'px ' + settings('font');
|
|
context.fillStyle = (settings('labelColor') === 'node') ?
|
|
(node.color || settings('defaultNodeColor')) :
|
|
settings('defaultLabelColor');
|
|
|
|
context.fillText(
|
|
node.label,
|
|
Math.round(node[prefix + 'x'] + size + 3),
|
|
Math.round(node[prefix + 'y'] + fontSize / 3)
|
|
);
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.canvas.hovers');
|
|
|
|
/**
|
|
* This hover renderer will basically display the label with a background.
|
|
*
|
|
* @param {object} node The node object.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.hovers.def = function(node, context, settings) {
|
|
var x,
|
|
y,
|
|
w,
|
|
h,
|
|
e,
|
|
fontStyle = settings('hoverFontStyle') || settings('fontStyle'),
|
|
prefix = settings('prefix') || '',
|
|
size = node[prefix + 'size'],
|
|
fontSize = (settings('labelSize') === 'fixed') ?
|
|
settings('defaultLabelSize') :
|
|
settings('labelSizeRatio') * size;
|
|
|
|
// Label background:
|
|
context.font = (fontStyle ? fontStyle + ' ' : '') +
|
|
fontSize + 'px ' + (settings('hoverFont') || settings('font'));
|
|
|
|
context.beginPath();
|
|
context.fillStyle = settings('labelHoverBGColor') === 'node' ?
|
|
(node.color || settings('defaultNodeColor')) :
|
|
settings('defaultHoverLabelBGColor');
|
|
|
|
if (node.label && settings('labelHoverShadow')) {
|
|
context.shadowOffsetX = 0;
|
|
context.shadowOffsetY = 0;
|
|
context.shadowBlur = 8;
|
|
context.shadowColor = settings('labelHoverShadowColor');
|
|
}
|
|
|
|
if (node.label && typeof node.label === 'string') {
|
|
x = Math.round(node[prefix + 'x'] - fontSize / 2 - 2);
|
|
y = Math.round(node[prefix + 'y'] - fontSize / 2 - 2);
|
|
w = Math.round(
|
|
context.measureText(node.label).width + fontSize / 2 + size + 7
|
|
);
|
|
h = Math.round(fontSize + 4);
|
|
e = Math.round(fontSize / 2 + 2);
|
|
|
|
context.moveTo(x, y + e);
|
|
context.arcTo(x, y, x + e, y, e);
|
|
context.lineTo(x + w, y);
|
|
context.lineTo(x + w, y + h);
|
|
context.lineTo(x + e, y + h);
|
|
context.arcTo(x, y + h, x, y + h - e, e);
|
|
context.lineTo(x, y + e);
|
|
|
|
context.closePath();
|
|
context.fill();
|
|
|
|
context.shadowOffsetX = 0;
|
|
context.shadowOffsetY = 0;
|
|
context.shadowBlur = 0;
|
|
}
|
|
|
|
// Node border:
|
|
if (settings('borderSize') > 0) {
|
|
context.beginPath();
|
|
context.fillStyle = settings('nodeBorderColor') === 'node' ?
|
|
(node.color || settings('defaultNodeColor')) :
|
|
settings('defaultNodeBorderColor');
|
|
context.arc(
|
|
node[prefix + 'x'],
|
|
node[prefix + 'y'],
|
|
size + settings('borderSize'),
|
|
0,
|
|
Math.PI * 2,
|
|
true
|
|
);
|
|
context.closePath();
|
|
context.fill();
|
|
}
|
|
|
|
// Node:
|
|
var nodeRenderer = sigma.canvas.nodes[node.type] || sigma.canvas.nodes.def;
|
|
nodeRenderer(node, context, settings);
|
|
|
|
// Display the label:
|
|
if (node.label && typeof node.label === 'string') {
|
|
context.fillStyle = (settings('labelHoverColor') === 'node') ?
|
|
(node.color || settings('defaultNodeColor')) :
|
|
settings('defaultLabelHoverColor');
|
|
|
|
context.fillText(
|
|
node.label,
|
|
Math.round(node[prefix + 'x'] + size + 3),
|
|
Math.round(node[prefix + 'y'] + fontSize / 3)
|
|
);
|
|
}
|
|
};
|
|
}).call(this);
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.canvas.nodes');
|
|
|
|
/**
|
|
* The default node renderer. It renders the node as a simple disc.
|
|
*
|
|
* @param {object} node The node object.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.nodes.def = function(node, context, settings) {
|
|
var prefix = settings('prefix') || '';
|
|
|
|
context.fillStyle = node.color || settings('defaultNodeColor');
|
|
context.beginPath();
|
|
context.arc(
|
|
node[prefix + 'x'],
|
|
node[prefix + 'y'],
|
|
node[prefix + 'size'],
|
|
0,
|
|
Math.PI * 2,
|
|
true
|
|
);
|
|
|
|
context.closePath();
|
|
context.fill();
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.canvas.edges');
|
|
|
|
/**
|
|
* The default edge renderer. It renders the edge as a simple line.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source node The edge source node.
|
|
* @param {object} target node The edge target node.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.edges.def = function(edge, source, target, context, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
size = edge[prefix + 'size'] || 1,
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor');
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
context.strokeStyle = color;
|
|
context.lineWidth = size;
|
|
context.beginPath();
|
|
context.moveTo(
|
|
source[prefix + 'x'],
|
|
source[prefix + 'y']
|
|
);
|
|
context.lineTo(
|
|
target[prefix + 'x'],
|
|
target[prefix + 'y']
|
|
);
|
|
context.stroke();
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.canvas.edges');
|
|
|
|
/**
|
|
* This edge renderer will display edges as curves.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source node The edge source node.
|
|
* @param {object} target node The edge target node.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.edges.curve = function(edge, source, target, context, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
size = edge[prefix + 'size'] || 1,
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor'),
|
|
cp = {},
|
|
sSize = source[prefix + 'size'],
|
|
sX = source[prefix + 'x'],
|
|
sY = source[prefix + 'y'],
|
|
tX = target[prefix + 'x'],
|
|
tY = target[prefix + 'y'];
|
|
|
|
cp = (source.id === target.id) ?
|
|
sigma.utils.getSelfLoopControlPoints(sX, sY, sSize) :
|
|
sigma.utils.getQuadraticControlPoint(sX, sY, tX, tY);
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
context.strokeStyle = color;
|
|
context.lineWidth = size;
|
|
context.beginPath();
|
|
context.moveTo(sX, sY);
|
|
if (source.id === target.id) {
|
|
context.bezierCurveTo(cp.x1, cp.y1, cp.x2, cp.y2, tX, tY);
|
|
} else {
|
|
context.quadraticCurveTo(cp.x, cp.y, tX, tY);
|
|
}
|
|
context.stroke();
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.canvas.edges');
|
|
|
|
/**
|
|
* This edge renderer will display edges as arrows going from the source node
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source node The edge source node.
|
|
* @param {object} target node The edge target node.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.edges.arrow = function(edge, source, target, context, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor'),
|
|
size = edge[prefix + 'size'] || 1,
|
|
tSize = target[prefix + 'size'],
|
|
sX = source[prefix + 'x'],
|
|
sY = source[prefix + 'y'],
|
|
tX = target[prefix + 'x'],
|
|
tY = target[prefix + 'y'],
|
|
aSize = Math.max(size * 2.5, settings('minArrowSize')),
|
|
d = Math.sqrt(Math.pow(tX - sX, 2) + Math.pow(tY - sY, 2)),
|
|
aX = sX + (tX - sX) * (d - aSize - tSize) / d,
|
|
aY = sY + (tY - sY) * (d - aSize - tSize) / d,
|
|
vX = (tX - sX) * aSize / d,
|
|
vY = (tY - sY) * aSize / d;
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
context.strokeStyle = color;
|
|
context.lineWidth = size;
|
|
context.beginPath();
|
|
context.moveTo(sX, sY);
|
|
context.lineTo(
|
|
aX,
|
|
aY
|
|
);
|
|
context.stroke();
|
|
|
|
context.fillStyle = color;
|
|
context.beginPath();
|
|
context.moveTo(aX + vX, aY + vY);
|
|
context.lineTo(aX + vY * 0.6, aY - vX * 0.6);
|
|
context.lineTo(aX - vY * 0.6, aY + vX * 0.6);
|
|
context.lineTo(aX + vX, aY + vY);
|
|
context.closePath();
|
|
context.fill();
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.canvas.edges');
|
|
|
|
/**
|
|
* This edge renderer will display edges as curves with arrow heading.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source node The edge source node.
|
|
* @param {object} target node The edge target node.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.edges.curvedArrow =
|
|
function(edge, source, target, context, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor'),
|
|
cp = {},
|
|
size = edge[prefix + 'size'] || 1,
|
|
tSize = target[prefix + 'size'],
|
|
sX = source[prefix + 'x'],
|
|
sY = source[prefix + 'y'],
|
|
tX = target[prefix + 'x'],
|
|
tY = target[prefix + 'y'],
|
|
aSize = Math.max(size * 2.5, settings('minArrowSize')),
|
|
d,
|
|
aX,
|
|
aY,
|
|
vX,
|
|
vY;
|
|
|
|
cp = (source.id === target.id) ?
|
|
sigma.utils.getSelfLoopControlPoints(sX, sY, tSize) :
|
|
sigma.utils.getQuadraticControlPoint(sX, sY, tX, tY);
|
|
|
|
if (source.id === target.id) {
|
|
d = Math.sqrt(Math.pow(tX - cp.x1, 2) + Math.pow(tY - cp.y1, 2));
|
|
aX = cp.x1 + (tX - cp.x1) * (d - aSize - tSize) / d;
|
|
aY = cp.y1 + (tY - cp.y1) * (d - aSize - tSize) / d;
|
|
vX = (tX - cp.x1) * aSize / d;
|
|
vY = (tY - cp.y1) * aSize / d;
|
|
}
|
|
else {
|
|
d = Math.sqrt(Math.pow(tX - cp.x, 2) + Math.pow(tY - cp.y, 2));
|
|
aX = cp.x + (tX - cp.x) * (d - aSize - tSize) / d;
|
|
aY = cp.y + (tY - cp.y) * (d - aSize - tSize) / d;
|
|
vX = (tX - cp.x) * aSize / d;
|
|
vY = (tY - cp.y) * aSize / d;
|
|
}
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
context.strokeStyle = color;
|
|
context.lineWidth = size;
|
|
context.beginPath();
|
|
context.moveTo(sX, sY);
|
|
if (source.id === target.id) {
|
|
context.bezierCurveTo(cp.x2, cp.y2, cp.x1, cp.y1, aX, aY);
|
|
} else {
|
|
context.quadraticCurveTo(cp.x, cp.y, aX, aY);
|
|
}
|
|
context.stroke();
|
|
|
|
context.fillStyle = color;
|
|
context.beginPath();
|
|
context.moveTo(aX + vX, aY + vY);
|
|
context.lineTo(aX + vY * 0.6, aY - vX * 0.6);
|
|
context.lineTo(aX - vY * 0.6, aY + vX * 0.6);
|
|
context.lineTo(aX + vX, aY + vY);
|
|
context.closePath();
|
|
context.fill();
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.canvas.edgehovers');
|
|
|
|
/**
|
|
* This hover renderer will display the edge with a different color or size.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source node The edge source node.
|
|
* @param {object} target node The edge target node.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.edgehovers.def =
|
|
function(edge, source, target, context, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
size = edge[prefix + 'size'] || 1,
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor');
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
if (settings('edgeHoverColor') === 'edge') {
|
|
color = edge.hover_color || color;
|
|
} else {
|
|
color = edge.hover_color || settings('defaultEdgeHoverColor') || color;
|
|
}
|
|
size *= settings('edgeHoverSizeRatio');
|
|
|
|
context.strokeStyle = color;
|
|
context.lineWidth = size;
|
|
context.beginPath();
|
|
context.moveTo(
|
|
source[prefix + 'x'],
|
|
source[prefix + 'y']
|
|
);
|
|
context.lineTo(
|
|
target[prefix + 'x'],
|
|
target[prefix + 'y']
|
|
);
|
|
context.stroke();
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.canvas.edgehovers');
|
|
|
|
/**
|
|
* This hover renderer will display the edge with a different color or size.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source node The edge source node.
|
|
* @param {object} target node The edge target node.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.edgehovers.curve =
|
|
function(edge, source, target, context, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
size = settings('edgeHoverSizeRatio') * (edge[prefix + 'size'] || 1),
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor'),
|
|
cp = {},
|
|
sSize = source[prefix + 'size'],
|
|
sX = source[prefix + 'x'],
|
|
sY = source[prefix + 'y'],
|
|
tX = target[prefix + 'x'],
|
|
tY = target[prefix + 'y'];
|
|
|
|
cp = (source.id === target.id) ?
|
|
sigma.utils.getSelfLoopControlPoints(sX, sY, sSize) :
|
|
sigma.utils.getQuadraticControlPoint(sX, sY, tX, tY);
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
if (settings('edgeHoverColor') === 'edge') {
|
|
color = edge.hover_color || color;
|
|
} else {
|
|
color = edge.hover_color || settings('defaultEdgeHoverColor') || color;
|
|
}
|
|
|
|
context.strokeStyle = color;
|
|
context.lineWidth = size;
|
|
context.beginPath();
|
|
context.moveTo(sX, sY);
|
|
if (source.id === target.id) {
|
|
context.bezierCurveTo(cp.x1, cp.y1, cp.x2, cp.y2, tX, tY);
|
|
} else {
|
|
context.quadraticCurveTo(cp.x, cp.y, tX, tY);
|
|
}
|
|
context.stroke();
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.canvas.edgehovers');
|
|
|
|
/**
|
|
* This hover renderer will display the edge with a different color or size.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source node The edge source node.
|
|
* @param {object} target node The edge target node.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.edgehovers.arrow =
|
|
function(edge, source, target, context, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor'),
|
|
size = edge[prefix + 'size'] || 1,
|
|
tSize = target[prefix + 'size'],
|
|
sX = source[prefix + 'x'],
|
|
sY = source[prefix + 'y'],
|
|
tX = target[prefix + 'x'],
|
|
tY = target[prefix + 'y'];
|
|
|
|
size = (edge.hover) ?
|
|
settings('edgeHoverSizeRatio') * size : size;
|
|
var aSize = size * 2.5,
|
|
d = Math.sqrt(Math.pow(tX - sX, 2) + Math.pow(tY - sY, 2)),
|
|
aX = sX + (tX - sX) * (d - aSize - tSize) / d,
|
|
aY = sY + (tY - sY) * (d - aSize - tSize) / d,
|
|
vX = (tX - sX) * aSize / d,
|
|
vY = (tY - sY) * aSize / d;
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
if (settings('edgeHoverColor') === 'edge') {
|
|
color = edge.hover_color || color;
|
|
} else {
|
|
color = edge.hover_color || settings('defaultEdgeHoverColor') || color;
|
|
}
|
|
|
|
context.strokeStyle = color;
|
|
context.lineWidth = size;
|
|
context.beginPath();
|
|
context.moveTo(sX, sY);
|
|
context.lineTo(
|
|
aX,
|
|
aY
|
|
);
|
|
context.stroke();
|
|
|
|
context.fillStyle = color;
|
|
context.beginPath();
|
|
context.moveTo(aX + vX, aY + vY);
|
|
context.lineTo(aX + vY * 0.6, aY - vX * 0.6);
|
|
context.lineTo(aX - vY * 0.6, aY + vX * 0.6);
|
|
context.lineTo(aX + vX, aY + vY);
|
|
context.closePath();
|
|
context.fill();
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.canvas.edgehovers');
|
|
|
|
/**
|
|
* This hover renderer will display the edge with a different color or size.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source node The edge source node.
|
|
* @param {object} target node The edge target node.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.edgehovers.curvedArrow =
|
|
function(edge, source, target, context, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor'),
|
|
cp = {},
|
|
size = settings('edgeHoverSizeRatio') * (edge[prefix + 'size'] || 1),
|
|
tSize = target[prefix + 'size'],
|
|
sX = source[prefix + 'x'],
|
|
sY = source[prefix + 'y'],
|
|
tX = target[prefix + 'x'],
|
|
tY = target[prefix + 'y'],
|
|
d,
|
|
aSize,
|
|
aX,
|
|
aY,
|
|
vX,
|
|
vY;
|
|
|
|
cp = (source.id === target.id) ?
|
|
sigma.utils.getSelfLoopControlPoints(sX, sY, tSize) :
|
|
sigma.utils.getQuadraticControlPoint(sX, sY, tX, tY);
|
|
|
|
if (source.id === target.id) {
|
|
d = Math.sqrt(Math.pow(tX - cp.x1, 2) + Math.pow(tY - cp.y1, 2));
|
|
aSize = size * 2.5;
|
|
aX = cp.x1 + (tX - cp.x1) * (d - aSize - tSize) / d;
|
|
aY = cp.y1 + (tY - cp.y1) * (d - aSize - tSize) / d;
|
|
vX = (tX - cp.x1) * aSize / d;
|
|
vY = (tY - cp.y1) * aSize / d;
|
|
}
|
|
else {
|
|
d = Math.sqrt(Math.pow(tX - cp.x, 2) + Math.pow(tY - cp.y, 2));
|
|
aSize = size * 2.5;
|
|
aX = cp.x + (tX - cp.x) * (d - aSize - tSize) / d;
|
|
aY = cp.y + (tY - cp.y) * (d - aSize - tSize) / d;
|
|
vX = (tX - cp.x) * aSize / d;
|
|
vY = (tY - cp.y) * aSize / d;
|
|
}
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
if (settings('edgeHoverColor') === 'edge') {
|
|
color = edge.hover_color || color;
|
|
} else {
|
|
color = edge.hover_color || settings('defaultEdgeHoverColor') || color;
|
|
}
|
|
|
|
context.strokeStyle = color;
|
|
context.lineWidth = size;
|
|
context.beginPath();
|
|
context.moveTo(sX, sY);
|
|
if (source.id === target.id) {
|
|
context.bezierCurveTo(cp.x2, cp.y2, cp.x1, cp.y1, aX, aY);
|
|
} else {
|
|
context.quadraticCurveTo(cp.x, cp.y, aX, aY);
|
|
}
|
|
context.stroke();
|
|
|
|
context.fillStyle = color;
|
|
context.beginPath();
|
|
context.moveTo(aX + vX, aY + vY);
|
|
context.lineTo(aX + vY * 0.6, aY - vX * 0.6);
|
|
context.lineTo(aX - vY * 0.6, aY + vX * 0.6);
|
|
context.lineTo(aX + vX, aY + vY);
|
|
context.closePath();
|
|
context.fill();
|
|
};
|
|
})();
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.canvas.extremities');
|
|
|
|
/**
|
|
* The default renderer for hovered edge extremities. It renders the edge
|
|
* extremities as hovered.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source node The edge source node.
|
|
* @param {object} target node The edge target node.
|
|
* @param {CanvasRenderingContext2D} context The canvas context.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
sigma.canvas.extremities.def =
|
|
function(edge, source, target, context, settings) {
|
|
// Source Node:
|
|
(
|
|
sigma.canvas.hovers[source.type] ||
|
|
sigma.canvas.hovers.def
|
|
) (
|
|
source, context, settings
|
|
);
|
|
|
|
// Target Node:
|
|
(
|
|
sigma.canvas.hovers[target.type] ||
|
|
sigma.canvas.hovers.def
|
|
) (
|
|
target, context, settings
|
|
);
|
|
};
|
|
}).call(this);
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.svg.utils');
|
|
|
|
/**
|
|
* Some useful functions used by sigma's SVG renderer.
|
|
*/
|
|
sigma.svg.utils = {
|
|
|
|
/**
|
|
* SVG Element show.
|
|
*
|
|
* @param {DOMElement} element The DOM element to show.
|
|
*/
|
|
show: function(element) {
|
|
element.style.display = '';
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* SVG Element hide.
|
|
*
|
|
* @param {DOMElement} element The DOM element to hide.
|
|
*/
|
|
hide: function(element) {
|
|
element.style.display = 'none';
|
|
return this;
|
|
}
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.svg.nodes');
|
|
|
|
/**
|
|
* The default node renderer. It renders the node as a simple disc.
|
|
*/
|
|
sigma.svg.nodes.def = {
|
|
|
|
/**
|
|
* SVG Element creation.
|
|
*
|
|
* @param {object} node The node object.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
create: function(node, settings) {
|
|
var prefix = settings('prefix') || '',
|
|
circle = document.createElementNS(settings('xmlns'), 'circle');
|
|
|
|
// Defining the node's circle
|
|
circle.setAttributeNS(null, 'data-node-id', node.id);
|
|
circle.setAttributeNS(null, 'class', settings('classPrefix') + '-node');
|
|
circle.setAttributeNS(
|
|
null, 'fill', node.color || settings('defaultNodeColor'));
|
|
|
|
// Returning the DOM Element
|
|
return circle;
|
|
},
|
|
|
|
/**
|
|
* SVG Element update.
|
|
*
|
|
* @param {object} node The node object.
|
|
* @param {DOMElement} circle The node DOM element.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
update: function(node, circle, settings) {
|
|
var prefix = settings('prefix') || '';
|
|
|
|
// Applying changes
|
|
// TODO: optimize - check if necessary
|
|
circle.setAttributeNS(null, 'cx', node[prefix + 'x']);
|
|
circle.setAttributeNS(null, 'cy', node[prefix + 'y']);
|
|
circle.setAttributeNS(null, 'r', node[prefix + 'size']);
|
|
|
|
// Updating only if not freestyle
|
|
if (!settings('freeStyle'))
|
|
circle.setAttributeNS(
|
|
null, 'fill', node.color || settings('defaultNodeColor'));
|
|
|
|
// Showing
|
|
circle.style.display = '';
|
|
|
|
return this;
|
|
}
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.svg.edges');
|
|
|
|
/**
|
|
* The default edge renderer. It renders the node as a simple line.
|
|
*/
|
|
sigma.svg.edges.def = {
|
|
|
|
/**
|
|
* SVG Element creation.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source The source node object.
|
|
* @param {object} target The target node object.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
create: function(edge, source, target, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor');
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
var line = document.createElementNS(settings('xmlns'), 'line');
|
|
|
|
// Attributes
|
|
line.setAttributeNS(null, 'data-edge-id', edge.id);
|
|
line.setAttributeNS(null, 'class', settings('classPrefix') + '-edge');
|
|
line.setAttributeNS(null, 'stroke', color);
|
|
|
|
return line;
|
|
},
|
|
|
|
/**
|
|
* SVG Element update.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {DOMElement} line The line DOM Element.
|
|
* @param {object} source The source node object.
|
|
* @param {object} target The target node object.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
update: function(edge, line, source, target, settings) {
|
|
var prefix = settings('prefix') || '';
|
|
|
|
line.setAttributeNS(null, 'stroke-width', edge[prefix + 'size'] || 1);
|
|
line.setAttributeNS(null, 'x1', source[prefix + 'x']);
|
|
line.setAttributeNS(null, 'y1', source[prefix + 'y']);
|
|
line.setAttributeNS(null, 'x2', target[prefix + 'x']);
|
|
line.setAttributeNS(null, 'y2', target[prefix + 'y']);
|
|
|
|
// Showing
|
|
line.style.display = '';
|
|
|
|
return this;
|
|
}
|
|
};
|
|
})();
|
|
|
|
;(function() {
|
|
'use strict';
|
|
|
|
sigma.utils.pkg('sigma.svg.edges');
|
|
|
|
/**
|
|
* The curve edge renderer. It renders the node as a bezier curve.
|
|
*/
|
|
sigma.svg.edges.curve = {
|
|
|
|
/**
|
|
* SVG Element creation.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {object} source The source node object.
|
|
* @param {object} target The target node object.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
create: function(edge, source, target, settings) {
|
|
var color = edge.color,
|
|
prefix = settings('prefix') || '',
|
|
edgeColor = settings('edgeColor'),
|
|
defaultNodeColor = settings('defaultNodeColor'),
|
|
defaultEdgeColor = settings('defaultEdgeColor');
|
|
|
|
if (!color)
|
|
switch (edgeColor) {
|
|
case 'source':
|
|
color = source.color || defaultNodeColor;
|
|
break;
|
|
case 'target':
|
|
color = target.color || defaultNodeColor;
|
|
break;
|
|
default:
|
|
color = defaultEdgeColor;
|
|
break;
|
|
}
|
|
|
|
var path = document.createElementNS(settings('xmlns'), 'path');
|
|
|
|
// Attributes
|
|
path.setAttributeNS(null, 'data-edge-id', edge.id);
|
|
path.setAttributeNS(null, 'class', settings('classPrefix') + '-edge');
|
|
path.setAttributeNS(null, 'stroke', color);
|
|
|
|
return path;
|
|
},
|
|
|
|
/**
|
|
* SVG Element update.
|
|
*
|
|
* @param {object} edge The edge object.
|
|
* @param {DOMElement} line The line DOM Element.
|
|
* @param {object} source The source node object.
|
|
* @param {object} target The target node object.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
update: function(edge, path, source, target, settings) {
|
|
var prefix = settings('prefix') || '';
|
|
|
|
path.setAttributeNS(null, 'stroke-width', edge[prefix + 'size'] || 1);
|
|
|
|
// Control point
|
|
var cx = (source[prefix + 'x'] + target[prefix + 'x']) / 2 +
|
|
(target[prefix + 'y'] - source[prefix + 'y']) / 4,
|
|
cy = (source[prefix + 'y'] + target[prefix + 'y']) / 2 +
|
|
(source[prefix + 'x'] - target[prefix + 'x']) / 4;
|
|
|
|
// Path
|
|
var p = 'M' + source[prefix + 'x'] + ',' + source[prefix + 'y'] + ' ' +
|
|
'Q' + cx + ',' + cy + ' ' +
|
|
target[prefix + 'x'] + ',' + target[prefix + 'y'];
|
|
|
|
// Updating attributes
|
|
path.setAttributeNS(null, 'd', p);
|
|
path.setAttributeNS(null, 'fill', 'none');
|
|
|
|
// Showing
|
|
path.style.display = '';
|
|
|
|
return this;
|
|
}
|
|
};
|
|
})();
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.svg.labels');
|
|
|
|
/**
|
|
* The default label renderer. It renders the label as a simple text.
|
|
*/
|
|
sigma.svg.labels.def = {
|
|
|
|
/**
|
|
* SVG Element creation.
|
|
*
|
|
* @param {object} node The node object.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
create: function(node, settings) {
|
|
var prefix = settings('prefix') || '',
|
|
size = node[prefix + 'size'],
|
|
text = document.createElementNS(settings('xmlns'), 'text');
|
|
|
|
var fontSize = (settings('labelSize') === 'fixed') ?
|
|
settings('defaultLabelSize') :
|
|
settings('labelSizeRatio') * size;
|
|
|
|
var fontColor = (settings('labelColor') === 'node') ?
|
|
(node.color || settings('defaultNodeColor')) :
|
|
settings('defaultLabelColor');
|
|
|
|
text.setAttributeNS(null, 'data-label-target', node.id);
|
|
text.setAttributeNS(null, 'class', settings('classPrefix') + '-label');
|
|
text.setAttributeNS(null, 'font-size', fontSize);
|
|
text.setAttributeNS(null, 'font-family', settings('font'));
|
|
text.setAttributeNS(null, 'fill', fontColor);
|
|
|
|
text.innerHTML = node.label;
|
|
text.textContent = node.label;
|
|
|
|
return text;
|
|
},
|
|
|
|
/**
|
|
* SVG Element update.
|
|
*
|
|
* @param {object} node The node object.
|
|
* @param {DOMElement} text The label DOM element.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
update: function(node, text, settings) {
|
|
var prefix = settings('prefix') || '',
|
|
size = node[prefix + 'size'];
|
|
|
|
var fontSize = (settings('labelSize') === 'fixed') ?
|
|
settings('defaultLabelSize') :
|
|
settings('labelSizeRatio') * size;
|
|
|
|
// Case when we don't want to display the label
|
|
if (!settings('forceLabels') && size < settings('labelThreshold'))
|
|
return;
|
|
|
|
if (typeof node.label !== 'string')
|
|
return;
|
|
|
|
// Updating
|
|
text.setAttributeNS(null, 'x',
|
|
Math.round(node[prefix + 'x'] + size + 3));
|
|
text.setAttributeNS(null, 'y',
|
|
Math.round(node[prefix + 'y'] + fontSize / 3));
|
|
|
|
// Showing
|
|
text.style.display = '';
|
|
|
|
return this;
|
|
}
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.svg.hovers');
|
|
|
|
/**
|
|
* The default hover renderer.
|
|
*/
|
|
sigma.svg.hovers.def = {
|
|
|
|
/**
|
|
* SVG Element creation.
|
|
*
|
|
* @param {object} node The node object.
|
|
* @param {CanvasElement} measurementCanvas A fake canvas handled by
|
|
* the svg to perform some measurements and
|
|
* passed by the renderer.
|
|
* @param {DOMElement} nodeCircle The node DOM Element.
|
|
* @param {configurable} settings The settings function.
|
|
*/
|
|
create: function(node, nodeCircle, measurementCanvas, settings) {
|
|
|
|
// Defining visual properties
|
|
var x,
|
|
y,
|
|
w,
|
|
h,
|
|
e,
|
|
d,
|
|
fontStyle = settings('hoverFontStyle') || settings('fontStyle'),
|
|
prefix = settings('prefix') || '',
|
|
size = node[prefix + 'size'],
|
|
fontSize = (settings('labelSize') === 'fixed') ?
|
|
settings('defaultLabelSize') :
|
|
settings('labelSizeRatio') * size,
|
|
fontColor = (settings('labelHoverColor') === 'node') ?
|
|
(node.color || settings('defaultNodeColor')) :
|
|
settings('defaultLabelHoverColor');
|
|
|
|
// Creating elements
|
|
var group = document.createElementNS(settings('xmlns'), 'g'),
|
|
rectangle = document.createElementNS(settings('xmlns'), 'rect'),
|
|
circle = document.createElementNS(settings('xmlns'), 'circle'),
|
|
text = document.createElementNS(settings('xmlns'), 'text');
|
|
|
|
// Defining properties
|
|
group.setAttributeNS(null, 'class', settings('classPrefix') + '-hover');
|
|
group.setAttributeNS(null, 'data-node-id', node.id);
|
|
|
|
if (typeof node.label === 'string') {
|
|
|
|
// Text
|
|
text.innerHTML = node.label;
|
|
text.textContent = node.label;
|
|
text.setAttributeNS(
|
|
null,
|
|
'class',
|
|
settings('classPrefix') + '-hover-label');
|
|
text.setAttributeNS(null, 'font-size', fontSize);
|
|
text.setAttributeNS(null, 'font-family', settings('font'));
|
|
text.setAttributeNS(null, 'fill', fontColor);
|
|
text.setAttributeNS(null, 'x',
|
|
Math.round(node[prefix + 'x'] + size + 3));
|
|
text.setAttributeNS(null, 'y',
|
|
Math.round(node[prefix + 'y'] + fontSize / 3));
|
|
|
|
// Measures
|
|
// OPTIMIZE: Find a better way than a measurement canvas
|
|
x = Math.round(node[prefix + 'x'] - fontSize / 2 - 2);
|
|
y = Math.round(node[prefix + 'y'] - fontSize / 2 - 2);
|
|
w = Math.round(
|
|
measurementCanvas.measureText(node.label).width +
|
|
fontSize / 2 + size + 9
|
|
);
|
|
h = Math.round(fontSize + 4);
|
|
e = Math.round(fontSize / 2 + 2);
|
|
|
|
// Circle
|
|
circle.setAttributeNS(
|
|
null,
|
|
'class',
|
|
settings('classPrefix') + '-hover-area');
|
|
circle.setAttributeNS(null, 'fill', '#fff');
|
|
circle.setAttributeNS(null, 'cx', node[prefix + 'x']);
|
|
circle.setAttributeNS(null, 'cy', node[prefix + 'y']);
|
|
circle.setAttributeNS(null, 'r', e);
|
|
|
|
// Rectangle
|
|
rectangle.setAttributeNS(
|
|
null,
|
|
'class',
|
|
settings('classPrefix') + '-hover-area');
|
|
rectangle.setAttributeNS(null, 'fill', '#fff');
|
|
rectangle.setAttributeNS(null, 'x', node[prefix + 'x'] + e / 4);
|
|
rectangle.setAttributeNS(null, 'y', node[prefix + 'y'] - e);
|
|
rectangle.setAttributeNS(null, 'width', w);
|
|
rectangle.setAttributeNS(null, 'height', h);
|
|
}
|
|
|
|
// Appending childs
|
|
group.appendChild(circle);
|
|
group.appendChild(rectangle);
|
|
group.appendChild(text);
|
|
group.appendChild(nodeCircle);
|
|
|
|
return group;
|
|
}
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.middlewares');
|
|
sigma.utils.pkg('sigma.utils');
|
|
|
|
/**
|
|
* This middleware will rescale the graph such that it takes an optimal space
|
|
* on the renderer.
|
|
*
|
|
* As each middleware, this function is executed in the scope of the sigma
|
|
* instance.
|
|
*
|
|
* @param {?string} readPrefix The read prefix.
|
|
* @param {?string} writePrefix The write prefix.
|
|
* @param {object} options The parameters.
|
|
*/
|
|
sigma.middlewares.rescale = function(readPrefix, writePrefix, options) {
|
|
var i,
|
|
l,
|
|
a,
|
|
b,
|
|
c,
|
|
d,
|
|
scale,
|
|
margin,
|
|
n = this.graph.nodes(),
|
|
e = this.graph.edges(),
|
|
settings = this.settings.embedObjects(options || {}),
|
|
bounds = settings('bounds') || sigma.utils.getBoundaries(
|
|
this.graph,
|
|
readPrefix,
|
|
true
|
|
),
|
|
minX = bounds.minX,
|
|
minY = bounds.minY,
|
|
maxX = bounds.maxX,
|
|
maxY = bounds.maxY,
|
|
sizeMax = bounds.sizeMax,
|
|
weightMax = bounds.weightMax,
|
|
w = settings('width') || 1,
|
|
h = settings('height') || 1,
|
|
rescaleSettings = settings('autoRescale'),
|
|
validSettings = {
|
|
nodePosition: 1,
|
|
nodeSize: 1,
|
|
edgeSize: 1
|
|
};
|
|
|
|
/**
|
|
* What elements should we rescale?
|
|
*/
|
|
if (!(rescaleSettings instanceof Array))
|
|
rescaleSettings = ['nodePosition', 'nodeSize', 'edgeSize'];
|
|
|
|
for (i = 0, l = rescaleSettings.length; i < l; i++)
|
|
if (!validSettings[rescaleSettings[i]])
|
|
throw new Error(
|
|
'The rescale setting "' + rescaleSettings[i] + '" is not recognized.'
|
|
);
|
|
|
|
var np = ~rescaleSettings.indexOf('nodePosition'),
|
|
ns = ~rescaleSettings.indexOf('nodeSize'),
|
|
es = ~rescaleSettings.indexOf('edgeSize');
|
|
|
|
/**
|
|
* First, we compute the scaling ratio, without considering the sizes
|
|
* of the nodes : Each node will have its center in the canvas, but might
|
|
* be partially out of it.
|
|
*/
|
|
scale = settings('scalingMode') === 'outside' ?
|
|
Math.max(
|
|
w / Math.max(maxX - minX, 1),
|
|
h / Math.max(maxY - minY, 1)
|
|
) :
|
|
Math.min(
|
|
w / Math.max(maxX - minX, 1),
|
|
h / Math.max(maxY - minY, 1)
|
|
);
|
|
|
|
/**
|
|
* Then, we correct that scaling ratio considering a margin, which is
|
|
* basically the size of the biggest node.
|
|
* This has to be done as a correction since to compare the size of the
|
|
* biggest node to the X and Y values, we have to first get an
|
|
* approximation of the scaling ratio.
|
|
**/
|
|
margin =
|
|
(
|
|
settings('rescaleIgnoreSize') ?
|
|
0 :
|
|
(settings('maxNodeSize') || sizeMax) / scale
|
|
) +
|
|
(settings('sideMargin') || 0);
|
|
maxX += margin;
|
|
minX -= margin;
|
|
maxY += margin;
|
|
minY -= margin;
|
|
|
|
// Fix the scaling with the new extrema:
|
|
scale = settings('scalingMode') === 'outside' ?
|
|
Math.max(
|
|
w / Math.max(maxX - minX, 1),
|
|
h / Math.max(maxY - minY, 1)
|
|
) :
|
|
Math.min(
|
|
w / Math.max(maxX - minX, 1),
|
|
h / Math.max(maxY - minY, 1)
|
|
);
|
|
|
|
// Size homothetic parameters:
|
|
if (!settings('maxNodeSize') && !settings('minNodeSize')) {
|
|
a = 1;
|
|
b = 0;
|
|
} else if (settings('maxNodeSize') === settings('minNodeSize')) {
|
|
a = 0;
|
|
b = +settings('maxNodeSize');
|
|
} else {
|
|
a = (settings('maxNodeSize') - settings('minNodeSize')) / sizeMax;
|
|
b = +settings('minNodeSize');
|
|
}
|
|
|
|
if (!settings('maxEdgeSize') && !settings('minEdgeSize')) {
|
|
c = 1;
|
|
d = 0;
|
|
} else if (settings('maxEdgeSize') === settings('minEdgeSize')) {
|
|
c = 0;
|
|
d = +settings('minEdgeSize');
|
|
} else {
|
|
c = (settings('maxEdgeSize') - settings('minEdgeSize')) / weightMax;
|
|
d = +settings('minEdgeSize');
|
|
}
|
|
|
|
// Rescale the nodes and edges:
|
|
for (i = 0, l = e.length; i < l; i++)
|
|
e[i][writePrefix + 'size'] =
|
|
e[i][readPrefix + 'size'] * (es ? c : 1) + (es ? d : 0);
|
|
|
|
for (i = 0, l = n.length; i < l; i++) {
|
|
n[i][writePrefix + 'size'] =
|
|
n[i][readPrefix + 'size'] * (ns ? a : 1) + (ns ? b : 0);
|
|
n[i][writePrefix + 'x'] =
|
|
(n[i][readPrefix + 'x'] - (maxX + minX) / 2) * (np ? scale : 1);
|
|
n[i][writePrefix + 'y'] =
|
|
(n[i][readPrefix + 'y'] - (maxY + minY) / 2) * (np ? scale : 1);
|
|
}
|
|
};
|
|
|
|
sigma.utils.getBoundaries = function(graph, prefix, doEdges) {
|
|
var i,
|
|
l,
|
|
e = graph.edges(),
|
|
n = graph.nodes(),
|
|
weightMax = -Infinity,
|
|
sizeMax = -Infinity,
|
|
minX = Infinity,
|
|
minY = Infinity,
|
|
maxX = -Infinity,
|
|
maxY = -Infinity;
|
|
|
|
if (doEdges)
|
|
for (i = 0, l = e.length; i < l; i++)
|
|
weightMax = Math.max(e[i][prefix + 'size'], weightMax);
|
|
|
|
for (i = 0, l = n.length; i < l; i++) {
|
|
sizeMax = Math.max(n[i][prefix + 'size'], sizeMax);
|
|
maxX = Math.max(n[i][prefix + 'x'], maxX);
|
|
minX = Math.min(n[i][prefix + 'x'], minX);
|
|
maxY = Math.max(n[i][prefix + 'y'], maxY);
|
|
minY = Math.min(n[i][prefix + 'y'], minY);
|
|
}
|
|
|
|
weightMax = weightMax || 1;
|
|
sizeMax = sizeMax || 1;
|
|
|
|
return {
|
|
weightMax: weightMax,
|
|
sizeMax: sizeMax,
|
|
minX: minX,
|
|
minY: minY,
|
|
maxX: maxX,
|
|
maxY: maxY
|
|
};
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.middlewares');
|
|
|
|
/**
|
|
* This middleware will just copy the graphic properties.
|
|
*
|
|
* @param {?string} readPrefix The read prefix.
|
|
* @param {?string} writePrefix The write prefix.
|
|
*/
|
|
sigma.middlewares.copy = function(readPrefix, writePrefix) {
|
|
var i,
|
|
l,
|
|
a;
|
|
|
|
if (writePrefix + '' === readPrefix + '')
|
|
return;
|
|
|
|
a = this.graph.nodes();
|
|
for (i = 0, l = a.length; i < l; i++) {
|
|
a[i][writePrefix + 'x'] = a[i][readPrefix + 'x'];
|
|
a[i][writePrefix + 'y'] = a[i][readPrefix + 'y'];
|
|
a[i][writePrefix + 'size'] = a[i][readPrefix + 'size'];
|
|
}
|
|
|
|
a = this.graph.edges();
|
|
for (i = 0, l = a.length; i < l; i++)
|
|
a[i][writePrefix + 'size'] = a[i][readPrefix + 'size'];
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.misc.animation.running');
|
|
|
|
/**
|
|
* Generates a unique ID for the animation.
|
|
*
|
|
* @return {string} Returns the new ID.
|
|
*/
|
|
var _getID = (function() {
|
|
var id = 0;
|
|
return function() {
|
|
return '' + (++id);
|
|
};
|
|
})();
|
|
|
|
/**
|
|
* This function animates a camera. It has to be called with the camera to
|
|
* animate, the values of the coordinates to reach and eventually some
|
|
* options. It returns a number id, that you can use to kill the animation,
|
|
* with the method sigma.misc.animation.kill(id).
|
|
*
|
|
* The available options are:
|
|
*
|
|
* {?number} duration The duration of the animation.
|
|
* {?function} onNewFrame A callback to execute when the animation
|
|
* enter a new frame.
|
|
* {?function} onComplete A callback to execute when the animation
|
|
* is completed or killed.
|
|
* {?(string|function)} easing The name of a function from the package
|
|
* sigma.utils.easings, or a custom easing
|
|
* function.
|
|
*
|
|
* @param {camera} camera The camera to animate.
|
|
* @param {object} target The coordinates to reach.
|
|
* @param {?object} options Eventually an object to specify some options to
|
|
* the function. The available options are
|
|
* presented in the description of the function.
|
|
* @return {number} The animation id, to make it easy to kill
|
|
* through the method "sigma.misc.animation.kill".
|
|
*/
|
|
sigma.misc.animation.camera = function(camera, val, options) {
|
|
if (
|
|
!(camera instanceof sigma.classes.camera) ||
|
|
typeof val !== 'object' ||
|
|
!val
|
|
)
|
|
throw 'animation.camera: Wrong arguments.';
|
|
|
|
if (
|
|
typeof val.x !== 'number' &&
|
|
typeof val.y !== 'number' &&
|
|
typeof val.ratio !== 'number' &&
|
|
typeof val.angle !== 'number'
|
|
)
|
|
throw 'There must be at least one valid coordinate in the given val.';
|
|
|
|
var fn,
|
|
id,
|
|
anim,
|
|
easing,
|
|
duration,
|
|
initialVal,
|
|
o = options || {},
|
|
start = sigma.utils.dateNow();
|
|
|
|
// Store initial values:
|
|
initialVal = {
|
|
x: camera.x,
|
|
y: camera.y,
|
|
ratio: camera.ratio,
|
|
angle: camera.angle
|
|
};
|
|
|
|
duration = o.duration;
|
|
easing = typeof o.easing !== 'function' ?
|
|
sigma.utils.easings[o.easing || 'quadraticInOut'] :
|
|
o.easing;
|
|
|
|
fn = function() {
|
|
var coef,
|
|
t = o.duration ? (sigma.utils.dateNow() - start) / o.duration : 1;
|
|
|
|
// If the animation is over:
|
|
if (t >= 1) {
|
|
camera.isAnimated = false;
|
|
camera.goTo({
|
|
x: val.x !== undefined ? val.x : initialVal.x,
|
|
y: val.y !== undefined ? val.y : initialVal.y,
|
|
ratio: val.ratio !== undefined ? val.ratio : initialVal.ratio,
|
|
angle: val.angle !== undefined ? val.angle : initialVal.angle
|
|
});
|
|
|
|
cancelAnimationFrame(id);
|
|
delete sigma.misc.animation.running[id];
|
|
|
|
// Check callbacks:
|
|
if (typeof o.onComplete === 'function')
|
|
o.onComplete();
|
|
|
|
// Else, let's keep going:
|
|
} else {
|
|
coef = easing(t);
|
|
camera.isAnimated = true;
|
|
camera.goTo({
|
|
x: val.x !== undefined ?
|
|
initialVal.x + (val.x - initialVal.x) * coef :
|
|
initialVal.x,
|
|
y: val.y !== undefined ?
|
|
initialVal.y + (val.y - initialVal.y) * coef :
|
|
initialVal.y,
|
|
ratio: val.ratio !== undefined ?
|
|
initialVal.ratio + (val.ratio - initialVal.ratio) * coef :
|
|
initialVal.ratio,
|
|
angle: val.angle !== undefined ?
|
|
initialVal.angle + (val.angle - initialVal.angle) * coef :
|
|
initialVal.angle
|
|
});
|
|
|
|
// Check callbacks:
|
|
if (typeof o.onNewFrame === 'function')
|
|
o.onNewFrame();
|
|
|
|
anim.frameId = requestAnimationFrame(fn);
|
|
}
|
|
};
|
|
|
|
id = _getID();
|
|
anim = {
|
|
frameId: requestAnimationFrame(fn),
|
|
target: camera,
|
|
type: 'camera',
|
|
options: o,
|
|
fn: fn
|
|
};
|
|
sigma.misc.animation.running[id] = anim;
|
|
|
|
return id;
|
|
};
|
|
|
|
/**
|
|
* Kills a running animation. It triggers the eventual onComplete callback.
|
|
*
|
|
* @param {number} id The id of the animation to kill.
|
|
* @return {object} Returns the sigma.misc.animation package.
|
|
*/
|
|
sigma.misc.animation.kill = function(id) {
|
|
if (arguments.length !== 1 || typeof id !== 'number')
|
|
throw 'animation.kill: Wrong arguments.';
|
|
|
|
var o = sigma.misc.animation.running[id];
|
|
|
|
if (o) {
|
|
cancelAnimationFrame(id);
|
|
delete sigma.misc.animation.running[o.frameId];
|
|
|
|
if (o.type === 'camera')
|
|
o.target.isAnimated = false;
|
|
|
|
// Check callbacks:
|
|
if (typeof (o.options || {}).onComplete === 'function')
|
|
o.options.onComplete();
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Kills every running animations, or only the one with the specified type,
|
|
* if a string parameter is given.
|
|
*
|
|
* @param {?(string|object)} filter A string to filter the animations to kill
|
|
* on their type (example: "camera"), or an
|
|
* object to filter on their target.
|
|
* @return {number} Returns the number of animations killed
|
|
* that way.
|
|
*/
|
|
sigma.misc.animation.killAll = function(filter) {
|
|
var o,
|
|
id,
|
|
count = 0,
|
|
type = typeof filter === 'string' ? filter : null,
|
|
target = typeof filter === 'object' ? filter : null,
|
|
running = sigma.misc.animation.running;
|
|
|
|
for (id in running)
|
|
if (
|
|
(!type || running[id].type === type) &&
|
|
(!target || running[id].target === target)
|
|
) {
|
|
o = sigma.misc.animation.running[id];
|
|
cancelAnimationFrame(o.frameId);
|
|
delete sigma.misc.animation.running[id];
|
|
|
|
if (o.type === 'camera')
|
|
o.target.isAnimated = false;
|
|
|
|
// Increment counter:
|
|
count++;
|
|
|
|
// Check callbacks:
|
|
if (typeof (o.options || {}).onComplete === 'function')
|
|
o.options.onComplete();
|
|
}
|
|
|
|
return count;
|
|
};
|
|
|
|
/**
|
|
* Returns "true" if any animation that is currently still running matches
|
|
* the filter given to the function.
|
|
*
|
|
* @param {string|object} filter A string to filter the animations to kill
|
|
* on their type (example: "camera"), or an
|
|
* object to filter on their target.
|
|
* @return {boolean} Returns true if any running animation
|
|
* matches.
|
|
*/
|
|
sigma.misc.animation.has = function(filter) {
|
|
var id,
|
|
type = typeof filter === 'string' ? filter : null,
|
|
target = typeof filter === 'object' ? filter : null,
|
|
running = sigma.misc.animation.running;
|
|
|
|
for (id in running)
|
|
if (
|
|
(!type || running[id].type === type) &&
|
|
(!target || running[id].target === target)
|
|
)
|
|
return true;
|
|
|
|
return false;
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.misc');
|
|
|
|
/**
|
|
* This helper will bind any no-DOM renderer (for instance canvas or WebGL)
|
|
* to its captors, to properly dispatch the good events to the sigma instance
|
|
* to manage clicking, hovering etc...
|
|
*
|
|
* It has to be called in the scope of the related renderer.
|
|
*/
|
|
sigma.misc.bindEvents = function(prefix) {
|
|
var i,
|
|
l,
|
|
mX,
|
|
mY,
|
|
captor,
|
|
self = this;
|
|
|
|
function getNodes(e) {
|
|
if (e) {
|
|
mX = 'x' in e.data ? e.data.x : mX;
|
|
mY = 'y' in e.data ? e.data.y : mY;
|
|
}
|
|
|
|
var i,
|
|
j,
|
|
l,
|
|
n,
|
|
x,
|
|
y,
|
|
s,
|
|
inserted,
|
|
selected = [],
|
|
modifiedX = mX + self.width / 2,
|
|
modifiedY = mY + self.height / 2,
|
|
point = self.camera.cameraPosition(
|
|
mX,
|
|
mY
|
|
),
|
|
nodes = self.camera.quadtree.point(
|
|
point.x,
|
|
point.y
|
|
);
|
|
|
|
if (nodes.length)
|
|
for (i = 0, l = nodes.length; i < l; i++) {
|
|
n = nodes[i];
|
|
x = n[prefix + 'x'];
|
|
y = n[prefix + 'y'];
|
|
s = n[prefix + 'size'];
|
|
|
|
if (
|
|
!n.hidden &&
|
|
modifiedX > x - s &&
|
|
modifiedX < x + s &&
|
|
modifiedY > y - s &&
|
|
modifiedY < y + s &&
|
|
Math.sqrt(
|
|
Math.pow(modifiedX - x, 2) +
|
|
Math.pow(modifiedY - y, 2)
|
|
) < s
|
|
) {
|
|
// Insert the node:
|
|
inserted = false;
|
|
|
|
for (j = 0; j < selected.length; j++)
|
|
if (n.size > selected[j].size) {
|
|
selected.splice(j, 0, n);
|
|
inserted = true;
|
|
break;
|
|
}
|
|
|
|
if (!inserted)
|
|
selected.push(n);
|
|
}
|
|
}
|
|
|
|
return selected;
|
|
}
|
|
|
|
|
|
function getEdges(e) {
|
|
if (!self.settings('enableEdgeHovering')) {
|
|
// No event if the setting is off:
|
|
return [];
|
|
}
|
|
|
|
var isCanvas = (
|
|
sigma.renderers.canvas && self instanceof sigma.renderers.canvas);
|
|
|
|
if (!isCanvas) {
|
|
// A quick hardcoded rule to prevent people from using this feature
|
|
// with the WebGL renderer (which is not good enough at the moment):
|
|
throw new Error(
|
|
'The edge events feature is not compatible with the WebGL renderer'
|
|
);
|
|
}
|
|
|
|
if (e) {
|
|
mX = 'x' in e.data ? e.data.x : mX;
|
|
mY = 'y' in e.data ? e.data.y : mY;
|
|
}
|
|
|
|
var i,
|
|
j,
|
|
l,
|
|
a,
|
|
edge,
|
|
s,
|
|
maxEpsilon = self.settings('edgeHoverPrecision'),
|
|
source,
|
|
target,
|
|
cp,
|
|
nodeIndex = {},
|
|
inserted,
|
|
selected = [],
|
|
modifiedX = mX + self.width / 2,
|
|
modifiedY = mY + self.height / 2,
|
|
point = self.camera.cameraPosition(
|
|
mX,
|
|
mY
|
|
),
|
|
edges = [];
|
|
|
|
if (isCanvas) {
|
|
var nodesOnScreen = self.camera.quadtree.area(
|
|
self.camera.getRectangle(self.width, self.height)
|
|
);
|
|
for (a = nodesOnScreen, i = 0, l = a.length; i < l; i++)
|
|
nodeIndex[a[i].id] = a[i];
|
|
}
|
|
|
|
if (self.camera.edgequadtree !== undefined) {
|
|
edges = self.camera.edgequadtree.point(
|
|
point.x,
|
|
point.y
|
|
);
|
|
}
|
|
|
|
function insertEdge(selected, edge) {
|
|
inserted = false;
|
|
|
|
for (j = 0; j < selected.length; j++)
|
|
if (edge.size > selected[j].size) {
|
|
selected.splice(j, 0, edge);
|
|
inserted = true;
|
|
break;
|
|
}
|
|
|
|
if (!inserted)
|
|
selected.push(edge);
|
|
}
|
|
|
|
if (edges.length)
|
|
for (i = 0, l = edges.length; i < l; i++) {
|
|
edge = edges[i];
|
|
source = self.graph.nodes(edge.source);
|
|
target = self.graph.nodes(edge.target);
|
|
// (HACK) we can't get edge[prefix + 'size'] on WebGL renderer:
|
|
s = edge[prefix + 'size'] ||
|
|
edge['read_' + prefix + 'size'];
|
|
|
|
// First, let's identify which edges are drawn. To do this, we keep
|
|
// every edges that have at least one extremity displayed according to
|
|
// the quadtree and the "hidden" attribute. We also do not keep hidden
|
|
// edges.
|
|
// Then, let's check if the mouse is on the edge (we suppose that it
|
|
// is a line segment).
|
|
|
|
if (
|
|
!edge.hidden &&
|
|
!source.hidden && !target.hidden &&
|
|
(!isCanvas ||
|
|
(nodeIndex[edge.source] || nodeIndex[edge.target])) &&
|
|
sigma.utils.getDistance(
|
|
source[prefix + 'x'],
|
|
source[prefix + 'y'],
|
|
modifiedX,
|
|
modifiedY) > source[prefix + 'size'] &&
|
|
sigma.utils.getDistance(
|
|
target[prefix + 'x'],
|
|
target[prefix + 'y'],
|
|
modifiedX,
|
|
modifiedY) > target[prefix + 'size']
|
|
) {
|
|
if (edge.type == 'curve' || edge.type == 'curvedArrow') {
|
|
if (source.id === target.id) {
|
|
cp = sigma.utils.getSelfLoopControlPoints(
|
|
source[prefix + 'x'],
|
|
source[prefix + 'y'],
|
|
source[prefix + 'size']
|
|
);
|
|
if (
|
|
sigma.utils.isPointOnBezierCurve(
|
|
modifiedX,
|
|
modifiedY,
|
|
source[prefix + 'x'],
|
|
source[prefix + 'y'],
|
|
target[prefix + 'x'],
|
|
target[prefix + 'y'],
|
|
cp.x1,
|
|
cp.y1,
|
|
cp.x2,
|
|
cp.y2,
|
|
Math.max(s, maxEpsilon)
|
|
)) {
|
|
insertEdge(selected, edge);
|
|
}
|
|
}
|
|
else {
|
|
cp = sigma.utils.getQuadraticControlPoint(
|
|
source[prefix + 'x'],
|
|
source[prefix + 'y'],
|
|
target[prefix + 'x'],
|
|
target[prefix + 'y']);
|
|
if (
|
|
sigma.utils.isPointOnQuadraticCurve(
|
|
modifiedX,
|
|
modifiedY,
|
|
source[prefix + 'x'],
|
|
source[prefix + 'y'],
|
|
target[prefix + 'x'],
|
|
target[prefix + 'y'],
|
|
cp.x,
|
|
cp.y,
|
|
Math.max(s, maxEpsilon)
|
|
)) {
|
|
insertEdge(selected, edge);
|
|
}
|
|
}
|
|
} else if (
|
|
sigma.utils.isPointOnSegment(
|
|
modifiedX,
|
|
modifiedY,
|
|
source[prefix + 'x'],
|
|
source[prefix + 'y'],
|
|
target[prefix + 'x'],
|
|
target[prefix + 'y'],
|
|
Math.max(s, maxEpsilon)
|
|
)) {
|
|
insertEdge(selected, edge);
|
|
}
|
|
}
|
|
}
|
|
|
|
return selected;
|
|
}
|
|
|
|
|
|
function bindCaptor(captor) {
|
|
var nodes,
|
|
edges,
|
|
overNodes = {},
|
|
overEdges = {};
|
|
|
|
function onClick(e) {
|
|
if (!self.settings('eventsEnabled'))
|
|
return;
|
|
|
|
self.dispatchEvent('click', e.data);
|
|
|
|
nodes = getNodes(e);
|
|
edges = getEdges(e);
|
|
|
|
if (nodes.length) {
|
|
self.dispatchEvent('clickNode', {
|
|
node: nodes[0],
|
|
captor: e.data
|
|
});
|
|
self.dispatchEvent('clickNodes', {
|
|
node: nodes,
|
|
captor: e.data
|
|
});
|
|
} else if (edges.length) {
|
|
self.dispatchEvent('clickEdge', {
|
|
edge: edges[0],
|
|
captor: e.data
|
|
});
|
|
self.dispatchEvent('clickEdges', {
|
|
edge: edges,
|
|
captor: e.data
|
|
});
|
|
} else
|
|
self.dispatchEvent('clickStage', {captor: e.data});
|
|
}
|
|
|
|
function onDoubleClick(e) {
|
|
if (!self.settings('eventsEnabled'))
|
|
return;
|
|
|
|
self.dispatchEvent('doubleClick', e.data);
|
|
|
|
nodes = getNodes(e);
|
|
edges = getEdges(e);
|
|
|
|
if (nodes.length) {
|
|
self.dispatchEvent('doubleClickNode', {
|
|
node: nodes[0],
|
|
captor: e.data
|
|
});
|
|
self.dispatchEvent('doubleClickNodes', {
|
|
node: nodes,
|
|
captor: e.data
|
|
});
|
|
} else if (edges.length) {
|
|
self.dispatchEvent('doubleClickEdge', {
|
|
edge: edges[0],
|
|
captor: e.data
|
|
});
|
|
self.dispatchEvent('doubleClickEdges', {
|
|
edge: edges,
|
|
captor: e.data
|
|
});
|
|
} else
|
|
self.dispatchEvent('doubleClickStage', {captor: e.data});
|
|
}
|
|
|
|
function onRightClick(e) {
|
|
if (!self.settings('eventsEnabled'))
|
|
return;
|
|
|
|
self.dispatchEvent('rightClick', e.data);
|
|
|
|
nodes = getNodes(e);
|
|
edges = getEdges(e);
|
|
|
|
if (nodes.length) {
|
|
self.dispatchEvent('rightClickNode', {
|
|
node: nodes[0],
|
|
captor: e.data
|
|
});
|
|
self.dispatchEvent('rightClickNodes', {
|
|
node: nodes,
|
|
captor: e.data
|
|
});
|
|
} else if (edges.length) {
|
|
self.dispatchEvent('rightClickEdge', {
|
|
edge: edges[0],
|
|
captor: e.data
|
|
});
|
|
self.dispatchEvent('rightClickEdges', {
|
|
edge: edges,
|
|
captor: e.data
|
|
});
|
|
} else
|
|
self.dispatchEvent('rightClickStage', {captor: e.data});
|
|
}
|
|
|
|
function onOut(e) {
|
|
if (!self.settings('eventsEnabled'))
|
|
return;
|
|
|
|
var k,
|
|
i,
|
|
l,
|
|
le,
|
|
outNodes = [],
|
|
outEdges = [];
|
|
|
|
for (k in overNodes)
|
|
outNodes.push(overNodes[k]);
|
|
|
|
overNodes = {};
|
|
// Dispatch both single and multi events:
|
|
for (i = 0, l = outNodes.length; i < l; i++)
|
|
self.dispatchEvent('outNode', {
|
|
node: outNodes[i],
|
|
captor: e.data
|
|
});
|
|
if (outNodes.length)
|
|
self.dispatchEvent('outNodes', {
|
|
nodes: outNodes,
|
|
captor: e.data
|
|
});
|
|
|
|
overEdges = {};
|
|
// Dispatch both single and multi events:
|
|
for (i = 0, le = outEdges.length; i < le; i++)
|
|
self.dispatchEvent('outEdge', {
|
|
edge: outEdges[i],
|
|
captor: e.data
|
|
});
|
|
if (outEdges.length)
|
|
self.dispatchEvent('outEdges', {
|
|
edges: outEdges,
|
|
captor: e.data
|
|
});
|
|
}
|
|
|
|
function onMove(e) {
|
|
if (!self.settings('eventsEnabled'))
|
|
return;
|
|
|
|
nodes = getNodes(e);
|
|
edges = getEdges(e);
|
|
|
|
var i,
|
|
k,
|
|
node,
|
|
edge,
|
|
newOutNodes = [],
|
|
newOverNodes = [],
|
|
currentOverNodes = {},
|
|
l = nodes.length,
|
|
newOutEdges = [],
|
|
newOverEdges = [],
|
|
currentOverEdges = {},
|
|
le = edges.length;
|
|
|
|
// Check newly overred nodes:
|
|
for (i = 0; i < l; i++) {
|
|
node = nodes[i];
|
|
currentOverNodes[node.id] = node;
|
|
if (!overNodes[node.id]) {
|
|
newOverNodes.push(node);
|
|
overNodes[node.id] = node;
|
|
}
|
|
}
|
|
|
|
// Check no more overred nodes:
|
|
for (k in overNodes)
|
|
if (!currentOverNodes[k]) {
|
|
newOutNodes.push(overNodes[k]);
|
|
delete overNodes[k];
|
|
}
|
|
|
|
// Dispatch both single and multi events:
|
|
for (i = 0, l = newOverNodes.length; i < l; i++)
|
|
self.dispatchEvent('overNode', {
|
|
node: newOverNodes[i],
|
|
captor: e.data
|
|
});
|
|
for (i = 0, l = newOutNodes.length; i < l; i++)
|
|
self.dispatchEvent('outNode', {
|
|
node: newOutNodes[i],
|
|
captor: e.data
|
|
});
|
|
if (newOverNodes.length)
|
|
self.dispatchEvent('overNodes', {
|
|
nodes: newOverNodes,
|
|
captor: e.data
|
|
});
|
|
if (newOutNodes.length)
|
|
self.dispatchEvent('outNodes', {
|
|
nodes: newOutNodes,
|
|
captor: e.data
|
|
});
|
|
|
|
// Check newly overred edges:
|
|
for (i = 0; i < le; i++) {
|
|
edge = edges[i];
|
|
currentOverEdges[edge.id] = edge;
|
|
if (!overEdges[edge.id]) {
|
|
newOverEdges.push(edge);
|
|
overEdges[edge.id] = edge;
|
|
}
|
|
}
|
|
|
|
// Check no more overred edges:
|
|
for (k in overEdges)
|
|
if (!currentOverEdges[k]) {
|
|
newOutEdges.push(overEdges[k]);
|
|
delete overEdges[k];
|
|
}
|
|
|
|
// Dispatch both single and multi events:
|
|
for (i = 0, le = newOverEdges.length; i < le; i++)
|
|
self.dispatchEvent('overEdge', {
|
|
edge: newOverEdges[i],
|
|
captor: e.data
|
|
});
|
|
for (i = 0, le = newOutEdges.length; i < le; i++)
|
|
self.dispatchEvent('outEdge', {
|
|
edge: newOutEdges[i],
|
|
captor: e.data
|
|
});
|
|
if (newOverEdges.length)
|
|
self.dispatchEvent('overEdges', {
|
|
edges: newOverEdges,
|
|
captor: e.data
|
|
});
|
|
if (newOutEdges.length)
|
|
self.dispatchEvent('outEdges', {
|
|
edges: newOutEdges,
|
|
captor: e.data
|
|
});
|
|
}
|
|
|
|
// Bind events:
|
|
captor.bind('click', onClick);
|
|
captor.bind('mousedown', onMove);
|
|
captor.bind('mouseup', onMove);
|
|
captor.bind('mousemove', onMove);
|
|
captor.bind('mouseout', onOut);
|
|
captor.bind('doubleclick', onDoubleClick);
|
|
captor.bind('rightclick', onRightClick);
|
|
self.bind('render', onMove);
|
|
}
|
|
|
|
for (i = 0, l = this.captors.length; i < l; i++)
|
|
bindCaptor(this.captors[i]);
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.misc');
|
|
|
|
/**
|
|
* This helper will bind any DOM renderer (for instance svg)
|
|
* to its captors, to properly dispatch the good events to the sigma instance
|
|
* to manage clicking, hovering etc...
|
|
*
|
|
* It has to be called in the scope of the related renderer.
|
|
*/
|
|
sigma.misc.bindDOMEvents = function(container) {
|
|
var self = this,
|
|
graph = this.graph;
|
|
|
|
// DOMElement abstraction
|
|
function Element(domElement) {
|
|
|
|
// Helpers
|
|
this.attr = function(attrName) {
|
|
return domElement.getAttributeNS(null, attrName);
|
|
};
|
|
|
|
// Properties
|
|
this.tag = domElement.tagName;
|
|
this.class = this.attr('class');
|
|
this.id = this.attr('id');
|
|
|
|
// Methods
|
|
this.isNode = function() {
|
|
return !!~this.class.indexOf(self.settings('classPrefix') + '-node');
|
|
};
|
|
|
|
this.isEdge = function() {
|
|
return !!~this.class.indexOf(self.settings('classPrefix') + '-edge');
|
|
};
|
|
|
|
this.isHover = function() {
|
|
return !!~this.class.indexOf(self.settings('classPrefix') + '-hover');
|
|
};
|
|
}
|
|
|
|
// Click
|
|
function click(e) {
|
|
if (!self.settings('eventsEnabled'))
|
|
return;
|
|
|
|
// Generic event
|
|
self.dispatchEvent('click', e);
|
|
|
|
// Are we on a node?
|
|
var element = new Element(e.target);
|
|
|
|
if (element.isNode())
|
|
self.dispatchEvent('clickNode', {
|
|
node: graph.nodes(element.attr('data-node-id'))
|
|
});
|
|
else
|
|
self.dispatchEvent('clickStage');
|
|
|
|
e.preventDefault();
|
|
e.stopPropagation();
|
|
}
|
|
|
|
// Double click
|
|
function doubleClick(e) {
|
|
if (!self.settings('eventsEnabled'))
|
|
return;
|
|
|
|
// Generic event
|
|
self.dispatchEvent('doubleClick', e);
|
|
|
|
// Are we on a node?
|
|
var element = new Element(e.target);
|
|
|
|
if (element.isNode())
|
|
self.dispatchEvent('doubleClickNode', {
|
|
node: graph.nodes(element.attr('data-node-id'))
|
|
});
|
|
else
|
|
self.dispatchEvent('doubleClickStage');
|
|
|
|
e.preventDefault();
|
|
e.stopPropagation();
|
|
}
|
|
|
|
// On over
|
|
function onOver(e) {
|
|
var target = e.toElement || e.target;
|
|
|
|
if (!self.settings('eventsEnabled') || !target)
|
|
return;
|
|
|
|
var el = new Element(target);
|
|
|
|
if (el.isNode()) {
|
|
self.dispatchEvent('overNode', {
|
|
node: graph.nodes(el.attr('data-node-id'))
|
|
});
|
|
}
|
|
else if (el.isEdge()) {
|
|
var edge = graph.edges(el.attr('data-edge-id'));
|
|
self.dispatchEvent('overEdge', {
|
|
edge: edge,
|
|
source: graph.nodes(edge.source),
|
|
target: graph.nodes(edge.target)
|
|
});
|
|
}
|
|
}
|
|
|
|
// On out
|
|
function onOut(e) {
|
|
var target = e.fromElement || e.originalTarget;
|
|
|
|
if (!self.settings('eventsEnabled'))
|
|
return;
|
|
|
|
var el = new Element(target);
|
|
|
|
if (el.isNode()) {
|
|
self.dispatchEvent('outNode', {
|
|
node: graph.nodes(el.attr('data-node-id'))
|
|
});
|
|
}
|
|
else if (el.isEdge()) {
|
|
var edge = graph.edges(el.attr('data-edge-id'));
|
|
self.dispatchEvent('outEdge', {
|
|
edge: edge,
|
|
source: graph.nodes(edge.source),
|
|
target: graph.nodes(edge.target)
|
|
});
|
|
}
|
|
}
|
|
|
|
// Registering Events:
|
|
|
|
// Click
|
|
container.addEventListener('click', click, false);
|
|
sigma.utils.doubleClick(container, 'click', doubleClick);
|
|
|
|
// Touch counterparts
|
|
container.addEventListener('touchstart', click, false);
|
|
sigma.utils.doubleClick(container, 'touchstart', doubleClick);
|
|
|
|
// Mouseover
|
|
container.addEventListener('mouseover', onOver, true);
|
|
|
|
// Mouseout
|
|
container.addEventListener('mouseout', onOut, true);
|
|
};
|
|
}).call(this);
|
|
|
|
;(function(undefined) {
|
|
'use strict';
|
|
|
|
if (typeof sigma === 'undefined')
|
|
throw 'sigma is not declared';
|
|
|
|
// Initialize packages:
|
|
sigma.utils.pkg('sigma.misc');
|
|
|
|
/**
|
|
* This method listens to "overNode", "outNode", "overEdge" and "outEdge"
|
|
* events from a renderer and renders the nodes differently on the top layer.
|
|
* The goal is to make any node label readable with the mouse, and to
|
|
* highlight hovered nodes and edges.
|
|
*
|
|
* It has to be called in the scope of the related renderer.
|
|
*/
|
|
sigma.misc.drawHovers = function(prefix) {
|
|
var self = this,
|
|
hoveredNodes = {},
|
|
hoveredEdges = {};
|
|
|
|
this.bind('overNode', function(event) {
|
|
var node = event.data.node;
|
|
if (!node.hidden) {
|
|
hoveredNodes[node.id] = node;
|
|
draw();
|
|
}
|
|
});
|
|
|
|
this.bind('outNode', function(event) {
|
|
delete hoveredNodes[event.data.node.id];
|
|
draw();
|
|
});
|
|
|
|
this.bind('overEdge', function(event) {
|
|
var edge = event.data.edge;
|
|
if (!edge.hidden) {
|
|
hoveredEdges[edge.id] = edge;
|
|
draw();
|
|
}
|
|
});
|
|
|
|
this.bind('outEdge', function(event) {
|
|
delete hoveredEdges[event.data.edge.id];
|
|
draw();
|
|
});
|
|
|
|
this.bind('render', function(event) {
|
|
draw();
|
|
});
|
|
|
|
function draw() {
|
|
// Clear self.contexts.hover:
|
|
self.contexts.hover.canvas.width = self.contexts.hover.canvas.width;
|
|
|
|
var k,
|
|
source,
|
|
target,
|
|
hoveredNode,
|
|
hoveredEdge,
|
|
defaultNodeType = self.settings('defaultNodeType'),
|
|
defaultEdgeType = self.settings('defaultEdgeType'),
|
|
nodeRenderers = sigma.canvas.hovers,
|
|
edgeRenderers = sigma.canvas.edgehovers,
|
|
extremitiesRenderers = sigma.canvas.extremities,
|
|
embedSettings = self.settings.embedObjects({
|
|
prefix: prefix
|
|
});
|
|
|
|
// Node render: single hover
|
|
if (
|
|
embedSettings('enableHovering') &&
|
|
embedSettings('singleHover') &&
|
|
Object.keys(hoveredNodes).length
|
|
) {
|
|
hoveredNode = hoveredNodes[Object.keys(hoveredNodes)[0]];
|
|
(
|
|
nodeRenderers[hoveredNode.type] ||
|
|
nodeRenderers[defaultNodeType] ||
|
|
nodeRenderers.def
|
|
)(
|
|
hoveredNode,
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
}
|
|
|
|
// Node render: multiple hover
|
|
if (
|
|
embedSettings('enableHovering') &&
|
|
!embedSettings('singleHover')
|
|
)
|
|
for (k in hoveredNodes)
|
|
(
|
|
nodeRenderers[hoveredNodes[k].type] ||
|
|
nodeRenderers[defaultNodeType] ||
|
|
nodeRenderers.def
|
|
)(
|
|
hoveredNodes[k],
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
|
|
// Edge render: single hover
|
|
if (
|
|
embedSettings('enableEdgeHovering') &&
|
|
embedSettings('singleHover') &&
|
|
Object.keys(hoveredEdges).length
|
|
) {
|
|
hoveredEdge = hoveredEdges[Object.keys(hoveredEdges)[0]];
|
|
source = self.graph.nodes(hoveredEdge.source);
|
|
target = self.graph.nodes(hoveredEdge.target);
|
|
|
|
if (! hoveredEdge.hidden) {
|
|
(
|
|
edgeRenderers[hoveredEdge.type] ||
|
|
edgeRenderers[defaultEdgeType] ||
|
|
edgeRenderers.def
|
|
) (
|
|
hoveredEdge,
|
|
source,
|
|
target,
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
|
|
if (embedSettings('edgeHoverExtremities')) {
|
|
(
|
|
extremitiesRenderers[hoveredEdge.type] ||
|
|
extremitiesRenderers.def
|
|
)(
|
|
hoveredEdge,
|
|
source,
|
|
target,
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
|
|
} else {
|
|
// Avoid edges rendered over nodes:
|
|
(
|
|
sigma.canvas.nodes[source.type] ||
|
|
sigma.canvas.nodes.def
|
|
) (
|
|
source,
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
(
|
|
sigma.canvas.nodes[target.type] ||
|
|
sigma.canvas.nodes.def
|
|
) (
|
|
target,
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Edge render: multiple hover
|
|
if (
|
|
embedSettings('enableEdgeHovering') &&
|
|
!embedSettings('singleHover')
|
|
) {
|
|
for (k in hoveredEdges) {
|
|
hoveredEdge = hoveredEdges[k];
|
|
source = self.graph.nodes(hoveredEdge.source);
|
|
target = self.graph.nodes(hoveredEdge.target);
|
|
|
|
if (!hoveredEdge.hidden) {
|
|
(
|
|
edgeRenderers[hoveredEdge.type] ||
|
|
edgeRenderers[defaultEdgeType] ||
|
|
edgeRenderers.def
|
|
) (
|
|
hoveredEdge,
|
|
source,
|
|
target,
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
|
|
if (embedSettings('edgeHoverExtremities')) {
|
|
(
|
|
extremitiesRenderers[hoveredEdge.type] ||
|
|
extremitiesRenderers.def
|
|
)(
|
|
hoveredEdge,
|
|
source,
|
|
target,
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
} else {
|
|
// Avoid edges rendered over nodes:
|
|
(
|
|
sigma.canvas.nodes[source.type] ||
|
|
sigma.canvas.nodes.def
|
|
) (
|
|
source,
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
(
|
|
sigma.canvas.nodes[target.type] ||
|
|
sigma.canvas.nodes.def
|
|
) (
|
|
target,
|
|
self.contexts.hover,
|
|
embedSettings
|
|
);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
};
|
|
}).call(this);
|