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;
|