Commit Graph

78 Commits

Author SHA1 Message Date
Tim Schaub
1110da37e1 Move ol.Sphere#circle to ol.geom.Polygon.circular
Previously, ol.geom.Polygon was a transitive dependency of ol.proj (since ol.proj requires ol.sphere.NORMAL, and all spheres were capable of generating circular polygons).  Instead, ol.proj should be lower-level.  Since it deals only with coordinate arrays, it shouldn't depend on all of the geometry code.

By adding a static `circular` function to `ol.geom.Polygon`, the dependency tree makes more sense.  If you want to create a polygon that approximates a circle on a sphere, you require `ol.geom.Polygon` and `ol.Sphere` (or one of the constants).

This makes room for geometries to have a `transform` method that takes projection-like arguments (meaning that `ol.geom.Geometry` will require `ol.proj`).
2014-05-02 11:25:44 -06:00
Andreas Hocevar
fbdbbfb7a7 Get rid of stability annotations and document stability with api
This change adds a stability value to the api annotation, with
'experimental' as default value.

enum, typedef and event annotations are never exportable, but
api annotations are needed there to make them appear in the
docs.

Nested typedefs are no longer inlined recursively, because the
resulting tables get too wide with the current template.
2014-04-29 09:53:07 -06:00
Andreas Hocevar
c17ac0cae3 Greatly simplify and document the usage of JSDoc
This commit simplifies the exports.js plugin so it only relies
on the stability notes to generate the documentation, which
completely decouples it from the exportable API.

As a rule of thumb, whenever something has an 'api' annotation,
it should also have a 'stability' annotation. A more verbose
documentation of ol3 specific annotation usage is available in
the new 'apidoc/readme.md' file.

