goog.provide('ol.layer.Tile'); goog.require('ol'); goog.require('ol.layer.Layer'); goog.require('ol.layer.TileProperty'); goog.require('ol.obj'); goog.require('ol.renderer.Type'); goog.require('ol.renderer.canvas.TileLayer'); goog.require('ol.renderer.webgl.TileLayer'); /** * @classdesc * For layer sources that provide pre-rendered, tiled images in grids that are * organized by zoom levels for specific resolutions. * Note that any property set in the options is set as a {@link ol.Object} * property on the layer object; for example, setting `title: 'My Title'` in the * options means that `title` is observable, and has get/set accessors. * * @constructor * @extends {ol.layer.Layer} * @fires ol.render.Event * @param {olx.layer.TileOptions=} opt_options Tile layer options. * @api */ ol.layer.Tile = function(opt_options) { var options = opt_options ? opt_options : {}; var baseOptions = ol.obj.assign({}, options); delete baseOptions.preload; delete baseOptions.useInterimTilesOnError; ol.layer.Layer.call(this, /** @type {olx.layer.LayerOptions} */ (baseOptions)); this.setPreload(options.preload !== undefined ? options.preload : 0); this.setUseInterimTilesOnError(options.useInterimTilesOnError !== undefined ? options.useInterimTilesOnError : true); }; ol.inherits(ol.layer.Tile, ol.layer.Layer); /** * @inheritDoc */ ol.layer.Tile.prototype.createRenderer = function(mapRenderer) { var renderer = null; var type = mapRenderer.getType(); if (ol.ENABLE_CANVAS && type === ol.renderer.Type.CANVAS) { renderer = new ol.renderer.canvas.TileLayer(this); } else if (ol.ENABLE_WEBGL && type === ol.renderer.Type.WEBGL) { renderer = new ol.renderer.webgl.TileLayer(/** @type {ol.renderer.webgl.Map} */ (mapRenderer), this); } return renderer; }; /** * Return the level as number to which we will preload tiles up to. * @return {number} The level to preload tiles up to. * @observable * @api */ ol.layer.Tile.prototype.getPreload = function() { return /** @type {number} */ (this.get(ol.layer.TileProperty.PRELOAD)); }; /** * Return the associated {@link ol.source.Tile tilesource} of the layer. * @function * @return {ol.source.Tile} Source. * @api */ ol.layer.Tile.prototype.getSource; /** * Set the level as number to which we will preload tiles up to. * @param {number} preload The level to preload tiles up to. * @observable * @api */ ol.layer.Tile.prototype.setPreload = function(preload) { this.set(ol.layer.TileProperty.PRELOAD, preload); }; /** * Whether we use interim tiles on error. * @return {boolean} Use interim tiles on error. * @observable * @api */ ol.layer.Tile.prototype.getUseInterimTilesOnError = function() { return /** @type {boolean} */ ( this.get(ol.layer.TileProperty.USE_INTERIM_TILES_ON_ERROR)); }; /** * Set whether we use interim tiles on error. * @param {boolean} useInterimTilesOnError Use interim tiles on error. * @observable * @api */ ol.layer.Tile.prototype.setUseInterimTilesOnError = function(useInterimTilesOnError) { this.set( ol.layer.TileProperty.USE_INTERIM_TILES_ON_ERROR, useInterimTilesOnError); };