cesiumDemo/Source/Workers/createSimplePolylineGeometry.js

/* This file is automatically rebuilt by the Cesium build process. */
define(['./defined-26bd4a03', './Check-da037458', './freezeObject-2d83f591', './defaultValue-f2e68450', './Math-fa6e45cb', './Cartesian2-2a723276', './defineProperties-6f7a50f2', './Transforms-65aba0a4', './RuntimeError-ad75c885', './WebGLConstants-497deb20', './ComponentDatatype-69643096', './GeometryAttribute-ed359d71', './when-ee12a2cb', './GeometryAttributes-eecc9f43', './IndexDatatype-3de60176', './IntersectionTests-c2360ffa', './Plane-a1a3fd52', './ArcType-d521909b', './EllipsoidRhumbLine-c6cdbfd3', './EllipsoidGeodesic-53e988a6', './PolylinePipeline-b4161aaf', './Color-63c0bcb4'], function (defined, Check, freezeObject, defaultValue, _Math, Cartesian2, defineProperties, Transforms, RuntimeError, WebGLConstants, ComponentDatatype, GeometryAttribute, when, GeometryAttributes, IndexDatatype, IntersectionTests, Plane, ArcType, EllipsoidRhumbLine, EllipsoidGeodesic, PolylinePipeline, Color) { 'use strict';

    function interpolateColors(p0, p1, color0, color1, minDistance, array, offset) {
            var numPoints = PolylinePipeline.PolylinePipeline.numberOfPoints(p0, p1, minDistance);
            var i;

            var r0 = color0.red;
            var g0 = color0.green;
            var b0 = color0.blue;
            var a0 = color0.alpha;

            var r1 = color1.red;
            var g1 = color1.green;
            var b1 = color1.blue;
            var a1 = color1.alpha;

            if (Color.Color.equals(color0, color1)) {
                for (i = 0; i < numPoints; i++) {
                    array[offset++] = Color.Color.floatToByte(r0);
                    array[offset++] = Color.Color.floatToByte(g0);
                    array[offset++] = Color.Color.floatToByte(b0);
                    array[offset++] = Color.Color.floatToByte(a0);
                }
                return offset;
            }

            var redPerVertex = (r1 - r0) / numPoints;
            var greenPerVertex = (g1 - g0) / numPoints;
            var bluePerVertex = (b1 - b0) / numPoints;
            var alphaPerVertex = (a1 - a0) / numPoints;

            var index = offset;
            for (i = 0; i < numPoints; i++) {
                array[index++] = Color.Color.floatToByte(r0 + i * redPerVertex);
                array[index++] = Color.Color.floatToByte(g0 + i * greenPerVertex);
                array[index++] = Color.Color.floatToByte(b0 + i * bluePerVertex);
                array[index++] = Color.Color.floatToByte(a0 + i * alphaPerVertex);
            }

            return index;
        }

        /**
         * A description of a polyline modeled as a line strip; the first two positions define a line segment,
         * and each additional position defines a line segment from the previous position.
         *
         * @alias SimplePolylineGeometry
         * @constructor
         *
         * @param {Object} options Object with the following properties:
         * @param {Cartesian3[]} options.positions An array of {@link Cartesian3} defining the positions in the polyline as a line strip.
         * @param {Color[]} [options.colors] An Array of {@link Color} defining the per vertex or per segment colors.
         * @param {Boolean} [options.colorsPerVertex=false] A boolean that determines whether the colors will be flat across each segment of the line or interpolated across the vertices.
         * @param {ArcType} [options.arcType=ArcType.GEODESIC] The type of line the polyline segments must follow.
         * @param {Number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude if options.arcType is not ArcType.NONE. Determines the number of positions in the buffer.
         * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid to be used as a reference.
         *
         * @exception {DeveloperError} At least two positions are required.
         * @exception {DeveloperError} colors has an invalid length.
         *
         * @see SimplePolylineGeometry#createGeometry
         *
         * @example
         * // A polyline with two connected line segments
         * var polyline = new Cesium.SimplePolylineGeometry({
         *   positions : Cesium.Cartesian3.fromDegreesArray([
         *     0.0, 0.0,
         *     5.0, 0.0,
         *     5.0, 5.0
         *   ])
         * });
         * var geometry = Cesium.SimplePolylineGeometry.createGeometry(polyline);
         */
        function SimplePolylineGeometry(options) {
            options = defaultValue.defaultValue(options, defaultValue.defaultValue.EMPTY_OBJECT);
            var positions = options.positions;
            var colors = options.colors;
            var colorsPerVertex = defaultValue.defaultValue(options.colorsPerVertex, false);

            //>>includeStart('debug', pragmas.debug);
            if ((!defined.defined(positions)) || (positions.length < 2)) {
                throw new Check.DeveloperError('At least two positions are required.');
            }
            if (defined.defined(colors) && ((colorsPerVertex && colors.length < positions.length) || (!colorsPerVertex && colors.length < positions.length - 1))) {
                throw new Check.DeveloperError('colors has an invalid length.');
            }
            //>>includeEnd('debug');

            this._positions = positions;
            this._colors = colors;
            this._colorsPerVertex = colorsPerVertex;

            this._arcType = defaultValue.defaultValue(options.arcType, ArcType.ArcType.GEODESIC);
            this._granularity = defaultValue.defaultValue(options.granularity, _Math.CesiumMath.RADIANS_PER_DEGREE);
            this._ellipsoid = defaultValue.defaultValue(options.ellipsoid, Cartesian2.Ellipsoid.WGS84);
            this._workerName = 'createSimplePolylineGeometry';

            var numComponents = 1 + positions.length * Cartesian2.Cartesian3.packedLength;
            numComponents += defined.defined(colors) ? 1 + colors.length * Color.Color.packedLength : 1;

            /**
             * The number of elements used to pack the object into an array.
             * @type {Number}
             */
            this.packedLength = numComponents + Cartesian2.Ellipsoid.packedLength + 3;
        }

        /**
         * Stores the provided instance into the provided array.
         *
         * @param {SimplePolylineGeometry} value The value to pack.
         * @param {Number[]} array The array to pack into.
         * @param {Number} [startingIndex=0] The index into the array at which to start packing the elements.
         *
         * @returns {Number[]} The array that was packed into
         */
        SimplePolylineGeometry.pack = function(value, array, startingIndex) {
            //>>includeStart('debug', pragmas.debug);
            if (!defined.defined(value)) {
                throw new Check.DeveloperError('value is required');
            }
            if (!defined.defined(array)) {
                throw new Check.DeveloperError('array is required');
            }
            //>>includeEnd('debug');

            startingIndex = defaultValue.defaultValue(startingIndex, 0);

            var i;

            var positions = value._positions;
            var length = positions.length;
            array[startingIndex++] = length;

            for (i = 0; i < length; ++i, startingIndex += Cartesian2.Cartesian3.packedLength) {
                Cartesian2.Cartesian3.pack(positions[i], array, startingIndex);
            }

            var colors = value._colors;
            length = defined.defined(colors) ? colors.length : 0.0;
            array[startingIndex++] = length;

            for (i = 0; i < length; ++i, startingIndex += Color.Color.packedLength) {
                Color.Color.pack(colors[i], array, startingIndex);
            }

            Cartesian2.Ellipsoid.pack(value._ellipsoid, array, startingIndex);
            startingIndex += Cartesian2.Ellipsoid.packedLength;

            array[startingIndex++] = value._colorsPerVertex ? 1.0 : 0.0;
            array[startingIndex++] = value._arcType;
            array[startingIndex]   = value._granularity;

            return array;
        };

        /**
         * Retrieves an instance from a packed array.
         *
         * @param {Number[]} array The packed array.
         * @param {Number} [startingIndex=0] The starting index of the element to be unpacked.
         * @param {SimplePolylineGeometry} [result] The object into which to store the result.
         * @returns {SimplePolylineGeometry} The modified result parameter or a new SimplePolylineGeometry instance if one was not provided.
         */
        SimplePolylineGeometry.unpack = function(array, startingIndex, result) {
            //>>includeStart('debug', pragmas.debug);
            if (!defined.defined(array)) {
                throw new Check.DeveloperError('array is required');
            }
            //>>includeEnd('debug');

            startingIndex = defaultValue.defaultValue(startingIndex, 0);

            var i;

            var length = array[startingIndex++];
            var positions = new Array(length);

            for (i = 0; i < length; ++i, startingIndex += Cartesian2.Cartesian3.packedLength) {
                positions[i] = Cartesian2.Cartesian3.unpack(array, startingIndex);
            }

            length = array[startingIndex++];
            var colors = length > 0 ? new Array(length) : undefined;

            for (i = 0; i < length; ++i, startingIndex += Color.Color.packedLength) {
                colors[i] = Color.Color.unpack(array, startingIndex);
            }

            var ellipsoid = Cartesian2.Ellipsoid.unpack(array, startingIndex);
            startingIndex += Cartesian2.Ellipsoid.packedLength;

            var colorsPerVertex = array[startingIndex++] === 1.0;
            var arcType = array[startingIndex++];
            var granularity = array[startingIndex];

            if (!defined.defined(result)) {
                return new SimplePolylineGeometry({
                    positions : positions,
                    colors : colors,
                    ellipsoid : ellipsoid,
                    colorsPerVertex : colorsPerVertex,
                    arcType : arcType,
                    granularity : granularity
                });
            }

            result._positions = positions;
            result._colors = colors;
            result._ellipsoid = ellipsoid;
            result._colorsPerVertex = colorsPerVertex;
            result._arcType = arcType;
            result._granularity = granularity;

            return result;
        };

        var scratchArray1 = new Array(2);
        var scratchArray2 = new Array(2);
        var generateArcOptionsScratch = {
            positions : scratchArray1,
            height: scratchArray2,
            ellipsoid: undefined,
            minDistance : undefined,
            granularity : undefined
        };

        /**
         * Computes the geometric representation of a simple polyline, including its vertices, indices, and a bounding sphere.
         *
         * @param {SimplePolylineGeometry} simplePolylineGeometry A description of the polyline.
         * @returns {Geometry} The computed vertices and indices.
         */
        SimplePolylineGeometry.createGeometry = function(simplePolylineGeometry) {
            var positions = simplePolylineGeometry._positions;
            var colors = simplePolylineGeometry._colors;
            var colorsPerVertex = simplePolylineGeometry._colorsPerVertex;
            var arcType = simplePolylineGeometry._arcType;
            var granularity = simplePolylineGeometry._granularity;
            var ellipsoid = simplePolylineGeometry._ellipsoid;

            var minDistance = _Math.CesiumMath.chordLength(granularity, ellipsoid.maximumRadius);
            var perSegmentColors = defined.defined(colors) && !colorsPerVertex;

            var i;
            var length = positions.length;

            var positionValues;
            var numberOfPositions;
            var colorValues;
            var color;
            var offset = 0;

            if (arcType === ArcType.ArcType.GEODESIC || arcType === ArcType.ArcType.RHUMB) {
                var subdivisionSize;
                var numberOfPointsFunction;
                var generateArcFunction;
                if (arcType === ArcType.ArcType.GEODESIC) {
                    subdivisionSize = _Math.CesiumMath.chordLength(granularity, ellipsoid.maximumRadius);
                    numberOfPointsFunction = PolylinePipeline.PolylinePipeline.numberOfPoints;
                    generateArcFunction = PolylinePipeline.PolylinePipeline.generateArc;
                } else {
                    subdivisionSize = granularity;
                    numberOfPointsFunction = PolylinePipeline.PolylinePipeline.numberOfPointsRhumbLine;
                    generateArcFunction = PolylinePipeline.PolylinePipeline.generateRhumbArc;
                }

                var heights = PolylinePipeline.PolylinePipeline.extractHeights(positions, ellipsoid);

                var generateArcOptions = generateArcOptionsScratch;
                if (arcType === ArcType.ArcType.GEODESIC) {
                    generateArcOptions.minDistance = minDistance;
                } else {
                    generateArcOptions.granularity = granularity;
                }
                generateArcOptions.ellipsoid = ellipsoid;

                if (perSegmentColors) {
                    var positionCount = 0;
                    for (i = 0; i < length - 1; i++) {
                        positionCount += numberOfPointsFunction(positions[i], positions[i+1], subdivisionSize) + 1;
                    }

                    positionValues = new Float64Array(positionCount * 3);
                    colorValues = new Uint8Array(positionCount * 4);

                    generateArcOptions.positions = scratchArray1;
                    generateArcOptions.height= scratchArray2;

                    var ci = 0;
                    for (i = 0; i < length - 1; ++i) {
                        scratchArray1[0] = positions[i];
                        scratchArray1[1] = positions[i + 1];

                        scratchArray2[0] = heights[i];
                        scratchArray2[1] = heights[i + 1];

                        var pos = generateArcFunction(generateArcOptions);

                        if (defined.defined(colors)) {
                            var segLen = pos.length / 3;
                            color = colors[i];
                            for(var k = 0; k < segLen; ++k) {
                                colorValues[ci++] = Color.Color.floatToByte(color.red);
                                colorValues[ci++] = Color.Color.floatToByte(color.green);
                                colorValues[ci++] = Color.Color.floatToByte(color.blue);
                                colorValues[ci++] = Color.Color.floatToByte(color.alpha);
                            }
                        }

                        positionValues.set(pos, offset);
                        offset += pos.length;
                    }
                } else {
                    generateArcOptions.positions = positions;
                    generateArcOptions.height= heights;
                    positionValues = new Float64Array(generateArcFunction(generateArcOptions));

                    if (defined.defined(colors)) {
                        colorValues = new Uint8Array(positionValues.length / 3 * 4);

                        for (i = 0; i < length - 1; ++i) {
                            var p0 = positions[i];
                            var p1 = positions[i + 1];
                            var c0 = colors[i];
                            var c1 = colors[i + 1];
                            offset = interpolateColors(p0, p1, c0, c1, minDistance, colorValues, offset);
                        }

                        var lastColor = colors[length - 1];
                        colorValues[offset++] = Color.Color.floatToByte(lastColor.red);
                        colorValues[offset++] = Color.Color.floatToByte(lastColor.green);
                        colorValues[offset++] = Color.Color.floatToByte(lastColor.blue);
                        colorValues[offset++] = Color.Color.floatToByte(lastColor.alpha);
                    }
                }
            } else {
                numberOfPositions = perSegmentColors ? length * 2 - 2 : length;
                positionValues = new Float64Array(numberOfPositions * 3);
                colorValues = defined.defined(colors) ? new Uint8Array(numberOfPositions * 4) : undefined;

                var positionIndex = 0;
                var colorIndex = 0;

                for (i = 0; i < length; ++i) {
                    var p = positions[i];

                    if (perSegmentColors && i > 0) {
                        Cartesian2.Cartesian3.pack(p, positionValues, positionIndex);
                        positionIndex += 3;

                        color = colors[i - 1];
                        colorValues[colorIndex++] = Color.Color.floatToByte(color.red);
                        colorValues[colorIndex++] = Color.Color.floatToByte(color.green);
                        colorValues[colorIndex++] = Color.Color.floatToByte(color.blue);
                        colorValues[colorIndex++] = Color.Color.floatToByte(color.alpha);
                    }

                    if (perSegmentColors && i === length - 1) {
                        break;
                    }

                    Cartesian2.Cartesian3.pack(p, positionValues, positionIndex);
                    positionIndex += 3;

                    if (defined.defined(colors)) {
                        color = colors[i];
                        colorValues[colorIndex++] = Color.Color.floatToByte(color.red);
                        colorValues[colorIndex++] = Color.Color.floatToByte(color.green);
                        colorValues[colorIndex++] = Color.Color.floatToByte(color.blue);
                        colorValues[colorIndex++] = Color.Color.floatToByte(color.alpha);
                    }
                }
            }

            var attributes = new GeometryAttributes.GeometryAttributes();
            attributes.position = new GeometryAttribute.GeometryAttribute({
                componentDatatype : ComponentDatatype.ComponentDatatype.DOUBLE,
                componentsPerAttribute : 3,
                values : positionValues
            });

            if (defined.defined(colors)) {
                attributes.color = new GeometryAttribute.GeometryAttribute({
                    componentDatatype : ComponentDatatype.ComponentDatatype.UNSIGNED_BYTE,
                    componentsPerAttribute : 4,
                    values : colorValues,
                    normalize : true
                });
            }

            numberOfPositions = positionValues.length / 3;
            var numberOfIndices = (numberOfPositions - 1) * 2;
            var indices = IndexDatatype.IndexDatatype.createTypedArray(numberOfPositions, numberOfIndices);

            var index = 0;
            for (i = 0; i < numberOfPositions - 1; ++i) {
                indices[index++] = i;
                indices[index++] = i + 1;
            }

            return new GeometryAttribute.Geometry({
                attributes : attributes,
                indices : indices,
                primitiveType : GeometryAttribute.PrimitiveType.LINES,
                boundingSphere : Transforms.BoundingSphere.fromPoints(positions)
            });
        };

    function createSimplePolylineGeometry(simplePolylineGeometry, offset) {
            if (defined.defined(offset)) {
                simplePolylineGeometry = SimplePolylineGeometry.unpack(simplePolylineGeometry, offset);
            }
            simplePolylineGeometry._ellipsoid = Cartesian2.Ellipsoid.clone(simplePolylineGeometry._ellipsoid);
            return SimplePolylineGeometry.createGeometry(simplePolylineGeometry);
        }

    return createSimplePolylineGeometry;

});