This commit also modifies all source files to implement these
usage suggestions.
2014-04-29 09:53:06 -06:00
Tim Schaub
fb497f5288 Annotations for exports 2014-04-29 09:53:05 -06:00
Tom Payne
b613c9cde7 Merge pull request #1859 from pgiraud/geolocation_tracking_orientation
Geolocation tracking with orientation example
2014-03-24 12:53:53 +01:00
Pierre GIRAUD
8e9ffb377e Geolocation tracking with orientation example 2014-03-24 12:26:17 +01:00
Tom Payne
dbc4f4e621 Use ol.array.safeExtend in ol.geom.Polygon 2014-03-24 11:56:53 +01:00
Tom Payne
78c8d976eb Remove empty ol.geom.flat 2014-03-12 13:26:14 +01:00
Tom Payne
3541a01aab Factor out ol.geom.flat.inflate 2014-03-12 13:26:14 +01:00
Tom Payne
266c43dc78 Factor out ol.geom.flat.deflate 2014-03-12 13:26:14 +01:00
Tom Payne
d525b43d06 Factor out ol.geom.flat.contains and interiorpoint 2014-03-12 13:26:14 +01:00
Tom Payne
1363ce3a58 Factor out ol.geom.flat.orient 2014-03-12 13:26:14 +01:00
Tom Payne
becd1318bd Factor out ol.geom.flat.area 2014-03-12 13:26:13 +01:00
Tom Payne
c8165a8168 Factor out ol.geom.flat.simplify 2014-03-12 13:26:13 +01:00
Tom Payne
2b6845244c Factor out ol.geom.flat.closest 2014-03-12 13:26:13 +01:00
Tom Payne
c2d4ffaba1 Add ol.geom.Polygon#getLinearRing 2014-03-10 16:53:19 +01:00
Tom Payne
03911e6c6b Add ol.geom.Polygon#appendLinearRing 2014-03-10 16:53:19 +01:00
Tom Payne
23dc855c2f Check arguments passed to ol.geom.Polygon#setFlatCoordinates 2014-03-10 16:53:19 +01:00
Tom Payne
0f884b5d03 Add ol.geom.Polygon#getInteriorPoint 2014-02-28 16:10:01 +01:00
Tom Payne
a780936805 Fix getInteriorPoint calculation to always return a point 2014-02-03 15:49:06 +01:00
Tom Payne
40eb21f445 Replace ol.geom.Polygon#getInteriorPoint with getFlatInteriorPoint 2014-02-03 15:49:04 +01:00
Tom Payne
8f50d0f097 Add stability annotation to ol.geom.Polygon 2014-02-03 14:59:12 +01:00
Tom Payne
d35c40f81f Create linear rings directly from flat coordinates 2014-01-21 16:11:53 +01:00
Tom Payne
6552046aa0 Use oriented rings where needed 2014-01-21 16:11:52 +01:00
Tom Payne
5b5865d48e Add ol.geom.Polygon#getOrientedFlatCoordinates 2014-01-21 16:11:52 +01:00
Tom Payne
ff73f080b3 Don't automatically orient rings in ol.geom.Polygon 2014-01-21 16:07:26 +01:00
Tom Payne
edcb38232f Use inherited dispatchChangeEvent and getRevision in ol.geom.Geometry 2014-01-21 11:43:13 +01:00
oterral
235af49f0b Add goog.provide('ol.geom.GeometryType') 2014-01-10 14:00:30 +01:00
Tom Payne
b179a27ade Rename ol.geom.simplify.schaub to quantize 2013-12-13 20:51:54 +01:00
Tom Payne
594cee01e4 Use Schaub's topology-preserving simplification method for Polygons and MultiPolygons 2013-12-13 13:59:29 +01:00
Tom Payne
802d1644bb Implement clone for simple geometries 2013-12-11 16:49:47 +01:00
Tom Payne
76a6e08ec1 Factor out ol.geom.SimpleGeometry 2013-12-11 16:49:47 +01:00
Tom Payne
f4fe0046b2 Check closest point against extent 2013-12-09 16:40:55 +01:00
Tom Payne
cf659f0753 Add ol.geom.Polygon#closestPointXY 2013-12-09 16:40:53 +01:00
Tom Payne
e560192c0f Add ol.geom.Polygon#getSimplifiedGeometryInternal 2013-12-09 16:37:32 +01:00
Tom Payne
057cda42be Rename ol.geom.Type to ol.geom.GeometryType 2013-12-04 16:28:36 +01:00
Tom Payne
c2228b1d19 Rename ol.geom.Layout to ol.geom.GeometryLayout 2013-12-04 16:27:03 +01:00
Tom Payne
1a9d19a2fb Allow geometries to have null coordinates and add setFlatCoordinates 2013-12-03 19:58:34 +01:00
Tom Payne
bb294bf52f Add ol.geom.Polygon#getArea 2013-12-02 12:07:33 +01:00
Tom Payne
72df83251d Cache ol.geom.Polygon interior point 2013-12-02 09:08:05 +01:00
Tom Payne
3d35ce75e4 Add ol.geom.Polygon#getInteriorPoint 2013-12-02 09:08:05 +01:00
Tom Payne
c1c813e3fa Add ol.geom.Polygon#getLinearRings 2013-12-01 21:06:11 +01:00
Frederic Junod
99ce67aedc Nicer dragbox style 2013-11-20 11:45:25 +01:00
Tom Payne
df423fda22 Move ol.geom.orientFlatLinearRings into ol.geom.flat 2013-11-20 11:44:45 +01:00
Tom Payne
857c28a88b Move ol.geom.flatLinearRingContains to ol.geom.flat 2013-11-20 11:44:44 +01:00
Tom Payne
16e5f238d2 Move inflateCoordinates into ol.geom.flat 2013-11-20 11:44:44 +01:00
Tom Payne
dc1ad7bb83 Move deflateCoodinates into ol.geom.flat 2013-11-20 11:44:44 +01:00
Tom Payne
cd9b52572a Replace ol.geom.GeometryType with ol.geom.Type 2013-11-20 11:42:09 +01:00
Tom Payne
fe06c97a08 Orient rings in ol.geom.Polygon 2013-11-20 11:42:09 +01:00
Tom Payne
aa70030a43 Move containsCoordinate to ol.geom.Geometry 2013-11-20 11:42:07 +01:00