/
CircleOutlineGeometry.js
154 lines (143 loc) · 6.06 KB
/
CircleOutlineGeometry.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
/*global define*/
define([
'./Cartesian3',
'./defaultValue',
'./defined',
'./DeveloperError',
'./EllipseOutlineGeometry',
'./Ellipsoid'
], function(
Cartesian3,
defaultValue,
defined,
DeveloperError,
EllipseOutlineGeometry,
Ellipsoid) {
"use strict";
/**
* A description of the outline of a circle on the ellipsoid.
*
* @alias CircleOutlineGeometry
* @constructor
*
* @param {Object} options Object with the following properties:
* @param {Cartesian3} options.center The circle's center point in the fixed frame.
* @param {Number} options.radius The radius in meters.
* @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid the circle will be on.
* @param {Number} [options.height=0.0] The height above the ellipsoid.
* @param {Number} [options.granularity=0.02] The angular distance between points on the circle in radians.
* @param {Number} [options.extrudedHeight=0.0] The height of the extrusion relative to the ellipsoid.
* @param {Number} [options.numberOfVerticalLines=16] Number of lines to draw between the top and bottom of an extruded circle.
*
* @exception {DeveloperError} radius must be greater than zero.
* @exception {DeveloperError} granularity must be greater than zero.
*
* @see CircleOutlineGeometry.createGeometry
* @see Packable
*
* @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=Circle%20Outline.html|Cesium Sandcastle Circle Outline Demo}
*
* @example
* // Create a circle.
* var circle = new Cesium.CircleOutlineGeometry({
* center : Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883),
* radius : 100000.0
* });
* var geometry = Cesium.CircleOutlineGeometry.createGeometry(circle);
*/
var CircleOutlineGeometry = function(options) {
options = defaultValue(options, defaultValue.EMPTY_OBJECT);
var radius = options.radius;
//>>includeStart('debug', pragmas.debug);
if (!defined(radius)) {
throw new DeveloperError('radius is required.');
}
if (radius <= 0.0) {
throw new DeveloperError('radius must be greater than zero.');
}
//>>includeEnd('debug');
var ellipseGeometryOptions = {
center : options.center,
semiMajorAxis : radius,
semiMinorAxis : radius,
ellipsoid : options.ellipsoid,
height : options.height,
extrudedHeight : options.extrudedHeight,
granularity : options.granularity,
numberOfVerticalLines : options.numberOfVerticalLines
};
this._ellipseGeometry = new EllipseOutlineGeometry(ellipseGeometryOptions);
this._workerName = 'createCircleOutlineGeometry';
};
/**
* The number of elements used to pack the object into an array.
* @type {Number}
*/
CircleOutlineGeometry.packedLength = EllipseOutlineGeometry.packedLength;
/**
* Stores the provided instance into the provided array.
* @function
*
* @param {Object} value The value to pack.
* @param {Number[]} array The array to pack into.
* @param {Number} [startingIndex=0] The index into the array at which to start packing the elements.
*/
CircleOutlineGeometry.pack = function(value, array, startingIndex) {
//>>includeStart('debug', pragmas.debug);
if (!defined(value)) {
throw new DeveloperError('value is required');
}
//>>includeEnd('debug');
EllipseOutlineGeometry.pack(value._ellipseGeometry, array, startingIndex);
};
var scratchEllipseGeometry = new EllipseOutlineGeometry({
center : new Cartesian3(),
semiMajorAxis : 1.0,
semiMinorAxis : 1.0
});
var scratchOptions = {
center : new Cartesian3(),
radius : undefined,
ellipsoid : Ellipsoid.clone(Ellipsoid.UNIT_SPHERE),
height : undefined,
extrudedHeight : undefined,
granularity : undefined,
numberOfVerticalLines : undefined,
semiMajorAxis : undefined,
semiMinorAxis : undefined
};
/**
* Retrieves an instance from a packed array.
*
* @param {Number[]} array The packed array.
* @param {Number} [startingIndex=0] The starting index of the element to be unpacked.
* @param {CircleOutlineGeometry} [result] The object into which to store the result.
*/
CircleOutlineGeometry.unpack = function(array, startingIndex, result) {
var ellipseGeometry = EllipseOutlineGeometry.unpack(array, startingIndex, scratchEllipseGeometry);
scratchOptions.center = Cartesian3.clone(ellipseGeometry._center, scratchOptions.center);
scratchOptions.ellipsoid = Ellipsoid.clone(ellipseGeometry._ellipsoid, scratchOptions.ellipsoid);
scratchOptions.height = ellipseGeometry._height;
scratchOptions.extrudedHeight = ellipseGeometry._extrudedHeight;
scratchOptions.granularity = ellipseGeometry._granularity;
scratchOptions.numberOfVerticalLines = ellipseGeometry._numberOfVerticalLines;
if (!defined(result)) {
scratchOptions.radius = ellipseGeometry._semiMajorAxis;
return new CircleOutlineGeometry(scratchOptions);
}
scratchOptions.semiMajorAxis = ellipseGeometry._semiMajorAxis;
scratchOptions.semiMinorAxis = ellipseGeometry._semiMinorAxis;
result._ellipseGeometry = new EllipseOutlineGeometry(scratchOptions);
return result;
};
/**
* Computes the geometric representation of an outline of a circle on an ellipsoid, including its vertices, indices, and a bounding sphere.
*
* @param {CircleOutlineGeometry} circleGeometry A description of the circle.
* @returns {Geometry} The computed vertices and indices.
*/
CircleOutlineGeometry.createGeometry = function(circleGeometry) {
return EllipseOutlineGeometry.createGeometry(circleGeometry._ellipseGeometry);
};
return CircleOutlineGeometry;
});