Move proj files so they are named like their provides
This commit is contained in:
Tim Schaub
@@ -0,0 +1,839 @@
|
||||
goog.provide('ol.proj');
|
||||
goog.provide('ol.proj.METERS_PER_UNIT');
|
||||
goog.provide('ol.proj.Projection');
|
||||
goog.provide('ol.proj.Units');
|
||||
|
||||
goog.require('ol');
|
||||
goog.require('ol.extent');
|
||||
goog.require('ol.object');
|
||||
goog.require('ol.sphere.NORMAL');
|
||||
|
||||
|
||||
/**
|
||||
* Projection units: `'degrees'`, `'ft'`, `'m'`, `'pixels'`, `'tile-pixels'` or
|
||||
* `'us-ft'`.
|
||||
* @enum {string}
|
||||
*/
|
||||
ol.proj.Units = {
|
||||
DEGREES: 'degrees',
|
||||
FEET: 'ft',
|
||||
METERS: 'm',
|
||||
PIXELS: 'pixels',
|
||||
TILE_PIXELS: 'tile-pixels',
|
||||
USFEET: 'us-ft'
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Meters per unit lookup table.
|
||||
* @const
|
||||
* @type {Object.<ol.proj.Units, number>}
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.METERS_PER_UNIT = {};
|
||||
ol.proj.METERS_PER_UNIT[ol.proj.Units.DEGREES] =
|
||||
2 * Math.PI * ol.sphere.NORMAL.radius / 360;
|
||||
ol.proj.METERS_PER_UNIT[ol.proj.Units.FEET] = 0.3048;
|
||||
ol.proj.METERS_PER_UNIT[ol.proj.Units.METERS] = 1;
|
||||
ol.proj.METERS_PER_UNIT[ol.proj.Units.USFEET] = 1200 / 3937;
|
||||
|
||||
|
||||
/**
|
||||
* @classdesc
|
||||
* Projection definition class. One of these is created for each projection
|
||||
* supported in the application and stored in the {@link ol.proj} namespace.
|
||||
* You can use these in applications, but this is not required, as API params
|
||||
* and options use {@link ol.ProjectionLike} which means the simple string
|
||||
* code will suffice.
|
||||
*
|
||||
* You can use {@link ol.proj.get} to retrieve the object for a particular
|
||||
* projection.
|
||||
*
|
||||
* The library includes definitions for `EPSG:4326` and `EPSG:3857`, together
|
||||
* with the following aliases:
|
||||
* * `EPSG:4326`: CRS:84, urn:ogc:def:crs:EPSG:6.6:4326,
|
||||
* urn:ogc:def:crs:OGC:1.3:CRS84, urn:ogc:def:crs:OGC:2:84,
|
||||
* http://www.opengis.net/gml/srs/epsg.xml#4326,
|
||||
* urn:x-ogc:def:crs:EPSG:4326
|
||||
* * `EPSG:3857`: EPSG:102100, EPSG:102113, EPSG:900913,
|
||||
* urn:ogc:def:crs:EPSG:6.18:3:3857,
|
||||
* http://www.opengis.net/gml/srs/epsg.xml#3857
|
||||
*
|
||||
* If you use proj4js, aliases can be added using `proj4.defs()`; see
|
||||
* [documentation](https://github.com/proj4js/proj4js). To set an alternative
|
||||
* namespace for proj4, use {@link ol.proj.setProj4}.
|
||||
*
|
||||
* @constructor
|
||||
* @param {olx.ProjectionOptions} options Projection options.
|
||||
* @struct
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.Projection = function(options) {
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {string}
|
||||
*/
|
||||
this.code_ = options.code;
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {ol.proj.Units}
|
||||
*/
|
||||
this.units_ = /** @type {ol.proj.Units} */ (options.units);
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {ol.Extent}
|
||||
*/
|
||||
this.extent_ = options.extent !== undefined ? options.extent : null;
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {ol.Extent}
|
||||
*/
|
||||
this.worldExtent_ = options.worldExtent !== undefined ?
|
||||
options.worldExtent : null;
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {string}
|
||||
*/
|
||||
this.axisOrientation_ = options.axisOrientation !== undefined ?
|
||||
options.axisOrientation : 'enu';
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {boolean}
|
||||
*/
|
||||
this.global_ = options.global !== undefined ? options.global : false;
|
||||
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {boolean}
|
||||
*/
|
||||
this.canWrapX_ = !!(this.global_ && this.extent_);
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {function(number, ol.Coordinate):number}
|
||||
*/
|
||||
this.getPointResolutionFunc_ = options.getPointResolution !== undefined ?
|
||||
options.getPointResolution : this.getPointResolution_;
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {ol.tilegrid.TileGrid}
|
||||
*/
|
||||
this.defaultTileGrid_ = null;
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {number|undefined}
|
||||
*/
|
||||
this.metersPerUnit_ = options.metersPerUnit;
|
||||
|
||||
var projections = ol.proj.projections_;
|
||||
var code = options.code;
|
||||
goog.DEBUG && console.assert(code !== undefined,
|
||||
'Option "code" is required for constructing instance');
|
||||
if (ol.ENABLE_PROJ4JS) {
|
||||
var proj4js = ol.proj.proj4_ || ol.global['proj4'];
|
||||
if (typeof proj4js == 'function' && projections[code] === undefined) {
|
||||
var def = proj4js.defs(code);
|
||||
if (def !== undefined) {
|
||||
if (def.axis !== undefined && options.axisOrientation === undefined) {
|
||||
this.axisOrientation_ = def.axis;
|
||||
}
|
||||
if (options.metersPerUnit === undefined) {
|
||||
this.metersPerUnit_ = def.to_meter;
|
||||
}
|
||||
if (options.units === undefined) {
|
||||
this.units_ = def.units;
|
||||
}
|
||||
var currentCode, currentDef, currentProj, proj4Transform;
|
||||
for (currentCode in projections) {
|
||||
currentDef = proj4js.defs(currentCode);
|
||||
if (currentDef !== undefined) {
|
||||
currentProj = ol.proj.get(currentCode);
|
||||
if (currentDef === def) {
|
||||
ol.proj.addEquivalentProjections([currentProj, this]);
|
||||
} else {
|
||||
proj4Transform = proj4js(currentCode, code);
|
||||
ol.proj.addCoordinateTransforms(currentProj, this,
|
||||
proj4Transform.forward, proj4Transform.inverse);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @return {boolean} The projection is suitable for wrapping the x-axis
|
||||
*/
|
||||
ol.proj.Projection.prototype.canWrapX = function() {
|
||||
return this.canWrapX_;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Get the code for this projection, e.g. 'EPSG:4326'.
|
||||
* @return {string} Code.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.Projection.prototype.getCode = function() {
|
||||
return this.code_;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Get the validity extent for this projection.
|
||||
* @return {ol.Extent} Extent.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.Projection.prototype.getExtent = function() {
|
||||
return this.extent_;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Get the units of this projection.
|
||||
* @return {ol.proj.Units} Units.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.Projection.prototype.getUnits = function() {
|
||||
return this.units_;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Get the amount of meters per unit of this projection. If the projection is
|
||||
* not configured with `metersPerUnit` or a units identifier, the return is
|
||||
* `undefined`.
|
||||
* @return {number|undefined} Meters.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.Projection.prototype.getMetersPerUnit = function() {
|
||||
return this.metersPerUnit_ || ol.proj.METERS_PER_UNIT[this.units_];
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Get the world extent for this projection.
|
||||
* @return {ol.Extent} Extent.
|
||||
* @api
|
||||
*/
|
||||
ol.proj.Projection.prototype.getWorldExtent = function() {
|
||||
return this.worldExtent_;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Get the axis orientation of this projection.
|
||||
* Example values are:
|
||||
* enu - the default easting, northing, elevation.
|
||||
* neu - northing, easting, up - useful for "lat/long" geographic coordinates,
|
||||
* or south orientated transverse mercator.
|
||||
* wnu - westing, northing, up - some planetary coordinate systems have
|
||||
* "west positive" coordinate systems
|
||||
* @return {string} Axis orientation.
|
||||
*/
|
||||
ol.proj.Projection.prototype.getAxisOrientation = function() {
|
||||
return this.axisOrientation_;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Is this projection a global projection which spans the whole world?
|
||||
* @return {boolean} Whether the projection is global.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.Projection.prototype.isGlobal = function() {
|
||||
return this.global_;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Set if the projection is a global projection which spans the whole world
|
||||
* @param {boolean} global Whether the projection is global.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.Projection.prototype.setGlobal = function(global) {
|
||||
this.global_ = global;
|
||||
this.canWrapX_ = !!(global && this.extent_);
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @return {ol.tilegrid.TileGrid} The default tile grid.
|
||||
*/
|
||||
ol.proj.Projection.prototype.getDefaultTileGrid = function() {
|
||||
return this.defaultTileGrid_;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @param {ol.tilegrid.TileGrid} tileGrid The default tile grid.
|
||||
*/
|
||||
ol.proj.Projection.prototype.setDefaultTileGrid = function(tileGrid) {
|
||||
this.defaultTileGrid_ = tileGrid;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Set the validity extent for this projection.
|
||||
* @param {ol.Extent} extent Extent.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.Projection.prototype.setExtent = function(extent) {
|
||||
this.extent_ = extent;
|
||||
this.canWrapX_ = !!(this.global_ && extent);
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Set the world extent for this projection.
|
||||
* @param {ol.Extent} worldExtent World extent
|
||||
* [minlon, minlat, maxlon, maxlat].
|
||||
* @api
|
||||
*/
|
||||
ol.proj.Projection.prototype.setWorldExtent = function(worldExtent) {
|
||||
this.worldExtent_ = worldExtent;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Set the getPointResolution function for this projection.
|
||||
* @param {function(number, ol.Coordinate):number} func Function
|
||||
* @api
|
||||
*/
|
||||
ol.proj.Projection.prototype.setGetPointResolution = function(func) {
|
||||
this.getPointResolutionFunc_ = func;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Default version.
|
||||
* Get the resolution of the point in degrees or distance units.
|
||||
* For projections with degrees as the unit this will simply return the
|
||||
* provided resolution. For other projections the point resolution is
|
||||
* estimated by transforming the 'point' pixel to EPSG:4326,
|
||||
* measuring its width and height on the normal sphere,
|
||||
* and taking the average of the width and height.
|
||||
* @param {number} resolution Nominal resolution in projection units.
|
||||
* @param {ol.Coordinate} point Point to find adjusted resolution at.
|
||||
* @return {number} Point resolution at point in projection units.
|
||||
* @private
|
||||
*/
|
||||
ol.proj.Projection.prototype.getPointResolution_ = function(resolution, point) {
|
||||
var units = this.getUnits();
|
||||
if (units == ol.proj.Units.DEGREES) {
|
||||
return resolution;
|
||||
} else {
|
||||
// Estimate point resolution by transforming the center pixel to EPSG:4326,
|
||||
// measuring its width and height on the normal sphere, and taking the
|
||||
// average of the width and height.
|
||||
var toEPSG4326 = ol.proj.getTransformFromProjections(
|
||||
this, ol.proj.get('EPSG:4326'));
|
||||
var vertices = [
|
||||
point[0] - resolution / 2, point[1],
|
||||
point[0] + resolution / 2, point[1],
|
||||
point[0], point[1] - resolution / 2,
|
||||
point[0], point[1] + resolution / 2
|
||||
];
|
||||
vertices = toEPSG4326(vertices, vertices, 2);
|
||||
var width = ol.sphere.NORMAL.haversineDistance(
|
||||
vertices.slice(0, 2), vertices.slice(2, 4));
|
||||
var height = ol.sphere.NORMAL.haversineDistance(
|
||||
vertices.slice(4, 6), vertices.slice(6, 8));
|
||||
var pointResolution = (width + height) / 2;
|
||||
var metersPerUnit = this.getMetersPerUnit();
|
||||
if (metersPerUnit !== undefined) {
|
||||
pointResolution /= metersPerUnit;
|
||||
}
|
||||
return pointResolution;
|
||||
}
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Get the resolution of the point in degrees or distance units.
|
||||
* For projections with degrees as the unit this will simply return the
|
||||
* provided resolution. The default for other projections is to estimate
|
||||
* the point resolution by transforming the 'point' pixel to EPSG:4326,
|
||||
* measuring its width and height on the normal sphere,
|
||||
* and taking the average of the width and height.
|
||||
* An alternative implementation may be given when constructing a
|
||||
* projection. For many local projections,
|
||||
* such a custom function will return the resolution unchanged.
|
||||
* @param {number} resolution Resolution in projection units.
|
||||
* @param {ol.Coordinate} point Point.
|
||||
* @return {number} Point resolution in projection units.
|
||||
* @api
|
||||
*/
|
||||
ol.proj.Projection.prototype.getPointResolution = function(resolution, point) {
|
||||
return this.getPointResolutionFunc_(resolution, point);
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {Object.<string, ol.proj.Projection>}
|
||||
*/
|
||||
ol.proj.projections_ = {};
|
||||
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {Object.<string, Object.<string, ol.TransformFunction>>}
|
||||
*/
|
||||
ol.proj.transforms_ = {};
|
||||
|
||||
|
||||
/**
|
||||
* @private
|
||||
* @type {proj4}
|
||||
*/
|
||||
ol.proj.proj4_ = null;
|
||||
|
||||
|
||||
if (ol.ENABLE_PROJ4JS) {
|
||||
/**
|
||||
* Register proj4. If not explicitly registered, it will be assumed that
|
||||
* proj4js will be loaded in the global namespace. For example in a
|
||||
* browserify ES6 environment you could use:
|
||||
*
|
||||
* import ol from 'openlayers';
|
||||
* import proj4 from 'proj4';
|
||||
* ol.proj.setProj4(proj4);
|
||||
*
|
||||
* @param {proj4} proj4 Proj4.
|
||||
* @api
|
||||
*/
|
||||
ol.proj.setProj4 = function(proj4) {
|
||||
goog.DEBUG && console.assert(typeof proj4 == 'function',
|
||||
'proj4 argument should be a function');
|
||||
ol.proj.proj4_ = proj4;
|
||||
};
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Registers transformation functions that don't alter coordinates. Those allow
|
||||
* to transform between projections with equal meaning.
|
||||
*
|
||||
* @param {Array.<ol.proj.Projection>} projections Projections.
|
||||
* @api
|
||||
*/
|
||||
ol.proj.addEquivalentProjections = function(projections) {
|
||||
ol.proj.addProjections(projections);
|
||||
projections.forEach(function(source) {
|
||||
projections.forEach(function(destination) {
|
||||
if (source !== destination) {
|
||||
ol.proj.addTransform(source, destination, ol.proj.cloneTransform);
|
||||
}
|
||||
});
|
||||
});
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Registers transformation functions to convert coordinates in any projection
|
||||
* in projection1 to any projection in projection2.
|
||||
*
|
||||
* @param {Array.<ol.proj.Projection>} projections1 Projections with equal
|
||||
* meaning.
|
||||
* @param {Array.<ol.proj.Projection>} projections2 Projections with equal
|
||||
* meaning.
|
||||
* @param {ol.TransformFunction} forwardTransform Transformation from any
|
||||
* projection in projection1 to any projection in projection2.
|
||||
* @param {ol.TransformFunction} inverseTransform Transform from any projection
|
||||
* in projection2 to any projection in projection1..
|
||||
*/
|
||||
ol.proj.addEquivalentTransforms = function(projections1, projections2, forwardTransform, inverseTransform) {
|
||||
projections1.forEach(function(projection1) {
|
||||
projections2.forEach(function(projection2) {
|
||||
ol.proj.addTransform(projection1, projection2, forwardTransform);
|
||||
ol.proj.addTransform(projection2, projection1, inverseTransform);
|
||||
});
|
||||
});
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Add a Projection object to the list of supported projections that can be
|
||||
* looked up by their code.
|
||||
*
|
||||
* @param {ol.proj.Projection} projection Projection instance.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.addProjection = function(projection) {
|
||||
ol.proj.projections_[projection.getCode()] = projection;
|
||||
ol.proj.addTransform(projection, projection, ol.proj.cloneTransform);
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @param {Array.<ol.proj.Projection>} projections Projections.
|
||||
*/
|
||||
ol.proj.addProjections = function(projections) {
|
||||
var addedProjections = [];
|
||||
projections.forEach(function(projection) {
|
||||
addedProjections.push(ol.proj.addProjection(projection));
|
||||
});
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* FIXME empty description for jsdoc
|
||||
*/
|
||||
ol.proj.clearAllProjections = function() {
|
||||
ol.proj.projections_ = {};
|
||||
ol.proj.transforms_ = {};
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @param {ol.proj.Projection|string|undefined} projection Projection.
|
||||
* @param {string} defaultCode Default code.
|
||||
* @return {ol.proj.Projection} Projection.
|
||||
*/
|
||||
ol.proj.createProjection = function(projection, defaultCode) {
|
||||
if (!projection) {
|
||||
return ol.proj.get(defaultCode);
|
||||
} else if (typeof projection === 'string') {
|
||||
return ol.proj.get(projection);
|
||||
} else {
|
||||
return /** @type {ol.proj.Projection} */ (projection);
|
||||
}
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Registers a conversion function to convert coordinates from the source
|
||||
* projection to the destination projection.
|
||||
*
|
||||
* @param {ol.proj.Projection} source Source.
|
||||
* @param {ol.proj.Projection} destination Destination.
|
||||
* @param {ol.TransformFunction} transformFn Transform.
|
||||
*/
|
||||
ol.proj.addTransform = function(source, destination, transformFn) {
|
||||
var sourceCode = source.getCode();
|
||||
var destinationCode = destination.getCode();
|
||||
var transforms = ol.proj.transforms_;
|
||||
if (!(sourceCode in transforms)) {
|
||||
transforms[sourceCode] = {};
|
||||
}
|
||||
transforms[sourceCode][destinationCode] = transformFn;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Registers coordinate transform functions to convert coordinates between the
|
||||
* source projection and the destination projection.
|
||||
* The forward and inverse functions convert coordinate pairs; this function
|
||||
* converts these into the functions used internally which also handle
|
||||
* extents and coordinate arrays.
|
||||
*
|
||||
* @param {ol.ProjectionLike} source Source projection.
|
||||
* @param {ol.ProjectionLike} destination Destination projection.
|
||||
* @param {function(ol.Coordinate): ol.Coordinate} forward The forward transform
|
||||
* function (that is, from the source projection to the destination
|
||||
* projection) that takes a {@link ol.Coordinate} as argument and returns
|
||||
* the transformed {@link ol.Coordinate}.
|
||||
* @param {function(ol.Coordinate): ol.Coordinate} inverse The inverse transform
|
||||
* function (that is, from the destination projection to the source
|
||||
* projection) that takes a {@link ol.Coordinate} as argument and returns
|
||||
* the transformed {@link ol.Coordinate}.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.addCoordinateTransforms = function(source, destination, forward, inverse) {
|
||||
var sourceProj = ol.proj.get(source);
|
||||
var destProj = ol.proj.get(destination);
|
||||
ol.proj.addTransform(sourceProj, destProj,
|
||||
ol.proj.createTransformFromCoordinateTransform(forward));
|
||||
ol.proj.addTransform(destProj, sourceProj,
|
||||
ol.proj.createTransformFromCoordinateTransform(inverse));
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Creates a {@link ol.TransformFunction} from a simple 2D coordinate transform
|
||||
* function.
|
||||
* @param {function(ol.Coordinate): ol.Coordinate} transform Coordinate
|
||||
* transform.
|
||||
* @return {ol.TransformFunction} Transform function.
|
||||
*/
|
||||
ol.proj.createTransformFromCoordinateTransform = function(transform) {
|
||||
return (
|
||||
/**
|
||||
* @param {Array.<number>} input Input.
|
||||
* @param {Array.<number>=} opt_output Output.
|
||||
* @param {number=} opt_dimension Dimension.
|
||||
* @return {Array.<number>} Output.
|
||||
*/
|
||||
function(input, opt_output, opt_dimension) {
|
||||
var length = input.length;
|
||||
var dimension = opt_dimension !== undefined ? opt_dimension : 2;
|
||||
var output = opt_output !== undefined ? opt_output : new Array(length);
|
||||
var point, i, j;
|
||||
for (i = 0; i < length; i += dimension) {
|
||||
point = transform([input[i], input[i + 1]]);
|
||||
output[i] = point[0];
|
||||
output[i + 1] = point[1];
|
||||
for (j = dimension - 1; j >= 2; --j) {
|
||||
output[i + j] = input[i + j];
|
||||
}
|
||||
}
|
||||
return output;
|
||||
});
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Unregisters the conversion function to convert coordinates from the source
|
||||
* projection to the destination projection. This method is used to clean up
|
||||
* cached transforms during testing.
|
||||
*
|
||||
* @param {ol.proj.Projection} source Source projection.
|
||||
* @param {ol.proj.Projection} destination Destination projection.
|
||||
* @return {ol.TransformFunction} transformFn The unregistered transform.
|
||||
*/
|
||||
ol.proj.removeTransform = function(source, destination) {
|
||||
var sourceCode = source.getCode();
|
||||
var destinationCode = destination.getCode();
|
||||
var transforms = ol.proj.transforms_;
|
||||
goog.DEBUG && console.assert(sourceCode in transforms,
|
||||
'sourceCode should be in transforms');
|
||||
goog.DEBUG && console.assert(destinationCode in transforms[sourceCode],
|
||||
'destinationCode should be in transforms of sourceCode');
|
||||
var transform = transforms[sourceCode][destinationCode];
|
||||
delete transforms[sourceCode][destinationCode];
|
||||
if (ol.object.isEmpty(transforms[sourceCode])) {
|
||||
delete transforms[sourceCode];
|
||||
}
|
||||
return transform;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Transforms a coordinate from longitude/latitude to a different projection.
|
||||
* @param {ol.Coordinate} coordinate Coordinate as longitude and latitude, i.e.
|
||||
* an array with longitude as 1st and latitude as 2nd element.
|
||||
* @param {ol.ProjectionLike=} opt_projection Target projection. The
|
||||
* default is Web Mercator, i.e. 'EPSG:3857'.
|
||||
* @return {ol.Coordinate} Coordinate projected to the target projection.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.fromLonLat = function(coordinate, opt_projection) {
|
||||
return ol.proj.transform(coordinate, 'EPSG:4326',
|
||||
opt_projection !== undefined ? opt_projection : 'EPSG:3857');
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Transforms a coordinate to longitude/latitude.
|
||||
* @param {ol.Coordinate} coordinate Projected coordinate.
|
||||
* @param {ol.ProjectionLike=} opt_projection Projection of the coordinate.
|
||||
* The default is Web Mercator, i.e. 'EPSG:3857'.
|
||||
* @return {ol.Coordinate} Coordinate as longitude and latitude, i.e. an array
|
||||
* with longitude as 1st and latitude as 2nd element.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.toLonLat = function(coordinate, opt_projection) {
|
||||
return ol.proj.transform(coordinate,
|
||||
opt_projection !== undefined ? opt_projection : 'EPSG:3857', 'EPSG:4326');
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Fetches a Projection object for the code specified.
|
||||
*
|
||||
* @param {ol.ProjectionLike} projectionLike Either a code string which is
|
||||
* a combination of authority and identifier such as "EPSG:4326", or an
|
||||
* existing projection object, or undefined.
|
||||
* @return {ol.proj.Projection} Projection object, or null if not in list.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.get = function(projectionLike) {
|
||||
var projection;
|
||||
if (projectionLike instanceof ol.proj.Projection) {
|
||||
projection = projectionLike;
|
||||
} else if (typeof projectionLike === 'string') {
|
||||
var code = projectionLike;
|
||||
projection = ol.proj.projections_[code];
|
||||
if (ol.ENABLE_PROJ4JS) {
|
||||
var proj4js = ol.proj.proj4_ || ol.global['proj4'];
|
||||
if (projection === undefined && typeof proj4js == 'function' &&
|
||||
proj4js.defs(code) !== undefined) {
|
||||
projection = new ol.proj.Projection({code: code});
|
||||
ol.proj.addProjection(projection);
|
||||
}
|
||||
}
|
||||
}
|
||||
return projection || null;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Checks if two projections are the same, that is every coordinate in one
|
||||
* projection does represent the same geographic point as the same coordinate in
|
||||
* the other projection.
|
||||
*
|
||||
* @param {ol.proj.Projection} projection1 Projection 1.
|
||||
* @param {ol.proj.Projection} projection2 Projection 2.
|
||||
* @return {boolean} Equivalent.
|
||||
* @api
|
||||
*/
|
||||
ol.proj.equivalent = function(projection1, projection2) {
|
||||
if (projection1 === projection2) {
|
||||
return true;
|
||||
}
|
||||
var equalUnits = projection1.getUnits() === projection2.getUnits();
|
||||
if (projection1.getCode() === projection2.getCode()) {
|
||||
return equalUnits;
|
||||
} else {
|
||||
var transformFn = ol.proj.getTransformFromProjections(
|
||||
projection1, projection2);
|
||||
return transformFn === ol.proj.cloneTransform && equalUnits;
|
||||
}
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Given the projection-like objects, searches for a transformation
|
||||
* function to convert a coordinates array from the source projection to the
|
||||
* destination projection.
|
||||
*
|
||||
* @param {ol.ProjectionLike} source Source.
|
||||
* @param {ol.ProjectionLike} destination Destination.
|
||||
* @return {ol.TransformFunction} Transform function.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.getTransform = function(source, destination) {
|
||||
var sourceProjection = ol.proj.get(source);
|
||||
var destinationProjection = ol.proj.get(destination);
|
||||
return ol.proj.getTransformFromProjections(
|
||||
sourceProjection, destinationProjection);
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Searches in the list of transform functions for the function for converting
|
||||
* coordinates from the source projection to the destination projection.
|
||||
*
|
||||
* @param {ol.proj.Projection} sourceProjection Source Projection object.
|
||||
* @param {ol.proj.Projection} destinationProjection Destination Projection
|
||||
* object.
|
||||
* @return {ol.TransformFunction} Transform function.
|
||||
*/
|
||||
ol.proj.getTransformFromProjections = function(sourceProjection, destinationProjection) {
|
||||
var transforms = ol.proj.transforms_;
|
||||
var sourceCode = sourceProjection.getCode();
|
||||
var destinationCode = destinationProjection.getCode();
|
||||
var transform;
|
||||
if (sourceCode in transforms && destinationCode in transforms[sourceCode]) {
|
||||
transform = transforms[sourceCode][destinationCode];
|
||||
}
|
||||
if (transform === undefined) {
|
||||
goog.DEBUG && console.assert(transform !== undefined, 'transform should be defined');
|
||||
transform = ol.proj.identityTransform;
|
||||
}
|
||||
return transform;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @param {Array.<number>} input Input coordinate array.
|
||||
* @param {Array.<number>=} opt_output Output array of coordinate values.
|
||||
* @param {number=} opt_dimension Dimension.
|
||||
* @return {Array.<number>} Input coordinate array (same array as input).
|
||||
*/
|
||||
ol.proj.identityTransform = function(input, opt_output, opt_dimension) {
|
||||
if (opt_output !== undefined && input !== opt_output) {
|
||||
// TODO: consider making this a warning instead
|
||||
goog.DEBUG && console.assert(false, 'This should not be used internally.');
|
||||
for (var i = 0, ii = input.length; i < ii; ++i) {
|
||||
opt_output[i] = input[i];
|
||||
}
|
||||
input = opt_output;
|
||||
}
|
||||
return input;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* @param {Array.<number>} input Input coordinate array.
|
||||
* @param {Array.<number>=} opt_output Output array of coordinate values.
|
||||
* @param {number=} opt_dimension Dimension.
|
||||
* @return {Array.<number>} Output coordinate array (new array, same coordinate
|
||||
* values).
|
||||
*/
|
||||
ol.proj.cloneTransform = function(input, opt_output, opt_dimension) {
|
||||
var output;
|
||||
if (opt_output !== undefined) {
|
||||
for (var i = 0, ii = input.length; i < ii; ++i) {
|
||||
opt_output[i] = input[i];
|
||||
}
|
||||
output = opt_output;
|
||||
} else {
|
||||
output = input.slice();
|
||||
}
|
||||
return output;
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Transforms a coordinate from source projection to destination projection.
|
||||
* This returns a new coordinate (and does not modify the original).
|
||||
*
|
||||
* See {@link ol.proj.transformExtent} for extent transformation.
|
||||
* See the transform method of {@link ol.geom.Geometry} and its subclasses for
|
||||
* geometry transforms.
|
||||
*
|
||||
* @param {ol.Coordinate} coordinate Coordinate.
|
||||
* @param {ol.ProjectionLike} source Source projection-like.
|
||||
* @param {ol.ProjectionLike} destination Destination projection-like.
|
||||
* @return {ol.Coordinate} Coordinate.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.transform = function(coordinate, source, destination) {
|
||||
var transformFn = ol.proj.getTransform(source, destination);
|
||||
return transformFn(coordinate, undefined, coordinate.length);
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Transforms an extent from source projection to destination projection. This
|
||||
* returns a new extent (and does not modify the original).
|
||||
*
|
||||
* @param {ol.Extent} extent The extent to transform.
|
||||
* @param {ol.ProjectionLike} source Source projection-like.
|
||||
* @param {ol.ProjectionLike} destination Destination projection-like.
|
||||
* @return {ol.Extent} The transformed extent.
|
||||
* @api stable
|
||||
*/
|
||||
ol.proj.transformExtent = function(extent, source, destination) {
|
||||
var transformFn = ol.proj.getTransform(source, destination);
|
||||
return ol.extent.applyTransform(extent, transformFn);
|
||||
};
|
||||
|
||||
|
||||
/**
|
||||
* Transforms the given point to the destination projection.
|
||||
*
|
||||
* @param {ol.Coordinate} point Point.
|
||||
* @param {ol.proj.Projection} sourceProjection Source projection.
|
||||
* @param {ol.proj.Projection} destinationProjection Destination projection.
|
||||
* @return {ol.Coordinate} Point.
|
||||
*/
|
||||
ol.proj.transformWithProjections = function(point, sourceProjection, destinationProjection) {
|
||||
var transformFn = ol.proj.getTransformFromProjections(
|
||||
sourceProjection, destinationProjection);
|
||||
return transformFn(point);
|
||||
};
|
||||
Reference in New Issue
Block a user