/**
|
* Cesium - https://github.com/CesiumGS/cesium
|
*
|
* Copyright 2011-2020 Cesium Contributors
|
*
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
* you may not use this file except in compliance with the License.
|
* You may obtain a copy of the License at
|
*
|
* http://www.apache.org/licenses/LICENSE-2.0
|
*
|
* Unless required by applicable law or agreed to in writing, software
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
* See the License for the specific language governing permissions and
|
* limitations under the License.
|
*
|
* Columbus View (Pat. Pend.)
|
*
|
* Portions licensed separately.
|
* See https://github.com/CesiumGS/cesium/blob/master/LICENSE.md for full licensing details.
|
*/
|
define(['./when-8d13db60', './Check-70bec281', './Math-61ede240', './Cartographic-fe4be337', './Cartesian2-85064f09', './BoundingSphere-775c5788', './Cartesian4-5af5bb24', './RuntimeError-ba10bc3e', './WebGLConstants-4c11ee5f', './ComponentDatatype-5862616f', './GeometryAttribute-ed9d707f', './PrimitiveType-97893bc7', './FeatureDetection-7bd32c34', './Transforms-a1cf7267', './buildModuleUrl-e7952659', './GeometryAttributes-aacecde6', './IndexDatatype-9435b55f', './arrayFill-9766fb2e', './GeometryOffsetAttribute-999fc023', './EllipseGeometryLibrary-7533a967', './EllipseOutlineGeometry-9a21ac97'], function (when, Check, _Math, Cartographic, Cartesian2, BoundingSphere, Cartesian4, RuntimeError, WebGLConstants, ComponentDatatype, GeometryAttribute, PrimitiveType, FeatureDetection, Transforms, buildModuleUrl, GeometryAttributes, IndexDatatype, arrayFill, GeometryOffsetAttribute, EllipseGeometryLibrary, EllipseOutlineGeometry) { '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 distance in meters between the circle and the ellipsoid surface.
|
* @param {Number} [options.granularity=0.02] The angular distance between points on the circle in radians.
|
* @param {Number} [options.extrudedHeight=0.0] The distance in meters between the circle's extruded face and the ellipsoid surface.
|
* @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
|
*
|
* @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);
|
*/
|
function CircleOutlineGeometry(options) {
|
options = when.defaultValue(options, when.defaultValue.EMPTY_OBJECT);
|
var radius = options.radius;
|
|
//>>includeStart('debug', pragmas.debug);
|
Check.Check.typeOf.number('radius', radius);
|
//>>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.EllipseOutlineGeometry(ellipseGeometryOptions);
|
this._workerName = 'createCircleOutlineGeometry';
|
}
|
|
/**
|
* The number of elements used to pack the object into an array.
|
* @type {Number}
|
*/
|
CircleOutlineGeometry.packedLength = EllipseOutlineGeometry.EllipseOutlineGeometry.packedLength;
|
|
/**
|
* Stores the provided instance into the provided array.
|
*
|
* @param {CircleOutlineGeometry} 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.
|
*
|
* @returns {Number[]} The array that was packed into
|
*/
|
CircleOutlineGeometry.pack = function(value, array, startingIndex) {
|
//>>includeStart('debug', pragmas.debug);
|
Check.Check.typeOf.object('value', value);
|
//>>includeEnd('debug');
|
return EllipseOutlineGeometry.EllipseOutlineGeometry.pack(value._ellipseGeometry, array, startingIndex);
|
};
|
|
var scratchEllipseGeometry = new EllipseOutlineGeometry.EllipseOutlineGeometry({
|
center : new Cartographic.Cartesian3(),
|
semiMajorAxis : 1.0,
|
semiMinorAxis : 1.0
|
});
|
var scratchOptions = {
|
center : new Cartographic.Cartesian3(),
|
radius : undefined,
|
ellipsoid : Cartesian2.Ellipsoid.clone(Cartesian2.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.
|
* @returns {CircleOutlineGeometry} The modified result parameter or a new CircleOutlineGeometry instance if one was not provided.
|
*/
|
CircleOutlineGeometry.unpack = function(array, startingIndex, result) {
|
var ellipseGeometry = EllipseOutlineGeometry.EllipseOutlineGeometry.unpack(array, startingIndex, scratchEllipseGeometry);
|
scratchOptions.center = Cartographic.Cartesian3.clone(ellipseGeometry._center, scratchOptions.center);
|
scratchOptions.ellipsoid = Cartesian2.Ellipsoid.clone(ellipseGeometry._ellipsoid, scratchOptions.ellipsoid);
|
scratchOptions.height = ellipseGeometry._height;
|
scratchOptions.extrudedHeight = ellipseGeometry._extrudedHeight;
|
scratchOptions.granularity = ellipseGeometry._granularity;
|
scratchOptions.numberOfVerticalLines = ellipseGeometry._numberOfVerticalLines;
|
|
if (!when.defined(result)) {
|
scratchOptions.radius = ellipseGeometry._semiMajorAxis;
|
return new CircleOutlineGeometry(scratchOptions);
|
}
|
|
scratchOptions.semiMajorAxis = ellipseGeometry._semiMajorAxis;
|
scratchOptions.semiMinorAxis = ellipseGeometry._semiMinorAxis;
|
result._ellipseGeometry = new EllipseOutlineGeometry.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|undefined} The computed vertices and indices.
|
*/
|
CircleOutlineGeometry.createGeometry = function(circleGeometry) {
|
return EllipseOutlineGeometry.EllipseOutlineGeometry.createGeometry(circleGeometry._ellipseGeometry);
|
};
|
|
function createCircleOutlineGeometry(circleGeometry, offset) {
|
if (when.defined(offset)) {
|
circleGeometry = CircleOutlineGeometry.unpack(circleGeometry, offset);
|
}
|
circleGeometry._ellipseGeometry._center = Cartographic.Cartesian3.clone(circleGeometry._ellipseGeometry._center);
|
circleGeometry._ellipseGeometry._ellipsoid = Cartesian2.Ellipsoid.clone(circleGeometry._ellipseGeometry._ellipsoid);
|
return CircleOutlineGeometry.createGeometry(circleGeometry);
|
}
|
|
return createCircleOutlineGeometry;
|
|
});
|
