123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565 |
- import ApproximateTerrainHeights from "../Core/ApproximateTerrainHeights.js";
- import ArcType from "../Core/ArcType.js";
- import Cartesian2 from "../Core/Cartesian2.js";
- import Cartesian3 from "../Core/Cartesian3.js";
- import Check from "../Core/Check.js";
- import Color from "../Core/Color.js";
- import ColorGeometryInstanceAttribute from "../Core/ColorGeometryInstanceAttribute.js";
- import CoplanarPolygonGeometry from "../Core/CoplanarPolygonGeometry.js";
- import CoplanarPolygonOutlineGeometry from "../Core/CoplanarPolygonOutlineGeometry.js";
- import defined from "../Core/defined.js";
- import DeveloperError from "../Core/DeveloperError.js";
- import DistanceDisplayConditionGeometryInstanceAttribute from "../Core/DistanceDisplayConditionGeometryInstanceAttribute.js";
- import EllipsoidTangentPlane from "../Core/EllipsoidTangentPlane.js";
- import GeometryInstance from "../Core/GeometryInstance.js";
- import Iso8601 from "../Core/Iso8601.js";
- import OffsetGeometryInstanceAttribute from "../Core/OffsetGeometryInstanceAttribute.js";
- import oneTimeWarning from "../Core/oneTimeWarning.js";
- import PolygonGeometry from "../Core/PolygonGeometry.js";
- import PolygonOutlineGeometry from "../Core/PolygonOutlineGeometry.js";
- import Rectangle from "../Core/Rectangle.js";
- import ShowGeometryInstanceAttribute from "../Core/ShowGeometryInstanceAttribute.js";
- import HeightReference from "../Scene/HeightReference.js";
- import MaterialAppearance from "../Scene/MaterialAppearance.js";
- import PerInstanceColorAppearance from "../Scene/PerInstanceColorAppearance.js";
- import ColorMaterialProperty from "./ColorMaterialProperty.js";
- import DynamicGeometryUpdater from "./DynamicGeometryUpdater.js";
- import GeometryUpdater from "./GeometryUpdater.js";
- import GroundGeometryUpdater from "./GroundGeometryUpdater.js";
- import Property from "./Property.js";
- const heightAndPerPositionHeightWarning =
- "Entity polygons cannot have both height and perPositionHeight. height will be ignored";
- const heightReferenceAndPerPositionHeightWarning =
- "heightReference is not supported for entity polygons with perPositionHeight. heightReference will be ignored";
- const scratchColor = new Color();
- const defaultOffset = Cartesian3.ZERO;
- const offsetScratch = new Cartesian3();
- const scratchRectangle = new Rectangle();
- const scratch2DPositions = [];
- const cart2Scratch = new Cartesian2();
- function PolygonGeometryOptions(entity) {
- this.id = entity;
- this.vertexFormat = undefined;
- this.polygonHierarchy = undefined;
- this.perPositionHeight = undefined;
- this.closeTop = undefined;
- this.closeBottom = undefined;
- this.height = undefined;
- this.extrudedHeight = undefined;
- this.granularity = undefined;
- this.stRotation = undefined;
- this.offsetAttribute = undefined;
- this.arcType = undefined;
- }
- /**
- * A {@link GeometryUpdater} for polygons.
- * Clients do not normally create this class directly, but instead rely on {@link DataSourceDisplay}.
- * @alias PolygonGeometryUpdater
- * @constructor
- *
- * @param {Entity} entity The entity containing the geometry to be visualized.
- * @param {Scene} scene The scene where visualization is taking place.
- */
- function PolygonGeometryUpdater(entity, scene) {
- GroundGeometryUpdater.call(this, {
- entity: entity,
- scene: scene,
- geometryOptions: new PolygonGeometryOptions(entity),
- geometryPropertyName: "polygon",
- observedPropertyNames: ["availability", "polygon"],
- });
- this._onEntityPropertyChanged(entity, "polygon", entity.polygon, undefined);
- }
- if (defined(Object.create)) {
- PolygonGeometryUpdater.prototype = Object.create(
- GroundGeometryUpdater.prototype
- );
- PolygonGeometryUpdater.prototype.constructor = PolygonGeometryUpdater;
- }
- /**
- * Creates the geometry instance which represents the fill of the geometry.
- *
- * @param {JulianDate} time The time to use when retrieving initial attribute values.
- * @returns {GeometryInstance} The geometry instance representing the filled portion of the geometry.
- *
- * @exception {DeveloperError} This instance does not represent a filled geometry.
- */
- PolygonGeometryUpdater.prototype.createFillGeometryInstance = function (time) {
- //>>includeStart('debug', pragmas.debug);
- Check.defined("time", time);
- if (!this._fillEnabled) {
- throw new DeveloperError(
- "This instance does not represent a filled geometry."
- );
- }
- //>>includeEnd('debug');
- const entity = this._entity;
- const isAvailable = entity.isAvailable(time);
- const options = this._options;
- const attributes = {
- show: new ShowGeometryInstanceAttribute(
- isAvailable &&
- entity.isShowing &&
- this._showProperty.getValue(time) &&
- this._fillProperty.getValue(time)
- ),
- distanceDisplayCondition: DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
- this._distanceDisplayConditionProperty.getValue(time)
- ),
- offset: undefined,
- color: undefined,
- };
- if (this._materialProperty instanceof ColorMaterialProperty) {
- let currentColor;
- if (
- defined(this._materialProperty.color) &&
- (this._materialProperty.color.isConstant || isAvailable)
- ) {
- currentColor = this._materialProperty.color.getValue(time, scratchColor);
- }
- if (!defined(currentColor)) {
- currentColor = Color.WHITE;
- }
- attributes.color = ColorGeometryInstanceAttribute.fromColor(currentColor);
- }
- if (defined(options.offsetAttribute)) {
- attributes.offset = OffsetGeometryInstanceAttribute.fromCartesian3(
- Property.getValueOrDefault(
- this._terrainOffsetProperty,
- time,
- defaultOffset,
- offsetScratch
- )
- );
- }
- let geometry;
- if (options.perPositionHeight && !defined(options.extrudedHeight)) {
- geometry = new CoplanarPolygonGeometry(options);
- } else {
- geometry = new PolygonGeometry(options);
- }
- return new GeometryInstance({
- id: entity,
- geometry: geometry,
- attributes: attributes,
- });
- };
- /**
- * Creates the geometry instance which represents the outline of the geometry.
- *
- * @param {JulianDate} time The time to use when retrieving initial attribute values.
- * @returns {GeometryInstance} The geometry instance representing the outline portion of the geometry.
- *
- * @exception {DeveloperError} This instance does not represent an outlined geometry.
- */
- PolygonGeometryUpdater.prototype.createOutlineGeometryInstance = function (
- time
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.defined("time", time);
- if (!this._outlineEnabled) {
- throw new DeveloperError(
- "This instance does not represent an outlined geometry."
- );
- }
- //>>includeEnd('debug');
- const entity = this._entity;
- const isAvailable = entity.isAvailable(time);
- const options = this._options;
- const outlineColor = Property.getValueOrDefault(
- this._outlineColorProperty,
- time,
- Color.BLACK,
- scratchColor
- );
- const distanceDisplayCondition = this._distanceDisplayConditionProperty.getValue(
- time
- );
- const attributes = {
- show: new ShowGeometryInstanceAttribute(
- isAvailable &&
- entity.isShowing &&
- this._showProperty.getValue(time) &&
- this._showOutlineProperty.getValue(time)
- ),
- color: ColorGeometryInstanceAttribute.fromColor(outlineColor),
- distanceDisplayCondition: DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
- distanceDisplayCondition
- ),
- offset: undefined,
- };
- if (defined(options.offsetAttribute)) {
- attributes.offset = OffsetGeometryInstanceAttribute.fromCartesian3(
- Property.getValueOrDefault(
- this._terrainOffsetProperty,
- time,
- defaultOffset,
- offsetScratch
- )
- );
- }
- let geometry;
- if (options.perPositionHeight && !defined(options.extrudedHeight)) {
- geometry = new CoplanarPolygonOutlineGeometry(options);
- } else {
- geometry = new PolygonOutlineGeometry(options);
- }
- return new GeometryInstance({
- id: entity,
- geometry: geometry,
- attributes: attributes,
- });
- };
- PolygonGeometryUpdater.prototype._computeCenter = function (time, result) {
- const hierarchy = Property.getValueOrUndefined(
- this._entity.polygon.hierarchy,
- time
- );
- if (!defined(hierarchy)) {
- return;
- }
- const positions = hierarchy.positions;
- if (positions.length === 0) {
- return;
- }
- const ellipsoid = this._scene.mapProjection.ellipsoid;
- const tangentPlane = EllipsoidTangentPlane.fromPoints(positions, ellipsoid);
- const positions2D = tangentPlane.projectPointsOntoPlane(
- positions,
- scratch2DPositions
- );
- const length = positions2D.length;
- let area = 0;
- let j = length - 1;
- let centroid2D = new Cartesian2();
- for (let i = 0; i < length; j = i++) {
- const p1 = positions2D[i];
- const p2 = positions2D[j];
- const f = p1.x * p2.y - p2.x * p1.y;
- let sum = Cartesian2.add(p1, p2, cart2Scratch);
- sum = Cartesian2.multiplyByScalar(sum, f, sum);
- centroid2D = Cartesian2.add(centroid2D, sum, centroid2D);
- area += f;
- }
- const a = 1.0 / (area * 3.0);
- centroid2D = Cartesian2.multiplyByScalar(centroid2D, a, centroid2D);
- return tangentPlane.projectPointOntoEllipsoid(centroid2D, result);
- };
- PolygonGeometryUpdater.prototype._isHidden = function (entity, polygon) {
- return (
- !defined(polygon.hierarchy) ||
- GeometryUpdater.prototype._isHidden.call(this, entity, polygon)
- );
- };
- PolygonGeometryUpdater.prototype._isOnTerrain = function (entity, polygon) {
- const onTerrain = GroundGeometryUpdater.prototype._isOnTerrain.call(
- this,
- entity,
- polygon
- );
- const perPositionHeightProperty = polygon.perPositionHeight;
- const perPositionHeightEnabled =
- defined(perPositionHeightProperty) &&
- (perPositionHeightProperty.isConstant
- ? perPositionHeightProperty.getValue(Iso8601.MINIMUM_VALUE)
- : true);
- return onTerrain && !perPositionHeightEnabled;
- };
- PolygonGeometryUpdater.prototype._isDynamic = function (entity, polygon) {
- return (
- !polygon.hierarchy.isConstant || //
- !Property.isConstant(polygon.height) || //
- !Property.isConstant(polygon.extrudedHeight) || //
- !Property.isConstant(polygon.granularity) || //
- !Property.isConstant(polygon.stRotation) || //
- !Property.isConstant(polygon.outlineWidth) || //
- !Property.isConstant(polygon.perPositionHeight) || //
- !Property.isConstant(polygon.closeTop) || //
- !Property.isConstant(polygon.closeBottom) || //
- !Property.isConstant(polygon.zIndex) || //
- !Property.isConstant(polygon.arcType) || //
- (this._onTerrain &&
- !Property.isConstant(this._materialProperty) &&
- !(this._materialProperty instanceof ColorMaterialProperty))
- );
- };
- PolygonGeometryUpdater.prototype._setStaticOptions = function (
- entity,
- polygon
- ) {
- const isColorMaterial =
- this._materialProperty instanceof ColorMaterialProperty;
- const options = this._options;
- options.vertexFormat = isColorMaterial
- ? PerInstanceColorAppearance.VERTEX_FORMAT
- : MaterialAppearance.MaterialSupport.TEXTURED.vertexFormat;
- const hierarchyValue = polygon.hierarchy.getValue(Iso8601.MINIMUM_VALUE);
- let heightValue = Property.getValueOrUndefined(
- polygon.height,
- Iso8601.MINIMUM_VALUE
- );
- const heightReferenceValue = Property.getValueOrDefault(
- polygon.heightReference,
- Iso8601.MINIMUM_VALUE,
- HeightReference.NONE
- );
- let extrudedHeightValue = Property.getValueOrUndefined(
- polygon.extrudedHeight,
- Iso8601.MINIMUM_VALUE
- );
- const extrudedHeightReferenceValue = Property.getValueOrDefault(
- polygon.extrudedHeightReference,
- Iso8601.MINIMUM_VALUE,
- HeightReference.NONE
- );
- const perPositionHeightValue = Property.getValueOrDefault(
- polygon.perPositionHeight,
- Iso8601.MINIMUM_VALUE,
- false
- );
- heightValue = GroundGeometryUpdater.getGeometryHeight(
- heightValue,
- heightReferenceValue
- );
- let offsetAttribute;
- if (perPositionHeightValue) {
- if (defined(heightValue)) {
- heightValue = undefined;
- oneTimeWarning(heightAndPerPositionHeightWarning);
- }
- if (
- heightReferenceValue !== HeightReference.NONE &&
- perPositionHeightValue
- ) {
- heightValue = undefined;
- oneTimeWarning(heightReferenceAndPerPositionHeightWarning);
- }
- } else {
- if (defined(extrudedHeightValue) && !defined(heightValue)) {
- heightValue = 0;
- }
- offsetAttribute = GroundGeometryUpdater.computeGeometryOffsetAttribute(
- heightValue,
- heightReferenceValue,
- extrudedHeightValue,
- extrudedHeightReferenceValue
- );
- }
- options.polygonHierarchy = hierarchyValue;
- options.granularity = Property.getValueOrUndefined(
- polygon.granularity,
- Iso8601.MINIMUM_VALUE
- );
- options.stRotation = Property.getValueOrUndefined(
- polygon.stRotation,
- Iso8601.MINIMUM_VALUE
- );
- options.perPositionHeight = perPositionHeightValue;
- options.closeTop = Property.getValueOrDefault(
- polygon.closeTop,
- Iso8601.MINIMUM_VALUE,
- true
- );
- options.closeBottom = Property.getValueOrDefault(
- polygon.closeBottom,
- Iso8601.MINIMUM_VALUE,
- true
- );
- options.offsetAttribute = offsetAttribute;
- options.height = heightValue;
- options.arcType = Property.getValueOrDefault(
- polygon.arcType,
- Iso8601.MINIMUM_VALUE,
- ArcType.GEODESIC
- );
- extrudedHeightValue = GroundGeometryUpdater.getGeometryExtrudedHeight(
- extrudedHeightValue,
- extrudedHeightReferenceValue
- );
- if (extrudedHeightValue === GroundGeometryUpdater.CLAMP_TO_GROUND) {
- extrudedHeightValue = ApproximateTerrainHeights.getMinimumMaximumHeights(
- PolygonGeometry.computeRectangle(options, scratchRectangle)
- ).minimumTerrainHeight;
- }
- options.extrudedHeight = extrudedHeightValue;
- };
- PolygonGeometryUpdater.prototype._getIsClosed = function (options) {
- const height = options.height;
- const extrudedHeight = options.extrudedHeight;
- const isExtruded = defined(extrudedHeight) && extrudedHeight !== height;
- return (
- !options.perPositionHeight &&
- ((!isExtruded && height === 0) ||
- (isExtruded && options.closeTop && options.closeBottom))
- );
- };
- PolygonGeometryUpdater.DynamicGeometryUpdater = DyanmicPolygonGeometryUpdater;
- /**
- * @private
- */
- function DyanmicPolygonGeometryUpdater(
- geometryUpdater,
- primitives,
- groundPrimitives
- ) {
- DynamicGeometryUpdater.call(
- this,
- geometryUpdater,
- primitives,
- groundPrimitives
- );
- }
- if (defined(Object.create)) {
- DyanmicPolygonGeometryUpdater.prototype = Object.create(
- DynamicGeometryUpdater.prototype
- );
- DyanmicPolygonGeometryUpdater.prototype.constructor = DyanmicPolygonGeometryUpdater;
- }
- DyanmicPolygonGeometryUpdater.prototype._isHidden = function (
- entity,
- polygon,
- time
- ) {
- return (
- !defined(this._options.polygonHierarchy) ||
- DynamicGeometryUpdater.prototype._isHidden.call(this, entity, polygon, time)
- );
- };
- DyanmicPolygonGeometryUpdater.prototype._setOptions = function (
- entity,
- polygon,
- time
- ) {
- const options = this._options;
- options.polygonHierarchy = Property.getValueOrUndefined(
- polygon.hierarchy,
- time
- );
- let heightValue = Property.getValueOrUndefined(polygon.height, time);
- const heightReferenceValue = Property.getValueOrDefault(
- polygon.heightReference,
- time,
- HeightReference.NONE
- );
- const extrudedHeightReferenceValue = Property.getValueOrDefault(
- polygon.extrudedHeightReference,
- time,
- HeightReference.NONE
- );
- let extrudedHeightValue = Property.getValueOrUndefined(
- polygon.extrudedHeight,
- time
- );
- const perPositionHeightValue = Property.getValueOrUndefined(
- polygon.perPositionHeight,
- time
- );
- heightValue = GroundGeometryUpdater.getGeometryHeight(
- heightValue,
- extrudedHeightReferenceValue
- );
- let offsetAttribute;
- if (perPositionHeightValue) {
- if (defined(heightValue)) {
- heightValue = undefined;
- oneTimeWarning(heightAndPerPositionHeightWarning);
- }
- if (
- heightReferenceValue !== HeightReference.NONE &&
- perPositionHeightValue
- ) {
- heightValue = undefined;
- oneTimeWarning(heightReferenceAndPerPositionHeightWarning);
- }
- } else {
- if (defined(extrudedHeightValue) && !defined(heightValue)) {
- heightValue = 0;
- }
- offsetAttribute = GroundGeometryUpdater.computeGeometryOffsetAttribute(
- heightValue,
- heightReferenceValue,
- extrudedHeightValue,
- extrudedHeightReferenceValue
- );
- }
- options.granularity = Property.getValueOrUndefined(polygon.granularity, time);
- options.stRotation = Property.getValueOrUndefined(polygon.stRotation, time);
- options.perPositionHeight = Property.getValueOrUndefined(
- polygon.perPositionHeight,
- time
- );
- options.closeTop = Property.getValueOrDefault(polygon.closeTop, time, true);
- options.closeBottom = Property.getValueOrDefault(
- polygon.closeBottom,
- time,
- true
- );
- options.offsetAttribute = offsetAttribute;
- options.height = heightValue;
- options.arcType = Property.getValueOrDefault(
- polygon.arcType,
- time,
- ArcType.GEODESIC
- );
- extrudedHeightValue = GroundGeometryUpdater.getGeometryExtrudedHeight(
- extrudedHeightValue,
- extrudedHeightReferenceValue
- );
- if (extrudedHeightValue === GroundGeometryUpdater.CLAMP_TO_GROUND) {
- extrudedHeightValue = ApproximateTerrainHeights.getMinimumMaximumHeights(
- PolygonGeometry.computeRectangle(options, scratchRectangle)
- ).minimumTerrainHeight;
- }
- options.extrudedHeight = extrudedHeightValue;
- };
- export default PolygonGeometryUpdater;
|