goog.provide('ol.renderer.Layer'); goog.require('goog.events'); goog.require('goog.events.EventType'); goog.require('ol.Attribution'); goog.require('ol.Coordinate'); goog.require('ol.FrameState'); goog.require('ol.Image'); goog.require('ol.ImageState'); goog.require('ol.Object'); goog.require('ol.Tile'); goog.require('ol.TileRange'); goog.require('ol.TileState'); goog.require('ol.layer.Layer'); goog.require('ol.layer.LayerProperty'); goog.require('ol.layer.LayerState'); goog.require('ol.source.TileSource'); /** * @constructor * @extends {ol.Object} * @param {ol.renderer.Map} mapRenderer Map renderer. * @param {ol.layer.Layer} layer Layer. */ ol.renderer.Layer = function(mapRenderer, layer) { goog.base(this); /** * @private * @type {ol.renderer.Map} */ this.mapRenderer_ = mapRenderer; /** * @private * @type {ol.layer.Layer} */ this.layer_ = layer; goog.events.listen(this.layer_, ol.Object.getChangedEventType(ol.layer.LayerProperty.BRIGHTNESS), this.handleLayerBrightnessChange, false, this); goog.events.listen(this.layer_, ol.Object.getChangedEventType(ol.layer.LayerProperty.CONTRAST), this.handleLayerContrastChange, false, this); goog.events.listen(this.layer_, ol.Object.getChangedEventType(ol.layer.LayerProperty.HUE), this.handleLayerHueChange, false, this); goog.events.listen(this.layer_, goog.events.EventType.LOAD, this.handleLayerLoad, false, this); goog.events.listen(this.layer_, ol.Object.getChangedEventType(ol.layer.LayerProperty.OPACITY), this.handleLayerOpacityChange, false, this); goog.events.listen(this.layer_, ol.Object.getChangedEventType(ol.layer.LayerProperty.SATURATION), this.handleLayerSaturationChange, false, this); goog.events.listen(this.layer_, ol.Object.getChangedEventType(ol.layer.LayerProperty.VISIBLE), this.handleLayerVisibleChange, false, this); }; goog.inherits(ol.renderer.Layer, ol.Object); /** * @protected */ ol.renderer.Layer.prototype.dispatchChangeEvent = function() { this.dispatchEvent(goog.events.EventType.CHANGE); }; /** * @return {ol.layer.Layer} Layer. */ ol.renderer.Layer.prototype.getLayer = function() { return this.layer_; }; /** * @return {ol.Map} Map. */ ol.renderer.Layer.prototype.getMap = function() { return this.mapRenderer_.getMap(); }; /** * @return {ol.renderer.Map} Map renderer. */ ol.renderer.Layer.prototype.getMapRenderer = function() { return this.mapRenderer_; }; /** * @protected */ ol.renderer.Layer.prototype.handleLayerBrightnessChange = goog.nullFunction; /** * @protected */ ol.renderer.Layer.prototype.handleLayerContrastChange = goog.nullFunction; /** * @protected */ ol.renderer.Layer.prototype.handleLayerHueChange = goog.nullFunction; /** * Handle changes in image state. * @param {goog.events.Event} event Image change event. * @protected */ ol.renderer.Layer.prototype.handleImageChange = function(event) { var image = /** @type {ol.Image} */ (event.target); if (image.getState() === ol.ImageState.LOADED) { this.getMap().requestRenderFrame(); } }; /** * @protected */ ol.renderer.Layer.prototype.handleLayerLoad = function() { this.dispatchChangeEvent(); }; /** * @protected */ ol.renderer.Layer.prototype.handleLayerOpacityChange = function() { this.dispatchChangeEvent(); }; /** * @protected */ ol.renderer.Layer.prototype.handleLayerSaturationChange = goog.nullFunction; /** * @protected */ ol.renderer.Layer.prototype.handleLayerVisibleChange = function() { this.dispatchChangeEvent(); }; /** * Handle changes in tile state. * @param {goog.events.Event} event Tile change event. * @private */ ol.renderer.Layer.prototype.handleTileChange_ = function(event) { var tile = /** @type {ol.Tile} */ (event.target); if (tile.getState() === ol.TileState.LOADED) { this.getMap().requestRenderFrame(); } }; /** * @param {ol.FrameState} frameState Frame state. * @param {ol.layer.LayerState} layerState Layer state. */ ol.renderer.Layer.prototype.renderFrame = goog.abstractMethod; /** * @protected * @param {ol.FrameState} frameState Frame state. * @param {ol.source.TileSource} tileSource Tile source. */ ol.renderer.Layer.prototype.scheduleExpireCache = function(frameState, tileSource) { if (tileSource.canExpireCache()) { frameState.postRenderFunctions.push( goog.partial(function(tileSource, map, frameState) { var tileSourceKey = goog.getUid(tileSource).toString(); tileSource.expireCache(frameState.usedTiles[tileSourceKey]); }, tileSource)); } }; /** * @protected * @param {Object.} attributionsSet Attributions * set (target). * @param {Array.} attributions Attributions (source). */ ol.renderer.Layer.prototype.updateAttributions = function(attributionsSet, attributions) { if (goog.isDefAndNotNull(attributions)) { var i; var attribution; for (i = 0; i < attributions.length; ++i) { attribution = attributions[i]; attributionsSet[goog.getUid(attribution).toString()] = attribution; } } }; /** * @protected * @param {Object.>} usedTiles Used tiles. * @param {ol.source.TileSource} tileSource Tile source. * @param {number} z Z. * @param {ol.TileRange} tileRange Tile range. */ ol.renderer.Layer.prototype.updateUsedTiles = function(usedTiles, tileSource, z, tileRange) { // FIXME should we use tilesToDrawByZ instead? var tileSourceKey = goog.getUid(tileSource).toString(); var zKey = z.toString(); if (tileSourceKey in usedTiles) { if (zKey in usedTiles[tileSourceKey]) { usedTiles[tileSourceKey][zKey].extend(tileRange); } else { usedTiles[tileSourceKey][zKey] = tileRange; } } else { usedTiles[tileSourceKey] = {}; usedTiles[tileSourceKey][zKey] = tileRange; } }; /** * @param {function(ol.Tile): boolean} isLoadedFunction Function to * determine if the tile is loaded. * @param {ol.source.TileSource} tileSource Tile source. * @param {ol.tilegrid.TileGrid} tileGrid Tile grid. * @param {ol.Projection} projection Projection. * @return {function(number, number, number): ol.Tile} Returns a tile if it is * loaded. */ ol.renderer.Layer.prototype.createGetTileIfLoadedFunction = function(isLoadedFunction, tileSource, tileGrid, projection) { return function(z, x, y) { var tile = tileSource.getTile(z, x, y, tileGrid, projection); return isLoadedFunction(tile) ? tile : null; }; }; /** * @param {ol.Coordinate} center Center. * @param {number} resolution Resolution. * @param {ol.Size} size Size. * @return {ol.Coordinate} Snapped center. * @protected */ ol.renderer.Layer.prototype.snapCenterToPixel = function(center, resolution, size) { return new ol.Coordinate( resolution * (Math.round(center.x / resolution) + (size.width % 2) / 2), resolution * (Math.round(center.y / resolution) + (size.height % 2) / 2)); }; /** * Manage tile pyramid. * This function performs a number of functions related to the tiles at the * current zoom and lower zoom levels: * - registers idle tiles in frameState.wantedTiles so that they are not * discarded by the tile queue * - enqueues missing tiles * @param {ol.FrameState} frameState Frame state. * @param {ol.source.TileSource} tileSource Tile source. * @param {ol.tilegrid.TileGrid} tileGrid Tile grid. * @param {ol.Projection} projection Projection. * @param {ol.Extent} extent Extent. * @param {number} currentZ Current Z. * @param {boolean} preload Preload low resolution tiles. * @param {function(this: T, ol.Tile)=} opt_tileCallback Tile callback. * @param {T=} opt_obj Object. * @protected * @template T */ ol.renderer.Layer.prototype.manageTilePyramid = function( frameState, tileSource, tileGrid, projection, extent, currentZ, preload, opt_tileCallback, opt_obj) { var tileSourceKey = goog.getUid(tileSource).toString(); if (!(tileSourceKey in frameState.wantedTiles)) { frameState.wantedTiles[tileSourceKey] = {}; } var wantedTiles = frameState.wantedTiles[tileSourceKey]; var tileQueue = frameState.tileQueue; var tile, tileRange, tileResolution, x, y, z; // FIXME this should loop up to tileGrid's minZ when implemented for (z = currentZ; z >= 0; --z) { tileRange = tileGrid.getTileRangeForExtentAndZ(extent, z); tileResolution = tileGrid.getResolution(z); for (x = tileRange.minX; x <= tileRange.maxX; ++x) { for (y = tileRange.minY; y <= tileRange.maxY; ++y) { if (preload || z == currentZ) { tile = tileSource.getTile(z, x, y, tileGrid, projection); if (tile.getState() == ol.TileState.IDLE) { wantedTiles[tile.tileCoord.toString()] = true; if (!tileQueue.isKeyQueued(tile.getKey())) { tileQueue.enqueue([tile, tileSourceKey, tileGrid.getTileCoordCenter(tile.tileCoord), tileResolution]); } } if (goog.isDef(opt_tileCallback)) { opt_tileCallback.call(opt_obj, tile); } } else { tileSource.useTile(z, x, y); } } } } };