cesium 0.13.0

data/app/assets/javascripts/DynamicScene/CzmlDefaults.js

@@ -0,0 +1,135 @@
+/*global define*/
+define([
+        './DynamicObject',
+        './DynamicBillboard',
+        './DynamicEllipsoid',
+        './DynamicCone',
+        './DynamicLabel',
+        './DynamicPath',
+        './DynamicPoint',
+        './DynamicPolygon',
+        './DynamicPolyline',
+        './DynamicPyramid',
+        './DynamicBillboardVisualizer',
+        './DynamicEllipsoidVisualizer',
+        './DynamicConeVisualizerUsingCustomSensor', //CZML_TODO Replace with './DynamicConeVisualizer', once ComplexConicSensor works.
+        './DynamicLabelVisualizer',
+        './DynamicPathVisualizer',
+        './DynamicPointVisualizer',
+        './DynamicPolygonVisualizer',
+        './DynamicPolylineVisualizer',
+        './DynamicPyramidVisualizer'
+       ], function(
+        DynamicObject,
+        DynamicBillboard,
+        DynamicEllipsoid,
+        DynamicCone,
+        DynamicLabel,
+        DynamicPath,
+        DynamicPoint,
+        DynamicPolygon,
+        DynamicPolyline,
+        DynamicPyramid,
+        DynamicBillboardVisualizer,
+        DynamicEllipsoidVisualizer,
+        DynamicConeVisualizer,
+        DynamicLabelVisualizer,
+        DynamicPathVisualizer,
+        DynamicPointVisualizer,
+        DynamicPolygonVisualizer,
+        DynamicPolylineVisualizer,
+        DynamicPyramidVisualizer) {
+    "use strict";
+
+    /**
+     * Helper class which provides the default set of CZML processing methods
+     * needed to visualize the complete CZML standard.  There's no reason to
+     * access this class directly, as it just holds the defaults used by
+     * DynamicObjectCollection, CompositeDynamicObjectCollection, and VisualizerCollection.
+     *
+     * @exports CzmlDefaults
+     *
+     * @see DynamicObjectCollection
+     * @see CompositeDynamicObjectCollection
+     * @see VisualizerCollection#createCzmlDefaultsCollection
+     */
+    var CzmlDefaults = {
+        //Any change to updaters needs to be reflected in the DynamicObject constructor,
+        //which has the superset of all properties created by the various updaters.
+        /**
+         * The standard set of updaters for processing CZML.  This array is the default
+         * set of updater methods used by DynamicObjectCollection.
+         * @see DynamicObjectCollection
+         */
+        updaters : [DynamicBillboard.processCzmlPacket,
+                    DynamicEllipsoid.processCzmlPacket,
+                    DynamicCone.processCzmlPacket,
+                    DynamicLabel.processCzmlPacket,
+                    DynamicPath.processCzmlPacket,
+                    DynamicPoint.processCzmlPacket,
+                    DynamicPolygon.processCzmlPacket,
+                    DynamicPolyline.processCzmlPacket,
+                    DynamicPyramid.processCzmlPacket,
+                    DynamicObject.processCzmlPacketPosition,
+                    DynamicObject.processCzmlPacketViewFrom,
+                    DynamicObject.processCzmlPacketOrientation,
+                    DynamicObject.processCzmlPacketVertexPositions,
+                    DynamicObject.processCzmlPacketAvailability],
+
+        /**
+         * The standard set of mergers for processing CZML.  This array is the default
+         * set of updater methods used by CompositeDynamicObjectCollection.
+         *
+         * @see CompositeDynamicObjectCollection
+         */
+        mergers : [DynamicBillboard.mergeProperties,
+                   DynamicEllipsoid.mergeProperties,
+                   DynamicCone.mergeProperties,
+                   DynamicLabel.mergeProperties,
+                   DynamicPath.mergeProperties,
+                   DynamicPoint.mergeProperties,
+                   DynamicPolygon.mergeProperties,
+                   DynamicPolyline.mergeProperties,
+                   DynamicPyramid.mergeProperties,
+                   DynamicObject.mergeProperties],
+
+       /**
+        * The standard set of cleaners for processing CZML.  This array is the default
+        * set of updater methods used by CompositeDynamicObjectCollection.
+        *
+        * @see CompositeDynamicObjectCollection
+        */
+        cleaners : [DynamicBillboard.undefineProperties,
+                    DynamicEllipsoid.undefineProperties,
+                    DynamicCone.undefineProperties,
+                    DynamicLabel.undefineProperties,
+                    DynamicPath.undefineProperties,
+                    DynamicPoint.undefineProperties,
+                    DynamicPolygon.undefineProperties,
+                    DynamicPolyline.undefineProperties,
+                    DynamicPyramid.undefineProperties,
+                    DynamicObject.undefineProperties],
+
+        /**
+         * Creates an array containing the standard CZML visualizers,
+         * configured for the provided scene.
+         *
+         * @param scene The scene being used for visualization.
+         * @returns {Array} The CZML standard visualizers.
+         * @see VisualizerCollection#createCzmlDefaultsCollection
+         */
+        createVisualizers : function(scene) {
+            return [new DynamicBillboardVisualizer(scene),
+                    new DynamicEllipsoidVisualizer(scene),
+                    new DynamicConeVisualizer(scene),
+                    new DynamicLabelVisualizer(scene),
+                    new DynamicPointVisualizer(scene),
+                    new DynamicPolygonVisualizer(scene),
+                    new DynamicPolylineVisualizer(scene),
+                    new DynamicPyramidVisualizer(scene),
+                    new DynamicPathVisualizer(scene)];
+        }
+    };
+
+    return CzmlDefaults;
+});

