/*global define*/
define([
'../Core/Clock',
'../Core/defaultValue',
'../Core/defined',
'../Core/defineProperties',
'../Core/DeveloperError',
'../Core/Event',
'../Core/JulianDate',
'./createPropertyDescriptor'
], function(
Clock,
defaultValue,
defined,
defineProperties,
DeveloperError,
Event,
JulianDate,
createPropertyDescriptor) {
"use strict";
/**
* Represents CZML document-level clock settings.
*
* @alias DataSourceClock
* @constructor
*/
var DataSourceClock = function() {
this._startTime = undefined;
this._stopTime = undefined;
this._currentTime = undefined;
this._clockRange = undefined;
this._clockStep = undefined;
this._multiplier = undefined;
this._definitionChanged = new Event();
};
defineProperties(DataSourceClock.prototype, {
/**
* Gets the event that is raised whenever a new property is assigned.
* @memberof DataSourceClock.prototype
*
* @type {Event}
* @readonly
*/
definitionChanged : {
get : function() {
return this._definitionChanged;
}
},
/**
* Gets or sets the start time of the clock to use when looping or clamped.
* @memberof DataSourceClock.prototype
* @type {JulianDate}
*/
startTime : createPropertyDescriptor('startTime'),
/**
* Gets or sets the stop time of the clock to use when looping or clamped.
* @memberof DataSourceClock.prototype
* @type {JulianDate}
*/
stopTime : createPropertyDescriptor('stopTime'),
/**
* Gets or sets the initial time to use when switching to this clock.
* @memberof DataSourceClock.prototype
* @type {JulianDate}
*/
currentTime : createPropertyDescriptor('currentTime'),
/**
* Gets or sets how the clock should behave when startTime
or stopTime
is reached.
* @memberof DataSourceClock.prototype
* @type {ClockRange}
*/
clockRange : createPropertyDescriptor('clockRange'),
/**
* Gets or sets if clock advancement is frame dependent or system clock dependent.
* @memberof DataSourceClock.prototype
* @type {ClockStep}
*/
clockStep : createPropertyDescriptor('clockStep'),
/**
* Gets or sets how much time advances with each tick, negative values allow for advancing backwards.
* If clockStep
is set to ClockStep.TICK_DEPENDENT this is the number of seconds to advance.
* If clockStep
is set to ClockStep.SYSTEM_CLOCK_MULTIPLIER this value is multiplied by the
* elapsed system time since the last call to tick.
* @memberof DataSourceClock.prototype
* @type {Number}
*/
multiplier : createPropertyDescriptor('multiplier')
});
/**
* Duplicates a DataSourceClock instance.
*
* @param {DataSourceClock} [result] The object onto which to store the result.
* @returns {DataSourceClock} The modified result parameter or a new instance if one was not provided.
*/
DataSourceClock.prototype.clone = function(result) {
if (!defined(result)) {
result = new DataSourceClock();
}
result.startTime = this.startTime;
result.stopTime = this.stopTime;
result.currentTime = this.currentTime;
result.clockRange = this.clockRange;
result.clockStep = this.clockStep;
result.multiplier = this.multiplier;
return result;
};
/**
* Returns true if this DataSourceClock is equivalent to the other
*
* @param {DataSourceClock} other The other DataSourceClock to compare to.
* @returns {Boolean} true
if the DataSourceClocks are equal; otherwise, false
.
*/
DataSourceClock.prototype.equals = function(other) {
return this === other ||
defined(other) &&
JulianDate.equals(this.startTime, other.startTime) &&
JulianDate.equals(this.stopTime, other.stopTime) &&
JulianDate.equals(this.currentTime, other.currentTime) &&
this.clockRange === other.clockRange &&
this.clockStep === other.clockStep &&
this.multiplier === other.multiplier;
};
/**
* Assigns each unassigned property on this object to the value
* of the same property on the provided source object.
*
* @param {DataSourceClock} source The object to be merged into this object.
*/
DataSourceClock.prototype.merge = function(source) {
//>>includeStart('debug', pragmas.debug);
if (!defined(source)) {
throw new DeveloperError('source is required.');
}
//>>includeEnd('debug');
this.startTime = defaultValue(this.startTime, source.startTime);
this.stopTime = defaultValue(this.stopTime, source.stopTime);
this.currentTime = defaultValue(this.currentTime, source.currentTime);
this.clockRange = defaultValue(this.clockRange, source.clockRange);
this.clockStep = defaultValue(this.clockStep, source.clockStep);
this.multiplier = defaultValue(this.multiplier, source.multiplier);
};
/**
* Gets the value of this clock instance as a {@link Clock} object.
*
* @returns {Clock} The modified result parameter or a new instance if one was not provided.
*/
DataSourceClock.prototype.getValue = function(result) {
if (!defined(result)) {
result = new Clock();
}
result.startTime = this.startTime;
result.stopTime = this.stopTime;
result.clockRange = this.clockRange;
result.clockStep = this.clockStep;
result.multiplier = this.multiplier;
result.currentTime = this.currentTime;
return result;
};
return DataSourceClock;
});