// FIXME bulk feature upload - suppress events // FIXME put features in an ol.Collection // FIXME make change-detection more refined (notably, geometry hint) goog.provide('ol.source.Vector'); goog.provide('ol.source.VectorEvent'); goog.provide('ol.source.VectorEventType'); goog.require('goog.array'); goog.require('goog.asserts'); goog.require('goog.events'); goog.require('goog.events.Event'); goog.require('goog.events.EventType'); goog.require('goog.object'); goog.require('ol.source.Source'); goog.require('ol.structs.RBush'); /** * @enum {string} */ ol.source.VectorEventType = { ADDFEATURE: 'addfeature', REMOVEFEATURE: 'removefeature' }; /** * @constructor * @extends {ol.source.Source} * @param {olx.source.VectorOptions=} opt_options Vector source options. * @todo stability experimental */ ol.source.Vector = function(opt_options) { var options = goog.isDef(opt_options) ? opt_options : {}; goog.base(this, { attributions: options.attributions, extent: options.extent, logo: options.logo, projection: options.projection, state: options.state }); /** * @private * @type {ol.structs.RBush.} */ this.rBush_ = new ol.structs.RBush(); /** * @private * @type {Object.} */ this.nullGeometryFeatures_ = {}; /** * @private * @type {Object.} */ this.featureChangeKeys_ = {}; if (goog.isDef(options.features)) { this.addFeaturesInternal(options.features); } }; goog.inherits(ol.source.Vector, ol.source.Source); /** * @param {ol.Feature} feature Feature. */ ol.source.Vector.prototype.addFeature = function(feature) { this.addFeatureInternal(feature); this.dispatchChangeEvent(); }; /** * Add a feature without firing a `change` event. * @param {ol.Feature} feature Feature. * @protected */ ol.source.Vector.prototype.addFeatureInternal = function(feature) { var featureKey = goog.getUid(feature) + ''; goog.asserts.assert(!(featureKey in this.featureChangeKeys_)); this.featureChangeKeys_[featureKey] = goog.events.listen(feature, goog.events.EventType.CHANGE, this.handleFeatureChange_, false, this); var geometry = feature.getGeometry(); if (goog.isNull(geometry)) { this.nullGeometryFeatures_[goog.getUid(feature).toString()] = feature; } else { var extent = geometry.getExtent(); this.rBush_.insert(extent, feature); } this.dispatchEvent( new ol.source.VectorEvent(ol.source.VectorEventType.ADDFEATURE, feature)); }; /** * @param {Array.} features Features. */ ol.source.Vector.prototype.addFeatures = function(features) { this.addFeaturesInternal(features); this.dispatchChangeEvent(); }; /** * Add features without firing a `change` event. * @param {Array.} features Features. * @protected */ ol.source.Vector.prototype.addFeaturesInternal = function(features) { // FIXME use R-Bush bulk load when available var i, ii; for (i = 0, ii = features.length; i < ii; ++i) { this.addFeatureInternal(features[i]); } }; /** * FIXME empty description for jsdoc */ ol.source.Vector.prototype.clear = function() { this.rBush_.forEach(this.removeFeatureInternal, this); this.rBush_.clear(); goog.object.forEach( this.nullGeometryFeatures_, this.removeFeatureInternal, this); goog.object.clear(this.nullGeometryFeatures_); goog.asserts.assert(goog.object.isEmpty(this.featureChangeKeys_)); this.dispatchChangeEvent(); }; /** * @param {function(this: T, ol.Feature): S} f Callback. * @param {T=} opt_obj The object to be used as the value of 'this' within f. * @return {S|undefined} * @template T,S */ ol.source.Vector.prototype.forEachFeature = function(f, opt_obj) { return this.rBush_.forEach(f, opt_obj); }; /** * @param {ol.Coordinate} coordinate Coordinate. * @param {function(this: T, ol.Feature): S} f Callback. * @param {T=} opt_obj The object to be used as the value of 'this' within f. * @return {S|undefined} * @template T,S */ ol.source.Vector.prototype.forEachFeatureAtCoordinate = function(coordinate, f, opt_obj) { var extent = [coordinate[0], coordinate[1], coordinate[0], coordinate[1]]; return this.forEachFeatureInExtent(extent, function(feature) { if (feature.getGeometry().containsCoordinate(coordinate)) { return f.call(opt_obj, feature); } else { return undefined; } }); }; /** * @param {ol.Extent} extent Extent. * @param {function(this: T, ol.Feature): S} f Callback. * @param {T=} opt_obj The object to be used as the value of 'this' within f. * @return {S|undefined} * @template T,S */ ol.source.Vector.prototype.forEachFeatureInExtent = function(extent, f, opt_obj) { return this.rBush_.forEachInExtent(extent, f, opt_obj); }; /** * @return {Array.} Features. */ ol.source.Vector.prototype.getAllFeatures = function() { var features = this.rBush_.getAll(); if (!goog.object.isEmpty(this.nullGeometryFeatures_)) { goog.array.extend( features, goog.object.getValues(this.nullGeometryFeatures_)); } return features; }; /** * @param {ol.Coordinate} coordinate Coordinate. * @return {Array.} Features. */ ol.source.Vector.prototype.getAllFeaturesAtCoordinate = function(coordinate) { var features = []; this.forEachFeatureAtCoordinate(coordinate, function(feature) { features.push(feature); }); return features; }; /** * @param {ol.Extent} extent Extent. * @return {Array.} Features. */ ol.source.Vector.prototype.getAllFeaturesInExtent = function(extent) { return this.rBush_.getAllInExtent(extent); }; /** * @param {ol.Coordinate} coordinate Coordinate. * @return {ol.Feature} Closest feature. */ ol.source.Vector.prototype.getClosestFeatureToCoordinate = function(coordinate) { // Find the closest feature using branch and bound. We start searching an // infinite extent, and find the distance from the first feature found. This // becomes the closest feature. We then compute a smaller extent which any // closer feature must intersect. We continue searching with this smaller // extent, trying to find a closer feature. Every time we find a closer // feature, we update the extent being searched so that any even closer // feature must intersect it. We continue until we run out of features. var x = coordinate[0]; var y = coordinate[1]; var closestFeature = null; var closestPoint = [NaN, NaN]; var minSquaredDistance = Infinity; var extent = [-Infinity, -Infinity, Infinity, Infinity]; this.rBush_.forEachInExtent(extent, /** * @param {ol.Feature} feature Feature. */ function(feature) { var geometry = feature.getGeometry(); goog.asserts.assert(!goog.isNull(geometry)); var previousMinSquaredDistance = minSquaredDistance; minSquaredDistance = geometry.closestPointXY( x, y, closestPoint, minSquaredDistance); if (minSquaredDistance < previousMinSquaredDistance) { closestFeature = feature; // This is sneaky. Reduce the extent that it is currently being // searched while the R-Tree traversal using this same extent object // is still in progress. This is safe because the new extent is // strictly contained by the old extent. var minDistance = Math.sqrt(minSquaredDistance); extent[0] = x - minDistance; extent[1] = y - minDistance; extent[2] = x + minDistance; extent[3] = y + minDistance; } }); return closestFeature; }; /** * @return {ol.Extent} Extent. */ ol.source.Vector.prototype.getExtent = function() { return this.rBush_.getExtent(); }; /** * @param {goog.events.Event} event Event. * @private */ ol.source.Vector.prototype.handleFeatureChange_ = function(event) { var feature = /** @type {ol.Feature} */ (event.target); this.rBush_.update(feature.getGeometry().getExtent(), feature); this.dispatchChangeEvent(); }; /** * @return {boolean} Is empty. */ ol.source.Vector.prototype.isEmpty = function() { return this.rBush_.isEmpty() && goog.object.isEmpty(this.nullGeometryFeatures_); }; /** * @param {ol.Feature} feature Feature. */ ol.source.Vector.prototype.removeFeature = function(feature) { var featureKey = goog.getUid(feature).toString(); if (featureKey in this.nullGeometryFeatures_) { delete this.nullGeometryFeatures_[featureKey]; } else { this.rBush_.remove(feature); } this.removeFeatureInternal(feature); this.dispatchChangeEvent(); }; /** * Remove feature without firing a `change` event. * @param {ol.Feature} feature Feature. * @protected */ ol.source.Vector.prototype.removeFeatureInternal = function(feature) { var featureKey = goog.getUid(feature) + ''; goog.asserts.assert(featureKey in this.featureChangeKeys_); goog.events.unlistenByKey(this.featureChangeKeys_[featureKey]); delete this.featureChangeKeys_[featureKey]; this.dispatchEvent(new ol.source.VectorEvent( ol.source.VectorEventType.REMOVEFEATURE, feature)); }; /** * @constructor * @extends {goog.events.Event} * @param {string} type Type. * @param {ol.Feature=} opt_feature Feature. */ ol.source.VectorEvent = function(type, opt_feature) { goog.base(this, type); /** * @private * @type {ol.Feature|undefined} */ this.feature_ = opt_feature; }; goog.inherits(ol.source.VectorEvent, goog.events.Event); /** * @return {ol.Feature|undefined} Feature. */ ol.source.VectorEvent.prototype.getFeature = function() { return this.feature_; };