import defaultValue from "../Core/defaultValue.js"; import defined from "../Core/defined.js"; import Event from "../Core/Event.js"; import TranslationRotationScale from "../Core/TranslationRotationScale.js"; import createPropertyDescriptor from "./createPropertyDescriptor.js"; import Property from "./Property.js"; const defaultNodeTransformation = new TranslationRotationScale(); /** * A {@link Property} that produces {@link TranslationRotationScale} data. * @alias NodeTransformationProperty * @constructor * * @param {object} [options] Object with the following properties: * @param {Property|Cartesian3} [options.translation=Cartesian3.ZERO] A {@link Cartesian3} Property specifying the (x, y, z) translation to apply to the node. * @param {Property|Quaternion} [options.rotation=Quaternion.IDENTITY] A {@link Quaternion} Property specifying the (x, y, z, w) rotation to apply to the node. * @param {Property|Cartesian3} [options.scale=new Cartesian3(1.0, 1.0, 1.0)] A {@link Cartesian3} Property specifying the (x, y, z) scaling to apply to the node. */ function NodeTransformationProperty(options) { options = defaultValue(options, defaultValue.EMPTY_OBJECT); this._definitionChanged = new Event(); this._translation = undefined; this._translationSubscription = undefined; this._rotation = undefined; this._rotationSubscription = undefined; this._scale = undefined; this._scaleSubscription = undefined; this.translation = options.translation; this.rotation = options.rotation; this.scale = options.scale; } Object.defineProperties(NodeTransformationProperty.prototype, { /** * Gets a value indicating if this property is constant. A property is considered * constant if getValue always returns the same result for the current definition. * @memberof NodeTransformationProperty.prototype * * @type {boolean} * @readonly */ isConstant: { get: function () { return ( Property.isConstant(this._translation) && Property.isConstant(this._rotation) && Property.isConstant(this._scale) ); }, }, /** * Gets the event that is raised whenever the definition of this property changes. * The definition is considered to have changed if a call to getValue would return * a different result for the same time. * @memberof NodeTransformationProperty.prototype * * @type {Event} * @readonly */ definitionChanged: { get: function () { return this._definitionChanged; }, }, /** * Gets or sets the {@link Cartesian3} Property specifying the (x, y, z) translation to apply to the node. * @memberof NodeTransformationProperty.prototype * @type {Property|undefined} * @default Cartesian3.ZERO */ translation: createPropertyDescriptor("translation"), /** * Gets or sets the {@link Quaternion} Property specifying the (x, y, z, w) rotation to apply to the node. * @memberof NodeTransformationProperty.prototype * @type {Property|undefined} * @default Quaternion.IDENTITY */ rotation: createPropertyDescriptor("rotation"), /** * Gets or sets the {@link Cartesian3} Property specifying the (x, y, z) scaling to apply to the node. * @memberof NodeTransformationProperty.prototype * @type {Property|undefined} * @default new Cartesian3(1.0, 1.0, 1.0) */ scale: createPropertyDescriptor("scale"), }); /** * Gets the value of the property at the provided time. * * @param {JulianDate} time The time for which to retrieve the value. * @param {TranslationRotationScale} [result] The object to store the value into, if omitted, a new instance is created and returned. * @returns {TranslationRotationScale} The modified result parameter or a new instance if the result parameter was not supplied. */ NodeTransformationProperty.prototype.getValue = function (time, result) { if (!defined(result)) { result = new TranslationRotationScale(); } result.translation = Property.getValueOrClonedDefault( this._translation, time, defaultNodeTransformation.translation, result.translation ); result.rotation = Property.getValueOrClonedDefault( this._rotation, time, defaultNodeTransformation.rotation, result.rotation ); result.scale = Property.getValueOrClonedDefault( this._scale, time, defaultNodeTransformation.scale, result.scale ); return result; }; /** * 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. */ NodeTransformationProperty.prototype.equals = function (other) { return ( this === other || (other instanceof NodeTransformationProperty && Property.equals(this._translation, other._translation) && Property.equals(this._rotation, other._rotation) && Property.equals(this._scale, other._scale)) ); }; export default NodeTransformationProperty;