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; this.textureCoordinates = 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.textureCoordinates) || // !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 ); options.textureCoordinates = Property.getValueOrUndefined( polygon.textureCoordinates, Iso8601.MINIMUM_VALUE ); 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.textureCoordinates = Property.getValueOrUndefined( polygon.textureCoordinates, 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;