import BoundingSphere from '../Core/BoundingSphere.js'; import Check from '../Core/Check.js'; import defined from '../Core/defined.js'; import destroyObject from '../Core/destroyObject.js'; import DeveloperError from '../Core/DeveloperError.js'; import GroundPrimitive from '../Scene/GroundPrimitive.js'; import MaterialAppearance from '../Scene/MaterialAppearance.js'; import PerInstanceColorAppearance from '../Scene/PerInstanceColorAppearance.js'; import Primitive from '../Scene/Primitive.js'; import BoundingSphereState from './BoundingSphereState.js'; import ColorMaterialProperty from './ColorMaterialProperty.js'; import MaterialProperty from './MaterialProperty.js'; import Property from './Property.js'; /** * Defines the interface for a dynamic geometry updater. A DynamicGeometryUpdater * is responsible for handling visualization of a specific type of geometry * that needs to be recomputed based on simulation time. * This object is never used directly by client code, but is instead created by * {@link GeometryUpdater} implementations which contain dynamic geometry. * * This type defines an interface and cannot be instantiated directly. * * @alias DynamicGeometryUpdater * @constructor * @private * @abstract */ function DynamicGeometryUpdater(geometryUpdater, primitives, orderedGroundPrimitives) { //>>includeStart('debug', pragmas.debug); Check.defined('geometryUpdater', geometryUpdater); Check.defined('primitives', primitives); Check.defined('orderedGroundPrimitives', orderedGroundPrimitives); //>>includeEnd('debug'); this._primitives = primitives; this._orderedGroundPrimitives = orderedGroundPrimitives; this._primitive = undefined; this._outlinePrimitive = undefined; this._geometryUpdater = geometryUpdater; this._options = geometryUpdater._options; this._entity = geometryUpdater._entity; this._material = undefined; } DynamicGeometryUpdater.prototype._isHidden = function(entity, geometry, time) { return !entity.isShowing || !entity.isAvailable(time) || !Property.getValueOrDefault(geometry.show, time, true); }; DynamicGeometryUpdater.prototype._setOptions = DeveloperError.throwInstantiationError; /** * Updates the geometry to the specified time. * @memberof DynamicGeometryUpdater * @function * * @param {JulianDate} time The current time. */ DynamicGeometryUpdater.prototype.update = function(time) { //>>includeStart('debug', pragmas.debug); Check.defined('time', time); //>>includeEnd('debug'); var geometryUpdater = this._geometryUpdater; var onTerrain = geometryUpdater._onTerrain; var primitives = this._primitives; var orderedGroundPrimitives = this._orderedGroundPrimitives; if (onTerrain) { orderedGroundPrimitives.remove(this._primitive); } else { primitives.removeAndDestroy(this._primitive); primitives.removeAndDestroy(this._outlinePrimitive); this._outlinePrimitive = undefined; } this._primitive = undefined; var entity = this._entity; var geometry = entity[this._geometryUpdater._geometryPropertyName]; this._setOptions(entity, geometry, time); if (this._isHidden(entity, geometry, time)) { return; } var shadows = this._geometryUpdater.shadowsProperty.getValue(time); var options = this._options; if (!defined(geometry.fill) || geometry.fill.getValue(time)) { var fillMaterialProperty = geometryUpdater.fillMaterialProperty; var isColorAppearance = fillMaterialProperty instanceof ColorMaterialProperty; var appearance; var closed = geometryUpdater._getIsClosed(options); if (isColorAppearance) { appearance = new PerInstanceColorAppearance({ closed: closed, flat : onTerrain && !geometryUpdater._supportsMaterialsforEntitiesOnTerrain }); } else { var material = MaterialProperty.getValue(time, fillMaterialProperty, this._material); this._material = material; appearance = new MaterialAppearance({ material : material, translucent : material.isTranslucent(), closed : closed }); } if (onTerrain) { options.vertexFormat = PerInstanceColorAppearance.VERTEX_FORMAT; this._primitive = orderedGroundPrimitives.add(new GroundPrimitive({ geometryInstances : this._geometryUpdater.createFillGeometryInstance(time), appearance : appearance, asynchronous : false, shadows : shadows, classificationType : this._geometryUpdater.classificationTypeProperty.getValue(time) }), Property.getValueOrUndefined(this._geometryUpdater.zIndex, time)); } else { options.vertexFormat = appearance.vertexFormat; var fillInstance = this._geometryUpdater.createFillGeometryInstance(time); if (isColorAppearance) { appearance.translucent = fillInstance.attributes.color.value[3] !== 255; } this._primitive = primitives.add(new Primitive({ geometryInstances : fillInstance, appearance : appearance, asynchronous : false, shadows : shadows })); } } if (!onTerrain && defined(geometry.outline) && geometry.outline.getValue(time)) { var outlineInstance = this._geometryUpdater.createOutlineGeometryInstance(time); var outlineWidth = Property.getValueOrDefault(geometry.outlineWidth, time, 1.0); this._outlinePrimitive = primitives.add(new Primitive({ geometryInstances : outlineInstance, appearance : new PerInstanceColorAppearance({ flat : true, translucent : outlineInstance.attributes.color.value[3] !== 255, renderState : { lineWidth : geometryUpdater._scene.clampLineWidth(outlineWidth) } }), asynchronous : false, shadows : shadows })); } }; /** * Computes a bounding sphere which encloses the visualization produced for the specified entity. * The bounding sphere is in the fixed frame of the scene's globe. * @function * * @param {BoundingSphere} result The bounding sphere onto which to store the result. * @returns {BoundingSphereState} BoundingSphereState.DONE if the result contains the bounding sphere, * BoundingSphereState.PENDING if the result is still being computed, or * BoundingSphereState.FAILED if the entity has no visualization in the current scene. * @private */ DynamicGeometryUpdater.prototype.getBoundingSphere = function(result) { //>>includeStart('debug', pragmas.debug); if (!defined(result)) { throw new DeveloperError('result is required.'); } //>>includeEnd('debug'); var entity = this._entity; var primitive = this._primitive; var outlinePrimitive = this._outlinePrimitive; var attributes; //Outline and Fill geometries have the same bounding sphere, so just use whichever one is defined and ready if (defined(primitive) && primitive.show && primitive.ready) { attributes = primitive.getGeometryInstanceAttributes(entity); if (defined(attributes) && defined(attributes.boundingSphere)) { BoundingSphere.clone(attributes.boundingSphere, result); return BoundingSphereState.DONE; } } if (defined(outlinePrimitive) && outlinePrimitive.show && outlinePrimitive.ready) { attributes = outlinePrimitive.getGeometryInstanceAttributes(entity); if (defined(attributes) && defined(attributes.boundingSphere)) { BoundingSphere.clone(attributes.boundingSphere, result); return BoundingSphereState.DONE; } } if ((defined(primitive) && !primitive.ready) || (defined(outlinePrimitive) && !outlinePrimitive.ready)) { return BoundingSphereState.PENDING; } return BoundingSphereState.FAILED; }; /** * Returns true if this object was destroyed; otherwise, false. * @memberof DynamicGeometryUpdater * @function * * @returns {Boolean} True if this object was destroyed; otherwise, false. */ DynamicGeometryUpdater.prototype.isDestroyed = function() { return false; }; /** * Destroys and resources used by the object. Once an object is destroyed, it should not be used. * @memberof DynamicGeometryUpdater * @function * * @exception {DeveloperError} This object was destroyed, i.e., destroy() was called. */ DynamicGeometryUpdater.prototype.destroy = function() { var primitives = this._primitives; var orderedGroundPrimitives = this._orderedGroundPrimitives; if (this._geometryUpdater._onTerrain) { orderedGroundPrimitives.remove(this._primitive); } else { primitives.removeAndDestroy(this._primitive); } primitives.removeAndDestroy(this._outlinePrimitive); destroyObject(this); }; export default DynamicGeometryUpdater;