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