data/app/assets/javascripts/DynamicScene/CzmlHorizontalOrigin.js

@@ -0,0 +1,59 @@
+/*global define*/
+define([
+        '../Scene/HorizontalOrigin'
+       ], function(
+         HorizontalOrigin) {
+    "use strict";
+
+    /**
+     * Provides methods for working with a horizontal origin defined in CZML.
+     *
+     * @exports CzmlHorizontalOrigin
+     *
+     * @see HorizontalOrigin
+     * @see DynamicProperty
+     * @see CzmlBoolean
+     * @see CzmlCartesian2
+     * @see CzmlCartesian3
+     * @see CzmlCartographic
+     * @see CzmlColor
+     * @see CzmlLabelStyle
+     * @see CzmlNumber
+     * @see CzmlString
+     * @see CzmlUnitCartesian3
+     * @see CzmlUnitQuaternion
+     * @see CzmlUnitSpherical
+     * @see CzmlVerticalOrigin
+     */
+    var CzmlHorizontalOrigin = {
+        /**
+         * Returns the packed enum representation contained within the provided CZML interval
+         * or undefined if the interval does not contain enum data.
+         *
+         * @param {Object} czmlInterval The CZML interval to unwrap.
+         */
+        unwrapInterval : function(czmlInterval) {
+            var result = czmlInterval.horizontalOrigin;
+            return typeof result === 'undefined' ? czmlInterval : result;
+        },
+
+        /**
+         * Since enums can not be sampled, this method always returns false.
+         */
+        isSampled : function() {
+            return false;
+        },
+
+        /**
+         * Returns the HorizontalOrigin contained within the unwrappedInterval.
+         *
+         * @param {Object} unwrappedInterval The result of CzmlHorizontalOrigin.unwrapInterval.
+         * @returns The HorizontalOrigin value.
+         */
+        getValue : function(unwrappedInterval) {
+            return HorizontalOrigin[unwrappedInterval];
+        }
+    };
+
+    return CzmlHorizontalOrigin;
+});

data/app/assets/javascripts/DynamicScene/CzmlImage.js

