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;