You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

469 lines
17 KiB

9 months ago
/**
* @license
* Cesium - https://github.com/CesiumGS/cesium
* Version 1.99
*
* Copyright 2011-2022 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/main/LICENSE.md for full licensing details.
*/
define(['exports', './Transforms-ac2d28a9', './Matrix3-ea964448', './ComponentDatatype-ebdce3ba', './defaultValue-135942ca', './Check-40d84a28', './EllipseGeometryLibrary-61eaea89', './GeometryAttribute-51d61732', './GeometryAttributes-899f8bd0', './GeometryOffsetAttribute-d3a42805', './IndexDatatype-fa75fe25', './Math-efde0c7b'], (function (exports, Transforms, Matrix3, ComponentDatatype, defaultValue, Check, EllipseGeometryLibrary, GeometryAttribute, GeometryAttributes, GeometryOffsetAttribute, IndexDatatype, Math$1) { 'use strict';
const scratchCartesian1 = new Matrix3.Cartesian3();
let boundingSphereCenter = new Matrix3.Cartesian3();
function computeEllipse(options) {
const center = options.center;
boundingSphereCenter = Matrix3.Cartesian3.multiplyByScalar(
options.ellipsoid.geodeticSurfaceNormal(center, boundingSphereCenter),
options.height,
boundingSphereCenter
);
boundingSphereCenter = Matrix3.Cartesian3.add(
center,
boundingSphereCenter,
boundingSphereCenter
);
const boundingSphere = new Transforms.BoundingSphere(
boundingSphereCenter,
options.semiMajorAxis
);
const positions = EllipseGeometryLibrary.EllipseGeometryLibrary.computeEllipsePositions(
options,
false,
true
).outerPositions;
const attributes = new GeometryAttributes.GeometryAttributes({
position: new GeometryAttribute.GeometryAttribute({
componentDatatype: ComponentDatatype.ComponentDatatype.DOUBLE,
componentsPerAttribute: 3,
values: EllipseGeometryLibrary.EllipseGeometryLibrary.raisePositionsToHeight(
positions,
options,
false
),
}),
});
const length = positions.length / 3;
const indices = IndexDatatype.IndexDatatype.createTypedArray(length, length * 2);
let index = 0;
for (let i = 0; i < length; ++i) {
indices[index++] = i;
indices[index++] = (i + 1) % length;
}
return {
boundingSphere: boundingSphere,
attributes: attributes,
indices: indices,
};
}
const topBoundingSphere = new Transforms.BoundingSphere();
const bottomBoundingSphere = new Transforms.BoundingSphere();
function computeExtrudedEllipse(options) {
const center = options.center;
const ellipsoid = options.ellipsoid;
const semiMajorAxis = options.semiMajorAxis;
let scaledNormal = Matrix3.Cartesian3.multiplyByScalar(
ellipsoid.geodeticSurfaceNormal(center, scratchCartesian1),
options.height,
scratchCartesian1
);
topBoundingSphere.center = Matrix3.Cartesian3.add(
center,
scaledNormal,
topBoundingSphere.center
);
topBoundingSphere.radius = semiMajorAxis;
scaledNormal = Matrix3.Cartesian3.multiplyByScalar(
ellipsoid.geodeticSurfaceNormal(center, scaledNormal),
options.extrudedHeight,
scaledNormal
);
bottomBoundingSphere.center = Matrix3.Cartesian3.add(
center,
scaledNormal,
bottomBoundingSphere.center
);
bottomBoundingSphere.radius = semiMajorAxis;
let positions = EllipseGeometryLibrary.EllipseGeometryLibrary.computeEllipsePositions(
options,
false,
true
).outerPositions;
const attributes = new GeometryAttributes.GeometryAttributes({
position: new GeometryAttribute.GeometryAttribute({
componentDatatype: ComponentDatatype.ComponentDatatype.DOUBLE,
componentsPerAttribute: 3,
values: EllipseGeometryLibrary.EllipseGeometryLibrary.raisePositionsToHeight(
positions,
options,
true
),
}),
});
positions = attributes.position.values;
const boundingSphere = Transforms.BoundingSphere.union(
topBoundingSphere,
bottomBoundingSphere
);
let length = positions.length / 3;
if (defaultValue.defined(options.offsetAttribute)) {
let applyOffset = new Uint8Array(length);
if (options.offsetAttribute === GeometryOffsetAttribute.GeometryOffsetAttribute.TOP) {
applyOffset = applyOffset.fill(1, 0, length / 2);
} else {
const offsetValue =
options.offsetAttribute === GeometryOffsetAttribute.GeometryOffsetAttribute.NONE ? 0 : 1;
applyOffset = applyOffset.fill(offsetValue);
}
attributes.applyOffset = new GeometryAttribute.GeometryAttribute({
componentDatatype: ComponentDatatype.ComponentDatatype.UNSIGNED_BYTE,
componentsPerAttribute: 1,
values: applyOffset,
});
}
let numberOfVerticalLines = defaultValue.defaultValue(options.numberOfVerticalLines, 16);
numberOfVerticalLines = Math$1.CesiumMath.clamp(
numberOfVerticalLines,
0,
length / 2
);
const indices = IndexDatatype.IndexDatatype.createTypedArray(
length,
length * 2 + numberOfVerticalLines * 2
);
length /= 2;
let index = 0;
let i;
for (i = 0; i < length; ++i) {
indices[index++] = i;
indices[index++] = (i + 1) % length;
indices[index++] = i + length;
indices[index++] = ((i + 1) % length) + length;
}
let numSide;
if (numberOfVerticalLines > 0) {
const numSideLines = Math.min(numberOfVerticalLines, length);
numSide = Math.round(length / numSideLines);
const maxI = Math.min(numSide * numberOfVerticalLines, length);
for (i = 0; i < maxI; i += numSide) {
indices[index++] = i;
indices[index++] = i + length;
}
}
return {
boundingSphere: boundingSphere,
attributes: attributes,
indices: indices,
};
}
/**
* A description of the outline of an ellipse on an ellipsoid.
*
* @alias EllipseOutlineGeometry
* @constructor
*
* @param {Object} options Object with the following properties:
* @param {Cartesian3} options.center The ellipse's center point in the fixed frame.
* @param {Number} options.semiMajorAxis The length of the ellipse's semi-major axis in meters.
* @param {Number} options.semiMinorAxis The length of the ellipse's semi-minor axis in meters.
* @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid the ellipse will be on.
* @param {Number} [options.height=0.0] The distance in meters between the ellipse and the ellipsoid surface.
* @param {Number} [options.extrudedHeight] The distance in meters between the ellipse's extruded face and the ellipsoid surface.
* @param {Number} [options.rotation=0.0] The angle from north (counter-clockwise) in radians.
* @param {Number} [options.granularity=0.02] The angular distance between points on the ellipse in radians.
* @param {Number} [options.numberOfVerticalLines=16] Number of lines to draw between the top and bottom surface of an extruded ellipse.
*
* @exception {DeveloperError} semiMajorAxis and semiMinorAxis must be greater than zero.
* @exception {DeveloperError} semiMajorAxis must be greater than or equal to the semiMinorAxis.
* @exception {DeveloperError} granularity must be greater than zero.
*
* @see EllipseOutlineGeometry.createGeometry
*
* @example
* const ellipse = new Cesium.EllipseOutlineGeometry({
* center : Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883),
* semiMajorAxis : 500000.0,
* semiMinorAxis : 300000.0,
* rotation : Cesium.Math.toRadians(60.0)
* });
* const geometry = Cesium.EllipseOutlineGeometry.createGeometry(ellipse);
*/
function EllipseOutlineGeometry(options) {
options = defaultValue.defaultValue(options, defaultValue.defaultValue.EMPTY_OBJECT);
const center = options.center;
const ellipsoid = defaultValue.defaultValue(options.ellipsoid, Matrix3.Ellipsoid.WGS84);
const semiMajorAxis = options.semiMajorAxis;
const semiMinorAxis = options.semiMinorAxis;
const granularity = defaultValue.defaultValue(
options.granularity,
Math$1.CesiumMath.RADIANS_PER_DEGREE
);
//>>includeStart('debug', pragmas.debug);
if (!defaultValue.defined(center)) {
throw new Check.DeveloperError("center is required.");
}
if (!defaultValue.defined(semiMajorAxis)) {
throw new Check.DeveloperError("semiMajorAxis is required.");
}
if (!defaultValue.defined(semiMinorAxis)) {
throw new Check.DeveloperError("semiMinorAxis is required.");
}
if (semiMajorAxis < semiMinorAxis) {
throw new Check.DeveloperError(
"semiMajorAxis must be greater than or equal to the semiMinorAxis."
);
}
if (granularity <= 0.0) {
throw new Check.DeveloperError("granularity must be greater than zero.");
}
//>>includeEnd('debug');
const height = defaultValue.defaultValue(options.height, 0.0);
const extrudedHeight = defaultValue.defaultValue(options.extrudedHeight, height);
this._center = Matrix3.Cartesian3.clone(center);
this._semiMajorAxis = semiMajorAxis;
this._semiMinorAxis = semiMinorAxis;
this._ellipsoid = Matrix3.Ellipsoid.clone(ellipsoid);
this._rotation = defaultValue.defaultValue(options.rotation, 0.0);
this._height = Math.max(extrudedHeight, height);
this._granularity = granularity;
this._extrudedHeight = Math.min(extrudedHeight, height);
this._numberOfVerticalLines = Math.max(
defaultValue.defaultValue(options.numberOfVerticalLines, 16),
0
);
this._offsetAttribute = options.offsetAttribute;
this._workerName = "createEllipseOutlineGeometry";
}
/**
* The number of elements used to pack the object into an array.
* @type {Number}
*/
EllipseOutlineGeometry.packedLength =
Matrix3.Cartesian3.packedLength + Matrix3.Ellipsoid.packedLength + 8;
/**
* Stores the provided instance into the provided array.
*
* @param {EllipseOutlineGeometry} 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
*/
EllipseOutlineGeometry.pack = function (value, array, startingIndex) {
//>>includeStart('debug', pragmas.debug);
if (!defaultValue.defined(value)) {
throw new Check.DeveloperError("value is required");
}
if (!defaultValue.defined(array)) {
throw new Check.DeveloperError("array is required");
}
//>>includeEnd('debug');
startingIndex = defaultValue.defaultValue(startingIndex, 0);
Matrix3.Cartesian3.pack(value._center, array, startingIndex);
startingIndex += Matrix3.Cartesian3.packedLength;
Matrix3.Ellipsoid.pack(value._ellipsoid, array, startingIndex);
startingIndex += Matrix3.Ellipsoid.packedLength;
array[startingIndex++] = value._semiMajorAxis;
array[startingIndex++] = value._semiMinorAxis;
array[startingIndex++] = value._rotation;
array[startingIndex++] = value._height;
array[startingIndex++] = value._granularity;
array[startingIndex++] = value._extrudedHeight;
array[startingIndex++] = value._numberOfVerticalLines;
array[startingIndex] = defaultValue.defaultValue(value._offsetAttribute, -1);
return array;
};
const scratchCenter = new Matrix3.Cartesian3();
const scratchEllipsoid = new Matrix3.Ellipsoid();
const scratchOptions = {
center: scratchCenter,
ellipsoid: scratchEllipsoid,
semiMajorAxis: undefined,
semiMinorAxis: undefined,
rotation: undefined,
height: undefined,
granularity: undefined,
extrudedHeight: undefined,
numberOfVerticalLines: undefined,
offsetAttribute: 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 {EllipseOutlineGeometry} [result] The object into which to store the result.
* @returns {EllipseOutlineGeometry} The modified result parameter or a new EllipseOutlineGeometry instance if one was not provided.
*/
EllipseOutlineGeometry.unpack = function (array, startingIndex, result) {
//>>includeStart('debug', pragmas.debug);
if (!defaultValue.defined(array)) {
throw new Check.DeveloperError("array is required");
}
//>>includeEnd('debug');
startingIndex = defaultValue.defaultValue(startingIndex, 0);
const center = Matrix3.Cartesian3.unpack(array, startingIndex, scratchCenter);
startingIndex += Matrix3.Cartesian3.packedLength;
const ellipsoid = Matrix3.Ellipsoid.unpack(array, startingIndex, scratchEllipsoid);
startingIndex += Matrix3.Ellipsoid.packedLength;
const semiMajorAxis = array[startingIndex++];
const semiMinorAxis = array[startingIndex++];
const rotation = array[startingIndex++];
const height = array[startingIndex++];
const granularity = array[startingIndex++];
const extrudedHeight = array[startingIndex++];
const numberOfVerticalLines = array[startingIndex++];
const offsetAttribute = array[startingIndex];
if (!defaultValue.defined(result)) {
scratchOptions.height = height;
scratchOptions.extrudedHeight = extrudedHeight;
scratchOptions.granularity = granularity;
scratchOptions.rotation = rotation;
scratchOptions.semiMajorAxis = semiMajorAxis;
scratchOptions.semiMinorAxis = semiMinorAxis;
scratchOptions.numberOfVerticalLines = numberOfVerticalLines;
scratchOptions.offsetAttribute =
offsetAttribute === -1 ? undefined : offsetAttribute;
return new EllipseOutlineGeometry(scratchOptions);
}
result._center = Matrix3.Cartesian3.clone(center, result._center);
result._ellipsoid = Matrix3.Ellipsoid.clone(ellipsoid, result._ellipsoid);
result._semiMajorAxis = semiMajorAxis;
result._semiMinorAxis = semiMinorAxis;
result._rotation = rotation;
result._height = height;
result._granularity = granularity;
result._extrudedHeight = extrudedHeight;
result._numberOfVerticalLines = numberOfVerticalLines;
result._offsetAttribute =
offsetAttribute === -1 ? undefined : offsetAttribute;
return result;
};
/**
* Computes the geometric representation of an outline of an ellipse on an ellipsoid, including its vertices, indices, and a bounding sphere.
*
* @param {EllipseOutlineGeometry} ellipseGeometry A description of the ellipse.
* @returns {Geometry|undefined} The computed vertices and indices.
*/
EllipseOutlineGeometry.createGeometry = function (ellipseGeometry) {
if (
ellipseGeometry._semiMajorAxis <= 0.0 ||
ellipseGeometry._semiMinorAxis <= 0.0
) {
return;
}
const height = ellipseGeometry._height;
const extrudedHeight = ellipseGeometry._extrudedHeight;
const extrude = !Math$1.CesiumMath.equalsEpsilon(
height,
extrudedHeight,
0,
Math$1.CesiumMath.EPSILON2
);
ellipseGeometry._center = ellipseGeometry._ellipsoid.scaleToGeodeticSurface(
ellipseGeometry._center,
ellipseGeometry._center
);
const options = {
center: ellipseGeometry._center,
semiMajorAxis: ellipseGeometry._semiMajorAxis,
semiMinorAxis: ellipseGeometry._semiMinorAxis,
ellipsoid: ellipseGeometry._ellipsoid,
rotation: ellipseGeometry._rotation,
height: height,
granularity: ellipseGeometry._granularity,
numberOfVerticalLines: ellipseGeometry._numberOfVerticalLines,
};
let geometry;
if (extrude) {
options.extrudedHeight = extrudedHeight;
options.offsetAttribute = ellipseGeometry._offsetAttribute;
geometry = computeExtrudedEllipse(options);
} else {
geometry = computeEllipse(options);
if (defaultValue.defined(ellipseGeometry._offsetAttribute)) {
const length = geometry.attributes.position.values.length;
const offsetValue =
ellipseGeometry._offsetAttribute === GeometryOffsetAttribute.GeometryOffsetAttribute.NONE
? 0
: 1;
const applyOffset = new Uint8Array(length / 3).fill(offsetValue);
geometry.attributes.applyOffset = new GeometryAttribute.GeometryAttribute({
componentDatatype: ComponentDatatype.ComponentDatatype.UNSIGNED_BYTE,
componentsPerAttribute: 1,
values: applyOffset,
});
}
}
return new GeometryAttribute.Geometry({
attributes: geometry.attributes,
indices: geometry.indices,
primitiveType: GeometryAttribute.PrimitiveType.LINES,
boundingSphere: geometry.boundingSphere,
offsetAttribute: ellipseGeometry._offsetAttribute,
});
};
exports.EllipseOutlineGeometry = EllipseOutlineGeometry;
}));