@@ -0,0 +1,61 @@
+/*global define*/
+define(['../ThirdParty/Uri'], function(Uri) {
+    "use strict";
+
+    /**
+     * Provides methods for working with a image defined in CZML.
+     *
+     * @exports CzmlImage
+     *
+     * @see DynamicProperty
+     * @see CzmlCartesian2
+     * @see CzmlCartesian3
+     * @see CzmlCartographic
+     * @see CzmlColor
+     * @see CzmlHorizontalOrigin
+     * @see CzmlLabelStyle
+     * @see CzmlNumber
+     * @see CzmlImage
+     * @see CzmlUnitCartesian3
+     * @see CzmlUnitQuaternion
+     * @see CzmlUnitSpherical
+     * @see CzmlVerticalOrigin
+     */
+    var CzmlImage = {
+        /**
+         * Returns the packed image representation contained within the provided CZML interval
+         * or undefined if the interval does not contain image data.
+         *
+         * @param {Object} czmlInterval The CZML interval to unwrap.
+         */
+        unwrapInterval : function(czmlInterval, sourceUri) {
+            var result = typeof czmlInterval.image === 'undefined' ? czmlInterval : czmlInterval.image;
+            if (typeof sourceUri !== 'undefined') {
+                var baseUri = new Uri(document.location.href);
+                sourceUri = new Uri(sourceUri);
+                result = new Uri(result).resolve(sourceUri.resolve(baseUri)).toString();
+            }
+            return result;
+        },
+
+        /**
+         * Since CZML images can not be sampled, this method always returns false.
+         */
+        isSampled : function() {
+            return false;
+        },
+
+        /**
+         * Returns the image value contained within the unwrappedInterval.  For images
+         * this is the unwrappedInterval itself.
+         *
+         * @param {Object} unwrappedInterval The result of CzmlImage.unwrapInterval.
+         * @returns The image value.
+         */
+        getValue : function(unwrappedInterval) {
+            return unwrappedInterval;
+        }
+    };
+
+    return CzmlImage;
+});

data/app/assets/javascripts/DynamicScene/CzmlLabelStyle.js

@@ -0,0 +1,59 @@
+/*global define*/
+define([
+        '../Scene/LabelStyle'
+       ], function(
+         LabelStyle) {
+    "use strict";
+
+    /**
+     * Provides methods for working with a label style defined in CZML.
+     *
+     * @exports CzmlLabelStyle
+     *
+     * @see LabelStyle
+     * @see DynamicProperty
+     * @see CzmlBoolean
+     * @see CzmlCartesian2
+     * @see CzmlCartesian3
+     * @see CzmlCartographic
+     * @see CzmlColor
+     * @see CzmlLabelStyle
+     * @see CzmlNumber
+     * @see CzmlString
+     * @see CzmlUnitCartesian3
+     * @see CzmlUnitQuaternion
+     * @see CzmlUnitSpherical
+     * @see CzmlVerticalOrigin
+     */
+    var CzmlLabelStyle = {
+        /**
+         * Returns the packed enum representation contained within the provided CZML interval
+         * or undefined if the interval does not contain enum data.
+         *
+         * @param {Object} czmlInterval The CZML interval to unwrap.
+         */
+        unwrapInterval : function(czmlInterval) {
+            var result = czmlInterval.labelStyle;
+            return typeof result === 'undefined' ? czmlInterval : result;
+        },
+
+        /**
+         * Since enums can not be sampled, this method always returns false.
+         */
+        isSampled : function() {
+            return false;
+        },
+
+        /**
+         * Returns the LabelStyle contained within the unwrappedInterval.
+         *
+         * @param {Object} unwrappedInterval The result of CzmlLabelStyle.unwrapInterval.
+         * @returns The LabelStyle value.
+         */
+        getValue : function(unwrappedInterval) {
+            return LabelStyle[unwrappedInterval];
+        }
+    };
+
+    return CzmlLabelStyle;
+});

data/app/assets/javascripts/DynamicScene/CzmlNumber.js

