import defaultValue from "../Core/defaultValue.js"; import defined from "../Core/defined.js"; import DeveloperError from "../Core/DeveloperError.js"; import Event from "../Core/Event.js"; import EventHelper from "../Core/EventHelper.js"; import ReferenceFrame from "../Core/ReferenceFrame.js"; import Property from "./Property.js"; /** * A {@link Property} whose value is an array whose items are the computed value * of other PositionProperty instances. * * @alias PositionPropertyArray * @constructor * * @param {Property[]} [value] An array of Property instances. * @param {ReferenceFrame} [referenceFrame=ReferenceFrame.FIXED] The reference frame in which the position is defined. */ function PositionPropertyArray(value, referenceFrame) { this._value = undefined; this._definitionChanged = new Event(); this._eventHelper = new EventHelper(); this._referenceFrame = defaultValue(referenceFrame, ReferenceFrame.FIXED); this.setValue(value); } Object.defineProperties(PositionPropertyArray.prototype, { /** * Gets a value indicating if this property is constant. This property * is considered constant if all property items in the array are constant. * @memberof PositionPropertyArray.prototype * * @type {boolean} * @readonly */ isConstant: { get: function () { const value = this._value; if (!defined(value)) { return true; } const length = value.length; for (let i = 0; i < length; i++) { if (!Property.isConstant(value[i])) { return false; } } return true; }, }, /** * Gets the event that is raised whenever the definition of this property changes. * The definition is changed whenever setValue is called with data different * than the current value or one of the properties in the array also changes. * @memberof PositionPropertyArray.prototype * * @type {Event} * @readonly */ definitionChanged: { get: function () { return this._definitionChanged; }, }, /** * Gets the reference frame in which the position is defined. * @memberof PositionPropertyArray.prototype * @type {ReferenceFrame} * @default ReferenceFrame.FIXED; */ referenceFrame: { get: function () { return this._referenceFrame; }, }, }); /** * Gets the value of the property. * * @param {JulianDate} time The time for which to retrieve the value. * @param {Cartesian3[]} [result] The object to store the value into, if omitted, a new instance is created and returned. * @returns {Cartesian3[]} The modified result parameter or a new instance if the result parameter was not supplied. */ PositionPropertyArray.prototype.getValue = function (time, result) { return this.getValueInReferenceFrame(time, ReferenceFrame.FIXED, result); }; /** * Gets the value of the property at the provided time and in the provided reference frame. * * @param {JulianDate} time The time for which to retrieve the value. * @param {ReferenceFrame} referenceFrame The desired referenceFrame of the result. * @param {Cartesian3[]} [result] The object to store the value into, if omitted, a new instance is created and returned. * @returns {Cartesian3[]} The modified result parameter or a new instance if the result parameter was not supplied. */ PositionPropertyArray.prototype.getValueInReferenceFrame = function ( time, referenceFrame, result ) { //>>includeStart('debug', pragmas.debug); if (!defined(time)) { throw new DeveloperError("time is required."); } if (!defined(referenceFrame)) { throw new DeveloperError("referenceFrame is required."); } //>>includeEnd('debug'); const value = this._value; if (!defined(value)) { return undefined; } const length = value.length; if (!defined(result)) { result = new Array(length); } let i = 0; let x = 0; while (i < length) { const property = value[i]; const itemValue = property.getValueInReferenceFrame( time, referenceFrame, result[i] ); if (defined(itemValue)) { result[x] = itemValue; x++; } i++; } result.length = x; return result; }; /** * Sets the value of the property. * * @param {Property[]} value An array of Property instances. */ PositionPropertyArray.prototype.setValue = function (value) { const eventHelper = this._eventHelper; eventHelper.removeAll(); if (defined(value)) { this._value = value.slice(); const length = value.length; for (let i = 0; i < length; i++) { const property = value[i]; if (defined(property)) { eventHelper.add( property.definitionChanged, PositionPropertyArray.prototype._raiseDefinitionChanged, this ); } } } else { this._value = undefined; } this._definitionChanged.raiseEvent(this); }; /** * Compares this property to the provided property and returns * true if they are equal, false otherwise. * * @param {Property} [other] The other property. * @returns {boolean} true if left and right are equal, false otherwise. */ PositionPropertyArray.prototype.equals = function (other) { return ( this === other || // (other instanceof PositionPropertyArray && // this._referenceFrame === other._referenceFrame && // Property.arrayEquals(this._value, other._value)) ); }; PositionPropertyArray.prototype._raiseDefinitionChanged = function () { this._definitionChanged.raiseEvent(this); }; export default PositionPropertyArray;