533 lines
16 KiB
JavaScript
533 lines
16 KiB
JavaScript
import BoundingSphere from "./BoundingSphere.js";
|
|
import Cartesian3 from "./Cartesian3.js";
|
|
import Cartographic from "./Cartographic.js";
|
|
import ComponentDatatype from "./ComponentDatatype.js";
|
|
import Frozen from "./Frozen.js";
|
|
import defined from "./defined.js";
|
|
import DeveloperError from "./DeveloperError.js";
|
|
import Ellipsoid from "./Ellipsoid.js";
|
|
import Geometry from "./Geometry.js";
|
|
import GeometryAttribute from "./GeometryAttribute.js";
|
|
import GeometryAttributes from "./GeometryAttributes.js";
|
|
import GeometryOffsetAttribute from "./GeometryOffsetAttribute.js";
|
|
import IndexDatatype from "./IndexDatatype.js";
|
|
import CesiumMath from "./Math.js";
|
|
import PolygonPipeline from "./PolygonPipeline.js";
|
|
import PrimitiveType from "./PrimitiveType.js";
|
|
import Rectangle from "./Rectangle.js";
|
|
import RectangleGeometryLibrary from "./RectangleGeometryLibrary.js";
|
|
|
|
const bottomBoundingSphere = new BoundingSphere();
|
|
const topBoundingSphere = new BoundingSphere();
|
|
const positionScratch = new Cartesian3();
|
|
const rectangleScratch = new Rectangle();
|
|
|
|
function constructRectangle(geometry, computedOptions) {
|
|
const ellipsoid = geometry._ellipsoid;
|
|
const height = computedOptions.height;
|
|
const width = computedOptions.width;
|
|
const northCap = computedOptions.northCap;
|
|
const southCap = computedOptions.southCap;
|
|
|
|
let rowHeight = height;
|
|
let widthMultiplier = 2;
|
|
let size = 0;
|
|
let corners = 4;
|
|
if (northCap) {
|
|
widthMultiplier -= 1;
|
|
rowHeight -= 1;
|
|
size += 1;
|
|
corners -= 2;
|
|
}
|
|
if (southCap) {
|
|
widthMultiplier -= 1;
|
|
rowHeight -= 1;
|
|
size += 1;
|
|
corners -= 2;
|
|
}
|
|
size += widthMultiplier * width + 2 * rowHeight - corners;
|
|
|
|
const positions = new Float64Array(size * 3);
|
|
|
|
let posIndex = 0;
|
|
let row = 0;
|
|
let col;
|
|
const position = positionScratch;
|
|
if (northCap) {
|
|
RectangleGeometryLibrary.computePosition(
|
|
computedOptions,
|
|
ellipsoid,
|
|
false,
|
|
row,
|
|
0,
|
|
position,
|
|
);
|
|
positions[posIndex++] = position.x;
|
|
positions[posIndex++] = position.y;
|
|
positions[posIndex++] = position.z;
|
|
} else {
|
|
for (col = 0; col < width; col++) {
|
|
RectangleGeometryLibrary.computePosition(
|
|
computedOptions,
|
|
ellipsoid,
|
|
false,
|
|
row,
|
|
col,
|
|
position,
|
|
);
|
|
positions[posIndex++] = position.x;
|
|
positions[posIndex++] = position.y;
|
|
positions[posIndex++] = position.z;
|
|
}
|
|
}
|
|
|
|
col = width - 1;
|
|
for (row = 1; row < height; row++) {
|
|
RectangleGeometryLibrary.computePosition(
|
|
computedOptions,
|
|
ellipsoid,
|
|
false,
|
|
row,
|
|
col,
|
|
position,
|
|
);
|
|
positions[posIndex++] = position.x;
|
|
positions[posIndex++] = position.y;
|
|
positions[posIndex++] = position.z;
|
|
}
|
|
|
|
row = height - 1;
|
|
if (!southCap) {
|
|
// if southCap is true, we dont need to add any more points because the south pole point was added by the iteration above
|
|
for (col = width - 2; col >= 0; col--) {
|
|
RectangleGeometryLibrary.computePosition(
|
|
computedOptions,
|
|
ellipsoid,
|
|
false,
|
|
row,
|
|
col,
|
|
position,
|
|
);
|
|
positions[posIndex++] = position.x;
|
|
positions[posIndex++] = position.y;
|
|
positions[posIndex++] = position.z;
|
|
}
|
|
}
|
|
|
|
col = 0;
|
|
for (row = height - 2; row > 0; row--) {
|
|
RectangleGeometryLibrary.computePosition(
|
|
computedOptions,
|
|
ellipsoid,
|
|
false,
|
|
row,
|
|
col,
|
|
position,
|
|
);
|
|
positions[posIndex++] = position.x;
|
|
positions[posIndex++] = position.y;
|
|
positions[posIndex++] = position.z;
|
|
}
|
|
|
|
const indicesSize = (positions.length / 3) * 2;
|
|
const indices = IndexDatatype.createTypedArray(
|
|
positions.length / 3,
|
|
indicesSize,
|
|
);
|
|
|
|
let index = 0;
|
|
for (let i = 0; i < positions.length / 3 - 1; i++) {
|
|
indices[index++] = i;
|
|
indices[index++] = i + 1;
|
|
}
|
|
indices[index++] = positions.length / 3 - 1;
|
|
indices[index++] = 0;
|
|
|
|
const geo = new Geometry({
|
|
attributes: new GeometryAttributes(),
|
|
primitiveType: PrimitiveType.LINES,
|
|
});
|
|
|
|
geo.attributes.position = new GeometryAttribute({
|
|
componentDatatype: ComponentDatatype.DOUBLE,
|
|
componentsPerAttribute: 3,
|
|
values: positions,
|
|
});
|
|
geo.indices = indices;
|
|
|
|
return geo;
|
|
}
|
|
|
|
function constructExtrudedRectangle(rectangleGeometry, computedOptions) {
|
|
const maxHeight = rectangleGeometry._surfaceHeight;
|
|
const minHeight = rectangleGeometry._extrudedHeight;
|
|
const ellipsoid = rectangleGeometry._ellipsoid;
|
|
const geo = constructRectangle(rectangleGeometry, computedOptions);
|
|
|
|
const height = computedOptions.height;
|
|
const width = computedOptions.width;
|
|
|
|
const topPositions = PolygonPipeline.scaleToGeodeticHeight(
|
|
geo.attributes.position.values,
|
|
maxHeight,
|
|
ellipsoid,
|
|
false,
|
|
);
|
|
let length = topPositions.length;
|
|
const positions = new Float64Array(length * 2);
|
|
positions.set(topPositions);
|
|
const bottomPositions = PolygonPipeline.scaleToGeodeticHeight(
|
|
geo.attributes.position.values,
|
|
minHeight,
|
|
ellipsoid,
|
|
);
|
|
positions.set(bottomPositions, length);
|
|
geo.attributes.position.values = positions;
|
|
|
|
const northCap = computedOptions.northCap;
|
|
const southCap = computedOptions.southCap;
|
|
let corners = 4;
|
|
if (northCap) {
|
|
corners -= 1;
|
|
}
|
|
if (southCap) {
|
|
corners -= 1;
|
|
}
|
|
|
|
const indicesSize = (positions.length / 3 + corners) * 2;
|
|
const indices = IndexDatatype.createTypedArray(
|
|
positions.length / 3,
|
|
indicesSize,
|
|
);
|
|
length = positions.length / 6;
|
|
let index = 0;
|
|
for (let i = 0; i < length - 1; i++) {
|
|
indices[index++] = i;
|
|
indices[index++] = i + 1;
|
|
indices[index++] = i + length;
|
|
indices[index++] = i + length + 1;
|
|
}
|
|
indices[index++] = length - 1;
|
|
indices[index++] = 0;
|
|
indices[index++] = length + length - 1;
|
|
indices[index++] = length;
|
|
|
|
indices[index++] = 0;
|
|
indices[index++] = length;
|
|
|
|
let bottomCorner;
|
|
if (northCap) {
|
|
bottomCorner = height - 1;
|
|
} else {
|
|
const topRightCorner = width - 1;
|
|
indices[index++] = topRightCorner;
|
|
indices[index++] = topRightCorner + length;
|
|
bottomCorner = width + height - 2;
|
|
}
|
|
|
|
indices[index++] = bottomCorner;
|
|
indices[index++] = bottomCorner + length;
|
|
|
|
if (!southCap) {
|
|
const bottomLeftCorner = width + bottomCorner - 1;
|
|
indices[index++] = bottomLeftCorner;
|
|
indices[index] = bottomLeftCorner + length;
|
|
}
|
|
|
|
geo.indices = indices;
|
|
|
|
return geo;
|
|
}
|
|
|
|
/**
|
|
* A description of the outline of a a cartographic rectangle on an ellipsoid centered at the origin.
|
|
*
|
|
* @alias RectangleOutlineGeometry
|
|
* @constructor
|
|
*
|
|
* @param {object} options Object with the following properties:
|
|
* @param {Rectangle} options.rectangle A cartographic rectangle with north, south, east and west properties in radians.
|
|
* @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid on which the rectangle lies.
|
|
* @param {number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
|
|
* @param {number} [options.height=0.0] The distance in meters between the rectangle and the ellipsoid surface.
|
|
* @param {number} [options.rotation=0.0] The rotation of the rectangle, in radians. A positive rotation is counter-clockwise.
|
|
* @param {number} [options.extrudedHeight] The distance in meters between the rectangle's extruded face and the ellipsoid surface.
|
|
*
|
|
* @exception {DeveloperError} <code>options.rectangle.north</code> must be in the interval [<code>-Pi/2</code>, <code>Pi/2</code>].
|
|
* @exception {DeveloperError} <code>options.rectangle.south</code> must be in the interval [<code>-Pi/2</code>, <code>Pi/2</code>].
|
|
* @exception {DeveloperError} <code>options.rectangle.east</code> must be in the interval [<code>-Pi</code>, <code>Pi</code>].
|
|
* @exception {DeveloperError} <code>options.rectangle.west</code> must be in the interval [<code>-Pi</code>, <code>Pi</code>].
|
|
* @exception {DeveloperError} <code>options.rectangle.north</code> must be greater than <code>rectangle.south</code>.
|
|
*
|
|
* @see RectangleOutlineGeometry#createGeometry
|
|
*
|
|
* @example
|
|
* const rectangle = new Cesium.RectangleOutlineGeometry({
|
|
* ellipsoid : Cesium.Ellipsoid.WGS84,
|
|
* rectangle : Cesium.Rectangle.fromDegrees(-80.0, 39.0, -74.0, 42.0),
|
|
* height : 10000.0
|
|
* });
|
|
* const geometry = Cesium.RectangleOutlineGeometry.createGeometry(rectangle);
|
|
*/
|
|
function RectangleOutlineGeometry(options) {
|
|
options = options ?? Frozen.EMPTY_OBJECT;
|
|
|
|
const rectangle = options.rectangle;
|
|
const granularity = options.granularity ?? CesiumMath.RADIANS_PER_DEGREE;
|
|
const ellipsoid = options.ellipsoid ?? Ellipsoid.default;
|
|
const rotation = options.rotation ?? 0.0;
|
|
|
|
//>>includeStart('debug', pragmas.debug);
|
|
if (!defined(rectangle)) {
|
|
throw new DeveloperError("rectangle is required.");
|
|
}
|
|
Rectangle._validate(rectangle);
|
|
if (rectangle.north < rectangle.south) {
|
|
throw new DeveloperError(
|
|
"options.rectangle.north must be greater than options.rectangle.south",
|
|
);
|
|
}
|
|
//>>includeEnd('debug');
|
|
|
|
const height = options.height ?? 0.0;
|
|
const extrudedHeight = options.extrudedHeight ?? height;
|
|
|
|
this._rectangle = Rectangle.clone(rectangle);
|
|
this._granularity = granularity;
|
|
this._ellipsoid = ellipsoid;
|
|
this._surfaceHeight = Math.max(height, extrudedHeight);
|
|
this._rotation = rotation;
|
|
this._extrudedHeight = Math.min(height, extrudedHeight);
|
|
this._offsetAttribute = options.offsetAttribute;
|
|
this._workerName = "createRectangleOutlineGeometry";
|
|
}
|
|
|
|
/**
|
|
* The number of elements used to pack the object into an array.
|
|
* @type {number}
|
|
*/
|
|
RectangleOutlineGeometry.packedLength =
|
|
Rectangle.packedLength + Ellipsoid.packedLength + 5;
|
|
|
|
/**
|
|
* Stores the provided instance into the provided array.
|
|
*
|
|
* @param {RectangleOutlineGeometry} 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
|
|
*/
|
|
RectangleOutlineGeometry.pack = function (value, array, startingIndex) {
|
|
//>>includeStart('debug', pragmas.debug);
|
|
if (!defined(value)) {
|
|
throw new DeveloperError("value is required");
|
|
}
|
|
|
|
if (!defined(array)) {
|
|
throw new DeveloperError("array is required");
|
|
}
|
|
//>>includeEnd('debug');
|
|
|
|
startingIndex = startingIndex ?? 0;
|
|
|
|
Rectangle.pack(value._rectangle, array, startingIndex);
|
|
startingIndex += Rectangle.packedLength;
|
|
|
|
Ellipsoid.pack(value._ellipsoid, array, startingIndex);
|
|
startingIndex += Ellipsoid.packedLength;
|
|
|
|
array[startingIndex++] = value._granularity;
|
|
array[startingIndex++] = value._surfaceHeight;
|
|
array[startingIndex++] = value._rotation;
|
|
array[startingIndex++] = value._extrudedHeight;
|
|
array[startingIndex] = value._offsetAttribute ?? -1;
|
|
|
|
return array;
|
|
};
|
|
|
|
const scratchRectangle = new Rectangle();
|
|
const scratchEllipsoid = Ellipsoid.clone(Ellipsoid.UNIT_SPHERE);
|
|
const scratchOptions = {
|
|
rectangle: scratchRectangle,
|
|
ellipsoid: scratchEllipsoid,
|
|
granularity: undefined,
|
|
height: undefined,
|
|
rotation: undefined,
|
|
extrudedHeight: 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 {RectangleOutlineGeometry} [result] The object into which to store the result.
|
|
* @returns {RectangleOutlineGeometry} The modified result parameter or a new RectangleOutlineGeometry instance if one was not provided.
|
|
*/
|
|
RectangleOutlineGeometry.unpack = function (array, startingIndex, result) {
|
|
//>>includeStart('debug', pragmas.debug);
|
|
if (!defined(array)) {
|
|
throw new DeveloperError("array is required");
|
|
}
|
|
//>>includeEnd('debug');
|
|
|
|
startingIndex = startingIndex ?? 0;
|
|
|
|
const rectangle = Rectangle.unpack(array, startingIndex, scratchRectangle);
|
|
startingIndex += Rectangle.packedLength;
|
|
|
|
const ellipsoid = Ellipsoid.unpack(array, startingIndex, scratchEllipsoid);
|
|
startingIndex += Ellipsoid.packedLength;
|
|
|
|
const granularity = array[startingIndex++];
|
|
const height = array[startingIndex++];
|
|
const rotation = array[startingIndex++];
|
|
const extrudedHeight = array[startingIndex++];
|
|
const offsetAttribute = array[startingIndex];
|
|
|
|
if (!defined(result)) {
|
|
scratchOptions.granularity = granularity;
|
|
scratchOptions.height = height;
|
|
scratchOptions.rotation = rotation;
|
|
scratchOptions.extrudedHeight = extrudedHeight;
|
|
scratchOptions.offsetAttribute =
|
|
offsetAttribute === -1 ? undefined : offsetAttribute;
|
|
|
|
return new RectangleOutlineGeometry(scratchOptions);
|
|
}
|
|
|
|
result._rectangle = Rectangle.clone(rectangle, result._rectangle);
|
|
result._ellipsoid = Ellipsoid.clone(ellipsoid, result._ellipsoid);
|
|
result._surfaceHeight = height;
|
|
result._rotation = rotation;
|
|
result._extrudedHeight = extrudedHeight;
|
|
result._offsetAttribute =
|
|
offsetAttribute === -1 ? undefined : offsetAttribute;
|
|
|
|
return result;
|
|
};
|
|
|
|
const nwScratch = new Cartographic();
|
|
/**
|
|
* Computes the geometric representation of an outline of a rectangle, including its vertices, indices, and a bounding sphere.
|
|
*
|
|
* @param {RectangleOutlineGeometry} rectangleGeometry A description of the rectangle outline.
|
|
* @returns {Geometry|undefined} The computed vertices and indices.
|
|
*
|
|
* @exception {DeveloperError} Rotated rectangle is invalid.
|
|
*/
|
|
RectangleOutlineGeometry.createGeometry = function (rectangleGeometry) {
|
|
const rectangle = rectangleGeometry._rectangle;
|
|
const ellipsoid = rectangleGeometry._ellipsoid;
|
|
const computedOptions = RectangleGeometryLibrary.computeOptions(
|
|
rectangle,
|
|
rectangleGeometry._granularity,
|
|
rectangleGeometry._rotation,
|
|
0,
|
|
rectangleScratch,
|
|
nwScratch,
|
|
);
|
|
|
|
let geometry;
|
|
let boundingSphere;
|
|
|
|
if (
|
|
CesiumMath.equalsEpsilon(
|
|
rectangle.north,
|
|
rectangle.south,
|
|
CesiumMath.EPSILON10,
|
|
) ||
|
|
CesiumMath.equalsEpsilon(
|
|
rectangle.east,
|
|
rectangle.west,
|
|
CesiumMath.EPSILON10,
|
|
)
|
|
) {
|
|
return undefined;
|
|
}
|
|
|
|
const surfaceHeight = rectangleGeometry._surfaceHeight;
|
|
const extrudedHeight = rectangleGeometry._extrudedHeight;
|
|
const extrude = !CesiumMath.equalsEpsilon(
|
|
surfaceHeight,
|
|
extrudedHeight,
|
|
0,
|
|
CesiumMath.EPSILON2,
|
|
);
|
|
let offsetValue;
|
|
if (extrude) {
|
|
geometry = constructExtrudedRectangle(rectangleGeometry, computedOptions);
|
|
if (defined(rectangleGeometry._offsetAttribute)) {
|
|
const size = geometry.attributes.position.values.length / 3;
|
|
let offsetAttribute = new Uint8Array(size);
|
|
if (rectangleGeometry._offsetAttribute === GeometryOffsetAttribute.TOP) {
|
|
offsetAttribute = offsetAttribute.fill(1, 0, size / 2);
|
|
} else {
|
|
offsetValue =
|
|
rectangleGeometry._offsetAttribute === GeometryOffsetAttribute.NONE
|
|
? 0
|
|
: 1;
|
|
offsetAttribute = offsetAttribute.fill(offsetValue);
|
|
}
|
|
|
|
geometry.attributes.applyOffset = new GeometryAttribute({
|
|
componentDatatype: ComponentDatatype.UNSIGNED_BYTE,
|
|
componentsPerAttribute: 1,
|
|
values: offsetAttribute,
|
|
});
|
|
}
|
|
const topBS = BoundingSphere.fromRectangle3D(
|
|
rectangle,
|
|
ellipsoid,
|
|
surfaceHeight,
|
|
topBoundingSphere,
|
|
);
|
|
const bottomBS = BoundingSphere.fromRectangle3D(
|
|
rectangle,
|
|
ellipsoid,
|
|
extrudedHeight,
|
|
bottomBoundingSphere,
|
|
);
|
|
boundingSphere = BoundingSphere.union(topBS, bottomBS);
|
|
} else {
|
|
geometry = constructRectangle(rectangleGeometry, computedOptions);
|
|
geometry.attributes.position.values = PolygonPipeline.scaleToGeodeticHeight(
|
|
geometry.attributes.position.values,
|
|
surfaceHeight,
|
|
ellipsoid,
|
|
false,
|
|
);
|
|
|
|
if (defined(rectangleGeometry._offsetAttribute)) {
|
|
const length = geometry.attributes.position.values.length;
|
|
offsetValue =
|
|
rectangleGeometry._offsetAttribute === GeometryOffsetAttribute.NONE
|
|
? 0
|
|
: 1;
|
|
const applyOffset = new Uint8Array(length / 3).fill(offsetValue);
|
|
geometry.attributes.applyOffset = new GeometryAttribute({
|
|
componentDatatype: ComponentDatatype.UNSIGNED_BYTE,
|
|
componentsPerAttribute: 1,
|
|
values: applyOffset,
|
|
});
|
|
}
|
|
|
|
boundingSphere = BoundingSphere.fromRectangle3D(
|
|
rectangle,
|
|
ellipsoid,
|
|
surfaceHeight,
|
|
);
|
|
}
|
|
|
|
return new Geometry({
|
|
attributes: geometry.attributes,
|
|
indices: geometry.indices,
|
|
primitiveType: PrimitiveType.LINES,
|
|
boundingSphere: boundingSphere,
|
|
offsetAttribute: rectangleGeometry._offsetAttribute,
|
|
});
|
|
};
|
|
export default RectangleOutlineGeometry;
|