@@ -0,0 +1,82 @@
+/*global define*/
+define(function() {
+    "use strict";
+
+    var doublesPerValue = 1;
+
+    /**
+     * Provides methods for working with a number defined in CZML.
+     *
+     * @exports CzmlNumber
+     *
+     * @see DynamicProperty
+     * @see CzmlBoolean
+     * @see CzmlCartesian2
+     * @see CzmlCartesian3
+     * @see CzmlCartographic
+     * @see CzmlColor
+     * @see CzmlHorizontalOrigin
+     * @see CzmlLabelStyle
+     * @see CzmlString
+     * @see CzmlUnitCartesian3
+     * @see CzmlUnitQuaternion
+     * @see CzmlUnitSpherical
+     * @see CzmlVerticalOrigin
+     */
+    var CzmlNumber = {
+        /**
+         * The number of doubles per packed value.
+         */
+        doublesPerValue : doublesPerValue,
+
+        /**
+         * The number of doubles per packed value used for interpolation.
+         */
+        doublesPerInterpolationValue : doublesPerValue,
+
+        /**
+         * Returns the packed numerical representation contained within the provided CZML interval
+         * or undefined if the interval does not contain numerical data.
+         *
+         * @param {Object} czmlInterval The CZML interval to unwrap.
+         */
+        unwrapInterval : function(czmlInterval) {
+            var result = czmlInterval.number;
+            return typeof result === 'undefined' ? czmlInterval : result;
+        },
+
+        /**
+         * Returns true if this interval represents data that should be interpolated by the client
+         * or false if it's a single value.
+         *
+         * @param {Object} unwrappedInterval The result of CzmlNumber.unwrapInterval.
+         */
+        isSampled : function(unwrappedInterval) {
+            return Array.isArray(unwrappedInterval);
+        },
+
+        /**
+         * Returns the numerical value contained within the unwrappedInterval.  For numbers
+         * this is the unwrappedInterval itself.
+         *
+         * @param {Object} unwrappedInterval The result of CzmlNumber.unwrapInterval.
+         * @returns The boolean value.
+         */
+        getValue : function(unwrappedInterval) {
+            return unwrappedInterval;
+        },
+
+        /**
+         * Given a packed array of numerical values, returns the number at the given index..
+         *
+         * @param {Array} array An array of numbers.
+         * @param {Number} startingIndex The index into the array that contains the value you would like.
+         * @returns The value at the specified index.
+         */
+        getValueFromArray : function(array, startingIndex) {
+            return array[startingIndex];
+        }
+    };
+
+    return CzmlNumber;
+});

data/app/assets/javascripts/DynamicScene/CzmlString.js

@@ -0,0 +1,56 @@
+/*global define*/
+define(function() {
+    "use strict";
+
+    /**
+     * Provides methods for working with a string defined in CZML.
+     *
+     * @exports CzmlString
+     *
+     * @see DynamicProperty
+     * @see CzmlCartesian2
+     * @see CzmlCartesian3
+     * @see CzmlCartographic
+     * @see CzmlColor
+     * @see CzmlHorizontalOrigin
+     * @see CzmlLabelStyle
+     * @see CzmlNumber
+     * @see CzmlString
+     * @see CzmlUnitCartesian3
+     * @see CzmlUnitQuaternion
+     * @see CzmlUnitSpherical
+     * @see CzmlVerticalOrigin
+     */
+    var CzmlString = {
+        /**
+         * Returns the packed string representation contained within the provided CZML interval
+         * or undefined if the interval does not contain string data.
+         *
+         * @param {Object} czmlInterval The CZML interval to unwrap.
+         */
+        unwrapInterval : function(czmlInterval) {
+            var result = czmlInterval.string;
+            return typeof result === 'undefined' ? czmlInterval : result;
+        },
+
+        /**
+         * Since CZML strings can not be sampled, this method always returns false.
+         */
+        isSampled : function() {
+            return false;
+        },
+
+        /**
+         * Returns the string value contained within the unwrappedInterval.  For strings
+         * this is the unwrappedInterval itself.
+         *
+         * @param {Object} unwrappedInterval The result of CzmlString.unwrapInterval.
+         * @returns The string value.
+         */
+        getValue : function(unwrappedInterval) {
+            return unwrappedInterval;
+        }
+    };
+
+    return CzmlString;
+});