From d1880142fa075331109234ea028d71681ed71c38 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 6 Nov 2017 11:34:26 -0500
Subject: [PATCH 01/37] Add plane geometry

---
 Source/Core/PlaneGeometry.js          | 462 ++++++++++++++++++++++++++
 Source/Workers/createPlaneGeometry.js |  15 +
 2 files changed, 477 insertions(+)
 create mode 100644 Source/Core/PlaneGeometry.js
 create mode 100644 Source/Workers/createPlaneGeometry.js

diff --git a/Source/Core/PlaneGeometry.js b/Source/Core/PlaneGeometry.js
new file mode 100644
index 000000000000..deab47408d95
--- /dev/null
+++ b/Source/Core/PlaneGeometry.js
@@ -0,0 +1,462 @@
+define([
+    './BoundingSphere',
+    './Cartesian3',
+    './Check',
+    './ComponentDatatype',
+    './defaultValue',
+    './defined',
+    './Geometry',
+    './GeometryAttribute',
+    './GeometryAttributes',
+    './Matrix4',
+    './Plane',
+    './PrimitiveType',
+    './Quaternion',
+    './TranslationRotationScale',
+    './VertexFormat'
+], function(
+    BoundingSphere,
+    Cartesian3,
+    Check,
+    ComponentDatatype,
+    defaultValue,
+    defined,
+    Geometry,
+    GeometryAttribute,
+    GeometryAttributes,
+    Matrix4,
+    Plane,
+    PrimitiveType,
+    Quaternion,
+    TranslationRotationScale,
+    VertexFormat) {
+    'use strict';
+
+    var scratchCartesian = new Cartesian3();
+    var scratchMatrix = new Matrix4();
+
+    /**
+     * Describes a plane by a normal and distance from the origin in world coordinates.
+     *
+     * @alias Plane
+     * @constructor
+     *
+     * @param {Object} options Object with the following properties:
+     * @param {Cartesian3} options.minimum The minimum x, y, and z coordinates of the box.
+     * @param {Cartesian3} options.maximum The maximum x, y, and z coordinates of the box.
+     * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
+     *
+     * @see Plane
+     * @see PlaneGeometry.fromDimensions
+     * @see PlaneGeometry.createGeometry
+     * @see Packable
+     *
+     * @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=Box.html|Cesium Sandcastle Box Demo}
+     *
+     * @example
+     * var planeGeometry = new Cesium.PlaneGeometry({
+     *   vertexFormat : Cesium.VertexFormat.POSITION_ONLY,
+     *   maximum : new Cesium.Cartesian3(250000.0, 250000.0, 250000.0),
+     *   minimum : new Cesium.Cartesian3(-250000.0, -250000.0, -250000.0)
+     * });
+     * var geometry = Cesium.PlaneGeometry.createGeometry(plane);
+     */
+    function PlaneGeometry(options) {
+        options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+
+        var min = options.minimum;
+        var max = options.maximum;
+
+        //>>includeStart('debug', pragmas.debug);
+        Check.typeOf.object('min', min);
+        Check.typeOf.object('max', max);
+        //>>includeEnd('debug');
+
+        var vertexFormat = defaultValue(options.vertexFormat, VertexFormat.DEFAULT);
+
+        // only need a min and max, but they must be planar
+        this._minimum = min;
+        this._maximum = max;
+        this._vertexFormat = vertexFormat;
+        this._workerName = 'createPlaneGeometry';
+    }
+
+    PlaneGeometry.fromPlane = function (options) {
+        options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+
+        var plane = options.plane;
+        var scale = defaultValue(options.scale, new Cartesian3(1.0, 1.0, 1.0));
+
+        //>>includeStart('debug', pragmas.debug);
+        Check.typeOf.object('plane', plane);
+        Check.typeOf.object('scale', scale);
+        //>>includeEnd('debug');
+
+        var min = new Cartesian3(-0.5, -0.5, 0.0);
+        var max = new Cartesian3( 0.5,  0.5, 0.0);
+
+        var location = Cartesian3.multiplyByScalar(plane.normal, plane.distance, scratchCartesian);
+        var orientation = Quaternion.IDENTITY; // orient z-axis to plane normal
+
+        var transformation = Matrix4.fromTranslationRotationScale(new TranslationRotationScale(
+            location, orientation, scale
+        ), scratchMatrix);
+
+        min = Matrix4.multiplyByPoint(transformation, min, min);
+        max = Matrix4.multiplyByPoint(transformation, max, max);
+        return new PlaneGeometry({
+            minimum : min,
+            maximum : max,
+            vertexFormat : options.vertexFormat
+        });
+    };
+
+    /**
+     * The number of elements used to pack the object into an array.
+     * @type {Number}
+     */
+    PlaneGeometry.packedLength = 2 * Cartesian3.packedLength + VertexFormat.packedLength;
+
+    /**
+     * Stores the provided instance into the provided array.
+     *
+     * @param {PlaneGeometry} 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
+     */
+    PlaneGeometry.pack = function(value, array, startingIndex) {
+        //>>includeStart('debug', pragmas.debug);
+        Check.typeOf.object('value', value);
+        Check.defined('array', array);
+        //>>includeEnd('debug');
+
+        startingIndex = defaultValue(startingIndex, 0);
+
+        Cartesian3.pack(value._minimum, array, startingIndex);
+        Cartesian3.pack(value._maximum, array, startingIndex + Cartesian3.packedLength);
+        VertexFormat.pack(value._vertexFormat, array, startingIndex + 2 * Cartesian3.packedLength);
+
+        return array;
+    };
+
+    var scratchMin = new Cartesian3();
+    var scratchMax = new Cartesian3();
+    var scratchVertexFormat = new VertexFormat();
+    var scratchOptions = {
+        minimum: scratchMin,
+        maximum: scratchMax,
+        vertexFormat: scratchVertexFormat
+    };
+
+    /**
+     * 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 {PlaneGeometry} [result] The object into which to store the result.
+     * @returns {PlaneGeometry} The modified result parameter or a new BoxGeometry instance if one was not provided.
+     */
+    PlaneGeometry.unpack = function(array, startingIndex, result) {
+        //>>includeStart('debug', pragmas.debug);
+        Check.defined('array', array);
+        //>>includeEnd('debug');
+
+        startingIndex = defaultValue(startingIndex, 0);
+
+        var min = Cartesian3.unpack(array, startingIndex, scratchMin);
+        var max = Cartesian3.unpack(array, startingIndex + Cartesian3.packedLength, scratchMax);
+        var vertexFormat = VertexFormat.unpack(array, startingIndex + 2 * Cartesian3.packedLength, scratchVertexFormat);
+
+        if (!defined(result)) {
+            return new PlaneGeometry(scratchOptions);
+        }
+
+        result._minimum = Cartesian3.clone(min, result._minimum);
+        result._maximum = Cartesian3.clone(max, result._maximum);
+        result._vertexFormat = VertexFormat.clone(vertexFormat, result._vertexFormat);
+
+        return result;
+    };
+
+    /**
+     * Computes the geometric representation of a plane, including its vertices, indices, and a bounding sphere.
+     *
+     * @param {PlaneGeometry} planeGeometry A description of the plane.
+     * @returns {Geometry|undefined} The computed vertices and indices.
+     */
+    PlaneGeometry.createGeometry = function(planeGeometry) {
+        var min = planeGeometry._minimum;
+        var max = planeGeometry._maximum;
+        var vertexFormat = planeGeometry._vertexFormat;
+
+        if (Cartesian3.equals(min, max)) {
+            return;
+        }
+
+        var attributes = new GeometryAttributes();
+        var indices;
+        var positions;
+
+        // TODO: tangents should be the plane normal
+
+        if (vertexFormat.position &&
+            (vertexFormat.st || vertexFormat.normal || vertexFormat.tangent || vertexFormat.bitangent)) {
+            if (vertexFormat.position) {
+                // 4 corner points.  Duplicated 3 times each for each incident edge/face.
+                positions = new Float64Array(2 * 4 * 3);
+
+                // +z face
+                positions[0]  = min.x;
+                positions[1]  = min.y;
+                positions[2]  = max.z;
+                positions[3]  = max.x;
+                positions[4]  = min.y;
+                positions[5]  = max.z;
+                positions[6]  = max.x;
+                positions[7]  = max.y;
+                positions[8]  = max.z;
+                positions[9]  = min.x;
+                positions[10] = max.y;
+                positions[11] = max.z;
+
+                // -z face
+                positions[12] = min.x;
+                positions[13] = min.y;
+                positions[14] = min.z;
+                positions[15] = max.x;
+                positions[16] = min.y;
+                positions[17] = min.z;
+                positions[18] = max.x;
+                positions[19] = max.y;
+                positions[20] = min.z;
+                positions[21] = min.x;
+                positions[22] = max.y;
+                positions[23] = min.z;
+
+                attributes.position = new GeometryAttribute({
+                    componentDatatype : ComponentDatatype.DOUBLE,
+                    componentsPerAttribute : 3,
+                    values : positions
+                });
+            }
+
+            if (vertexFormat.normal) {
+                var normals = new Float32Array(2 * 4 * 3);
+
+                // +z face
+                normals[0]  = 0.0;
+                normals[1]  = 0.0;
+                normals[2]  = 1.0;
+                normals[3]  = 0.0;
+                normals[4]  = 0.0;
+                normals[5]  = 1.0;
+                normals[6]  = 0.0;
+                normals[7]  = 0.0;
+                normals[8]  = 1.0;
+                normals[9]  = 0.0;
+                normals[10] = 0.0;
+                normals[11] = 1.0;
+
+                // -z face
+                normals[12] = 0.0;
+                normals[13] = 0.0;
+                normals[14] = -1.0;
+                normals[15] = 0.0;
+                normals[16] = 0.0;
+                normals[17] = -1.0;
+                normals[18] = 0.0;
+                normals[19] = 0.0;
+                normals[20] = -1.0;
+                normals[21] = 0.0;
+                normals[22] = 0.0;
+                normals[23] = -1.0;
+
+                attributes.normal = new GeometryAttribute({
+                    componentDatatype : ComponentDatatype.FLOAT,
+                    componentsPerAttribute : 3,
+                    values : normals
+                });
+            }
+
+            if (vertexFormat.st) {
+                var texCoords = new Float32Array(2 * 4 * 2);
+
+                // +z face
+                texCoords[0]  = 0.0;
+                texCoords[1]  = 0.0;
+                texCoords[2]  = 1.0;
+                texCoords[3]  = 0.0;
+                texCoords[4]  = 1.0;
+                texCoords[5]  = 1.0;
+                texCoords[6]  = 0.0;
+                texCoords[7]  = 1.0;
+
+                // -z face
+                texCoords[8]  = 1.0;
+                texCoords[9]  = 0.0;
+                texCoords[10] = 0.0;
+                texCoords[11] = 0.0;
+                texCoords[12] = 0.0;
+                texCoords[13] = 1.0;
+                texCoords[14] = 1.0;
+                texCoords[15] = 1.0;
+
+                attributes.st = new GeometryAttribute({
+                    componentDatatype : ComponentDatatype.FLOAT,
+                    componentsPerAttribute : 2,
+                    values : texCoords
+                });
+            }
+
+            if (vertexFormat.tangent) {
+                var tangents = new Float32Array(2 * 4 * 3);
+
+                // +z face
+                tangents[0]  = 1.0;
+                tangents[1]  = 0.0;
+                tangents[2]  = 0.0;
+                tangents[3]  = 1.0;
+                tangents[4]  = 0.0;
+                tangents[5]  = 0.0;
+                tangents[6]  = 1.0;
+                tangents[7]  = 0.0;
+                tangents[8]  = 0.0;
+                tangents[9]  = 1.0;
+                tangents[10] = 0.0;
+                tangents[11] = 0.0;
+
+                // -z face
+                tangents[12] = -1.0;
+                tangents[13] = 0.0;
+                tangents[14] = 0.0;
+                tangents[15] = -1.0;
+                tangents[16] = 0.0;
+                tangents[17] = 0.0;
+                tangents[18] = -1.0;
+                tangents[19] = 0.0;
+                tangents[20] = 0.0;
+                tangents[21] = -1.0;
+                tangents[22] = 0.0;
+                tangents[23] = 0.0;
+
+                attributes.tangent = new GeometryAttribute({
+                    componentDatatype : ComponentDatatype.FLOAT,
+                    componentsPerAttribute : 3,
+                    values : tangents
+                });
+            }
+
+            if (vertexFormat.bitangent) {
+                var bitangents = new Float32Array(2 * 4 * 3);
+
+                // +z face
+                bitangents[0] = 0.0;
+                bitangents[1] = 1.0;
+                bitangents[2] = 0.0;
+                bitangents[3] = 0.0;
+                bitangents[4] = 1.0;
+                bitangents[5] = 0.0;
+                bitangents[6] = 0.0;
+                bitangents[7] = 1.0;
+                bitangents[8] = 0.0;
+                bitangents[9] = 0.0;
+                bitangents[10] = 1.0;
+                bitangents[11] = 0.0;
+
+                // -z face
+                bitangents[12] = 0.0;
+                bitangents[13] = 1.0;
+                bitangents[14] = 0.0;
+                bitangents[15] = 0.0;
+                bitangents[16] = 1.0;
+                bitangents[17] = 0.0;
+                bitangents[18] = 0.0;
+                bitangents[19] = 1.0;
+                bitangents[20] = 0.0;
+                bitangents[21] = 0.0;
+                bitangents[22] = 1.0;
+                bitangents[23] = 0.0;
+
+                attributes.bitangent = new GeometryAttribute({
+                    componentDatatype : ComponentDatatype.FLOAT,
+                    componentsPerAttribute : 3,
+                    values : bitangents
+                });
+            }
+
+            // 4 triangles:  2 faces, 2 triangles each.
+            indices = new Uint16Array(2 * 2 * 3);
+
+            // +z face
+            indices[0] = 0;
+            indices[1] = 1;
+            indices[2] = 2;
+            indices[3] = 0;
+            indices[4] = 2;
+            indices[5] = 3;
+
+            // -z face
+            indices[6] = 4 + 2;
+            indices[7] = 4 + 1;
+            indices[8] = 4 + 0;
+            indices[9] = 4 + 3;
+            indices[10] = 4 + 2;
+            indices[11] = 4 + 0;
+        } else {
+            // Positions only - no need to duplicate corner points
+            positions = new Float64Array(4 * 3);
+
+            positions[0] = min.x;
+            positions[1] = min.y;
+            positions[2] = min.z;
+            positions[3] = max.x;
+            positions[4] = min.y;
+            positions[5] = min.z;
+            positions[6] = max.x;
+            positions[7] = max.y;
+            positions[8] = min.z;
+            positions[9] = min.x;
+            positions[10] = max.y;
+            positions[11] = min.z;
+
+            attributes.position = new GeometryAttribute({
+                componentDatatype : ComponentDatatype.DOUBLE,
+                componentsPerAttribute : 3,
+                values : positions
+            });
+
+            // 12 triangles:  2 faces, 2 triangles each.
+            indices = new Uint16Array(2 * 2 * 3);
+
+            // plane z = corner.Z
+            indices[0] = 4;
+            indices[1] = 5;
+            indices[2] = 6;
+            indices[3] = 4;
+            indices[4] = 6;
+            indices[5] = 7;
+
+            // plane z = -corner.Z
+            indices[6] = 1;
+            indices[7] = 0;
+            indices[8] = 3;
+            indices[9] = 1;
+            indices[10] = 3;
+            indices[11] = 2;
+        }
+
+        var diff = Cartesian3.subtract(max, min, scratchCartesian);
+        var radius = Cartesian3.magnitude(diff) * 0.5;
+
+        return new Geometry({
+            attributes : attributes,
+            indices : indices,
+            primitiveType : PrimitiveType.TRIANGLES,
+            boundingSphere : new BoundingSphere(Cartesian3.ZERO, radius)
+        });
+    };
+
+    return PlaneGeometry;
+});
diff --git a/Source/Workers/createPlaneGeometry.js b/Source/Workers/createPlaneGeometry.js
new file mode 100644
index 000000000000..23785ac71d65
--- /dev/null
+++ b/Source/Workers/createPlaneGeometry.js
@@ -0,0 +1,15 @@
+define([
+        '../Core/PlaneGeometry',
+        '../Core/defined'
+    ], function(
+        PlaneGeometry,
+        defined) {
+    'use strict';
+
+    return function(planeGeometry, offset) {
+        if (defined(offset)) {
+            planeGeometry = PlaneGeometry.unpack(planeGeometry, offset);
+        }
+        return PlaneGeometry.createGeometry(planeGeometry);
+    };
+});

From d142b0f640ce518808f7b50cbdbeb3c7b0549a1d Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Thu, 9 Nov 2017 17:20:27 -0500
Subject: [PATCH 02/37] Added plane graphics and geometries, update clipping
 planes example

---
 Apps/Sandcastle/gallery/Clipping Planes.html | 164 ++---
 CHANGES.md                                   |   2 +
 Source/Core/Plane.js                         |   4 -
 Source/Core/PlaneGeometry.js                 |  23 +-
 Source/Core/PlaneOutlineGeometry.js          | 143 ++++
 Source/DataSources/DataSourceDisplay.js      |   3 +
 Source/DataSources/Entity.js                 |  13 +-
 Source/DataSources/PlaneGeometryUpdater.js   | 723 +++++++++++++++++++
 Source/DataSources/PlaneGraphics.js          | 199 +++++
 Source/Workers/createPlaneOutlineGeometry.js |  15 +
 10 files changed, 1166 insertions(+), 123 deletions(-)
 create mode 100644 Source/Core/PlaneOutlineGeometry.js
 create mode 100644 Source/DataSources/PlaneGeometryUpdater.js
 create mode 100644 Source/DataSources/PlaneGraphics.js
 create mode 100644 Source/Workers/createPlaneOutlineGeometry.js

diff --git a/Apps/Sandcastle/gallery/Clipping Planes.html b/Apps/Sandcastle/gallery/Clipping Planes.html
index 16ff8c79c49b..8f993364ea75 100644
--- a/Apps/Sandcastle/gallery/Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/Clipping Planes.html	
@@ -36,34 +36,6 @@
 <div id="cesiumContainer" class="fullSize"></div>
 <div id="loadingOverlay"><h1>Loading...</h1></div>
 <div id="toolbar">
-    <table><tbody>
-    <tr>
-        <td>Type</td>
-        <td><select data-bind="options: exampleTypes, value: exampleType"></select></td>
-    </tr>
-    <tr>
-        <td>x</td>
-        <td>
-            <input type="range" min="-150" max="150" step="1" data-bind="value: xOffset, valueUpdate: 'input'">
-            <input type="text" size="2" data-bind="value: xOffset">
-        </td>
-    </tr>
-    <tr>
-        <td>y</td>
-        <td>
-            <input type="range" min="-150" max="150" step="1" data-bind="value: yOffset, valueUpdate: 'input'">
-            <input type="text" size="2" data-bind="value: yOffset">
-        </td>
-    </tr>
-    <tr>
-        <td>z</td>
-        <td>
-            <input type="range" min="-150" max="150" step="1" data-bind="value: zOffset, valueUpdate: 'input'">
-            <input type="text" size="2" data-bind="value: zOffset">
-        </td>
-    </tr>
-    </tbody></table>
-    <input type="checkbox" value="false" data-bind="checked: clippingPlanesEnabled, valueUpdate: 'input'"> Enable clipping planes
     <input type="checkbox" value="false" data-bind="checked: debugBoundingVolumesEnabled, valueUpdate: 'input'"> Show debug <code>boundingVolume</code>
 </div>
 
@@ -71,7 +43,13 @@
 function startup(Cesium) {
     'use strict';
 //Sandcastle_Begin
-var viewer = new Cesium.Viewer('cesiumContainer');
+var viewer = new Cesium.Viewer('cesiumContainer', {
+    infoBox: false,
+    selectionIndicator: false
+});
+var scene = viewer.scene;
+
+var planeScale = new Cesium.Cartesian2(300.0, 300.0);
 
 var clippingPlanes;
 var defaultClippingPlanes = [
@@ -81,15 +59,46 @@
 ];
 
 var viewModel = {
-    exampleType : 'BIM',
-    exampleTypes : ['BIM', 'Model', 'Point Cloud'],
-    clippingPlanesEnabled: true,
-    xOffset : 0.0,
-    yOffset: -100.0,
-    zOffset: -100.0,
     debugBoundingVolumesEnabled: false
 };
 
+var targetX = 0.0;
+var planeEntities = [];
+var selectedPlane;
+
+// Select plane when mouse down
+var downHandler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);
+downHandler.setInputAction(function(movement) {
+    var pickedObject = scene.pick(movement.position);
+    if (Cesium.defined(pickedObject) && Cesium.defined(pickedObject.id.plane)) {
+        selectedPlane = pickedObject.id.plane;
+        selectedPlane.material = Cesium.Color.WHITE.withAlpha(0.05);
+        selectedPlane.outlineColor = Cesium.Color.WHITE;
+        scene.screenSpaceCameraController.enableInputs = false;
+    }
+}, Cesium.ScreenSpaceEventType.LEFT_DOWN);
+
+// Release plane on mouse up
+var upHandler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);
+upHandler.setInputAction(function() {
+    if (Cesium.defined(selectedPlane)) {
+        selectedPlane.material = Cesium.Color.CYAN.withAlpha(0.1);
+        selectedPlane.outlineColor = Cesium.Color.CYAN;
+        selectedPlane = undefined;
+    }
+
+    scene.screenSpaceCameraController.enableInputs = true;
+}, Cesium.ScreenSpaceEventType.LEFT_UP);
+
+// Update plane on mouse move
+var moveHandler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);
+moveHandler.setInputAction(function(movement) {
+    if (Cesium.defined(selectedPlane)) {
+        var deltaX = movement.endPosition.x - movement.startPosition.x;
+        targetX += deltaX;
+    }
+}, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
+
 var tileset;
 function loadTileset(url) {
     reset();
@@ -102,6 +111,26 @@
         var boundingSphere = tileset.boundingSphere;
         viewer.camera.viewBoundingSphere(boundingSphere, new Cesium.HeadingPitchRange(0.5, -0.2, boundingSphere.radius * 4.0));
         viewer.camera.lookAtTransform(Cesium.Matrix4.IDENTITY);
+
+        for (var i = 0; i < 1; ++i) {
+            var plane = clippingPlanes[i];
+            var entity = viewer.entities.add({
+                position : boundingSphere.center,
+                plane : {
+                    dimensions : planeScale,
+                    material : Cesium.Color.CYAN.withAlpha(0.1),
+                    normal: plane.normal,
+                    distance: new Cesium.CallbackProperty(function() {
+                        plane.distance = Cesium.Math.lerp(plane.distance, targetX, 0.1);
+                        return plane.distance;
+                    }, false),
+                    outline: true,
+                    outlineColor: Cesium.Color.CYAN
+                }
+            });
+
+            planeEntities.push(entity);
+        }
     }).otherwise(function(error) {
         throw(error);
     });
@@ -111,38 +140,8 @@
     clippingPlanes = tileset.clippingPlanes = defaultClippingPlanes.slice();
 }
 
-var model;
-function loadModel(url) {
-    reset();
-
-    var position = Cesium.Cartesian3.fromDegrees(-123.0744619, 44.0503706, 100.0);
-    var heading = Cesium.Math.toRadians(135);
-    var pitch = 0;
-    var roll = 0;
-    var hpr = new Cesium.HeadingPitchRoll(heading, pitch, roll);
-    var orientation = Cesium.Transforms.headingPitchRollQuaternion(position, hpr);
-
-    var entity = viewer.entities.add({
-        name : url,
-        position : position,
-        orientation : orientation,
-        model : {
-            uri : url,
-            scale: 8,
-            minimumPixelSize: 100.0
-        }
-    });
-
-    viewer.trackedEntity = entity;
-    model = entity.model;
-    model.clippingPlanesEnabled = viewModel.clippingPlanesEnabled;
-    clippingPlanes = model.clippingPlanes = defaultClippingPlanes.slice();
-}
-
 // Power Plant design model provided by Bentley Systems
 var bimUrl = 'https://beta.cesium.com/api/assets/1459?access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzNjUyM2I5Yy01YmRhLTQ0MjktOGI0Zi02MDdmYzBjMmY0MjYiLCJpZCI6NDQsImFzc2V0cyI6WzE0NTldLCJpYXQiOjE0OTkyNjQ3ODF9.SW_rwY-ic0TwQBeiweXNqFyywoxnnUBtcVjeCmDGef4';
-var pointCloudUrl = 'https://beta.cesium.com/api/assets/1460?access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyMzk2YzJiOS1jZGFmLTRlZmYtYmQ4MS00NTA3NjEwMzViZTkiLCJpZCI6NDQsImFzc2V0cyI6WzE0NjBdLCJpYXQiOjE0OTkyNjQ3NTV9.oWjvN52CRQ-dk3xtvD4e8ZnOHZhoWSpJLlw115mbQJM';
-var modelUrl = '../../SampleData/models/CesiumAir/Cesium_Air.glb';
 
 loadTileset(bimUrl);
 
@@ -151,45 +150,16 @@
 Cesium.knockout.track(viewModel);
 Cesium.knockout.applyBindings(viewModel, toolbar);
 
-Cesium.knockout.getObservable(viewModel, 'xOffset').subscribe(function(newValue) {
-    clippingPlanes[0].distance = parseFloat(newValue);
-});
-
-Cesium.knockout.getObservable(viewModel, 'yOffset').subscribe(function(newValue) {
-    clippingPlanes[1].distance = parseFloat(newValue);
-});
-
-Cesium.knockout.getObservable(viewModel, 'zOffset').subscribe(function(newValue) {
-    clippingPlanes[2].distance = parseFloat(newValue);
-});
-
 Cesium.knockout.getObservable(viewModel, 'debugBoundingVolumesEnabled').subscribe(function(newValue) {
     if (Cesium.defined(tileset)) {
         tileset.debugShowBoundingVolume = newValue;
     }
 });
-
-Cesium.knockout.getObservable(viewModel, 'clippingPlanesEnabled').subscribe(function(newValue) {
-    if (Cesium.defined(tileset)) {
-        tileset.clippingPlanesEnabled = newValue;
-    }
-});
-
-Cesium.knockout.getObservable(viewModel, 'exampleType').subscribe(
-    function(newValue) {
-        if (newValue === 'BIM') {
-            loadTileset(bimUrl);
-        } else if (newValue === 'Point Cloud') {
-            loadTileset(pointCloudUrl);
-        } else {
-            loadModel(modelUrl);
-        }
-    }
-);
-
-function reset () {
+    
+function reset() {
     viewer.entities.removeAll();
     viewer.scene.primitives.removeAll();
+    planeEntities = [];
 
     if (Cesium.defined(viewModel)) {
         viewModel.clippingPlanesEnabled = true;
diff --git a/CHANGES.md b/CHANGES.md
index 8dbc228e74bc..67d968efe6d8 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -5,6 +5,8 @@ Change Log
 
 * Added `clippingPlanes` property to `ModelGraphics` and `Cesium3DTileset`, which specifies an array of planes to clip the object. [TODO]()
 * Added `Plane.transformPlane` function to apply a transformation to a plane. [TODO]()
+* Added `PlaneGeometry` and `PlaneOutlineGeometry` primitives
+* Added `PlaneGraphics` and `plane` property to `Entity`.
 
 ### 1.38 - 2017-10-02
 
diff --git a/Source/Core/Plane.js b/Source/Core/Plane.js
index 824ecb9eb7c0..cec682af4071 100644
--- a/Source/Core/Plane.js
+++ b/Source/Core/Plane.js
@@ -183,10 +183,6 @@ define([
         return Plane.fromPointNormal(scratchPosition, scratchNormal, result);
     };
 
-    Plane.prototype.origin = function (result) {
-        Cartesian3.multiplyByScalar(this.normal, this.distance, result);
-    };
-
     /**
      * A constant initialized to the XY plane passing through the origin, with normal in positive Z.
      *
diff --git a/Source/Core/PlaneGeometry.js b/Source/Core/PlaneGeometry.js
index 43c59793c366..9a494d60415b 100644
--- a/Source/Core/PlaneGeometry.js
+++ b/Source/Core/PlaneGeometry.js
@@ -1,6 +1,5 @@
 define([
     './BoundingSphere',
-    './Cartesian2',
     './Cartesian3',
     './Check',
     './ComponentDatatype',
@@ -9,15 +8,10 @@ define([
     './Geometry',
     './GeometryAttribute',
     './GeometryAttributes',
-    './Matrix4',
-    './Plane',
     './PrimitiveType',
-    './Quaternion',
-    './TranslationRotationScale',
     './VertexFormat'
 ], function(
     BoundingSphere,
-    Cartesian2,
     Cartesian3,
     Check,
     ComponentDatatype,
@@ -26,11 +20,7 @@ define([
     Geometry,
     GeometryAttribute,
     GeometryAttributes,
-    Matrix4,
-    Plane,
     PrimitiveType,
-    Quaternion,
-    TranslationRotationScale,
     VertexFormat) {
     'use strict';
 
@@ -41,22 +31,15 @@ define([
      * @constructor
      *
      * @param {Object} options Object with the following properties:
-     * @param {Cartesian3} options.minimum The minimum x, y, and z coordinates of the box.
-     * @param {Cartesian3} options.maximum The maximum x, y, and z coordinates of the box.
      * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
      *
      * @see Plane
-     * @see PlaneGeometry.fromDimensions
      * @see PlaneGeometry.createGeometry
      * @see Packable
      *
-     * @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=Box.html|Cesium Sandcastle Box Demo}
-     *
      * @example
      * var planeGeometry = new Cesium.PlaneGeometry({
-     *   vertexFormat : Cesium.VertexFormat.POSITION_ONLY,
-     *   maximum : new Cesium.Cartesian3(250000.0, 250000.0, 250000.0),
-     *   minimum : new Cesium.Cartesian3(-250000.0, -250000.0, -250000.0)
+     *   vertexFormat : Cesium.VertexFormat.POSITION_ONLY
      * });
      * var geometry = Cesium.PlaneGeometry.createGeometry(plane);
      */
@@ -389,13 +372,11 @@ define([
             indices[11] = 2;
         }
 
-        var radius = 0.5;
-
         return new Geometry({
             attributes : attributes,
             indices : indices,
             primitiveType : PrimitiveType.TRIANGLES,
-            boundingSphere : new BoundingSphere(Cartesian3.ZERO, radius)
+            boundingSphere : new BoundingSphere(Cartesian3.ZERO, 0.5)
         });
     };
 
diff --git a/Source/Core/PlaneOutlineGeometry.js b/Source/Core/PlaneOutlineGeometry.js
new file mode 100644
index 000000000000..f3f0aaf55ff7
--- /dev/null
+++ b/Source/Core/PlaneOutlineGeometry.js
@@ -0,0 +1,143 @@
+define([
+    './BoundingSphere',
+    './Cartesian3',
+    './Check',
+    './ComponentDatatype',
+    './defaultValue',
+    './defined',
+    './Geometry',
+    './GeometryAttribute',
+    './GeometryAttributes',
+    './PrimitiveType'
+], function(
+    BoundingSphere,
+    Cartesian3,
+    Check,
+    ComponentDatatype,
+    defaultValue,
+    defined,
+    Geometry,
+    GeometryAttribute,
+    GeometryAttributes,
+    PrimitiveType) {
+    'use strict';
+
+    /**
+     * A description of the outline of a cube centered at the origin.
+     *
+     * @alias PlaneOutlineGeometry
+     * @constructor
+     *
+     * @param {Object} options Object with the following properties:
+     * @param {Cartesian3} options.minimum The minimum x, y, and z coordinates of the box.
+     * @param {Cartesian3} options.maximum The maximum x, y, and z coordinates of the box.
+     *
+     * @see PlaneOutlineGeometry.fromDimensions
+     * @see PlaneOutlineGeometry.createGeometry
+     * @see Packable
+     *
+     * @example
+     * var box = new Cesium.PlaneOutlineGeometry({
+     *   maximum : new Cesium.Cartesian3(250000.0, 250000.0, 250000.0),
+     *   minimum : new Cesium.Cartesian3(-250000.0, -250000.0, -250000.0)
+     * });
+     * var geometry = Cesium.PlaneOutlineGeometry.createGeometry(box);
+     */
+    function PlaneOutlineGeometry(options) {
+        this._workerName = 'createPlaneOutlineGeometry';
+    }
+    /**
+     * The number of elements used to pack the object into an array.
+     * @type {Number}
+     */
+    PlaneOutlineGeometry.packedLength = 0;
+
+    /**
+     * Stores the provided instance into the provided array.
+     *
+     * @param {PlaneOutlineGeometry} 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
+     */
+    PlaneOutlineGeometry.pack = function(value, array, startingIndex) {
+        //>>includeStart('debug', pragmas.debug);
+        Check.defined('array', array);
+        //>>includeEnd('debug');
+
+        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 {PlaneOutlineGeometry} [result] The object into which to store the result.
+     * @returns {PlaneOutlineGeometry} The modified result parameter or a new PlaneOutlineGeometry instance if one was not provided.
+     */
+    PlaneOutlineGeometry.unpack = function(array, startingIndex, result) {
+        //>>includeStart('debug', pragmas.debug);
+        Check.defined('array', array);
+        //>>includeEnd('debug');
+
+        if (!defined(result)) {
+            return new PlaneOutlineGeometry();
+        }
+
+        return result;
+    };
+
+    /**
+     * Computes the geometric representation of an outline of a box, including its vertices, indices, and a bounding sphere.
+     *
+     * @param {PlaneOutlineGeometry} boxGeometry A description of the box outline.
+     * @returns {Geometry|undefined} The computed vertices and indices.
+     */
+    PlaneOutlineGeometry.createGeometry = function(boxGeometry) {
+        var min = new Cartesian3(-0.5, -0.5, 0.0);
+        var max = new Cartesian3( 0.5,  0.5, 0.0);
+
+        var attributes = new GeometryAttributes();
+        var indices = new Uint16Array(4 * 2);
+        var positions = new Float64Array(4 * 3);
+
+        positions[0] = min.x;
+        positions[1] = min.y;
+        positions[2] = min.z;
+        positions[3] = max.x;
+        positions[4] = min.y;
+        positions[5] = min.z;
+        positions[6] = max.x;
+        positions[7] = max.y;
+        positions[8] = min.z;
+        positions[9] = min.x;
+        positions[10] = max.y;
+        positions[11] = min.z;
+
+        attributes.position = new GeometryAttribute({
+            componentDatatype : ComponentDatatype.DOUBLE,
+            componentsPerAttribute : 3,
+            values : positions
+        });
+
+        indices[0] = 0;
+        indices[1] = 1;
+        indices[2] = 1;
+        indices[3] = 2;
+        indices[4] = 2;
+        indices[5] = 3;
+        indices[6] = 3;
+        indices[7] = 0;
+
+        return new Geometry({
+            attributes : attributes,
+            indices : indices,
+            primitiveType : PrimitiveType.LINES,
+            boundingSphere : new BoundingSphere(Cartesian3.ZERO, 0.5)
+        });
+    };
+
+    return PlaneOutlineGeometry;
+});
diff --git a/Source/DataSources/DataSourceDisplay.js b/Source/DataSources/DataSourceDisplay.js
index 98d243669d77..977845700c24 100644
--- a/Source/DataSources/DataSourceDisplay.js
+++ b/Source/DataSources/DataSourceDisplay.js
@@ -20,6 +20,7 @@ define([
         './LabelVisualizer',
         './ModelVisualizer',
         './PathVisualizer',
+        './PlaneGeometryUpdater',
         './PointVisualizer',
         './PolygonGeometryUpdater',
         './PolylineGeometryUpdater',
@@ -48,6 +49,7 @@ define([
         LabelVisualizer,
         ModelVisualizer,
         PathVisualizer,
+        PlaneGeometryUpdater,
         PointVisualizer,
         PolygonGeometryUpdater,
         PolylineGeometryUpdater,
@@ -114,6 +116,7 @@ define([
                 new GeometryVisualizer(CorridorGeometryUpdater, scene, entities),
                 new GeometryVisualizer(EllipseGeometryUpdater, scene, entities),
                 new GeometryVisualizer(EllipsoidGeometryUpdater, scene, entities),
+                new GeometryVisualizer(PlaneGeometryUpdater, scene, entities),
                 new GeometryVisualizer(PolygonGeometryUpdater, scene, entities),
                 new GeometryVisualizer(PolylineGeometryUpdater, scene, entities),
                 new GeometryVisualizer(PolylineVolumeGeometryUpdater, scene, entities),
diff --git a/Source/DataSources/Entity.js b/Source/DataSources/Entity.js
index 42c634f3b1b5..b487bdece44c 100644
--- a/Source/DataSources/Entity.js
+++ b/Source/DataSources/Entity.js
@@ -23,6 +23,7 @@ define([
         './LabelGraphics',
         './ModelGraphics',
         './PathGraphics',
+        './PlaneGraphics',
         './PointGraphics',
         './PolygonGraphics',
         './PolylineGraphics',
@@ -56,6 +57,7 @@ define([
         LabelGraphics,
         ModelGraphics,
         PathGraphics,
+        PlaneGraphics,
         PointGraphics,
         PolygonGraphics,
         PolylineGraphics,
@@ -109,6 +111,7 @@ define([
      * @param {LabelGraphics} [options.label] A options.label to associate with this entity.
      * @param {ModelGraphics} [options.model] A model to associate with this entity.
      * @param {PathGraphics} [options.path] A path to associate with this entity.
+     * @param {PlaneGraphics} [options.plane] A plane to associate with this entity.
      * @param {PointGraphics} [options.point] A point to associate with this entity.
      * @param {PolygonGraphics} [options.polygon] A polygon to associate with this entity.
      * @param {PolylineGraphics} [options.polyline] A polyline to associate with this entity.
@@ -134,7 +137,7 @@ define([
         this._show = defaultValue(options.show, true);
         this._parent = undefined;
         this._propertyNames = ['billboard', 'box', 'corridor', 'cylinder', 'description', 'ellipse', //
-                               'ellipsoid', 'label', 'model', 'orientation', 'path', 'point', 'polygon', //
+                               'ellipsoid', 'label', 'model', 'orientation', 'path', 'plane', 'point', 'polygon', //
                                'polyline', 'polylineVolume', 'position', 'properties', 'rectangle', 'viewFrom', 'wall'];
 
         this._billboard = undefined;
@@ -159,6 +162,8 @@ define([
         this._orientationSubscription = undefined;
         this._path = undefined;
         this._pathSubscription = undefined;
+        this._plane = undefined;
+        this._planeSubscription = undefined;
         this._point = undefined;
         this._pointSubscription = undefined;
         this._polygon = undefined;
@@ -398,6 +403,12 @@ define([
          * @type {PathGraphics}
          */
         path : createPropertyTypeDescriptor('path', PathGraphics),
+        /**
+         * Gets or sets the plane.
+         * @memberof Entity.prototype
+         * @type {PlaneGraphics}
+         */
+        plane : createPropertyTypeDescriptor('plane', PlaneGraphics),
         /**
          * Gets or sets the point graphic.
          * @memberof Entity.prototype
diff --git a/Source/DataSources/PlaneGeometryUpdater.js b/Source/DataSources/PlaneGeometryUpdater.js
new file mode 100644
index 000000000000..6ee862b5e7aa
--- /dev/null
+++ b/Source/DataSources/PlaneGeometryUpdater.js
@@ -0,0 +1,723 @@
+define([
+    '../Core/PlaneGeometry',
+    '../Core/PlaneOutlineGeometry',
+    '../Core/Cartesian2',
+    '../Core/Cartesian3',
+    '../Core/Color',
+    '../Core/ColorGeometryInstanceAttribute',
+    '../Core/defaultValue',
+    '../Core/defined',
+    '../Core/defineProperties',
+    '../Core/destroyObject',
+    '../Core/DeveloperError',
+    '../Core/DistanceDisplayCondition',
+    '../Core/DistanceDisplayConditionGeometryInstanceAttribute',
+    '../Core/Event',
+    '../Core/GeometryInstance',
+    '../Core/Iso8601',
+    '../Core/Matrix4',
+    '../Core/ShowGeometryInstanceAttribute',
+    '../Core/Quaternion',
+    '../Scene/MaterialAppearance',
+    '../Scene/PerInstanceColorAppearance',
+    '../Scene/Primitive',
+    '../Scene/ShadowMode',
+    './ColorMaterialProperty',
+    './ConstantProperty',
+    './dynamicGeometryGetBoundingSphere',
+    './MaterialProperty',
+    './Property'
+], function(
+    PlaneGeometry,
+    PlaneOutlineGeometry,
+    Cartesian2,
+    Cartesian3,
+    Color,
+    ColorGeometryInstanceAttribute,
+    defaultValue,
+    defined,
+    defineProperties,
+    destroyObject,
+    DeveloperError,
+    DistanceDisplayCondition,
+    DistanceDisplayConditionGeometryInstanceAttribute,
+    Event,
+    GeometryInstance,
+    Iso8601,
+    Matrix4,
+    ShowGeometryInstanceAttribute,
+    Quaternion,
+    MaterialAppearance,
+    PerInstanceColorAppearance,
+    Primitive,
+    ShadowMode,
+    ColorMaterialProperty,
+    ConstantProperty,
+    dynamicGeometryGetBoundingSphere,
+    MaterialProperty,
+    Property) {
+    'use strict';
+
+    var defaultMaterial = new ColorMaterialProperty(Color.WHITE);
+    var defaultShow = new ConstantProperty(true);
+    var defaultFill = new ConstantProperty(true);
+    var defaultOutline = new ConstantProperty(false);
+    var defaultOutlineColor = new ConstantProperty(Color.BLACK);
+    var defaultShadows = new ConstantProperty(ShadowMode.DISABLED);
+    var defaultDistanceDisplayCondition = new ConstantProperty(new DistanceDisplayCondition());
+    var scratchColor = new Color();
+
+    function GeometryOptions(entity) {
+        this.id = entity;
+        this.vertexFormat = undefined;
+        this.normal = undefined;
+        this.distance = 0.0;
+        this.dimensions = undefined;
+    }
+
+    /**
+     * A {@link GeometryUpdater} for planes.
+     * Clients do not normally create this class directly, but instead rely on {@link DataSourceDisplay}.
+     * @alias PlaneGeometryUpdater
+     * @constructor
+     *
+     * @param {Entity} entity The entity containing the geometry to be visualized.
+     * @param {Scene} scene The scene where visualization is taking place.
+     */
+    function PlaneGeometryUpdater(entity, scene) {
+        //>>includeStart('debug', pragmas.debug);
+        if (!defined(entity)) {
+            throw new DeveloperError('entity is required');
+        }
+        if (!defined(scene)) {
+            throw new DeveloperError('scene is required');
+        }
+        //>>includeEnd('debug');
+
+        this._entity = entity;
+        this._scene = scene;
+        this._entitySubscription = entity.definitionChanged.addEventListener(PlaneGeometryUpdater.prototype._onEntityPropertyChanged, this);
+        this._fillEnabled = false;
+        this._dynamic = false;
+        this._outlineEnabled = false;
+        this._geometryChanged = new Event();
+        this._showProperty = undefined;
+        this._materialProperty = undefined;
+        this._hasConstantOutline = true;
+        this._showOutlineProperty = undefined;
+        this._outlineColorProperty = undefined;
+        this._outlineWidth = 1.0;
+        this._shadowsProperty = undefined;
+        this._distanceDisplayConditionProperty = undefined;
+        this._options = new GeometryOptions(entity);
+        this._onEntityPropertyChanged(entity, 'plane', entity.plane, undefined);
+    }
+
+    defineProperties(PlaneGeometryUpdater, {
+        /**
+         * Gets the type of Appearance to use for simple color-based geometry.
+         * @memberof PlaneGeometryUpdater
+         * @type {Appearance}
+         */
+        perInstanceColorAppearanceType : {
+            value : PerInstanceColorAppearance
+        },
+        /**
+         * Gets the type of Appearance to use for material-based geometry.
+         * @memberof PlaneGeometryUpdater
+         * @type {Appearance}
+         */
+        materialAppearanceType : {
+            value : MaterialAppearance
+        }
+    });
+
+    defineProperties(PlaneGeometryUpdater.prototype, {
+        /**
+         * Gets the entity associated with this geometry.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Entity}
+         * @readonly
+         */
+        entity : {
+            get : function() {
+                return this._entity;
+            }
+        },
+        /**
+         * Gets a value indicating if the geometry has a fill component.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Boolean}
+         * @readonly
+         */
+        fillEnabled : {
+            get : function() {
+                return this._fillEnabled;
+            }
+        },
+        /**
+         * Gets a value indicating if fill visibility varies with simulation time.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Boolean}
+         * @readonly
+         */
+        hasConstantFill : {
+            get : function() {
+                return !this._fillEnabled ||
+                       (!defined(this._entity.availability) &&
+                        Property.isConstant(this._showProperty) &&
+                        Property.isConstant(this._fillProperty));
+            }
+        },
+        /**
+         * Gets the material property used to fill the geometry.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {MaterialProperty}
+         * @readonly
+         */
+        fillMaterialProperty : {
+            get : function() {
+                return this._materialProperty;
+            }
+        },
+        /**
+         * Gets a value indicating if the geometry has an outline component.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Boolean}
+         * @readonly
+         */
+        outlineEnabled : {
+            get : function() {
+                return this._outlineEnabled;
+            }
+        },
+        /**
+         * Gets a value indicating if the geometry has an outline component.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Boolean}
+         * @readonly
+         */
+        hasConstantOutline : {
+            get : function() {
+                return !this._outlineEnabled ||
+                       (!defined(this._entity.availability) &&
+                        Property.isConstant(this._showProperty) &&
+                        Property.isConstant(this._showOutlineProperty));
+            }
+        },
+        /**
+         * Gets the {@link Color} property for the geometry outline.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Property}
+         * @readonly
+         */
+        outlineColorProperty : {
+            get : function() {
+                return this._outlineColorProperty;
+            }
+        },
+        /**
+         * Gets the constant with of the geometry outline, in pixels.
+         * This value is only valid if isDynamic is false.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Number}
+         * @readonly
+         */
+        outlineWidth : {
+            get : function() {
+                return this._outlineWidth;
+            }
+        },
+        /**
+         * Gets the property specifying whether the geometry
+         * casts or receives shadows from each light source.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Property}
+         * @readonly
+         */
+        shadowsProperty : {
+            get : function() {
+                return this._shadowsProperty;
+            }
+        },
+        /**
+         * Gets or sets the {@link DistanceDisplayCondition} Property specifying at what distance from the camera that this geometry will be displayed.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Property}
+         * @readonly
+         */
+        distanceDisplayConditionProperty : {
+            get : function() {
+                return this._distanceDisplayConditionProperty;
+            }
+        },
+        /**
+         * Gets a value indicating if the geometry is time-varying.
+         * If true, all visualization is delegated to the {@link DynamicGeometryUpdater}
+         * returned by GeometryUpdater#createDynamicUpdater.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Boolean}
+         * @readonly
+         */
+        isDynamic : {
+            get : function() {
+                return this._dynamic;
+            }
+        },
+        /**
+         * Gets a value indicating if the geometry is closed.
+         * This property is only valid for static geometry.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Boolean}
+         * @readonly
+         */
+        isClosed : {
+            value : true
+        },
+        /**
+         * Gets an event that is raised whenever the public properties
+         * of this updater change.
+         * @memberof PlaneGeometryUpdater.prototype
+         *
+         * @type {Boolean}
+         * @readonly
+         */
+        geometryChanged : {
+            get : function() {
+                return this._geometryChanged;
+            }
+        }
+    });
+
+    /**
+     * Checks if the geometry is outlined at the provided time.
+     *
+     * @param {JulianDate} time The time for which to retrieve visibility.
+     * @returns {Boolean} true if geometry is outlined at the provided time, false otherwise.
+     */
+    PlaneGeometryUpdater.prototype.isOutlineVisible = function(time) {
+        var entity = this._entity;
+        return this._outlineEnabled && entity.isAvailable(time) && this._showProperty.getValue(time) && this._showOutlineProperty.getValue(time);
+    };
+
+    /**
+     * Checks if the geometry is filled at the provided time.
+     *
+     * @param {JulianDate} time The time for which to retrieve visibility.
+     * @returns {Boolean} true if geometry is filled at the provided time, false otherwise.
+     */
+    PlaneGeometryUpdater.prototype.isFilled = function(time) {
+        var entity = this._entity;
+        return this._fillEnabled && entity.isAvailable(time) && this._showProperty.getValue(time) && this._fillProperty.getValue(time);
+    };
+
+    /**
+     * Creates the geometry instance which represents the fill of the geometry.
+     *
+     * @param {JulianDate} time The time to use when retrieving initial attribute values.
+     * @returns {GeometryInstance} The geometry instance representing the filled portion of the geometry.
+     *
+     * @exception {DeveloperError} This instance does not represent a filled geometry.
+     */
+    PlaneGeometryUpdater.prototype.createFillGeometryInstance = function(time) {
+        //>>includeStart('debug', pragmas.debug);
+        if (!defined(time)) {
+            throw new DeveloperError('time is required.');
+        }
+
+        if (!this._fillEnabled) {
+            throw new DeveloperError('This instance does not represent a filled geometry.');
+        }
+        //>>includeEnd('debug');
+
+        var entity = this._entity;
+        var isAvailable = entity.isAvailable(time);
+
+        var attributes;
+
+        var color;
+        var show = new ShowGeometryInstanceAttribute(isAvailable && entity.isShowing && this._showProperty.getValue(time) && this._fillProperty.getValue(time));
+        var distanceDisplayCondition = this._distanceDisplayConditionProperty.getValue(time);
+        var distanceDisplayConditionAttribute = DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(distanceDisplayCondition);
+        if (this._materialProperty instanceof ColorMaterialProperty) {
+            var currentColor = Color.WHITE;
+            if (defined(this._materialProperty.color) && (this._materialProperty.color.isConstant || isAvailable)) {
+                currentColor = this._materialProperty.color.getValue(time);
+            }
+            color = ColorGeometryInstanceAttribute.fromColor(currentColor);
+            attributes = {
+                show : show,
+                distanceDisplayCondition : distanceDisplayConditionAttribute,
+                color : color
+            };
+        } else {
+            attributes = {
+                show : show,
+                distanceDisplayCondition : distanceDisplayConditionAttribute
+            };
+        }
+
+        var options = this._options;
+        var normal = options.normal;
+        var distance = options.distance;
+        var dimensions = options.dimensions;
+
+        var modelMatrix = entity.computeModelMatrix(Iso8601.MINIMUM_VALUE);
+        //modelMatrix = createPrimitiveMatrix(normal, distance, dimensions, modelMatrix, modelMatrix);
+
+        return new GeometryInstance({
+            id : entity,
+            geometry : new PlaneGeometry(),
+            modelMatrix : modelMatrix,
+            attributes : attributes
+        });
+    };
+
+    /**
+     * Creates the geometry instance which represents the outline of the geometry.
+     *
+     * @param {JulianDate} time The time to use when retrieving initial attribute values.
+     * @returns {GeometryInstance} The geometry instance representing the outline portion of the geometry.
+     *
+     * @exception {DeveloperError} This instance does not represent an outlined geometry.
+     */
+    PlaneGeometryUpdater.prototype.createOutlineGeometryInstance = function(time) {
+        //>>includeStart('debug', pragmas.debug);
+        if (!defined(time)) {
+            throw new DeveloperError('time is required.');
+        }
+
+        if (!this._outlineEnabled) {
+            throw new DeveloperError('This instance does not represent an outlined geometry.');
+        }
+        //>>includeEnd('debug');
+
+        var entity = this._entity;
+        var isAvailable = entity.isAvailable(time);
+        var outlineColor = Property.getValueOrDefault(this._outlineColorProperty, time, Color.BLACK);
+        var distanceDisplayCondition = this._distanceDisplayConditionProperty.getValue(time);
+
+        var options = this._options;
+        var normal = options.normal;
+        var distance = options.distance;
+        var dimensions = options.dimensions;
+
+        var modelMatrix = entity.computeModelMatrix(Iso8601.MINIMUM_VALUE);
+        //modelMatrix = createPrimitiveMatrix(normal, distance, dimensions, modelMatrix, modelMatrix);
+
+        return new GeometryInstance({
+            id : entity,
+            geometry : new PlaneOutlineGeometry(),
+            modelMatrix : modelMatrix,
+            attributes : {
+                show : new ShowGeometryInstanceAttribute(isAvailable && entity.isShowing && this._showProperty.getValue(time) && this._showOutlineProperty.getValue(time)),
+                color : ColorGeometryInstanceAttribute.fromColor(outlineColor),
+                distanceDisplayCondition : DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(distanceDisplayCondition)
+            }
+        });
+    };
+
+    /**
+     * Returns true if this object was destroyed; otherwise, false.
+     *
+     * @returns {Boolean} True if this object was destroyed; otherwise, false.
+     */
+    PlaneGeometryUpdater.prototype.isDestroyed = function() {
+        return false;
+    };
+
+    /**
+     * Destroys and resources used by the object.  Once an object is destroyed, it should not be used.
+     *
+     * @exception {DeveloperError} This object was destroyed, i.e., destroy() was called.
+     */
+    PlaneGeometryUpdater.prototype.destroy = function() {
+        this._entitySubscription();
+        destroyObject(this);
+    };
+
+    PlaneGeometryUpdater.prototype._onEntityPropertyChanged = function(entity, propertyName, newValue, oldValue) {
+        if (!(propertyName === 'availability' || propertyName === 'position' || propertyName === 'orientation' || propertyName === 'plane')) {
+            return;
+        }
+
+        var plane = this._entity.plane;
+
+
+
+        if (!defined(plane)) {
+            if (this._fillEnabled || this._outlineEnabled) {
+                this._fillEnabled = false;
+                this._outlineEnabled = false;
+                this._geometryChanged.raiseEvent(this);
+            }
+            return;
+        }
+
+        var fillProperty = plane.fill;
+        var fillEnabled = defined(fillProperty) && fillProperty.isConstant ? fillProperty.getValue(Iso8601.MINIMUM_VALUE) : true;
+
+        var outlineProperty = plane.outline;
+        var outlineEnabled = defined(outlineProperty);
+        if (outlineEnabled && outlineProperty.isConstant) {
+            outlineEnabled = outlineProperty.getValue(Iso8601.MINIMUM_VALUE);
+        }
+
+        if (!fillEnabled && !outlineEnabled) {
+            if (this._fillEnabled || this._outlineEnabled) {
+                this._fillEnabled = false;
+                this._outlineEnabled = false;
+                this._geometryChanged.raiseEvent(this);
+            }
+            return;
+        }
+
+        var normal = plane.normal;
+        var distance = plane.distance;
+        var dimensions = plane.dimensions;
+        var position = entity.position;
+
+        var show = plane.show;
+        if (!defined(normal) || !defined(distance) || !defined(position) || (defined(show) && show.isConstant && !show.getValue(Iso8601.MINIMUM_VALUE))) {
+            if (this._fillEnabled || this._outlineEnabled) {
+                this._fillEnabled = false;
+                this._outlineEnabled = false;
+                this._geometryChanged.raiseEvent(this);
+            }
+            return;
+        }
+
+        var material = defaultValue(plane.material, defaultMaterial);
+        var isColorMaterial = material instanceof ColorMaterialProperty;
+        this._materialProperty = material;
+        this._fillProperty = defaultValue(fillProperty, defaultFill);
+        this._showProperty = defaultValue(show, defaultShow);
+        this._showOutlineProperty = defaultValue(plane.outline, defaultOutline);
+        this._outlineColorProperty = outlineEnabled ? defaultValue(plane.outlineColor, defaultOutlineColor) : undefined;
+        this._shadowsProperty = defaultValue(plane.shadows, defaultShadows);
+        this._distanceDisplayConditionProperty = defaultValue(plane.distanceDisplayCondition, defaultDistanceDisplayCondition);
+
+        var outlineWidth = plane.outlineWidth;
+
+        this._fillEnabled = fillEnabled;
+        this._outlineEnabled = outlineEnabled;
+
+        if (!position.isConstant || //
+            !Property.isConstant(entity.orientation) || //
+            !normal.isConstant || //
+            !distance.isConstant || //
+            !dimensions.isConstant || //
+            !Property.isConstant(outlineWidth)) {
+            if (!this._dynamic) {
+                this._dynamic = true;
+                this._geometryChanged.raiseEvent(this);
+            }
+        } else {
+            var options = this._options;
+            options.vertexFormat = isColorMaterial ? PerInstanceColorAppearance.VERTEX_FORMAT : MaterialAppearance.MaterialSupport.TEXTURED.vertexFormat;
+            options.normal = normal.getValue(Iso8601.MINIMUM_VALUE, options.normal);
+            options.distance = distance.getValue(Iso8601.MINIMUM_VALUE, options.distance);
+            options.dimensions = dimensions.getValue(Iso8601.MINIMUM_VALUE, options.dimensions);
+            this._outlineWidth = defined(outlineWidth) ? outlineWidth.getValue(Iso8601.MINIMUM_VALUE) : 1.0;
+            this._dynamic = false;
+            this._geometryChanged.raiseEvent(this);
+        }
+    };
+
+    /**
+     * Creates the dynamic updater to be used when GeometryUpdater#isDynamic is true.
+     *
+     * @param {PrimitiveCollection} primitives The primitive collection to use.
+     * @returns {DynamicGeometryUpdater} The dynamic updater used to update the geometry each frame.
+     *
+     * @exception {DeveloperError} This instance does not represent dynamic geometry.
+     */
+    PlaneGeometryUpdater.prototype.createDynamicUpdater = function(primitives) {
+        //>>includeStart('debug', pragmas.debug);
+        if (!this._dynamic) {
+            throw new DeveloperError('This instance does not represent dynamic geometry.');
+        }
+
+        if (!defined(primitives)) {
+            throw new DeveloperError('primitives is required.');
+        }
+        //>>includeEnd('debug');
+
+        return new DynamicGeometryUpdater(primitives, this);
+    };
+
+    /**
+     * @private
+     */
+    function DynamicGeometryUpdater(primitives, geometryUpdater) {
+        this._primitives = primitives;
+        this._primitive = undefined;
+        this._outlinePrimitive = undefined;
+        this._geometryUpdater = geometryUpdater;
+        this._options = new GeometryOptions(geometryUpdater._entity);
+    }
+    DynamicGeometryUpdater.prototype.update = function(time) {
+        //>>includeStart('debug', pragmas.debug);
+        if (!defined(time)) {
+            throw new DeveloperError('time is required.');
+        }
+        //>>includeEnd('debug');
+
+        var primitives = this._primitives;
+        primitives.removeAndDestroy(this._primitive);
+        primitives.removeAndDestroy(this._outlinePrimitive);
+        this._primitive = undefined;
+        this._outlinePrimitive = undefined;
+
+        var geometryUpdater = this._geometryUpdater;
+        var entity = geometryUpdater._entity;
+        var plane = entity.plane;
+        if (!entity.isShowing || !entity.isAvailable(time) || !Property.getValueOrDefault(plane.show, time, true)) {
+            return;
+        }
+
+        var options = this._options;
+        var modelMatrix = entity.computeModelMatrix(time);
+        var normal = Property.getValueOrDefault(plane.normal, time, options.normal);
+        var distance = Property.getValueOrUndefined(plane.distance, time, options.distance);
+        var dimensions = Property.getValueOrUndefined(plane.dimensions, time, options.dimensions);
+        if (!defined(modelMatrix) || !defined(normal) || !defined(distance) || !defined(dimensions)) {
+            return;
+        }
+
+        options.normal = normal;
+        options.distance = distance;
+        options.dimensions = dimensions;
+
+        modelMatrix = createPrimitiveMatrix(normal, distance, dimensions, modelMatrix, modelMatrix);
+
+        var shadows = this._geometryUpdater.shadowsProperty.getValue(time);
+
+        var distanceDisplayConditionProperty = this._geometryUpdater.distanceDisplayConditionProperty;
+        var distanceDisplayCondition = distanceDisplayConditionProperty.getValue(time);
+        var distanceDisplayConditionAttribute = DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(distanceDisplayCondition);
+
+        if (Property.getValueOrDefault(plane.fill, time, true)) {
+            var material = MaterialProperty.getValue(time, geometryUpdater.fillMaterialProperty, this._material);
+            this._material = material;
+
+            var appearance = new MaterialAppearance({
+                material : material,
+                translucent : material.isTranslucent(),
+                closed : true
+            });
+            options.vertexFormat = appearance.vertexFormat;
+
+            this._primitive = primitives.add(new Primitive({
+                geometryInstances : new GeometryInstance({
+                    id : entity,
+                    geometry : new PlaneGeometry(),
+                    modelMatrix : modelMatrix,
+                    attributes : {
+                        distanceDisplayCondition : distanceDisplayConditionAttribute
+                    }
+                }),
+                appearance : appearance,
+                asynchronous : false,
+                shadows : shadows
+            }));
+        }
+
+        if (Property.getValueOrDefault(plane.outline, time, false)) {
+            options.vertexFormat = PerInstanceColorAppearance.VERTEX_FORMAT;
+
+            var outlineColor = Property.getValueOrClonedDefault(plane.outlineColor, time, Color.BLACK, scratchColor);
+            var outlineWidth = Property.getValueOrDefault(plane.outlineWidth, time, 1.0);
+            var translucent = outlineColor.alpha !== 1.0;
+
+            this._outlinePrimitive = primitives.add(new Primitive({
+                geometryInstances : new GeometryInstance({
+                    id : entity,
+                    geometry : new PlaneOutlineGeometry(),
+                    modelMatrix : modelMatrix,
+                    attributes : {
+                        color : ColorGeometryInstanceAttribute.fromColor(outlineColor),
+                        distanceDisplayCondition : distanceDisplayConditionAttribute
+                    }
+                }),
+                appearance : new PerInstanceColorAppearance({
+                    flat : true,
+                    translucent : translucent,
+                    renderState : {
+                        lineWidth : geometryUpdater._scene.clampLineWidth(outlineWidth)
+                    }
+                }),
+                asynchronous : false,
+                shadows : shadows
+            }));
+        }
+    };
+
+    var scratchTranslation = new Cartesian3();
+    var scratchNormal = new Cartesian3();
+    var scratchScale = new Cartesian3();
+    var defaultDimensions = new Cartesian2(1.0, 1.0);
+    function createPrimitiveMatrix (normal, distance, dimensions, modelMatrix, result) {
+        if (!defined(normal)) {
+            normal = Cartesian3.UNIT_X;
+        }
+        if (!defined(distance)) {
+            distance = 0.0;
+        }
+        if (!defined(dimensions)) {
+            dimensions = defaultDimensions;
+        }
+
+        var translation = Cartesian3.multiplyByScalar(normal, distance, scratchTranslation);
+        translation = Matrix4.multiplyByPoint(modelMatrix, translation, translation);
+
+        var transformedNormal = Matrix4.multiplyByPointAsVector(modelMatrix, normal, scratchNormal);
+        Cartesian3.normalize(transformedNormal, transformedNormal);
+        var rotation = getRotationMatrix(transformedNormal, Cartesian3.UNIT_Z);
+
+        var scale = Cartesian2.clone(dimensions, scratchScale);
+        scale.z = 1.0;
+
+        return Matrix4.fromTranslationQuaternionRotationScale(translation, rotation, scale, result);
+    }
+
+    // get a rotation according to a normal
+    function getRotationMatrix(direction, up) {
+        var angle = Cartesian3.angleBetween(direction, up);
+        if (angle === 0.0) {
+            return Quaternion.IDENTITY;
+        }
+
+        var axis = Cartesian3.cross(up, direction, new Cartesian3());
+        return Quaternion.fromAxisAngle(axis, angle);
+    }
+
+    DynamicGeometryUpdater.prototype.getBoundingSphere = function(entity, result) {
+        return dynamicGeometryGetBoundingSphere(entity, this._primitive, this._outlinePrimitive, result);
+    };
+
+    DynamicGeometryUpdater.prototype.isDestroyed = function() {
+        return false;
+    };
+
+    DynamicGeometryUpdater.prototype.destroy = function() {
+        var primitives = this._primitives;
+        primitives.removeAndDestroy(this._primitive);
+        primitives.removeAndDestroy(this._outlinePrimitive);
+        destroyObject(this);
+    };
+
+    return PlaneGeometryUpdater;
+});
diff --git a/Source/DataSources/PlaneGraphics.js b/Source/DataSources/PlaneGraphics.js
new file mode 100644
index 000000000000..3aac0ea91e95
--- /dev/null
+++ b/Source/DataSources/PlaneGraphics.js
@@ -0,0 +1,199 @@
+define([
+    '../Core/defaultValue',
+    '../Core/defined',
+    '../Core/defineProperties',
+    '../Core/DeveloperError',
+    '../Core/Event',
+    './createMaterialPropertyDescriptor',
+    './createPropertyDescriptor'
+], function(
+    defaultValue,
+    defined,
+    defineProperties,
+    DeveloperError,
+    Event,
+    createMaterialPropertyDescriptor,
+    createPropertyDescriptor) {
+    'use strict';
+
+    /**
+     * Describes a plane. The center position and orientation are determined by the containing {@link Entity}.
+     *
+     * @alias PlaneGraphics
+     * @constructor
+     *
+     * @param {Object} [options] Object with the following properties:
+     * @param {Property} [options.dimensions] A {@link Cartesian3} Property specifying the length, width, and height of the box.
+     * @param {Property} [options.show=true] A boolean Property specifying the visibility of the box.
+     * @param {Property} [options.fill=true] A boolean Property specifying whether the box is filled with the provided material.
+     * @param {MaterialProperty} [options.material=Color.WHITE] A Property specifying the material used to fill the box.
+     * @param {Property} [options.outline=false] A boolean Property specifying whether the box is outlined.
+     * @param {Property} [options.outlineColor=Color.BLACK] A Property specifying the {@link Color} of the outline.
+     * @param {Property} [options.outlineWidth=1.0] A numeric Property specifying the width of the outline.
+     * @param {Property} [options.shadows=ShadowMode.DISABLED] An enum Property specifying whether the box casts or receives shadows from each light source.
+     * @param {Property} [options.distanceDisplayCondition] A Property specifying at what distance from the camera that this box will be displayed.
+     *
+     * @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=Box.html|Cesium Sandcastle Box Demo}
+     */
+    function PlaneGraphics(options) {
+        this._normal = undefined;
+        this._normalSubscription = undefined;
+        this._distance = undefined;
+        this._distanceSubscription = undefined;
+        this._dimensions = undefined;
+        this._dimensionsSubscription = undefined;
+        this._show = undefined;
+        this._showSubscription = undefined;
+        this._fill = undefined;
+        this._fillSubscription = undefined;
+        this._material = undefined;
+        this._materialSubscription = undefined;
+        this._outline = undefined;
+        this._outlineSubscription = undefined;
+        this._outlineColor = undefined;
+        this._outlineColorSubscription = undefined;
+        this._outlineWidth = undefined;
+        this._outlineWidthSubscription = undefined;
+        this._shadows = undefined;
+        this._shadowsSubscription = undefined;
+        this._distanceDisplayCondition = undefined;
+        this._distanceDisplayConditionSubscription = undefined;
+        this._definitionChanged = new Event();
+
+        this.merge(defaultValue(options, defaultValue.EMPTY_OBJECT));
+    }
+
+    defineProperties(PlaneGraphics.prototype, {
+        /**
+         * Gets the event that is raised whenever a property or sub-property is changed or modified.
+         * @memberof PlaneGraphics.prototype
+         * @type {Event}
+         * @readonly
+         */
+        definitionChanged : {
+            get : function() {
+                return this._definitionChanged;
+            }
+        },
+
+        /**
+         * Gets or sets the boolean Property specifying the visibility of the box.
+         * @memberof PlaneGraphics.prototype
+         * @type {Property}
+         * @default true
+         */
+        show : createPropertyDescriptor('show'),
+
+        normal : createPropertyDescriptor('normal'),
+        distance : createPropertyDescriptor('distance'),
+        dimensions : createPropertyDescriptor('dimensions'),
+
+        /**
+         * Gets or sets the material used to fill the box.
+         * @memberof PlaneGraphics.prototype
+         * @type {MaterialProperty}
+         * @default Color.WHITE
+         */
+        material : createMaterialPropertyDescriptor('material'),
+
+        /**
+         * Gets or sets the boolean Property specifying whether the box is filled with the provided material.
+         * @memberof PlaneGraphics.prototype
+         * @type {Property}
+         * @default true
+         */
+        fill : createPropertyDescriptor('fill'),
+
+        /**
+         * Gets or sets the Property specifying whether the box is outlined.
+         * @memberof PlaneGraphics.prototype
+         * @type {Property}
+         * @default false
+         */
+        outline : createPropertyDescriptor('outline'),
+
+        /**
+         * Gets or sets the Property specifying the {@link Color} of the outline.
+         * @memberof PlaneGraphics.prototype
+         * @type {Property}
+         * @default Color.BLACK
+         */
+        outlineColor : createPropertyDescriptor('outlineColor'),
+
+        /**
+         * Gets or sets the numeric Property specifying the width of the outline.
+         * @memberof PlaneGraphics.prototype
+         * @type {Property}
+         * @default 1.0
+         */
+        outlineWidth : createPropertyDescriptor('outlineWidth'),
+
+        /**
+         * Get or sets the enum Property specifying whether the box
+         * casts or receives shadows from each light source.
+         * @memberof PlaneGraphics.prototype
+         * @type {Property}
+         * @default ShadowMode.DISABLED
+         */
+        shadows : createPropertyDescriptor('shadows'),
+
+        /**
+         * Gets or sets the {@link DistanceDisplayCondition} Property specifying at what distance from the camera that this box will be displayed.
+         * @memberof PlaneGraphics.prototype
+         * @type {Property}
+         */
+        distanceDisplayCondition : createPropertyDescriptor('distanceDisplayCondition')
+    });
+
+    /**
+     * Duplicates this instance.
+     *
+     * @param {PlaneGraphics} [result] The object onto which to store the result.
+     * @returns {PlaneGraphics} The modified result parameter or a new instance if one was not provided.
+     */
+    PlaneGraphics.prototype.clone = function(result) {
+        if (!defined(result)) {
+            return new PlaneGraphics(this);
+        }
+        result.normal = this.normal;
+        result.distance = this.distance;
+        result.dimensions = this.dimensions;
+        result.show = this.show;
+        result.material = this.material;
+        result.fill = this.fill;
+        result.outline = this.outline;
+        result.outlineColor = this.outlineColor;
+        result.outlineWidth = this.outlineWidth;
+        result.shadows = this.shadows;
+        result.distanceDisplayCondition = this.distanceDisplayCondition;
+        return result;
+    };
+
+    /**
+     * Assigns each unassigned property on this object to the value
+     * of the same property on the provided source object.
+     *
+     * @param {PlaneGraphics} source The object to be merged into this object.
+     */
+    PlaneGraphics.prototype.merge = function(source) {
+        //>>includeStart('debug', pragmas.debug);
+        if (!defined(source)) {
+            throw new DeveloperError('source is required.');
+        }
+        //>>includeEnd('debug');
+
+        this.normal = defaultValue(this.normal, source.normal);
+        this.distance = defaultValue(this.distance, source.distance);
+        this.dimensions = defaultValue(this.dimensions, source.dimensions);
+        this.show = defaultValue(this.show, source.show);
+        this.material = defaultValue(this.material, source.material);
+        this.fill = defaultValue(this.fill, source.fill);
+        this.outline = defaultValue(this.outline, source.outline);
+        this.outlineColor = defaultValue(this.outlineColor, source.outlineColor);
+        this.outlineWidth = defaultValue(this.outlineWidth, source.outlineWidth);
+        this.shadows = defaultValue(this.shadows, source.shadows);
+        this.distanceDisplayCondition = defaultValue(this.distanceDisplayCondition, source.distanceDisplayCondition);
+    };
+
+    return PlaneGraphics;
+});
diff --git a/Source/Workers/createPlaneOutlineGeometry.js b/Source/Workers/createPlaneOutlineGeometry.js
new file mode 100644
index 000000000000..7f91ee8b6e9e
--- /dev/null
+++ b/Source/Workers/createPlaneOutlineGeometry.js
@@ -0,0 +1,15 @@
+define([
+    '../Core/PlaneOutlineGeometry',
+    '../Core/defined'
+], function(
+    PlaneOutlineGeometry,
+    defined) {
+    'use strict';
+
+    return function(planeGeometry, offset) {
+        if (defined(offset)) {
+            planeGeometry = PlaneOutlineGeometry.unpack(planeGeometry, offset);
+        }
+        return PlaneOutlineGeometry.createGeometry(planeGeometry);
+    };
+});

From 4dfea3a406c1631f9a8a62d5acbbb15a9682748e Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Thu, 9 Nov 2017 17:49:44 -0500
Subject: [PATCH 03/37] Cleanup

---
 Apps/Sandcastle/gallery/Clipping Planes.html | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/Apps/Sandcastle/gallery/Clipping Planes.html b/Apps/Sandcastle/gallery/Clipping Planes.html
index 8f993364ea75..5b407826b35c 100644
--- a/Apps/Sandcastle/gallery/Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/Clipping Planes.html	
@@ -70,7 +70,9 @@
 var downHandler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);
 downHandler.setInputAction(function(movement) {
     var pickedObject = scene.pick(movement.position);
-    if (Cesium.defined(pickedObject) && Cesium.defined(pickedObject.id.plane)) {
+    if (Cesium.defined(pickedObject) &&
+            Cesium.defined(pickedObject.id) &&
+            Cesium.defined(pickedObject.id.plane)) {
         selectedPlane = pickedObject.id.plane;
         selectedPlane.material = Cesium.Color.WHITE.withAlpha(0.05);
         selectedPlane.outlineColor = Cesium.Color.WHITE;
@@ -155,7 +157,7 @@
         tileset.debugShowBoundingVolume = newValue;
     }
 });
-    
+
 function reset() {
     viewer.entities.removeAll();
     viewer.scene.primitives.removeAll();
@@ -163,9 +165,6 @@
 
     if (Cesium.defined(viewModel)) {
         viewModel.clippingPlanesEnabled = true;
-        viewModel.xOffset = 0.0;
-        viewModel.yOffset = -100.0;
-        viewModel.zOffset = -100.0;
     }
 }
 

From ee8b97aabb791eac300e5cb6aa6f598c27e6867e Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 10 Nov 2017 13:19:48 -0500
Subject: [PATCH 04/37] Update sandcastle demo, colors and scenario

---
 Apps/Sandcastle/gallery/Clipping Planes.html | 11 +++++------
 Source/Scene/Model.js                        |  7 ++++++-
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/Apps/Sandcastle/gallery/Clipping Planes.html b/Apps/Sandcastle/gallery/Clipping Planes.html
index 5b407826b35c..cbd1716033a4 100644
--- a/Apps/Sandcastle/gallery/Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/Clipping Planes.html	
@@ -53,8 +53,6 @@
 
 var clippingPlanes;
 var defaultClippingPlanes = [
-    new Cesium.Plane(new Cesium.Cartesian3(1.0, 0.0, 0.0),    0.0),
-    new Cesium.Plane(new Cesium.Cartesian3(0.0, 1.0, 0.0), -100.0),
     new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0,-1.0), -100.0)
 ];
 
@@ -62,7 +60,7 @@
     debugBoundingVolumesEnabled: false
 };
 
-var targetX = 0.0;
+var targetY = 0.0;
 var planeEntities = [];
 var selectedPlane;
 
@@ -96,8 +94,9 @@
 var moveHandler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);
 moveHandler.setInputAction(function(movement) {
     if (Cesium.defined(selectedPlane)) {
-        var deltaX = movement.endPosition.x - movement.startPosition.x;
-        targetX += deltaX;
+        var deltaY = movement.endPosition.y - movement.startPosition.y;
+        var screenScale = scene.camera.getPixelSize(tileset.boundingSphere, scene.drawingBufferWidth, scene.drawingBufferHeight);
+        targetY += deltaY * screenScale;
     }
 }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
 
@@ -123,7 +122,7 @@
                     material : Cesium.Color.CYAN.withAlpha(0.1),
                     normal: plane.normal,
                     distance: new Cesium.CallbackProperty(function() {
-                        plane.distance = Cesium.Math.lerp(plane.distance, targetX, 0.1);
+                        plane.distance = Cesium.Math.lerp(plane.distance, targetY, 0.1);
                         return plane.distance;
                     }, false),
                     outline: true,
diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index dd6a2f99811f..bf8687cc4f21 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -3332,10 +3332,15 @@ define([
     }
 
     var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
-    function createClippingPlanesFunction(model, context) {
+    function createClippingPlanesFunction(model) {
         return function() {
             var planes = model.clippingPlanes;
             var packedPlanes = model._packedClippingPlanes;
+
+            if (!model.clippingPlanesEnabled) {
+                return packedPlanes;
+            }
+
             var length = packedPlanes.length;
             for (var i = 0; i < length; ++i) {
                 var plane = planes[i];

From 33eb86a61aec28f0e373c9e11e44c4eb585e7330 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Sun, 12 Nov 2017 15:32:46 -0500
Subject: [PATCH 05/37] Clipping planes on terrain

---
 Source/Scene/Globe.js                    | 13 +++++++
 Source/Scene/GlobeSurfaceShaderSet.js    |  9 ++++-
 Source/Scene/GlobeSurfaceTileProvider.js | 49 +++++++++++++++++++++++-
 Source/Shaders/GlobeFS.glsl              |  9 +++++
 4 files changed, 76 insertions(+), 4 deletions(-)

diff --git a/Source/Scene/Globe.js b/Source/Scene/Globe.js
index 8a351098c7b9..2c853c9e70f2 100644
--- a/Source/Scene/Globe.js
+++ b/Source/Scene/Globe.js
@@ -234,6 +234,19 @@ define([
                 this._surface.tileProvider.baseColor = value;
             }
         },
+        /**
+         * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+         *
+         * @type {Plane[]}
+         */
+        terrainClippingPlanes : {
+            get : function() {
+                return this._surface.tileProvider.clippingPlanes;
+            },
+            set : function(value) {
+                this._surface.tileProvider.clippingPlanes = value;
+            }
+        },
         /**
          * The terrain provider providing surface geometry for this globe.
          * @type {TerrainProvider}
diff --git a/Source/Scene/GlobeSurfaceShaderSet.js b/Source/Scene/GlobeSurfaceShaderSet.js
index 2442df1a5efb..a6f7068a8b61 100644
--- a/Source/Scene/GlobeSurfaceShaderSet.js
+++ b/Source/Scene/GlobeSurfaceShaderSet.js
@@ -61,7 +61,7 @@ define([
         return useWebMercatorProjection ? get2DYPositionFractionMercatorProjection : get2DYPositionFractionGeographicProjection;
     }
 
-    GlobeSurfaceShaderSet.prototype.getShaderProgram = function(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, enableLighting, hasVertexNormals, useWebMercatorProjection, enableFog) {
+    GlobeSurfaceShaderSet.prototype.getShaderProgram = function(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, enableLighting, hasVertexNormals, useWebMercatorProjection, enableFog, enableClippingPlanes) {
         var quantization = 0;
         var quantizationDefine = '';
 
@@ -87,7 +87,8 @@ define([
                     (useWebMercatorProjection << 12) |
                     (enableFog << 13) |
                     (quantization << 14) |
-                    (applySplit << 15);
+                    (applySplit << 15) |
+                    (enableClippingPlanes << 16);
 
         var surfaceShader = surfaceTile.surfaceShader;
         if (defined(surfaceShader) &&
@@ -160,6 +161,10 @@ define([
                 fs.defines.push('APPLY_SPLIT');
             }
 
+            if (enableClippingPlanes) {
+                fs.defines.push('ENABLE_CLIPPING_PLANES');
+            }
+
             var computeDayColor = '\
     vec4 computeDayColor(vec4 initialColor, vec3 textureCoordinates)\n\
     {\n\
diff --git a/Source/Scene/GlobeSurfaceTileProvider.js b/Source/Scene/GlobeSurfaceTileProvider.js
index 00c047e2b83d..2665bfc37ec9 100644
--- a/Source/Scene/GlobeSurfaceTileProvider.js
+++ b/Source/Scene/GlobeSurfaceTileProvider.js
@@ -20,6 +20,7 @@ define([
         '../Core/Matrix4',
         '../Core/OrientedBoundingBox',
         '../Core/OrthographicFrustum',
+        '../Core/Plane',
         '../Core/PrimitiveType',
         '../Core/Rectangle',
         '../Core/SphereOutlineGeometry',
@@ -64,6 +65,7 @@ define([
         Matrix4,
         OrientedBoundingBox,
         OrthographicFrustum,
+        Plane,
         PrimitiveType,
         Rectangle,
         SphereOutlineGeometry,
@@ -158,6 +160,13 @@ define([
         this._baseColor = undefined;
         this._firstPassInitialColor = undefined;
         this.baseColor = new Color(0.0, 0.0, 0.5, 1.0);
+
+        /**
+         * Gets or sets the array of clipping planes, defined in world space;
+         * Each clipping plane selectively disables rendering contents on the outside of the plane.
+         * @type {Plane[]}
+         */
+        this.clippingPlanes = undefined;
     }
 
     defineProperties(GlobeSurfaceTileProvider.prototype, {
@@ -849,6 +858,12 @@ define([
             u_dayTextureSplit : function() {
                 return this.properties.dayTextureSplit;
             },
+            u_clippingPlanesLength : function() {
+                return this.properties.clippingPlanes.length;
+            },
+            u_clippingPlanes : function() {
+                return this.properties.clippingPlanes;
+            },
 
             // make a separate object so that changes to the properties are seen on
             // derived commands that combine another uniform map with this one.
@@ -883,7 +898,8 @@ define([
                 waterMaskTranslationAndScale : new Cartesian4(),
 
                 minMaxHeight : new Cartesian2(),
-                scaleAndBias : new Matrix4()
+                scaleAndBias : new Matrix4(),
+                clippingPlanes : []
             }
         };
 
@@ -1006,6 +1022,7 @@ define([
     })();
 
     var otherPassesInitialColor = new Cartesian4(0.0, 0.0, 0.0, 0.0);
+    var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
 
     function addDrawCommandsForTile(tileProvider, tile, frameState) {
         var surfaceTile = tile.data;
@@ -1259,7 +1276,35 @@ define([
             uniformMapProperties.minMaxHeight.y = encoding.maximumHeight;
             Matrix4.clone(encoding.matrix, uniformMapProperties.scaleAndBias);
 
-            command.shaderProgram = tileProvider._surfaceShaderSet.getShaderProgram(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, tileProvider.enableLighting, hasVertexNormals, useWebMercatorProjection, applyFog);
+            // update clipping planes
+            var length = 0;
+            var clippingPlanes = tileProvider.clippingPlanes;
+            if (defined(clippingPlanes)) {
+                length = clippingPlanes.length;
+            }
+            if (length !== uniformMapProperties.clippingPlanes.length) {
+                uniformMapProperties.clippingPlanes = new Array(length);
+
+                for (var i = 0; i < length; ++i) {
+                    uniformMapProperties.clippingPlanes[i] = new Cartesian4();
+                }
+            }
+
+            var packedPlanes = uniformMapProperties.clippingPlanes;
+            for (var j = 0; j < length; ++j) {
+                var plane = clippingPlanes[j];
+                var packedPlane = packedPlanes[j];
+
+                Plane.transform(plane, context.uniformState.view, scratchPlane);
+
+                Cartesian3.clone(scratchPlane.normal, packedPlane);
+                packedPlane.w = scratchPlane.distance;
+            }
+
+            // TODO: Optimization, determine if this tile is entirely clipped or entirely visible
+            var clippingPlanesEnabled = (uniformMapProperties.clippingPlanes.length > 0);
+
+            command.shaderProgram = tileProvider._surfaceShaderSet.getShaderProgram(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, tileProvider.enableLighting, hasVertexNormals, useWebMercatorProjection, applyFog, clippingPlanesEnabled);
             command.castShadows = castShadows;
             command.receiveShadows = receiveShadows;
             command.renderState = renderState;
diff --git a/Source/Shaders/GlobeFS.glsl b/Source/Shaders/GlobeFS.glsl
index 34f8bc02c4ca..e1925a224f96 100644
--- a/Source/Shaders/GlobeFS.glsl
+++ b/Source/Shaders/GlobeFS.glsl
@@ -52,6 +52,11 @@ uniform sampler2D u_oceanNormalMap;
 uniform vec2 u_lightingFadeDistance;
 #endif
 
+#ifdef ENABLE_CLIPPING_PLANES
+uniform int u_clippingPlanesLength;
+uniform vec4 u_clippingPlanes[czm_maxClippingPlanes];
+#endif
+
 varying vec3 v_positionMC;
 varying vec3 v_positionEC;
 varying vec3 v_textureCoordinates;
@@ -141,6 +146,10 @@ vec4 computeWaterColor(vec3 positionEyeCoordinates, vec2 textureCoordinates, mat
 
 void main()
 {
+#ifdef ENABLE_CLIPPING_PLANES
+    czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength);
+#endif
+
     // The clamp below works around an apparent bug in Chrome Canary v23.0.1241.0
     // where the fragment shader sees textures coordinates < 0.0 and > 1.0 for the
     // fragments on the edges of tiles even though the vertex shader is outputting

From 951a33bb2182b6079a59903a5ca4462b7d2b1531 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 13 Nov 2017 09:35:41 -0500
Subject: [PATCH 06/37] Modified shaders to highlight clipping edge

---
 Source/Scene/Model.js                               |  3 ++-
 .../Shaders/Builtin/Functions/discardIfClipped.glsl | 13 +++++++++++--
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index bf8687cc4f21..d37a32ba80ff 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -4256,7 +4256,8 @@ define([
             '{ \n' +
             '    gltf_clip_main(); \n' +
             '    if (gltf_clippingPlanesEnabled) { \n' +
-            '        czm_discardIfClipped(gltf_clippingPlanes, gltf_clippingPlanesLength); \n' +
+            '        float amount = czm_discardIfClipped(gltf_clippingPlanes, gltf_clippingPlanesLength); \n' +
+            '        if (amount > 0.0 && amount < 1.0) gl_FragColor = vec4(1.0); \n' +
             '    } \n' +
             '} \n';
 
diff --git a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
index 0a59ae5f7e64..04b60f9a1ef7 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
@@ -7,7 +7,7 @@
  * @param {vec4[]} clippingPlanes The array of planes used to clip, defined in eyespace.
  * @param {int} clippingPlanesLength The number of planes in the array of clipping planes.
  */
-void czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength)
+float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength)
 {
     if (clippingPlanesLength > 0)
     {
@@ -15,6 +15,7 @@ void czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clipp
         vec4 position = czm_windowToEyeCoordinates(gl_FragCoord);
         vec3 clipNormal = vec3(0.0);
         vec3 clipPosition = vec3(0.0);
+        float clipAmount = 100.0;
 
         for (int i = 0; i < czm_maxClippingPlanes; ++i)
         {
@@ -25,12 +26,20 @@ void czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clipp
 
             clipNormal = clippingPlanes[i].xyz;
             clipPosition = -clippingPlanes[i].w * clipNormal;
-            clipped = dot(clipNormal, (position.xyz - clipPosition)) <= 0.0;
+            float amount = dot(clipNormal, (position.xyz - clipPosition));
+            clipped = (amount <= 0.0);
+            if (abs(amount) < clipAmount) {
+                clipAmount = abs(amount);
+            }
+
         }
 
         if (clipped)
         {
             discard;
+            return 0.0;
         }
+
+        return clipAmount;
     }
 }

From 8981779ec93aeea7ff4c05274ebf78c4672946ac Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 13 Nov 2017 10:21:09 -0500
Subject: [PATCH 07/37] Add demo

---
 Apps/Sandcastle/gallery/Terrain Clipping.html | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 Apps/Sandcastle/gallery/Terrain Clipping.html

diff --git a/Apps/Sandcastle/gallery/Terrain Clipping.html b/Apps/Sandcastle/gallery/Terrain Clipping.html
new file mode 100644
index 000000000000..00270f2cc6d2
--- /dev/null
+++ b/Apps/Sandcastle/gallery/Terrain Clipping.html	
@@ -0,0 +1,61 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no">
+    <meta name="description" content="Clipping planes on terrain.">
+    <meta name="cesium-sandcastle-labels" content="Beginner, Showcases">
+    <title>Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script type="text/javascript" src="../../../ThirdParty/requirejs-2.1.20/require.js"></script>
+    <script type="text/javascript">
+    require.config({
+        baseUrl : '../../../Source',
+        waitSeconds : 60
+    });
+    </script>
+</head>
+<body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+<style>
+    @import url(../templates/bucket.css);
+</style>
+<div id="cesiumContainer" class="fullSize"></div>
+<div id="loadingOverlay"><h1>Loading...</h1></div>
+<div id="toolbar"></div>
+<script id="cesium_sandcastle_script">
+function startup(Cesium) {
+    'use strict';
+//Sandcastle_Begin
+var viewer = new Cesium.Viewer('cesiumContainer', {
+    terrainExaggeration : 3.0
+});
+
+var cesiumTerrainProviderMeshes = new Cesium.CesiumTerrainProvider({
+    url : 'https://assets.agi.com/stk-terrain/v1/tilesets/world/tiles',
+    requestWaterMask : true,
+    requestVertexNormals : true
+});
+viewer.terrainProvider = cesiumTerrainProviderMeshes;
+
+var globe = viewer.scene.globe;
+
+var planes = globe.terrainClippingPlanes = [
+    new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 1000000.0)
+];
+
+window.setInterval(function () {
+    planes[0].distance -= 5.0;
+}, 30);
+
+//Sandcastle_End
+    Sandcastle.finishedLoading();
+}
+if (typeof Cesium !== "undefined") {
+    startup(Cesium);
+} else if (typeof require === "function") {
+    require(["Cesium"], startup);
+}
+</script>
+</body>
+</html>

From c0ec2c4b6859663688d04e8ca90693ccee21c15e Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 13 Nov 2017 13:07:01 -0500
Subject: [PATCH 08/37] Add highlighting to terrain edges

---
 Source/Scene/Model.js       | 5 ++++-
 Source/Shaders/GlobeFS.glsl | 7 ++++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index d37a32ba80ff..dd5312cbab42 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -4246,6 +4246,9 @@ define([
         }
     }
 
+    var edgeColor = 'vec4(1.0)';
+    var edgeWidth = '0.7';
+
     function modifyShaderForClippingPlanes(shader) {
         shader = ShaderSource.replaceMain(shader, 'gltf_clip_main');
         shader +=
@@ -4257,7 +4260,7 @@ define([
             '    gltf_clip_main(); \n' +
             '    if (gltf_clippingPlanesEnabled) { \n' +
             '        float amount = czm_discardIfClipped(gltf_clippingPlanes, gltf_clippingPlanesLength); \n' +
-            '        if (amount > 0.0 && amount < 1.0) gl_FragColor = vec4(1.0); \n' +
+            '        if (amount > 0.0 && amount < '+ edgeWidth + ') gl_FragColor = ' + edgeColor + '; \n' +
             '    } \n' +
             '} \n';
 
diff --git a/Source/Shaders/GlobeFS.glsl b/Source/Shaders/GlobeFS.glsl
index e1925a224f96..1d6be70cd4b1 100644
--- a/Source/Shaders/GlobeFS.glsl
+++ b/Source/Shaders/GlobeFS.glsl
@@ -147,7 +147,7 @@ vec4 computeWaterColor(vec3 positionEyeCoordinates, vec2 textureCoordinates, mat
 void main()
 {
 #ifdef ENABLE_CLIPPING_PLANES
-    czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength);
+    float clippingEdgeAmount = czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength);
 #endif
 
     // The clamp below works around an apparent bug in Chrome Canary v23.0.1241.0
@@ -204,6 +204,11 @@ void main()
     vec4 finalColor = color;
 #endif
 
+#ifdef ENABLE_CLIPPING_PLANES
+    if (clippingEdgeAmount > 0.0 && clippingEdgeAmount < 0.5) { // Edge width
+        finalColor = vec4(1.0); // Edgecolor
+    }
+#endif
 
 #ifdef FOG
     const float fExposure = 2.0;

From 5ec1058cb5df71f7d6850e55765c725e17d939c9 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Tue, 14 Nov 2017 13:15:01 -0500
Subject: [PATCH 09/37] Multiple clipping planes && together, define terrain
 clipping plane origin

---
 Apps/Sandcastle/gallery/Terrain Clipping.html       |  8 +++++---
 Source/Scene/Globe.js                               | 13 +++++++++++++
 Source/Scene/GlobeSurfaceTileProvider.js            |  6 +++++-
 .../Shaders/Builtin/Functions/discardIfClipped.glsl |  6 +++---
 4 files changed, 26 insertions(+), 7 deletions(-)

diff --git a/Apps/Sandcastle/gallery/Terrain Clipping.html b/Apps/Sandcastle/gallery/Terrain Clipping.html
index 00270f2cc6d2..4d330677d4cf 100644
--- a/Apps/Sandcastle/gallery/Terrain Clipping.html	
+++ b/Apps/Sandcastle/gallery/Terrain Clipping.html	
@@ -39,13 +39,15 @@
 viewer.terrainProvider = cesiumTerrainProviderMeshes;
 
 var globe = viewer.scene.globe;
-
+globe.terrainClippingPlanesOrigin = new Cesium.Cartesian3(0.0, 0.0, 3000000.0); // Defines the "center" from which the planes' normals and offsets will orginate
 var planes = globe.terrainClippingPlanes = [
-    new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 1000000.0)
+    new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 0.0),
+    new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, 1.0), 100000.0)
 ];
 
 window.setInterval(function () {
-    planes[0].distance -= 5.0;
+    planes[0].distance -= 50.0;
+    planes[1].distance += 50.0;
 }, 30);
 
 //Sandcastle_End
diff --git a/Source/Scene/Globe.js b/Source/Scene/Globe.js
index 2c853c9e70f2..51dfa8c6c273 100644
--- a/Source/Scene/Globe.js
+++ b/Source/Scene/Globe.js
@@ -234,6 +234,19 @@ define([
                 this._surface.tileProvider.baseColor = value;
             }
         },
+        /**
+         * A property specifying the reference location that each clipping plane treats as the origin.
+         *
+         * @type {Cartesian3}
+         */
+        terrainClippingPlanesOrigin : {
+            get : function() {
+                return this._surface.tileProvider.clippingPlanesOrigin;
+            },
+            set : function(value) {
+                this._surface.tileProvider.clippingPlanesOrigin = value;
+            }
+        },
         /**
          * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
          *
diff --git a/Source/Scene/GlobeSurfaceTileProvider.js b/Source/Scene/GlobeSurfaceTileProvider.js
index 2665bfc37ec9..c73c59899db1 100644
--- a/Source/Scene/GlobeSurfaceTileProvider.js
+++ b/Source/Scene/GlobeSurfaceTileProvider.js
@@ -167,6 +167,7 @@ define([
          * @type {Plane[]}
          */
         this.clippingPlanes = undefined;
+        this.clippingPlanesOrigin = new Cartesian3();
     }
 
     defineProperties(GlobeSurfaceTileProvider.prototype, {
@@ -1023,6 +1024,7 @@ define([
 
     var otherPassesInitialColor = new Cartesian4(0.0, 0.0, 0.0, 0.0);
     var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
+    var scratchMatrix = new Matrix4();
 
     function addDrawCommandsForTile(tileProvider, tile, frameState) {
         var surfaceTile = tile.data;
@@ -1291,11 +1293,13 @@ define([
             }
 
             var packedPlanes = uniformMapProperties.clippingPlanes;
+            var origin = Matrix4.fromTranslation(tileProvider.clippingPlanesOrigin, scratchMatrix);
+            var transform = Matrix4.multiply(context.uniformState.view, origin, scratchMatrix);
             for (var j = 0; j < length; ++j) {
                 var plane = clippingPlanes[j];
                 var packedPlane = packedPlanes[j];
 
-                Plane.transform(plane, context.uniformState.view, scratchPlane);
+                Plane.transform(plane, transform, scratchPlane);
 
                 Cartesian3.clone(scratchPlane.normal, packedPlane);
                 packedPlane.w = scratchPlane.distance;
diff --git a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
index 0a59ae5f7e64..3ba6bb00c9fa 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
@@ -11,21 +11,21 @@ void czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clipp
 {
     if (clippingPlanesLength > 0)
     {
-        bool clipped = false;
+        bool clipped = true;
         vec4 position = czm_windowToEyeCoordinates(gl_FragCoord);
         vec3 clipNormal = vec3(0.0);
         vec3 clipPosition = vec3(0.0);
 
         for (int i = 0; i < czm_maxClippingPlanes; ++i)
         {
-            if (i == clippingPlanesLength || clipped)
+            if (i == clippingPlanesLength)
             {
                 break;
             }
 
             clipNormal = clippingPlanes[i].xyz;
             clipPosition = -clippingPlanes[i].w * clipNormal;
-            clipped = dot(clipNormal, (position.xyz - clipPosition)) <= 0.0;
+            clipped = clipped && (dot(clipNormal, (position.xyz - clipPosition)) <= 0.0);
         }
 
         if (clipped)

From 443f73a8a60e3eb921902985bb8eb0d6d53c0c2e Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 17 Nov 2017 10:15:02 -0500
Subject: [PATCH 10/37] Add ClippingPlaneCollection

---
 Apps/Sandcastle/gallery/Clipping Planes.html  |  28 ++--
 Apps/Sandcastle/gallery/Terrain Clipping.html |  13 +-
 Source/DataSources/ModelGraphics.js           |   2 +-
 Source/Scene/Batched3DModel3DTileContent.js   |  12 +-
 Source/Scene/Cesium3DTile.js                  |   5 +-
 Source/Scene/Cesium3DTileset.js               |  14 +-
 Source/Scene/ClippingPlanesCollection.js      | 141 ++++++++++++++++++
 Source/Scene/Globe.js                         |  15 +-
 Source/Scene/GlobeSurfaceTileProvider.js      |  38 +++--
 Source/Scene/Model.js                         |  89 ++++++-----
 .../Builtin/Functions/discardIfClipped.glsl   |  18 ++-
 Source/Shaders/GlobeFS.glsl                   |   9 +-
 12 files changed, 274 insertions(+), 110 deletions(-)
 create mode 100644 Source/Scene/ClippingPlanesCollection.js

diff --git a/Apps/Sandcastle/gallery/Clipping Planes.html b/Apps/Sandcastle/gallery/Clipping Planes.html
index cbd1716033a4..5ca87ed1957f 100644
--- a/Apps/Sandcastle/gallery/Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/Clipping Planes.html	
@@ -51,7 +51,6 @@
 
 var planeScale = new Cesium.Cartesian2(300.0, 300.0);
 
-var clippingPlanes;
 var defaultClippingPlanes = [
     new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0,-1.0), -100.0)
 ];
@@ -100,12 +99,24 @@
     }
 }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
 
+function createPlaneUpdateFunction(plane) {
+    return function () {
+        plane.distance = Cesium.Math.lerp(plane.distance, targetY, 0.1);
+        return plane.distance;
+    };
+}
+
 var tileset;
 function loadTileset(url) {
     reset();
 
     tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
-        url : url
+        url : url,
+        clippingPlanes : new Cesium.ClippingPlanesCollection({
+            planes : defaultClippingPlanes,
+            edgeWidth: 10.0,
+            edgeColor: Cesium.Color.CYAN
+        })
     }));
 
     tileset.readyPromise.then(function() {
@@ -114,17 +125,14 @@
         viewer.camera.lookAtTransform(Cesium.Matrix4.IDENTITY);
 
         for (var i = 0; i < 1; ++i) {
-            var plane = clippingPlanes[i];
+            var plane = tileset.clippingPlanes.planes[i];
             var entity = viewer.entities.add({
                 position : boundingSphere.center,
                 plane : {
                     dimensions : planeScale,
                     material : Cesium.Color.CYAN.withAlpha(0.1),
                     normal: plane.normal,
-                    distance: new Cesium.CallbackProperty(function() {
-                        plane.distance = Cesium.Math.lerp(plane.distance, targetY, 0.1);
-                        return plane.distance;
-                    }, false),
+                    distance: new Cesium.CallbackProperty(createPlaneUpdateFunction(plane), false),
                     outline: true,
                     outlineColor: Cesium.Color.CYAN
                 }
@@ -137,8 +145,6 @@
     });
 
     tileset.debugShowBoundingVolume = viewModel.debugBoundingVolumesEnabled;
-    tileset.clippingPlanesEnabled = viewModel.clippingPlanesEnabled;
-    clippingPlanes = tileset.clippingPlanes = defaultClippingPlanes.slice();
 }
 
 // Power Plant design model provided by Bentley Systems
@@ -161,10 +167,6 @@
     viewer.entities.removeAll();
     viewer.scene.primitives.removeAll();
     planeEntities = [];
-
-    if (Cesium.defined(viewModel)) {
-        viewModel.clippingPlanesEnabled = true;
-    }
 }
 
 //Sandcastle_End
diff --git a/Apps/Sandcastle/gallery/Terrain Clipping.html b/Apps/Sandcastle/gallery/Terrain Clipping.html
index 4d330677d4cf..ed2a15cd94ac 100644
--- a/Apps/Sandcastle/gallery/Terrain Clipping.html	
+++ b/Apps/Sandcastle/gallery/Terrain Clipping.html	
@@ -39,12 +39,15 @@
 viewer.terrainProvider = cesiumTerrainProviderMeshes;
 
 var globe = viewer.scene.globe;
-globe.terrainClippingPlanesOrigin = new Cesium.Cartesian3(0.0, 0.0, 3000000.0); // Defines the "center" from which the planes' normals and offsets will orginate
-var planes = globe.terrainClippingPlanes = [
-    new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 0.0),
-    new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, 1.0), 100000.0)
-];
+globe.terrainClippingPlanes = new Cesium.ClippingPlanesCollection({
+    transformationMatrix : Cesium.Matrix4.fromTranslation(new Cesium.Cartesian3(0.0, 0.0, 3000000.0)),
+    planes : [
+        new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 0.0),
+        new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, 1.0), 100000.0)
+    ]
+});
 
+var planes = globe.terrainClippingPlanes.planes;
 window.setInterval(function () {
     planes[0].distance -= 50.0;
     planes[1].distance += 50.0;
diff --git a/Source/DataSources/ModelGraphics.js b/Source/DataSources/ModelGraphics.js
index 566b1249dc2e..90af4ab0a59a 100644
--- a/Source/DataSources/ModelGraphics.js
+++ b/Source/DataSources/ModelGraphics.js
@@ -54,7 +54,7 @@ define([
      * @param {Property} [options.color=Color.WHITE] A Property specifying the {@link Color} that blends with the model's rendered color.
      * @param {Property} [options.colorBlendMode=ColorBlendMode.HIGHLIGHT] An enum Property specifying how the color blends with the model.
      * @param {Property} [options.colorBlendAmount=0.5] A numeric Property specifying the color strength when the <code>colorBlendMode</code> is <code>MIX</code>. A value of 0.0 results in the model's rendered color while a value of 1.0 results in a solid color, with any value in-between resulting in a mix of the two.
-     * @param {Property} [options.clippingPlanes=[]] A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+     * @param {Property} [options.clippingPlanes] A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
      *
      * @see {@link http://cesiumjs.org/2014/03/03/Cesium-3D-Models-Tutorial/|3D Models Tutorial}
      * @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=3D%20Models.html|Cesium Sandcastle 3D Models Demo}
diff --git a/Source/Scene/Batched3DModel3DTileContent.js b/Source/Scene/Batched3DModel3DTileContent.js
index 95ce75a3ab86..86bed8370b29 100644
--- a/Source/Scene/Batched3DModel3DTileContent.js
+++ b/Source/Scene/Batched3DModel3DTileContent.js
@@ -378,8 +378,7 @@ define([
             pickUniformMapLoaded : batchTable.getPickUniformMapCallback(),
             addBatchIdToGeneratedShaders : (batchLength > 0), // If the batch table has values in it, generated shaders will need a batchId attribute
             pickObject : pickObject,
-            clippingPlanes : tileset.clippingPlanes,
-            clippingPlanesEnabled : tileset.clippingPlanesEnabled && tile._isClipped
+            clippingPlanes : tileset.clippingPlanes
         });
     }
 
@@ -449,8 +448,13 @@ define([
         this._model.modelMatrix = this._tile.computedTransform;
         this._model.shadows = this._tileset.shadows;
         this._model.debugWireframe = this._tileset.debugWireframe;
-        this._model.clippingPlanes = this._tileset.clippingPlanes;
-        this._model.clippingPlanesEnabled = this._tileset.clippingPlanesEnabled && this._tile._isClipped;
+
+        // Update clipping planes
+        var modelClippingPlanes = this._model.clippingPlanes.planes;
+        var tilesetClippingPlanes = this._tileset.clippingPlanes;
+        tilesetClippingPlanes.clone(modelClippingPlanes);
+        modelClippingPlanes.enabled = tilesetClippingPlanes.enabled && this._tile._isClipped;
+
         this._model.update(frameState);
 
         // If any commands were pushed, add derived commands
diff --git a/Source/Scene/Cesium3DTile.js b/Source/Scene/Cesium3DTile.js
index a09d67affac0..dfe40de97a62 100644
--- a/Source/Scene/Cesium3DTile.js
+++ b/Source/Scene/Cesium3DTile.js
@@ -743,8 +743,9 @@ define([
 
     var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
     function checkTileClipped(tile, boundingVolume) {
-        var planes = tile._tileset.clippingPlanes;
-        if (defined(planes)) {
+        var clippingPlanes = tile._tileset.clippingPlanes;
+        if (defined(clippingPlanes)) {
+            var planes = clippingPlanes.planes;
             var length = planes.length;
             var rootTransform = tile._tileset._root.computedTransform;
             for (var i = 0; i < length; ++i) {
diff --git a/Source/Scene/Cesium3DTileset.js b/Source/Scene/Cesium3DTileset.js
index f5ffbe16cfa4..3194f7463051 100644
--- a/Source/Scene/Cesium3DTileset.js
+++ b/Source/Scene/Cesium3DTileset.js
@@ -105,8 +105,7 @@ define([
      * @param {Number} [options.skipLevels=1] When <code>skipLevelOfDetail</code> is <code>true</code>, a constant defining the minimum number of levels to skip when loading tiles. When it is 0, no levels are skipped. Used in conjunction with <code>skipScreenSpaceErrorFactor</code> to determine which tiles to load.
      * @param {Boolean} [options.immediatelyLoadDesiredLevelOfDetail=false] When <code>skipLevelOfDetail</code> is <code>true</code>, only tiles that meet the maximum screen space error will ever be downloaded. Skipping factors are ignored and just the desired tiles are loaded.
      * @param {Boolean} [options.loadSiblings=false] When <code>skipLevelOfDetail</code> is <code>true</code>, determines whether siblings of visible tiles are always downloaded during traversal.
-     * @param {Plane[]} [options.clippingPlanes] A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
-     * @param [Boolean} [options.clippingPlanesEnabled=true] Optimization option. If set to false, the tileset will not perform clipping operations.
+     * @param {ClippingPlaneCollection} [options.clippingPlanes] A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
      * @param {Boolean} [options.debugFreezeFrame=false] For debugging only. Determines if only the tiles from last frame should be used for rendering.
      * @param {Boolean} [options.debugColorizeTiles=false] For debugging only. When true, assigns a random color to each tile.
      * @param {Boolean} [options.debugWireframe=false] For debugging only. When true, render's each tile's content as a wireframe.
@@ -527,19 +526,10 @@ define([
         /**
          * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
          *
-         * @type {Plane[]}
+         * @type {ClippingPlanesCollection}
          */
         this.clippingPlanes = options.clippingPlanes;
 
-        /**
-         * Optimization option. If set to false, the tileset will not perform clipping operations.
-         *
-         * @type {Boolean}
-         * @default {undefined}
-         * @see Cesium3DTileset.clippingPlanes
-         */
-        this.clippingPlanesEnabled = defaultValue(options.clippingPlanesEnabled, true);
-
         /**
          * This property is for debugging only; it is not optimized for production use.
          * <p>
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
new file mode 100644
index 000000000000..8e7b954809a7
--- /dev/null
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -0,0 +1,141 @@
+define([
+    '../Core/BoundingSphere',
+    '../Core/buildModuleUrl',
+    '../Core/Cartesian3',
+    '../Core/Cartographic',
+    '../Core/Color',
+    '../Core/defaultValue',
+    '../Core/defined',
+    '../Core/Matrix4',
+    '../Core/Plane'
+], function(
+    BoundingSphere,
+    buildModuleUrl,
+    Cartesian3,
+    Cartographic,
+    Color,
+    defaultValue,
+    defined,
+    Matrix4,
+    Plane) {
+    'use strict';
+
+    /**
+     * The globe rendered in the scene, including its terrain ({@link ClippingPlanesCollection#terrainProvider})
+     * and imagery layers ({@link ClippingPlanesCollection#imageryLayers}).  Access the globe using {@link Scene#globe}.
+     *
+     * @alias ClippingPlanesCollection
+     * @constructor
+     *
+     * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] Determines the size and shape of the
+     * globe.
+     */
+    function ClippingPlanesCollection(options) {
+        var options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+
+        /**
+         * An array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+         *
+         * @type {Plane}
+         * @default []
+         */
+        this.planes = defaultValue(options.planes, []); // TODO don't instantiate?
+
+        /**
+         * Determines whether the clipping planes are active.
+         *
+         * @type {Boolean}
+         * @default true
+         */
+        this.enabled = defaultValue(options.enabled, true);
+
+        /**
+         * A transformation matrix specifying the coordinate system for this collection.
+         *
+         * @type {Matrix4}
+         * @default Matrix4.IDENTITY
+         */
+        this.transformationMatrix = defaultValue(options.transformationMatrix, Matrix4.IDENTITY);
+
+        /**
+         * If true, the region to be clipped must be included in all planes in this collection.
+         * Otherwise, a region will be clipped if included in any plane in the collection.
+         *
+         * @type {Boolean}
+         * @default true
+         */
+        this.inclusive = defaultValue(options.inclusive, true);
+
+        /**
+         * The color of the highlighted clipped edge.
+         *
+         * @type {Color}
+         * @default Color.WHITE
+         */
+        this.edgeColor = defaultValue(options.edgeColor, Color.WHITE);
+
+        /**
+         * The width of the clipped edge to highlight.
+         *
+         * @type {Number}
+         * @default 0.0
+         */
+        this.edgeWidth = defaultValue(options.edgeWidth, 0.0);
+
+    }
+
+    var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
+    var scratchMatrix = new Matrix4();
+    /**
+     * Applies the transformations to each plane and packs it into an array.
+     *
+     * @param viewMatrix
+     * @param [array]
+     * @returns {Cartesian4[]} The array of packed planes.
+     */
+    ClippingPlanesCollection.prototype.transformAndPackPlanes = function (viewMatrix, array) {
+        var planes = this.planes;
+        var length = planes.length;
+
+        if (!defined(array)) {
+            array = new Array(length);
+        }
+
+        var transform = Matrix4.multiply(viewMatrix, this.transformationMatrix, scratchMatrix);
+
+        for (var j = 0; j < length; ++j) {
+            var plane = planes[j];
+            var packedPlane = array[j];
+
+            Plane.transform(plane, transform, scratchPlane);
+
+            Cartesian3.clone(scratchPlane.normal, packedPlane);
+            packedPlane.w = scratchPlane.distance;
+        }
+
+        return array;
+    };
+
+    /**
+     * Duplicates this ClippingPlanesCollection instance.
+     *
+     * @param {ClippingPlanesCollection} [result] The object onto which to store the result.
+     * @returns he modified result parameter or a new ClippingPlanesCollection instance if one was not provided.
+     */
+    ClippingPlanesCollection.prototype.clone = function (result) {
+        if (!defined(result)) {
+            result = new ClippingPlanesCollection();
+        }
+
+        result.planes = Array.from(this.planes);
+        result.enabled = this.enabled;
+        Matrix4.clone(this.transformationMatrix, result.transformationMatrix);
+        result.inclusive = this.inclusive;
+        Color.clone(this.edgeColor, result.edgeColor);
+        result.edgeWidth = this.edgeWidth;
+
+        return result;
+    };
+
+    return ClippingPlanesCollection;
+});
diff --git a/Source/Scene/Globe.js b/Source/Scene/Globe.js
index 51dfa8c6c273..41f6b6e5b17e 100644
--- a/Source/Scene/Globe.js
+++ b/Source/Scene/Globe.js
@@ -234,23 +234,10 @@ define([
                 this._surface.tileProvider.baseColor = value;
             }
         },
-        /**
-         * A property specifying the reference location that each clipping plane treats as the origin.
-         *
-         * @type {Cartesian3}
-         */
-        terrainClippingPlanesOrigin : {
-            get : function() {
-                return this._surface.tileProvider.clippingPlanesOrigin;
-            },
-            set : function(value) {
-                this._surface.tileProvider.clippingPlanesOrigin = value;
-            }
-        },
         /**
          * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
          *
-         * @type {Plane[]}
+         * @type {ClippingPlaneCollection}
          */
         terrainClippingPlanes : {
             get : function() {
diff --git a/Source/Scene/GlobeSurfaceTileProvider.js b/Source/Scene/GlobeSurfaceTileProvider.js
index c73c59899db1..009c4f61a769 100644
--- a/Source/Scene/GlobeSurfaceTileProvider.js
+++ b/Source/Scene/GlobeSurfaceTileProvider.js
@@ -164,10 +164,9 @@ define([
         /**
          * Gets or sets the array of clipping planes, defined in world space;
          * Each clipping plane selectively disables rendering contents on the outside of the plane.
-         * @type {Plane[]}
+         * @type {ClippingPlanesCollection}
          */
         this.clippingPlanes = undefined;
-        this.clippingPlanesOrigin = new Cartesian3();
     }
 
     defineProperties(GlobeSurfaceTileProvider.prototype, {
@@ -865,6 +864,15 @@ define([
             u_clippingPlanes : function() {
                 return this.properties.clippingPlanes;
             },
+            u_clippingPlanesInclusive : function() {
+                return this.properties.clippingPlanesInclusive;
+            },
+            u_clippingPlanesEdgeColor : function() {
+                return this.properties.clippingPlanesEdgeColor;
+            },
+            u_clippingPlanesEdgeWidth : function() {
+                return this.properties.clippingPlanesEdgeWidth;
+            },
 
             // make a separate object so that changes to the properties are seen on
             // derived commands that combine another uniform map with this one.
@@ -900,7 +908,10 @@ define([
 
                 minMaxHeight : new Cartesian2(),
                 scaleAndBias : new Matrix4(),
-                clippingPlanes : []
+                clippingPlanes : [],
+                clippingPlanesInclusive : true,
+                clippingPlanesEdgeColor : new Cartesian4(1.0, 1.0, 1.0, 1.0),
+                clippingPlanesEdgeWidth : 0.0
             }
         };
 
@@ -1281,8 +1292,9 @@ define([
             // update clipping planes
             var length = 0;
             var clippingPlanes = tileProvider.clippingPlanes;
+
             if (defined(clippingPlanes)) {
-                length = clippingPlanes.length;
+                length = clippingPlanes.planes.length;
             }
             if (length !== uniformMapProperties.clippingPlanes.length) {
                 uniformMapProperties.clippingPlanes = new Array(length);
@@ -1292,21 +1304,15 @@ define([
                 }
             }
 
-            var packedPlanes = uniformMapProperties.clippingPlanes;
-            var origin = Matrix4.fromTranslation(tileProvider.clippingPlanesOrigin, scratchMatrix);
-            var transform = Matrix4.multiply(context.uniformState.view, origin, scratchMatrix);
-            for (var j = 0; j < length; ++j) {
-                var plane = clippingPlanes[j];
-                var packedPlane = packedPlanes[j];
-
-                Plane.transform(plane, transform, scratchPlane);
-
-                Cartesian3.clone(scratchPlane.normal, packedPlane);
-                packedPlane.w = scratchPlane.distance;
+            if (defined(clippingPlanes) && clippingPlanes.enabled) {
+                clippingPlanes.transformAndPackPlanes(context.uniformState.view, uniformMapProperties.clippingPlanes);
+                uniformMapProperties.clippingPlanesInclusive = clippingPlanes.inclusive;
+                uniformMapProperties.clippingPlanesEdgeColor = Cartesian4.fromColor(clippingPlanes.edgeColor, uniformMapProperties.clippingPlanesEdgeColor);
+                uniformMapProperties.clippingPlanesEdgeWidth = clippingPlanes.edgeWidth;
             }
 
             // TODO: Optimization, determine if this tile is entirely clipped or entirely visible
-            var clippingPlanesEnabled = (uniformMapProperties.clippingPlanes.length > 0);
+            var clippingPlanesEnabled = defined(clippingPlanes) && clippingPlanes.enabled && (uniformMapProperties.clippingPlanes.length > 0);
 
             command.shaderProgram = tileProvider._surfaceShaderSet.getShaderProgram(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, tileProvider.enableLighting, hasVertexNormals, useWebMercatorProjection, applyFog, clippingPlanesEnabled);
             command.castShadows = castShadows;
diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index dd5312cbab42..84038881c48e 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -341,8 +341,7 @@ define([
      * @param {Number} [options.colorBlendAmount=0.5] Value used to determine the color strength when the <code>colorBlendMode</code> is <code>MIX</code>. A value of 0.0 results in the model's rendered color while a value of 1.0 results in a solid color, with any value in-between resulting in a mix of the two.
      * @param {Color} [options.silhouetteColor=Color.RED] The silhouette color. If more than 256 models have silhouettes enabled, there is a small chance that overlapping models will have minor artifacts.
      * @param {Number} [options.silhouetteSize=0.0] The size of the silhouette in pixels.
-     * @param {Plane[]} [options.clippingPlanes=[]] An array of {@link Plane} used to clip the model.
-     * @param {Boolean} [options.clippingPlanesEnabled=true] Optimization option. If set to false, the model will not perform clipping operations.
+     * @param {ClippingPlanesCollection} [options.clippingPlanes] An array of {@link Plane} used to clip the model.
      *
      * @exception {DeveloperError} bgltf is not a valid Binary glTF file.
      * @exception {DeveloperError} Only glTF Binary version 1 is supported.
@@ -583,21 +582,10 @@ define([
         /**
          * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
          *
-         * @type {Plane[]}
+         * @type {ClippingPlanesCollection}
          */
         this.clippingPlanes = options.clippingPlanes;
 
-        /**
-         * Optimization option. If set to false, the model will not perform clipping operations.
-         *
-         * @see Model.clippingPlanes
-         *
-         * @type {Boolean}
-         *
-         * @default false
-         */
-        this.clippingPlanesEnabled = defaultValue(options.clippingPlanesEnabled, true);
-
         /**
          * This property is for debugging only; it is not for production use nor is it optimized.
          * <p>
@@ -3321,7 +3309,12 @@ define([
 
     function createClippingPlanesEnabledFunction(model) {
         return function() {
-            return model.clippingPlanesEnabled;
+            var clippingPlanes = model.clippingPlanes;
+            if (!defined(clippingPlanes)) {
+                return false;
+            }
+
+            return clippingPlanes.enabled;
         };
     }
 
@@ -3331,27 +3324,47 @@ define([
         };
     }
 
-    var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
     function createClippingPlanesFunction(model) {
         return function() {
-            var planes = model.clippingPlanes;
+            var clippingPlanes = model.clippingPlanes;
             var packedPlanes = model._packedClippingPlanes;
 
-            if (!model.clippingPlanesEnabled) {
-                return packedPlanes;
+            if (defined(clippingPlanes) && clippingPlanes.enabled) {
+                clippingPlanes.transformAndPackPlanes(model._modelViewMatrix, packedPlanes);
             }
 
-            var length = packedPlanes.length;
-            for (var i = 0; i < length; ++i) {
-                var plane = planes[i];
-                var packedPlane = packedPlanes[i];
+            return packedPlanes;
+        };
+    }
+
+    function createClippingPlanesInclusiveFunction(model) {
+        return function() {
+            if (!defined(model.clippingPlanes)) {
+                return true;
+            }
 
-                Plane.transform(plane, model._modelViewMatrix, scratchPlane);
+            return model.clippingPlanes.inclusive;
+        };
+    }
 
-                Cartesian3.clone(scratchPlane.normal, packedPlane);
-                packedPlane.w = scratchPlane.distance;
+    function createClippingPlanesEdgeWidthFunction(model) {
+        return function() {
+            if (!defined(model.clippingPlanes)) {
+                return 0.0;
             }
-            return packedPlanes;
+
+            return model.clippingPlanes.edgeWidth;
+        };
+    }
+
+    var scratchCartesian = new Cartesian4();
+    function createClippingPlanesEdgeColorFunction(model) {
+        return function() {
+            if (!defined(model.clippingPlanes)) {
+                return Cartesian4();
+            }
+
+            return Cartesian4.fromColor(model.clippingPlanes.edgeColor, scratchCartesian);
         };
     }
 
@@ -3452,7 +3465,10 @@ define([
                 gltf_colorBlend : createColorBlendFunction(model),
                 gltf_clippingPlanesEnabled: createClippingPlanesEnabledFunction(model),
                 gltf_clippingPlanesLength: createClippingPlanesLengthFunction(model),
-                gltf_clippingPlanes: createClippingPlanesFunction(model, context)
+                gltf_clippingPlanes: createClippingPlanesFunction(model, context),
+                gltf_clippingPlanesInclusive: createClippingPlanesInclusiveFunction(model),
+                gltf_clippingPlanesEdgeColor: createClippingPlanesEdgeColorFunction(model),
+                gltf_clippingPlanesEdgeWidth: createClippingPlanesEdgeWidthFunction(model)
             });
 
             // Allow callback to modify the uniformMap
@@ -4246,21 +4262,23 @@ define([
         }
     }
 
-    var edgeColor = 'vec4(1.0)';
-    var edgeWidth = '0.7';
-
     function modifyShaderForClippingPlanes(shader) {
         shader = ShaderSource.replaceMain(shader, 'gltf_clip_main');
         shader +=
             'uniform bool gltf_clippingPlanesEnabled; \n' +
             'uniform int gltf_clippingPlanesLength; \n' +
             'uniform vec4 gltf_clippingPlanes[czm_maxClippingPlanes]; \n' +
+            'uniform bool gltf_clippingPlanesInclusive; \n' +
+            'uniform vec4 gltf_clippingPlanesEdgeColor; \n' +
+            'uniform float gltf_clippingPlanesEdgeWidth; \n' +
             'void main() \n' +
             '{ \n' +
             '    gltf_clip_main(); \n' +
             '    if (gltf_clippingPlanesEnabled) { \n' +
-            '        float amount = czm_discardIfClipped(gltf_clippingPlanes, gltf_clippingPlanesLength); \n' +
-            '        if (amount > 0.0 && amount < '+ edgeWidth + ') gl_FragColor = ' + edgeColor + '; \n' +
+            '        float clipDistance = czm_discardIfClipped(gltf_clippingPlanes, gltf_clippingPlanesLength, gltf_clippingPlanesInclusive); \n' +
+            '        if (clipDistance < gltf_clippingPlanesEdgeWidth) { \n' +
+            '            gl_FragColor = gltf_clippingPlanesEdgeColor; \n' +
+            '        } \n' +
             '    } \n' +
             '} \n';
 
@@ -4293,7 +4311,7 @@ define([
         var length = 0;
         var clippingPlanes = model.clippingPlanes;
         if (defined(clippingPlanes)) {
-            length = clippingPlanes.length;
+            length = clippingPlanes.planes.length;
         }
 
         if (model._packedClippingPlanes.length !== length) {
@@ -4751,7 +4769,8 @@ define([
                 }
             }
 
-            if (this.clippingPlanesEnabled && modelViewChanged) {
+            var clippingPlanes = this.clippingPlanes;
+            if (defined(clippingPlanes) && clippingPlanes.enabled && modelViewChanged) {
                 Matrix4.multiply(context.uniformState.view3D, this._computedModelMatrix, this._modelViewMatrix);
             }
 
diff --git a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
index b99f7e371e79..1f3bd125008f 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
@@ -6,12 +6,14 @@
  *
  * @param {vec4[]} clippingPlanes The array of planes used to clip, defined in eyespace.
  * @param {int} clippingPlanesLength The number of planes in the array of clipping planes.
+ * @param {bool} inclusive
+ * @returns {float} The distance away from a clipped fragment, in eyespace
  */
-float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength)
+float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength, bool inclusive)
 {
     if (clippingPlanesLength > 0)
     {
-        bool clipped = true;
+        bool clipped = inclusive;
         vec4 position = czm_windowToEyeCoordinates(gl_FragCoord);
         vec3 clipNormal = vec3(0.0);
         vec3 clipPosition = vec3(0.0);
@@ -26,16 +28,22 @@ float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clip
 
             clipNormal = clippingPlanes[i].xyz;
             clipPosition = -clippingPlanes[i].w * clipNormal;
+
             float amount = dot(clipNormal, (position.xyz - clipPosition));
-            clipAmount += amount;
+            if (amount > clipAmount) {
+                clipAmount = amount;
+            }
 
-            clipped = clipped && (amount <= 0.0);
+            if (inclusive) {
+                clipped = clipped && (amount <= 0.0);
+            } else {
+                clipped = clipped || (amount <= 0.0);
+            }
         }
 
         if (clipped)
         {
             discard;
-            return 0.0;
         }
 
         return clipAmount;
diff --git a/Source/Shaders/GlobeFS.glsl b/Source/Shaders/GlobeFS.glsl
index 1d6be70cd4b1..be076f396704 100644
--- a/Source/Shaders/GlobeFS.glsl
+++ b/Source/Shaders/GlobeFS.glsl
@@ -55,6 +55,9 @@ uniform vec2 u_lightingFadeDistance;
 #ifdef ENABLE_CLIPPING_PLANES
 uniform int u_clippingPlanesLength;
 uniform vec4 u_clippingPlanes[czm_maxClippingPlanes];
+uniform bool u_clippingPlanesInclusive;
+uniform vec4 u_clippingPlanesEdgeColor;
+uniform float u_clippingPlanesEdgeWidth;
 #endif
 
 varying vec3 v_positionMC;
@@ -147,7 +150,7 @@ vec4 computeWaterColor(vec3 positionEyeCoordinates, vec2 textureCoordinates, mat
 void main()
 {
 #ifdef ENABLE_CLIPPING_PLANES
-    float clippingEdgeAmount = czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength);
+    float clipDistance = czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength, u_clippingPlanesInclusive);
 #endif
 
     // The clamp below works around an apparent bug in Chrome Canary v23.0.1241.0
@@ -205,8 +208,8 @@ void main()
 #endif
 
 #ifdef ENABLE_CLIPPING_PLANES
-    if (clippingEdgeAmount > 0.0 && clippingEdgeAmount < 0.5) { // Edge width
-        finalColor = vec4(1.0); // Edgecolor
+    if (clipDistance < u_clippingPlanesEdgeWidth) {
+        finalColor = u_clippingPlanesEdgeColor;
     }
 #endif
 

From 910e1c6d490c52d30a9443ff17a80f7ea2a381d1 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 17 Nov 2017 17:11:42 -0500
Subject: [PATCH 11/37] Fixed scaling in demo

---
 Apps/Sandcastle/gallery/Clipping Planes.html | 23 +++---
 Source/DataSources/PlaneGeometryUpdater.js   | 74 ++++++++------------
 Source/DataSources/PlaneGraphics.js          | 32 +++++----
 Source/Scene/Batched3DModel3DTileContent.js  |  8 ++-
 Source/Scene/ClippingPlanesCollection.js     |  3 +-
 Source/Scene/Model.js                        |  2 +-
 6 files changed, 70 insertions(+), 72 deletions(-)

diff --git a/Apps/Sandcastle/gallery/Clipping Planes.html b/Apps/Sandcastle/gallery/Clipping Planes.html
index 5ca87ed1957f..425dab024016 100644
--- a/Apps/Sandcastle/gallery/Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/Clipping Planes.html	
@@ -49,7 +49,7 @@
 });
 var scene = viewer.scene;
 
-var planeScale = new Cesium.Cartesian2(300.0, 300.0);
+var planeScale = new Cesium.Cartesian2(500.0, 500.0);
 
 var defaultClippingPlanes = [
     new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0,-1.0), -100.0)
@@ -99,10 +99,14 @@
     }
 }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
 
-function createPlaneUpdateFunction(plane) {
+var scratchPlane = new Cesium.Plane(Cesium.Cartesian3.UNIT_X, 0.0);
+function createPlaneUpdateFunction(tileset, plane) {
     return function () {
         plane.distance = Cesium.Math.lerp(plane.distance, targetY, 0.1);
-        return plane.distance;
+
+        var transformedPlane = Cesium.Plane.transform(plane, tileset.modelMatrix, scratchPlane);
+        transformedPlane.distance = -transformedPlane.distance;
+        return transformedPlane;
     };
 }
 
@@ -114,9 +118,10 @@
         url : url,
         clippingPlanes : new Cesium.ClippingPlanesCollection({
             planes : defaultClippingPlanes,
-            edgeWidth: 10.0,
+            edgeWidth: 1.0,
             edgeColor: Cesium.Color.CYAN
-        })
+        }),
+        modelMatrix : Cesium.Matrix4.fromUniformScale(2.0)
     }));
 
     tileset.readyPromise.then(function() {
@@ -124,22 +129,22 @@
         viewer.camera.viewBoundingSphere(boundingSphere, new Cesium.HeadingPitchRange(0.5, -0.2, boundingSphere.radius * 4.0));
         viewer.camera.lookAtTransform(Cesium.Matrix4.IDENTITY);
 
-        for (var i = 0; i < 1; ++i) {
+        for (var i = 0; i < defaultClippingPlanes.length; ++i) {
             var plane = tileset.clippingPlanes.planes[i];
             var entity = viewer.entities.add({
                 position : boundingSphere.center,
                 plane : {
                     dimensions : planeScale,
                     material : Cesium.Color.CYAN.withAlpha(0.1),
-                    normal: plane.normal,
-                    distance: new Cesium.CallbackProperty(createPlaneUpdateFunction(plane), false),
+                    plane: new Cesium.CallbackProperty(createPlaneUpdateFunction(tileset, plane), false),
                     outline: true,
                     outlineColor: Cesium.Color.CYAN
-                }
+                },
             });
 
             planeEntities.push(entity);
         }
+
     }).otherwise(function(error) {
         throw(error);
     });
diff --git a/Source/DataSources/PlaneGeometryUpdater.js b/Source/DataSources/PlaneGeometryUpdater.js
index 6ee862b5e7aa..02117d691b1f 100644
--- a/Source/DataSources/PlaneGeometryUpdater.js
+++ b/Source/DataSources/PlaneGeometryUpdater.js
@@ -70,8 +70,7 @@ define([
     function GeometryOptions(entity) {
         this.id = entity;
         this.vertexFormat = undefined;
-        this.normal = undefined;
-        this.distance = 0.0;
+        this.plane = undefined;
         this.dimensions = undefined;
     }
 
@@ -370,12 +369,8 @@ define([
         }
 
         var options = this._options;
-        var normal = options.normal;
-        var distance = options.distance;
-        var dimensions = options.dimensions;
 
         var modelMatrix = entity.computeModelMatrix(Iso8601.MINIMUM_VALUE);
-        //modelMatrix = createPrimitiveMatrix(normal, distance, dimensions, modelMatrix, modelMatrix);
 
         return new GeometryInstance({
             id : entity,
@@ -409,13 +404,7 @@ define([
         var outlineColor = Property.getValueOrDefault(this._outlineColorProperty, time, Color.BLACK);
         var distanceDisplayCondition = this._distanceDisplayConditionProperty.getValue(time);
 
-        var options = this._options;
-        var normal = options.normal;
-        var distance = options.distance;
-        var dimensions = options.dimensions;
-
         var modelMatrix = entity.computeModelMatrix(Iso8601.MINIMUM_VALUE);
-        //modelMatrix = createPrimitiveMatrix(normal, distance, dimensions, modelMatrix, modelMatrix);
 
         return new GeometryInstance({
             id : entity,
@@ -453,11 +442,9 @@ define([
             return;
         }
 
-        var plane = this._entity.plane;
-
-
+        var planeGraphics = this._entity.plane;
 
-        if (!defined(plane)) {
+        if (!defined(planeGraphics)) {
             if (this._fillEnabled || this._outlineEnabled) {
                 this._fillEnabled = false;
                 this._outlineEnabled = false;
@@ -466,10 +453,10 @@ define([
             return;
         }
 
-        var fillProperty = plane.fill;
+        var fillProperty = planeGraphics.fill;
         var fillEnabled = defined(fillProperty) && fillProperty.isConstant ? fillProperty.getValue(Iso8601.MINIMUM_VALUE) : true;
 
-        var outlineProperty = plane.outline;
+        var outlineProperty = planeGraphics.outline;
         var outlineEnabled = defined(outlineProperty);
         if (outlineEnabled && outlineProperty.isConstant) {
             outlineEnabled = outlineProperty.getValue(Iso8601.MINIMUM_VALUE);
@@ -484,13 +471,12 @@ define([
             return;
         }
 
-        var normal = plane.normal;
-        var distance = plane.distance;
-        var dimensions = plane.dimensions;
+        var plane = planeGraphics.plane;
+        var dimensions = planeGraphics.dimensions;
         var position = entity.position;
 
-        var show = plane.show;
-        if (!defined(normal) || !defined(distance) || !defined(position) || (defined(show) && show.isConstant && !show.getValue(Iso8601.MINIMUM_VALUE))) {
+        var show = planeGraphics.show;
+        if (!defined(plane) || !defined(position) || (defined(show) && show.isConstant && !show.getValue(Iso8601.MINIMUM_VALUE))) {
             if (this._fillEnabled || this._outlineEnabled) {
                 this._fillEnabled = false;
                 this._outlineEnabled = false;
@@ -499,25 +485,24 @@ define([
             return;
         }
 
-        var material = defaultValue(plane.material, defaultMaterial);
+        var material = defaultValue(planeGraphics.material, defaultMaterial);
         var isColorMaterial = material instanceof ColorMaterialProperty;
         this._materialProperty = material;
         this._fillProperty = defaultValue(fillProperty, defaultFill);
         this._showProperty = defaultValue(show, defaultShow);
-        this._showOutlineProperty = defaultValue(plane.outline, defaultOutline);
-        this._outlineColorProperty = outlineEnabled ? defaultValue(plane.outlineColor, defaultOutlineColor) : undefined;
-        this._shadowsProperty = defaultValue(plane.shadows, defaultShadows);
-        this._distanceDisplayConditionProperty = defaultValue(plane.distanceDisplayCondition, defaultDistanceDisplayCondition);
+        this._showOutlineProperty = defaultValue(planeGraphics.outline, defaultOutline);
+        this._outlineColorProperty = outlineEnabled ? defaultValue(planeGraphics.outlineColor, defaultOutlineColor) : undefined;
+        this._shadowsProperty = defaultValue(planeGraphics.shadows, defaultShadows);
+        this._distanceDisplayConditionProperty = defaultValue(planeGraphics.distanceDisplayCondition, defaultDistanceDisplayCondition);
 
-        var outlineWidth = plane.outlineWidth;
+        var outlineWidth = planeGraphics.outlineWidth;
 
         this._fillEnabled = fillEnabled;
         this._outlineEnabled = outlineEnabled;
 
         if (!position.isConstant || //
             !Property.isConstant(entity.orientation) || //
-            !normal.isConstant || //
-            !distance.isConstant || //
+            !plane.isConstant || //
             !dimensions.isConstant || //
             !Property.isConstant(outlineWidth)) {
             if (!this._dynamic) {
@@ -527,8 +512,7 @@ define([
         } else {
             var options = this._options;
             options.vertexFormat = isColorMaterial ? PerInstanceColorAppearance.VERTEX_FORMAT : MaterialAppearance.MaterialSupport.TEXTURED.vertexFormat;
-            options.normal = normal.getValue(Iso8601.MINIMUM_VALUE, options.normal);
-            options.distance = distance.getValue(Iso8601.MINIMUM_VALUE, options.distance);
+            options.plane = plane.getValue(Iso8601.MINIMUM_VALUE, options.plane);
             options.dimensions = dimensions.getValue(Iso8601.MINIMUM_VALUE, options.dimensions);
             this._outlineWidth = defined(outlineWidth) ? outlineWidth.getValue(Iso8601.MINIMUM_VALUE) : 1.0;
             this._dynamic = false;
@@ -583,25 +567,23 @@ define([
 
         var geometryUpdater = this._geometryUpdater;
         var entity = geometryUpdater._entity;
-        var plane = entity.plane;
-        if (!entity.isShowing || !entity.isAvailable(time) || !Property.getValueOrDefault(plane.show, time, true)) {
+        var planeGraphics = entity.plane;
+        if (!entity.isShowing || !entity.isAvailable(time) || !Property.getValueOrDefault(planeGraphics.show, time, true)) {
             return;
         }
 
         var options = this._options;
         var modelMatrix = entity.computeModelMatrix(time);
-        var normal = Property.getValueOrDefault(plane.normal, time, options.normal);
-        var distance = Property.getValueOrUndefined(plane.distance, time, options.distance);
-        var dimensions = Property.getValueOrUndefined(plane.dimensions, time, options.dimensions);
-        if (!defined(modelMatrix) || !defined(normal) || !defined(distance) || !defined(dimensions)) {
+        var plane = Property.getValueOrDefault(planeGraphics.plane, time, options.plane);
+        var dimensions = Property.getValueOrUndefined(planeGraphics.dimensions, time, options.dimensions);
+        if (!defined(modelMatrix) || !defined(plane) || !defined(dimensions)) {
             return;
         }
 
-        options.normal = normal;
-        options.distance = distance;
+        options.plane = plane;
         options.dimensions = dimensions;
 
-        modelMatrix = createPrimitiveMatrix(normal, distance, dimensions, modelMatrix, modelMatrix);
+        modelMatrix = createPrimitiveMatrix(plane.normal, plane.distance, dimensions, modelMatrix, modelMatrix);
 
         var shadows = this._geometryUpdater.shadowsProperty.getValue(time);
 
@@ -609,7 +591,7 @@ define([
         var distanceDisplayCondition = distanceDisplayConditionProperty.getValue(time);
         var distanceDisplayConditionAttribute = DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(distanceDisplayCondition);
 
-        if (Property.getValueOrDefault(plane.fill, time, true)) {
+        if (Property.getValueOrDefault(planeGraphics.fill, time, true)) {
             var material = MaterialProperty.getValue(time, geometryUpdater.fillMaterialProperty, this._material);
             this._material = material;
 
@@ -635,11 +617,11 @@ define([
             }));
         }
 
-        if (Property.getValueOrDefault(plane.outline, time, false)) {
+        if (Property.getValueOrDefault(planeGraphics.outline, time, false)) {
             options.vertexFormat = PerInstanceColorAppearance.VERTEX_FORMAT;
 
-            var outlineColor = Property.getValueOrClonedDefault(plane.outlineColor, time, Color.BLACK, scratchColor);
-            var outlineWidth = Property.getValueOrDefault(plane.outlineWidth, time, 1.0);
+            var outlineColor = Property.getValueOrClonedDefault(planeGraphics.outlineColor, time, Color.BLACK, scratchColor);
+            var outlineWidth = Property.getValueOrDefault(planeGraphics.outlineWidth, time, 1.0);
             var translucent = outlineColor.alpha !== 1.0;
 
             this._outlinePrimitive = primitives.add(new Primitive({
diff --git a/Source/DataSources/PlaneGraphics.js b/Source/DataSources/PlaneGraphics.js
index 3aac0ea91e95..59348494fea5 100644
--- a/Source/DataSources/PlaneGraphics.js
+++ b/Source/DataSources/PlaneGraphics.js
@@ -23,7 +23,8 @@ define([
      * @constructor
      *
      * @param {Object} [options] Object with the following properties:
-     * @param {Property} [options.dimensions] A {@link Cartesian3} Property specifying the length, width, and height of the box.
+     * @param {Property} [options.plane] A {@link Plane} Property specifying the normal and distance for the plane.
+     * @param {Property} [options.dimensions] A {@link Cartesian2} Property specifying the width and height of the plane.
      * @param {Property} [options.show=true] A boolean Property specifying the visibility of the box.
      * @param {Property} [options.fill=true] A boolean Property specifying whether the box is filled with the provided material.
      * @param {MaterialProperty} [options.material=Color.WHITE] A Property specifying the material used to fill the box.
@@ -36,11 +37,8 @@ define([
      * @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=Box.html|Cesium Sandcastle Box Demo}
      */
     function PlaneGraphics(options) {
-        this._normal = undefined;
-        this._normalSubscription = undefined;
-        this._distance = undefined;
-        this._distanceSubscription = undefined;
-        this._dimensions = undefined;
+        this._plane = undefined;
+        this._planeSubscription = undefined;
         this._dimensionsSubscription = undefined;
         this._show = undefined;
         this._showSubscription = undefined;
@@ -84,8 +82,20 @@ define([
          */
         show : createPropertyDescriptor('show'),
 
-        normal : createPropertyDescriptor('normal'),
-        distance : createPropertyDescriptor('distance'),
+        /**
+         * Gets or sets the {@link Plane} Property specifying the normal and distance of the plane.
+         *
+         * @memberof PlaneGraphics.prototype
+         * @type {Property}
+         */
+        plane : createPropertyDescriptor('plane'),
+
+        /**
+         * Gets or sets the {@link Cartesian2} Property specifying the width and height of the plane.
+         *
+         * @memberof PlaneGraphics.prototype
+         * @type {Property}
+         */
         dimensions : createPropertyDescriptor('dimensions'),
 
         /**
@@ -155,8 +165,7 @@ define([
         if (!defined(result)) {
             return new PlaneGraphics(this);
         }
-        result.normal = this.normal;
-        result.distance = this.distance;
+        result.plane = this.plane;
         result.dimensions = this.dimensions;
         result.show = this.show;
         result.material = this.material;
@@ -182,8 +191,7 @@ define([
         }
         //>>includeEnd('debug');
 
-        this.normal = defaultValue(this.normal, source.normal);
-        this.distance = defaultValue(this.distance, source.distance);
+        this.plane = defaultValue(this.plane, source.plane);
         this.dimensions = defaultValue(this.dimensions, source.dimensions);
         this.show = defaultValue(this.show, source.show);
         this.material = defaultValue(this.material, source.material);
diff --git a/Source/Scene/Batched3DModel3DTileContent.js b/Source/Scene/Batched3DModel3DTileContent.js
index 86bed8370b29..27e1c0403b77 100644
--- a/Source/Scene/Batched3DModel3DTileContent.js
+++ b/Source/Scene/Batched3DModel3DTileContent.js
@@ -450,10 +450,12 @@ define([
         this._model.debugWireframe = this._tileset.debugWireframe;
 
         // Update clipping planes
-        var modelClippingPlanes = this._model.clippingPlanes.planes;
         var tilesetClippingPlanes = this._tileset.clippingPlanes;
-        tilesetClippingPlanes.clone(modelClippingPlanes);
-        modelClippingPlanes.enabled = tilesetClippingPlanes.enabled && this._tile._isClipped;
+        if (defined(tilesetClippingPlanes)) {
+            var modelClippingPlanes = this._model.clippingPlanes.planes;
+            tilesetClippingPlanes.clone(modelClippingPlanes);
+            modelClippingPlanes.enabled = tilesetClippingPlanes.enabled && this._tile._isClipped;
+        }
 
         this._model.update(frameState);
 
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index 8e7b954809a7..038d6b1e1415 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -39,7 +39,7 @@ define([
          * @type {Plane}
          * @default []
          */
-        this.planes = defaultValue(options.planes, []); // TODO don't instantiate?
+        this.planes = defaultValue(options.planes, []);
 
         /**
          * Determines whether the clipping planes are active.
@@ -82,6 +82,7 @@ define([
          */
         this.edgeWidth = defaultValue(options.edgeWidth, 0.0);
 
+        this._geometries = undefined;
     }
 
     var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index 84038881c48e..7f163d211d91 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -3361,7 +3361,7 @@ define([
     function createClippingPlanesEdgeColorFunction(model) {
         return function() {
             if (!defined(model.clippingPlanes)) {
-                return Cartesian4();
+                return scratchCartesian;
             }
 
             return Cartesian4.fromColor(model.clippingPlanes.edgeColor, scratchCartesian);

From 6d67925820dbfe3ac2af0428e241766682d60d82 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 20 Nov 2017 13:13:23 -0500
Subject: [PATCH 12/37] Optimize globe tile loading with clipping planes

---
 Source/Scene/Cesium3DTile.js             | 26 ++++++++-----
 Source/Scene/ClippingPlanesCollection.js | 47 +++++++++++++++++++++++-
 Source/Scene/GlobeSurfaceTile.js         |  1 +
 Source/Scene/GlobeSurfaceTileProvider.js | 30 ++++++++++-----
 4 files changed, 82 insertions(+), 22 deletions(-)

diff --git a/Source/Scene/Cesium3DTile.js b/Source/Scene/Cesium3DTile.js
index dfe40de97a62..6eb6ad2af9b7 100644
--- a/Source/Scene/Cesium3DTile.js
+++ b/Source/Scene/Cesium3DTile.js
@@ -744,10 +744,10 @@ define([
     var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
     function checkTileClipped(tile, boundingVolume) {
         var clippingPlanes = tile._tileset.clippingPlanes;
-        if (defined(clippingPlanes)) {
+        if (defined(clippingPlanes) && clippingPlanes.enabled) {
             var planes = clippingPlanes.planes;
             var length = planes.length;
-            var rootTransform = tile._tileset._root.computedTransform;
+            var rootTransform = tile._tileset._root.computedTransform; // TODO, factor in inclusive/exclusive, transform
             for (var i = 0; i < length; ++i) {
                 var plane = planes[i];
                 Plane.transform(plane, rootTransform, scratchPlane);
@@ -775,10 +775,13 @@ define([
         var cullingVolume = frameState.cullingVolume;
         var boundingVolume = getBoundingVolume(this, frameState);
 
-        if (this._tileset.clippingPlanesEnabled) {
-            var clipped = checkTileClipped(this, boundingVolume);
-            this._isClipped = (clipped !== Intersect.INSIDE);
-            if (clipped === Intersect.OUTSIDE) {
+        var tileset = this._tileset;
+        var clippingPlanes = tileset.clippingPlanes;
+        if (defined(clippingPlanes) && clippingPlanes.enabled) {
+            var tileTransform = tileset._root.computedTransform;
+            var intersection = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume, tileTransform);
+            this._isClipped = (intersection !== Intersect.INSIDE);
+            if (intersection === Intersect.OUTSIDE) {
                 return CullingVolume.MASK_OUTSIDE;
             }
         }
@@ -807,10 +810,13 @@ define([
         var cullingVolume = frameState.cullingVolume;
         var boundingVolume = getContentBoundingVolume(this, frameState);
 
-        if (this._tileset.clippingPlanesEnabled) {
-            var clipped = checkTileClipped(this, boundingVolume);
-            this._isClipped = (clipped !== Intersect.INSIDE);
-            if (clipped === Intersect.OUTSIDE) {
+        var tileset = this._tileset;
+        var clippingPlanes = tileset.clippingPlanes;
+        if (defined(clippingPlanes) && clippingPlanes.enabled) {
+            var tileTransform = tileset._root.computedTransform;
+            var intersection = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume, tileTransform);
+            this._isClipped = (intersection !== Intersect.INSIDE);
+            if (intersection === Intersect.OUTSIDE) {
                 return Intersect.OUTSIDE;
             }
         }
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index 038d6b1e1415..6d7bdafe241c 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -6,6 +6,7 @@ define([
     '../Core/Color',
     '../Core/defaultValue',
     '../Core/defined',
+    '../Core/Intersect',
     '../Core/Matrix4',
     '../Core/Plane'
 ], function(
@@ -16,6 +17,7 @@ define([
     Color,
     defaultValue,
     defined,
+    Intersect,
     Matrix4,
     Plane) {
     'use strict';
@@ -81,8 +83,6 @@ define([
          * @default 0.0
          */
         this.edgeWidth = defaultValue(options.edgeWidth, 0.0);
-
-        this._geometries = undefined;
     }
 
     var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
@@ -138,5 +138,48 @@ define([
         return result;
     };
 
+    /**
+     * Determines the type intersection with the planes of this bounding collection and the specified {@link BoundingVolume}.
+     *
+     * @param {BoundingVolume} boundingVolume The volume to determine the intersection with the planes.
+     * @param {Matrix4} [parentTransform] An additional matrix to transform the plane to world coordinates.
+     * @returns {Intersect} {@link Intersect.INSIDE} if the entire volume is on the side of the planes
+     *                      the normal is pointing and should be entirely rendered, {@link Intersect.OUTSIDE}
+     *                      if the entire volume is on the opposite side and should be clipped, and
+     *                      {@link Intersect.INTERSECTING} if the volume intersects the planes.
+     */
+    ClippingPlanesCollection.prototype.computeIntersectionWithBoundingVolume = function (boundingVolume, parentTransform) {
+        var planes = this.planes;
+        var length = planes.length;
+
+        var transformation = this.transformationMatrix;
+        if (defined(parentTransform)) {
+            transformation = Matrix4.multiply(transformation, parentTransform, scratchMatrix);
+        }
+
+        // If the clipping planes are inclusive, the volume must be outside of all planes to be considered completely
+        // clipped. Otherwise, if the volume can be outside any the planes, it is considered completely clipped.
+        // Lastly, if not completely clipped, if any plane is intersecting, more calculations must be performed.
+        var intersection = Intersect.INSIDE;
+        if (this.inclusive && length > 0) {
+            intersection = Intersect.OUTSIDE;
+        }
+        for (var i = 0; i < length; ++i) {
+            var plane = planes[i];
+
+            Plane.transform(plane, transformation, scratchPlane);
+
+            var value = boundingVolume.intersectPlane(scratchPlane);
+            if (value === Intersect.INTERSECTING) {
+                intersection = value;
+            } else if ((this.inclusive && value === Intersect.INSIDE) ||
+                       (!this.inclusive && value === Intersect.OUTSIDE)) {
+                return value;
+            }
+        }
+
+        return intersection;
+    };
+
     return ClippingPlanesCollection;
 });
diff --git a/Source/Scene/GlobeSurfaceTile.js b/Source/Scene/GlobeSurfaceTile.js
index a976e41f53c2..22aad038b2b4 100644
--- a/Source/Scene/GlobeSurfaceTile.js
+++ b/Source/Scene/GlobeSurfaceTile.js
@@ -80,6 +80,7 @@ define([
         this.pickTerrain = undefined;
 
         this.surfaceShader = undefined;
+        this.isClipped = true;
     }
 
     defineProperties(GlobeSurfaceTile.prototype, {
diff --git a/Source/Scene/GlobeSurfaceTileProvider.js b/Source/Scene/GlobeSurfaceTileProvider.js
index 009c4f61a769..ce6c2fce8548 100644
--- a/Source/Scene/GlobeSurfaceTileProvider.js
+++ b/Source/Scene/GlobeSurfaceTileProvider.js
@@ -507,6 +507,15 @@ define([
             }
         }
 
+        var clippingPlanes = this.clippingPlanes;
+        if (defined(clippingPlanes) && clippingPlanes.enabled) {
+            var planeIntersection = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+            tile.isClipped = (planeIntersection !== Intersect.INSIDE);
+            if (planeIntersection === Intersect.OUTSIDE) {
+                return Intersect.OUTSIDE;
+            }
+        }
+
         var intersection = cullingVolume.computeVisibility(boundingVolume);
         if (intersection === Intersect.OUTSIDE) {
             return Visibility.NONE;
@@ -1290,17 +1299,19 @@ define([
             Matrix4.clone(encoding.matrix, uniformMapProperties.scaleAndBias);
 
             // update clipping planes
-            var length = 0;
-            var clippingPlanes = tileProvider.clippingPlanes;
+            if (tile.isClipped) {
+                var length = 0;
+                var clippingPlanes = tileProvider.clippingPlanes;
 
-            if (defined(clippingPlanes)) {
-                length = clippingPlanes.planes.length;
-            }
-            if (length !== uniformMapProperties.clippingPlanes.length) {
-                uniformMapProperties.clippingPlanes = new Array(length);
+                if (defined(clippingPlanes)) {
+                    length = clippingPlanes.planes.length;
+                }
+                if (length !== uniformMapProperties.clippingPlanes.length) {
+                    uniformMapProperties.clippingPlanes = new Array(length);
 
-                for (var i = 0; i < length; ++i) {
-                    uniformMapProperties.clippingPlanes[i] = new Cartesian4();
+                    for (var i = 0; i < length; ++i) {
+                        uniformMapProperties.clippingPlanes[i] = new Cartesian4();
+                    }
                 }
             }
 
@@ -1311,7 +1322,6 @@ define([
                 uniformMapProperties.clippingPlanesEdgeWidth = clippingPlanes.edgeWidth;
             }
 
-            // TODO: Optimization, determine if this tile is entirely clipped or entirely visible
             var clippingPlanesEnabled = defined(clippingPlanes) && clippingPlanes.enabled && (uniformMapProperties.clippingPlanes.length > 0);
 
             command.shaderProgram = tileProvider._surfaceShaderSet.getShaderProgram(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, tileProvider.enableLighting, hasVertexNormals, useWebMercatorProjection, applyFog, clippingPlanesEnabled);

From 086a03b1b90bda88f29ac32577293d74e9cd15b8 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Tue, 21 Nov 2017 13:09:05 -0500
Subject: [PATCH 13/37] Cleanup docs

---
 Source/DataSources/ModelGraphics.js      |  5 ++---
 Source/Scene/Cesium3DTileset.js          |  4 ++--
 Source/Scene/ClippingPlanesCollection.js | 17 +++++++++++------
 Source/Scene/Model.js                    |  4 ++--
 4 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/Source/DataSources/ModelGraphics.js b/Source/DataSources/ModelGraphics.js
index 90af4ab0a59a..e0e4ec7d2b10 100644
--- a/Source/DataSources/ModelGraphics.js
+++ b/Source/DataSources/ModelGraphics.js
@@ -54,7 +54,7 @@ define([
      * @param {Property} [options.color=Color.WHITE] A Property specifying the {@link Color} that blends with the model's rendered color.
      * @param {Property} [options.colorBlendMode=ColorBlendMode.HIGHLIGHT] An enum Property specifying how the color blends with the model.
      * @param {Property} [options.colorBlendAmount=0.5] A numeric Property specifying the color strength when the <code>colorBlendMode</code> is <code>MIX</code>. A value of 0.0 results in the model's rendered color while a value of 1.0 results in a solid color, with any value in-between resulting in a mix of the two.
-     * @param {Property} [options.clippingPlanes] A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+     * @param {Property} [options.clippingPlanes] A property specifying the {@link ClippingPlanesCollection} used to selectively disable rendering the model.
      *
      * @see {@link http://cesiumjs.org/2014/03/03/Cesium-3D-Models-Tutorial/|3D Models Tutorial}
      * @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=3D%20Models.html|Cesium Sandcastle 3D Models Demo}
@@ -248,10 +248,9 @@ define([
         colorBlendAmount : createPropertyDescriptor('colorBlendAmount'),
 
         /**
-         * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+         * A property specifying the {@link ClippingPlanesCollection} used to selectively disable rendering the model.
          * @memberof ModelGraphics.prototype
          * @type {Property}
-         * @default []
          */
         clippingPlanes: createPropertyDescriptor('clippingPlanes')
     });
diff --git a/Source/Scene/Cesium3DTileset.js b/Source/Scene/Cesium3DTileset.js
index 3194f7463051..2a88231f0dc1 100644
--- a/Source/Scene/Cesium3DTileset.js
+++ b/Source/Scene/Cesium3DTileset.js
@@ -105,7 +105,7 @@ define([
      * @param {Number} [options.skipLevels=1] When <code>skipLevelOfDetail</code> is <code>true</code>, a constant defining the minimum number of levels to skip when loading tiles. When it is 0, no levels are skipped. Used in conjunction with <code>skipScreenSpaceErrorFactor</code> to determine which tiles to load.
      * @param {Boolean} [options.immediatelyLoadDesiredLevelOfDetail=false] When <code>skipLevelOfDetail</code> is <code>true</code>, only tiles that meet the maximum screen space error will ever be downloaded. Skipping factors are ignored and just the desired tiles are loaded.
      * @param {Boolean} [options.loadSiblings=false] When <code>skipLevelOfDetail</code> is <code>true</code>, determines whether siblings of visible tiles are always downloaded during traversal.
-     * @param {ClippingPlaneCollection} [options.clippingPlanes] A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+     * @param {ClippingPlaneCollection} [options.clippingPlanes] The {@link ClippingPlanesCollection} used to selectively disable rendering the tileset.
      * @param {Boolean} [options.debugFreezeFrame=false] For debugging only. Determines if only the tiles from last frame should be used for rendering.
      * @param {Boolean} [options.debugColorizeTiles=false] For debugging only. When true, assigns a random color to each tile.
      * @param {Boolean} [options.debugWireframe=false] For debugging only. When true, render's each tile's content as a wireframe.
@@ -524,7 +524,7 @@ define([
         this.loadSiblings = defaultValue(options.loadSiblings, false);
 
         /**
-         * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+         * The {@link ClippingPlanesCollection} used to selectively disable rendering the tileset.
          *
          * @type {ClippingPlanesCollection}
          */
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index 6d7bdafe241c..2a813aa706d3 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -29,8 +29,13 @@ define([
      * @alias ClippingPlanesCollection
      * @constructor
      *
-     * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] Determines the size and shape of the
-     * globe.
+     * @param {Object} [options] Object with the following properties:
+     * @param {Plane[]} [options.planes=[]] An array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+     * @param {Boolean} [options.enabled=true] Determines whether the clipping planes are active.
+     * @param {Matrix4} [options.transformationMatrix=Matrix4.IDENTITY] The 4x4 transformation matrix specifying an additional transform relative to the clipping planes original coordinate system.
+     * @param {Boolean} [options.inclusive=true] If true, the region to be clipped must be included in all planes in this collection. Otherwise, a region will be clipped if included in any plane in the collection.
+     * @param {Color} [options.edgeColor=Color.WHITE] The color applied to hughlight the edge along which an object is clipped.
+     * @param {Number} [options.edgeWidth=0.0] The width of the highlight applied to the edge along which an object is clipped.
      */
     function ClippingPlanesCollection(options) {
         var options = defaultValue(options, defaultValue.EMPTY_OBJECT);
@@ -52,7 +57,7 @@ define([
         this.enabled = defaultValue(options.enabled, true);
 
         /**
-         * A transformation matrix specifying the coordinate system for this collection.
+         * The 4x4 transformation matrix specifying an additional transform relative to the clipping planes original coordinate system.
          *
          * @type {Matrix4}
          * @default Matrix4.IDENTITY
@@ -69,7 +74,7 @@ define([
         this.inclusive = defaultValue(options.inclusive, true);
 
         /**
-         * The color of the highlighted clipped edge.
+         * The color applied to hughlight the edge along which an object is clipped.
          *
          * @type {Color}
          * @default Color.WHITE
@@ -77,7 +82,7 @@ define([
         this.edgeColor = defaultValue(options.edgeColor, Color.WHITE);
 
         /**
-         * The width of the clipped edge to highlight.
+         * The width of the highlight applied to the edge along which an object is clipped.
          *
          * @type {Number}
          * @default 0.0
@@ -142,7 +147,7 @@ define([
      * Determines the type intersection with the planes of this bounding collection and the specified {@link BoundingVolume}.
      *
      * @param {BoundingVolume} boundingVolume The volume to determine the intersection with the planes.
-     * @param {Matrix4} [parentTransform] An additional matrix to transform the plane to world coordinates.
+     * @param {Matrix4} [parentTransform] An optional, additional matrix to transform the plane to world coordinates.
      * @returns {Intersect} {@link Intersect.INSIDE} if the entire volume is on the side of the planes
      *                      the normal is pointing and should be entirely rendered, {@link Intersect.OUTSIDE}
      *                      if the entire volume is on the opposite side and should be clipped, and
diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index 7f163d211d91..37602006092c 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -341,7 +341,7 @@ define([
      * @param {Number} [options.colorBlendAmount=0.5] Value used to determine the color strength when the <code>colorBlendMode</code> is <code>MIX</code>. A value of 0.0 results in the model's rendered color while a value of 1.0 results in a solid color, with any value in-between resulting in a mix of the two.
      * @param {Color} [options.silhouetteColor=Color.RED] The silhouette color. If more than 256 models have silhouettes enabled, there is a small chance that overlapping models will have minor artifacts.
      * @param {Number} [options.silhouetteSize=0.0] The size of the silhouette in pixels.
-     * @param {ClippingPlanesCollection} [options.clippingPlanes] An array of {@link Plane} used to clip the model.
+     * @param {ClippingPlanesCollection} [options.clippingPlanes] The {@link ClippingPlanesCollection} used to selectively disable rendering the model.
      *
      * @exception {DeveloperError} bgltf is not a valid Binary glTF file.
      * @exception {DeveloperError} Only glTF Binary version 1 is supported.
@@ -580,7 +580,7 @@ define([
         this.colorBlendAmount = defaultValue(options.colorBlendAmount, 0.5);
 
         /**
-         * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+         * The {@link ClippingPlanesCollection} used to selectively disable rendering the model.
          *
          * @type {ClippingPlanesCollection}
          */

From af21899f9940a08114b01eeb960dd39234f7c720 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Tue, 21 Nov 2017 13:12:43 -0500
Subject: [PATCH 14/37] Updated CHANGES.md

---
 CHANGES.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGES.md b/CHANGES.md
index 67d968efe6d8..918d68eb3014 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -3,7 +3,8 @@ Change Log
 
 ## TODO release
 
-* Added `clippingPlanes` property to `ModelGraphics` and `Cesium3DTileset`, which specifies an array of planes to clip the object. [TODO]()
+* Added `clippingPlanes` property to `ModelGraphics` and `Cesium3DTileset`, which specifies a `ClippingPlanesCollection` to clip the object. [TODO]()
+* Added `terrainClippingPlanes` property to `Globe` which specifies a `ClippingPlanesCollection` to clip the terrain.
 * Added `Plane.transformPlane` function to apply a transformation to a plane. [TODO]()
 * Added `PlaneGeometry` and `PlaneOutlineGeometry` primitives
 * Added `PlaneGraphics` and `plane` property to `Entity`.

From 748784749f2f98f9bbabf95804eabc579aa20f65 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Tue, 21 Nov 2017 13:25:47 -0500
Subject: [PATCH 15/37] Tweak doc

---
 Source/Scene/ClippingPlanesCollection.js | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index 2a813aa706d3..8b06f0969089 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -23,8 +23,7 @@ define([
     'use strict';
 
     /**
-     * The globe rendered in the scene, including its terrain ({@link ClippingPlanesCollection#terrainProvider})
-     * and imagery layers ({@link ClippingPlanesCollection#imageryLayers}).  Access the globe using {@link Scene#globe}.
+     * Contains the options to specify a set of clipping planes. Clipping planes selectively disable rendering on an object on the outside of the specified list of {@link Plane}.
      *
      * @alias ClippingPlanesCollection
      * @constructor

From 227698cc3d1a8421deb029837e8b751ffadaedf7 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Wed, 22 Nov 2017 15:31:43 -0500
Subject: [PATCH 16/37] Update Sandcastle example, fix sandcastle images

---
 Apps/Sandcastle/gallery/Clipping Planes.html  | 103 +++++++++++++++---
 Apps/Sandcastle/gallery/Clipping Planes.jpg   | Bin 20989 -> 31284 bytes
 Apps/Sandcastle/gallery/Terrain Clipping.html |   8 +-
 Apps/Sandcastle/gallery/Terrain Clipping.jpg  | Bin 0 -> 32991 bytes
 Source/DataSources/ModelVisualizer.js         |   3 +-
 Source/Scene/ClippingPlanesCollection.js      |  10 +-
 Source/Scene/Model.js                         |  33 ++----
 Source/Scene/PointCloud3DTileContent.js       |  92 +++++++++++-----
 8 files changed, 165 insertions(+), 84 deletions(-)
 create mode 100644 Apps/Sandcastle/gallery/Terrain Clipping.jpg

diff --git a/Apps/Sandcastle/gallery/Clipping Planes.html b/Apps/Sandcastle/gallery/Clipping Planes.html
index 425dab024016..73e04286bf59 100644
--- a/Apps/Sandcastle/gallery/Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/Clipping Planes.html	
@@ -36,6 +36,7 @@
 <div id="cesiumContainer" class="fullSize"></div>
 <div id="loadingOverlay"><h1>Loading...</h1></div>
 <div id="toolbar">
+    <select data-bind="options: exampleTypes, value: currentExampleType"></select>
     <input type="checkbox" value="false" data-bind="checked: debugBoundingVolumesEnabled, valueUpdate: 'input'"> Show debug <code>boundingVolume</code>
 </div>
 
@@ -49,14 +50,15 @@
 });
 var scene = viewer.scene;
 
-var planeScale = new Cesium.Cartesian2(500.0, 500.0);
-
 var defaultClippingPlanes = [
     new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0,-1.0), -100.0)
 ];
 
+var clipObjects = ['BIM', 'Point Cloud', 'Model'];
 var viewModel = {
-    debugBoundingVolumesEnabled: false
+    debugBoundingVolumesEnabled : false,
+    exampleTypes : clipObjects,
+    currentExampleType : clipObjects[0]
 };
 
 var targetY = 0.0;
@@ -94,17 +96,17 @@
 moveHandler.setInputAction(function(movement) {
     if (Cesium.defined(selectedPlane)) {
         var deltaY = movement.endPosition.y - movement.startPosition.y;
-        var screenScale = scene.camera.getPixelSize(tileset.boundingSphere, scene.drawingBufferWidth, scene.drawingBufferHeight);
-        targetY += deltaY * screenScale;
+        //var screenScale = scene.camera.getPixelSize(tileset.boundingSphere, scene.drawingBufferWidth, scene.drawingBufferHeight);
+        targetY += deltaY;// * screenScale;
     }
 }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
 
 var scratchPlane = new Cesium.Plane(Cesium.Cartesian3.UNIT_X, 0.0);
-function createPlaneUpdateFunction(tileset, plane) {
+function createPlaneUpdateFunction(plane, transform) {
     return function () {
         plane.distance = Cesium.Math.lerp(plane.distance, targetY, 0.1);
 
-        var transformedPlane = Cesium.Plane.transform(plane, tileset.modelMatrix, scratchPlane);
+        var transformedPlane = Cesium.Plane.transform(plane, transform, scratchPlane);
         transformedPlane.distance = -transformedPlane.distance;
         return transformedPlane;
     };
@@ -112,37 +114,37 @@
 
 var tileset;
 function loadTileset(url) {
-    reset();
-
     tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
         url : url,
         clippingPlanes : new Cesium.ClippingPlanesCollection({
             planes : defaultClippingPlanes,
             edgeWidth: 1.0,
             edgeColor: Cesium.Color.CYAN
-        }),
-        modelMatrix : Cesium.Matrix4.fromUniformScale(2.0)
+        })
     }));
 
     tileset.readyPromise.then(function() {
         var boundingSphere = tileset.boundingSphere;
-        viewer.camera.viewBoundingSphere(boundingSphere, new Cesium.HeadingPitchRange(0.5, -0.2, boundingSphere.radius * 4.0));
+        var radius = boundingSphere.radius;
+
+        viewer.camera.viewBoundingSphere(boundingSphere, new Cesium.HeadingPitchRange(0.5, -0.2, radius * 4.0));
         viewer.camera.lookAtTransform(Cesium.Matrix4.IDENTITY);
 
         for (var i = 0; i < defaultClippingPlanes.length; ++i) {
-            var plane = tileset.clippingPlanes.planes[i];
-            var entity = viewer.entities.add({
+            var clippingPlanes = tileset.clippingPlanes;
+            var plane = clippingPlanes.planes[i];
+            var planeEntity = viewer.entities.add({
                 position : boundingSphere.center,
                 plane : {
-                    dimensions : planeScale,
+                    dimensions : new Cesium.Cartesian2(radius * 2.5, radius * 2.5),
                     material : Cesium.Color.CYAN.withAlpha(0.1),
-                    plane: new Cesium.CallbackProperty(createPlaneUpdateFunction(tileset, plane), false),
+                    plane: new Cesium.CallbackProperty(createPlaneUpdateFunction(plane, tileset.modelMatrix), false),
                     outline: true,
                     outlineColor: Cesium.Color.CYAN
-                },
+                }
             });
 
-            planeEntities.push(entity);
+            planeEntities.push(planeEntity);
         }
 
     }).otherwise(function(error) {
@@ -152,8 +154,58 @@
     tileset.debugShowBoundingVolume = viewModel.debugBoundingVolumesEnabled;
 }
 
+var modelEntity;
+function loadModel(url) {
+    var position = Cesium.Cartesian3.fromDegrees(-123.0744619, 44.0503706, 100.0);
+    var heading = Cesium.Math.toRadians(135.0);
+    var pitch = 0.0;
+    var roll = 0.0;
+    var hpr = new Cesium.HeadingPitchRoll(heading, pitch, roll);
+    var orientation = Cesium.Transforms.headingPitchRollQuaternion(position, hpr);
+    var entity = viewer.entities.add({
+        name : url,
+        position : position,
+        orientation : orientation,
+        model : {
+            uri : url,
+            scale: 8,
+            minimumPixelSize: 100.0,
+            clippingPlanes : new Cesium.ClippingPlanesCollection({
+                planes : defaultClippingPlanes,
+                edgeWidth: 1.0,
+                edgeColor: Cesium.Color.CYAN,
+                transformationMatrix: Cesium.Matrix4.fromRotationTranslation(Cesium.Matrix3.fromRotationX(-Cesium.Math.PI_OVER_TWO))
+            })
+        }
+    });
+
+    viewer.trackedEntity = entity;
+    modelEntity = entity.model;
+
+    console.log(modelEntity);
+
+    for (var i = 0; i < defaultClippingPlanes.length; ++i) {
+        var clippingPlanes = tileset.clippingPlanes;
+        var plane = clippingPlanes.planes[i];
+        var planeEntity = viewer.entities.add({
+            position : position,
+            plane : {
+                dimensions : new Cesium.Cartesian2(300.0, 300.0),
+                material : Cesium.Color.CYAN.withAlpha(0.1),
+                plane: new Cesium.CallbackProperty(createPlaneUpdateFunction(plane, Cesium.Matrix4.IDENTITY), false),
+                outline: true,
+                outlineColor: Cesium.Color.CYAN
+            }
+        });
+
+        planeEntities.push(planeEntity);
+    }
+}
+
 // Power Plant design model provided by Bentley Systems
 var bimUrl = 'https://beta.cesium.com/api/assets/1459?access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzNjUyM2I5Yy01YmRhLTQ0MjktOGI0Zi02MDdmYzBjMmY0MjYiLCJpZCI6NDQsImFzc2V0cyI6WzE0NTldLCJpYXQiOjE0OTkyNjQ3ODF9.SW_rwY-ic0TwQBeiweXNqFyywoxnnUBtcVjeCmDGef4';
+var pointCloudUrl = 'https://beta.cesium.com/api/assets/1460?access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyMzk2YzJiOS1jZGFmLTRlZmYtYmQ4MS00NTA3NjEwMzViZTkiLCJpZCI6NDQsImFzc2V0cyI6WzE0NjBdLCJpYXQiOjE0OTkyNjQ3NTV9.oWjvN52CRQ-dk3xtvD4e8ZnOHZhoWSpJLlw115mbQJM';
+var modelUrl = '../../SampleData/models/CesiumAir/Cesium_Air.glb';
 
 loadTileset(bimUrl);
 
@@ -162,6 +214,21 @@
 Cesium.knockout.track(viewModel);
 Cesium.knockout.applyBindings(viewModel, toolbar);
 
+Cesium.knockout.getObservable(viewModel, 'currentExampleType').subscribe(function(newValue) {
+    reset();
+
+    if (newValue === clipObjects[0]) {
+        loadTileset(bimUrl);
+    } else if (newValue === clipObjects[1]) {
+        loadTileset(pointCloudUrl);
+        tileset.readyPromise.then(function () {
+            tileset.clippingPlanes.transformationMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(tileset.boundingSphere.center);
+        });
+    } else {
+        loadModel(modelUrl);
+    }
+});
+
 Cesium.knockout.getObservable(viewModel, 'debugBoundingVolumesEnabled').subscribe(function(newValue) {
     if (Cesium.defined(tileset)) {
         tileset.debugShowBoundingVolume = newValue;
diff --git a/Apps/Sandcastle/gallery/Clipping Planes.jpg b/Apps/Sandcastle/gallery/Clipping Planes.jpg
index b8b63c0307b4379fb9d5e39d76e43f74155e99c3..a5098bed32e4437941cd6bfe2e69efefd13bb3bd 100644
GIT binary patch
delta 30805
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

delta 20429
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
ao2$tRvXt#=smdzWcU-cIPfzBzk^k9Zc5%i4

diff --git a/Apps/Sandcastle/gallery/Terrain Clipping.html b/Apps/Sandcastle/gallery/Terrain Clipping.html
index ed2a15cd94ac..4c382a1c3d04 100644
--- a/Apps/Sandcastle/gallery/Terrain Clipping.html	
+++ b/Apps/Sandcastle/gallery/Terrain Clipping.html	
@@ -43,16 +43,10 @@
     transformationMatrix : Cesium.Matrix4.fromTranslation(new Cesium.Cartesian3(0.0, 0.0, 3000000.0)),
     planes : [
         new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 0.0),
-        new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, 1.0), 100000.0)
+        new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, 1.0), 1000000.0)
     ]
 });
 
-var planes = globe.terrainClippingPlanes.planes;
-window.setInterval(function () {
-    planes[0].distance -= 50.0;
-    planes[1].distance += 50.0;
-}, 30);
-
 //Sandcastle_End
     Sandcastle.finishedLoading();
 }
diff --git a/Apps/Sandcastle/gallery/Terrain Clipping.jpg b/Apps/Sandcastle/gallery/Terrain Clipping.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..cb1bd06060d048db08ae0109ec7c89a98838cef8
GIT binary patch
literal 32991
zcmbq)cT^MI+bt@n2#BD7fQZst0O=rt^b(46NGLBLB|wNs3lhK==~XE~K|pFinm`gd
zNSEGQXeJ0q2_)1g?ehEXTHpQW{&Cm+PS%sm%FLWIdy<)Xp1t?En7#N(bw^)YPn+t>
zl`B;LT)wC-@Ko+vaEL1vm7yV(2o)98O)Bau98@%yOII#K<qGG2FKb^BqPq59-(S64
z`Go57or>u)j4tCp?Vro|&p!Y4`N|RE?I-T-;`c~KTvGgr;^j#5R2u&o_kYy>)5-s+
zga7P&@tun4CRGO2!nG?rR9Bg<Tw}U&(M835dGs{@yYEX7|JANsy+%!Q{l-n&TXdHj
zVD3;|y>ji^RqAUrG}P3WTZde(r=n(}VSfBX?fP94#~VC8_oV*)kav?;y}F&nbd1C&
z?esdF_7*GKeRd9h0YM>Q5gA!Ic?Cr!4NWa=9bG+rGjj_|D{C8&^Gg?3H+P7Kub+QF
zAUx>JyNJlB=$P2Jl+?6zWX8u&nfV2UMa8I+(yukOXbiTlzM-+Bv#YzO_eWp<_{8MY
z^vvuW4o_J5wYs+cdt;Nlw|{VWbWHj4_dmF<P+j})Q}%zw#dL}5DmC>r>Kp&Tb>(W{
zWn5#Trg{A2I<uO|4M(55JW~JOyr=#luezO<SK5@s;`Dm#7Av0&o}c_5X#a)m{|#99
z{};0V2KIk&;i%}ZUAg@6t}#)mQk~y%3Wo4w(!Ew<oN#QJTJ>NX@qdEdQH>5Y@AnO6
zZZ0|5@Hc_M3(Amy2^nEJ7qm5KN0A3@Tnp3Pz7?Hxv_h1B(y?cY8A8tkSPARr&ni}G
zAVg*+Pq8TN7@(QZ`#IvL9fmznQ&(xwJtj35f7r8MOhbS{rh(#?{x14Dbz>2WYUH^e
zQY4XKTTb)cYCq5NJyF=2G0dx<A6w66C0D#8^e<CO(Ny`Et`nOixIxbV66dWHdgFQZ
zO{7IQH@f^uyD!&#d;mW&KLr?D$#UhY8DqNGi8pU;!W>S<fUevGLph}TF}^5RmlMRw
z4zSa~@rDTmx!C+<D(s&r6@7OU>ka5oRIw;(QuDrFHox$m*)z!TLqRrFH<`$^*jzz9
zJt&Y8@T~>A@8&L8A3d^Et68hY$Nb4LL12z|@M|3sJ7Xx3nF*<pXPxn4N>71U>a`Bu
z>E{c#N)f8)ct<~0<GzZ)G}W!1|6`AZ7bbvPFrR(cVQx7JPT_cd$^2&(n8_FRbiEVM
z%61LDjJkN3$1xjIPoi6O&VYZ&UAskaJ%n~HV7<SdPYcz(I^=UypXt;f+Bm!5aF##5
zrmZGB8JAWVWrNCmLF!eO+mo0puQ14huB3oR^A$8DT}L%z#`WI^b*#xG-TUO&Gn73k
zJ}>xWu<;cbKG{w!2?E;<Q41U_v_k_~CR4yloo6LD+uA6g4PbChG!Xd~I+?2P)XW6#
zbiL&rXL@cyKnGgY_5~b6gMAQ#&J8Jh&u8RDeU3(X+!Fez*A0-03~?ZJ{(8RzEojM{
ztt7R>e7x^X;LDV`^70+%S|Z*CdV1!;BUX_|U#C&HskL6mK=ZlO$Dg6_XzyFnlCRI>
z6T^fzMe)_x@Eu2GR^R!#F8;{#@hT<Dqqj#Ol{~=IQsl!bH@QqQ7_uvSm}+Bd3-Qh3
z0<kWxF4%6UWmtx&XgEVl464D#^jPUl4qs8x<*LD~KA=PN>iq6P8AM7(<Yi-1=3M9u
zv_|1&UBhs;w{wl1wnB4Zol_%1GEoPJksooC7AV{qiw{oVjEHjg_I62H8`jGYJfU|?
z_tr3UJu()1{XL%RV-mrUWpfB}E1osjnP%#924D)palN|S9_)?<*`q49tQx1Vk;U$R
zRdU3uVE)0g#PSMsmf_>Xsp*0;4^}*KY5FF<KI%x3<xxPAQ0igs&-K&0@9<R-G}A>V
zP=v*VOc;kda(qN}+mj^NWx2#lnaNw&7$Nx8k}jx-Y-C9=yZ|4#okOOiYQSz&GCDJ-
z)5*Lm7gUknvUH+-VQ$r)fS%%P8PY_lk^i~~903sYs2?;qLvmzIEc!zFi-0OF>Jc6U
ze$M`Tg{cbUkEe3Xa;5SjwMOQ@O_QH_#K|?iaG;lPZ^UpZNv7qaOaTStT{Tiz3<6vR
z$$3aR$|{Gac5^fVP|;`!dI(!%aoN|UkNR}FGKrkPDRIH3=A7W}7_ep?4N(x&XsBfK
zkMLg$JdDC;OiU$|aRIwjnf)B1mumyw;Q?|0a5wP8_|%wG*WtiU3D!BGiK?ut3%kC1
z2-R3=Ik4hjAx1Sg!tzdqCcR;P@dI+TQJcfyfOiL+J*rr%XjPYFDr3_6kt+$+88&y)
z{boJFpOFz>rAARL@_gf39mY>gJ~FD6?}o*`Nxz_qRS|}dA#_-Z3*AVJ@vV<M9<s)*
zoftG?NtTgcHeWk%_rPLR?<0IyS}eJAdUC{DW~%b`Ii_Hh)0_b5*J=-jiZ<k4brx+T
z`avC2woa6WXNValXO*k2^+5tEQD)&$E-W#fqa~!+C8V@;qL-|g6B>l%1bo>bl>M__
zhKeu!w0c+sZ!6_z7e*i*yD$*o>{tQ|M6}TyRArgQVQN&&qc>V$XFs0*tsdv|DlMe;
zwQU<{IkfA7>f1;s@pZ2bW$S{9=0Pi2^TS5Ko1U_u6S>fVW#-ecFJXmRG6A5+<Qu)l
zcS46}-b9RTY{3B8=jr$p;+2Cl^>#7Y{a<<v8I=_7Bex5xa9&C_HR}Zx){0mmSH}ll
znLt>Pe2;=D22q~cj*N4d<vXVqWWje{z>@bDR9z$8AA+hEO5OImJ9H=~KIMz{x|VwO
zx}5<(=&wCs(bR2sqQwo}ccD&ph8dFn%y|FAOl-??4yhk)(gB0PLIRCV_4V~1oTC%~
z`Efcq1c;5Pkh30N`rHeKU)K)W=42e{OwyI4^p$rMlyCE7r8(~^Tu?#qz8vopmMSIg
z{PC)gsR|Qz3rc|!wkFeFo^{hs7H;$|*1&F9T`vOIR|4dNd-1A3Sy;F#NjKYn2c1o~
zGIM(GTIca~Yohb?`dN;u8#m|g_d{GA)@uGfJ~xQKpSsWk3a_Uwr$rL0D>jlZiN$k%
z#Xq|AyyJqZRwuq$<+8Ijl1bY;EBU>UuMm}o2tNwjiTWukxxev~DX$L!Mo%$bxzV9`
zs1qh{_6-e7FquW?x;Nx*AH84V36j`8zM!H$IV)>(uZjbqI>I6y7?lmVyPk=5{!NY*
z97U)(ex-PtD!C*^{C!`Co+zqLwVgclJOM&nCj1OVby_AR^03XVNsBUzsxMm6e*;(6
zx7kl#oOdlfcxQ4}-R6AxXJ&?bpZ-9G-A8Z{l9}KhLkPFZ-k)24n)wOK?4I`5$;X`o
z`}i_D`5q3}4{pWoN(}2U2)#<roW~QPk4|++VNrg;tZSd8GAE8$zgzaa?wy->k*B`{
zDpd-C+BR5N#(OiBviC?eVSY|8I}mQ&TN21dXteJu3>WFkKKO^QGT2fnl_T;ZeJvj)
ztOP}I3S_rxQyMN&&z@C>-iP3JW0&!EBi&)qq4!U&7gQkhC|6b(sY54o84=QuQk_8Y
z*bu_*0|fm{vwso%^}Lk>ku%GjY`P(}*j}`03Z7fkcrs7=955baHVoYX-E`jH`5E$T
zoJ(oDOsP+7Lbv*@_e(XA1!D4#4|=ht*AqetNUBF4$YI};V{*92%kTWF*ePx%q?s7M
zWF|2cR<b1u5B!7SW?YnAOZ8{1D544G0_rvK?CVczmG9ZuT~l_yrdxHw(Z-?b6gH32
zR|+FakWj{ytd+9a2v&y&=l5paxv#5wN!${#`Hj^pq0Bi0bE7V(&_hdEjzyGslco!*
zh^o%OoTp^%+DaR_GV*%I=)CL}MX~h;-P_N07IB@9s}Eh06NOh^-6<iC7_;2EgOry*
zUC*ukivRfaloT!F#=bl^ppbkwMqlCcGsUU3Rlm|clkyeM_OYW{zbB?Cftg1iwG7o?
zulo3?e(d8*!Tki;bv-^2RW_ZMdC@Hvc&nsF>oqGslPxrkN&0%fF~^V(CeI2SI9*+;
zm16QB+%CtUX1;v1-15j6#@Ah5h}`a@Pk!{#kUR5RkQ5lK%bR#XrLUrVLDjC>Z1a=*
zCcKGoygfu_G&n0gzy2Hfijv$N%15e;lntXpm{Tmi*e<r_(sSQCXC68$4aT=THEwOK
zojBaRk5DFacNs?r2Z!O$M0N=biRVRmpiS;fEV&ORi1S)p(PP&ArNMiC#+T61=k;|)
zN?E%0{<PZNA%>Q!%#%ghDya(L(Fj3tn~Bme7f>4BGSXhVK-C45m95zL`dFkJn3Jx#
zF_j>qZQ@`S)jitXJ{)P}4Hj<ic~NTE=c{F2B+K!BE#53z#`H7C=LdQG0_(ZMP1-4*
zAKm=BxBhU8^(cTWIhjpIQMsIUgFP?NQj0+;XK_#cEb~~#`&#&{UBUiOzVC@aA3Xo_
zp?{OZ+Sca?!YeJJb1ya~@{6-2u?Ve|dt3&6AX(9&gAC$uMRLae)M9Fq5r*AicyRoI
z9m$4V%!hDH=hBzenj|?0Y!vc)+XqQJj<R_19=zD+%Qk01NCJNpl+=x}#6#soAEivM
zTyI@Alwa0H=3td>?z*AhH>Xs5HXC4Rrh|Hm5&q>(l&C0rkDJAb1?<W6uye?^#Ob(X
z3a_>#ZQJttcpk;m&3+8>eQq#H2ukTAesD8q&Win&;&UZx&CQvmSs-X-@lKR$R72zv
zZkY(+`0>|&&V1G_M^t8CoHal|gI?U5RhNj50UNMM+4A%Xea;I>HTd0~HOO7h^l0%{
z^S=W?Nzq$35!oaWV@{S}Po!o-IWqg`38Z&@{+BK}$aEWHBjH_;vL-jUU!n((>0~Ia
z!#1(qP35G6#JCCsht<MtW4txXM|i-6X5|u3PDDDXpR_Z7r9lq#$1?F|a}sIt&$jZi
zoUYNPc$QY?V=-7bvL7sJJ;z@M1S-0QZ~in0ot`G^1o=NT=IdF~t3<hbQNK`w(O^L$
z0Y#kuT;reCMY7u)rs)3OdhkJ{Tg+2N^c6L7@K#JswLvnUcRA3iY7n^tE*vUrqGq<W
ztxG-nQVW!sUR^&Ct5_8^z)laXYOs8*mW&;ctq+&(OJcT=5bV73r{+V^+uav|*B{kX
z-{*hui7i>0+55#YJoA@w6#RQ4GxZ*p?^`!#uDHh4=eFg#%xhudg8OQXX<SP$!inhF
zLb`iw*P<kTN#-#0*yxLCZ^}0$I!E`%rUVAj_3WL-i*(;tw0WlbH0!RGk1{|!9R`o}
z^$-5%rM1?#%x(a*b;QXz$mL3ZsZ}J%S1e*Dd#<kx_^cj2Tliihkm2)(bacv^45sm&
zcZG=T0X8Ka%UT8X=gS!2TEHIr82ih9=Gk1_r5_LZDhmI#RJ$|jMeO34o*4lDK25`&
z=wV{=aTip*EqmW#rWQJw22Zy+9qItGz4Esp<N(XzcdQ=%(-%yN%O0U2v6!`#uTFh2
z(<0IhoA~SP!XJ}c(S0F-f3j#HzC!W(X)W{f^9F<k_2dvf<MmGESIw{I`#fAV8U6j;
z_$RLeoh*n>*np@l9fN73^f1R#_kG)q#;Ej?xh)P?RH6Nn&7xK?M5ry^x@M9$Wqix9
zsjj6O-2{x`a>2rT_>)4EfHBe!2?RZvu9mwp0YAHoXBQ=MuV=gOmgqZUl7cMn16Fc~
zl_}<|UyS%$8j=SW1W|wvkgcwGrp5cKwb9r;H>WjC_jZdUYQ{Ty0UG{Xm_aEpZlv*M
zVU4&jz|8ws-<-qX{I^fYxnDjXoq~%zoBWe@$Rl$s$jd`ZL_0xvzVQUJWom{CrX%J!
zR^6te6#t!o@wd6enXyczoonU?mqZ>Cx_wJ{N4%Ca@@{ub??D8vj~Lm6&Ur(>bU)Du
zgz+71z*w^M9b;rW=<0XGb(=p6<ih-p_q$o@k-`$ZSQ8#KkB2*=1F6p7CmJ%+cEGEe
zCY7DDb{)vz^`@43%~-xqYiNi!>s^thK4x1G&bIprD+A4U6pM@JLV^A&Z&MSJv!Sp-
zcOB@CPr-3!>*HKSW_)Gjuyv_8J+8TVe+U$jF{(dSc;w&=_G><Bi{QS|`Y3c%_0Fj<
zo;wOe4{D2(%?i=zded^&xna*pVhl&f<Igx8Sl~0g59P=etEVa~B&*I{8p>-KGA!Aj
z7;vmc+KoIAr5iG~olNO;0{%b%NNnAzmyZx8#0^pg-XVM!0VA^!tYXlY8SCk@@q>XU
zK^0pZ=XJhR6Mkh1+9z-#>(etSRpQeLhPr6Kp!J-?9RNTpP4$ZdC#H(=^e!nmuFbja
zE$%$I5^f^fWE}=EPFiA{24LpGJRD-|*{1TRv_Iri%8aj0!{);9GYJ(AFDPJq%R>TG
zlrR$KSMl^HntV81U7j4F!cGxAU>5)?55KOk&{t5BUd^)KE}PVs@)Lfl8YPubW+=Fw
zrv$<ILmWDXeXW1;-jak6M77CA%A*Bz7~<E$iCRccqAb72L_%6fzd!1Ry91Xp|B2{^
z;P=bSJbC^f%5WX1=hF&oe#8>H7s|60${up}gvk#!7ub3Jh;)doJCUcTK=m)EY^DI`
zq91M$0V~f`7^ye0pycg+h+u*WvxhW->g+wjnKcj3$g;&W@2<jvJTaINkn%uERM|mF
zJrQ2AaGCj*yS5XRFXIrlYBYV=w%VGw9eBmTY9_#PqN|yP;J`o$2oc|M7!%*|_A4Wb
z{~AIyZnwr8r9ZsC^Z32@$Fw*h1BgG0&!<~D_9b%V*rC#)MxMwNL~eUdna_t$m^G1>
z%6?W|>0RNH+BKRG_kKw>$_OD8;Inl)t)9$piWVu4ZmCF-v@1|c@bKy2U!>#ks%>#)
zT^D!9M&b&s+kNHyul<tnH}}O<9_IJVRP=c$1T@@xCF5+-Ewiv`S!TE2aK7hJp^p)1
zdpEF3@BPnZ0<|8Kh5||4&c}Ocxi5uIuvqjwfs}OI6Pifoa}=ch-E(iFN|_AX?k4RT
zQcMVmw?;aZLaPWu%KVj!*6^$sqi$gwTlRcFE;H+iLm}C+r-@EMyAs}0vYhdvL&nB7
zE3xP-N4Zpg7nmR+Af4pf#gQ8?Gs3VXJqy<k@!0v92<({|qnPPo!<m%ptO9X4RS)i{
zQH#Q)yd6}6<I};SPlL-g^6FCmJ_(U{F?p)E>aYMI54co;!8oO*PH|Lu@*T19Wst*$
z*@%Bw`R@SMqgxY{Xu~L-vGw|~a$e-x=893$Zb!2tzAQI})oO{05?KVd#Bn;XP~rwU
zLCZ%B#ceM6^ElhzyTwaOt);B#Uj<54%3Z!qA=nv)lB0+iuE*tvTtKUF|7;x~_OvWo
zp_4OR%tg$6Jt;}<YnKwn)2IR=_LX06rpTzMz%nxfp!eckI64S&s?!kHzhZBWiVAO6
z|Ll0fNHXqd43;%FTx0qw#V3u$M%%=;|4mcDzFUuKtx-HF_atE6u8!=#_dGTbpUm0$
z^Q7-ounf1P|2HHNi@I?XnU=#fRpB46TDvS89fNSqump9t3?(5)P`a{=qiwT_%JQUW
zf?ZOh8`&!SU~9;@UA}QW?x01YJNFhsT_)_NU0*&tt37sQ$gLLyJ&G>$43$eE^sb0!
zed%2}0qCC(bWFelJOAD%9boVHFW*1EcWOtj%q@23xS)zbJSqL%%01&eHH^Y<EoyY+
z2uE9zYBrfDp^S7(1B|gQNk`|n>&e?7BJn&MZ<t}l;WPmCEQl9_f*9|d-X_b(sYqz}
zkk<N?9e(Pb+7ZemSZuywYbXsrb7?&?t)dT>uh}hA!skt<QDn5e5LsI7==bAvFJ?oq
zZH}F#uGek|oNTa9|KQc3&xeY*ZXKq9=%bwBD8Lw!%dD`WM8Z*7J@HMohjL}1#Vzv-
zsxURty!4(Zeyc=|Z$;YX5;312l$lysXo+lyw6&lN8}BWmLiK`!up1U_zmvCbT;3wj
zDEucZl-#2P%voM26~cKcl>ZcbmM;s1bv5QjoIbrIf7(;rRc=nqp#c(FS@_gtiiSE#
zC+?I5wK0uzE&aKuBy82K)M>wY{+NvBXu--dZtwnt5ou4v&X?M#oyf3`HWtc_mE?}x
zhwj2RVoqgC<~KkS^SI3?xmdUrLH=J^II3yPUo>zZddZ<sGJuhtJ$5`fbNKp<)46R-
za`+`%u--Xe#YkECu5yLqPtMgC_d9tev2s~RRxxjI7)ScWOGv1Zk|I}j8Q^C6V9}Pl
znj};>(F?GnERU~ZW)M`HWb!gQaaYR&2i@4tCZh=Qr+1T&x+%~V7$d@rq>OBRKz<lo
zW(Pm+xa&Zv{jMTGGAg54ZRW=9Z8U13l6yNBgN@p35T5u7Rf7p-ufGp}!EU4C{VGIy
zW_~X|V3ktnSFn}!YLgpCTaOtK^hiQG8=5CiDRPTOthhy`0ccS!EVn_ij?$kkY4D-7
zAf$6T;g6#+C--YV7va6W8B^Ptcc~UDrh9G8r~twRRqzGXPi!s;wv<dF7{`WTb+*yV
zjLo#9g6E|3mX+Oy2)TNWut>B7twa<$#M!<DOKMF=Lx!N`T1B(Ja~_Pz#609&zO!iw
z^6yD3*cb?^w7sC>ZM{x0B*VHmV6msZq|VM9p{ep#P8&5s*gX&X2k54z)DBz-+6wn&
zrt%k>ArJ+IOlJxdl`VNx6S#N=^qVGk-KuMAked>RSI!#FdBNw47gQwe3o4v+?{ZBe
zoR?6T%XEHqtL|^WhteQi)Q3cNVr3`~1bfYDw0t+KCzN%}3!znlP-@B58_PWD;ebW>
zH|Y`4@h8E3ssl}Glom2~N2X5fDKEZ_1D^4mbR4&R$RN?BB%WTrY02SQi}Fx02t0a|
zluI)hFhdsz^Q5U5$-1j2o8~lb<@wqf2IJ`>kQF$-MS56>OjK!0T9@^UG76jd|1+fm
zs_0Mi=txF4CTdrW+|>WDPG)7Ji|QTC=J1W;WQtA?I-y~swP;RPR5L#tkISgd)-swf
zf%YQJ%v5G53@1+TUOci4e?i5y0jjLJydGBEA`<6nC>VTMG+U1Fgt(Wu%vJ>*fi?Bk
zj~of?qzq?;b4O!#F}ktx10jUY1WVefg5qaaCzb7db}y*zUr@bdyb`+9%0yc3=AJ{f
zw{la|PAuRV+9}3&5!|HD)2z8PVGsw7-^bEmO5DoN%4k&WMi_0Yq$iXCTU2x^G2xy2
zU6uLpxPCPB;YJ%B!dLZO>upNe-i^-2q2a7j@Zxu9ab~}xFGKbzlilpn+qP##tLQ&b
z!FuP`u5or_y2+TaQI0ba$~CfdJI?r>tTETd9uN;Uv|h4?&ws}Sl!|4tmJ&Sm4mlU)
zxEOV!2rFIooRj|94}bOIgBxHo9ZQcI#$}gjjWTbeT)u3*4r(}JJmH9_X7}bOLa6XE
z=@F!k77e(pU@uEX!&56VrUOme3ExIbZ?RZSeO1r7!4!)E=Zf??@y8@%yVTP*I@6s@
zF}lT5Mjmyx^^Gv==^~2`-*-pfO2sTVq*0XWQupIbuEn+V3Xm-X6qQv9Eb;(ZmW((D
z6)n$~>jgn%bCKd=m5<CD;(pty55VLAxG`^@#MN>@b5rS~hO4YdoG^>}Le}evxwCvG
z6~KCflyu?kJZ2$26^l_Mf1+Jm!N|Pok$c@)145Kwe3?oz`c1W*eQV{0>)28vSK#G>
zqe~9Bm7mAq+sdl`mGD(Dj&r)*`=R5Z*G6}|5qc|7Gab@tE~#GS?(e_32?(pel1o-I
zBi=tZW_jpzuV~=vH>j?_N2<N2oTV<W5bIhoKT`BKw7r4S^G(r7xcfXz&s$~eIA*=%
z<mrSh+6gOy+GZw4X`7}#NxZbN3AP2sY>}S}I3{<?-SnI97TBj1{k_e|N@gl$J87f@
zX|rrBq8l(M%T!3PK1+&sx@KLXzL`mxeuYB0X;+Uh2X!3h+u?6PH9?-9)YW%Ny2o5o
zN9yWLla*8K*zJDCx_n|Le2a}pY3H1GC^vp>K?t}?bgawN!?AzV5Q>w<x+ch|>kW?f
ze9+~)j%^);x?+(}uBGyb=GW4>#1ViWztri;G(~w*T(w0^$Hq4WqfOrG@Y*yJQ~69|
zU3=&7cdqL_`ZO)W)Ev&LX>Oc7$Dcfal!yEZzp*zvz{+Y0bS}jnPa@%f)3S!g4M7J7
z4KI^4_|uEF!vk}K1XJ2w+q#}x*ZX+-_|Qw~UF{2~0@P($Jkr4|IA7Piy9j8vloyX1
z>s|e40j)b~h%RT+oS@G1{AB$VjH{*>6`zhCv`O{+<LH8f+{ucTHx#0Ql5`WkbTy>k
zg1N{HC9pb+SqVQH47}a9-W>R#YfSMIaf&a!KrDfJA|<g2ZduHuz?U?&m#|}J<6Ng5
z&Hs|AHkRM!{$rQNSLqPdoi*hjURpOy64;nOmQUYb9&n^4vr4w5a}0j?m?_J|K5dn#
zf8zzksdwGwN$=AOs=}xAu@4n~3QMyk4_-;XrB4Ql#W0N(W?Hx`R_BL3aZa?9<ym<F
zbaQTciA<?|c(u9%_k-<a8J{L1D^vQBT_yY5r}t{(mJE@|@r9t&5Tx{jL~0)vR(s20
zC{8v<x3Jc&!Ofb;G42NZG<YWlU0Ni`e+p^bgZu;Ti#+VA=5*C{kxRZuF2N?bxSP)d
zaL~qv)P8i%jb;octVTo3iq>n~7+Q?$iL#y(=i<GrX|uDoYkGrZD%I+;O>ekH4xm19
zX2DmQGP5gwk?gd`yy_w~1=ePWlAQ7NyZkktAG^;oK60(OB&KHyrSyG|T3Q~408mj4
zDZydw)#xHmcMrXLu(P6U4dX<UiuD>ep&>`|r8P}=IRpm1{#j-+PC;dK<1Uak+AtZI
zNURjd(GzTJ99s)wK9Z0yW16*_U+BuP3>>wSve!R0;bR*%UnnZhd%$cX40&HZJ-(>!
z+7P8FtpR(J>`2cPR5zV^mOo6l4yjzzjQYFDSz38(&L|ef_bLlqO$XxJM|!ef=Q=A1
z0l#2%mUHT$bzR`k5n@qJ9C+QkotN<DZ7LDUi2I@!m=E;j7!Wl#(;tkQH$2PjMg7SZ
zj4t;+{8Z%_e)DC#Vcn$cmN91Gx1}Yv&xK=1+7Mc@DThr(f0*lagt~gW=4>ot=R9h%
zLZnv0UNnN62;DGmapqyZNxwhDb?iHHDD95S2?PqICJkkaw>x4Iy~TGNHL<NWV(Te3
zGBK1E)f4r5G1l|Aq1V;wJ$QpVGJ!nCA}-BH>xhZ+qzu>9*2#bQ>I_YC6b|YQGv*zt
zb+!)+&c{{Js_#yDSK|MmjUzY!*gEplmEO4W^875b(bgLXrExcMZx^`jHi&;7q*m!b
z@l|gitw$V`>^K6K*|!>1BgG6dI0`v@HaZ-?uK37EqOEpCrxF#gxne;%wYegx<{Lfx
zrJ^d<+NN)KMJQk4w$Hq@+&uh*^$ROJF*JovS$f0XW8sZ!sV1P>W6mS+S*(o1Y~A_I
zKje(_TbyJwljzP|v>UOyQ0+t}v^Vs@B-+|P1ZY5cwlZYO_4Md1+3$^gOR<NBZZjo=
z<Yr7M_!;uFtIeg__%=n}q_$~PcGiC+Muk0xyC+D-;@Yj~jdwG9Tj$EDna5!`*yRW(
znxQxc^o`D3dV~o%C+ULfRwymS(}7|~%Ee1WA{3!NcO$uJnx#eOZEYwL_@#e~+P!1^
zHV&$2DXbDq@cs*`?i~4P8OB?1Prd0=PlD(`ut4$^G~(Cx4`si<xg&q>sLoZ*!e2+S
z<DZxd^-CquNml(E7geer0eRi(X>U|sq;!bloInaxJ|4q7)NBKcY*{8Ep1tWe$&tUI
z!!Ei}VWsL*QLvp~p#9k|v%o0zYfIVZ+>}HHxVZG^+t;t~UYkg{cBgg0#{qucpD7>J
zERD~N$q^>o<=bqeY_KY+dxjs1?TTRxb<8JrW%9gex`(>EYd3I~b(b2)_2}Tn8GCeX
zYpQX))wh`g<4>y9!&XeI=H#9r#r9#<Joa9XzfZL}xKN#S<HSmgS^3g}js2p{LZ2_R
zc!Vn{y_6Zc19f{YaZo^=hypKy?Kd(?%YI~3CZY;WPnY9lEgd?hQq4@dog^ti3R+ES
z1KB5fssWOrLuE35vI|%<Cx(7}9k~11)WamTz^KCI`e9lg%gvrUbN%~PV}(^Ai|4hZ
zuH!cm@}ZAKOWprMiA9*<TpzLhq2kUG2+ohTWEtoQ<C-d(I?Ai)eFOOCle0Mn6Sqe2
zW0Mc8*~6;b$ugYU#S9DqyHym>^_hmIoQtmKQ(~@l5T3eAIV9}GH_Z8uNhE`8&T6V|
z=H!M?Z;4irILfEWSh+6Ko?+Zu7G6|4jxhwjAayysjPI*yYs4TYzzvdyC78(c?R~W?
zp7B{dmnzF3Ft`LJm<}aYBur;0;Lg)ato!^~^Q7%Nj*iC{d+Mw*xFNOSI2@P$O}7b-
zqoaOuPS4u!?|=zIq@lW86p$|7X(nu7vT)I+q)*s9B`!Q!x4vZWsj#pr=H4V2sJ%Ec
z?qQK8tZml0B%0kfgv&Yx2<E5p<sgj!Wv_padlry;<B6wt@fFU!fgNXToo{3p`>nzK
z1~qzL=RwxLanD-1pu;)h-Urz-o@#?wy7f(ujGE`XEvF^Zst`u5Evw7{comSe)>h<k
z&V6}iya58xyN0y+8(V=z%ZlTb66OB<DO;wEW9Zds@xv^r{U%{rPRZc!LzG*dN2A~t
zP2_nrA&kxrw6xNtBoQw&q@kZfINBgIHID97bVqzMrk4WQL#k*}(h~ElqxSj<!s;6z
z7C<9M$<gOZp+C0p6d1ySwE24kA8g2RVl#y%y6%9ph*Ch!hSnSgxwT~j2Q(-o@*l8h
zh*nR2MKapn4qZ+PjcoVDm&*y>jTnA)fd4pEb|3E}yV39hbyJ(^=w2bF(}_!W;5b&@
zLVUxw?DZtc_lIk0UUZL(g#amM$e1ZQQuk|;*>M`qGSWi?pz5|Or02W$3_lh+7<z|X
zTua*R4CNuYbvMz0hXf7D-nm5xVX{NGtZ4G}&Bnya(iKC~oBmv(Bi-0HX;w2&76*bo
z%iJy7yeGJ3jP7hIGy&UURi5@<Qj97^gxwfWT~zDv`TfSrvLF)SSYq9N%kV~wN}tr1
z83QHDm}7a}qkVTbb2~Ad*3mOI<A!P3r)7)sCetdXXYVTz8u(pW2BQ^AY=%~|JV!?K
zLGb)1Z}0Mh5amS>Jk4f-vkV9XG8lJ7t@MuzU_FC_^L#}0WTz|q1KOT5XivQG{No?&
z89yZ7y~O>HgY25<Q?y~KRi#m}+~s}fzCL|E<>pT6^{gPq%^S2q1<!a0_p#4wrl;Uh
zm3mzbEmqMT&gMR^iymn50vRlkEQEVy_;nE(p)-$sQ@^ufL7Y*}r6yiB9XA7FcRNCw
zWc21#a%U!^{eEp)M(R&)l;Ah{?JJC3ZiGV2zLfU(@%<52w<rJMIssf#23o3K7gV!3
z%iV8`x97<Fy{Zh&&sH@3$%2tyy9JY{!eId~Ck8VY>^Z0NTE}H}@7|Z0w^M)@7}nO3
zuR;W%09o0Z`kWhota=|xH<5Rf5Ed&<XR3PRyQhu>sAsoQR5qR{^^Eg*b=%A#XSU_h
zyyp1hz<0p$iX9k#ve86dK-BOM4>q2u=W81T@#YLEQ*{exM@jC0h6sFuLQC!KZ9MAo
z_sEZHrvZMwtrL9jbjJB}jUsn{rk)Gp0y4@CJ!&_vPaDb^3Yt%=T%9~9BdTaqix$&q
zZ~X9I95YXxyFs~mGKZsmB)`$1{Zwp7*jQ>H$c@OqT{dKP<Zr$*Ag(_K?iVpZxBQww
zq(EwWs%{+!8edCHEA9WRSTd1rk5CmO?&1%9Y!}T;yg~Z%x*=UX%4ky-!I)V@rSH4F
zw?Uoscw>csUf+g@o!XWC-W5z0KY`4F2sc;Z@jVX}GX;8oI0fZJt-Souw`zRLkhPE2
zdAQGq2Rlt;qh~7F^()|U%zUo}p9EH+EdJJF$NdDA>o&g2tH)G~2EW{P@bH7rMWTDy
z3fC5k3jePGZ*WV&vp$_BsQV{y?Lxi<Fa#3Fm3fSuZcGVi(;oZla&q^4O!a}XA=wvy
zhKlyvy+wJ~#eKyeMtvGU(JG~&fO<0A*Wd$3VN(ZTEbyD~uK=Y<+pW-BQ->kahNRqB
zA}WQh3HlVAYxd4=bo`m?=Kh8RMSNzP>1Xo4OM(=MlaSB>C4+PBvxGL-1r=>4Ik;Wr
zp5{bRD}|06Xo^P9s0g0Y%v@06A2zp)A7lr1G-8McOzr|FgQOi)KD@WxaixL8(v?hU
zC(RRJ388fGEgf?2JBgm$@(o{9|2$~o1$v*jo@+G8bHfXn`VqgNrU&(QteX@o#!OZK
z#PR1}E=iXZ?)zv)ib(W!$R#sIb7@ymM0iaC4lbzf!oNDi<kqpB-aWs}4D26a>s1+5
zL?EG$+Q>J$mLvblVJ>MKHfyk2v0=%Uoc+@Y<;Op{uUrv~K2<xhK7CHMFQQw7NOFIu
zh=zN0U}-yPHAIJmJ6`<KkMD4uTvZUW(=9VY>3=O%XW3L!II~+3+_vZODU(2b@0^=J
zN+n}HlS<{X{8<q6Y0oMj0+tHDYRpYm=u1Hw$MOsfP1lRVc;4T{X#*bPewze(ImIfg
z<)tY6(&^3V54Rp)(zc!?e&9>%qZc1fjHJB@i0Dsw$J1FG%D<GPz922afZ{O`)}v3@
zK^2nOqA?D%p1A19Q!CVvV<kM;qIpy{`*r{j;GjE&2A>QG98H*FPUsU^rm}|;stsY!
znwB*m4aTniXmyjP`dlyaLElR9{$c`h{Oa$NWVxwyr|0^SnTvU8v3B|I1v*;!@Jhbv
ziajqr^9va<8|q8NdzhrWDb*^@d{bN=qAK$;?aO2yUlF^YzYsbTa%k-L_sb`BFGZ_#
z8;kVlj9(vDK4o6Nsw$h}q<Mwa`g9;7^M;tI^aDe|9UhZ={Hu5Ba?wHWyNU^tar7y~
z{g<3LyH<qP*BlQu5lwG!pO61r$5=;IH#4TFY5o+&N~eF7tE8R#*7T&`^L$FbnPS7#
z+0y>fM>)$|h9W+xwc4%xL3;?RbCX*tyXZCojT`H6GZW$Oq&6?TTJDl(bJ{>1b@!Sm
zFQW*1U{Ea259i2&6alfwsq{~C9e=)dCpEJ@K?B!1>3^~@$<I1{7=J{J`Snpuz|CrT
zU;d-B`g^fR9xdDXl3!LCudfcb>g^FiklR!#)*X#Cd~sDgkM`-Y<dVC5-ifO~u7$DA
zTjk>-e}WuDa15yRS96@B*R2>h9iKa8{Sh;y^6Rk{1b-^_q<s34Mr>$GOt73GSkLrF
zt@rx@AG74~h{k^^PT^KC;6yn2e*-3T2YZi!<_+-25VmCR)F1TZ!M%CTQr4s26_YhM
zWnmcg>-$7P_7~Q&Y{=V^mr;R08tWa4M=s{(^-^juUooL^b%Qon4WFl9yD!B-YLd=f
zY<gi$^SJVKoNCQ@@O-ISB7d5AfeWXU8bftUtaD?t^rDe>r{2|a)@#Ns=6Vqo`SR(R
zGft5S@{&XM<AHXDsAZ_jy=kfBTA-V3bH;cfdn%FbHLmw+qakbQKLa6eLPr1{I{Z(<
zFpeRtVKoc0x<$l^eqhO3a4@+2^7+NOL%Szl=q&SukG{haX;Uj>6j)GKZv)tY;jenm
zyVX7E47w6+q}kdSC#smYxC#=ki%b!9z=DceB5`)$PQN7&oe&Asi9$F*I*^`eD9{Z`
zSJYmM1wL^+`i<_@F@XXSlk(t8PR)T=WctLv)L<VUN+ubN_zH}7cxIJp0qcL&Si7A_
zHQIopu}P3hmwMO6SiHQ0kleRk&o?zgvMuTV%FD~`OKb;jXB5=68&d?Uh_qy^p~$(R
z!_h}dG<W;i^_^v-ac}geR_4%QOO*$dLvn6s$G%Ndh_TM}VO7kz#Mwu;Q3<p=yI?Iz
zBEgT#6ZB295kqEN;om7le$${A(OBqwlF<ITRYP+~b)G-Cupz~*we>9^;w!<t9-BfC
zO3_f#Y#T$?l9oG^*tQ2w9-RuD54FgXLi-x8SCH+8k7nmUo2`75v&)obnX4QIZ7!Xw
zwA}hR(%lx>s6{*xV-wgiKz3yqDlHKlnlF<bK+aRyu9<M#S!FIAb?*mcRD9)UA$^Z?
zqP&spibxWRskfv_!lrtmifE$GXvb>(8|mr$%`QUI;TdA6s4r9c&Dh$sbRG3kv&0E+
zBl8sn;GeF^;+BS-qhnKKz@%p2!{DM-;=u&A$SbAKZ^9TbXvOTo0H4?tm#|pBYt%C>
z<cOTQpwdvGLBK{&?TW1_X5DOKkR`wbaa)EWv9sgqDZ%2B(lPD%O#3t{3tXS=d}*qM
zyi7IC@oyeqYu0YTj-N|W(n+<p6up(OI~1^KL%91k6t~&?!c&pxNPd|3=CQkkmsqjG
zvZ7w*_}M>=^_U3^9r#2SBjvZ&m^@rzA%F>|U2=~|u6~R(;c5bxlQGTA#>&`mPqz<+
z0qQo)qSmM+I4fP+Ljjx2HD&2fGcBr1>V+lFB>$Xre*M>`3B?T+rgzs~m9g=cQ8tE6
zGO9nhz;8buD0w~9=o=yG_(aBH;ob^s(fw9%hl!q1+V~veZiH>vD>1ZuOMM--?n>sG
zxoPN&w`@1tq|rXYVhHs9%Ot684W;V~Dv9-^Y-Bn<+jRO^a|WX*J0xLHJ^C}J`>~<a
zz>Ad*GxvbMu7#>~r&<;L@3Xy!3fvEX!G8{(HYJ+)c|tJDKf>NQV0s!zbF3rXe`$8(
zy|nt0b*6Xx=YJm#(Kulp{Y&gN6Cq+bf~-9{Q+`AN-{M6s^=UiBU2id`y0L9ldlioJ
zaqerOqL7(XIA^aM$Q4yUkprJ_M=w39{x*(qBQW0Sh34B8ze8;(W&goW`73xIZ0sHa
z9NLpBAb(wux#dgqVu?IrZPJ7~X6O2(Rxt2dR25LD!^C3CS6iI&w;E$(p5~&^lk||u
zyrkblBGX@x)3=CQG_oFi!h52Pl`<)fD-|~DoGMOhcr{J=nJbpA|9QeJu`<OZzOMN!
z`Maer4(_VTFygNgs{{`RetOwV7RYwHo{RDrT^NAmd$5M#$RLmdSUF(mS!E&7(Qh;g
z$*cUAE1`Q{d#3d6eSYnx6H$=5Q%fx?Y2a~8Cv78A8~vVZ<S2;1T(~E<)%T#;a@#NY
zcDtw8aVBmv2QY&P=Dy>>5nAAKORvNO`<H*H#v{yoYzH$CWXcI}vuzo78ob-@h2hMa
zZfXb@g-QjP8Mk79_j%2;{Z3dLTT))`<+shP8%l*_0#vTi556DzwcVJ>S%+lz-pNrE
zXgzf*TyRB^_3WB-bQim|w0ef-w#K%6H@EQ43hLq_lBoNAg_A8yFBgTuRUwCsTfRRI
z2jW|J=DW&5$~IcLNyU-n{4Fyv{8IoZv_gWW5EQZT^$JULw4X6%Y0=(L`RF(!;QiwK
zlG>XA8K|$l^G|LZw>nvoeB;O}RtCnkft{)2aNe-oEi)AJgs_Zb4rVxVvYf;G9gkdV
zf`jnr)`_9sEa>$DnKyn)X<;usL+MG!34VG|WwU&c2QVazzok3<7i%35(5U5SWuD2U
zYYW*QSvM97$lqBIZ2}A8^zWbMz750EP9Aa@uQ()KdOcei&gVy!!-6mGM+UX28l;S<
z4BJa9K}O!@lBk^vL*ja@vPK9YTPGwZ{m9NrO-`u`<h9q2e6t+0BX(v>qi<beepH*T
ztZB#3f#L6qPS~_8(w8dvBVyj1_NS$YP`alm&o{1|Ia#EC4}ZV^j!EFEZNH_}s|Yi_
z9^v`);-Wx*zlsA?1hfkAB#*x}%hRXG#xv6!1t?0{{2N-z2g)fck!)_(C>aW-W=-w%
z``i7wF$Nfmny7$%?qwM?)AJ<Uh(iRHyW^_I4@HHW^{4~h4^?hPUe7Lc#}eq=y*Pp2
z8e%JDxobT@EttH-OLr3A_y}%SY!brZ(p?pOE|9YWkXM^PFFx(X@wZ^6Gq^7u+t(K;
zH}pu_m=YcOI-k}8n%rdXT>yrCS092)M8<yc$n=99LB{tr>N3o}Rqw0f%m~m6s&_Ic
zE)&q=hmWRLTPFNYB0L?oTW$kbXAFWP+)ag9cL<8R`CxMsK>D_Ei0{*q!0_WL8nFSn
z;om=n95)E$*+z`WQj7K8w8x={Ww&;|>8}V!rSZs@U-iWgh4p}QlWSeWQP-|10-2QV
z37grr4%02zZ$IX+&G>~FmYHgqEZ=2K*FDX1A#0divJ`*0Sx>D;l?@51R1|T~6M!2q
z=^k>~W(uKS2hz@?>F$oO=Tw~w<r#Z9?M1{-VuGu-&y<4e#SX!JFiooqDg}f-_wB>v
zI}7&kYsQo4UB-SB;z6RtwLX+2_8kxB^rVDKBlAMg@P>jKt+_=C`M$9MWrf^$+_hIx
z$ok=Of|kxdHP)!vUk#J8!9aoVEijq26oT3q_XHIfKidO+LDyV5iNK`*zj;v^&nnF6
zmmI!He52=V@q7I)bY9j~we+Xp2P_>Wx6Dg!QQ7)9w7MuFBt;oP@W71eB(4`ohp4Kd
zcSV<z%8pBW?i7h>Zcdh2`i74Uq~_@9jjY(w+dCQ|(k*nAa>nm})>QPg$Q66+Zk#<V
zldjP7#8l6HS>)I&lSpcr<ol@gKwsVQ@fF|NN41~1bF>$_B2VgXC{WK%xasl7F?^3@
zbETzvxx=f-Wn?T^d>w9U^~|>fv@nEuEq?#wj{zmo(yPW#R&?A`9xZtdntxoebTt6D
zod4aZD5zU}+>q_WR6gV-SyRiJ5*YjV`L~XjIcCa78#IHr=h->5XPB}azf~GZTdd7{
zWXp%V+1C@d7A=!4Pr(!vsH8-hSlw067FNTr+<(0f1l#asS{cDA4vfKlPdSt@#G<JQ
zEl(LKaA%8M(mJ@WqjLVKxu$Ct@vc;7%c}>wKIh5zGU$%#PVaIa{Y$pmK0EOb9ad#V
zD2B+W2#q7Oz9Ljekv(}3?%2l@{FKf-N-}==$Z-q<!$LC7IcIc|51+|*VVNOTV*>@0
zEQjXW+GN}M>dA`GJ2rA)dyQ2cdY|s(93937yL?_`@J_u~R(f3k5^wP-g<)JF7J2V4
z-H|p_P8A3KsZtP1=$JR4w2=CVI2Tp7sGXUfMiJ0*AD@)X%^3q9l~U@D4T&z8xQ?~y
zy-Ncgp0e$4VB}QIF*KFU(SIv_qBvc#ZE<h0_k+EaUQ^lTNJ+;;9&)U>>WyE~4MmIN
zZ0%K+pt=IzfJC(ZhI`2TW!d?K0%VM6^W0*L%Y0T@3(Gs7YNJO;ka6r7A)<4`WGl~E
zEtmo(Z&{?H`(PFPxm~IcRoD?~WZ8rzf9#oH7sz6&8<S-KP2J<*OR<3Pnr3yRAr-36
zOPvymYS@{8x#D^(NZm^ndpZDD-7~;_@ZoaMEK*b!fqQNQADD2kcw02Y`DYc8X~p3>
zysV40kN%FG`vn!ZGA{~V_Wds(68S#H(T?@xXLQ#y&Ef6P=^Owyoj1Z2n7qzxV+j_*
zWA6;y7$hotVr5)Y{f6GuEU^Df;LHLmP=^|ron<i<?)Tgr&f&4%erWe`!0O{al9agA
z;Hhr2we~fZmzCR_uGY3M56~b;$CGynW(6$T)}Q(Oti>$6lpWh@^Zda#jQ%cXTm#cr
z&S&h`skoZgf8bbFfi~&U@A1~0mGGs=NbaQbF|!NQ2aUVN>D}%Nl#aH3uSM5~(Z)XM
z8SA?l^}Lq&@<Vhscdjhj6!?pmXJgEeo^0gi*6^{9=QR0QzFrA?1#*5cN=8artGKuz
z2nLC<-y=+|Jdx?a(Sfr*PD9L$HRXNzrYoK<%9=0U`&YRLDYW!hs!Kp1h<bF8q~8SW
zC^xvHR2Iwg;wH^B{I@($J<?GO!gua_X}qj^zsSz3tLdZVt-rvwXDW2030O^$M4mux
zH63S#4Q8~pcf*Z$zQ9*FW5YgBYuuWzOHP;fUaVVN!1)^Wj~brDq8`3Tn%RyL4TdA>
zd|miH06BX78}B^|`Y<@c^mNV1Ii<Gv)t)q_98!-oSM{Ea3DSI<k&dIWy*ZdP?i}U%
z-Ra72hnEAO!Q^7d0R3kjK1(Yo%h1@qpfh!j-`*@}-bQIaHr|d?k0$@wb|bPBMqP>d
z-~s_W>@|p6({&9OY;Ka&bN>3+6Y?dCzE#Z~kBt+mssx~q_Ez4D^;~ll2pLM8>Tb=D
znU?2Sm}`fwS2Szm?o&IsVzX$u5?+-emjeBpSZn%tHTW)7%$eu25exbZ3n|vaJm9RS
zG5qdCpQFM_*1MSVVVL&=zH`k!u1VHoDQ<L{)i<_J`ylcg8ynfMt&zN@)=WG9wjUE_
zUIR}zu=$=rtl(;f>HK3hY*cV*KIVOxTRbbIk|(EUE>8g5lt07fYXc4`Fihk=3T^@e
zgD%y@siGuN_bRrL2-zas>A;a`9mBI`q=^yeCQW9(+C8Z*u_8+WWN43OnXfzSW$fc<
zznOr2!$2RI_d348VKO81$h{G<(Rjy_xvsL3_P|G(({z|yl<CJ=zcN>Bu#w6G?!;{(
zU-%?#e$$C&xT2Fa0p4W_Ua%c_MbO<TbQE)%#`k7boN@nfb=mg9wR8nOF@yoq&lZaY
zC5q273ABcTW0;5<FL}uYW08S1yJZcij7Y`FAC<9H!9&=IHm9Km0XqB%_5Bfs#1`Jl
zjNpq^aizb!mP47~ck%S&rQQa<hCkghAE`V~5lT!5W(X5yS`ceY$ata6&?SGA!Nzt+
zsmUQ03fMU`H_RA~&QW9~1ph`(A3C+>JX5j+3s?N)o)+wxrP=M?jeGMpru$(TnXX5v
zrST(9((5oJ?8W4Ej^wZNO(3wuCGwq8vr#f<BTK+pQ~Rl`QrrAtW{bYVTpD4Q)Pb5=
zK)(qdW|~1sWVZck6|%~fPca3l=MTC8FzNDdP3(?J0diry`vWU(+kfz|1SNy;bLxp^
zunWrA6F<W8ywG-I{4)FOg9hI`n=U8<271LlYbLjJw_t|9_?0E9tnCFYlT!(dov=Fy
zq3NpAOONZFSr192AU3%TvA+QY|M1l{<l2&s%4EI_G5i8~h%DL8qM6PLUVLl#HgRYt
z<;e-#cxWf>`|4TadBNTV)#0>!Y%4RxiXa{>5v}ZoC(3t$w0@*VRu)jD%^S-WEyml=
z+U5aUq)mZO=bPZN0Ht8?iTjQ#IQS!CdSuck@QS1F@nN}G=}%v+f~vkZ*692+=ePub
zxc^QGflX$G<_F$VBr|%Dw9G-Mkv~MJ=STn+P1n!X*cTOnj6?8}roQ1wJgwn=kKd~B
z<-{iG;SV7noZWFkRlG^Tc1l8H_WQ>25U;(ve6=A-HkreUb$ru3HwiD_E6a03Kr2>^
zVz23*>J^3ynVgo-&&RU^G<|VdlAz!i{y6!@NpXElXZ)w1*#*++Rg)v}4kUv%wvg6+
zONwYEq%r+n=d*591j0&cBeOelDEq6ib0H<LD;CBdxwZKw8Rt~XanQ;!Arq;DkjF(X
z<`4KoNII7}=i3V^*4En|Y>lejxis*19TJ6`6-Ar`vPUatDhP|Q&U`9yZ^N*J;%4T{
zQW%f;>vCR6w(ADO$J3Ru13XE}>pVkJx3(BR;j?duLrhDGIMO`Tr6ZmdiM)p@_?n~G
zh6aTCeIi!amqd@es#FK0GoO@Y5b|trB1OW2MlHg9dL@_TafWQ^WSxY}%RJ!@)9^KK
z60CPQF^8rRt#X@^UIBSBcRBIE?e~$P59C>POU2)XOW{gRg?$Pte!v+L>+9pi0g$?j
z!nrOD^oce4T~HahtCCEr5;??EFGa9-KN(p)jzmIxFY8u{{oj3y28qBRv1Rw%jwN2w
zR7FvCMN1bew#{`6rzjVcW0Ofc*mm{VLcpuDlrS`Zefs|j4?pn0B$g18JeiU)YSMqD
zF@gytg^?Czk9!zmxO3&Lt*zZlf3(eTZeHS40yd6j^COD&p#oSDQU;#hDNJc^EV98H
z6)I9T^8~R*-!)$>%keJt@OXNXZti}{F`T#FaZ#L>uSX`lk5$SoT2a#X`Sg7{>VCI)
zZ~h96sOc8aO|E<y({)WkKPuk#?!(7dS}vJ1u_DhB+UdHNf;E|~E-m6zQ|8`ZktLfw
zwC^3wq?I10{{RIc@CS)>O>e{gCjFm$>uqZ9P`S9%Us%w!ohh#Gq=xq9d)+@*@T6ko
z{j?;LO>t`r>TPcmI@?H+MQ`~!k?u*+?d_3_!fobxQcttMe97URS>3J{ReNHuJ6rvp
zbwZM<j0B+fFEr^k;%2m+Sz`>ScbIKs^T7#jBAhfa31^iNJfulvOR3V~tIwAWWX?)!
z3ph<Q)S-#RMXO7ha{l?K+FGtut<uD}QE=ttR#$0Tt6Mj_TYIhYrmmM$^`HJ8O`z$K
zt*jpfqr8Vt)2!?xwSOAfXlT(GxB0gJ0NLIb)RK1lEtRdkvZc<Rijo)&ywOPT508E(
z{?(o;_>Zkks?7rF_qUTsFXFz`&aGpliLS4<T4?JGa8Gq>ZEDaMq(NtLw=&Nhi9C_Z
zs7><<!5gRVBbCb8w2Ag6xw}P3)-esO%9n{tO?Pt>%poZyq*KXqVz`~5TFl*;Vz%<o
z+`%`LCRnYaiDL+n`F9ftQb}4@bY-4Py_Uu%Df39PL+WK1Og=?YwOq0b4_>?@POW)A
zZ&|`Ew4qYJwVfSbyy&`adULs1TZ0po<@mVMSd22NsY%Wel}f6cmDaT>#&M@s-)Gv!
ze3$oacYe22@dl@Qe%CzK3>l{q3wajid1Zh^*OJ^p=Ff9!7+E)3$#NlCq;nd*)UjSI
zmMyK#)!dVPo+!#W^I5KAjjZ5>q!GWEw?cb(phcB8J@d(LZ!#pJXs%Wwav)v)aE~HK
zgs#^rT*(?M&E>kID2xDQjyOU$lu8z55gG1{fvu#snTk9s5i`jPBurtqjzv{zV~MvS
z`C=QaMB5$~^S{yMZ$_>!5naD)Uad>?l;z8{w2k>zi=x+8z0QhQY&{-TPK`JvWq83}
z*ZymBY13Ug4pt(0A(^0xS)!BAnXRUbFAXdf(ON?bqRQ;6X9{^R+eIeZdD;s_H%ncu
z<$;STz!@ZEHqwZE*scpnz8jlK6v)jGwwG|46J-EU%wzL>l+X)jB$ta3k*%kiNnyDO
z9Pzo0%iD)DTG`7k8Z#8~M3%vxVKdvhMJ1)x=<Kb&!k%i#&S6-kQE=W<qDwT%7-dLh
zbqy}ylDwEGgd8FT(+`5g;#&4}+Kc}Hmy^6;mwVds>F_B%cDACgi^Jip<u@jpT#)yq
z+k07QA6dAro7p-k1-edr)qAL(-t`t(CwRh1JU1y}b#HTfV=K*P9HQFg?3xvtYhqy+
z8g2CQ&u7zkTJBvRQ`7G(-Jq7z=HB8Nm6%MD+szb^%(CZrk~10<U_&Ow3P42zo+B-e
z2Pc8Tf_n}?$8St@9V>51jI`kHL9ur#v!Vt(e4~2~dFVMf?lMQyW!NfMMx_1vl4(k#
zk4@ZSwdIDFmG0&Cosx?A{L>XIRT;)hlADXQHLKYx%FEuB{vAEtlHI@QL-ywQjK3Fu
z;GcgPt#q4PXml-Xe$C&smYFT$>8Y)Vv|Vn~;Z}ijdmf#r>Kc8UOQif})~s%=Z6<ZJ
zmq~`&W{UpPP!j(DF_McwipxFA-OP}@(>#V-XB%NRHl)WAKbs`5hK=H%KVz2O(bSS=
zxBZy#kBDsVf8d#)9@2e5FK%P_bE9}x-p)yt<+JjCYafB$BWr7M9?Oe25nM?mafF?2
zVASrVdF_R?Fx`GF#9~KSX7Yj9#9Ykt$s3LGv|lWKXjr5(mX;;+5u}M+O>P?Cx5z^Z
zusAFp4m{2nS!S4OPD#d6qf0x?l_}auO4EzxP2ZV&$+XewWq8V%_m9O?jAJ^ux=v~q
zx3pPq0yQ@3rxvWzYi+C_YLTIe)@!May}P`zg_2nj5@vxengMVXVwugQyk2w=7j;1k
zHOdnlXy~P*EY@oYhT-IN6G=2#Vq_bqc#`7f?c)suOK@UTo;c)mnGcgFnkZY!nY{Sb
z<BnLo=@JLHSvDfd@);rpVo>r;AKD_G4=f^XR+=K_NZr+JH`t_bS~TM7=ggAw;9Fb$
zuIVuXMHrsu+DXN@eUK;m6WmQIiLPYzL~Ds)^KR_tzDXp&X0}0N3qvQE@>}nZc$Ns>
zIO0^_wWL&pM55Xjl?2FsZ!+f0GRKH*4CXJEDAA;Ev`svoY>ce({K%eRK2%8-%)@Vq
z)coMc1kP8^TX@Kh3GTDzGs^cZB#O$AZHj58@)kKBV#^!9v>MdBcJ>e$8O*T#z9gD&
zDgNfy2^yH#4dY~Jo7u{!%>Z^wZMGEqMc9M}iWj(vljmEB5t8F|%TDVXS-`JsfIyyA
zqf2Kj*3iBEn|%06T}chRUuCyg?c=;;I2wAw_Loy7v>sa{&LoOgy-BuMOL(?$MI73N
zv=-Ivp>rJmO30R{>=9p00JBpR*VhJUqK58xL`LFBZD+c)jNHv}ED3f}S(4gU8dF`!
zvMQz7X|)(}9mVCsBvINyHN~6RSvw70d99_kl2~`jRW8yCi$Mg^+dvA@-%HusRBv^s
zp2U;hTbLz{n%-NRE35XJd!@R2xxC4(tu*^<o1nI7Cz)kycN<%!yDT;`rLDQMl*pQ6
zBC?j_0`A&$y1SCbDfOpWyqPAxzLBPeSf_?ti39ns43kIXYKw7Wc&01If<#9{<WF;P
z4YUj;vz}X<tBaOc*>6@)DX!(e%1+kT3vDFg<+P`TrJ7-R3ftT_*)A-xL1i+}rP$3q
z_MYhv+HP)baV!^*-c705Sq)MPN4ky+DeU92cx2P$xt{nfl$zzPi+KwalWNQ7_z{~e
zO2AmpdvB@51lo3?sOfF0Y2w>Xy|u8O{@Yca$lQIl3(Q_=bJ%KP&P6wOc2a5DvMh~u
z)}PkTi@aB+{7}=r6nsL`f=O@U&)LWJT+}Y-iZ3o3pAbR&Is7iuJYOnfhi~{x^!<7(
zi4X4@>N&*toJt4sccWQfY8N`rpxVWboZ3F09;JVDrQt_5cGu|*y^zy%>#1xnC;L<o
z+e->Sw(B$8%2HH_C-krT8T><Ui=VL9?B+Esa>ic}d>Og;ulqkA38k!YYMMWV^nV!-
zj@}yaE%QS+mbM-zxc#C$L8EAPUt@sU*?1;Wms)~MlE?cGgP52@JjdW#Y2&a8bla4z
zd?fj&6rl-4&HHP`)Rj1>Ms|~^;ZA>+c&A2k$*?%Zeq0_ml4)}MIGTL1o4k|djHxKK
z1vxi3-aM*Ok8K{F9%Ws<Nar01KaMlry>r5T6Bj{2kCT)4dUO5*{PnJG9XPGR<wym%
zIP~@R<BxC3zM=SCq^-=bB!~zl6y-t4BnHPLws1X<sTKVTQiY$w^t*a%bhNs9{JQ9V
z7OV3?EB0S2$Ja}AfAIA*--V5H3hcMuSY>`pjz>n$4hS6f!NK<OKaO7pwY#qgc=CNB
z!R_^*4MyJ(G&{A^o5`9<t*>U*tf9G*SYo=>B$_V}-fA{b$n7z^(wbCH?T8w0*w2UG
z4Q=&XSTSs_89^Vr<L3h{pME}J!0D0Fy(3xpDJ(Gg@!9S2_e&X!9m)}jQm=u*RfxKf
zLgklx3={DjTf+DrCd%;{elti{!{TT;K|W<HMI@=Y#s2`$oJBeqsPf)2sfU7ggOpEG
zE6uSPZYG{14J4;Vtt!!sn}UAIT->dz-BhPKlx1eG3X;0LkL2H6{g;1a{{W1B2GBfj
zulyp>^xqXprd(WW7v2bm#9j%STdU17O;#qe(flhB({*WOzmEFaYwr=;-{0DsduwQ}
zE~0|#%lQ|?pYToZgO++z-Rb@*@$<@;GL0ts^HlK0tESvqtN#F_%YO!up=r}yG>o21
z)>fL;oy1T=l1BDo<9mLn>e@GmJ{4=;Klpp%+bhonc#-a<TU&JyHkYEk{-C<T{{Y0(
zOEOCynXGBT&rgd~wJ=;goKa104xuHz&5LH~9tei}!4}$WrL@uCXty(2>h`a39n+iH
zHrxyNB#K5^bj#4r`fbEP;F8%w#Ulv#{zmYxEtWrwzp%5KwPjBShs@Pn1}b&n>ea%@
zQjI9ma*XNJk2|WAd43lwUMk<c@uqo*qr>=2!z!HU&l6V%&x^zRI*_EL@5#3)&J(9s
zl|t{CH#Dx)nwR2C->{{Qn`v;X@h0Z)Rxw?OrEdy7u9do1vNrNbWB&jNRmIfOMA7P(
z5=SPY);Bko)=xc?>H2iqUZdq__7eDwuHE^1e~bPfTA#Hoq}Q5@c%sTN1;$KwmlpO~
z9=u^yl*%NI!Z{emo7Ogzu$%WQTljUP=y0y1;v3s*I3H>V?j#n`k2eA(XOOEgFY>XC
zlgnTPj1-9F^KCc7+C%F8O}B}3%^y$HEuxwW{ZMKW>GGR}hFcW#ptik|6LSpgR_5hm
zw6<Ke+}6m+ApP?&;VuonD-B6PhARt3Gp$Prjl|;dxM)|Cg&OrR9@iC!adW$;%}FWp
zwBIaUzc#}0zZEM@R;h}F-#s~Ea2R@6dfvyE+ft`mjvj(d#>w)za=9<JC4b1BPxc1*
zk>Qy2>Gf|BcphCZL$-oFPD>p_S({Xb;^pn)lIu#)^(#*b>lgNBc7oAwn!@KySDjXJ
z;^NxvysGQ=bbD!I68NR3NY$E16GdfN8c-HjB3)+T5>|}3Mvf)&$%v|-ByRqcd@bT{
z4d3`H;treQognzC!&JV~H3+XX&kpI(MQg7^2lgJhZ5M{@w0o}%vT8mVCh`Z>R^LXy
z@fU?`d`&BOpIFiKtukND4;g$p(C#JHbw3Yk(P{RO+iH4^mXWTTscvps9}vZ3ZJ}ve
z)vc_lsNJT4s9EbRtaz5g!8RA>$6K(qL#sih*lQjhABA{wI7}2?B9=cfSUNJt)0@ZT
z_?lJYPBE=ord^7j9}`BEX{k<+H6BM76$#H(A6G8po*>2JvsyT+H8T7?9A&T-6+9jz
z4O<OX5S==4#nO#P)T>7Fg;x0`%&y}Y@=B-XjnBdj0?J6)t~G0+7#?I-S5UN4kh@7@
zwy8XOvHt)pCyA3JBPy{|jd|gHI=~TWV+=tYx{!gHUj;#ppK~ApuvJD1yPT?m@1Lpl
z-5yA#c#J!y-WOzFzRR321IpeTA%Peq5J3d)uO`-X=0f44Wnf4u$jWon<S-pL>5>8G
z8O2nxoDBrs3?&H5TS-AVrmeJ{<sDLbHEr7JeH=3^U4CC{UaZqe+0IsyeR)-r()N{}
zk4+Dq^&27_;9%z?j-2}A*!Jn`RpN=-+@ah;u_Zq5_d)079lQSk-y?HZplWs_bbyVx
z>ckQNC#dQ@`*b}`a#Gt#5P0}P#X|3WpkpU23yrzlaezraz?JiAQB>sK`aj8APbcVh
zPP1`}Td76s+UxQ3S}W_Z%N4_tdIEZL&-3fgekyq8c#h;|QdN`{Vx)&wRv#$@f{e<;
zqah)(xfJJt_b>`@8yt?|xg7J@k6esnIH_Z{e1~=UKn$Zlc;KAzkVhY=9D>-vD`>jg
z&;B3NO-`9kJgQQE*Gpebbl>wn$nZ~!blnT~3;n2UH3-^I5crehzwDji4-KS?G+uXw
zAH)9uw6~2uAzE3^t`<Wlh&(ayt@S8U8Eyb=DVl3YcA35wn&?M)JFH+>w1y#Sv);6E
z+5NcO{hv1XfJ+QliW_8eG;ZtWTTHXGbJyr+?L~N>4S!<a*k9l}U3h?Nel@fB)%$7q
z@58<!($1GJh4tT!{xY-pGvM7XPqUid*81zi{wVk(`!D<?__5*5T5|2EX+IOB)ilZO
zJUy!EGE4dOFnK5Qu0o`cEu)w%3@-$bT&S5<9b~z+hV8fcr7`6h8hDaBd#FT5=Xio?
z;^<LJTs{hfB>n42*Og3kTIP&ewLDxSD=t}1Gn8DTB`51-l$<cNs#}-a<15tUw0*}<
zlM640etF@gQ(t*0+E!_xm+em!c(-E;Tg3|8LoCo4CfL%XlG{xxw6_q8*)4>2__q<;
zvRet^vXWM$wv$`Ua{-P>l*8uB8xOQKua?<(uKcxmEoKoxIdy+6(4vQB*v=mntV;2>
z+HGF$;wc&JjkUzBX)M<hLe|q6(l{Fa3v!of<oVDd&2I#feX!3By>>;nXGzdpx|yxf
z9jAuh%#8z<^JAG~en>X{RIHP-2b3^$bKxGq*u=<}1IdY8!wu-*?No+OmukRRM!^}O
zb-7^?4m`-#e<Eepv28WrR@5$j&nem>i7er~Q36JhhVvH1)i=tLx0I&~oZ~D>qiN?9
zlGt0jJnDsGic)`f98woCF_6a7jnJ|rX(N*icH|E+l4wHOTmWvSDDj1kF&VdX@<N7>
zZ`$uxRRB2wL3CVTFgZj3>?O5|CJ~EOOJ_?tpm}X!mh$okxw2VGINdeGav33L9qe@x
zCERapCWd&P2w!y;m{eI6j^j{EO+wYKu4fV2!S-oLwJyzaP+rE+-9)j=6}_qZOcx3=
zsWZ^LwO7-mxP!@;?P(41c$MwrMr(;-xRynCv+}&5ZyYl2g6hRDZYFDcsF4;!O5s{a
zq)9J;jV$A0Ck(CrkrLj<H$@;>o>h5qG{R{nVFWgTtz?Q=((h|GxucYqX1X@NBGlU;
z@}Y%nqPQ<3M<h#g9^W(1ltBvIyn^0nWwt<Mb0o_55!)98T>YnhIc@G|W|YBgdZ}_e
z<<sqasZ8N+BejSvt;MyK%S(N5ZjH&Zv9OB9cpc&S=B)I%jwgU=kVy6`BE_c3s%@U<
z7UJ!%QquO;&NXPB;&r^bHtL4au5J~J%3+?euWx+VrJ5koNp9?HB)5s=FDhL;*LTYz
z-0grOO%%rcT1gV(8%sF0q<0sN#djrU?AEEbZ|l_CxYqT1T`&7O3%kf;zm|CJt*x)#
z*23*&xzn#tn*f!V$GILSw*m-Qg}I4s-q^)ov;P3_Mt_S5{{RWk#vj>ZUDWK+{{U#O
z4Cvl6_-&(DUFuT(r{nLyt9^e^@SU`lwi;#d*EKJQUkv<B@q55N4bn8}CYM|If#Tl?
zEb>HRGcV$8oOc?H)H0*p3+Ic<5t$-}1h<Mf*1}lbuF$Hazv$B2+AI)R!)*)}h<?_V
zuy%e6@qdfH7yLo+pNu>quF2tF8+Z@Lns19VJ!abE>AI(eJX7J#V#4OfR8#gldz)*$
zA6C<#yGT;v<VIkf+TJpfNnXzn=Jhf>=Pu15cCeV3PNWv{qc3u@ifu*B(v+MOz0YW%
z<eFAItoJOZon<)ezIL`MgrOHL6e~v4qc+lV<&9Xu%awC-rlQknpV#}ti85ChJwFlc
z*Wa+<@x^@$@Rso-zJX*TZsFhY=f64a->(E$j@W!c@Q3XQ@Y~_1?LYA6OVjjk2mEx<
zW!E)73~2DI8c)Noi&`sN*nDF6TWxJ?qUic&kEeKV#gmT_cnia}jj7&gzXg10@S6Vs
zTGS@h^_!(mm%;j*X}5^rmD=ih_Rnu@jt{<T`*RD3!{#_#Ha`yIIvBbX>(iVcG-Vo*
zQcg0mQcG@aQ%dpoT4(Y8CXIXsBNK$gCmPsV)1g)mMyCn#wI#1By1kv+dOcG=cK-lp
z^JjZ)YZ)nmh&dySZ5(m@@#;=1?`vNKSzp<s1X9}p$mg6XR&jz@fB+nhFmu|!8$JO1
zOj}p84LDM!JPp{+3g_$io<SA*@9_Ts;x(Q1j0DRYA1!jZUBdx;4te~!?bLYr#vc@^
zDwtTOI7!LI$+n%BXSKH3@7#28HoSSXYR>jo*`@tG_3eL#ziVIFBf(!4^r#@$>}Q8i
z(ymtbM%VPFOHFS}nPgcef(xdOXl}IaL&`|CJtI<v^GVbZA)4mN?<}k?Z9feBLHj6t
zVfba@T~1#P`2PUH!p&9);hSBv)kxLt?aRXjzM-Sq3tckPQ;$h`Y?oV~QoFOcn$J#}
z-$~Htj%&N0>Z{@n{g$I)aQoEm85!pp9Xa>y$FHcb%b$$eC9Lw?vnrgf)5_xju?MGL
zpRogv#=kw!cn2Zk3`Q3@#o)0REb5ebR%exCF&TC~FO!xsl}Z{-M#;ufi<;$8=22}w
zt;)EMFu~xe<?9hnz6PsY*i2n0;wZMK7Sv-_GD%9!$tII}+nUXPHoiK#x$z&3^qo7$
zws%?@==z1Gfvi{?d2Z7E<B)0xSB@6a?@o-SHvY%Cx0CI9eAln15v%H2T=CzeHku}Z
z;_YVpN7A+Z8TDiP^J^qmhU+<&;KgeV)OLw9$pjNiExaFVn%3SaTIFCdzCTJnA^1N;
z)NV=C^qo6X7R-Ln{h@4=OKhT4mD0}j6kb^@zFMq_Z#aqL`6hyN0c-P~%fYGeljA++
zxvxigFN1EZ^&1}uc+XLZC5p=TQ`7X>7fbO>_R+~}rA1+BWv^J-YZA?*T3(MVE}N&>
zM?9Bbl;F63ihMcE)oQhJ-2VU~;ym*SPdCr8-(QY%fy1b(bY3#6#XL1SH2LfMJWSN-
zI`t%~`yX#gC(&2TGVJ3ERpC}6FU&Al7Vww~F~iFPR!QDV4@uLM<yLhi300>aM(D=y
zQ<XZ5<+ZN>+3Brw_T57E?3I!^V74!3VIs^7a>X=JKEW8l-3k(u<rRV>ZhsNhn(Ir7
z_8lo8x3wU$NXYLra|ryTxP^C{Xs#el;v2QL^P@9Lt0vaS`zypLr|Pqmi%`>U8cU0a
zhm(J4aFg6xE4Abb@Ji6U_A!w){31q@(lV1=EHTNK@;A2dG1T79;(L8Y>Gp^qd95O}
zo@wKSqP7?A(;F+vMdhcGvszqv9%D&7GtV4)WZzrGS+@t}*lGU&ZDMe>Xk#ZFD#Kn_
z)rplC341BfgsM}7Av{DSRpLFJK50^QCC%)umPriT5mFw(RH<H!eY28Kp-zuGvyzpg
z?@dyaX{vFQ`BdW=G^Boi__tBkZZBtdx`)rW2$N53VPk77hCGP8$zit=vjEJl!a&j|
z%P*RtRCz~>bam9Mp@Kq*HHnPdw$g>;n$L8I(nJn_<KEUZ-5Zeq056#ehY$K)seBaD
zyh(Yc7ihG1)vczxTWjqe>PTZK*Ov`s*X?%(k!c{cvl6bW2EBQw`7C0ddwoGJG|PV$
z@rQ!`AKXo)_<O?|s$N`O+}LTC`jqqN_E20+J(ABRrD<;RC8QP-PkU>n>8t&>a5Y_0
z&r^!ZSp|g4C&4cg_!&l>Dig%hr%^>eXO~x}3@tcv#y;6ab2!E=B^)#>a;P}FE?fO2
ze5W{}>~S8-j3-7e*2UqcI?|~qtHKd{^LoBzRa25uyG^?vlp5xg@U+0->~~z?fIwn1
zmH>{2j=x&+{ZmhrZYhw%<^&Am=rD2!80Q{`xId|F`!s60iw`CNeQT=7);5<gME9zb
zi<qrsX`qrTOX%XZy^=e7i>U2pXl7`(K_qt;($Df=#E*nJ$AmSVW5aXVT*Iws_xBoo
z=AU;AwwDn}3EO~|ky}l&P9}uQ1-rB_8+l62gXz)DGF;xZdO2=qg~rsO2-T?y4pQZ%
zE?Z4au35!56(<=!Nl8XrveEX^%qvigKDC6ehIJ;X!PbgVoSb6bmvYxun_RL{ZY}J5
zf`(kIOjr%TF~e?S(<Gi)s6F}uK)^Na{{XYc!JT*ZlKAED!{AqjuUAID_>1DJEhAU)
zZPuNr>e@fU?*`hW+PB0HiM}PX(xIC9JQ?u2z`A#c{vr6^QGo*KeiHE3wX01mHuf(%
zx?g}_6Pv<1zr-t#4c*vyKS#E>yuH?SCyK@uj@~lpB8uVC@^!tqXzX<Pp|+CV>i$Cn
za)T7l7q@&mzLWN5{geEE@vdm?bpHU1f3>BDiGBh61RAE3A=W%G@Fz;UwqM#u<5z~H
z)%+gQY14c})hz5kWv_?75PT2f*=)6K4F1`_4ZK@pZ2D||XDuv75`NxFyed(`Iel`a
z8jzQ=j1qIErSC#GiQY8m!lk*Z)TK$;%^vJitm!&%{pD8(;gq8#3Du~*%9gZUN>tL7
zTC#^Tjvk!mlW}P9uiG!;_lEvC{?Q&f@wb5`)nWKiqQl{Tg`WiUpAlY5scZTdz>k9d
z5YWC5d=v2QyMHjX7y6!=@Wa7g6^B~Xtv4;+p*_{vZ?xXMyk9g=DortXgkhMr9^o#Y
z=HotW(%#P7ZV{xC02$5;Z)VC#y5*!uRvotF$K?5DEs{tU6*nnzWoV7lM8hu>rAd%L
zkh4eUDNAVOk^mf*WK%q(EyP<uov`pMyJkr|z}SvIGGOo$3<1@aAf)_8CcN=jiuj47
zr(Ue;$}ztrT;%1+1lwv5zbq4O(MexJ?J)FXhoMIgPVN+GQ>7O5lZ+yuoSI2FJ6=sC
zc{c5-V%F|kcD%QNW11Vge=cErZKu56Tz5A2VoNC|PckdBac)XYXChBEsG7xu_Hx|8
zG;>_q%<##!C2i8Qk;eqF+N5SN<v_8cB+7_mEYmE;;!WmPW|~PFrM$Fg9$RUIYHX#F
zCwL`}=F)sm5(Sd#&Tl2wL=p#<Db_b}h_;0?Q)6pr(Jod=qB}&0lOo(jJhtpJ9(=To
zl_mQ=+iB9~DMV`51~ifo_!^L;aa<D=0tRA?Rz0_kEP<t9p(Op_Su*6N;;^03w4||e
zAe<8?@1~A63cFHto#a$uya)2(l@;>M=AbG>zF}lnEtjIG5xR+E%&@203KiOUb!ftG
zKPTD4x0f8xAy!l>e4y8&Ht8BksK;{B+^?Msr)n(L>P@;dO*Mtbn;cR>EwFf;LX87J
zsI3bM0O_y3*K=&*$2UghF7761h}_ojN9Ww#Pi`&J7LFISyu3HI>K;4T^(JUc))8FV
zUA@%puC$v^vxT(PB$1-Oxsy;&B*M1pwpaF+*Oq4cOOOS;w!gg^l+j(zz}#(u_AA?-
zb{l(%EaLwFN^ul1TE%M}-kcWVWx5x#G<L-W<>Zh_d$!gkxAQG$l5aM7EZQi7-AKx;
z$zcSyknEZrIh|VCNVZNcKHTdi#PNCGV}np>X0W@G#XO5cEXL+S939)W-~0jzru%4M
zmXX16=EvpB8s5qUser@wXwq4pPcBJij@+={6xTUhd92~LMwam{Jn}5MrM&yC=YO_b
z%@ym&mr*RYR`9*S+{Cl6u`O~gEw5ay!L||H-q|BO?Iq^Pe$g|CuUU=$nJay)Ta=92
z+{I`enms~MJds+gQJC%08;?5rD5Wwy6WU1d$!T#EQ$=?z(iUl6Ha9o+^T@&C4+M!6
zSJv}EI<sA+g~GeYvd3(IHEpkM_OY6?yS19jA(Hms-N$()#E$OwdYy;amTQ^7Xq6y>
zSs7-yyAv$;65ULZE6maA&1-q9>NbY<^`}{j$sOLKB)2fzt=#*rZ|@${?K8Y~+JwzD
z>jawSQ*~{B2ijKkE*7XyG16!zxl56Ab8Ta%T{I&8J4odpV7r@9duOncMP>5!1iOw8
zwA;liTZpX1skFHoTBVftFdbHBhV>svN!<gj)X-g-WW0vaFD#fZ_C%@nP;9PmqbWEO
zTWQAD@il&}dKU{j-&g6U`Ca~p>L2_P{{Z&I(tl^)9qYdcJ}=)~581!tAK0!uQL0*{
z{{WNlf8sTySDHV9zB3DLGRIJJrsx`mtaM+AIx1-zrRRvg8fsd#j*$oaCi)kGZhSfY
z6nKlm`nQBNi;X8$wp&ZsBC@(sZ*^&?>G%46sby`eXu9T$tLc{)dQQFJ?+|F$wi@S$
zJVm13U+8`!&~+U<T+uZP{VMv>@^9jRY4NmjtjR1g*uW%NH7l5{?iLnndySZqR9P;~
zm8I0S(pp0WwagKuMBeImF<PhZpZpUu{t6r61@Kpe{{Um3+W!E==SlF6nGDc=&Hn(j
zj-_X)TsOefzPq=&Ux!~7Qr_C<R@J{}9~EnQ=h`%#O2XGr);<jQgHgEgUxzGj{4=lk
zyTUq;?fw?{ha9EHhqIZ>`#!Biuvn?NH-wzp{mV_Y>|CETVx!Kk;}<5V(3j*MB=99n
z)k{6e;Fdm>Kla=#V;HP#AeSvv(oI){VxZe@GK!0QmZ?zvqVPwKE_6$naWg8b4y<rF
z2a)y1KTlfw{{Z2q?Ev<%!moN%gaD2F9tR_lpXFbgUMKLjvEc1???czDg_fmZ_IH&c
zy0gEsyR^QvgHY2oO)pf_XS>q1tq)q#uI#mq1H>9V<@SxQ=$HC_wWD9(=~vd5bCzBw
zxYEiLk$_zFV~?onIVX(t!1U+(QgDpp8Pk+!38>DT;MAii$tI;27Sy98(@kj8O=y2P
zDve8$ag-++I8H9{lw_T)E7_)+Yh8Cv$L(F;#}vP@`EOOj0g>i%IP5<6Jv*L&k&$0D
z`1i+f>IPlcD~+H4&4ZJ?obWO*7o79l4z=)9KNc?`0xz_`1Fr7;f-rqL^y&}em8<+v
zxVTI-<;Syg&Oz&rFc$;AzIgJnG?TO0^Cs4-Mw)lB+iv~rdUQRavfA<Hk1|c_*GHq~
z{I+MHc)L@9rk&b!DY>wDY_EI(e)a+5o=6;XpPW2P;suGCJ6Sdbm&{fS(YrbnAmw*5
z1ImIA$e^6INv!Q>$4mZ@3pBoV3z-?2gD&B@3p(t|?N(G92}OOOnTvSluj1QgGfL6r
zf}R-3v}BADGE{;{UP|)AhV9~FsYTP29hK$E?%Q0v>wBd2PVHH=^t-jr>MFOj=A36y
zDBe7=QC!L?ueH(WpEJC-wd|^Ry7t*^tfOm-8+fdBOG&&slj+~uHkNwgEbnb5m!ybq
zTuE&cUc8qYeW86nPZxJG2w{#=pEG!CS@3ej;ypuN*RAfZ?e3z~^xYHe7f|@3_fgcK
zgY9~i+uvK>T<FUVkAJ4=SC=+gp~`rB?N;{lMW))`Ya2frF0W$plTNnP6IGVZ(o?FK
zE@8IO^!t-Hm1$uio@il@S`%DdE#w;}yZbD$J4I!D)=%-}--mVEOM9D^HqgVVH|}*M
zx>@g%-U->5ZHD1wwld3>XkCK<BW5|0CqKcyC})&2?k2>;34x=6!(|lz0J11b7U!=F
z9ciUnq-ixqG3L^RI3}snjAJ=YP4fQf!?;{#Q-X&)C5pu2qOrAos$8^HYFw1#9%bz+
zRGO5%wB*!fK4``gigK5}_{ZX__@>s&PFU^iEUm9~N$fORi~j)lmPT)_E^Vf})NQW!
z+1=`?Z5P=sWriI#-^stcjA_1Zr5((i&WZ6R_rMF{Tb%{8tF1%Fz8t;qwfvgBgxZDo
zm#W(N^J_K|$EaFQpzCIRSyt0sh#|ANvU#L|?bUwW=QAdur&&W3R<Zv8Yv0cjTilq+
z%!xGcw2`zEffk<e+A|pv3#q5`<BIXGqqh?+-)W?HDKzi1HN#$6_=)C&P`h}Z8w=R9
z1uJnS+gxim5oz`hbS6fE;bplN*5V7O;<{OF^#uIwQdf^PPIWa1Xxv-TEp0B3cJ<Qz
zPh!}}R#mIcQpC>9RB~=m=7pr+D@iEAP8zFP`d-%S^!-;`xYDN5d{?Y%$)r8g-tMz|
ztDQzoF8UiyGA%M&>q*~GnkG5~Lr?JTq_RzEt6RtR?KNh)xQ+b}O#a!MOS;$mMW<TB
zapLPqA=7kw4F*57L1#X&>uV%8pJ}z4D^sUUdv|Yjdd&rd7Wa0VnuHeXWlO^U01xj^
zh{eXS6qbo+rdnxN8icm+TxwI_>NhdJ+0#&(3p?FX^6t@Y(^Hfru@;isL|4<yD3bef
z=(gII{3JT2x$zG}_*d}v;l7-{CHTkjzr{mP)%-p1XTzQ(iYqN5*)+XA;>%U|gYiqo
z_Wl>2LHI%Nd&2knZ;QSuc#}=>1=!X6A@Iw>UlhJ7{5<rq7)*9!i>H@mRO(c(UAQ>Y
zl$W@<B_~!%@<xmleWh7ce34L2*Rj~>(WgpPt9!JgDsfZ4zbQ2srA{)muPtFt*KW;5
z%WshUVW{{^<41{nOW?nVI`518A^RJA0n;>p5q{Vo7(5Xcgmv4oZE2}$zYRZUuK-+l
zjbZToe-^$mc=N-l;NJ<s{h8x!Ur5w#b^id18qb3DpN0Pb0e&YXzvGwf3Gts?`1SEG
zQSsiTWu<suNVBlgJQ?uQz&a(?qkG|Bh5rBzJP~1MqIehKzlCo#Tg^`L_eAivfoWr-
z4M$qP)pZSjQEf}a+WxPpYdWr>tLi@W`(=LBdKbov-3#FF!M_V?e+mBpWe<fquZXTb
z8Tc1gzO(TMjC^<E&0s-o;=kGl<Ijn7m@MtQd-2QSWyY0dFNyp?X>A{ed?VqjO$Xtx
z!)+Tx_<7*(4`{J`DpmwOYww2QIU-Z$Kp<Gk#=ExW>D<bav<+?qVmXhSEb_v+Vfyzb
z7b?r><e6;w@bsK&W3e%R@A%s;dEV~yDa!uN-t66->QkeIaQ3hmdefiRv61DkC@Oe*
zI;Dlf+B!JBs?_CN*VddAX{8y;ysD!~6RMYyriwWicoUfCm`oi6#M}$ej=|)fM7N6Q
zTgf}N0GAQOf!Up95Xh@<8ibwAt29rEZJ*3ws_Ncs6Bm__?iseYP-GKHKbs(w%M@U=
znRwPH3pbR~v0G(Ek>a}!(4dywK_q4<-bkR0?ctI*%3sZ9VSPe7IVM$x(lY|wLuRu*
z%&d~E6DVtYRhmS5b+|DmCNR2?+-IztTA?OsX120pB%&h}uOhp%#f|Y>%A15X@fVuv
zF)r1bRdtfx?k6`Y%}$m!@~$C`t-Qr|Pb%0;aJOkQdD608G_wh1hE#&w2%1ZIRZN0;
zBxvQHyjPC`s7WJ@<17SzS)U4Hk~NYwo;jn8!yCBF%?k!gIbw+<w_BQfBsW_&OyMDh
z2-W6wlgW@sit9AyI72Iyns^Wi+B;B@qRk<b?7)d8oyjW~@6}@2BCJucR|s4@LI+_L
zvPkP8vsDo<lE~1nmnJCXV^vu0o+QD>%ZIn#71}W)plN|-R2+r@R4iM6cav^O3(2%S
zxhh4X`H`LJ6|`^WW<vm-BaH|Aw^JcasS+@POK7uafEfz;t00f%Sv<&M-W-{-6@g~K
zl&<DxB!V&k3ZNdIsiunvp?kZzH9NMvhIfL-=H6GGmeCA$_g5FXa9D33djy<a+s$Z#
zce#o`G8=fVX+EbTJZfXoZEWQ8;+F4D(&4q6ZOfTvo6Wdb?piyT<sMzL-ojypTT8QR
z9f%;YcYL>(eq^%5*D@{b>P>X5Z*nHQwTgASl2$_(_O;CHik@s%qS0SYlGUuzMY@W+
zLv=KU;#(V$HQ<)+2)13A<gmJi*5t~!Oo@MaYve2p&$`my+()ooz_&{x1;MSIwesDO
zTlvwbX)QG?lW8<k%^kRw+GQVSH|1M0d6x3DC>=}<0g(`dh39}sQr-)=<CZxsi59U-
zdA9mjl3ym~Ij$g-X&9NNfu*)c=DK(%w7rQeW4#u(_Xs4ns%iFZZ*_3fB=^kr?PnZv
zO>F|fF66whnBFD4t8&oA6y(`YsKACscx~X*q<N&Sx3_wMw}D=0Ek(2z?IrKYBE>8d
z+q%Ienj}qQWo<mN-(h^oEn4PztmRnlqKFILTBqc{%%qmH0QXmlvP!dvC%3$wc;+`(
zVgk)1>|kha;$$+*6Ea;*{*xqYn|t50?_M~H?(#Vzw6uGFJWDO5;#u2X+TFtqnp^1b
zvR!E`^So*HyT~mrEuK8eB$Cz-x82l^I|$~C?9~?L?&eE^%`#g{D_u`-0yI-x1QFa#
zb8UHcn7Eidu!W+(is}ZIeJgtgk)w?Lw%KHn?e1>xuBVFH32h<1ykxjp&Yfu!YSBiT
zm785%8;Nf1+w4#*mWgHym1#EJ`G2p+&+hccyAdSw+UDZaiIM|%I@;QVwKhi1(*E{I
zE!2tQEgIb|s@utMw#Hky;kpLtCKpSmTu%YH1i>Zb>wRlA&YIIb#CB0!tIqN~$|3^l
z<|7rfjJkrEZ&OpZf;(#oE$vGzb1GR)IwTjiFh@MMmt`*`f;hyYdwY!{`Zu~?vk5jE
zi))2hrjjEBdR5Urn`dVm{_bceSqsAroIYj5Ll@T9c2{0i{1-3}HhUXwLK)_LN;pxj
z?IOCixfe2lE2a6pkJYc(&;AON;xB>PHkt5a_KVTAUyPpwZ1nM^ct2T+YnXm0d<2V8
zxQkc1y!dmd-(K3=_>010SDCe2--F&b`&Wf-S6K0s-w$<Pg+3+mZSRYR^Z}vTcw^$f
z!|R`n-vIn+qI_@oHE-mb{{S5LCB?<}f=$f&O_i>l@r%JeY~CyQHR1_1U24<A_V!*o
zu+wyZ5^K<EQ2aab7ml=BSas{K;xbtt;Kgfob#C5TGup{@1orm#8K2LAo@s-uF<m{!
z+HRw{j><H(DKDKGN)Y;Q!cUFg8NX*gh&orqpMl>Kd~NV|;#P&{C8vsf8LsL+8u2Z>
zI8bc$69wg{zSH$cH^r)Hm+N(BsM$Q<Yp|Zl<a?jgctgc3--jVj1CQp-GN?O3ok@SS
zVWD)~F!g0GdO9^2RD7}LZ8oC_FU>fw!#tyiXFPTaQOh$)d(*2<AMDtf>iMx0W3=Sj
zbE{6%m6tW!ZT|pUm(j|Fhy)Nx>EEH?k8a0<^)<_0T@jE;#y(&{I3QqcAoai*Cmrx>
z^XuS0{1$KFpNSxkL;bXV0^ZB1I$o@w89!x-bYBAaqT^D#-Dzoi;*WuzC4l@V@db{M
zY|?miABI;S0A{^6H~#=>xV@KU)t~4mhdwC&#(x`4y#D~R@9mfHXT+CUjn<iMXW$Qx
z)4%Mc@j}KsogiLnS9<dNUc0sU5f!eLsic}vkHa6d2aGi<)SFJeT|O3{Qnb>)b;~&W
zg>%@)>bZ?N6{Q=x7{A=qi&plRQfv2g_mxR<!NK$1(Vr*c`IiLoK1|xg<<%?Eq|{Y>
zANx%w7M!B*8%cB8NkPY-nZ_+AI%<3luRAv48M=^1f981l{{Z^@$5)zMNPxfZ09@gY
z0Fhfb$2r@KabIIM?9K7(Td~(Qj|}`9_>bdX4tRa_Q>ggE;r{@Hb+3p%1QxnHlP&hE
zW8=RCT5J9d)wBrG-dm`AMWpMO+7;!1T|&!Ixv-KuhWT$<v1>_XhUN!~c$wpx-sL2U
zRCIEVtrG;1T^)9^uu`NjIV*$eVm+NjH44<_C~`SQoTE1tE?HA<F=|VhT2b2ZvsX<s
z&%)Gnxq0c-TFO5BIX(D0PB)sjG+vTV;g*iiLyS#A$5YeJiQ-EbF6`j)O^xfrCTwN4
zDE5te91%)yA+(Yhrio3ww+Qhf!f?_@KbzQm8rAOg3!9$}c(*|*Xz)mu@vN7ZU+9s|
z4*8?9mhKf;VQ1ZU4eisJZu1=XGsd@d?VcC-P4PeC{<!`a_*L-p$Db4YM7FmV!^2+=
zd?Vry8fy{R+w2z?f7w19)3rPFw1;we*9`!QJgJqzY@b%}zwE2=bK%ynd9Qq6@SHyb
zF0?xfjYi7L_L%Vpg}-L~4^Xx9EiLcbKN9?R*Zv&nm%5BmT}Ad^4p?7ZYggf}C%3S8
zbnE#oKb?G2;5>scjxRoiTuv7_g$XI)a@;D#RLyZ5sbQ5|4LHuPw7e82UL3Jhpz2h1
zrrZ5jgY%qEHXAOlN|js`t2tAvh{V*w!v{y1)Ws-bQ;a1A%&RIKvudkqoxQWa%HzV1
zpk6E<GSD^8?OE<D?5%Z8PsH|T!#4M~?O-FkxUkc89WTVf)(s|cHPw~WuXp{Q9kh}J
z(_TYm>6TF@j~$ysJi4`{b{}MK6YEggqz`PjH&^YaXlrI5wzSdo`zR!G8uwAS(_)<I
z`)+OSA5&Ui62EH?*ylmi;_)}d{{Y%9ABbADzlC1X4~4(8ABXiHi~cgwZnPa{%EH6L
z9w_nOitqdp@J8Q9)b!u&YuJ2M;ID~47{9Zg_eimm!5X}A-AiTp>G4PY3h(g(!VO!)
z-?6vDtAE*BOlc>A-{P&tv;P1KANHTPvx)pyX>M2I{nv)H4J+Y}vHg?co6ig0YCp68
z0D?Xe>i!|{^V;a%H`Tme_RV@f0l@HHDyJ=6+YwJGqfMmfO?!OOqgQf-a_Vh7G~?Sa
zse)H=QFC1UzoSm|F%tgG!&k&XrlE?(Ml`5KE!k9c<rOONov%sZsp6#?X<l^sz3<Ww
zk3J&s=j_3w$uI2@uj`)*wQ;3DG{1s=8($CHe$+n_<4+LJXR2t=;k`<0sQ&<G4+@<#
zNw~TH0EM6N!^1Zg^XdB6f&54C)8SXgZ3|ZMCB}pJ75hy7*1j+Oqwj6>J8c_D_+9XO
zMAx;i5%@RYr+~E&6>1&`@OH1_dCdCXh&63n#(K`V<4=j75OqrnJqt+JJ|O%}@i&Tm
zS8=0wZ$j{vpQ`CT3h<|dd^e)}$9b#j8pfrpYg(?UKZrG3>x+xsM_JbIrn}TNE4!)N
z?Kk%~8jqWKtX)WEl5g~w(sL{}_fta71T{h%Xy=9)BXYL|?i~4(CzOgzYY&kdS;(=d
zcFVHdMzfWU5Q1T9t@c=Ns%4ltW%*Vg>X><}VzCo(o<A_Pn)==%FoRT7mo+>U6%0K$
zZhvo55v+O`Y_Tfw#bW9_RxN8ywALRA+U0KxMY(cK#q!R)+^bGEQFQ6a(;GG>or${-
z<U<{dZ*ehFf(L*ZU}#?L8Yhh=J0X~@yE8wStK~e5XkIAyO&j@X4XpblhHc(X`+1sZ
zXBNvG5YHv#QY_w4FAd2t-A>X(mvKs=p5_QygiAE>Ly{G7^E`zZZH0Ho8b{=$sT-*b
zR#2p~cONyaqzI}ULnM-inlrdQ$<=4sJW?!eB#|p5Zm}p?l*nDqNvE;uG}ergIH8j1
zgze-&NE4skg@n2R1g@c^lHo%jY2<|-c1Cvv<d{YgA%+X6<J_(!g59BX^W%j~kp+;-
zw^oj35%0OQyNwjX_QaL!E@rk0lGwSLZDQ|GxM&hNuWrS`O*>Auj?O9FWG`=RWndB;
zJ2rCS3w=5jhC5p%5ZWXVDnkiLP<ibpK7S?>A!wFQv|HiYHHt4hY>dKH*UV`H!X^!g
zBU0=7`G1-ar9Q<O%xJ1+m`6O1EEglpid%V|AW4IHYEevnd@fUJmPcEMN~a1HUCSSv
zCRIG95^p%##gGXWK{Trq0hQYthEciR9Nbf8W>pU(TW^{<@~dV|ib|~z5&6<a^S9Z_
zXv<E9aSTJwJ6@`Qe7`m4b(FSNETTYTSCocJh~{w4WQ6QfZX;<Vo>h}_5bOz!yBVWY
zaIs1R*5+B&Ac`rPDL#KZ<q|iL38up?5#8b&W_5z*;y*dTvs6&bV}=RmFk8nX8CDn!
zt31XOG7}e{G}A0)QdwQpv30zNtsBg~dU@h$p_X@sJBZR?(gPz%yWV&%9y9XAARB;Y
zX7ZZttTLF&#iHC_gl(-lL2}F_+N|+Q<*TB}6E@5Zxj>J!@7~}Y1XfdB#}QP8n&d|%
ztk8gx>J4!f#0{qz?la}fh>OK}J*B$FKGM%4xwb>H@>yN^k;E*cvyR@)15asrG)(jT
zhUPe9l6$M$$StM4p5j?V5nH+{Wf;pU$r(ihO|6Is5~iBg+pZ>iMY@>5Bil+Qx_7gU
zE-!$xx!)UF!5k(rc%msC9^f^y++OFi7-6<Bq(bOjrOVr9XwW*_z$e-wWP&(UT3u!B
z-YcnIEwX*4C9n{bQogqGf2aACHD;c-f2F^#$Zy+z%WpNb={>?kuuO`nZMF?U)(eQO
z-Bw8!6A@W83yY*S@(IyKoCsF8zJ__N=7QSSQkH2TnKbAklJD(ve91Z%TWH6VeJ#+q
z(=M%5{P^_ySl4}lg`u{BMku1n_qL;+i7)FzV^XrzZH=>QmNR{$Rkfc{22Dw2YpE`^
zD5SAAu-eV`J9bYaH*Y`LO~s&{Hb-^j88dC?xVn2A8H(GR(vbOz^E8*@FYM{Oi@@)A
zvq2rjot&}2B(f4Mxi=S5OKV_gqM4oE-3-$NdW^`r5)Jatw1DO-8QV^?n(8dWc8@ZP
zt8}@U;+?J(pDH;gLnFl&b;sH#F<eUUMG^^jWdvI-%#y57MQvpV*`Pjnoggtr-b<91
z&4?(HiYP7{{J+SKS(-gO+oaRQZ*v&AMTq>1<rS5ok~Nkh(1vD~5xvm{Wfr35K#(y!
z#1q-=nVl^b+j2Z{`A+lO!!o>PMvi#?S7dcDOEY;-H<qZ;5{eqWjH&5nw0Ga+b$%T2
zw~qW7cy9a=;{N~@cuIS9N$uqD_P?lTcj`x)#!t0q_j-N|W;qJtLAEl96l%x!Us12^
z>-%?jA?<XlAKMr9r10$4z%&tQ-yXgr$lqtXw;o%<w*DlF&N#7bvMs1EeAD?7e(6k#
zQC*aC9K#PyQlXB<(WJlS-7HmlaP{Pb;~T$2j<yd6iTAM>Of6|>xvJsmRF_}1I7#&A
zah@mrwtsA&7_at!i~j&?KiV(E)<GD3n_BqK@gGyMzGsOpz@EbUUYZF6%_iH=wJfN9
z(efnm!qLm~cA<Z(YZtTK>l%&zu{3kXad~-vdo=fi38miteal?P?h-d{Oqq5Lcd%59
zqNct-9g2#MCmD*wMn4Q|;wx5)^i?M$zCxpg!r|}rd^R41_x3bt(!Z~>jBZt*bauA#
zwa(cZYuOe^)=w%Rv)e@^(EuYcwAVqSWft<2<ihG9Mv#~b#pU^nB&{SeLXxbcTu5e)
zH}jcgbb$@LvRlh2grJdPcpz!zcwT7=E0pSjyVZ2R<Y*)_xP>5%W4QC9QhdWF+6;2T
z8MIj4lGRmiBYT*G!x)X^eb=(6L>ci(aplP*Q#3+IyrC2;9CA7|vX3TNBU^O|G^Qgq
z()-oGa?2SCQ9w&cJ9M|?Lf%k7CxwN=OrC2Q5vG|WwNETXvJWaXwi_J~$^@?`?*YK_
z7t8^sM%<7pTPr9b#?8^<24XiPal-P6S{Td8FPO;1XJASwB#KGeU>D4EbVhS3mn4Z|
zg3?uFFR>lr0ZT%=OhPD#!eJjIZ3o$f+sc+Qh_0iK4U&H1?_r(e5*6~MWw&Md<6`d=
zK4TE8Feso2W4Kkb5@DnA5ZT$ayLnQEYr}UX%N#M7z_%jX63Y~&E^XChnj1M4s<hA}
znHSEDt>%o{`GsdtH?w9&0WehpwiXhuLwvD?hA>e;5`eCzQMDv=lgnj|9ZIySgY5vM
zd!``bIpd8=I>#$7n9nSCt@V4Gc*wVoIaWy|mFBpx(Qf3LMq&)R^&1<@l-#Pjk**vx
Of#<@!&Y+@zKmXa-8YwIQ

literal 0
HcmV?d00001

diff --git a/Source/DataSources/ModelVisualizer.js b/Source/DataSources/ModelVisualizer.js
index f878277f2983..e8055bf1af71 100644
--- a/Source/DataSources/ModelVisualizer.js
+++ b/Source/DataSources/ModelVisualizer.js
@@ -40,7 +40,6 @@ define([
     var defaultColor = Color.WHITE;
     var defaultColorBlendMode = ColorBlendMode.HIGHLIGHT;
     var defaultColorBlendAmount = 0.5;
-    var defaultClippingPlanes = [];
 
     var modelMatrixScratch = new Matrix4();
     var nodeMatrixScratch = new Matrix4();
@@ -153,7 +152,7 @@ define([
             model.color = Property.getValueOrDefault(modelGraphics._color, time, defaultColor, model._color);
             model.colorBlendMode = Property.getValueOrDefault(modelGraphics._colorBlendMode, time, defaultColorBlendMode);
             model.colorBlendAmount = Property.getValueOrDefault(modelGraphics._colorBlendAmount, time, defaultColorBlendAmount);
-            model.clippingPlanes = Property.getValueOrDefault(modelGraphics._clippingPlanes, time, defaultClippingPlanes);
+            model.clippingPlanes = Property.getValueOrUndefined(modelGraphics._clippingPlanes, time);
 
             if (model.ready) {
                 var runAnimations = Property.getValueOrDefault(modelGraphics._runAnimations, time, true);
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index 8b06f0969089..6e198a7615ae 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -61,7 +61,7 @@ define([
          * @type {Matrix4}
          * @default Matrix4.IDENTITY
          */
-        this.transformationMatrix = defaultValue(options.transformationMatrix, Matrix4.IDENTITY);
+        this.transformationMatrix = defaultValue(options.transformationMatrix, Matrix4.clone(Matrix4.IDENTITY));
 
         /**
          * If true, the region to be clipped must be included in all planes in this collection.
@@ -78,7 +78,7 @@ define([
          * @type {Color}
          * @default Color.WHITE
          */
-        this.edgeColor = defaultValue(options.edgeColor, Color.WHITE);
+        this.edgeColor = defaultValue(options.edgeColor, Color.clone(Color.WHITE));
 
         /**
          * The width of the highlight applied to the edge along which an object is clipped.
@@ -108,9 +108,9 @@ define([
 
         var transform = Matrix4.multiply(viewMatrix, this.transformationMatrix, scratchMatrix);
 
-        for (var j = 0; j < length; ++j) {
-            var plane = planes[j];
-            var packedPlane = array[j];
+        for (var i = 0; i < length; ++i) {
+            var plane = planes[i];
+            var packedPlane = array[i];
 
             Plane.transform(plane, transform, scratchPlane);
 
diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index d43064e571e6..9007b8bd7ff6 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -2108,11 +2108,15 @@ define([
         }
 
         var premultipliedAlpha = hasPremultipliedAlpha(model);
-        var blendFS = modifyShaderForColor(fs, premultipliedAlpha);
-        var clippingFS = modifyShaderForClippingPlanes(blendFS);
+        var finalFS = modifyShaderForColor(fs, premultipliedAlpha);
+
+        var clippingPlanes = model.clippingPlanes;
+        if (defined(clippingPlanes) && clippingPlanes.enabled) {
+            finalFS = modifyShaderForClippingPlanes(finalFS);
+        }
 
         var drawVS = modifyShader(vs, id, model._vertexShaderLoaded);
-        var drawFS = modifyShader(clippingFS, id, model._fragmentShaderLoaded);
+        var drawFS = modifyShader(finalFS, id, model._fragmentShaderLoaded);
 
         model._rendererResources.programs[id] = ShaderProgram.fromCache({
             context : context,
@@ -3307,23 +3311,12 @@ define([
         };
     }
 
-    function createClippingPlanesEnabledFunction(model) {
-        return function() {
-            var clippingPlanes = model.clippingPlanes;
-            if (!defined(clippingPlanes)) {
-                return false;
-            }
-
-            return clippingPlanes.enabled;
-        };
-    }
-
     function createClippingPlanesLengthFunction(model) {
         return function() {
             return model._packedClippingPlanes.length;
         };
     }
-    
+
     function createClippingPlanesFunction(model) {
         return function() {
             var clippingPlanes = model.clippingPlanes;
@@ -3463,7 +3456,6 @@ define([
             uniformMap = combine(uniformMap, {
                 gltf_color : createColorFunction(model),
                 gltf_colorBlend : createColorBlendFunction(model),
-                gltf_clippingPlanesEnabled: createClippingPlanesEnabledFunction(model),
                 gltf_clippingPlanesLength: createClippingPlanesLengthFunction(model),
                 gltf_clippingPlanes: createClippingPlanesFunction(model, context),
                 gltf_clippingPlanesInclusive: createClippingPlanesInclusiveFunction(model),
@@ -4265,7 +4257,6 @@ define([
     function modifyShaderForClippingPlanes(shader) {
         shader = ShaderSource.replaceMain(shader, 'gltf_clip_main');
         shader +=
-            'uniform bool gltf_clippingPlanesEnabled; \n' +
             'uniform int gltf_clippingPlanesLength; \n' +
             'uniform vec4 gltf_clippingPlanes[czm_maxClippingPlanes]; \n' +
             'uniform bool gltf_clippingPlanesInclusive; \n' +
@@ -4274,11 +4265,9 @@ define([
             'void main() \n' +
             '{ \n' +
             '    gltf_clip_main(); \n' +
-            '    if (gltf_clippingPlanesEnabled) { \n' +
-            '        float clipDistance = czm_discardIfClipped(gltf_clippingPlanes, gltf_clippingPlanesLength, gltf_clippingPlanesInclusive); \n' +
-            '        if (clipDistance < gltf_clippingPlanesEdgeWidth) { \n' +
-            '            gl_FragColor = gltf_clippingPlanesEdgeColor; \n' +
-            '        } \n' +
+            '    float clipDistance = czm_discardIfClipped(gltf_clippingPlanes, gltf_clippingPlanesLength, gltf_clippingPlanesInclusive); \n' +
+            '    if (clipDistance < gltf_clippingPlanesEdgeWidth) { \n' +
+            '        gl_FragColor = gltf_clippingPlanesEdgeColor; \n' +
             '    } \n' +
             '} \n';
 
diff --git a/Source/Scene/PointCloud3DTileContent.js b/Source/Scene/PointCloud3DTileContent.js
index 72cbcff5e7f9..207048fe97fe 100644
--- a/Source/Scene/PointCloud3DTileContent.js
+++ b/Source/Scene/PointCloud3DTileContent.js
@@ -138,7 +138,8 @@ define([
 
         this._features = undefined;
 
-        this._packedClippingPlanes  = [];
+        this._packedClippingPlanes = [];
+        this._modelViewMatrix = Matrix4.clone(Matrix4.IDENTITY);
 
         /**
          * @inheritdoc Cesium3DTileContent#featurePropertiesDirty
@@ -516,8 +517,8 @@ define([
             }
         }
 
-        var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
-        var scratchMatrix = new Matrix4();
+        var clippingPlanes = content._tileset.clippingPlanes;
+        var scratchCartesian = new Cartesian4();
         var uniformMap = {
             u_pointSizeAndTilesetTime : function() {
                 scratchPointSizeAndTilesetTime.x = content._pointSize;
@@ -530,28 +531,38 @@ define([
             u_constantColor : function() {
                 return content._constantColor;
             },
-            u_clippingPlanesEnabled : function() {
-                return content._tileset.clippingPlanesEnabled && content._tile._isClipped;
-            },
             u_clippingPlanesLength : function() {
                 return content._packedClippingPlanes.length;
             },
             u_clippingPlanes : function() {
-                Matrix4.multiply(context.uniformState.view3D, content._modelMatrix, scratchMatrix);
-
-                var planes = content._tileset.clippingPlanes;
                 var packedPlanes = content._packedClippingPlanes;
-                var length = packedPlanes.length;
-                for (var i = 0; i < length; ++i) {
-                    var plane = planes[i];
-                    var packedPlane = packedPlanes[i];
-
-                    Plane.transform(plane, scratchMatrix, scratchPlane);
 
-                    Cartesian3.clone(scratchPlane.normal, packedPlane);
-                    packedPlane.w = scratchPlane.distance;
+                if (defined(clippingPlanes) && clippingPlanes.enabled) {
+                    clippingPlanes.transformAndPackPlanes(content._modelViewMatrix, packedPlanes);
                 }
+
                 return packedPlanes;
+            },
+            u_clippingPlanesInclusive : function() {
+                if (!defined(clippingPlanes)) {
+                    return true;
+                }
+
+                return clippingPlanes.inclusive;
+            },
+            u_clippingPlanesEdgeWidth : function() {
+                if (!defined(clippingPlanes)) {
+                    return 0.0;
+                }
+
+                return clippingPlanes.edgeWidth;
+            },
+            u_clippingPlanesEdgeColor : function() {
+                if (!defined(clippingPlanes)) {
+                    return scratchCartesian;
+                }
+
+                return Cartesian4.fromColor(clippingPlanes.edgeColor, scratchCartesian);
             }
         };
 
@@ -818,6 +829,7 @@ define([
         var hasBatchIds = content._hasBatchIds;
         var backFaceCulling = content._backFaceCulling;
         var vertexArray = content._drawCommand.vertexArray;
+        var clippingPlanes = content._tileset.clippingPlanes;
 
         var colorStyleFunction;
         var showStyleFunction;
@@ -846,6 +858,7 @@ define([
         var hasColorStyle = defined(colorStyleFunction);
         var hasShowStyle = defined(showStyleFunction);
         var hasPointSizeStyle = defined(pointSizeStyleFunction);
+        var hasClippingPlanes = defined(clippingPlanes) && clippingPlanes.enabled && content._tile._isClipped;
 
         // Get the properties in use by the style
         var styleableProperties = [];
@@ -1060,17 +1073,28 @@ define([
 
         vs += '} \n';
 
-        var fs = 'varying vec4 v_color; \n' +
-                 'uniform bool u_clippingPlanesEnabled; \n' +
-                 'uniform int u_clippingPlanesLength;' +
-                 'uniform vec4 u_clippingPlanes[czm_maxClippingPlanes]; \n' +
-                 'void main() \n' +
-                 '{ \n' +
-                 '    if (u_clippingPlanesEnabled) { \n' +
-                 '        czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength); \n' +
-                 '    } \n' +
-                 '    gl_FragColor = v_color; \n' +
-                 '} \n';
+        var fs = 'varying vec4 v_color; \n';
+
+        if (hasClippingPlanes) {
+            fs += 'uniform int u_clippingPlanesLength;' +
+                  'uniform vec4 u_clippingPlanes[czm_maxClippingPlanes]; \n' +
+                  'uniform bool u_clippingPlanesInclusive; \n' +
+                  'uniform vec4 u_clippingPlanesEdgeColor; \n' +
+                  'uniform float u_clippingPlanesEdgeWidth; \n';
+        }
+
+        fs +=  'void main() \n' +
+               '{ \n' +
+               '    gl_FragColor = v_color; \n';
+
+        if (hasClippingPlanes) {
+            fs += '    float clipDistance = czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength, u_clippingPlanesInclusive); \n' +
+                  '    if (clipDistance < u_clippingPlanesEdgeWidth) { \n' +
+                  '        gl_FragColor = u_clippingPlanesEdgeColor; \n' +
+                  '    } \n';
+        }
+
+        fs += '} \n';
 
         var drawVS = vs;
         var drawFS = fs;
@@ -1203,10 +1227,18 @@ define([
 
         this._mode = frameState.mode;
 
+        var context = frameState.context;
+
         // update clipping planes
+        var clippingPlanes = this._tileset.clippingPlanes;
+        var modelViewChanged = context.uniformState._modelViewDirty || modelMatrixChanged;
+        if (defined(clippingPlanes) && clippingPlanes.enabled && modelViewChanged) {
+            Matrix4.multiply(context.uniformState.view3D, modelMatrix, this._modelViewMatrix);
+        }
+
         var length = 0;
-        if (defined(this._tileset.clippingPlanes)) {
-            length = this._tileset.clippingPlanes.length;
+        if (defined(clippingPlanes)) {
+            length = clippingPlanes.planes.length;
         }
 
         if (this._packedClippingPlanes.length !== length) {

From e8e14f2263689c206e93791ee4d5db7bc885c8bf Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 27 Nov 2017 10:03:58 -0500
Subject: [PATCH 17/37] Refactor clipping planes

---
 ...nes.html => 3D Tiles Clipping Planes.html} |  39 ++++----
 ...lanes.jpg => 3D Tiles Clipping Planes.jpg} | Bin
 ...ping.html => Terrain Clipping Planes.html} |  11 +-
 ...ipping.jpg => Terrain Clipping Planes.jpg} | Bin
 Source/Core/Plane.js                          |   2 -
 Source/Scene/Cesium3DTile.js                  |  22 ----
 Source/Scene/ClippingPlanesCollection.js      |  94 ++++++++++++------
 Source/Scene/Globe.js                         |   2 +-
 Source/Scene/GlobeSurfaceShaderSet.js         |   6 +-
 Source/Scene/GlobeSurfaceTileProvider.js      |  36 +++----
 Source/Scene/Model.js                         |  20 +---
 Source/Scene/PointCloud3DTileContent.js       |  11 +-
 .../Builtin/Functions/discardIfClipped.glsl   |  19 ++--
 .../discardIfClippedCombineRegions.glsl       |  49 +++++++++
 Source/Shaders/GlobeFS.glsl                   |   7 +-
 15 files changed, 173 insertions(+), 145 deletions(-)
 rename Apps/Sandcastle/gallery/{Clipping Planes.html => 3D Tiles Clipping Planes.html} (85%)
 rename Apps/Sandcastle/gallery/{Clipping Planes.jpg => 3D Tiles Clipping Planes.jpg} (100%)
 rename Apps/Sandcastle/gallery/{Terrain Clipping.html => Terrain Clipping Planes.html} (78%)
 rename Apps/Sandcastle/gallery/{Terrain Clipping.jpg => Terrain Clipping Planes.jpg} (100%)
 create mode 100644 Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl

diff --git a/Apps/Sandcastle/gallery/Clipping Planes.html b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html
similarity index 85%
rename from Apps/Sandcastle/gallery/Clipping Planes.html
rename to Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html
index 73e04286bf59..c7af66f4ef25 100644
--- a/Apps/Sandcastle/gallery/Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
@@ -37,7 +37,7 @@
 <div id="loadingOverlay"><h1>Loading...</h1></div>
 <div id="toolbar">
     <select data-bind="options: exampleTypes, value: currentExampleType"></select>
-    <input type="checkbox" value="false" data-bind="checked: debugBoundingVolumesEnabled, valueUpdate: 'input'"> Show debug <code>boundingVolume</code>
+    <input type="checkbox" value="false" data-bind="checked: debugBoundingVolumesEnabled, valueUpdate: 'input'"> Show bounding volume
 </div>
 
 <script id="cesium_sandcastle_script">
@@ -83,8 +83,8 @@
 var upHandler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);
 upHandler.setInputAction(function() {
     if (Cesium.defined(selectedPlane)) {
-        selectedPlane.material = Cesium.Color.CYAN.withAlpha(0.1);
-        selectedPlane.outlineColor = Cesium.Color.CYAN;
+        selectedPlane.material = Cesium.Color.WHITE.withAlpha(0.1);
+        selectedPlane.outlineColor = Cesium.Color.WHITE;
         selectedPlane = undefined;
     }
 
@@ -96,8 +96,7 @@
 moveHandler.setInputAction(function(movement) {
     if (Cesium.defined(selectedPlane)) {
         var deltaY = movement.endPosition.y - movement.startPosition.y;
-        //var screenScale = scene.camera.getPixelSize(tileset.boundingSphere, scene.drawingBufferWidth, scene.drawingBufferHeight);
-        targetY += deltaY;// * screenScale;
+        targetY += deltaY;
     }
 }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
 
@@ -118,8 +117,7 @@
         url : url,
         clippingPlanes : new Cesium.ClippingPlanesCollection({
             planes : defaultClippingPlanes,
-            edgeWidth: 1.0,
-            edgeColor: Cesium.Color.CYAN
+            edgeWidth : 1.0
         })
     }));
 
@@ -137,10 +135,10 @@
                 position : boundingSphere.center,
                 plane : {
                     dimensions : new Cesium.Cartesian2(radius * 2.5, radius * 2.5),
-                    material : Cesium.Color.CYAN.withAlpha(0.1),
-                    plane: new Cesium.CallbackProperty(createPlaneUpdateFunction(plane, tileset.modelMatrix), false),
-                    outline: true,
-                    outlineColor: Cesium.Color.CYAN
+                    material : Cesium.Color.WHITE.withAlpha(0.1),
+                    plane : new Cesium.CallbackProperty(createPlaneUpdateFunction(plane, tileset.modelMatrix), false),
+                    outline : true,
+                    outlineColor : Cesium.Color.WHITE
                 }
             });
 
@@ -168,13 +166,12 @@
         orientation : orientation,
         model : {
             uri : url,
-            scale: 8,
-            minimumPixelSize: 100.0,
+            scale : 8,
+            minimumPixelSize : 100.0,
             clippingPlanes : new Cesium.ClippingPlanesCollection({
                 planes : defaultClippingPlanes,
-                edgeWidth: 1.0,
-                edgeColor: Cesium.Color.CYAN,
-                transformationMatrix: Cesium.Matrix4.fromRotationTranslation(Cesium.Matrix3.fromRotationX(-Cesium.Math.PI_OVER_TWO))
+                edgeWidth : 1.0,
+                modelMatrix : Cesium.Matrix4.fromRotationTranslation(Cesium.Matrix3.fromRotationX(-Cesium.Math.PI_OVER_TWO))
             })
         }
     });
@@ -191,10 +188,10 @@
             position : position,
             plane : {
                 dimensions : new Cesium.Cartesian2(300.0, 300.0),
-                material : Cesium.Color.CYAN.withAlpha(0.1),
-                plane: new Cesium.CallbackProperty(createPlaneUpdateFunction(plane, Cesium.Matrix4.IDENTITY), false),
-                outline: true,
-                outlineColor: Cesium.Color.CYAN
+                material : Cesium.Color.WHITE.withAlpha(0.1),
+                plane : new Cesium.CallbackProperty(createPlaneUpdateFunction(plane, Cesium.Matrix4.IDENTITY), false),
+                outline : true,
+                outlineColor : Cesium.Color.WHITE
             }
         });
 
@@ -222,7 +219,7 @@
     } else if (newValue === clipObjects[1]) {
         loadTileset(pointCloudUrl);
         tileset.readyPromise.then(function () {
-            tileset.clippingPlanes.transformationMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(tileset.boundingSphere.center);
+            tileset.clippingPlanes.modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(tileset.boundingSphere.center);
         });
     } else {
         loadModel(modelUrl);
diff --git a/Apps/Sandcastle/gallery/Clipping Planes.jpg b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.jpg
similarity index 100%
rename from Apps/Sandcastle/gallery/Clipping Planes.jpg
rename to Apps/Sandcastle/gallery/3D Tiles Clipping Planes.jpg
diff --git a/Apps/Sandcastle/gallery/Terrain Clipping.html b/Apps/Sandcastle/gallery/Terrain Clipping Planes.html
similarity index 78%
rename from Apps/Sandcastle/gallery/Terrain Clipping.html
rename to Apps/Sandcastle/gallery/Terrain Clipping Planes.html
index 4c382a1c3d04..c925f37a2206 100644
--- a/Apps/Sandcastle/gallery/Terrain Clipping.html	
+++ b/Apps/Sandcastle/gallery/Terrain Clipping Planes.html	
@@ -4,8 +4,8 @@
     <meta charset="utf-8">
     <meta http-equiv="X-UA-Compatible" content="IE=edge">
     <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no">
-    <meta name="description" content="Clipping planes on terrain.">
-    <meta name="cesium-sandcastle-labels" content="Beginner, Showcases">
+    <meta name="description" content="User-defined clipping planes applied to terrain.">
+    <meta name="cesium-sandcastle-labels" content="Showcases">
     <title>Cesium Demo</title>
     <script type="text/javascript" src="../Sandcastle-header.js"></script>
     <script type="text/javascript" src="../../../ThirdParty/requirejs-2.1.20/require.js"></script>
@@ -31,16 +31,15 @@
     terrainExaggeration : 3.0
 });
 
-var cesiumTerrainProviderMeshes = new Cesium.CesiumTerrainProvider({
+viewer.terrainProvider = new Cesium.CesiumTerrainProvider({
     url : 'https://assets.agi.com/stk-terrain/v1/tilesets/world/tiles',
     requestWaterMask : true,
     requestVertexNormals : true
 });
-viewer.terrainProvider = cesiumTerrainProviderMeshes;
 
 var globe = viewer.scene.globe;
-globe.terrainClippingPlanes = new Cesium.ClippingPlanesCollection({
-    transformationMatrix : Cesium.Matrix4.fromTranslation(new Cesium.Cartesian3(0.0, 0.0, 3000000.0)),
+globe.clippingPlanes = new Cesium.ClippingPlanesCollection({
+    modelMatrix : Cesium.Matrix4.fromTranslation(new Cesium.Cartesian3(0.0, 0.0, 3000000.0)),
     planes : [
         new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 0.0),
         new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, 1.0), 1000000.0)
diff --git a/Apps/Sandcastle/gallery/Terrain Clipping.jpg b/Apps/Sandcastle/gallery/Terrain Clipping Planes.jpg
similarity index 100%
rename from Apps/Sandcastle/gallery/Terrain Clipping.jpg
rename to Apps/Sandcastle/gallery/Terrain Clipping Planes.jpg
diff --git a/Source/Core/Plane.js b/Source/Core/Plane.js
index cec682af4071..cc7f5532937e 100644
--- a/Source/Core/Plane.js
+++ b/Source/Core/Plane.js
@@ -1,7 +1,6 @@
 define([
         './Cartesian3',
         './Check',
-        './defaultValue',
         './defined',
         './DeveloperError',
         './freezeObject',
@@ -10,7 +9,6 @@ define([
     ], function(
         Cartesian3,
         Check,
-        defaultValue,
         defined,
         DeveloperError,
         freezeObject,
diff --git a/Source/Scene/Cesium3DTile.js b/Source/Scene/Cesium3DTile.js
index 6eb6ad2af9b7..d7af1391ed35 100644
--- a/Source/Scene/Cesium3DTile.js
+++ b/Source/Scene/Cesium3DTile.js
@@ -740,28 +740,6 @@ define([
         return frameState.mode !== SceneMode.SCENE3D ? tile._contentBoundingVolume2D : tile._contentBoundingVolume;
     }
 
-
-    var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
-    function checkTileClipped(tile, boundingVolume) {
-        var clippingPlanes = tile._tileset.clippingPlanes;
-        if (defined(clippingPlanes) && clippingPlanes.enabled) {
-            var planes = clippingPlanes.planes;
-            var length = planes.length;
-            var rootTransform = tile._tileset._root.computedTransform; // TODO, factor in inclusive/exclusive, transform
-            for (var i = 0; i < length; ++i) {
-                var plane = planes[i];
-                Plane.transform(plane, rootTransform, scratchPlane);
-                var value = boundingVolume.intersectPlane(scratchPlane);
-                if (value !== Intersect.INSIDE) {
-                    return value;
-                }
-            }
-        }
-
-        return Intersect.INSIDE;
-    }
-
-
     /**
      * Determines whether the tile's bounding volume intersects the culling volume.
      *
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index 6e198a7615ae..e6d7bf1be8f1 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -6,6 +6,7 @@ define([
     '../Core/Color',
     '../Core/defaultValue',
     '../Core/defined',
+    '../Core/defineProperties',
     '../Core/Intersect',
     '../Core/Matrix4',
     '../Core/Plane'
@@ -17,30 +18,31 @@ define([
     Color,
     defaultValue,
     defined,
+    defineProperties,
     Intersect,
     Matrix4,
     Plane) {
     'use strict';
 
     /**
-     * Contains the options to specify a set of clipping planes. Clipping planes selectively disable rendering on an object on the outside of the specified list of {@link Plane}.
+     * Specifies a set of clipping planes. Clipping planes selectively disable rendering in a region on the outside of the specified list of {@link Plane} objects.
      *
      * @alias ClippingPlanesCollection
      * @constructor
      *
      * @param {Object} [options] Object with the following properties:
-     * @param {Plane[]} [options.planes=[]] An array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+     * @param {Plane[]} [options.planes=[]] An array of up to 6 {@link Plane} objects used to selectively disable rendering on the outside of each plane.
      * @param {Boolean} [options.enabled=true] Determines whether the clipping planes are active.
-     * @param {Matrix4} [options.transformationMatrix=Matrix4.IDENTITY] The 4x4 transformation matrix specifying an additional transform relative to the clipping planes original coordinate system.
-     * @param {Boolean} [options.inclusive=true] If true, the region to be clipped must be included in all planes in this collection. Otherwise, a region will be clipped if included in any plane in the collection.
-     * @param {Color} [options.edgeColor=Color.WHITE] The color applied to hughlight the edge along which an object is clipped.
+     * @param {Matrix4} [options.modelMatrix=Matrix4.IDENTITY] The 4x4 transformation matrix specifying an additional transform relative to the clipping planes original coordinate system.
+     * @param {Boolean} [options.combineClippingRegions=true] If true, the region to be clipped must be included in all planes in this collection. Otherwise, a region will be clipped if included in any plane in the collection.
+     * @param {Color} [options.edgeColor=Color.WHITE] The color applied to highlight the edge along which an object is clipped.
      * @param {Number} [options.edgeWidth=0.0] The width of the highlight applied to the edge along which an object is clipped.
      */
     function ClippingPlanesCollection(options) {
-        var options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+        options = defaultValue(options, defaultValue.EMPTY_OBJECT);
 
         /**
-         * An array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
+         * An array of up to 6 {@link Plane} objects used to selectively disable rendering on the outside of each plane.
          *
          * @type {Plane}
          * @default []
@@ -61,19 +63,10 @@ define([
          * @type {Matrix4}
          * @default Matrix4.IDENTITY
          */
-        this.transformationMatrix = defaultValue(options.transformationMatrix, Matrix4.clone(Matrix4.IDENTITY));
+        this.modelMatrix = defaultValue(options.modelMatrix, Matrix4.clone(Matrix4.IDENTITY));
 
         /**
-         * If true, the region to be clipped must be included in all planes in this collection.
-         * Otherwise, a region will be clipped if included in any plane in the collection.
-         *
-         * @type {Boolean}
-         * @default true
-         */
-        this.inclusive = defaultValue(options.inclusive, true);
-
-        /**
-         * The color applied to hughlight the edge along which an object is clipped.
+         * The color applied to highlight the edge along which an object is clipped.
          *
          * @type {Color}
          * @default Color.WHITE
@@ -87,6 +80,43 @@ define([
          * @default 0.0
          */
         this.edgeWidth = defaultValue(options.edgeWidth, 0.0);
+
+        this._testIntersection = undefined;
+        this.combineClippingRegions = defaultValue(options.combineClippingRegions, true);
+    }
+
+    defineProperties(ClippingPlanesCollection.prototype, {
+        /**
+         * If true, the region to be clipped must be included in all planes in this collection.
+         * Otherwise, a region will be clipped if included in any plane in the collection.
+         *
+         * @memberof ClippingPlanesCollection.prototype
+         * @type {Boolean}
+         * @default true
+         */
+        combineClippingRegions : {
+            get : function() {
+                return this._combineClippingRegions;
+            },
+            set : function(value) {
+                if (this._combineClippingRegions !== value) {
+                    this._combineClippingRegions = value;
+                    this._testIntersection = getTestIntersectionFunction(value);
+                }
+            }
+        }
+    });
+
+    function getTestIntersectionFunction(combineClippingRegions) {
+        if (combineClippingRegions) {
+            return function(value) {
+                return (value === Intersect.INSIDE);
+            };
+        }
+
+        return function(value) {
+            return (value === Intersect.OUTSIDE);
+        };
     }
 
     var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
@@ -98,7 +128,7 @@ define([
      * @param [array]
      * @returns {Cartesian4[]} The array of packed planes.
      */
-    ClippingPlanesCollection.prototype.transformAndPackPlanes = function (viewMatrix, array) {
+    ClippingPlanesCollection.prototype.transformAndPackPlanes = function(viewMatrix, array) {
         var planes = this.planes;
         var length = planes.length;
 
@@ -106,7 +136,7 @@ define([
             array = new Array(length);
         }
 
-        var transform = Matrix4.multiply(viewMatrix, this.transformationMatrix, scratchMatrix);
+        var transform = Matrix4.multiply(viewMatrix, this.modelMatrix, scratchMatrix);
 
         for (var i = 0; i < length; ++i) {
             var plane = planes[i];
@@ -127,15 +157,15 @@ define([
      * @param {ClippingPlanesCollection} [result] The object onto which to store the result.
      * @returns he modified result parameter or a new ClippingPlanesCollection instance if one was not provided.
      */
-    ClippingPlanesCollection.prototype.clone = function (result) {
+    ClippingPlanesCollection.prototype.clone = function(result) {
         if (!defined(result)) {
             result = new ClippingPlanesCollection();
         }
 
         result.planes = Array.from(this.planes);
         result.enabled = this.enabled;
-        Matrix4.clone(this.transformationMatrix, result.transformationMatrix);
-        result.inclusive = this.inclusive;
+        Matrix4.clone(this.modelMatrix, result.modelMatrix);
+        result.combineClippingRegions = this.combineClippingRegions;
         Color.clone(this.edgeColor, result.edgeColor);
         result.edgeWidth = this.edgeWidth;
 
@@ -152,32 +182,32 @@ define([
      *                      if the entire volume is on the opposite side and should be clipped, and
      *                      {@link Intersect.INTERSECTING} if the volume intersects the planes.
      */
-    ClippingPlanesCollection.prototype.computeIntersectionWithBoundingVolume = function (boundingVolume, parentTransform) {
+    ClippingPlanesCollection.prototype.computeIntersectionWithBoundingVolume = function(boundingVolume, parentTransform) {
         var planes = this.planes;
         var length = planes.length;
 
-        var transformation = this.transformationMatrix;
+        var transform = this.modelMatrix;
         if (defined(parentTransform)) {
-            transformation = Matrix4.multiply(transformation, parentTransform, scratchMatrix);
+            transform = Matrix4.multiply(transform, parentTransform, scratchMatrix);
         }
 
-        // If the clipping planes are inclusive, the volume must be outside of all planes to be considered completely
-        // clipped. Otherwise, if the volume can be outside any the planes, it is considered completely clipped.
+        // If the clipping planes are using combineClippingRegions, the volume must be outside of all planes to be considered
+        // completely clipped. Otherwise, if the volume can be outside any the planes, it is considered completely clipped.
         // Lastly, if not completely clipped, if any plane is intersecting, more calculations must be performed.
         var intersection = Intersect.INSIDE;
-        if (this.inclusive && length > 0) {
+        if (this.combineClippingRegions && length > 0) {
             intersection = Intersect.OUTSIDE;
         }
+
         for (var i = 0; i < length; ++i) {
             var plane = planes[i];
 
-            Plane.transform(plane, transformation, scratchPlane);
+            Plane.transform(plane, transform, scratchPlane);
 
             var value = boundingVolume.intersectPlane(scratchPlane);
             if (value === Intersect.INTERSECTING) {
                 intersection = value;
-            } else if ((this.inclusive && value === Intersect.INSIDE) ||
-                       (!this.inclusive && value === Intersect.OUTSIDE)) {
+            } else if (this._testIntersection(value)) {
                 return value;
             }
         }
diff --git a/Source/Scene/Globe.js b/Source/Scene/Globe.js
index 41f6b6e5b17e..3fd3e79f92f7 100644
--- a/Source/Scene/Globe.js
+++ b/Source/Scene/Globe.js
@@ -239,7 +239,7 @@ define([
          *
          * @type {ClippingPlaneCollection}
          */
-        terrainClippingPlanes : {
+        clippingPlanes : {
             get : function() {
                 return this._surface.tileProvider.clippingPlanes;
             },
diff --git a/Source/Scene/GlobeSurfaceShaderSet.js b/Source/Scene/GlobeSurfaceShaderSet.js
index a6f7068a8b61..7de0b451d118 100644
--- a/Source/Scene/GlobeSurfaceShaderSet.js
+++ b/Source/Scene/GlobeSurfaceShaderSet.js
@@ -61,7 +61,7 @@ define([
         return useWebMercatorProjection ? get2DYPositionFractionMercatorProjection : get2DYPositionFractionGeographicProjection;
     }
 
-    GlobeSurfaceShaderSet.prototype.getShaderProgram = function(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, enableLighting, hasVertexNormals, useWebMercatorProjection, enableFog, enableClippingPlanes) {
+    GlobeSurfaceShaderSet.prototype.getShaderProgram = function(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, enableLighting, hasVertexNormals, useWebMercatorProjection, enableFog, enableClippingPlanes, combineClippingRegions) {
         var quantization = 0;
         var quantizationDefine = '';
 
@@ -163,6 +163,10 @@ define([
 
             if (enableClippingPlanes) {
                 fs.defines.push('ENABLE_CLIPPING_PLANES');
+
+                if (combineClippingRegions) {
+                    fs.defines.push('COMBINE_CLIPPING_REGIONS');
+                }
             }
 
             var computeDayColor = '\
diff --git a/Source/Scene/GlobeSurfaceTileProvider.js b/Source/Scene/GlobeSurfaceTileProvider.js
index ce6c2fce8548..a785bca7fb5d 100644
--- a/Source/Scene/GlobeSurfaceTileProvider.js
+++ b/Source/Scene/GlobeSurfaceTileProvider.js
@@ -873,9 +873,6 @@ define([
             u_clippingPlanes : function() {
                 return this.properties.clippingPlanes;
             },
-            u_clippingPlanesInclusive : function() {
-                return this.properties.clippingPlanesInclusive;
-            },
             u_clippingPlanesEdgeColor : function() {
                 return this.properties.clippingPlanesEdgeColor;
             },
@@ -918,7 +915,6 @@ define([
                 minMaxHeight : new Cartesian2(),
                 scaleAndBias : new Matrix4(),
                 clippingPlanes : [],
-                clippingPlanesInclusive : true,
                 clippingPlanesEdgeColor : new Cartesian4(1.0, 1.0, 1.0, 1.0),
                 clippingPlanesEdgeWidth : 0.0
             }
@@ -1043,8 +1039,6 @@ define([
     })();
 
     var otherPassesInitialColor = new Cartesian4(0.0, 0.0, 0.0, 0.0);
-    var scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
-    var scratchMatrix = new Matrix4();
 
     function addDrawCommandsForTile(tileProvider, tile, frameState) {
         var surfaceTile = tile.data;
@@ -1299,32 +1293,32 @@ define([
             Matrix4.clone(encoding.matrix, uniformMapProperties.scaleAndBias);
 
             // update clipping planes
-            if (tile.isClipped) {
-                var length = 0;
-                var clippingPlanes = tileProvider.clippingPlanes;
+            var clippingPlanes = tileProvider.clippingPlanes;
+            var length = 0;
 
-                if (defined(clippingPlanes)) {
-                    length = clippingPlanes.planes.length;
-                }
-                if (length !== uniformMapProperties.clippingPlanes.length) {
-                    uniformMapProperties.clippingPlanes = new Array(length);
+            if (defined(clippingPlanes) && tile.isClipped) {
+                length = clippingPlanes.planes.length;
+            }
 
-                    for (var i = 0; i < length; ++i) {
-                        uniformMapProperties.clippingPlanes[i] = new Cartesian4();
-                    }
+            var clippingPlanesProperty = uniformMapProperties.clippingPlanes;
+            if (length !== clippingPlanesProperty.length) {
+                clippingPlanesProperty = uniformMapProperties.clippingPlanes = new Array(length);
+
+                for (var i = 0; i < length; ++i) {
+                    clippingPlanesProperty[i] = new Cartesian4();
                 }
             }
 
-            if (defined(clippingPlanes) && clippingPlanes.enabled) {
-                clippingPlanes.transformAndPackPlanes(context.uniformState.view, uniformMapProperties.clippingPlanes);
-                uniformMapProperties.clippingPlanesInclusive = clippingPlanes.inclusive;
+            if (defined(clippingPlanes) && clippingPlanes.enabled && tile.isClipped) {
+                clippingPlanes.transformAndPackPlanes(context.uniformState.view, clippingPlanesProperty);
                 uniformMapProperties.clippingPlanesEdgeColor = Cartesian4.fromColor(clippingPlanes.edgeColor, uniformMapProperties.clippingPlanesEdgeColor);
                 uniformMapProperties.clippingPlanesEdgeWidth = clippingPlanes.edgeWidth;
             }
 
             var clippingPlanesEnabled = defined(clippingPlanes) && clippingPlanes.enabled && (uniformMapProperties.clippingPlanes.length > 0);
+            var combineClippingRegions = clippingPlanesEnabled ? clippingPlanes.combineClippingRegions : true;
 
-            command.shaderProgram = tileProvider._surfaceShaderSet.getShaderProgram(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, tileProvider.enableLighting, hasVertexNormals, useWebMercatorProjection, applyFog, clippingPlanesEnabled);
+            command.shaderProgram = tileProvider._surfaceShaderSet.getShaderProgram(frameState, surfaceTile, numberOfDayTextures, applyBrightness, applyContrast, applyHue, applySaturation, applyGamma, applyAlpha, applySplit, showReflectiveOcean, showOceanWaves, tileProvider.enableLighting, hasVertexNormals, useWebMercatorProjection, applyFog, clippingPlanesEnabled, combineClippingRegions);
             command.castShadows = castShadows;
             command.receiveShadows = receiveShadows;
             command.renderState = renderState;
diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index 9007b8bd7ff6..e6d270601222 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -2112,7 +2112,7 @@ define([
 
         var clippingPlanes = model.clippingPlanes;
         if (defined(clippingPlanes) && clippingPlanes.enabled) {
-            finalFS = modifyShaderForClippingPlanes(finalFS);
+            finalFS = modifyShaderForClippingPlanes(finalFS, model.clippingPlanes.combineClippingRegions);
         }
 
         var drawVS = modifyShader(vs, id, model._vertexShaderLoaded);
@@ -3330,16 +3330,6 @@ define([
         };
     }
 
-    function createClippingPlanesInclusiveFunction(model) {
-        return function() {
-            if (!defined(model.clippingPlanes)) {
-                return true;
-            }
-
-            return model.clippingPlanes.inclusive;
-        };
-    }
-
     function createClippingPlanesEdgeWidthFunction(model) {
         return function() {
             if (!defined(model.clippingPlanes)) {
@@ -3458,7 +3448,6 @@ define([
                 gltf_colorBlend : createColorBlendFunction(model),
                 gltf_clippingPlanesLength: createClippingPlanesLengthFunction(model),
                 gltf_clippingPlanes: createClippingPlanesFunction(model, context),
-                gltf_clippingPlanesInclusive: createClippingPlanesInclusiveFunction(model),
                 gltf_clippingPlanesEdgeColor: createClippingPlanesEdgeColorFunction(model),
                 gltf_clippingPlanesEdgeWidth: createClippingPlanesEdgeWidthFunction(model)
             });
@@ -4254,18 +4243,19 @@ define([
         }
     }
 
-    function modifyShaderForClippingPlanes(shader) {
+    function modifyShaderForClippingPlanes(shader, combineClippingRegions) {
         shader = ShaderSource.replaceMain(shader, 'gltf_clip_main');
+
+        var clippingFunction = combineClippingRegions ? 'czm_discardIfClippedCombineRegions' : 'czm_discardIfClipped';
         shader +=
             'uniform int gltf_clippingPlanesLength; \n' +
             'uniform vec4 gltf_clippingPlanes[czm_maxClippingPlanes]; \n' +
-            'uniform bool gltf_clippingPlanesInclusive; \n' +
             'uniform vec4 gltf_clippingPlanesEdgeColor; \n' +
             'uniform float gltf_clippingPlanesEdgeWidth; \n' +
             'void main() \n' +
             '{ \n' +
             '    gltf_clip_main(); \n' +
-            '    float clipDistance = czm_discardIfClipped(gltf_clippingPlanes, gltf_clippingPlanesLength, gltf_clippingPlanesInclusive); \n' +
+            '    float clipDistance = ' + clippingFunction + '(gltf_clippingPlanes, gltf_clippingPlanesLength); \n' +
             '    if (clipDistance < gltf_clippingPlanesEdgeWidth) { \n' +
             '        gl_FragColor = gltf_clippingPlanesEdgeColor; \n' +
             '    } \n' +
diff --git a/Source/Scene/PointCloud3DTileContent.js b/Source/Scene/PointCloud3DTileContent.js
index 207048fe97fe..64b1791c208f 100644
--- a/Source/Scene/PointCloud3DTileContent.js
+++ b/Source/Scene/PointCloud3DTileContent.js
@@ -543,13 +543,6 @@ define([
 
                 return packedPlanes;
             },
-            u_clippingPlanesInclusive : function() {
-                if (!defined(clippingPlanes)) {
-                    return true;
-                }
-
-                return clippingPlanes.inclusive;
-            },
             u_clippingPlanesEdgeWidth : function() {
                 if (!defined(clippingPlanes)) {
                     return 0.0;
@@ -1078,7 +1071,6 @@ define([
         if (hasClippingPlanes) {
             fs += 'uniform int u_clippingPlanesLength;' +
                   'uniform vec4 u_clippingPlanes[czm_maxClippingPlanes]; \n' +
-                  'uniform bool u_clippingPlanesInclusive; \n' +
                   'uniform vec4 u_clippingPlanesEdgeColor; \n' +
                   'uniform float u_clippingPlanesEdgeWidth; \n';
         }
@@ -1088,7 +1080,8 @@ define([
                '    gl_FragColor = v_color; \n';
 
         if (hasClippingPlanes) {
-            fs += '    float clipDistance = czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength, u_clippingPlanesInclusive); \n' +
+            var clippingFunction = clippingPlanes.combineClippingRegions ? 'czm_discardIfClippedCombineRegions' : 'czm_discardIfClipped';
+            fs += '    float clipDistance = ' + clippingFunction + '(u_clippingPlanes, u_clippingPlanesLength); \n' +
                   '    if (clipDistance < u_clippingPlanesEdgeWidth) { \n' +
                   '        gl_FragColor = u_clippingPlanesEdgeColor; \n' +
                   '    } \n';
diff --git a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
index 1f3bd125008f..6f9e740175e7 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
@@ -1,19 +1,18 @@
 /**
- * Clip a fragment by an array of clipping planes.
+ * Clip a fragment by an array of clipping planes. Clipping plane regions are not combined, therefore if a fragment is
+ * clipped by any of the planes, it is discarded.
  *
  * @name czm_discardIfClipped
  * @glslFunction
  *
  * @param {vec4[]} clippingPlanes The array of planes used to clip, defined in eyespace.
  * @param {int} clippingPlanesLength The number of planes in the array of clipping planes.
- * @param {bool} inclusive
  * @returns {float} The distance away from a clipped fragment, in eyespace
  */
-float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength, bool inclusive)
+float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength)
 {
     if (clippingPlanesLength > 0)
     {
-        bool clipped = inclusive;
         vec4 position = czm_windowToEyeCoordinates(gl_FragCoord);
         vec3 clipNormal = vec3(0.0);
         vec3 clipPosition = vec3(0.0);
@@ -34,18 +33,12 @@ float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clip
                 clipAmount = amount;
             }
 
-            if (inclusive) {
-                clipped = clipped && (amount <= 0.0);
-            } else {
-                clipped = clipped || (amount <= 0.0);
+            if (amount <= 0.0) {
+                discard;
+                return amount;
             }
         }
 
-        if (clipped)
-        {
-            discard;
-        }
-
         return clipAmount;
     }
 
diff --git a/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl b/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
new file mode 100644
index 000000000000..638b835ba378
--- /dev/null
+++ b/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
@@ -0,0 +1,49 @@
+/**
+ * Clip a fragment by an array of clipping planes. Clipping plane regions are combined, so a fragment must be clipped
+ * by all of the planes to be discarded.
+ *
+ * @name czm_discardIfClipped
+ * @glslFunction
+ *
+ * @param {vec4[]} clippingPlanes The array of planes used to clip, defined in eyespace.
+ * @param {int} clippingPlanesLength The number of planes in the array of clipping planes.
+ * @returns {float} The distance away from a clipped fragment, in eyespace
+ */
+float czm_discardIfClippedCombineRegions (vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength)
+{
+    if (clippingPlanesLength > 0)
+    {
+        bool clipped = true;
+        vec4 position = czm_windowToEyeCoordinates(gl_FragCoord);
+        vec3 clipNormal = vec3(0.0);
+        vec3 clipPosition = vec3(0.0);
+        float clipAmount = 0.0;
+
+        for (int i = 0; i < czm_maxClippingPlanes; ++i)
+        {
+            if (i == clippingPlanesLength)
+            {
+                break;
+            }
+
+            clipNormal = clippingPlanes[i].xyz;
+            clipPosition = -clippingPlanes[i].w * clipNormal;
+
+            float amount = dot(clipNormal, (position.xyz - clipPosition));
+            if (amount > clipAmount) {
+                clipAmount = amount;
+            }
+
+            clipped = clipped && (amount <= 0.0);
+        }
+
+        if (clipped)
+        {
+            discard;
+        }
+
+        return clipAmount;
+    }
+
+    return 0.0;
+}
diff --git a/Source/Shaders/GlobeFS.glsl b/Source/Shaders/GlobeFS.glsl
index be076f396704..aa47300d6301 100644
--- a/Source/Shaders/GlobeFS.glsl
+++ b/Source/Shaders/GlobeFS.glsl
@@ -55,7 +55,6 @@ uniform vec2 u_lightingFadeDistance;
 #ifdef ENABLE_CLIPPING_PLANES
 uniform int u_clippingPlanesLength;
 uniform vec4 u_clippingPlanes[czm_maxClippingPlanes];
-uniform bool u_clippingPlanesInclusive;
 uniform vec4 u_clippingPlanesEdgeColor;
 uniform float u_clippingPlanesEdgeWidth;
 #endif
@@ -150,7 +149,11 @@ vec4 computeWaterColor(vec3 positionEyeCoordinates, vec2 textureCoordinates, mat
 void main()
 {
 #ifdef ENABLE_CLIPPING_PLANES
-    float clipDistance = czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength, u_clippingPlanesInclusive);
+    #ifdef COMBINE_CLIPPING_REGIONS
+    float clipDistance = czm_discardIfClippedCombineRegions(u_clippingPlanes, u_clippingPlanesLength);
+    #else
+    float clipDistance = czm_discardIfClipped(u_clippingPlanes, u_clippingPlanesLength);
+    #endif
 #endif
 
     // The clamp below works around an apparent bug in Chrome Canary v23.0.1241.0

From 4a376901322e064cb38a3f8ea7c5a139915e3670 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 27 Nov 2017 12:21:50 -0500
Subject: [PATCH 18/37] Fix Plane geometry classes

---
 CHANGES.md                                 | 10 ++++----
 Source/Core/PlaneGeometry.js               | 12 +++------
 Source/Core/PlaneOutlineGeometry.js        | 29 ++++++----------------
 Source/DataSources/PlaneGeometryUpdater.js |  2 --
 4 files changed, 17 insertions(+), 36 deletions(-)

diff --git a/CHANGES.md b/CHANGES.md
index 918d68eb3014..6efaddfb0013 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -3,11 +3,11 @@ Change Log
 
 ## TODO release
 
-* Added `clippingPlanes` property to `ModelGraphics` and `Cesium3DTileset`, which specifies a `ClippingPlanesCollection` to clip the object. [TODO]()
-* Added `terrainClippingPlanes` property to `Globe` which specifies a `ClippingPlanesCollection` to clip the terrain.
-* Added `Plane.transformPlane` function to apply a transformation to a plane. [TODO]()
-* Added `PlaneGeometry` and `PlaneOutlineGeometry` primitives
-* Added `PlaneGraphics` and `plane` property to `Entity`.
+* Added `clippingPlanes` property to `ModelGraphics` and `Cesium3DTileset`, which specifies a `ClippingPlanesCollection` to clip the object. [#5913](https://github.com/AnalyticalGraphicsInc/cesium/pull/5913)
+* Added `terrainClippingPlanes` property to `Globe` which specifies a `ClippingPlanesCollection` to clip the terrain. [#5996](https://github.com/AnalyticalGraphicsInc/cesium/pull/5996)
+* Added `Plane.transformPlane` function to apply a transformation to a plane. [#5966](https://github.com/AnalyticalGraphicsInc/cesium/pull/5966)
+* Added `PlaneGeometry`, `PlaneOutlineGeometry`, and `PlaneOutlineGeometryUpdater` classes to render plane primitives. [#5996](https://github.com/AnalyticalGraphicsInc/cesium/pull/5996)
+* Added `PlaneGraphics` class and `plane` property to `Entity`. [#5996](https://github.com/AnalyticalGraphicsInc/cesium/pull/5996)
 
 ### 1.38 - 2017-10-02
 
diff --git a/Source/Core/PlaneGeometry.js b/Source/Core/PlaneGeometry.js
index 9a494d60415b..412b21ecf68f 100644
--- a/Source/Core/PlaneGeometry.js
+++ b/Source/Core/PlaneGeometry.js
@@ -25,23 +25,18 @@ define([
     'use strict';
 
     /**
-     * Describes a plane by a normal and distance from the origin in world coordinates.
+     * Describes geometry representing a plane centered at the origin, with a unit width and length.
      *
-     * @alias Plane
+     * @alias PlaneGeometry
      * @constructor
      *
      * @param {Object} options Object with the following properties:
      * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
      *
-     * @see Plane
-     * @see PlaneGeometry.createGeometry
-     * @see Packable
-     *
      * @example
      * var planeGeometry = new Cesium.PlaneGeometry({
      *   vertexFormat : Cesium.VertexFormat.POSITION_ONLY
      * });
-     * var geometry = Cesium.PlaneGeometry.createGeometry(plane);
      */
     function PlaneGeometry(options) {
         options = defaultValue(options, defaultValue.EMPTY_OBJECT);
@@ -110,6 +105,7 @@ define([
 
         return result;
     };
+
     /**
      * Computes the geometric representation of a plane, including its vertices, indices, and a bounding sphere.
      *
@@ -376,7 +372,7 @@ define([
             attributes : attributes,
             indices : indices,
             primitiveType : PrimitiveType.TRIANGLES,
-            boundingSphere : new BoundingSphere(Cartesian3.ZERO, 0.5)
+            boundingSphere : new BoundingSphere(Cartesian3.ZERO, Math.sqrt(2.0))
         });
     };
 
diff --git a/Source/Core/PlaneOutlineGeometry.js b/Source/Core/PlaneOutlineGeometry.js
index f3f0aaf55ff7..751c13bf5558 100644
--- a/Source/Core/PlaneOutlineGeometry.js
+++ b/Source/Core/PlaneOutlineGeometry.js
@@ -23,29 +23,16 @@ define([
     'use strict';
 
     /**
-     * A description of the outline of a cube centered at the origin.
+     * Describes geometry representing the outline of a plane centered at the origin, with a unit width and length.
      *
      * @alias PlaneOutlineGeometry
      * @constructor
      *
-     * @param {Object} options Object with the following properties:
-     * @param {Cartesian3} options.minimum The minimum x, y, and z coordinates of the box.
-     * @param {Cartesian3} options.maximum The maximum x, y, and z coordinates of the box.
-     *
-     * @see PlaneOutlineGeometry.fromDimensions
-     * @see PlaneOutlineGeometry.createGeometry
-     * @see Packable
-     *
-     * @example
-     * var box = new Cesium.PlaneOutlineGeometry({
-     *   maximum : new Cesium.Cartesian3(250000.0, 250000.0, 250000.0),
-     *   minimum : new Cesium.Cartesian3(-250000.0, -250000.0, -250000.0)
-     * });
-     * var geometry = Cesium.PlaneOutlineGeometry.createGeometry(box);
      */
-    function PlaneOutlineGeometry(options) {
+    function PlaneOutlineGeometry() {
         this._workerName = 'createPlaneOutlineGeometry';
     }
+
     /**
      * The number of elements used to pack the object into an array.
      * @type {Number}
@@ -61,7 +48,7 @@ define([
      *
      * @returns {Number[]} The array that was packed into
      */
-    PlaneOutlineGeometry.pack = function(value, array, startingIndex) {
+    PlaneOutlineGeometry.pack = function(value, array) {
         //>>includeStart('debug', pragmas.debug);
         Check.defined('array', array);
         //>>includeEnd('debug');
@@ -90,12 +77,12 @@ define([
     };
 
     /**
-     * Computes the geometric representation of an outline of a box, including its vertices, indices, and a bounding sphere.
+     * Computes the geometric representation of an outline of a plane, including its vertices, indices, and a bounding sphere.
      *
-     * @param {PlaneOutlineGeometry} boxGeometry A description of the box outline.
+     * @param {PlaneOutlineGeometry} planeGeometry A description of the plane outline.
      * @returns {Geometry|undefined} The computed vertices and indices.
      */
-    PlaneOutlineGeometry.createGeometry = function(boxGeometry) {
+    PlaneOutlineGeometry.createGeometry = function() {
         var min = new Cartesian3(-0.5, -0.5, 0.0);
         var max = new Cartesian3( 0.5,  0.5, 0.0);
 
@@ -135,7 +122,7 @@ define([
             attributes : attributes,
             indices : indices,
             primitiveType : PrimitiveType.LINES,
-            boundingSphere : new BoundingSphere(Cartesian3.ZERO, 0.5)
+            boundingSphere : new BoundingSphere(Cartesian3.ZERO, Math.sqrt(2.0))
         });
     };
 
diff --git a/Source/DataSources/PlaneGeometryUpdater.js b/Source/DataSources/PlaneGeometryUpdater.js
index 02117d691b1f..94013f39d01c 100644
--- a/Source/DataSources/PlaneGeometryUpdater.js
+++ b/Source/DataSources/PlaneGeometryUpdater.js
@@ -368,8 +368,6 @@ define([
             };
         }
 
-        var options = this._options;
-
         var modelMatrix = entity.computeModelMatrix(Iso8601.MINIMUM_VALUE);
 
         return new GeometryInstance({

From 93a29409024efba3e3e923d311e1518b94775d5f Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 27 Nov 2017 12:23:40 -0500
Subject: [PATCH 19/37] Fix doc

---
 Source/Core/PlaneOutlineGeometry.js | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Source/Core/PlaneOutlineGeometry.js b/Source/Core/PlaneOutlineGeometry.js
index 751c13bf5558..1f24a5876876 100644
--- a/Source/Core/PlaneOutlineGeometry.js
+++ b/Source/Core/PlaneOutlineGeometry.js
@@ -44,7 +44,6 @@ define([
      *
      * @param {PlaneOutlineGeometry} 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
      */

From 8d41a56186aeb95df21c3b63bd42ad20c64de95b Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 27 Nov 2017 13:49:21 -0500
Subject: [PATCH 20/37] Pixel width for edge highlighting, fix model transforms

---
 .../gallery/3D Tiles Clipping Planes.html     | 32 +++++++++----------
 Source/Scene/ClippingPlanesCollection.js      |  4 +--
 Source/Scene/Model.js                         |  2 +-
 .../Builtin/Functions/discardIfClipped.glsl   |  3 +-
 .../discardIfClippedCombineRegions.glsl       |  3 +-
 5 files changed, 23 insertions(+), 21 deletions(-)

diff --git a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html
index c7af66f4ef25..1c6e8e6d9dc9 100644
--- a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
@@ -50,10 +50,6 @@
 });
 var scene = viewer.scene;
 
-var defaultClippingPlanes = [
-    new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0,-1.0), -100.0)
-];
-
 var clipObjects = ['BIM', 'Point Cloud', 'Model'];
 var viewModel = {
     debugBoundingVolumesEnabled : false,
@@ -113,10 +109,14 @@
 
 var tileset;
 function loadTileset(url) {
+    var clippingPlanes = [
+        new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), -100.0)
+    ];
+
     tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
         url : url,
         clippingPlanes : new Cesium.ClippingPlanesCollection({
-            planes : defaultClippingPlanes,
+            planes : clippingPlanes,
             edgeWidth : 1.0
         })
     }));
@@ -128,9 +128,8 @@
         viewer.camera.viewBoundingSphere(boundingSphere, new Cesium.HeadingPitchRange(0.5, -0.2, radius * 4.0));
         viewer.camera.lookAtTransform(Cesium.Matrix4.IDENTITY);
 
-        for (var i = 0; i < defaultClippingPlanes.length; ++i) {
-            var clippingPlanes = tileset.clippingPlanes;
-            var plane = clippingPlanes.planes[i];
+        for (var i = 0; i < clippingPlanes.length; ++i) {
+            var plane = clippingPlanes[i];
             var planeEntity = viewer.entities.add({
                 position : boundingSphere.center,
                 plane : {
@@ -154,6 +153,10 @@
 
 var modelEntity;
 function loadModel(url) {
+    var clippingPlanes = [
+        new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), -100.0)
+    ];
+
     var position = Cesium.Cartesian3.fromDegrees(-123.0744619, 44.0503706, 100.0);
     var heading = Cesium.Math.toRadians(135.0);
     var pitch = 0.0;
@@ -169,9 +172,8 @@
             scale : 8,
             minimumPixelSize : 100.0,
             clippingPlanes : new Cesium.ClippingPlanesCollection({
-                planes : defaultClippingPlanes,
-                edgeWidth : 1.0,
-                modelMatrix : Cesium.Matrix4.fromRotationTranslation(Cesium.Matrix3.fromRotationX(-Cesium.Math.PI_OVER_TWO))
+                planes : clippingPlanes,
+                edgeWidth : 1.0
             })
         }
     });
@@ -179,11 +181,8 @@
     viewer.trackedEntity = entity;
     modelEntity = entity.model;
 
-    console.log(modelEntity);
-
-    for (var i = 0; i < defaultClippingPlanes.length; ++i) {
-        var clippingPlanes = tileset.clippingPlanes;
-        var plane = clippingPlanes.planes[i];
+    for (var i = 0; i < clippingPlanes.length; ++i) {
+        var plane = clippingPlanes[i];
         var planeEntity = viewer.entities.add({
             position : position,
             plane : {
@@ -236,6 +235,7 @@
     viewer.entities.removeAll();
     viewer.scene.primitives.removeAll();
     planeEntities = [];
+    targetY = 0.0;
 }
 
 //Sandcastle_End
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index e6d7bf1be8f1..5583ef81ceba 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -36,7 +36,7 @@ define([
      * @param {Matrix4} [options.modelMatrix=Matrix4.IDENTITY] The 4x4 transformation matrix specifying an additional transform relative to the clipping planes original coordinate system.
      * @param {Boolean} [options.combineClippingRegions=true] If true, the region to be clipped must be included in all planes in this collection. Otherwise, a region will be clipped if included in any plane in the collection.
      * @param {Color} [options.edgeColor=Color.WHITE] The color applied to highlight the edge along which an object is clipped.
-     * @param {Number} [options.edgeWidth=0.0] The width of the highlight applied to the edge along which an object is clipped.
+     * @param {Number} [options.edgeWidth=0.0] The width, in pixels, of the highlight applied to the edge along which an object is clipped.
      */
     function ClippingPlanesCollection(options) {
         options = defaultValue(options, defaultValue.EMPTY_OBJECT);
@@ -74,7 +74,7 @@ define([
         this.edgeColor = defaultValue(options.edgeColor, Color.clone(Color.WHITE));
 
         /**
-         * The width of the highlight applied to the edge along which an object is clipped.
+         * The width, in pixels, of the highlight applied to the edge along which an object is clipped.
          *
          * @type {Number}
          * @default 0.0
diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index e6d270601222..61194c4cbbbb 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -4750,7 +4750,7 @@ define([
 
             var clippingPlanes = this.clippingPlanes;
             if (defined(clippingPlanes) && clippingPlanes.enabled && modelViewChanged) {
-                Matrix4.multiply(context.uniformState.view3D, this._computedModelMatrix, this._modelViewMatrix);
+                Matrix4.multiply(context.uniformState.view3D, modelMatrix, this._modelViewMatrix);
             }
 
             // Update modelMatrix throughout the graph as needed
diff --git a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
index 6f9e740175e7..33896e5cbfc6 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
@@ -17,6 +17,7 @@ float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clip
         vec3 clipNormal = vec3(0.0);
         vec3 clipPosition = vec3(0.0);
         float clipAmount = 0.0;
+        float pixelWidth = czm_metersPerPixel(position);
 
         for (int i = 0; i < czm_maxClippingPlanes; ++i)
         {
@@ -28,7 +29,7 @@ float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clip
             clipNormal = clippingPlanes[i].xyz;
             clipPosition = -clippingPlanes[i].w * clipNormal;
 
-            float amount = dot(clipNormal, (position.xyz - clipPosition));
+            float amount = dot(clipNormal, (position.xyz - clipPosition)) / pixelWidth;
             if (amount > clipAmount) {
                 clipAmount = amount;
             }
diff --git a/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl b/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
index 638b835ba378..18b007c4c0e7 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
@@ -18,6 +18,7 @@ float czm_discardIfClippedCombineRegions (vec4[czm_maxClippingPlanes] clippingPl
         vec3 clipNormal = vec3(0.0);
         vec3 clipPosition = vec3(0.0);
         float clipAmount = 0.0;
+        float pixelWidth = czm_metersPerPixel(position);
 
         for (int i = 0; i < czm_maxClippingPlanes; ++i)
         {
@@ -29,7 +30,7 @@ float czm_discardIfClippedCombineRegions (vec4[czm_maxClippingPlanes] clippingPl
             clipNormal = clippingPlanes[i].xyz;
             clipPosition = -clippingPlanes[i].w * clipNormal;
 
-            float amount = dot(clipNormal, (position.xyz - clipPosition));
+            float amount = dot(clipNormal, (position.xyz - clipPosition)) / pixelWidth;
             if (amount > clipAmount) {
                 clipAmount = amount;
             }

From b4c9a8d72bb69073831de0dccfd2493f19ffacb8 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 27 Nov 2017 14:50:21 -0500
Subject: [PATCH 21/37] Point cloud clipping fix

---
 Source/Scene/PointCloud3DTileContent.js | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/Source/Scene/PointCloud3DTileContent.js b/Source/Scene/PointCloud3DTileContent.js
index 64b1791c208f..7a1de03680c4 100644
--- a/Source/Scene/PointCloud3DTileContent.js
+++ b/Source/Scene/PointCloud3DTileContent.js
@@ -117,6 +117,9 @@ define([
         this._hasNormals = false;
         this._hasBatchIds = false;
 
+        // Used to regenerate shader when clipping on this tile changes
+        this._isClipped = true;
+
         // Use per-point normals to hide back-facing points.
         this.backFaceCulling = false;
         this._backFaceCulling = false;
@@ -518,6 +521,7 @@ define([
         }
 
         var clippingPlanes = content._tileset.clippingPlanes;
+        var contentClipped = defined(clippingPlanes) && clippingPlanes.enabled;// && content._tile._isClipped;
         var scratchCartesian = new Cartesian4();
         var uniformMap = {
             u_pointSizeAndTilesetTime : function() {
@@ -537,7 +541,7 @@ define([
             u_clippingPlanes : function() {
                 var packedPlanes = content._packedClippingPlanes;
 
-                if (defined(clippingPlanes) && clippingPlanes.enabled) {
+                if (contentClipped) {
                     clippingPlanes.transformAndPackPlanes(content._modelViewMatrix, packedPlanes);
                 }
 
@@ -1251,6 +1255,12 @@ define([
             this._parsedContent = undefined; // Unload
         }
 
+        var isClipped = this._tile._isClipped;
+        if (this._isClipped !== isClipped) {
+            this._isClipped = isClipped;
+            createShaders(this, frameState, tileset.style);
+        }
+
         if (updateModelMatrix) {
             Matrix4.clone(modelMatrix, this._modelMatrix);
             if (defined(this._rtcCenter)) {

From 627b8d435c2608f249c3b3adb6a038e7a8506acb Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 27 Nov 2017 15:54:02 -0500
Subject: [PATCH 22/37] Update clipping planes example

---
 .../gallery/Terrain Clipping Planes.html      |  63 ++++++++++++++++--
 .../gallery/Terrain Clipping Planes.jpg       | Bin 32991 -> 39605 bytes
 2 files changed, 57 insertions(+), 6 deletions(-)

diff --git a/Apps/Sandcastle/gallery/Terrain Clipping Planes.html b/Apps/Sandcastle/gallery/Terrain Clipping Planes.html
index c925f37a2206..0570579157cc 100644
--- a/Apps/Sandcastle/gallery/Terrain Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/Terrain Clipping Planes.html	
@@ -19,16 +19,28 @@
 <body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
 <style>
     @import url(../templates/bucket.css);
+    #toolbar {
+        background: rgba(42, 42, 42, 0.8);
+        padding: 4px;
+        border-radius: 4px;
+    }
+    #toolbar input {
+        vertical-align: middle;
+        padding-top: 2px;
+        padding-bottom: 2px;
+    }
 </style>
 <div id="cesiumContainer" class="fullSize"></div>
 <div id="loadingOverlay"><h1>Loading...</h1></div>
-<div id="toolbar"></div>
+<div id="toolbar">
+    <input type="checkbox" value="false" data-bind="checked: clippingPlanesEnabled, valueUpdate: 'input'"> Globe clipping planes enabled
+</div>
 <script id="cesium_sandcastle_script">
 function startup(Cesium) {
     'use strict';
 //Sandcastle_Begin
 var viewer = new Cesium.Viewer('cesiumContainer', {
-    terrainExaggeration : 3.0
+    skyAtmosphere: false
 });
 
 viewer.terrainProvider = new Cesium.CesiumTerrainProvider({
@@ -37,13 +49,52 @@
     requestVertexNormals : true
 });
 
+var position = Cesium.Cartesian3.fromRadians(-2.0862979473351286, 0.6586620013036164, 1400.0);
+
+var entity = viewer.entities.add({
+    position : position,
+    box : {
+        dimensions : new Cesium.Cartesian3(1400.0, 1400.0, 2800.0),
+        material : Cesium.Color.WHITE.withAlpha(0.3),
+        outline : true,
+        outlineColor : Cesium.Color.WHITE
+    }
+});
+
+viewer.entities.add({
+    position : position,
+    model : {
+        uri : '../../SampleData/models/CesiumMan/Cesium_Man.glb',
+        minimumPixelSize : 128,
+        maximumScale : 800
+    }
+});
+
 var globe = viewer.scene.globe;
+globe.depthTestAgainstTerrain = true;
 globe.clippingPlanes = new Cesium.ClippingPlanesCollection({
-    modelMatrix : Cesium.Matrix4.fromTranslation(new Cesium.Cartesian3(0.0, 0.0, 3000000.0)),
+    modelMatrix : entity.computeModelMatrix(Cesium.JulianDate.now()),
     planes : [
-        new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 0.0),
-        new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, 1.0), 1000000.0)
-    ]
+        new Cesium.Plane(new Cesium.Cartesian3( 1.0,  0.0, 0.0), 700.0),
+        new Cesium.Plane(new Cesium.Cartesian3(-1.0,  0.0, 0.0), 700.0),
+        new Cesium.Plane(new Cesium.Cartesian3( 0.0,  1.0, 0.0), 700.0),
+        new Cesium.Plane(new Cesium.Cartesian3( 0.0, -1.0, 0.0), 700.0)
+    ],
+    edgeWidth: 1.0,
+    edgeColor: Cesium.Color.WHITE
+});
+
+viewer.trackedEntity = entity;
+
+var viewModel = {
+    clippingPlanesEnabled : true
+};
+var toolbar = document.getElementById('toolbar');
+Cesium.knockout.track(viewModel);
+Cesium.knockout.applyBindings(viewModel, toolbar);
+
+Cesium.knockout.getObservable(viewModel, 'clippingPlanesEnabled').subscribe(function(value) {
+    globe.clippingPlanes.enabled = value;
 });
 
 //Sandcastle_End
diff --git a/Apps/Sandcastle/gallery/Terrain Clipping Planes.jpg b/Apps/Sandcastle/gallery/Terrain Clipping Planes.jpg
index cb1bd06060d048db08ae0109ec7c89a98838cef8..d5c3198863c43a6e311779aa8bf188677ac673da 100644
GIT binary patch
literal 39605
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

delta 32526
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


From fd151a05d8bb16e993b65ddbe3bebc1ab09a6c56 Mon Sep 17 00:00:00 2001
From: Sean Lilley <lilleyse@gmail.com>
Date: Tue, 28 Nov 2017 10:36:51 -0500
Subject: [PATCH 23/37] Indent includes

---
 .../gallery/3D Tiles Clipping Planes.html     |   1 -
 Source/Core/PlaneGeometry.js                  |  46 +++----
 Source/Core/PlaneOutlineGeometry.js           |  42 +++----
 Source/DataSources/PlaneGeometryUpdater.js    | 114 +++++++++---------
 Source/DataSources/PlaneGraphics.js           |  28 ++---
 Source/Scene/ClippingPlanesCollection.js      |  46 +++----
 Source/Workers/createPlaneOutlineGeometry.js  |  10 +-
 7 files changed, 143 insertions(+), 144 deletions(-)

diff --git a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html
index 1c6e8e6d9dc9..83728564225b 100644
--- a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
@@ -143,7 +143,6 @@
 
             planeEntities.push(planeEntity);
         }
-
     }).otherwise(function(error) {
         throw(error);
     });
diff --git a/Source/Core/PlaneGeometry.js b/Source/Core/PlaneGeometry.js
index 412b21ecf68f..caf03b3b437d 100644
--- a/Source/Core/PlaneGeometry.js
+++ b/Source/Core/PlaneGeometry.js
@@ -1,27 +1,27 @@
 define([
-    './BoundingSphere',
-    './Cartesian3',
-    './Check',
-    './ComponentDatatype',
-    './defaultValue',
-    './defined',
-    './Geometry',
-    './GeometryAttribute',
-    './GeometryAttributes',
-    './PrimitiveType',
-    './VertexFormat'
-], function(
-    BoundingSphere,
-    Cartesian3,
-    Check,
-    ComponentDatatype,
-    defaultValue,
-    defined,
-    Geometry,
-    GeometryAttribute,
-    GeometryAttributes,
-    PrimitiveType,
-    VertexFormat) {
+        './BoundingSphere',
+        './Cartesian3',
+        './Check',
+        './ComponentDatatype',
+        './defaultValue',
+        './defined',
+        './Geometry',
+        './GeometryAttribute',
+        './GeometryAttributes',
+        './PrimitiveType',
+        './VertexFormat'
+    ], function(
+        BoundingSphere,
+        Cartesian3,
+        Check,
+        ComponentDatatype,
+        defaultValue,
+        defined,
+        Geometry,
+        GeometryAttribute,
+        GeometryAttributes,
+        PrimitiveType,
+        VertexFormat) {
     'use strict';
 
     /**
diff --git a/Source/Core/PlaneOutlineGeometry.js b/Source/Core/PlaneOutlineGeometry.js
index 1f24a5876876..a83ac781782f 100644
--- a/Source/Core/PlaneOutlineGeometry.js
+++ b/Source/Core/PlaneOutlineGeometry.js
@@ -1,25 +1,25 @@
 define([
-    './BoundingSphere',
-    './Cartesian3',
-    './Check',
-    './ComponentDatatype',
-    './defaultValue',
-    './defined',
-    './Geometry',
-    './GeometryAttribute',
-    './GeometryAttributes',
-    './PrimitiveType'
-], function(
-    BoundingSphere,
-    Cartesian3,
-    Check,
-    ComponentDatatype,
-    defaultValue,
-    defined,
-    Geometry,
-    GeometryAttribute,
-    GeometryAttributes,
-    PrimitiveType) {
+        './BoundingSphere',
+        './Cartesian3',
+        './Check',
+        './ComponentDatatype',
+        './defaultValue',
+        './defined',
+        './Geometry',
+        './GeometryAttribute',
+        './GeometryAttributes',
+        './PrimitiveType'
+    ], function(
+        BoundingSphere,
+        Cartesian3,
+        Check,
+        ComponentDatatype,
+        defaultValue,
+        defined,
+        Geometry,
+        GeometryAttribute,
+        GeometryAttributes,
+        PrimitiveType) {
     'use strict';
 
     /**
diff --git a/Source/DataSources/PlaneGeometryUpdater.js b/Source/DataSources/PlaneGeometryUpdater.js
index 94013f39d01c..314877f467c8 100644
--- a/Source/DataSources/PlaneGeometryUpdater.js
+++ b/Source/DataSources/PlaneGeometryUpdater.js
@@ -1,61 +1,61 @@
 define([
-    '../Core/PlaneGeometry',
-    '../Core/PlaneOutlineGeometry',
-    '../Core/Cartesian2',
-    '../Core/Cartesian3',
-    '../Core/Color',
-    '../Core/ColorGeometryInstanceAttribute',
-    '../Core/defaultValue',
-    '../Core/defined',
-    '../Core/defineProperties',
-    '../Core/destroyObject',
-    '../Core/DeveloperError',
-    '../Core/DistanceDisplayCondition',
-    '../Core/DistanceDisplayConditionGeometryInstanceAttribute',
-    '../Core/Event',
-    '../Core/GeometryInstance',
-    '../Core/Iso8601',
-    '../Core/Matrix4',
-    '../Core/ShowGeometryInstanceAttribute',
-    '../Core/Quaternion',
-    '../Scene/MaterialAppearance',
-    '../Scene/PerInstanceColorAppearance',
-    '../Scene/Primitive',
-    '../Scene/ShadowMode',
-    './ColorMaterialProperty',
-    './ConstantProperty',
-    './dynamicGeometryGetBoundingSphere',
-    './MaterialProperty',
-    './Property'
-], function(
-    PlaneGeometry,
-    PlaneOutlineGeometry,
-    Cartesian2,
-    Cartesian3,
-    Color,
-    ColorGeometryInstanceAttribute,
-    defaultValue,
-    defined,
-    defineProperties,
-    destroyObject,
-    DeveloperError,
-    DistanceDisplayCondition,
-    DistanceDisplayConditionGeometryInstanceAttribute,
-    Event,
-    GeometryInstance,
-    Iso8601,
-    Matrix4,
-    ShowGeometryInstanceAttribute,
-    Quaternion,
-    MaterialAppearance,
-    PerInstanceColorAppearance,
-    Primitive,
-    ShadowMode,
-    ColorMaterialProperty,
-    ConstantProperty,
-    dynamicGeometryGetBoundingSphere,
-    MaterialProperty,
-    Property) {
+        '../Core/PlaneGeometry',
+        '../Core/PlaneOutlineGeometry',
+        '../Core/Cartesian2',
+        '../Core/Cartesian3',
+        '../Core/Color',
+        '../Core/ColorGeometryInstanceAttribute',
+        '../Core/defaultValue',
+        '../Core/defined',
+        '../Core/defineProperties',
+        '../Core/destroyObject',
+        '../Core/DeveloperError',
+        '../Core/DistanceDisplayCondition',
+        '../Core/DistanceDisplayConditionGeometryInstanceAttribute',
+        '../Core/Event',
+        '../Core/GeometryInstance',
+        '../Core/Iso8601',
+        '../Core/Matrix4',
+        '../Core/ShowGeometryInstanceAttribute',
+        '../Core/Quaternion',
+        '../Scene/MaterialAppearance',
+        '../Scene/PerInstanceColorAppearance',
+        '../Scene/Primitive',
+        '../Scene/ShadowMode',
+        './ColorMaterialProperty',
+        './ConstantProperty',
+        './dynamicGeometryGetBoundingSphere',
+        './MaterialProperty',
+        './Property'
+    ], function(
+        PlaneGeometry,
+        PlaneOutlineGeometry,
+        Cartesian2,
+        Cartesian3,
+        Color,
+        ColorGeometryInstanceAttribute,
+        defaultValue,
+        defined,
+        defineProperties,
+        destroyObject,
+        DeveloperError,
+        DistanceDisplayCondition,
+        DistanceDisplayConditionGeometryInstanceAttribute,
+        Event,
+        GeometryInstance,
+        Iso8601,
+        Matrix4,
+        ShowGeometryInstanceAttribute,
+        Quaternion,
+        MaterialAppearance,
+        PerInstanceColorAppearance,
+        Primitive,
+        ShadowMode,
+        ColorMaterialProperty,
+        ConstantProperty,
+        dynamicGeometryGetBoundingSphere,
+        MaterialProperty,
+        Property) {
     'use strict';
 
     var defaultMaterial = new ColorMaterialProperty(Color.WHITE);
diff --git a/Source/DataSources/PlaneGraphics.js b/Source/DataSources/PlaneGraphics.js
index 59348494fea5..38636f7d9406 100644
--- a/Source/DataSources/PlaneGraphics.js
+++ b/Source/DataSources/PlaneGraphics.js
@@ -1,19 +1,19 @@
 define([
-    '../Core/defaultValue',
-    '../Core/defined',
-    '../Core/defineProperties',
-    '../Core/DeveloperError',
-    '../Core/Event',
-    './createMaterialPropertyDescriptor',
-    './createPropertyDescriptor'
+        '../Core/defaultValue',
+        '../Core/defined',
+        '../Core/defineProperties',
+        '../Core/DeveloperError',
+        '../Core/Event',
+        './createMaterialPropertyDescriptor',
+        './createPropertyDescriptor'
 ], function(
-    defaultValue,
-    defined,
-    defineProperties,
-    DeveloperError,
-    Event,
-    createMaterialPropertyDescriptor,
-    createPropertyDescriptor) {
+        defaultValue,
+        defined,
+        defineProperties,
+        DeveloperError,
+        Event,
+        createMaterialPropertyDescriptor,
+        createPropertyDescriptor) {
     'use strict';
 
     /**
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index 5583ef81ceba..f905131a8925 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -1,27 +1,27 @@
 define([
-    '../Core/BoundingSphere',
-    '../Core/buildModuleUrl',
-    '../Core/Cartesian3',
-    '../Core/Cartographic',
-    '../Core/Color',
-    '../Core/defaultValue',
-    '../Core/defined',
-    '../Core/defineProperties',
-    '../Core/Intersect',
-    '../Core/Matrix4',
-    '../Core/Plane'
-], function(
-    BoundingSphere,
-    buildModuleUrl,
-    Cartesian3,
-    Cartographic,
-    Color,
-    defaultValue,
-    defined,
-    defineProperties,
-    Intersect,
-    Matrix4,
-    Plane) {
+        '../Core/BoundingSphere',
+        '../Core/buildModuleUrl',
+        '../Core/Cartesian3',
+        '../Core/Cartographic',
+        '../Core/Color',
+        '../Core/defaultValue',
+        '../Core/defined',
+        '../Core/defineProperties',
+        '../Core/Intersect',
+        '../Core/Matrix4',
+        '../Core/Plane'
+    ], function(
+        BoundingSphere,
+        buildModuleUrl,
+        Cartesian3,
+        Cartographic,
+        Color,
+        defaultValue,
+        defined,
+        defineProperties,
+        Intersect,
+        Matrix4,
+        Plane) {
     'use strict';
 
     /**
diff --git a/Source/Workers/createPlaneOutlineGeometry.js b/Source/Workers/createPlaneOutlineGeometry.js
index 7f91ee8b6e9e..c2f5a7a7ff4a 100644
--- a/Source/Workers/createPlaneOutlineGeometry.js
+++ b/Source/Workers/createPlaneOutlineGeometry.js
@@ -1,9 +1,9 @@
 define([
-    '../Core/PlaneOutlineGeometry',
-    '../Core/defined'
-], function(
-    PlaneOutlineGeometry,
-    defined) {
+        '../Core/PlaneOutlineGeometry',
+        '../Core/defined'
+    ], function(
+        PlaneOutlineGeometry,
+        defined) {
     'use strict';
 
     return function(planeGeometry, offset) {

From 5b75ee5a3b5e83def64c44c4204735b2fcb8bd1c Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Wed, 29 Nov 2017 12:35:53 -0500
Subject: [PATCH 24/37] Cleanup and add plane geometry sandcastle example

---
 .../gallery/3D Tiles Clipping Planes.html     |  41 ++++++--
 Apps/Sandcastle/gallery/Plane.html            |  77 +++++++++++++++
 Apps/Sandcastle/gallery/Plane.jpg             | Bin 0 -> 39003 bytes
 Source/Core/PlaneGeometry.js                  |   4 +-
 Source/Core/PlaneOutlineGeometry.js           |   1 -
 Source/DataSources/ModelGraphics.js           |   2 +-
 Source/DataSources/PlaneGeometryUpdater.js    |  56 ++++++++---
 Source/DataSources/PlaneGraphics.js           |  27 +++---
 Source/Scene/Batched3DModel3DTileContent.js   |   4 +-
 Source/Scene/Cesium3DTileset.js               |   2 +-
 Source/Scene/ClippingPlanesCollection.js      |  87 ++++++++++-------
 Source/Scene/Globe.js                         |   1 +
 Source/Scene/GlobeSurfaceTileProvider.js      |  13 ++-
 Source/Scene/Model.js                         |  88 ++++++++++--------
 Source/Scene/PointCloud3DTileContent.js       |  40 ++++----
 .../Builtin/Functions/discardIfClipped.glsl   |   8 +-
 .../discardIfClippedCombineRegions.glsl       |   4 +-
 Source/Shaders/GlobeFS.glsl                   |  11 ++-
 18 files changed, 309 insertions(+), 157 deletions(-)
 create mode 100644 Apps/Sandcastle/gallery/Plane.html
 create mode 100644 Apps/Sandcastle/gallery/Plane.jpg

diff --git a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html
index 83728564225b..22a3fb7d3632 100644
--- a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
@@ -38,12 +38,17 @@
 <div id="toolbar">
     <select data-bind="options: exampleTypes, value: currentExampleType"></select>
     <input type="checkbox" value="false" data-bind="checked: debugBoundingVolumesEnabled, valueUpdate: 'input'"> Show bounding volume
+    <input type="checkbox" value="true" data-bind="checked: edgeStylingEnabled, valueUpdate: 'input'"> Enable edge styling
 </div>
 
 <script id="cesium_sandcastle_script">
 function startup(Cesium) {
     'use strict';
 //Sandcastle_Begin
+
+// Add a clipping plane, a plane geometry to show the representation of the
+// plane, and control the magnitude of the plane distance with the mouse.
+
 var viewer = new Cesium.Viewer('cesiumContainer', {
     infoBox: false,
     selectionIndicator: false
@@ -53,6 +58,7 @@
 var clipObjects = ['BIM', 'Point Cloud', 'Model'];
 var viewModel = {
     debugBoundingVolumesEnabled : false,
+    edgeStylingEnabled : true,
     exampleTypes : clipObjects,
     currentExampleType : clipObjects[0]
 };
@@ -117,7 +123,7 @@
         url : url,
         clippingPlanes : new Cesium.ClippingPlanesCollection({
             planes : clippingPlanes,
-            edgeWidth : 1.0
+            edgeWidth : viewModel.edgeStylingEnabled ? 1.0 : 0.0
         })
     }));
 
@@ -150,12 +156,21 @@
     tileset.debugShowBoundingVolume = viewModel.debugBoundingVolumesEnabled;
 }
 
-var modelEntity;
+var modelEntityClippingPlanes;
 function loadModel(url) {
     var clippingPlanes = [
         new Cesium.Plane(new Cesium.Cartesian3(0.0, 0.0, -1.0), -100.0)
     ];
 
+    modelEntityClippingPlanes = new Cesium.ClippingPlanesCollection({
+        planes : clippingPlanes,
+        edgeWidth : viewModel.edgeStylingEnabled ? 1.0 : 0.0
+    });
+
+    function updateClippingPlanes() {
+        return modelEntityClippingPlanes;
+    }
+
     var position = Cesium.Cartesian3.fromDegrees(-123.0744619, 44.0503706, 100.0);
     var heading = Cesium.Math.toRadians(135.0);
     var pitch = 0.0;
@@ -170,15 +185,11 @@
             uri : url,
             scale : 8,
             minimumPixelSize : 100.0,
-            clippingPlanes : new Cesium.ClippingPlanesCollection({
-                planes : clippingPlanes,
-                edgeWidth : 1.0
-            })
+            clippingPlanes : new Cesium.CallbackProperty(updateClippingPlanes, false)
         }
     });
 
     viewer.trackedEntity = entity;
-    modelEntity = entity.model;
 
     for (var i = 0; i < clippingPlanes.length; ++i) {
         var plane = clippingPlanes[i];
@@ -224,9 +235,21 @@
     }
 });
 
-Cesium.knockout.getObservable(viewModel, 'debugBoundingVolumesEnabled').subscribe(function(newValue) {
+Cesium.knockout.getObservable(viewModel, 'debugBoundingVolumesEnabled').subscribe(function(value) {
     if (Cesium.defined(tileset)) {
-        tileset.debugShowBoundingVolume = newValue;
+        tileset.debugShowBoundingVolume = value;
+    }
+});
+
+Cesium.knockout.getObservable(viewModel, 'edgeStylingEnabled').subscribe(function(value) {
+    var edgeWidth = value ? 1.0 : 0.0;
+
+    if (Cesium.defined(tileset)) {
+        tileset.clippingPlanes.edgeWidth = edgeWidth;
+    }
+
+    if (Cesium.defined(modelEntityClippingPlanes)) {
+        modelEntityClippingPlanes.edgeWidth = edgeWidth;
     }
 });
 
diff --git a/Apps/Sandcastle/gallery/Plane.html b/Apps/Sandcastle/gallery/Plane.html
new file mode 100644
index 000000000000..2e4c6e8cef46
--- /dev/null
+++ b/Apps/Sandcastle/gallery/Plane.html
@@ -0,0 +1,77 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no">
+    <meta name="description" content="Draw a plane geometry.">
+    <meta name="cesium-sandcastle-labels" content="Geometries">
+    <title>Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script type="text/javascript" src="../../../ThirdParty/requirejs-2.1.20/require.js"></script>
+    <script type="text/javascript">
+        require.config({
+            baseUrl : '../../../Source',
+            waitSeconds : 60
+        });
+    </script>
+</head>
+<body class="sandcastle-loading" data-sandcastle-bucket="bucket-requirejs.html">
+<style>
+    @import url(../templates/bucket.css);
+</style>
+<div id="cesiumContainer" class="fullSize"></div>
+<div id="loadingOverlay"><h1>Loading...</h1></div>
+<div id="toolbar"></div>
+<script id="cesium_sandcastle_script">
+    function startup(Cesium) {
+        'use strict';
+//Sandcastle_Begin
+var viewer = new Cesium.Viewer('cesiumContainer');
+
+var bluePlane = viewer.entities.add({
+    name : 'Blue plane',
+    position: Cesium.Cartesian3.fromDegrees(-114.0, 40.0, 300000.0),
+    plane : {
+        plane : new Cesium.Plane(Cesium.Cartesian3.UNIT_X, 0.0),
+        dimensions : new Cesium.Cartesian2(400000.0, 300000.0),
+        material : Cesium.Color.BLUE
+    }
+});
+
+var redPlane = viewer.entities.add({
+    name : 'Red plane with black outline',
+    position: Cesium.Cartesian3.fromDegrees(-107.0, 40.0, 300000.0),
+    plane : {
+        plane : new Cesium.Plane(Cesium.Cartesian3.UNIT_Y, 0.0),
+        dimensions : new Cesium.Cartesian2(400000.0, 300000.0),
+        material : Cesium.Color.RED.withAlpha(0.5),
+        outline : true,
+        outlineColor : Cesium.Color.BLACK
+    }
+});
+
+var outlineOnly = viewer.entities.add({
+    name : 'Yellow plane outline',
+    position: Cesium.Cartesian3.fromDegrees(-100.0, 40.0, 300000.0),
+    plane : {
+        plane : new Cesium.Plane(Cesium.Cartesian3.UNIT_Z, 0.0),
+        dimensions : new Cesium.Cartesian2(400000.0, 300000.0),
+        fill : false,
+        outline : true,
+        outlineColor : Cesium.Color.YELLOW
+    }
+});
+
+viewer.zoomTo(viewer.entities);
+//Sandcastle_End
+        Sandcastle.finishedLoading();
+    }
+    if (typeof Cesium !== "undefined") {
+        startup(Cesium);
+    } else if (typeof require === "function") {
+        require(["Cesium"], startup);
+    }
+</script>
+</body>
+</html>
diff --git a/Apps/Sandcastle/gallery/Plane.jpg b/Apps/Sandcastle/gallery/Plane.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..4fcb0355e641ece73baf7c0c7e0c205e094f2280
GIT binary patch
literal 39003
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

literal 0
HcmV?d00001

diff --git a/Source/Core/PlaneGeometry.js b/Source/Core/PlaneGeometry.js
index caf03b3b437d..c46c9ad8df6b 100644
--- a/Source/Core/PlaneGeometry.js
+++ b/Source/Core/PlaneGeometry.js
@@ -86,7 +86,7 @@ define([
      * @param {Number[]} array The packed array.
      * @param {Number} [startingIndex=0] The starting index of the element to be unpacked.
      * @param {PlaneGeometry} [result] The object into which to store the result.
-     * @returns {PlaneGeometry} The modified result parameter or a new BoxGeometry instance if one was not provided.
+     * @returns {PlaneGeometry} The modified result parameter or a new PlaneGeometry instance if one was not provided.
      */
     PlaneGeometry.unpack = function(array, startingIndex, result) {
         //>>includeStart('debug', pragmas.debug);
@@ -372,7 +372,7 @@ define([
             attributes : attributes,
             indices : indices,
             primitiveType : PrimitiveType.TRIANGLES,
-            boundingSphere : new BoundingSphere(Cartesian3.ZERO, Math.sqrt(2.0))
+            boundingSphere : new BoundingSphere(Cartesian3.ZERO, Math.sqrt(2.0)/2.0)
         });
     };
 
diff --git a/Source/Core/PlaneOutlineGeometry.js b/Source/Core/PlaneOutlineGeometry.js
index a83ac781782f..d4cb7245b300 100644
--- a/Source/Core/PlaneOutlineGeometry.js
+++ b/Source/Core/PlaneOutlineGeometry.js
@@ -78,7 +78,6 @@ define([
     /**
      * Computes the geometric representation of an outline of a plane, including its vertices, indices, and a bounding sphere.
      *
-     * @param {PlaneOutlineGeometry} planeGeometry A description of the plane outline.
      * @returns {Geometry|undefined} The computed vertices and indices.
      */
     PlaneOutlineGeometry.createGeometry = function() {
diff --git a/Source/DataSources/ModelGraphics.js b/Source/DataSources/ModelGraphics.js
index e0e4ec7d2b10..eddda212b0ec 100644
--- a/Source/DataSources/ModelGraphics.js
+++ b/Source/DataSources/ModelGraphics.js
@@ -252,7 +252,7 @@ define([
          * @memberof ModelGraphics.prototype
          * @type {Property}
          */
-        clippingPlanes: createPropertyDescriptor('clippingPlanes')
+        clippingPlanes : createPropertyDescriptor('clippingPlanes')
     });
 
     /**
diff --git a/Source/DataSources/PlaneGeometryUpdater.js b/Source/DataSources/PlaneGeometryUpdater.js
index 314877f467c8..14877ad8aff2 100644
--- a/Source/DataSources/PlaneGeometryUpdater.js
+++ b/Source/DataSources/PlaneGeometryUpdater.js
@@ -368,7 +368,19 @@ define([
             };
         }
 
-        var modelMatrix = entity.computeModelMatrix(Iso8601.MINIMUM_VALUE);
+        var planeGraphics = entity.plane;
+        var options = this._options;
+        var modelMatrix = entity.computeModelMatrix(time);
+        var plane = Property.getValueOrDefault(planeGraphics.plane, time, options.plane);
+        var dimensions = Property.getValueOrUndefined(planeGraphics.dimensions, time, options.dimensions);
+        if (!defined(modelMatrix) || !defined(plane) || !defined(dimensions)) {
+            return;
+        }
+
+        options.plane = plane;
+        options.dimensions = dimensions;
+
+        modelMatrix = createPrimitiveMatrix(plane, dimensions, modelMatrix, modelMatrix);
 
         return new GeometryInstance({
             id : entity,
@@ -402,7 +414,19 @@ define([
         var outlineColor = Property.getValueOrDefault(this._outlineColorProperty, time, Color.BLACK);
         var distanceDisplayCondition = this._distanceDisplayConditionProperty.getValue(time);
 
-        var modelMatrix = entity.computeModelMatrix(Iso8601.MINIMUM_VALUE);
+        var planeGraphics = entity.plane;
+        var options = this._options;
+        var modelMatrix = entity.computeModelMatrix(time);
+        var plane = Property.getValueOrDefault(planeGraphics.plane, time, options.plane);
+        var dimensions = Property.getValueOrUndefined(planeGraphics.dimensions, time, options.dimensions);
+        if (!defined(modelMatrix) || !defined(plane) || !defined(dimensions)) {
+            return;
+        }
+
+        options.plane = plane;
+        options.dimensions = dimensions;
+
+        modelMatrix = createPrimitiveMatrix(plane, dimensions, modelMatrix, modelMatrix);
 
         return new GeometryInstance({
             id : entity,
@@ -439,7 +463,6 @@ define([
         if (!(propertyName === 'availability' || propertyName === 'position' || propertyName === 'orientation' || propertyName === 'plane')) {
             return;
         }
-
         var planeGraphics = this._entity.plane;
 
         if (!defined(planeGraphics)) {
@@ -581,7 +604,7 @@ define([
         options.plane = plane;
         options.dimensions = dimensions;
 
-        modelMatrix = createPrimitiveMatrix(plane.normal, plane.distance, dimensions, modelMatrix, modelMatrix);
+        modelMatrix = createPrimitiveMatrix(plane, dimensions, modelMatrix, modelMatrix);
 
         var shadows = this._geometryUpdater.shadowsProperty.getValue(time);
 
@@ -648,16 +671,19 @@ define([
     var scratchTranslation = new Cartesian3();
     var scratchNormal = new Cartesian3();
     var scratchScale = new Cartesian3();
-    var defaultDimensions = new Cartesian2(1.0, 1.0);
-    function createPrimitiveMatrix (normal, distance, dimensions, modelMatrix, result) {
-        if (!defined(normal)) {
-            normal = Cartesian3.UNIT_X;
-        }
-        if (!defined(distance)) {
+    function createPrimitiveMatrix (plane, dimensions, modelMatrix, result) {
+        var normal;
+        var distance;
+        if (defined(plane)) {
+            normal = plane.normal;
+            distance = plane.distance;
+        } else {
+            normal = Cartesian3.clone(Cartesian3.UNIT_X, scratchNormal);
             distance = 0.0;
         }
+
         if (!defined(dimensions)) {
-            dimensions = defaultDimensions;
+            dimensions = new Cartesian2(1.0, 1.0);
         }
 
         var translation = Cartesian3.multiplyByScalar(normal, distance, scratchTranslation);
@@ -674,14 +700,16 @@ define([
     }
 
     // get a rotation according to a normal
+    var scratchAxis = new Cartesian3();
+    var scratchQuaternion = new Quaternion();
     function getRotationMatrix(direction, up) {
         var angle = Cartesian3.angleBetween(direction, up);
         if (angle === 0.0) {
-            return Quaternion.IDENTITY;
+            return Quaternion.clone(Quaternion.IDENTITY, scratchQuaternion);
         }
 
-        var axis = Cartesian3.cross(up, direction, new Cartesian3());
-        return Quaternion.fromAxisAngle(axis, angle);
+        var axis = Cartesian3.cross(up, direction, scratchAxis);
+        return Quaternion.fromAxisAngle(axis, angle, scratchQuaternion);
     }
 
     DynamicGeometryUpdater.prototype.getBoundingSphere = function(entity, result) {
diff --git a/Source/DataSources/PlaneGraphics.js b/Source/DataSources/PlaneGraphics.js
index 38636f7d9406..5e5cf3dab481 100644
--- a/Source/DataSources/PlaneGraphics.js
+++ b/Source/DataSources/PlaneGraphics.js
@@ -25,20 +25,21 @@ define([
      * @param {Object} [options] Object with the following properties:
      * @param {Property} [options.plane] A {@link Plane} Property specifying the normal and distance for the plane.
      * @param {Property} [options.dimensions] A {@link Cartesian2} Property specifying the width and height of the plane.
-     * @param {Property} [options.show=true] A boolean Property specifying the visibility of the box.
-     * @param {Property} [options.fill=true] A boolean Property specifying whether the box is filled with the provided material.
-     * @param {MaterialProperty} [options.material=Color.WHITE] A Property specifying the material used to fill the box.
-     * @param {Property} [options.outline=false] A boolean Property specifying whether the box is outlined.
+     * @param {Property} [options.show=true] A boolean Property specifying the visibility of the plane.
+     * @param {Property} [options.fill=true] A boolean Property specifying whether the plane is filled with the provided material.
+     * @param {MaterialProperty} [options.material=Color.WHITE] A Property specifying the material used to fill the plane.
+     * @param {Property} [options.outline=false] A boolean Property specifying whether the plane is outlined.
      * @param {Property} [options.outlineColor=Color.BLACK] A Property specifying the {@link Color} of the outline.
      * @param {Property} [options.outlineWidth=1.0] A numeric Property specifying the width of the outline.
-     * @param {Property} [options.shadows=ShadowMode.DISABLED] An enum Property specifying whether the box casts or receives shadows from each light source.
-     * @param {Property} [options.distanceDisplayCondition] A Property specifying at what distance from the camera that this box will be displayed.
+     * @param {Property} [options.shadows=ShadowMode.DISABLED] An enum Property specifying whether the plane casts or receives shadows from each light source.
+     * @param {Property} [options.distanceDisplayCondition] A Property specifying at what distance from the camera that this plane will be displayed.
      *
-     * @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=Box.html|Cesium Sandcastle Box Demo}
+     * @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=Plane.html|Cesium Sandcastle Plane Demo}
      */
     function PlaneGraphics(options) {
         this._plane = undefined;
         this._planeSubscription = undefined;
+        this._dimensions = undefined;
         this._dimensionsSubscription = undefined;
         this._show = undefined;
         this._showSubscription = undefined;
@@ -75,7 +76,7 @@ define([
         },
 
         /**
-         * Gets or sets the boolean Property specifying the visibility of the box.
+         * Gets or sets the boolean Property specifying the visibility of the plane.
          * @memberof PlaneGraphics.prototype
          * @type {Property}
          * @default true
@@ -99,7 +100,7 @@ define([
         dimensions : createPropertyDescriptor('dimensions'),
 
         /**
-         * Gets or sets the material used to fill the box.
+         * Gets or sets the material used to fill the plane.
          * @memberof PlaneGraphics.prototype
          * @type {MaterialProperty}
          * @default Color.WHITE
@@ -107,7 +108,7 @@ define([
         material : createMaterialPropertyDescriptor('material'),
 
         /**
-         * Gets or sets the boolean Property specifying whether the box is filled with the provided material.
+         * Gets or sets the boolean Property specifying whether the plane is filled with the provided material.
          * @memberof PlaneGraphics.prototype
          * @type {Property}
          * @default true
@@ -115,7 +116,7 @@ define([
         fill : createPropertyDescriptor('fill'),
 
         /**
-         * Gets or sets the Property specifying whether the box is outlined.
+         * Gets or sets the Property specifying whether the plane is outlined.
          * @memberof PlaneGraphics.prototype
          * @type {Property}
          * @default false
@@ -139,7 +140,7 @@ define([
         outlineWidth : createPropertyDescriptor('outlineWidth'),
 
         /**
-         * Get or sets the enum Property specifying whether the box
+         * Get or sets the enum Property specifying whether the plane
          * casts or receives shadows from each light source.
          * @memberof PlaneGraphics.prototype
          * @type {Property}
@@ -148,7 +149,7 @@ define([
         shadows : createPropertyDescriptor('shadows'),
 
         /**
-         * Gets or sets the {@link DistanceDisplayCondition} Property specifying at what distance from the camera that this box will be displayed.
+         * Gets or sets the {@link DistanceDisplayCondition} Property specifying at what distance from the camera that this plane will be displayed.
          * @memberof PlaneGraphics.prototype
          * @type {Property}
          */
diff --git a/Source/Scene/Batched3DModel3DTileContent.js b/Source/Scene/Batched3DModel3DTileContent.js
index 27e1c0403b77..42deb3e41ccb 100644
--- a/Source/Scene/Batched3DModel3DTileContent.js
+++ b/Source/Scene/Batched3DModel3DTileContent.js
@@ -378,7 +378,7 @@ define([
             pickUniformMapLoaded : batchTable.getPickUniformMapCallback(),
             addBatchIdToGeneratedShaders : (batchLength > 0), // If the batch table has values in it, generated shaders will need a batchId attribute
             pickObject : pickObject,
-            clippingPlanes : tileset.clippingPlanes
+            clippingPlanes : tileset.clippingPlanes.clone()
         });
     }
 
@@ -452,7 +452,7 @@ define([
         // Update clipping planes
         var tilesetClippingPlanes = this._tileset.clippingPlanes;
         if (defined(tilesetClippingPlanes)) {
-            var modelClippingPlanes = this._model.clippingPlanes.planes;
+            var modelClippingPlanes = this._model.clippingPlanes;
             tilesetClippingPlanes.clone(modelClippingPlanes);
             modelClippingPlanes.enabled = tilesetClippingPlanes.enabled && this._tile._isClipped;
         }
diff --git a/Source/Scene/Cesium3DTileset.js b/Source/Scene/Cesium3DTileset.js
index 2a88231f0dc1..adcadce80fc7 100644
--- a/Source/Scene/Cesium3DTileset.js
+++ b/Source/Scene/Cesium3DTileset.js
@@ -105,7 +105,7 @@ define([
      * @param {Number} [options.skipLevels=1] When <code>skipLevelOfDetail</code> is <code>true</code>, a constant defining the minimum number of levels to skip when loading tiles. When it is 0, no levels are skipped. Used in conjunction with <code>skipScreenSpaceErrorFactor</code> to determine which tiles to load.
      * @param {Boolean} [options.immediatelyLoadDesiredLevelOfDetail=false] When <code>skipLevelOfDetail</code> is <code>true</code>, only tiles that meet the maximum screen space error will ever be downloaded. Skipping factors are ignored and just the desired tiles are loaded.
      * @param {Boolean} [options.loadSiblings=false] When <code>skipLevelOfDetail</code> is <code>true</code>, determines whether siblings of visible tiles are always downloaded during traversal.
-     * @param {ClippingPlaneCollection} [options.clippingPlanes] The {@link ClippingPlanesCollection} used to selectively disable rendering the tileset.
+     * @param {ClippingPlanesCollection} [options.clippingPlanes] The {@link ClippingPlanesCollection} used to selectively disable rendering the tileset.
      * @param {Boolean} [options.debugFreezeFrame=false] For debugging only. Determines if only the tiles from last frame should be used for rendering.
      * @param {Boolean} [options.debugColorizeTiles=false] For debugging only. When true, assigns a random color to each tile.
      * @param {Boolean} [options.debugWireframe=false] For debugging only. When true, render's each tile's content as a wireframe.
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index f905131a8925..b43cd5f9c4c1 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -1,27 +1,25 @@
 define([
-        '../Core/BoundingSphere',
-        '../Core/buildModuleUrl',
-        '../Core/Cartesian3',
-        '../Core/Cartographic',
-        '../Core/Color',
-        '../Core/defaultValue',
-        '../Core/defined',
-        '../Core/defineProperties',
-        '../Core/Intersect',
-        '../Core/Matrix4',
-        '../Core/Plane'
-    ], function(
-        BoundingSphere,
-        buildModuleUrl,
-        Cartesian3,
-        Cartographic,
-        Color,
-        defaultValue,
-        defined,
-        defineProperties,
-        Intersect,
-        Matrix4,
-        Plane) {
+    '../Core/Cartesian3',
+    '../Core/Cartesian4',
+    '../Core/Check',
+    '../Core/Color',
+    '../Core/defaultValue',
+    '../Core/defined',
+    '../Core/defineProperties',
+    '../Core/Intersect',
+    '../Core/Matrix4',
+    '../Core/Plane'
+], function(
+    Cartesian3,
+    Cartesian4,
+    Check,
+    Color,
+    defaultValue,
+    defined,
+    defineProperties,
+    Intersect,
+    Matrix4,
+    Plane) {
     'use strict';
 
     /**
@@ -123,22 +121,32 @@ define([
     var scratchMatrix = new Matrix4();
     /**
      * Applies the transformations to each plane and packs it into an array.
+     * @private
      *
-     * @param viewMatrix
-     * @param [array]
+     * @param viewMatrix The 4x4 matrix to transform the plane into eyespace.
+     * @param [array] The array into which the planes will be packed.
      * @returns {Cartesian4[]} The array of packed planes.
      */
     ClippingPlanesCollection.prototype.transformAndPackPlanes = function(viewMatrix, array) {
+        //>>includeStart('debug', pragmas.debug);
+        Check.typeOf.object('viewMatrix', viewMatrix);
+        //>>includeEnd('debug');
+
         var planes = this.planes;
         var length = planes.length;
 
+        var i;
         if (!defined(array)) {
             array = new Array(length);
+
+            for (i = 0; i < length; ++i) {
+                array[i] = new Cartesian4();
+            }
         }
 
         var transform = Matrix4.multiply(viewMatrix, this.modelMatrix, scratchMatrix);
 
-        for (var i = 0; i < length; ++i) {
+        for (i = 0; i < length; ++i) {
             var plane = planes[i];
             var packedPlane = array[i];
 
@@ -155,14 +163,20 @@ define([
      * Duplicates this ClippingPlanesCollection instance.
      *
      * @param {ClippingPlanesCollection} [result] The object onto which to store the result.
-     * @returns he modified result parameter or a new ClippingPlanesCollection instance if one was not provided.
+     * @returns {ClippingPlanesCollection} The modified result parameter or a new ClippingPlanesCollection instance if one was not provided.
      */
     ClippingPlanesCollection.prototype.clone = function(result) {
         if (!defined(result)) {
             result = new ClippingPlanesCollection();
         }
 
-        result.planes = Array.from(this.planes);
+        var length = this.planes.length;
+        result.planes = new Array(length);
+        for (var i = 0; i < length; ++i) {
+            var plane = this.planes[i];
+            result.planes[i] = new Plane(plane.normal, plane.distance);
+        }
+
         result.enabled = this.enabled;
         Matrix4.clone(this.modelMatrix, result.modelMatrix);
         result.combineClippingRegions = this.combineClippingRegions;
@@ -173,22 +187,23 @@ define([
     };
 
     /**
-     * Determines the type intersection with the planes of this bounding collection and the specified {@link BoundingVolume}.
+     * Determines the type intersection with the planes of this ClippingPlanesCollection instance and the specified {@link BoundingVolume}.
+     * @private
      *
-     * @param {BoundingVolume} boundingVolume The volume to determine the intersection with the planes.
-     * @param {Matrix4} [parentTransform] An optional, additional matrix to transform the plane to world coordinates.
+     * @param {Object} boundingVolume The volume to determine the intersection with the planes.
+     * @param {Matrix4} [transform] An optional, additional matrix to transform the plane to world coordinates.
      * @returns {Intersect} {@link Intersect.INSIDE} if the entire volume is on the side of the planes
      *                      the normal is pointing and should be entirely rendered, {@link Intersect.OUTSIDE}
      *                      if the entire volume is on the opposite side and should be clipped, and
      *                      {@link Intersect.INTERSECTING} if the volume intersects the planes.
      */
-    ClippingPlanesCollection.prototype.computeIntersectionWithBoundingVolume = function(boundingVolume, parentTransform) {
+    ClippingPlanesCollection.prototype.computeIntersectionWithBoundingVolume = function(boundingVolume, transform) {
         var planes = this.planes;
         var length = planes.length;
 
-        var transform = this.modelMatrix;
-        if (defined(parentTransform)) {
-            transform = Matrix4.multiply(transform, parentTransform, scratchMatrix);
+        var modelMatrix = this.modelMatrix;
+        if (defined(transform)) {
+            modelMatrix = Matrix4.multiply(modelMatrix, transform, scratchMatrix);
         }
 
         // If the clipping planes are using combineClippingRegions, the volume must be outside of all planes to be considered
@@ -202,7 +217,7 @@ define([
         for (var i = 0; i < length; ++i) {
             var plane = planes[i];
 
-            Plane.transform(plane, transform, scratchPlane);
+            Plane.transform(plane, modelMatrix, scratchPlane);
 
             var value = boundingVolume.intersectPlane(scratchPlane);
             if (value === Intersect.INTERSECTING) {
diff --git a/Source/Scene/Globe.js b/Source/Scene/Globe.js
index 3fd3e79f92f7..a15bba2f77a2 100644
--- a/Source/Scene/Globe.js
+++ b/Source/Scene/Globe.js
@@ -237,6 +237,7 @@ define([
         /**
          * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
          *
+         * @memberof Globe.prototype
          * @type {ClippingPlaneCollection}
          */
         clippingPlanes : {
diff --git a/Source/Scene/GlobeSurfaceTileProvider.js b/Source/Scene/GlobeSurfaceTileProvider.js
index a785bca7fb5d..a7646e76bde8 100644
--- a/Source/Scene/GlobeSurfaceTileProvider.js
+++ b/Source/Scene/GlobeSurfaceTileProvider.js
@@ -873,11 +873,10 @@ define([
             u_clippingPlanes : function() {
                 return this.properties.clippingPlanes;
             },
-            u_clippingPlanesEdgeColor : function() {
-                return this.properties.clippingPlanesEdgeColor;
-            },
-            u_clippingPlanesEdgeWidth : function() {
-                return this.properties.clippingPlanesEdgeWidth;
+            u_clippingPlanesEdgeStyle : function() {
+                var style = this.properties.clippingPlanesEdgeColor;
+                style.alpha = this.properties.clippingPlanesEdgeWidth;
+                return style;
             },
 
             // make a separate object so that changes to the properties are seen on
@@ -915,7 +914,7 @@ define([
                 minMaxHeight : new Cartesian2(),
                 scaleAndBias : new Matrix4(),
                 clippingPlanes : [],
-                clippingPlanesEdgeColor : new Cartesian4(1.0, 1.0, 1.0, 1.0),
+                clippingPlanesEdgeColor : Color.clone(Color.WHITE),
                 clippingPlanesEdgeWidth : 0.0
             }
         };
@@ -1311,7 +1310,7 @@ define([
 
             if (defined(clippingPlanes) && clippingPlanes.enabled && tile.isClipped) {
                 clippingPlanes.transformAndPackPlanes(context.uniformState.view, clippingPlanesProperty);
-                uniformMapProperties.clippingPlanesEdgeColor = Cartesian4.fromColor(clippingPlanes.edgeColor, uniformMapProperties.clippingPlanesEdgeColor);
+                uniformMapProperties.clippingPlanesEdgeColor = Color.clone(clippingPlanes.edgeColor, uniformMapProperties.clippingPlanesEdgeColor);
                 uniformMapProperties.clippingPlanesEdgeWidth = clippingPlanes.edgeWidth;
             }
 
diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index 61194c4cbbbb..41ec0cb64115 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -586,6 +586,10 @@ define([
          */
         this.clippingPlanes = options.clippingPlanes;
 
+        // Used to determine if the shader needs to be recompiled
+        this._clippingPlanesEnabled = false;
+        this._clippingPlanesCombined = true;
+
         /**
          * This property is for debugging only; it is not for production use nor is it optimized.
          * <p>
@@ -2109,11 +2113,7 @@ define([
 
         var premultipliedAlpha = hasPremultipliedAlpha(model);
         var finalFS = modifyShaderForColor(fs, premultipliedAlpha);
-
-        var clippingPlanes = model.clippingPlanes;
-        if (defined(clippingPlanes) && clippingPlanes.enabled) {
-            finalFS = modifyShaderForClippingPlanes(finalFS, model.clippingPlanes.combineClippingRegions);
-        }
+        finalFS = modifyShaderForClippingPlanes(finalFS);
 
         var drawVS = modifyShader(vs, id, model._vertexShaderLoaded);
         var drawFS = modifyShader(finalFS, id, model._fragmentShaderLoaded);
@@ -3317,37 +3317,40 @@ define([
         };
     }
 
-    function createClippingPlanesFunction(model) {
+    function createClippingPlanesCombineRegionsFunction(model) {
         return function() {
             var clippingPlanes = model.clippingPlanes;
-            var packedPlanes = model._packedClippingPlanes;
-
-            if (defined(clippingPlanes) && clippingPlanes.enabled) {
-                clippingPlanes.transformAndPackPlanes(model._modelViewMatrix, packedPlanes);
+            if (!defined(clippingPlanes)) {
+                return true;
             }
 
-            return packedPlanes;
+            return clippingPlanes.combineClippingRegions;
         };
     }
 
-    function createClippingPlanesEdgeWidthFunction(model) {
+    function createClippingPlanesFunction(model) {
         return function() {
-            if (!defined(model.clippingPlanes)) {
-                return 0.0;
+            var clippingPlanes = model.clippingPlanes;
+            var packedPlanes = model._packedClippingPlanes;
+
+            if (defined(clippingPlanes) && clippingPlanes.enabled) {
+                clippingPlanes.transformAndPackPlanes(model._modelViewMatrix, packedPlanes);
             }
 
-            return model.clippingPlanes.edgeWidth;
+            return packedPlanes;
         };
     }
 
-    var scratchCartesian = new Cartesian4();
-    function createClippingPlanesEdgeColorFunction(model) {
+    function createClippingPlanesEdgeStyleFunction(model) {
         return function() {
-            if (!defined(model.clippingPlanes)) {
-                return scratchCartesian;
+            var clippingPlanes = model.clippingPlanes;
+            if (!defined(clippingPlanes)) {
+                return Color.WHITE.withAlpha(0.0);
             }
 
-            return Cartesian4.fromColor(model.clippingPlanes.edgeColor, scratchCartesian);
+            var style = Color.clone(clippingPlanes.edgeColor);
+            style.alpha = clippingPlanes.edgeWidth;
+            return style;
         };
     }
 
@@ -3447,9 +3450,9 @@ define([
                 gltf_color : createColorFunction(model),
                 gltf_colorBlend : createColorBlendFunction(model),
                 gltf_clippingPlanesLength: createClippingPlanesLengthFunction(model),
+                gltf_clippingPlanesCombineRegions: createClippingPlanesCombineRegionsFunction(model),
                 gltf_clippingPlanes: createClippingPlanesFunction(model, context),
-                gltf_clippingPlanesEdgeColor: createClippingPlanesEdgeColorFunction(model),
-                gltf_clippingPlanesEdgeWidth: createClippingPlanesEdgeWidthFunction(model)
+                gltf_clippingPlanesEdgeStyle: createClippingPlanesEdgeStyleFunction(model)
             });
 
             // Allow callback to modify the uniformMap
@@ -4243,21 +4246,35 @@ define([
         }
     }
 
-    function modifyShaderForClippingPlanes(shader, combineClippingRegions) {
+    function modifyShaderForClippingPlanes(shader) {
         shader = ShaderSource.replaceMain(shader, 'gltf_clip_main');
-
-        var clippingFunction = combineClippingRegions ? 'czm_discardIfClippedCombineRegions' : 'czm_discardIfClipped';
         shader +=
             'uniform int gltf_clippingPlanesLength; \n' +
+            'uniform bool gltf_clippingPlanesCombineRegions; \n' +
             'uniform vec4 gltf_clippingPlanes[czm_maxClippingPlanes]; \n' +
-            'uniform vec4 gltf_clippingPlanesEdgeColor; \n' +
-            'uniform float gltf_clippingPlanesEdgeWidth; \n' +
+            'uniform vec4 gltf_clippingPlanesEdgeStyle; \n' +
             'void main() \n' +
             '{ \n' +
             '    gltf_clip_main(); \n' +
-            '    float clipDistance = ' + clippingFunction + '(gltf_clippingPlanes, gltf_clippingPlanesLength); \n' +
-            '    if (clipDistance < gltf_clippingPlanesEdgeWidth) { \n' +
-            '        gl_FragColor = gltf_clippingPlanesEdgeColor; \n' +
+            '    if (gltf_clippingPlanesLength > 0) \n' +
+            '    { \n' +
+            '        float clipDistance; \n' +
+            '        if (gltf_clippingPlanesCombineRegions) \n' +
+            '        { \n' +
+            '            clipDistance = czm_discardIfClippedCombineRegions(gltf_clippingPlanes, gltf_clippingPlanesLength); \n' +
+            '        } \n' +
+            '        else \n' +
+            '        { \n' +
+            '            clipDistance = czm_discardIfClipped(gltf_clippingPlanes, gltf_clippingPlanesLength); \n' +
+            '        } \n' +
+            '        \n' +
+            '        vec4 clippingPlanesEdgeColor = vec4(1.0); \n' +
+            '        clippingPlanesEdgeColor.rgb = gltf_clippingPlanesEdgeStyle.rgb; \n' +
+            '        float clippingPlanesEdgeWidth = gltf_clippingPlanesEdgeStyle.a; \n' +
+            '        if (clipDistance > 0.0 && clipDistance < clippingPlanesEdgeWidth) \n' +
+            '        { \n' +
+            '            gl_FragColor = clippingPlanesEdgeColor; \n' +
+            '        } \n' +
             '    } \n' +
             '} \n';
 
@@ -4287,9 +4304,9 @@ define([
     }
 
     function updateClippingPlanes(model) {
-        var length = 0;
         var clippingPlanes = model.clippingPlanes;
-        if (defined(clippingPlanes)) {
+        var length = 0;
+        if (defined(clippingPlanes) && clippingPlanes.enabled) {
             length = clippingPlanes.planes.length;
         }
 
@@ -4708,7 +4725,6 @@ define([
             this._cesiumAnimationsDirty = false;
             this._dirty = false;
             var modelMatrix = this.modelMatrix;
-            var modelViewChanged = context.uniformState._modelViewDirty;
 
             var modeChanged = frameState.mode !== this._mode;
             this._mode = frameState.mode;
@@ -4722,8 +4738,6 @@ define([
                 modeChanged;
 
             if (modelTransformChanged || justLoaded) {
-                modelViewChanged = true;
-
                 Matrix4.clone(modelMatrix, this._modelMatrix);
 
                 updateClamping(this);
@@ -4749,7 +4763,7 @@ define([
             }
 
             var clippingPlanes = this.clippingPlanes;
-            if (defined(clippingPlanes) && clippingPlanes.enabled && modelViewChanged) {
+            if (defined(clippingPlanes) && clippingPlanes.enabled) {
                 Matrix4.multiply(context.uniformState.view3D, modelMatrix, this._modelViewMatrix);
             }
 
@@ -4774,7 +4788,7 @@ define([
             updateShadows(this);
             updateColor(this, frameState);
             updateSilhouette(this, frameState);
-            updateClippingPlanes(this);
+            updateClippingPlanes(this, frameState);
         }
 
         if (justLoaded) {
diff --git a/Source/Scene/PointCloud3DTileContent.js b/Source/Scene/PointCloud3DTileContent.js
index 7a1de03680c4..5221b2876674 100644
--- a/Source/Scene/PointCloud3DTileContent.js
+++ b/Source/Scene/PointCloud3DTileContent.js
@@ -521,8 +521,7 @@ define([
         }
 
         var clippingPlanes = content._tileset.clippingPlanes;
-        var contentClipped = defined(clippingPlanes) && clippingPlanes.enabled;// && content._tile._isClipped;
-        var scratchCartesian = new Cartesian4();
+        var hasClippedContent = defined(clippingPlanes) && clippingPlanes.enabled && content._tile._isClipped;
         var uniformMap = {
             u_pointSizeAndTilesetTime : function() {
                 scratchPointSizeAndTilesetTime.x = content._pointSize;
@@ -541,25 +540,20 @@ define([
             u_clippingPlanes : function() {
                 var packedPlanes = content._packedClippingPlanes;
 
-                if (contentClipped) {
+                if (hasClippedContent) {
                     clippingPlanes.transformAndPackPlanes(content._modelViewMatrix, packedPlanes);
                 }
 
                 return packedPlanes;
             },
-            u_clippingPlanesEdgeWidth : function() {
+            u_clippingPlanesEdgeStyle : function() {
                 if (!defined(clippingPlanes)) {
-                    return 0.0;
+                    return Color.WHITE.withAlpha(0.0);
                 }
 
-                return clippingPlanes.edgeWidth;
-            },
-            u_clippingPlanesEdgeColor : function() {
-                if (!defined(clippingPlanes)) {
-                    return scratchCartesian;
-                }
-
-                return Cartesian4.fromColor(clippingPlanes.edgeColor, scratchCartesian);
+                var style = Color.clone(clippingPlanes.edgeColor);
+                style.alpha = clippingPlanes.edgeWidth;
+                return style;
             }
         };
 
@@ -855,7 +849,7 @@ define([
         var hasColorStyle = defined(colorStyleFunction);
         var hasShowStyle = defined(showStyleFunction);
         var hasPointSizeStyle = defined(pointSizeStyleFunction);
-        var hasClippingPlanes = defined(clippingPlanes) && clippingPlanes.enabled && content._tile._isClipped;
+        var hasClippedContent = defined(clippingPlanes) && clippingPlanes.enabled && content._tile._isClipped;
 
         // Get the properties in use by the style
         var styleableProperties = [];
@@ -1072,22 +1066,25 @@ define([
 
         var fs = 'varying vec4 v_color; \n';
 
-        if (hasClippingPlanes) {
+        if (hasClippedContent) {
             fs += 'uniform int u_clippingPlanesLength;' +
                   'uniform vec4 u_clippingPlanes[czm_maxClippingPlanes]; \n' +
-                  'uniform vec4 u_clippingPlanesEdgeColor; \n' +
-                  'uniform float u_clippingPlanesEdgeWidth; \n';
+                  'uniform vec4 u_clippingPlanesEdgeStyle; \n';
         }
 
         fs +=  'void main() \n' +
                '{ \n' +
                '    gl_FragColor = v_color; \n';
 
-        if (hasClippingPlanes) {
+        if (hasClippedContent) {
             var clippingFunction = clippingPlanes.combineClippingRegions ? 'czm_discardIfClippedCombineRegions' : 'czm_discardIfClipped';
             fs += '    float clipDistance = ' + clippingFunction + '(u_clippingPlanes, u_clippingPlanesLength); \n' +
-                  '    if (clipDistance < u_clippingPlanesEdgeWidth) { \n' +
-                  '        gl_FragColor = u_clippingPlanesEdgeColor; \n' +
+                  '    vec4 clippingPlanesEdgeColor = vec4(1.0); \n' +
+                  '    clippingPlanesEdgeColor.rgb = u_clippingPlanesEdgeStyle.rgb; \n' +
+                  '    float clippingPlanesEdgeWidth = u_clippingPlanesEdgeStyle.a; \n' +
+                  '    if (clipDistance > 0.0 && clipDistance < clippingPlanesEdgeWidth) \n' +
+                  '    { \n' +
+                  '        gl_FragColor = clippingPlanesEdgeColor; \n' +
                   '    } \n';
         }
 
@@ -1228,8 +1225,7 @@ define([
 
         // update clipping planes
         var clippingPlanes = this._tileset.clippingPlanes;
-        var modelViewChanged = context.uniformState._modelViewDirty || modelMatrixChanged;
-        if (defined(clippingPlanes) && clippingPlanes.enabled && modelViewChanged) {
+        if (defined(clippingPlanes) && clippingPlanes.enabled) {
             Matrix4.multiply(context.uniformState.view3D, modelMatrix, this._modelViewMatrix);
         }
 
diff --git a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
index 33896e5cbfc6..74d0c51dc01f 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
@@ -30,13 +30,11 @@ float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clip
             clipPosition = -clippingPlanes[i].w * clipNormal;
 
             float amount = dot(clipNormal, (position.xyz - clipPosition)) / pixelWidth;
-            if (amount > clipAmount) {
-                clipAmount = amount;
-            }
+            clipAmount = max(amount, clipAmount);
 
-            if (amount <= 0.0) {
+            if (amount <= 0.0)
+            {
                 discard;
-                return amount;
             }
         }
 
diff --git a/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl b/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
index 18b007c4c0e7..4709159fddd1 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
@@ -31,9 +31,7 @@ float czm_discardIfClippedCombineRegions (vec4[czm_maxClippingPlanes] clippingPl
             clipPosition = -clippingPlanes[i].w * clipNormal;
 
             float amount = dot(clipNormal, (position.xyz - clipPosition)) / pixelWidth;
-            if (amount > clipAmount) {
-                clipAmount = amount;
-            }
+            clipAmount = max(amount, clipAmount);
 
             clipped = clipped && (amount <= 0.0);
         }
diff --git a/Source/Shaders/GlobeFS.glsl b/Source/Shaders/GlobeFS.glsl
index aa47300d6301..056d6a2bf8d5 100644
--- a/Source/Shaders/GlobeFS.glsl
+++ b/Source/Shaders/GlobeFS.glsl
@@ -55,8 +55,7 @@ uniform vec2 u_lightingFadeDistance;
 #ifdef ENABLE_CLIPPING_PLANES
 uniform int u_clippingPlanesLength;
 uniform vec4 u_clippingPlanes[czm_maxClippingPlanes];
-uniform vec4 u_clippingPlanesEdgeColor;
-uniform float u_clippingPlanesEdgeWidth;
+uniform vec4 u_clippingPlanesEdgeStyle;
 #endif
 
 varying vec3 v_positionMC;
@@ -211,8 +210,12 @@ void main()
 #endif
 
 #ifdef ENABLE_CLIPPING_PLANES
-    if (clipDistance < u_clippingPlanesEdgeWidth) {
-        finalColor = u_clippingPlanesEdgeColor;
+    vec4 clippingPlanesEdgeColor = vec4(1.0);
+    clippingPlanesEdgeColor.rgb = u_clippingPlanesEdgeStyle.rgb;
+    float clippingPlanesEdgeWidth = u_clippingPlanesEdgeStyle.a;
+
+    if (clipDistance < clippingPlanesEdgeWidth) {
+        finalColor = clippingPlanesEdgeColor;
     }
 #endif
 

From 92fc2bb6a3cb50aeb1bee37aaca82f834337cd33 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Thu, 30 Nov 2017 16:14:55 -0500
Subject: [PATCH 25/37] Fix failing tests

---
 Source/Scene/Batched3DModel3DTileContent.js | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/Source/Scene/Batched3DModel3DTileContent.js b/Source/Scene/Batched3DModel3DTileContent.js
index 42deb3e41ccb..0d083631b10a 100644
--- a/Source/Scene/Batched3DModel3DTileContent.js
+++ b/Source/Scene/Batched3DModel3DTileContent.js
@@ -377,9 +377,12 @@ define([
             pickFragmentShaderLoaded : batchTable.getPickFragmentShaderCallback(),
             pickUniformMapLoaded : batchTable.getPickUniformMapCallback(),
             addBatchIdToGeneratedShaders : (batchLength > 0), // If the batch table has values in it, generated shaders will need a batchId attribute
-            pickObject : pickObject,
-            clippingPlanes : tileset.clippingPlanes.clone()
+            pickObject : pickObject
         });
+
+        if (defined(tileset.clippingPlanes)) {
+            content._model.clippingPlanes = tileset.clippingPlanes.clone();
+        }
     }
 
     function createFeatures(content) {

From 0af0db6c46cfa906f43081be8c64781ff4e26b01 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Thu, 30 Nov 2017 17:07:36 -0500
Subject: [PATCH 26/37] Specs

---
 Source/Core/PlaneOutlineGeometry.js           |   1 +
 Source/DataSources/PlaneGeometryUpdater.js    |   2 +-
 Source/Scene/Batched3DModel3DTileContent.js   |   7 +-
 Source/Scene/ClippingPlanesCollection.js      |   1 +
 Source/Scene/PointCloud3DTileContent.js       |   8 +-
 Specs/Core/PlaneGeometrySpec.js               |  44 ++
 Specs/Core/PlaneOutlineGeometrySpec.js        |  19 +
 Specs/Core/PlaneSpec.js                       |  38 +-
 Specs/DataSources/EntitySpec.js               |   5 +
 Specs/DataSources/ModelGraphicsSpec.js        |  13 +
 Specs/DataSources/ModelVisualizerSpec.js      |  12 +
 Specs/DataSources/PlaneGeometryUpdaterSpec.js | 491 ++++++++++++++++++
 .../Scene/Batched3DModel3DTileContentSpec.js  |  32 ++
 Specs/Scene/Cesium3DTilesetSpec.js            |  57 ++
 Specs/Scene/ClippingPlanesCollectionSpec.js   | 175 +++++++
 Specs/Scene/GlobeSurfaceTileProviderSpec.js   | 120 +++++
 Specs/Scene/PointCloud3DTileContentSpec.js    | 119 +++++
 17 files changed, 1135 insertions(+), 9 deletions(-)
 create mode 100644 Specs/Core/PlaneGeometrySpec.js
 create mode 100644 Specs/Core/PlaneOutlineGeometrySpec.js
 create mode 100644 Specs/DataSources/PlaneGeometryUpdaterSpec.js
 create mode 100644 Specs/Scene/ClippingPlanesCollectionSpec.js

diff --git a/Source/Core/PlaneOutlineGeometry.js b/Source/Core/PlaneOutlineGeometry.js
index d4cb7245b300..29f6cf0d3654 100644
--- a/Source/Core/PlaneOutlineGeometry.js
+++ b/Source/Core/PlaneOutlineGeometry.js
@@ -49,6 +49,7 @@ define([
      */
     PlaneOutlineGeometry.pack = function(value, array) {
         //>>includeStart('debug', pragmas.debug);
+        Check.defined('value', value);
         Check.defined('array', array);
         //>>includeEnd('debug');
 
diff --git a/Source/DataSources/PlaneGeometryUpdater.js b/Source/DataSources/PlaneGeometryUpdater.js
index 14877ad8aff2..6e18f19bdec4 100644
--- a/Source/DataSources/PlaneGeometryUpdater.js
+++ b/Source/DataSources/PlaneGeometryUpdater.js
@@ -497,7 +497,7 @@ define([
         var position = entity.position;
 
         var show = planeGraphics.show;
-        if (!defined(plane) || !defined(position) || (defined(show) && show.isConstant && !show.getValue(Iso8601.MINIMUM_VALUE))) {
+        if (!defined(plane) || !defined(dimensions) || !defined(position) || (defined(show) && show.isConstant && !show.getValue(Iso8601.MINIMUM_VALUE))) {
             if (this._fillEnabled || this._outlineEnabled) {
                 this._fillEnabled = false;
                 this._outlineEnabled = false;
diff --git a/Source/Scene/Batched3DModel3DTileContent.js b/Source/Scene/Batched3DModel3DTileContent.js
index 0d083631b10a..6013c32f9727 100644
--- a/Source/Scene/Batched3DModel3DTileContent.js
+++ b/Source/Scene/Batched3DModel3DTileContent.js
@@ -14,6 +14,7 @@ define([
         '../Core/RequestType',
         '../Core/RuntimeError',
         '../Renderer/Pass',
+        '../Scene/ClippingPlanesCollection',
         './Cesium3DTileBatchTable',
         './Cesium3DTileFeature',
         './Cesium3DTileFeatureTable',
@@ -35,6 +36,7 @@ define([
         RequestType,
         RuntimeError,
         Pass,
+        ClippingPlanesCollections,
         Cesium3DTileBatchTable,
         Cesium3DTileFeature,
         Cesium3DTileFeatureTable,
@@ -377,7 +379,10 @@ define([
             pickFragmentShaderLoaded : batchTable.getPickFragmentShaderCallback(),
             pickUniformMapLoaded : batchTable.getPickUniformMapCallback(),
             addBatchIdToGeneratedShaders : (batchLength > 0), // If the batch table has values in it, generated shaders will need a batchId attribute
-            pickObject : pickObject
+            pickObject : pickObject,
+            clippingPlanes : new ClippingPlanesCollections({
+                enabled : false
+            })
         });
 
         if (defined(tileset.clippingPlanes)) {
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index b43cd5f9c4c1..b3fa262dd030 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -80,6 +80,7 @@ define([
         this.edgeWidth = defaultValue(options.edgeWidth, 0.0);
 
         this._testIntersection = undefined;
+        this._combineClippingRegions = undefined;
         this.combineClippingRegions = defaultValue(options.combineClippingRegions, true);
     }
 
diff --git a/Source/Scene/PointCloud3DTileContent.js b/Source/Scene/PointCloud3DTileContent.js
index 5221b2876674..69aa39d970ad 100644
--- a/Source/Scene/PointCloud3DTileContent.js
+++ b/Source/Scene/PointCloud3DTileContent.js
@@ -1225,13 +1225,11 @@ define([
 
         // update clipping planes
         var clippingPlanes = this._tileset.clippingPlanes;
-        if (defined(clippingPlanes) && clippingPlanes.enabled) {
-            Matrix4.multiply(context.uniformState.view3D, modelMatrix, this._modelViewMatrix);
-        }
-
+        var clippingEnabled = defined(clippingPlanes) && clippingPlanes.enabled && this._tile._isClipped;
         var length = 0;
-        if (defined(clippingPlanes)) {
+        if (clippingEnabled) {
             length = clippingPlanes.planes.length;
+            Matrix4.multiply(context.uniformState.view3D, modelMatrix, this._modelViewMatrix);
         }
 
         if (this._packedClippingPlanes.length !== length) {
diff --git a/Specs/Core/PlaneGeometrySpec.js b/Specs/Core/PlaneGeometrySpec.js
new file mode 100644
index 000000000000..0a5561fb4389
--- /dev/null
+++ b/Specs/Core/PlaneGeometrySpec.js
@@ -0,0 +1,44 @@
+defineSuite([
+        'Core/PlaneGeometry',
+        'Core/Cartesian3',
+        'Core/VertexFormat',
+        'Specs/createPackableSpecs'
+    ], function(
+        PlaneGeometry,
+        Cartesian3,
+        VertexFormat,
+        createPackableSpecs) {
+    'use strict';
+
+    it('constructor creates optimized number of positions for VertexFormat.POSITIONS_ONLY', function() {
+        var m = PlaneGeometry.createGeometry(new PlaneGeometry({
+            vertexFormat : VertexFormat.POSITION_ONLY
+        }));
+
+        expect(m.attributes.position.values.length).toEqual(4 * 3); // 4 corners
+        expect(m.indices.length).toEqual(4 * 3); // 2 sides x 2 triangles per side
+    });
+
+    it('constructor computes all vertex attributes', function() {
+        var m = PlaneGeometry.createGeometry(new PlaneGeometry({
+            vertexFormat : VertexFormat.ALL
+        }));
+
+        var numVertices = 8; //2 sides x 4 corners
+        var numTriangles = 4; //2 sides x 2 triangles per side
+        expect(m.attributes.position.values.length).toEqual(numVertices * 3);
+        expect(m.attributes.normal.values.length).toEqual(numVertices * 3);
+        expect(m.attributes.tangent.values.length).toEqual(numVertices * 3);
+        expect(m.attributes.bitangent.values.length).toEqual(numVertices * 3);
+        expect(m.attributes.st.values.length).toEqual(numVertices * 2);
+
+        expect(m.indices.length).toEqual(numTriangles * 3);
+
+        expect(m.boundingSphere.center).toEqual(Cartesian3.ZERO);
+        expect(m.boundingSphere.radius).toEqual(Math.sqrt(2.0)/2.0);
+    });
+
+    createPackableSpecs(PlaneGeometry, new PlaneGeometry({
+        vertexFormat : VertexFormat.POSITION_AND_NORMAL
+    }), [1.0, 1.0, 0.0, 0.0, 0.0, 0.0]);
+});
diff --git a/Specs/Core/PlaneOutlineGeometrySpec.js b/Specs/Core/PlaneOutlineGeometrySpec.js
new file mode 100644
index 000000000000..f1f1d49f6dc0
--- /dev/null
+++ b/Specs/Core/PlaneOutlineGeometrySpec.js
@@ -0,0 +1,19 @@
+defineSuite([
+        'Core/PlaneOutlineGeometry',
+        'Core/Cartesian3',
+        'Specs/createPackableSpecs'
+    ], function(
+        PlaneOutlineGeometry,
+        Cartesian3,
+        createPackableSpecs) {
+    'use strict';
+
+    it('constructor creates positions', function() {
+        var m = PlaneOutlineGeometry.createGeometry(new PlaneOutlineGeometry());
+
+        expect(m.attributes.position.values.length).toEqual(4 * 3);
+        expect(m.indices.length).toEqual(4 * 2);
+    });
+
+    createPackableSpecs(PlaneOutlineGeometry, new PlaneOutlineGeometry(), []);
+});
diff --git a/Specs/Core/PlaneSpec.js b/Specs/Core/PlaneSpec.js
index 8e28801b179f..94c851016ba4 100644
--- a/Specs/Core/PlaneSpec.js
+++ b/Specs/Core/PlaneSpec.js
@@ -1,11 +1,17 @@
 defineSuite([
         'Core/Plane',
         'Core/Cartesian3',
-        'Core/Cartesian4'
+        'Core/Cartesian4',
+        'Core/Math',
+        'Core/Matrix3',
+        'Core/Matrix4'
     ], function(
         Plane,
         Cartesian3,
-        Cartesian4) {
+        Cartesian4,
+        CesiumMath,
+        Matrix3,
+        Matrix4) {
     'use strict';
 
     it('constructs', function() {
@@ -122,4 +128,32 @@ defineSuite([
             return Plane.getPointDistance(plane, undefined);
         }).toThrowDeveloperError();
     });
+
+    it('transforms a plane according to a transform', function() {
+        var normal = new Cartesian3(1.0, 2.0, 3.0);
+        normal = Cartesian3.normalize(normal, normal);
+        var plane = new Plane(normal, 12.34);
+
+        var transform = Matrix4.fromUniformScale(2.0);
+        transform = Matrix4.multiplyByMatrix3(transform, Matrix3.fromRotationY(Math.PI), transform);
+        var transformedPlane = Plane.transform(plane, transform);
+        expect(transformedPlane.distance).toEqual(-plane.distance * 2.0);
+        expect(transformedPlane.normal.x).toEqualEpsilon(-plane.normal.x, CesiumMath.EPSILON10);
+        expect(transformedPlane.normal.y).toEqual(plane.normal.y);
+        expect(transformedPlane.normal.z).toEqual(-plane.normal.z);
+    });
+
+    it('transform throws without a plane', function() {
+        var point = Cartesian3.ZERO;
+        expect(function() {
+            return Plane.transform(undefined, point);
+        }).toThrowDeveloperError();
+    });
+
+    it('transform throws without a point', function() {
+        var plane = new Plane(Cartesian3.UNIT_X, 0.0);
+        expect(function() {
+            return Plane.transform(plane, undefined);
+        }).toThrowDeveloperError();
+    });
 });
diff --git a/Specs/DataSources/EntitySpec.js b/Specs/DataSources/EntitySpec.js
index 5a4a4eb4738a..3ff931561312 100644
--- a/Specs/DataSources/EntitySpec.js
+++ b/Specs/DataSources/EntitySpec.js
@@ -19,6 +19,7 @@ defineSuite([
         'DataSources/LabelGraphics',
         'DataSources/ModelGraphics',
         'DataSources/PathGraphics',
+        'DataSources/PlaneGraphics',
         'DataSources/PointGraphics',
         'DataSources/PolygonGraphics',
         'DataSources/PolylineGraphics',
@@ -46,6 +47,7 @@ defineSuite([
         LabelGraphics,
         ModelGraphics,
         PathGraphics,
+        PlaneGraphics,
         PointGraphics,
         PolygonGraphics,
         PolylineGraphics,
@@ -69,6 +71,7 @@ defineSuite([
         expect(entity.model).toBeUndefined();
         expect(entity.orientation).toBeUndefined();
         expect(entity.path).toBeUndefined();
+        expect(entity.plane).toBeUndefined();
         expect(entity.point).toBeUndefined();
         expect(entity.polygon).toBeUndefined();
         expect(entity.polyline).toBeUndefined();
@@ -97,6 +100,7 @@ defineSuite([
             model : {},
             orientation : new Quaternion(1, 2, 3, 4),
             path : {},
+            plane : {},
             point : {},
             polygon : {},
             polyline : {},
@@ -126,6 +130,7 @@ defineSuite([
         expect(entity.model).toBeInstanceOf(ModelGraphics);
         expect(entity.orientation).toBeInstanceOf(ConstantProperty);
         expect(entity.path).toBeInstanceOf(PathGraphics);
+        expect(entity.plane).toBeInstanceOf(PlaneGraphics);
         expect(entity.point).toBeInstanceOf(PointGraphics);
         expect(entity.polygon).toBeInstanceOf(PolygonGraphics);
         expect(entity.polyline).toBeInstanceOf(PolylineGraphics);
diff --git a/Specs/DataSources/ModelGraphicsSpec.js b/Specs/DataSources/ModelGraphicsSpec.js
index c5db38a7d99c..bda0e8cb9c73 100644
--- a/Specs/DataSources/ModelGraphicsSpec.js
+++ b/Specs/DataSources/ModelGraphicsSpec.js
@@ -9,6 +9,7 @@ defineSuite([
         'DataSources/NodeTransformationProperty',
         'DataSources/PropertyBag',
         'Scene/ColorBlendMode',
+        'Scene/ClippingPlanesCollection',
         'Scene/HeightReference',
         'Scene/ShadowMode'
     ], function(
@@ -22,6 +23,7 @@ defineSuite([
         NodeTransformationProperty,
         PropertyBag,
         ColorBlendMode,
+        ClippingPlanesCollection,
         HeightReference,
         ShadowMode) {
     'use strict';
@@ -43,6 +45,7 @@ defineSuite([
             color : new Color(0.0, 1.0, 0.0, 0.2),
             colorBlendMode : ColorBlendMode.HIGHLIGHT,
             colorBlendAmount : 0.5,
+            clippingPlanes : new ClippingPlanesCollection(),
             nodeTransformations : {
                 node1 : {
                     translation : Cartesian3.UNIT_Y,
@@ -67,6 +70,7 @@ defineSuite([
         expect(model.color).toBeInstanceOf(ConstantProperty);
         expect(model.colorBlendMode).toBeInstanceOf(ConstantProperty);
         expect(model.colorBlendAmount).toBeInstanceOf(ConstantProperty);
+        expect(model.clippingPlanes).toBeInstanceOf(ConstantProperty);
         expect(model.runAnimations).toBeInstanceOf(ConstantProperty);
 
         expect(model.nodeTransformations).toBeInstanceOf(PropertyBag);
@@ -85,6 +89,7 @@ defineSuite([
         expect(model.color.getValue()).toEqual(options.color);
         expect(model.colorBlendMode.getValue()).toEqual(options.colorBlendMode);
         expect(model.colorBlendAmount.getValue()).toEqual(options.colorBlendAmount);
+        expect(model.clippingPlanes.getValue().planes).toEqual(options.clippingPlanes.planes);
         expect(model.runAnimations.getValue()).toEqual(options.runAnimations);
 
         var actualNodeTransformations = model.nodeTransformations.getValue(new JulianDate());
@@ -112,6 +117,7 @@ defineSuite([
         source.color = new ConstantProperty(new Color(0.0, 1.0, 0.0, 0.2));
         source.colorBlendMode = new ConstantProperty(ColorBlendMode.HIGHLIGHT);
         source.colorBlendAmount = new ConstantProperty(0.5);
+        source.clippingPlanes = new ConstantProperty(new ClippingPlanesCollection());
         source.runAnimations = new ConstantProperty(true);
         source.nodeTransformations = {
             node1 : new NodeTransformationProperty({
@@ -141,6 +147,7 @@ defineSuite([
         expect(target.color).toBe(source.color);
         expect(target.colorBlendMode).toBe(source.colorBlendMode);
         expect(target.colorBlendAmount).toBe(source.colorBlendAmount);
+        expect(target.clippingPlanes).toBe(source.clippingPlanes);
         expect(target.runAnimations).toBe(source.runAnimations);
         expect(target.nodeTransformations).toEqual(source.nodeTransformations);
     });
@@ -161,6 +168,7 @@ defineSuite([
         source.color = new ConstantProperty(new Color(0.0, 1.0, 0.0, 0.2));
         source.colorBlendMode = new ConstantProperty(ColorBlendMode.HIGHLIGHT);
         source.colorBlendAmount = new ConstantProperty(0.5);
+        source.clippingPlanes = new ConstantProperty(new ClippingPlanesCollection());
         source.runAnimations = new ConstantProperty(true);
         source.nodeTransformations = {
             transform : new NodeTransformationProperty()
@@ -180,6 +188,7 @@ defineSuite([
         var color = new ConstantProperty(new Color(0.0, 1.0, 0.0, 0.2));
         var colorBlendMode = new ConstantProperty(ColorBlendMode.HIGHLIGHT);
         var colorBlendAmount = new ConstantProperty(0.5);
+        var clippingPlanes = new ConstantProperty(new ClippingPlanesCollection());
         var runAnimations = new ConstantProperty(true);
         var nodeTransformations = new PropertyBag({
             transform : new NodeTransformationProperty()
@@ -200,6 +209,7 @@ defineSuite([
         target.color = color;
         target.colorBlendMode = colorBlendMode;
         target.colorBlendAmount = colorBlendAmount;
+        target.clippingPlanes = clippingPlanes;
         target.runAnimations = runAnimations;
         target.nodeTransformations = nodeTransformations;
 
@@ -219,6 +229,7 @@ defineSuite([
         expect(target.color).toBe(color);
         expect(target.colorBlendMode).toBe(colorBlendMode);
         expect(target.colorBlendAmount).toBe(colorBlendAmount);
+        expect(target.clippingPlanes).toBe(clippingPlanes);
         expect(target.runAnimations).toBe(runAnimations);
         expect(target.nodeTransformations).toBe(nodeTransformations);
     });
@@ -239,6 +250,7 @@ defineSuite([
         source.color = new ConstantProperty(new Color(0.0, 1.0, 0.0, 0.2));
         source.colorBlendMode = new ConstantProperty(ColorBlendMode.HIGHLIGHT);
         source.colorBlendAmount = new ConstantProperty(0.5);
+        source.clippingPlanes = new ConstantProperty(new ClippingPlanesCollection());
         source.runAnimations = new ConstantProperty(true);
         source.nodeTransformations = {
             node1 : new NodeTransformationProperty(),
@@ -260,6 +272,7 @@ defineSuite([
         expect(result.color).toBe(source.color);
         expect(result.colorBlendMode).toBe(source.colorBlendMode);
         expect(result.colorBlendAmount).toBe(source.colorBlendAmount);
+        expect(result.clippingPlanes).toBe(source.clippingPlanes);
         expect(result.runAnimations).toBe(source.runAnimations);
         expect(result.nodeTransformations).toEqual(source.nodeTransformations);
     });
diff --git a/Specs/DataSources/ModelVisualizerSpec.js b/Specs/DataSources/ModelVisualizerSpec.js
index 61fa33d7598d..d76cbb795e46 100644
--- a/Specs/DataSources/ModelVisualizerSpec.js
+++ b/Specs/DataSources/ModelVisualizerSpec.js
@@ -6,6 +6,7 @@ defineSuite([
         'Core/DistanceDisplayCondition',
         'Core/JulianDate',
         'Core/Matrix4',
+        'Core/Plane',
         'Core/Quaternion',
         'Core/Transforms',
         'DataSources/BoundingSphereState',
@@ -14,6 +15,7 @@ defineSuite([
         'DataSources/EntityCollection',
         'DataSources/ModelGraphics',
         'DataSources/NodeTransformationProperty',
+        'Scene/ClippingPlanesCollection',
         'Scene/Globe',
         'Specs/createScene',
         'Specs/pollToPromise'
@@ -25,6 +27,7 @@ defineSuite([
         DistanceDisplayCondition,
         JulianDate,
         Matrix4,
+        Plane,
         Quaternion,
         Transforms,
         BoundingSphereState,
@@ -33,6 +36,7 @@ defineSuite([
         EntityCollection,
         ModelGraphics,
         NodeTransformationProperty,
+        ClippingPlanesCollection,
         Globe,
         createScene,
         pollToPromise) {
@@ -136,6 +140,13 @@ defineSuite([
         };
         model.nodeTransformations = nodeTransforms;
 
+        var clippingPlanes = new ClippingPlanesCollection({
+            planes: [
+                new Plane(Cartesian3.UNIT_X, 0.0)
+            ]
+        });
+        model.clippingPlanes = new ConstantProperty(clippingPlanes);
+
         var testObject = entityCollection.getOrCreateEntity('test');
         testObject.position = new ConstantPositionProperty(Cartesian3.fromDegrees(1, 2, 3));
         testObject.model = model;
@@ -151,6 +162,7 @@ defineSuite([
         expect(primitive.minimumPixelSize).toEqual(24.0);
         expect(primitive.modelMatrix).toEqual(Transforms.eastNorthUpToFixedFrame(Cartesian3.fromDegrees(1, 2, 3), scene.globe.ellipsoid));
         expect(primitive.distanceDisplayCondition).toEqual(new DistanceDisplayCondition(10.0, 100.0));
+        expect(primitive.clippingPlanes.planes).toEqual(clippingPlanes.planes);
 
         // wait till the model is loaded before we can check node transformations
         return pollToPromise(function() {
diff --git a/Specs/DataSources/PlaneGeometryUpdaterSpec.js b/Specs/DataSources/PlaneGeometryUpdaterSpec.js
new file mode 100644
index 000000000000..4e548da1d8f1
--- /dev/null
+++ b/Specs/DataSources/PlaneGeometryUpdaterSpec.js
@@ -0,0 +1,491 @@
+defineSuite([
+    'DataSources/PlaneGeometryUpdater',
+    'Core/Cartesian2',
+    'Core/Cartesian3',
+    'Core/Color',
+    'Core/ColorGeometryInstanceAttribute',
+    'Core/DistanceDisplayCondition',
+    'Core/DistanceDisplayConditionGeometryInstanceAttribute',
+    'Core/JulianDate',
+    'Core/Plane',
+    'Core/ShowGeometryInstanceAttribute',
+    'Core/TimeInterval',
+    'Core/TimeIntervalCollection',
+    'DataSources/PlaneGraphics',
+    'DataSources/ColorMaterialProperty',
+    'DataSources/ConstantPositionProperty',
+    'DataSources/ConstantProperty',
+    'DataSources/Entity',
+    'DataSources/GridMaterialProperty',
+    'DataSources/SampledProperty',
+    'DataSources/TimeIntervalCollectionProperty',
+    'Scene/PrimitiveCollection',
+    'Scene/ShadowMode',
+    'Specs/createDynamicGeometryBoundingSphereSpecs',
+    'Specs/createDynamicProperty',
+    'Specs/createScene'
+], function(
+    PlaneGeometryUpdater,
+    Cartesian2,
+    Cartesian3,
+    Color,
+    ColorGeometryInstanceAttribute,
+    DistanceDisplayCondition,
+    DistanceDisplayConditionGeometryInstanceAttribute,
+    JulianDate,
+    Plane,
+    ShowGeometryInstanceAttribute,
+    TimeInterval,
+    TimeIntervalCollection,
+    PlaneGraphics,
+    ColorMaterialProperty,
+    ConstantPositionProperty,
+    ConstantProperty,
+    Entity,
+    GridMaterialProperty,
+    SampledProperty,
+    TimeIntervalCollectionProperty,
+    PrimitiveCollection,
+    ShadowMode,
+    createDynamicGeometryBoundingSphereSpecs,
+    createDynamicProperty,
+    createScene) {
+    'use strict';
+
+    var scene;
+    var time;
+
+    beforeAll(function() {
+        scene = createScene();
+        time = JulianDate.now();
+    });
+
+    afterAll(function() {
+        scene.destroyForSpecs();
+    });
+
+    function createBasicPlane() {
+        var planeGraphics = new PlaneGraphics();
+        planeGraphics.plane = new ConstantProperty(new Plane(Cartesian3.UNIT_X, 0.0));
+        planeGraphics.dimensions = new ConstantProperty(new Cartesian2(1.0, 2.0));
+        var entity = new Entity();
+        entity.position = new ConstantPositionProperty(Cartesian3.fromDegrees(0, 0, 0));
+        entity.plane = planeGraphics;
+        return entity;
+    }
+
+    it('Constructor sets expected defaults', function() {
+        var entity = new Entity();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+
+        expect(updater.isDestroyed()).toBe(false);
+        expect(updater.entity).toBe(entity);
+        expect(updater.isClosed).toBe(true);
+        expect(updater.fillEnabled).toBe(false);
+        expect(updater.fillMaterialProperty).toBe(undefined);
+        expect(updater.outlineEnabled).toBe(false);
+        expect(updater.hasConstantFill).toBe(true);
+        expect(updater.hasConstantOutline).toBe(true);
+        expect(updater.outlineColorProperty).toBe(undefined);
+        expect(updater.outlineWidth).toBe(1.0);
+        expect(updater.shadowsProperty).toBe(undefined);
+        expect(updater.distanceDisplayConditionProperty).toBe(undefined);
+        expect(updater.isDynamic).toBe(false);
+        expect(updater.isOutlineVisible(time)).toBe(false);
+        expect(updater.isFilled(time)).toBe(false);
+        updater.destroy();
+        expect(updater.isDestroyed()).toBe(true);
+    });
+
+    it('No geometry available when plane is undefined ', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        entity.plane = undefined;
+
+        expect(updater.fillEnabled).toBe(false);
+        expect(updater.outlineEnabled).toBe(false);
+        expect(updater.isDynamic).toBe(false);
+    });
+
+    it('No geometry available when not filled or outline.', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        entity.plane.fill = new ConstantProperty(false);
+        entity.plane.outline = new ConstantProperty(false);
+
+        expect(updater.fillEnabled).toBe(false);
+        expect(updater.outlineEnabled).toBe(false);
+        expect(updater.isDynamic).toBe(false);
+    });
+
+    it('Values correct when using default graphics', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+
+        expect(updater.isClosed).toBe(true);
+        expect(updater.fillEnabled).toBe(true);
+        expect(updater.fillMaterialProperty).toEqual(new ColorMaterialProperty(Color.WHITE));
+        expect(updater.outlineEnabled).toBe(false);
+        expect(updater.hasConstantFill).toBe(true);
+        expect(updater.hasConstantOutline).toBe(true);
+        expect(updater.outlineColorProperty).toBe(undefined);
+        expect(updater.outlineWidth).toBe(1.0);
+        expect(updater.shadowsProperty).toEqual(new ConstantProperty(ShadowMode.DISABLED));
+        expect(updater.distanceDisplayConditionProperty).toEqual(new ConstantProperty(new DistanceDisplayCondition()));
+        expect(updater.isDynamic).toBe(false);
+    });
+
+    it('Plane material is correctly exposed.', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        entity.plane.material = new GridMaterialProperty(Color.BLUE);
+        expect(updater.fillMaterialProperty).toBe(entity.plane.material);
+    });
+
+    it('A time-varying outlineWidth causes geometry to be dynamic', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        entity.plane.outlineWidth = createDynamicProperty();
+        expect(updater.isDynamic).toBe(true);
+    });
+
+    it('A time-varying plane causes geometry to be dynamic', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        entity.plane.plane = createDynamicProperty();
+
+        expect(updater.isDynamic).toBe(true);
+    });
+
+    it('A time-varying dimensions causes geometry to be dynamic', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        entity.plane.dimensions = createDynamicProperty();
+
+        expect(updater.isDynamic).toBe(true);
+    });
+
+    function validateGeometryInstance(options) {
+        var entity = createBasicPlane();
+
+        var plane = entity.plane;
+        plane.show = new ConstantProperty(options.show);
+        plane.fill = new ConstantProperty(options.fill);
+        plane.material = options.material;
+        plane.outline = new ConstantProperty(options.outline);
+        plane.outlineColor = new ConstantProperty(options.outlineColor);
+        plane.plane = new ConstantProperty(options.plane);
+        plane.dimensions = new ConstantProperty(options.dimensions);
+        plane.distanceDisplayCondition = options.distanceDisplayCondition;
+
+        var updater = new PlaneGeometryUpdater(entity, scene);
+
+        var instance;
+        var geometry;
+        var attributes;
+        if (options.fill) {
+            instance = updater.createFillGeometryInstance(time);
+
+            attributes = instance.attributes;
+            if (options.material instanceof ColorMaterialProperty) {
+                expect(attributes.color.value).toEqual(ColorGeometryInstanceAttribute.toValue(options.material.color.getValue(time)));
+            } else {
+                expect(attributes.color).toBeUndefined();
+            }
+            expect(attributes.show.value).toEqual(ShowGeometryInstanceAttribute.toValue(options.fill));
+            if (options.distanceDisplayCondition) {
+                expect(attributes.distanceDisplayCondition.value).toEqual(DistanceDisplayConditionGeometryInstanceAttribute.toValue(options.distanceDisplayCondition));
+            }
+        }
+
+        if (options.outline) {
+            instance = updater.createOutlineGeometryInstance(time);
+
+            attributes = instance.attributes;
+            expect(attributes.color.value).toEqual(ColorGeometryInstanceAttribute.toValue(options.outlineColor));
+            expect(attributes.show.value).toEqual(ShowGeometryInstanceAttribute.toValue(options.fill));
+            if (options.distanceDisplayCondition) {
+                expect(attributes.distanceDisplayCondition.value).toEqual(DistanceDisplayConditionGeometryInstanceAttribute.toValue(options.distanceDisplayCondition));
+            }
+        }
+    }
+
+    it('Creates expected per-color geometry', function() {
+        validateGeometryInstance({
+            show : true,
+            material : new ColorMaterialProperty(Color.RED),
+            fill : true,
+            outline : true,
+            outlineColor : Color.BLUE,
+            plane : new Plane(Cartesian3.UNIT_X, 0.0),
+            dimensions : new Cartesian2(1.0, 2.0)
+        });
+    });
+
+    it('Creates expected per-material geometry', function() {
+        validateGeometryInstance({
+            show : true,
+            material : new GridMaterialProperty(),
+            fill : true,
+            outline : true,
+            outlineColor : Color.BLUE,
+            plane : new Plane(Cartesian3.UNIT_X, 0.0),
+            dimensions : new Cartesian2(1.0, 2.0)
+        });
+    });
+
+    it('Creates expected distance display condition geometry', function() {
+        validateGeometryInstance({
+            show : true,
+            material : new ColorMaterialProperty(Color.RED),
+            fill : true,
+            outline : true,
+            outlineColor : Color.BLUE,
+            plane : new Plane(Cartesian3.UNIT_X, 0.0),
+            dimensions : new Cartesian2(1.0, 2.0),
+            distanceDisplayCondition : new DistanceDisplayCondition(10.0, 100.0)
+        });
+    });
+
+    it('Correctly exposes outlineWidth', function() {
+        var entity = createBasicPlane();
+        entity.plane.outlineWidth = new ConstantProperty(8);
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        expect(updater.outlineWidth).toBe(8);
+    });
+
+    it('Attributes have expected values at creation time', function() {
+        var time1 = new JulianDate(0, 0);
+        var time2 = new JulianDate(10, 0);
+        var time3 = new JulianDate(20, 0);
+
+        var fill = new TimeIntervalCollectionProperty();
+        fill.intervals.addInterval(new TimeInterval({
+            start : time1,
+            stop : time2,
+            data : false
+        }));
+        fill.intervals.addInterval(new TimeInterval({
+            start : time2,
+            stop : time3,
+            isStartIncluded : false,
+            data : true
+        }));
+
+        var colorMaterial = new ColorMaterialProperty();
+        colorMaterial.color = new SampledProperty(Color);
+        colorMaterial.color.addSample(time, Color.YELLOW);
+        colorMaterial.color.addSample(time2, Color.BLUE);
+        colorMaterial.color.addSample(time3, Color.RED);
+
+        var outline = new TimeIntervalCollectionProperty();
+        outline.intervals.addInterval(new TimeInterval({
+            start : time1,
+            stop : time2,
+            data : false
+        }));
+        outline.intervals.addInterval(new TimeInterval({
+            start : time2,
+            stop : time3,
+            isStartIncluded : false,
+            data : true
+        }));
+
+        var outlineColor = new SampledProperty(Color);
+        outlineColor.addSample(time, Color.BLUE);
+        outlineColor.addSample(time2, Color.RED);
+        outlineColor.addSample(time3, Color.YELLOW);
+
+        var entity = createBasicPlane();
+        entity.plane.fill = fill;
+        entity.plane.material = colorMaterial;
+        entity.plane.outline = outline;
+        entity.plane.outlineColor = outlineColor;
+
+        var updater = new PlaneGeometryUpdater(entity, scene);
+
+        var instance = updater.createFillGeometryInstance(time2);
+        var attributes = instance.attributes;
+        expect(attributes.color.value).toEqual(ColorGeometryInstanceAttribute.toValue(colorMaterial.color.getValue(time2)));
+        expect(attributes.show.value).toEqual(ShowGeometryInstanceAttribute.toValue(fill.getValue(time2)));
+
+        instance = updater.createOutlineGeometryInstance(time2);
+        attributes = instance.attributes;
+        expect(attributes.color.value).toEqual(ColorGeometryInstanceAttribute.toValue(outlineColor.getValue(time2)));
+        expect(attributes.show.value).toEqual(ShowGeometryInstanceAttribute.toValue(outline.getValue(time2)));
+    });
+
+    it('createFillGeometryInstance obeys Entity.show is false.', function() {
+        var entity = createBasicPlane();
+        entity.show = false;
+        entity.plane.fill = true;
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        var instance = updater.createFillGeometryInstance(new JulianDate());
+        var attributes = instance.attributes;
+        expect(attributes.show.value).toEqual(ShowGeometryInstanceAttribute.toValue(false));
+    });
+
+    it('createOutlineGeometryInstance obeys Entity.show is false.', function() {
+        var entity = createBasicPlane();
+        entity.show = false;
+        entity.plane.outline = true;
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        var instance = updater.createFillGeometryInstance(new JulianDate());
+        var attributes = instance.attributes;
+        expect(attributes.show.value).toEqual(ShowGeometryInstanceAttribute.toValue(false));
+    });
+
+    it('dynamic updater sets properties', function() {
+        var entity = new Entity();
+        entity.position = new ConstantPositionProperty(Cartesian3.fromDegrees(0, 0, 0));
+        var planeGraphics = new PlaneGraphics();
+        entity.plane = planeGraphics;
+
+        planeGraphics.show = createDynamicProperty(true);
+        planeGraphics.plane = createDynamicProperty(new Plane(Cartesian3.UNIT_X, 0.0));
+        planeGraphics.dimensions = createDynamicProperty(new Cartesian3(1.0, 2.0));
+        planeGraphics.outline = createDynamicProperty(true);
+        planeGraphics.fill = createDynamicProperty(true);
+
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        var primitives = new PrimitiveCollection();
+        var dynamicUpdater = updater.createDynamicUpdater(primitives);
+        expect(primitives.length).toBe(0);
+
+        dynamicUpdater.update(JulianDate.now());
+        expect(primitives.length).toBe(2);
+        expect(dynamicUpdater.isDestroyed()).toBe(false);
+
+        expect(dynamicUpdater._options.id).toBe(entity);
+        expect(dynamicUpdater._options.plane).toEqual(planeGraphics.plane.getValue());
+        expect(dynamicUpdater._options.dimensions).toEqual(planeGraphics.dimensions.getValue());
+
+        entity.show = false;
+        dynamicUpdater.update(JulianDate.now());
+        expect(primitives.length).toBe(0);
+        entity.show = true;
+
+        planeGraphics.show.setValue(false);
+        dynamicUpdater.update(JulianDate.now());
+        expect(primitives.length).toBe(0);
+
+        planeGraphics.show.setValue(true);
+        planeGraphics.fill.setValue(false);
+        dynamicUpdater.update(JulianDate.now());
+        expect(primitives.length).toBe(1);
+
+        planeGraphics.fill.setValue(true);
+        planeGraphics.outline.setValue(false);
+        dynamicUpdater.update(JulianDate.now());
+        expect(primitives.length).toBe(1);
+
+        dynamicUpdater.destroy();
+        expect(primitives.length).toBe(0);
+        updater.destroy();
+    });
+
+    it('geometryChanged event is raised when expected', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        var listener = jasmine.createSpy('listener');
+        updater.geometryChanged.addEventListener(listener);
+
+        entity.plane.dimensions = new ConstantProperty();
+        expect(listener.calls.count()).toEqual(1);
+
+        entity.availability = new TimeIntervalCollection();
+        expect(listener.calls.count()).toEqual(2);
+
+        entity.plane.dimensions = undefined;
+        expect(listener.calls.count()).toEqual(3);
+
+        //Since there's no valid geometry, changing another property should not raise the event.
+        entity.plane.height = undefined;
+
+        //Modifying an unrelated property should not have any effect.
+        entity.viewFrom = new ConstantProperty(Cartesian3.UNIT_X);
+        expect(listener.calls.count()).toEqual(3);
+    });
+
+    it('createFillGeometryInstance throws if object is not filled', function() {
+        var entity = new Entity();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        expect(function() {
+            return updater.createFillGeometryInstance(time);
+        }).toThrowDeveloperError();
+    });
+
+    it('createFillGeometryInstance throws if no time provided', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        expect(function() {
+            return updater.createFillGeometryInstance(undefined);
+        }).toThrowDeveloperError();
+    });
+
+    it('createOutlineGeometryInstance throws if object is not outlined', function() {
+        var entity = new Entity();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        expect(function() {
+            return updater.createOutlineGeometryInstance(time);
+        }).toThrowDeveloperError();
+    });
+
+    it('createOutlineGeometryInstance throws if no time provided', function() {
+        var entity = createBasicPlane();
+        entity.plane.outline = new ConstantProperty(true);
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        expect(function() {
+            return updater.createOutlineGeometryInstance(undefined);
+        }).toThrowDeveloperError();
+    });
+
+    it('createDynamicUpdater throws if not dynamic', function() {
+        var entity = createBasicPlane();
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        expect(function() {
+            return updater.createDynamicUpdater(new PrimitiveCollection());
+        }).toThrowDeveloperError();
+    });
+
+    it('createDynamicUpdater throws if primitives undefined', function() {
+        var entity = createBasicPlane();
+        entity.plane.dimensions = createDynamicProperty(new Cartesian2(1.0, 2.0
+        ));
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        expect(updater.isDynamic).toBe(true);
+        expect(function() {
+            return updater.createDynamicUpdater(undefined);
+        }).toThrowDeveloperError();
+    });
+
+    it('dynamicUpdater.update throws if no time specified', function() {
+        var entity = createBasicPlane();
+        entity.plane.dimensions = createDynamicProperty(new Cartesian2(1.0, 2.0));
+        var updater = new PlaneGeometryUpdater(entity, scene);
+        var dynamicUpdater = updater.createDynamicUpdater(new PrimitiveCollection());
+        expect(function() {
+            dynamicUpdater.update(undefined);
+        }).toThrowDeveloperError();
+    });
+
+    it('Constructor throws if no Entity supplied', function() {
+        expect(function() {
+            return new PlaneGeometryUpdater(undefined, scene);
+        }).toThrowDeveloperError();
+    });
+
+    it('Constructor throws if no scene supplied', function() {
+        var entity = createBasicPlane();
+        expect(function() {
+            return new PlaneGeometryUpdater(entity, undefined);
+        }).toThrowDeveloperError();
+    });
+
+    var entity = createBasicPlane();
+    entity.plane.plane = createDynamicProperty(new Plane(Cartesian3.UNIT_X, 0.0));
+    entity.plane.dimensions = createDynamicProperty(new Cartesian2(1.0, 2.0));
+    createDynamicGeometryBoundingSphereSpecs(PlaneGeometryUpdater, entity, entity.plane, function() {
+        return scene;
+    });
+}, 'WebGL');
diff --git a/Specs/Scene/Batched3DModel3DTileContentSpec.js b/Specs/Scene/Batched3DModel3DTileContentSpec.js
index c5e948a855ed..1f77b3fba8ff 100644
--- a/Specs/Scene/Batched3DModel3DTileContentSpec.js
+++ b/Specs/Scene/Batched3DModel3DTileContentSpec.js
@@ -5,7 +5,9 @@ defineSuite([
         'Core/deprecationWarning',
         'Core/HeadingPitchRange',
         'Core/HeadingPitchRoll',
+        'Core/Plane',
         'Core/Transforms',
+        'Scene/ClippingPlanesCollection',
         'Specs/Cesium3DTilesTester',
         'Specs/createScene'
     ], function(
@@ -15,7 +17,9 @@ defineSuite([
         deprecationWarning,
         HeadingPitchRange,
         HeadingPitchRoll,
+        Plane,
         Transforms,
+        ClippingPlanesCollection,
         Cesium3DTilesTester,
         createScene) {
     'use strict';
@@ -288,6 +292,34 @@ defineSuite([
         });
     });
 
+    it('Updates model\'s clipping planes', function() {
+        return Cesium3DTilesTester.loadTileset(scene, withBatchTableUrl).then(function(tileset) {
+            var tile = tileset._root;
+            var content = tile.content;
+            var model = content._model;
+
+            expect(model.clippingPlanes).toBeDefined();
+            expect(model.clippingPlanes.planes.length).toBe(0);
+            expect(model.clippingPlanes.enabled).toBe(false);
+
+            tileset.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    new Plane(Cartesian3.UNIT_X, 0.0)
+                ]
+            });
+            content.update(tileset, scene.frameState);
+
+            expect(model.clippingPlanes).toBeDefined();
+            expect(model.clippingPlanes.planes.length).toBe(1);
+            expect(model.clippingPlanes.enabled).toBe(true);
+
+            tile._isClipped = false;
+            content.update(tileset, scene.frameState);
+
+            expect(model.clippingPlanes.enabled).toBe(false);
+        });
+    });
+
     it('destroys', function() {
         return Cesium3DTilesTester.tileDestroys(scene, withoutBatchTableUrl);
     });
diff --git a/Specs/Scene/Cesium3DTilesetSpec.js b/Specs/Scene/Cesium3DTilesetSpec.js
index c6f802b8f315..772c0ad0bde4 100644
--- a/Specs/Scene/Cesium3DTilesetSpec.js
+++ b/Specs/Scene/Cesium3DTilesetSpec.js
@@ -7,11 +7,13 @@ defineSuite([
         'Core/defined',
         'Core/getStringFromTypedArray',
         'Core/HeadingPitchRange',
+        'Core/Intersect',
         'Core/JulianDate',
         'Core/loadWithXhr',
         'Core/Math',
         'Core/Matrix4',
         'Core/PerspectiveFrustum',
+        'Core/Plane',
         'Core/PrimitiveType',
         'Core/RequestScheduler',
         'Renderer/ClearCommand',
@@ -22,6 +24,7 @@ defineSuite([
         'Scene/Cesium3DTileOptimizations',
         'Scene/Cesium3DTileRefine',
         'Scene/Cesium3DTileStyle',
+        'Scene/ClippingPlanesCollection',
         'Scene/CullFace',
         'Specs/Cesium3DTilesTester',
         'Specs/createScene',
@@ -36,11 +39,13 @@ defineSuite([
         defined,
         getStringFromTypedArray,
         HeadingPitchRange,
+        Intersect,
         JulianDate,
         loadWithXhr,
         CesiumMath,
         Matrix4,
         PerspectiveFrustum,
+        Plane,
         PrimitiveType,
         RequestScheduler,
         ClearCommand,
@@ -51,6 +56,7 @@ defineSuite([
         Cesium3DTileOptimizations,
         Cesium3DTileRefine,
         Cesium3DTileStyle,
+        ClippingPlanesCollection,
         CullFace,
         Cesium3DTilesTester,
         createScene,
@@ -2807,4 +2813,55 @@ defineSuite([
         });
     });
 
+    it('clipping planes cull hidden tiles', function() {
+        // Root tile has a content box that is half the extents of its box
+        // Expect to cull root tile and three child tiles
+        return Cesium3DTilesTester.loadTileset(scene, tilesetUrl).then(function(tileset) {
+            var visibility = tileset._root.visibility(scene.frameState, CullingVolume.MASK_INSIDE);
+
+            expect(visibility).not.toBe(CullingVolume.MASK_OUTSIDE);
+
+            var plane = new Plane(Cartesian3.UNIT_Z, 100000000.0);
+            tileset.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    plane
+                ]
+            });
+
+            visibility = tileset._root.visibility(scene.frameState, CullingVolume.MASK_INSIDE);
+
+            expect(visibility).toBe(CullingVolume.MASK_OUTSIDE);
+
+            plane.distance = 0.0;
+            visibility = tileset._root.visibility(scene.frameState, CullingVolume.MASK_INSIDE);
+
+            expect(visibility).not.toBe(CullingVolume.MASK_OUTSIDE);
+        });
+    });
+
+    it('clipping planes cull hidden content', function() {
+        // Root tile has a content box that is half the extents of its box
+        // Expect to cull root tile and three child tiles
+        return Cesium3DTilesTester.loadTileset(scene, tilesetUrl).then(function(tileset) {
+            var visibility = tileset._root.contentVisibility(scene.frameState);
+
+            expect(visibility).not.toBe(Intersect.OUTSIDE);
+
+            var plane = new Plane(Cartesian3.UNIT_Z, 100000000.0);
+            tileset.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    plane
+                ]
+            });
+
+            visibility = tileset._root.contentVisibility(scene.frameState);
+
+            expect(visibility).toBe(Intersect.OUTSIDE);
+
+            plane.distance = 0.0;
+            visibility = tileset._root.contentVisibility(scene.frameState);
+
+            expect(visibility).not.toBe(Intersect.OUTSIDE);
+        });
+    });
 }, 'WebGL');
diff --git a/Specs/Scene/ClippingPlanesCollectionSpec.js b/Specs/Scene/ClippingPlanesCollectionSpec.js
new file mode 100644
index 000000000000..eb640a7c7557
--- /dev/null
+++ b/Specs/Scene/ClippingPlanesCollectionSpec.js
@@ -0,0 +1,175 @@
+defineSuite([
+    'Scene/ClippingPlanesCollection',
+    'Core/BoundingSphere',
+    'Core/Cartesian3',
+    'Core/Cartesian4',
+    'Core/Color',
+    'Core/Intersect',
+    'Core/Matrix4',
+    'Core/Plane'
+], function(
+    ClippingPlanesCollection,
+    BoundingSphere,
+    Cartesian3,
+    Cartesian4,
+    Color,
+    Intersect,
+    Matrix4,
+    Plane) {
+    'use strict';
+
+    var clippingPlanes;
+    var planes = [
+        new Plane(Cartesian3.UNIT_X, 1.0),
+        new Plane(Cartesian3.UNIT_Y, 2.0)
+    ];
+
+    var transform = new Matrix4.fromTranslation(new Cartesian3(1.0, 2.0, 3.0));
+    var boundingVolume  = new BoundingSphere(Cartesian3.ZERO, 1.0);
+
+    it('default constructor', function() {
+        clippingPlanes = new ClippingPlanesCollection();
+        expect(clippingPlanes.planes).toEqual([]);
+        expect(clippingPlanes.enabled).toEqual(true);
+        expect(clippingPlanes.modelMatrix).toEqual(Matrix4.IDENTITY);
+        expect(clippingPlanes.edgeColor).toEqual(Color.WHITE);
+        expect(clippingPlanes.edgeWidth).toEqual(0.0);
+        expect(clippingPlanes.combineClippingRegions).toEqual(true);
+        expect(clippingPlanes._testIntersection).not.toBeUndefined();
+    });
+
+    it('transforms and packs planes into result paramter', function() {
+        clippingPlanes = new ClippingPlanesCollection({
+            planes : planes
+        });
+
+        var result = clippingPlanes.transformAndPackPlanes(transform);
+        expect(result.length).toEqual(2);
+        expect(result[0]).toEqual(new Cartesian4(1.0, 0.0, 0.0, -2.0));
+        expect(result[1]).toEqual(new Cartesian4(0.0, 1.0, 0.0, -4.0));
+    });
+
+    it('transforms and packs planes with no result parameter creates new array', function() {
+        clippingPlanes = new ClippingPlanesCollection({
+            planes : planes
+        });
+
+        var result = clippingPlanes.transformAndPackPlanes(transform);
+        expect(result.length).toEqual(2);
+        expect(result[0] instanceof Cartesian4).toBe(true);
+        expect(result[1] instanceof Cartesian4).toBe(true);
+    });
+
+    it('clone without a result parameter returns new identical copy', function() {
+        clippingPlanes = new ClippingPlanesCollection({
+            planes : planes,
+            enabled : false,
+            edgeColor : Color.RED,
+            modelMatrix : transform
+        });
+
+        var result = clippingPlanes.clone();
+        expect(result).not.toBe(clippingPlanes);
+        expect(result.planes[0]).toEqual(planes[0]);
+        expect(result.planes[1]).toEqual(planes[1]);
+        expect(result.enabled).toEqual(false);
+        expect(result.modelMatrix).toEqual(transform);
+        expect(result.edgeColor).toEqual(Color.RED);
+        expect(result.edgeWidth).toEqual(0.0);
+        expect(result.combineClippingRegions).toEqual(true);
+        expect(result._testIntersection).not.toBeUndefined();
+    });
+
+    it('clone stores copy in result parameter', function() {
+        clippingPlanes = new ClippingPlanesCollection({
+            planes : planes,
+            enabled : false,
+            edgeColor : Color.RED,
+            modelMatrix : transform
+        });
+        var result = new ClippingPlanesCollection();
+        var copy = clippingPlanes.clone(result);
+        expect(copy).toBe(result);
+        expect(result.planes[0]).toEqual(planes[0]);
+        expect(result.planes[1]).toEqual(planes[1]);
+        expect(result.enabled).toEqual(false);
+        expect(result.modelMatrix).toEqual(transform);
+        expect(result.edgeColor).toEqual(Color.RED);
+        expect(result.edgeWidth).toEqual(0.0);
+        expect(result.combineClippingRegions).toEqual(true);
+        expect(result._testIntersection).not.toBeUndefined();
+    });
+
+    it('setting combineClippingRegions updates testIntersection function', function() {
+        clippingPlanes = new ClippingPlanesCollection();
+        var originalIntersectFunction = clippingPlanes._testIntersection;
+
+        expect(clippingPlanes._testIntersection).not.toBeUndefined();
+
+        clippingPlanes.combineClippingRegions = false;
+
+        expect(clippingPlanes._testIntersection).not.toBe(originalIntersectFunction);
+    });
+
+    it('computes intersections with bounding volumes when combining clipping regions', function() {
+        clippingPlanes = new ClippingPlanesCollection();
+
+        var intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.INSIDE);
+
+        clippingPlanes.planes.push(new Plane(Cartesian3.UNIT_X, 2.0));
+        intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.OUTSIDE);
+
+        clippingPlanes.planes.push(new Plane(Cartesian3.UNIT_Y, 0.0));
+        intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.INTERSECTING);
+
+        clippingPlanes.planes.push(new Plane(Cartesian3.UNIT_Z, -1.0));
+        intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.INSIDE);
+
+        clippingPlanes.planes.push(new Plane(Cartesian3.UNIT_Z, 0.0));
+        intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.INSIDE);
+    });
+
+    it('computes intersections with bounding volumes when not combining clipping regions', function() {
+        clippingPlanes = new ClippingPlanesCollection({
+            combineClippingRegions : false
+        });
+
+        var intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.INSIDE);
+
+        clippingPlanes.planes.push(new Plane(Cartesian3.UNIT_Z, -1.0));
+        intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.INSIDE);
+
+        clippingPlanes.planes.push(new Plane(Cartesian3.UNIT_Y, 2.0));
+        intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.OUTSIDE);
+
+        clippingPlanes.planes.push(new Plane(Cartesian3.UNIT_X, 0.0));
+        intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.OUTSIDE);
+
+        var plane = clippingPlanes.planes.pop();
+        clippingPlanes.planes.pop();
+
+        clippingPlanes.planes.push(plane);
+        intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume);
+        expect(intersect).toEqual(Intersect.INTERSECTING);
+    });
+
+    it('computes intersections applies optional transform to planes', function() {
+        clippingPlanes = new ClippingPlanesCollection();
+
+        var intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume, transform);
+        expect(intersect).toEqual(Intersect.INSIDE);
+
+        clippingPlanes.planes.push(new Plane(Cartesian3.UNIT_X, -1.0));
+        intersect = clippingPlanes.computeIntersectionWithBoundingVolume(boundingVolume, transform);
+        expect(intersect).not.toEqual(Intersect.INSIDE);
+    });
+});
diff --git a/Specs/Scene/GlobeSurfaceTileProviderSpec.js b/Specs/Scene/GlobeSurfaceTileProviderSpec.js
index 40b865886b56..9bf9a81abc0a 100644
--- a/Specs/Scene/GlobeSurfaceTileProviderSpec.js
+++ b/Specs/Scene/GlobeSurfaceTileProviderSpec.js
@@ -8,11 +8,14 @@ defineSuite([
         'Core/Ellipsoid',
         'Core/EllipsoidTerrainProvider',
         'Core/GeographicProjection',
+        'Core/Intersect',
+        'Core/Plane',
         'Core/Rectangle',
         'Core/WebMercatorProjection',
         'Renderer/ContextLimits',
         'Renderer/RenderState',
         'Scene/BlendingState',
+        'Scene/ClippingPlanesCollection',
         'Scene/Fog',
         'Scene/Globe',
         'Scene/GlobeSurfaceShaderSet',
@@ -35,11 +38,14 @@ defineSuite([
         Ellipsoid,
         EllipsoidTerrainProvider,
         GeographicProjection,
+        Intersect,
+        Plane,
         Rectangle,
         WebMercatorProjection,
         ContextLimits,
         RenderState,
         BlendingState,
+        ClippingPlanesCollection,
         Fog,
         Globe,
         GlobeSurfaceShaderSet,
@@ -692,4 +698,118 @@ defineSuite([
         }).toThrowDeveloperError();
     });
 
+    it('clipping planes selectively disable rendering globe surface', function() {
+        expect(scene).toRender([0, 0, 0, 255]);
+
+        switchViewMode(SceneMode.SCENE3D, new GeographicProjection(Ellipsoid.WGS84));
+
+        return updateUntilDone(scene.globe).then(function() {
+            expect(scene).notToRender([0, 0, 0, 255]);
+
+            var result;
+            expect(scene).toRenderAndCall(function(rgba) {
+                result = rgba;
+                expect(rgba).not.toEqual([0, 0, 0, 255]);
+            });
+
+            var clipPlane = new Plane(Cartesian3.UNIT_Z, 10000.0);
+            scene.globe.clippingPlanes = new ClippingPlanesCollection ({
+                planes : [
+                    clipPlane
+                ]
+            });
+
+            expect(scene).notToRender(result);
+
+            clipPlane.distance = 0.0;
+
+            expect(scene).toRender(result);
+
+            scene.globe.clippingPlanes = undefined;
+        });
+    });
+
+    it('clipping planes apply edge styling to globe surface', function() {
+        expect(scene).toRender([0, 0, 0, 255]);
+
+        switchViewMode(SceneMode.SCENE3D, new GeographicProjection(Ellipsoid.WGS84));
+
+        return updateUntilDone(scene.globe).then(function() {
+            expect(scene).notToRender([0, 0, 0, 255]);
+
+            var result;
+            expect(scene).toRenderAndCall(function(rgba) {
+                result = rgba;
+                expect(rgba).not.toEqual([0, 0, 0, 255]);
+            });
+
+            var clipPlane = new Plane(Cartesian3.UNIT_Z, 1000.0);
+            scene.globe.clippingPlanes = new ClippingPlanesCollection ({
+                planes : [
+                    clipPlane
+                ],
+                edgeWidth : 20.0,
+                edgeColor : Color.RED
+            });
+
+            expect(scene).notToRender(result);
+
+            clipPlane.distance = 0.0;
+
+            expect(scene).toRender([255, 0, 0, 255]);
+
+            scene.globe.clippingPlanes = undefined;
+        });
+    });
+
+    it('clipping planes combine regions', function() {
+        expect(scene).toRender([0, 0, 0, 255]);
+
+        switchViewMode(SceneMode.SCENE3D, new GeographicProjection(Ellipsoid.WGS84));
+
+        return updateUntilDone(scene.globe).then(function() {
+            expect(scene).notToRender([0, 0, 0, 255]);
+
+            var result;
+            expect(scene).toRenderAndCall(function(rgba) {
+                result = rgba;
+                expect(rgba).not.toEqual([0, 0, 0, 255]);
+            });
+
+            scene.globe.clippingPlanes = new ClippingPlanesCollection ({
+                planes : [
+                    new Plane(Cartesian3.UNIT_Z, 10000.0),
+                    new Plane(Cartesian3.UNIT_X, 1000.0)
+                ],
+                combineClippingRegions: false
+            });
+
+            expect(scene).notToRender(result);
+
+            scene.globe.clippingPlanes.combineClippingRegions = true;
+
+            expect(scene).toRender(result);
+
+            scene.globe.clippingPlanes = undefined;
+        });
+    });
+
+    it('computes tile visibility culls tiles when clipped', function() {
+        scene.globe.clippingPlanes = new ClippingPlanesCollection ({
+            planes : [
+                new Plane(Cartesian3.UNIT_X, 10000000.0)
+            ]
+        });
+
+        var surface = scene.globe._surface;
+
+        scene.renderForSpecs();
+
+        var tile = surface._levelZeroTiles[0];
+        expect(surface.tileProvider.computeTileVisibility(tile, scene.frameState)).toBe(Intersect.OUTSIDE);
+        expect(tile.isClipped).toBe(true);
+
+        scene.globe.clippingPlanes = undefined;
+    });
+
 }, 'WebGL');
diff --git a/Specs/Scene/PointCloud3DTileContentSpec.js b/Specs/Scene/PointCloud3DTileContentSpec.js
index f70b614c718c..b327f6a85651 100644
--- a/Specs/Scene/PointCloud3DTileContentSpec.js
+++ b/Specs/Scene/PointCloud3DTileContentSpec.js
@@ -7,9 +7,12 @@ defineSuite([
         'Core/HeadingPitchRange',
         'Core/HeadingPitchRoll',
         'Core/Math',
+        'Core/Matrix4',
         'Core/PerspectiveFrustum',
+        'Core/Plane',
         'Core/Transforms',
         'Scene/Cesium3DTileStyle',
+        'Scene/ClippingPlanesCollection',
         'Scene/Expression',
         'Specs/Cesium3DTilesTester',
         'Specs/createScene',
@@ -23,9 +26,12 @@ defineSuite([
         HeadingPitchRange,
         HeadingPitchRoll,
         CesiumMath,
+        Matrix4,
         PerspectiveFrustum,
+        Plane,
         Transforms,
         Cesium3DTileStyle,
+        ClippingPlanesCollection,
         Expression,
         Cesium3DTilesTester,
         createScene,
@@ -685,6 +691,119 @@ defineSuite([
         });
     });
 
+    it('Updates clipping planes when clipping planes are enabled', function () {
+        return Cesium3DTilesTester.loadTileset(scene, pointCloudRGBUrl).then(function(tileset) {
+            var content = tileset._root.content;
+
+            expect(content._packedClippingPlanes).toBeDefined();
+            expect(content._packedClippingPlanes.length).toBe(0);
+            expect(content._modelViewMatrix).toEqual(Matrix4.IDENTITY);
+
+            tileset.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    new Plane(Cartesian3.UNIT_X, 0.0)
+                ]
+            });
+
+            content.update(tileset, scene.frameState);
+
+            expect(content._packedClippingPlanes.length).toBe(1);
+            expect(content._modelViewMatrix).not.toEqual(Matrix4.IDENTITY);
+        });
+    });
+
+    it('Does not update clipping planes when tile is not clipped', function () {
+        return Cesium3DTilesTester.loadTileset(scene, pointCloudRGBUrl).then(function(tileset) {
+            var tile = tileset._root;
+            tile._isClipped = false;
+            var content = tile.content;
+
+            expect(content._packedClippingPlanes).toBeDefined();
+            expect(content._packedClippingPlanes.length).toBe(0);
+            expect(content._modelViewMatrix).toEqual(Matrix4.IDENTITY);
+
+            tileset.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    new Plane(Cartesian3.UNIT_X, 0.0)
+                ]
+            });
+
+            content.update(tileset, scene.frameState);
+
+            expect(content._packedClippingPlanes.length).toBe(0);
+            expect(content._modelViewMatrix).toEqual(Matrix4.IDENTITY);
+        });
+    });
+
+    it('Clipping planes selectively disable rendering', function () {
+        return Cesium3DTilesTester.loadTileset(scene, pointCloudRGBUrl).then(function(tileset) {
+            var color;
+            expect(scene).toRenderAndCall(function(rgba) {
+                color = rgba;
+            });
+
+            var clipPlane = new Plane(Cartesian3.UNIT_Z, 10.0);
+            tileset.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    clipPlane
+                ],
+                modelMatrix : Transforms.eastNorthUpToFixedFrame(tileset.boundingSphere.center)
+            });
+
+            expect(scene).notToRender(color);
+
+            clipPlane.distance = 0.0;
+
+            expect(scene).toRender(color);
+        });
+    });
+
+    it('clipping planes apply edge styling', function() {
+        return Cesium3DTilesTester.loadTileset(scene, pointCloudRGBUrl).then(function(tileset) {
+            var color;
+            expect(scene).toRenderAndCall(function(rgba) {
+                color = rgba;
+            });
+
+            var clipPlane = new Plane(Cartesian3.UNIT_Z, 10.0);
+            tileset.clippingPlanes = new ClippingPlanesCollection ({
+                planes : [
+                    clipPlane
+                ],
+                modelMatrix : Transforms.eastNorthUpToFixedFrame(tileset.boundingSphere.center),
+                edgeWidth : 20.0,
+                edgeColor : Color.RED
+            });
+
+            expect(scene).notToRender(color);
+        });
+    });
+
+    it('clipping planes combine regions', function() {
+        return Cesium3DTilesTester.loadTileset(scene, pointCloudRGBUrl).then(function(tileset) {
+            var color;
+            expect(scene).toRenderAndCall(function(rgba) {
+                color = rgba;
+            });
+
+            tileset.clippingPlanes = new ClippingPlanesCollection ({
+                planes : [
+                    new Plane(Cartesian3.UNIT_Z, 10.0),
+                    new Plane(Cartesian3.UNIT_X, 0.0)
+                ],
+                modelMatrix : Transforms.eastNorthUpToFixedFrame(tileset.boundingSphere.center),
+                combineClippingRegions: false
+            });
+
+            expect(scene).notToRender(color);
+
+            tileset.clippingPlanes.combineClippingRegions = true;
+
+            expect(scene).toRender(color);
+        });
+    });
+
+
     it('destroys', function() {
         return Cesium3DTilesTester.tileDestroys(scene, pointCloudRGBUrl);
     });

From 77457f59d830199986ae22d89687ad7f46731054 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Thu, 30 Nov 2017 17:49:26 -0500
Subject: [PATCH 27/37] Fix errors

---
 Source/Scene/Model.js                         | 2 +-
 Specs/DataSources/PlaneGeometryUpdaterSpec.js | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/Source/Scene/Model.js b/Source/Scene/Model.js
index 41ec0cb64115..e5a570a58d63 100644
--- a/Source/Scene/Model.js
+++ b/Source/Scene/Model.js
@@ -645,7 +645,7 @@ define([
         this.opaquePass = defaultValue(options.opaquePass, Pass.OPAQUE);
 
         this._computedModelMatrix = new Matrix4(); // Derived from modelMatrix and scale
-        this._modelViewMatrix = new Matrix4(); // Derived from modelMatrix, scale, and the current view matrix
+        this._modelViewMatrix = Matrix4.clone(Matrix4.IDENTITY); // Derived from modelMatrix, scale, and the current view matrix
         this._initialRadius = undefined;           // Radius without model's scale property, model-matrix scale, animations, or skins
         this._boundingSphere = undefined;
         this._scaledBoundingSphere = new BoundingSphere();
diff --git a/Specs/DataSources/PlaneGeometryUpdaterSpec.js b/Specs/DataSources/PlaneGeometryUpdaterSpec.js
index 4e548da1d8f1..9ac0070e680c 100644
--- a/Specs/DataSources/PlaneGeometryUpdaterSpec.js
+++ b/Specs/DataSources/PlaneGeometryUpdaterSpec.js
@@ -181,7 +181,6 @@ defineSuite([
         var updater = new PlaneGeometryUpdater(entity, scene);
 
         var instance;
-        var geometry;
         var attributes;
         if (options.fill) {
             instance = updater.createFillGeometryInstance(time);

From 47e0ec3794dc49b05a51f4dfe1a871f7e85e881e Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 1 Dec 2017 11:03:49 -0500
Subject: [PATCH 28/37] Cleanup, update specs

---
 Source/Scene/ClippingPlanesCollection.js      |  46 ++++----
 Source/Scene/Globe.js                         |   2 +-
 Source/Scene/PointCloud3DTileContent.js       |  13 +--
 .../Builtin/Functions/discardIfClipped.glsl   |   2 +-
 .../discardIfClippedCombineRegions.glsl       |   2 +-
 Specs/Core/PlaneSpec.js                       |   7 +-
 Specs/DataSources/PlaneGeometryUpdaterSpec.js | 102 +++++++++---------
 Specs/Scene/ClippingPlanesCollectionSpec.js   |  45 ++++----
 Specs/Scene/GlobeSurfaceTileProviderSpec.js   |  40 +++++--
 9 files changed, 144 insertions(+), 115 deletions(-)

diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index b3fa262dd030..d1b9bf411386 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -1,25 +1,25 @@
 define([
-    '../Core/Cartesian3',
-    '../Core/Cartesian4',
-    '../Core/Check',
-    '../Core/Color',
-    '../Core/defaultValue',
-    '../Core/defined',
-    '../Core/defineProperties',
-    '../Core/Intersect',
-    '../Core/Matrix4',
-    '../Core/Plane'
-], function(
-    Cartesian3,
-    Cartesian4,
-    Check,
-    Color,
-    defaultValue,
-    defined,
-    defineProperties,
-    Intersect,
-    Matrix4,
-    Plane) {
+        '../Core/Cartesian3',
+        '../Core/Cartesian4',
+        '../Core/Check',
+        '../Core/Color',
+        '../Core/defaultValue',
+        '../Core/defined',
+        '../Core/defineProperties',
+        '../Core/Intersect',
+        '../Core/Matrix4',
+        '../Core/Plane'
+    ], function(
+        Cartesian3,
+        Cartesian4,
+        Check,
+        Color,
+        defaultValue,
+        defined,
+        defineProperties,
+        Intersect,
+        Matrix4,
+        Plane) {
     'use strict';
 
     /**
@@ -172,7 +172,9 @@ define([
         }
 
         var length = this.planes.length;
-        result.planes = new Array(length);
+        if (result.planes.length !== length) {
+            result.planes = new Array(length);
+        }
         for (var i = 0; i < length; ++i) {
             var plane = this.planes[i];
             result.planes[i] = new Plane(plane.normal, plane.distance);
diff --git a/Source/Scene/Globe.js b/Source/Scene/Globe.js
index a15bba2f77a2..150e780c1d01 100644
--- a/Source/Scene/Globe.js
+++ b/Source/Scene/Globe.js
@@ -238,7 +238,7 @@ define([
          * A property specifying an array of up to 6 {@link Plane} used to selectively disable rendering on the outside of each plane.
          *
          * @memberof Globe.prototype
-         * @type {ClippingPlaneCollection}
+         * @type {ClippingPlanesCollection}
          */
         clippingPlanes : {
             get : function() {
diff --git a/Source/Scene/PointCloud3DTileContent.js b/Source/Scene/PointCloud3DTileContent.js
index 69aa39d970ad..d22a7049085d 100644
--- a/Source/Scene/PointCloud3DTileContent.js
+++ b/Source/Scene/PointCloud3DTileContent.js
@@ -521,7 +521,6 @@ define([
         }
 
         var clippingPlanes = content._tileset.clippingPlanes;
-        var hasClippedContent = defined(clippingPlanes) && clippingPlanes.enabled && content._tile._isClipped;
         var uniformMap = {
             u_pointSizeAndTilesetTime : function() {
                 scratchPointSizeAndTilesetTime.x = content._pointSize;
@@ -538,13 +537,7 @@ define([
                 return content._packedClippingPlanes.length;
             },
             u_clippingPlanes : function() {
-                var packedPlanes = content._packedClippingPlanes;
-
-                if (hasClippedContent) {
-                    clippingPlanes.transformAndPackPlanes(content._modelViewMatrix, packedPlanes);
-                }
-
-                return packedPlanes;
+                return content._packedClippingPlanes;
             },
             u_clippingPlanesEdgeStyle : function() {
                 if (!defined(clippingPlanes)) {
@@ -1249,6 +1242,10 @@ define([
             this._parsedContent = undefined; // Unload
         }
 
+        if (clippingEnabled) {
+            clippingPlanes.transformAndPackPlanes(this._modelViewMatrix, this._packedClippingPlanes);
+        }
+
         var isClipped = this._tile._isClipped;
         if (this._isClipped !== isClipped) {
             this._isClipped = isClipped;
diff --git a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
index 74d0c51dc01f..dab7cae02566 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClipped.glsl
@@ -9,7 +9,7 @@
  * @param {int} clippingPlanesLength The number of planes in the array of clipping planes.
  * @returns {float} The distance away from a clipped fragment, in eyespace
  */
-float czm_discardIfClipped (vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength)
+float czm_discardIfClipped(vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength)
 {
     if (clippingPlanesLength > 0)
     {
diff --git a/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl b/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
index 4709159fddd1..9d69e3d49838 100644
--- a/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
+++ b/Source/Shaders/Builtin/Functions/discardIfClippedCombineRegions.glsl
@@ -9,7 +9,7 @@
  * @param {int} clippingPlanesLength The number of planes in the array of clipping planes.
  * @returns {float} The distance away from a clipped fragment, in eyespace
  */
-float czm_discardIfClippedCombineRegions (vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength)
+float czm_discardIfClippedCombineRegions(vec4[czm_maxClippingPlanes] clippingPlanes, int clippingPlanesLength)
 {
     if (clippingPlanesLength > 0)
     {
diff --git a/Specs/Core/PlaneSpec.js b/Specs/Core/PlaneSpec.js
index 94c851016ba4..9c9419457b30 100644
--- a/Specs/Core/PlaneSpec.js
+++ b/Specs/Core/PlaneSpec.js
@@ -136,6 +136,7 @@ defineSuite([
 
         var transform = Matrix4.fromUniformScale(2.0);
         transform = Matrix4.multiplyByMatrix3(transform, Matrix3.fromRotationY(Math.PI), transform);
+
         var transformedPlane = Plane.transform(plane, transform);
         expect(transformedPlane.distance).toEqual(-plane.distance * 2.0);
         expect(transformedPlane.normal.x).toEqualEpsilon(-plane.normal.x, CesiumMath.EPSILON10);
@@ -144,13 +145,13 @@ defineSuite([
     });
 
     it('transform throws without a plane', function() {
-        var point = Cartesian3.ZERO;
+        var transform = Matrix4.IDENTITY;
         expect(function() {
-            return Plane.transform(undefined, point);
+            return Plane.transform(undefined, transform);
         }).toThrowDeveloperError();
     });
 
-    it('transform throws without a point', function() {
+    it('transform throws without a transform', function() {
         var plane = new Plane(Cartesian3.UNIT_X, 0.0);
         expect(function() {
             return Plane.transform(plane, undefined);
diff --git a/Specs/DataSources/PlaneGeometryUpdaterSpec.js b/Specs/DataSources/PlaneGeometryUpdaterSpec.js
index 9ac0070e680c..9f01ae6abc4c 100644
--- a/Specs/DataSources/PlaneGeometryUpdaterSpec.js
+++ b/Specs/DataSources/PlaneGeometryUpdaterSpec.js
@@ -1,55 +1,55 @@
 defineSuite([
-    'DataSources/PlaneGeometryUpdater',
-    'Core/Cartesian2',
-    'Core/Cartesian3',
-    'Core/Color',
-    'Core/ColorGeometryInstanceAttribute',
-    'Core/DistanceDisplayCondition',
-    'Core/DistanceDisplayConditionGeometryInstanceAttribute',
-    'Core/JulianDate',
-    'Core/Plane',
-    'Core/ShowGeometryInstanceAttribute',
-    'Core/TimeInterval',
-    'Core/TimeIntervalCollection',
-    'DataSources/PlaneGraphics',
-    'DataSources/ColorMaterialProperty',
-    'DataSources/ConstantPositionProperty',
-    'DataSources/ConstantProperty',
-    'DataSources/Entity',
-    'DataSources/GridMaterialProperty',
-    'DataSources/SampledProperty',
-    'DataSources/TimeIntervalCollectionProperty',
-    'Scene/PrimitiveCollection',
-    'Scene/ShadowMode',
-    'Specs/createDynamicGeometryBoundingSphereSpecs',
-    'Specs/createDynamicProperty',
-    'Specs/createScene'
-], function(
-    PlaneGeometryUpdater,
-    Cartesian2,
-    Cartesian3,
-    Color,
-    ColorGeometryInstanceAttribute,
-    DistanceDisplayCondition,
-    DistanceDisplayConditionGeometryInstanceAttribute,
-    JulianDate,
-    Plane,
-    ShowGeometryInstanceAttribute,
-    TimeInterval,
-    TimeIntervalCollection,
-    PlaneGraphics,
-    ColorMaterialProperty,
-    ConstantPositionProperty,
-    ConstantProperty,
-    Entity,
-    GridMaterialProperty,
-    SampledProperty,
-    TimeIntervalCollectionProperty,
-    PrimitiveCollection,
-    ShadowMode,
-    createDynamicGeometryBoundingSphereSpecs,
-    createDynamicProperty,
-    createScene) {
+        'DataSources/PlaneGeometryUpdater',
+        'Core/Cartesian2',
+        'Core/Cartesian3',
+        'Core/Color',
+        'Core/ColorGeometryInstanceAttribute',
+        'Core/DistanceDisplayCondition',
+        'Core/DistanceDisplayConditionGeometryInstanceAttribute',
+        'Core/JulianDate',
+        'Core/Plane',
+        'Core/ShowGeometryInstanceAttribute',
+        'Core/TimeInterval',
+        'Core/TimeIntervalCollection',
+        'DataSources/PlaneGraphics',
+        'DataSources/ColorMaterialProperty',
+        'DataSources/ConstantPositionProperty',
+        'DataSources/ConstantProperty',
+        'DataSources/Entity',
+        'DataSources/GridMaterialProperty',
+        'DataSources/SampledProperty',
+        'DataSources/TimeIntervalCollectionProperty',
+        'Scene/PrimitiveCollection',
+        'Scene/ShadowMode',
+        'Specs/createDynamicGeometryBoundingSphereSpecs',
+        'Specs/createDynamicProperty',
+        'Specs/createScene'
+    ], function(
+        PlaneGeometryUpdater,
+        Cartesian2,
+        Cartesian3,
+        Color,
+        ColorGeometryInstanceAttribute,
+        DistanceDisplayCondition,
+        DistanceDisplayConditionGeometryInstanceAttribute,
+        JulianDate,
+        Plane,
+        ShowGeometryInstanceAttribute,
+        TimeInterval,
+        TimeIntervalCollection,
+        PlaneGraphics,
+        ColorMaterialProperty,
+        ConstantPositionProperty,
+        ConstantProperty,
+        Entity,
+        GridMaterialProperty,
+        SampledProperty,
+        TimeIntervalCollectionProperty,
+        PrimitiveCollection,
+        ShadowMode,
+        createDynamicGeometryBoundingSphereSpecs,
+        createDynamicProperty,
+        createScene) {
     'use strict';
 
     var scene;
diff --git a/Specs/Scene/ClippingPlanesCollectionSpec.js b/Specs/Scene/ClippingPlanesCollectionSpec.js
index eb640a7c7557..0645adaa6fd4 100644
--- a/Specs/Scene/ClippingPlanesCollectionSpec.js
+++ b/Specs/Scene/ClippingPlanesCollectionSpec.js
@@ -1,21 +1,21 @@
 defineSuite([
-    'Scene/ClippingPlanesCollection',
-    'Core/BoundingSphere',
-    'Core/Cartesian3',
-    'Core/Cartesian4',
-    'Core/Color',
-    'Core/Intersect',
-    'Core/Matrix4',
-    'Core/Plane'
-], function(
-    ClippingPlanesCollection,
-    BoundingSphere,
-    Cartesian3,
-    Cartesian4,
-    Color,
-    Intersect,
-    Matrix4,
-    Plane) {
+        'Scene/ClippingPlanesCollection',
+        'Core/BoundingSphere',
+        'Core/Cartesian3',
+        'Core/Cartesian4',
+        'Core/Color',
+        'Core/Intersect',
+        'Core/Matrix4',
+        'Core/Plane'
+    ], function(
+        ClippingPlanesCollection,
+        BoundingSphere,
+        Cartesian3,
+        Cartesian4,
+        Color,
+        Intersect,
+        Matrix4,
+        Plane) {
     'use strict';
 
     var clippingPlanes;
@@ -56,8 +56,8 @@ defineSuite([
 
         var result = clippingPlanes.transformAndPackPlanes(transform);
         expect(result.length).toEqual(2);
-        expect(result[0] instanceof Cartesian4).toBe(true);
-        expect(result[1] instanceof Cartesian4).toBe(true);
+        expect(result[0]).toBeInstanceOf(Cartesian4);
+        expect(result[1]).toBeInstanceOf(Cartesian4);
     });
 
     it('clone without a result parameter returns new identical copy', function() {
@@ -90,6 +90,7 @@ defineSuite([
         var result = new ClippingPlanesCollection();
         var copy = clippingPlanes.clone(result);
         expect(copy).toBe(result);
+        expect(result.planes).not.toBe(planes);
         expect(result.planes[0]).toEqual(planes[0]);
         expect(result.planes[1]).toEqual(planes[1]);
         expect(result.enabled).toEqual(false);
@@ -98,8 +99,14 @@ defineSuite([
         expect(result.edgeWidth).toEqual(0.0);
         expect(result.combineClippingRegions).toEqual(true);
         expect(result._testIntersection).not.toBeUndefined();
+
+        // Only allocate a new array if needed
+        var previousPlanes = result.planes;
+        clippingPlanes.clone(result);
+        expect(result.planes).toBe(previousPlanes);
     });
 
+
     it('setting combineClippingRegions updates testIntersection function', function() {
         clippingPlanes = new ClippingPlanesCollection();
         var originalIntersectFunction = clippingPlanes._testIntersection;
diff --git a/Specs/Scene/GlobeSurfaceTileProviderSpec.js b/Specs/Scene/GlobeSurfaceTileProviderSpec.js
index 9bf9a81abc0a..8a91459632ea 100644
--- a/Specs/Scene/GlobeSurfaceTileProviderSpec.js
+++ b/Specs/Scene/GlobeSurfaceTileProviderSpec.js
@@ -794,22 +794,44 @@ defineSuite([
         });
     });
 
-    it('computes tile visibility culls tiles when clipped', function() {
-        scene.globe.clippingPlanes = new ClippingPlanesCollection ({
+    it('computesTileVisibility culls tiles when they are entirely inside the clipped region', function() {
+        var globe = scene.globe;
+        var plane = new Plane(Cartesian3.UNIT_Z, 10000000.0);
+        globe.clippingPlanes = new ClippingPlanesCollection ({
             planes : [
-                new Plane(Cartesian3.UNIT_X, 10000000.0)
+                plane
             ]
         });
 
-        var surface = scene.globe._surface;
+        switchViewMode(SceneMode.SCENE3D, new GeographicProjection(Ellipsoid.WGS84));
+
+        return updateUntilDone(globe).then(function() {
+            var surface = globe._surface;
+            var tile = surface._levelZeroTiles[0];
+
+            expect(surface.tileProvider.computeTileVisibility(tile, scene.frameState)).toBe(Intersect.OUTSIDE);
+            expect(tile.isClipped).toBe(true);
 
-        scene.renderForSpecs();
+            plane.distance = 0.0;
+            scene.renderForSpecs();
+
+            surface = scene.globe._surface;
+            tile = surface._levelZeroTiles[0];
 
-        var tile = surface._levelZeroTiles[0];
-        expect(surface.tileProvider.computeTileVisibility(tile, scene.frameState)).toBe(Intersect.OUTSIDE);
-        expect(tile.isClipped).toBe(true);
+            expect(surface.tileProvider.computeTileVisibility(tile, scene.frameState, scene.globe._surface._occluders)).toBe(Intersect.INTERSECTING);
+            expect(tile.isClipped).toBe(true);
 
-        scene.globe.clippingPlanes = undefined;
+            plane.distance = -10000000.0;
+            scene.renderForSpecs();
+
+            surface = scene.globe._surface;
+            tile = surface._levelZeroTiles[0];
+
+            expect(surface.tileProvider.computeTileVisibility(tile, scene.frameState, scene.globe._surface._occluders)).toBe(Intersect.INTERSECTING);
+            expect(tile.isClipped).toBe(false);
+
+            scene.globe.clippingPlanes = undefined;
+        });
     });
 
 }, 'WebGL');

From 5680c34ba631cf493e99010fb36f245539fb6e69 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 1 Dec 2017 13:07:04 -0500
Subject: [PATCH 29/37] Fix plane geometry surface

---
 Source/DataSources/PlaneGeometryUpdater.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Source/DataSources/PlaneGeometryUpdater.js b/Source/DataSources/PlaneGeometryUpdater.js
index 6e18f19bdec4..bf2b4915665b 100644
--- a/Source/DataSources/PlaneGeometryUpdater.js
+++ b/Source/DataSources/PlaneGeometryUpdater.js
@@ -384,7 +384,7 @@ define([
 
         return new GeometryInstance({
             id : entity,
-            geometry : new PlaneGeometry(),
+            geometry : new PlaneGeometry(this._options),
             modelMatrix : modelMatrix,
             attributes : attributes
         });

From 21c96e9ce5551fdee69d1ed7ad9923c9b0a1379b Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 1 Dec 2017 14:43:46 -0500
Subject: [PATCH 30/37] Draw commands in specs

---
 Specs/Scene/Cesium3DTilesetSpec.js          | 91 ++++++++++++++++++++-
 Specs/Scene/GlobeSurfaceTileProviderSpec.js | 61 +++++++++-----
 2 files changed, 129 insertions(+), 23 deletions(-)

diff --git a/Specs/Scene/Cesium3DTilesetSpec.js b/Specs/Scene/Cesium3DTilesetSpec.js
index 772c0ad0bde4..f1487346875e 100644
--- a/Specs/Scene/Cesium3DTilesetSpec.js
+++ b/Specs/Scene/Cesium3DTilesetSpec.js
@@ -2814,8 +2814,6 @@ defineSuite([
     });
 
     it('clipping planes cull hidden tiles', function() {
-        // Root tile has a content box that is half the extents of its box
-        // Expect to cull root tile and three child tiles
         return Cesium3DTilesTester.loadTileset(scene, tilesetUrl).then(function(tileset) {
             var visibility = tileset._root.visibility(scene.frameState, CullingVolume.MASK_INSIDE);
 
@@ -2840,8 +2838,6 @@ defineSuite([
     });
 
     it('clipping planes cull hidden content', function() {
-        // Root tile has a content box that is half the extents of its box
-        // Expect to cull root tile and three child tiles
         return Cesium3DTilesTester.loadTileset(scene, tilesetUrl).then(function(tileset) {
             var visibility = tileset._root.contentVisibility(scene.frameState);
 
@@ -2864,4 +2860,91 @@ defineSuite([
             expect(visibility).not.toBe(Intersect.OUTSIDE);
         });
     });
+
+    it('clipping planes cull tiles completely inside', function() {
+        return Cesium3DTilesTester.loadTileset(scene, tilesetUrl).then(function(tileset) {
+            var statistics = tileset._statistics;
+            var root = tileset._root;
+
+            scene.renderForSpecs();
+
+            expect(statistics.numberOfCommands).toEqual(5);
+
+            tileset.update(scene.frameState);
+
+            var plane = new Plane(Cartesian3.UNIT_Z, 0.0);
+            tileset.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    plane
+                ]
+            });
+
+            tileset.update(scene.frameState);
+            scene.renderForSpecs();
+
+            expect(statistics.numberOfCommands).toEqual(5);
+            expect(root._isClipped).toBe(false);
+
+            plane.distance = 4081630.311150717; // center
+
+            tileset.update(scene.frameState);
+            scene.renderForSpecs();
+
+            expect(statistics.numberOfCommands).toEqual(3);
+            expect(root._isClipped).toBe(true);
+
+            plane.distance = 4081630.31115071 + 287.0736139905632; // center + radius
+
+            tileset.update(scene.frameState);
+            scene.renderForSpecs();
+
+            expect(statistics.numberOfCommands).toEqual(0);
+            expect(root._isClipped).toBe(true);
+        });
+    });
+
+    it('clipping planes cull tiles completely inside for i3dm', function() {
+        return Cesium3DTilesTester.loadTileset(scene, instancedUrl).then(function(tileset) {
+
+            console.log(tileset);
+
+            var statistics = tileset._statistics;
+            var root = tileset._root;
+
+            scene.renderForSpecs();
+
+            expect(statistics.numberOfCommands).toEqual(1);
+
+            tileset.update(scene.frameState);
+
+            var plane = new Plane(Cartesian3.UNIT_Z, 0.0);
+            tileset.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    plane
+                ]
+            });
+
+            tileset.update(scene.frameState);
+            scene.renderForSpecs();
+
+            expect(statistics.numberOfCommands).toEqual(1);
+            expect(root._isClipped).toBe(false);
+
+            plane.distance = 4081611.654572015; // center
+
+            tileset.update(scene.frameState);
+            scene.renderForSpecs();
+
+            expect(statistics.numberOfCommands).toEqual(1);
+            expect(root._isClipped).toBe(true);
+
+            plane.distance = 4081611.654572015 + 142.6291406685467; // center + radius
+
+            tileset.update(scene.frameState);
+            scene.renderForSpecs();
+
+            expect(statistics.numberOfCommands).toEqual(0);
+            expect(root._isClipped).toBe(true);
+        });
+    });
 }, 'WebGL');
diff --git a/Specs/Scene/GlobeSurfaceTileProviderSpec.js b/Specs/Scene/GlobeSurfaceTileProviderSpec.js
index 8a91459632ea..e21ddc426df1 100644
--- a/Specs/Scene/GlobeSurfaceTileProviderSpec.js
+++ b/Specs/Scene/GlobeSurfaceTileProviderSpec.js
@@ -729,7 +729,7 @@ defineSuite([
         });
     });
 
-    it('clipping planes apply edge styling to globe surface', function() {
+    it('renders with clipping planes edge styling on globe surface', function() {
         expect(scene).toRender([0, 0, 0, 255]);
 
         switchViewMode(SceneMode.SCENE3D, new GeographicProjection(Ellipsoid.WGS84));
@@ -762,7 +762,7 @@ defineSuite([
         });
     });
 
-    it('clipping planes combine regions', function() {
+    it('renders with multiple clipping planes and combined regions', function() {
         expect(scene).toRender([0, 0, 0, 255]);
 
         switchViewMode(SceneMode.SCENE3D, new GeographicProjection(Ellipsoid.WGS84));
@@ -794,12 +794,20 @@ defineSuite([
         });
     });
 
-    it('computesTileVisibility culls tiles when they are entirely inside the clipped region', function() {
+    it('No extra tiles culled with no clipping planes', function() {
+        var globe = scene.globe;
+        switchViewMode(SceneMode.SCENE3D, new GeographicProjection(Ellipsoid.WGS84));
+
+        return updateUntilDone(globe).then(function() {
+            expect(scene.frameState.commandList.length).toBe(4);
+        });
+    });
+
+    it('Culls tiles when completely inside clipping region', function() {
         var globe = scene.globe;
-        var plane = new Plane(Cartesian3.UNIT_Z, 10000000.0);
         globe.clippingPlanes = new ClippingPlanesCollection ({
             planes : [
-                plane
+                new Plane(Cartesian3.UNIT_Z, 1000000.0)
             ]
         });
 
@@ -808,29 +816,44 @@ defineSuite([
         return updateUntilDone(globe).then(function() {
             var surface = globe._surface;
             var tile = surface._levelZeroTiles[0];
-
-            expect(surface.tileProvider.computeTileVisibility(tile, scene.frameState)).toBe(Intersect.OUTSIDE);
             expect(tile.isClipped).toBe(true);
+            expect(scene.frameState.commandList.length).toBe(2);
+        });
+    });
 
-            plane.distance = 0.0;
-            scene.renderForSpecs();
+    it('Doesn\'t cull, but clips tiles when intersecting clipping plane', function() {
+        var globe = scene.globe;
+        globe.clippingPlanes = new ClippingPlanesCollection ({
+            planes : [
+                new Plane(Cartesian3.UNIT_Z, 0.0)
+            ]
+        });
 
-            surface = scene.globe._surface;
-            tile = surface._levelZeroTiles[0];
+        switchViewMode(SceneMode.SCENE3D, new GeographicProjection(Ellipsoid.WGS84));
 
-            expect(surface.tileProvider.computeTileVisibility(tile, scene.frameState, scene.globe._surface._occluders)).toBe(Intersect.INTERSECTING);
+        return updateUntilDone(globe).then(function() {
+            var surface = globe._surface;
+            var tile = surface._levelZeroTiles[0];
             expect(tile.isClipped).toBe(true);
+            expect(scene.frameState.commandList.length).toBe(4);
+        });
+    });
 
-            plane.distance = -10000000.0;
-            scene.renderForSpecs();
+    it('Doesn\'t cull or clip tiles when completely outside clipping region', function() {
+        var globe = scene.globe;
+        globe.clippingPlanes = new ClippingPlanesCollection ({
+            planes : [
+                new Plane(Cartesian3.UNIT_Z, -10000000.0)
+            ]
+        });
 
-            surface = scene.globe._surface;
-            tile = surface._levelZeroTiles[0];
+        switchViewMode(SceneMode.SCENE3D, new GeographicProjection(Ellipsoid.WGS84));
 
-            expect(surface.tileProvider.computeTileVisibility(tile, scene.frameState, scene.globe._surface._occluders)).toBe(Intersect.INTERSECTING);
+        return updateUntilDone(globe).then(function() {
+            var surface = globe._surface;
+            var tile = surface._levelZeroTiles[0];
             expect(tile.isClipped).toBe(false);
-
-            scene.globe.clippingPlanes = undefined;
+            expect(scene.frameState.commandList.length).toBe(4);
         });
     });
 

From 3b069caedf0be6eb3a36b8cde95e355fb4bbabfa Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 1 Dec 2017 15:47:06 -0500
Subject: [PATCH 31/37] Model and PlaneGeometry Specs

---
 Specs/DataSources/PlaneGraphicsSpec.js     | 179 +++++++++++++++++++++
 Specs/Scene/ModelSpec.js                   | 144 ++++++++++++++++-
 Specs/Scene/PointCloud3DTileContentSpec.js |   1 -
 3 files changed, 320 insertions(+), 4 deletions(-)
 create mode 100644 Specs/DataSources/PlaneGraphicsSpec.js

diff --git a/Specs/DataSources/PlaneGraphicsSpec.js b/Specs/DataSources/PlaneGraphicsSpec.js
new file mode 100644
index 000000000000..ba79c4cf1dad
--- /dev/null
+++ b/Specs/DataSources/PlaneGraphicsSpec.js
@@ -0,0 +1,179 @@
+defineSuite([
+        'DataSources/PlaneGraphics',
+        'Core/Cartesian2',
+        'Core/Cartesian3',
+        'Core/Color',
+        'Core/DistanceDisplayCondition',
+        'Core/Plane',
+        'DataSources/ColorMaterialProperty',
+        'DataSources/ConstantProperty',
+        'Scene/ShadowMode',
+        'Specs/testDefinitionChanged',
+        'Specs/testMaterialDefinitionChanged'
+    ], function(
+        PlaneGraphics,
+        Cartesian2,
+        Cartesian3,
+        Color,
+        DistanceDisplayCondition,
+        Plane,
+        ColorMaterialProperty,
+        ConstantProperty,
+        ShadowMode,
+        testDefinitionChanged,
+        testMaterialDefinitionChanged) {
+    'use strict';
+
+    it('creates expected instance from raw assignment and construction', function() {
+        var options = {
+            material : Color.BLUE,
+            show : true,
+            fill : false,
+            outline : false,
+            outlineColor : Color.RED,
+            outlineWidth : 1,
+            plane : new Plane(Cartesian3.UNIT_X, 0.0),
+            dimensions : new Cartesian2(2.0, 3.0),
+            shadows : ShadowMode.DISABLED,
+            distanceDisplayCondition : new DistanceDisplayCondition(10.0, 100.0)
+        };
+
+        var plane = new PlaneGraphics(options);
+        expect(plane.material).toBeInstanceOf(ColorMaterialProperty);
+        expect(plane.show).toBeInstanceOf(ConstantProperty);
+        expect(plane.fill).toBeInstanceOf(ConstantProperty);
+        expect(plane.outline).toBeInstanceOf(ConstantProperty);
+        expect(plane.outlineColor).toBeInstanceOf(ConstantProperty);
+        expect(plane.outlineWidth).toBeInstanceOf(ConstantProperty);
+        expect(plane.plane).toBeInstanceOf(ConstantProperty);
+        expect(plane.dimensions).toBeInstanceOf(ConstantProperty);
+        expect(plane.shadows).toBeInstanceOf(ConstantProperty);
+        expect(plane.distanceDisplayCondition).toBeInstanceOf(ConstantProperty);
+
+        expect(plane.material.color.getValue()).toEqual(options.material);
+        expect(plane.show.getValue()).toEqual(options.show);
+        expect(plane.fill.getValue()).toEqual(options.fill);
+        expect(plane.outline.getValue()).toEqual(options.outline);
+        expect(plane.outlineColor.getValue()).toEqual(options.outlineColor);
+        expect(plane.outlineWidth.getValue()).toEqual(options.outlineWidth);
+        expect(plane.plane.getValue()).toEqual(options.plane);
+        expect(plane.dimensions.getValue()).toEqual(options.dimensions);
+        expect(plane.shadows.getValue()).toEqual(options.shadows);
+        expect(plane.distanceDisplayCondition.getValue()).toEqual(options.distanceDisplayCondition);
+    });
+
+    it('merge assigns unassigned properties', function() {
+        var source = new PlaneGraphics();
+        source.material = new ColorMaterialProperty();
+        source.show = new ConstantProperty();
+        source.fill = new ConstantProperty();
+        source.outline = new ConstantProperty();
+        source.outlineColor = new ConstantProperty();
+        source.outlineWidth = new ConstantProperty();
+        source.plane = new ConstantProperty();
+        source.dimensions = new ConstantProperty();
+        source.shadows = new ConstantProperty(ShadowMode.ENABLED);
+        source.distanceDisplayCondition = new ConstantProperty(new DistanceDisplayCondition(10.0, 100.0));
+
+        var target = new PlaneGraphics();
+        target.merge(source);
+
+        expect(target.material).toBe(source.material);
+        expect(target.show).toBe(source.show);
+        expect(target.fill).toBe(source.fill);
+        expect(target.outline).toBe(source.outline);
+        expect(target.outlineColor).toBe(source.outlineColor);
+        expect(target.outlineWidth).toBe(source.outlineWidth);
+        expect(target.plane).toBe(source.plane);
+        expect(target.dimensions).toBe(source.dimensions);
+        expect(target.shadows).toBe(source.shadows);
+        expect(target.distanceDisplayCondition).toBe(source.distanceDisplayCondition);
+    });
+
+    it('merge does not assign assigned properties', function() {
+        var source = new PlaneGraphics();
+
+        var material = new ColorMaterialProperty();
+        var show = new ConstantProperty();
+        var fill = new ConstantProperty();
+        var outline = new ConstantProperty();
+        var outlineColor = new ConstantProperty();
+        var outlineWidth = new ConstantProperty();
+        var plane = new ConstantProperty();
+        var dimensions = new ConstantProperty();
+        var shadows = new ConstantProperty();
+        var distanceDisplayCondition = new ConstantProperty();
+
+        var target = new PlaneGraphics();
+        target.material = material;
+        target.show = show;
+        target.fill = fill;
+        target.outline = outline;
+        target.outlineColor = outlineColor;
+        target.outlineWidth = outlineWidth;
+        target.plane = plane;
+        target.dimensions = dimensions;
+        target.shadows = shadows;
+        target.distanceDisplayCondition = distanceDisplayCondition;
+
+        target.merge(source);
+
+        expect(target.material).toBe(material);
+        expect(target.show).toBe(show);
+        expect(target.fill).toBe(fill);
+        expect(target.outline).toBe(outline);
+        expect(target.outlineColor).toBe(outlineColor);
+        expect(target.outlineWidth).toBe(outlineWidth);
+        expect(target.plane).toBe(plane);
+        expect(target.dimensions).toBe(dimensions);
+        expect(target.shadows).toBe(shadows);
+        expect(target.distanceDisplayCondition).toBe(distanceDisplayCondition);
+    });
+
+    it('clone works', function() {
+        var source = new PlaneGraphics();
+        source.material = new ColorMaterialProperty();
+        source.show = new ConstantProperty();
+        source.fill = new ConstantProperty();
+        source.outline = new ConstantProperty();
+        source.outlineColor = new ConstantProperty();
+        source.outlineWidth = new ConstantProperty();
+        source.plane = new ConstantProperty();
+        source.dimensions = new ConstantProperty();
+        source.shadows = new ConstantProperty();
+        source.distanceDisplayCondition = new ConstantProperty();
+
+        var result = source.clone();
+        expect(result.material).toBe(source.material);
+        expect(result.show).toBe(source.show);
+        expect(result.fill).toBe(source.fill);
+        expect(result.outline).toBe(source.outline);
+        expect(result.outlineColor).toBe(source.outlineColor);
+        expect(result.outlineWidth).toBe(source.outlineWidth);
+        expect(result.plane).toBe(source.plane);
+        expect(result.dimensions).toBe(source.dimensions);
+        expect(result.shadows).toBe(source.shadows);
+        expect(result.distanceDisplayCondition).toBe(source.distanceDisplayCondition);
+    });
+
+    it('merge throws if source undefined', function() {
+        var target = new PlaneGraphics();
+        expect(function() {
+            target.merge(undefined);
+        }).toThrowDeveloperError();
+    });
+
+    it('raises definitionChanged when a property is assigned or modified', function() {
+        var property = new PlaneGraphics();
+        testMaterialDefinitionChanged(property, 'material', Color.RED, Color.BLUE);
+        testDefinitionChanged(property, 'show', true, false);
+        testDefinitionChanged(property, 'fill', false, true);
+        testDefinitionChanged(property, 'outline', true, false);
+        testDefinitionChanged(property, 'outlineColor', Color.RED, Color.BLUE);
+        testDefinitionChanged(property, 'outlineWidth', 2, 3);
+        testDefinitionChanged(property, 'plane', new Plane(Cartesian3.UNIT_X, 0.0), new Plane(Cartesian3.UNIT_Z, 1.0));
+        testDefinitionChanged(property, 'dimensions', new Cartesian2(0.0, 0.0), new Cartesian2(1.0, 1.0));
+        testDefinitionChanged(property, 'shadows', ShadowMode.ENABLED, ShadowMode.DISABLED);
+        testDefinitionChanged(property, 'distanceDisplayCondition', new DistanceDisplayCondition(), new DistanceDisplayCondition(10.0, 100.0));
+    });
+});
diff --git a/Specs/Scene/ModelSpec.js b/Specs/Scene/ModelSpec.js
index 7ae7ba9e3385..c52fdb0a614b 100644
--- a/Specs/Scene/ModelSpec.js
+++ b/Specs/Scene/ModelSpec.js
@@ -22,6 +22,7 @@ defineSuite([
         'Core/Matrix3',
         'Core/Matrix4',
         'Core/PerspectiveFrustum',
+        'Core/Plane',
         'Core/PrimitiveType',
         'Core/Transforms',
         'Core/WebGLConstants',
@@ -29,6 +30,7 @@ defineSuite([
         'Renderer/RenderState',
         'Renderer/ShaderSource',
         'Scene/Axis',
+        'Scene/ClippingPlanesCollection',
         'Scene/ColorBlendMode',
         'Scene/HeightReference',
         'Scene/ModelAnimationLoop',
@@ -59,6 +61,7 @@ defineSuite([
         Matrix3,
         Matrix4,
         PerspectiveFrustum,
+        Plane,
         PrimitiveType,
         Transforms,
         WebGLConstants,
@@ -66,6 +69,7 @@ defineSuite([
         RenderState,
         ShaderSource,
         Axis,
+        ClippingPlanesCollection,
         ColorBlendMode,
         HeightReference,
         ModelAnimationLoop,
@@ -2397,6 +2401,8 @@ defineSuite([
             scene.renderForSpecs();
             var commands = scene.frameState.commandList;
             expect(commands.length).toBe(0);
+
+            primitives.remove(model);
         });
     });
 
@@ -2503,9 +2509,9 @@ defineSuite([
             model.silhouetteColor = Color.GREEN;
 
             // Load a second model
-            return loadModel(boxUrl).then(function(model) {
-                model.show = true;
-                model.silhouetteSize = 1.0;
+            return loadModel(boxUrl).then(function(model2) {
+                model2.show = true;
+                model2.silhouetteSize = 1.0;
                 scene.renderForSpecs();
                 expect(commands.length).toBe(4);
                 expect(commands[0].renderState.stencilTest.enabled).toBe(true);
@@ -2520,7 +2526,139 @@ defineSuite([
                 var reference1 = commands[0].renderState.stencilTest.reference;
                 var reference2 = commands[2].renderState.stencilTest.reference;
                 expect(reference2).toEqual(reference1 + 1);
+
+                primitives.remove(model);
+                primitives.remove(model2);
+            });
+        });
+    });
+
+    it('Updates clipping planes when clipping planes are enabled', function () {
+        return loadModel(boxUrl).then(function(model) {
+            model.show = true;
+            model.zoomTo();
+
+            scene.renderForSpecs();
+
+            expect(model._packedClippingPlanes).toBeDefined();
+            expect(model._packedClippingPlanes.length).toBe(0);
+            expect(model._modelViewMatrix).toEqual(Matrix4.IDENTITY);
+
+            model.clippingPlanes = new ClippingPlanesCollection({
+               planes : [
+                   new Plane(Cartesian3.UNIT_X, 0.0)
+               ]
             });
+
+            model.update(scene.frameState);
+            scene.renderForSpecs();
+
+            expect(model._packedClippingPlanes.length).toBe(1);
+            expect(model._modelViewMatrix).not.toEqual(Matrix4.IDENTITY);
+
+            primitives.remove(model);
+        });
+    });
+
+    it('Clipping planes selectively disable rendering', function () {
+        return loadModel(boxUrl).then(function(model) {
+            model.show = true;
+            model.zoomTo();
+
+            var modelColor;
+            model.update(scene.frameState);
+            expect(scene).toRenderAndCall(function(rgba) {
+                modelColor = rgba;
+            });
+
+            var plane = new Plane(Cartesian3.UNIT_X, 0.0);
+            model.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    plane
+                ]
+            });
+
+            model.update(scene.frameState);
+            expect(scene).toRenderAndCall(function(rgba) {
+                expect(rgba).not.toEqual(modelColor);
+            });
+
+            plane.distance = -10.0;
+            model.update(scene.frameState);
+            expect(scene).toRenderAndCall(function(rgba) {
+                expect(rgba).toEqual(modelColor);
+            });
+
+            primitives.remove(model);
+        });
+    });
+
+    it('Clipping planes apply edge styling', function () {
+        return loadModel(boxUrl).then(function(model) {
+            model.show = true;
+            model.zoomTo();
+
+            var modelColor;
+            model.update(scene.frameState);
+            expect(scene).toRenderAndCall(function(rgba) {
+                modelColor = rgba;
+            });
+
+            var plane = new Plane(Cartesian3.UNIT_X, 0.0);
+            model.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    plane
+                ],
+                edgeWidth : 5.0,
+                edgeColor : Color.BLUE
+            });
+
+            model.update(scene.frameState);
+            expect(scene).toRenderAndCall(function(rgba) {
+                expect(rgba).not.toEqual(modelColor);
+            });
+
+            plane.distance = -5.0;
+            model.update(scene.frameState);
+            expect(scene).toRenderAndCall(function(rgba) {
+                expect(rgba).toEqual([0, 0, 255, 255]);
+            });
+
+            primitives.remove(model);
+        });
+    });
+
+    it('Clipping planes combien regions', function () {
+        return loadModel(boxUrl).then(function(model) {
+            model.show = true;
+            model.zoomTo();
+
+            var modelColor;
+            model.update(scene.frameState);
+            expect(scene).toRenderAndCall(function(rgba) {
+                modelColor = rgba;
+            });
+
+            model.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    new Plane(Cartesian3.UNIT_Z, -5.0),
+                    new Plane(Cartesian3.UNIT_X, 0.0)
+                ],
+                combineClippingRegions: false
+            });
+
+            model.update(scene.frameState);
+            expect(scene).toRenderAndCall(function(rgba) {
+                expect(rgba).not.toEqual(modelColor);
+            });
+
+            model.clippingPlanes._combineClippingRegions = true;
+            model.update(scene.frameState);
+            expect(scene).toRenderAndCall(function(rgba) {
+                expect(rgba).toEqual(modelColor);
+            });
+
+            primitives.remove(model);
         });
     });
 
diff --git a/Specs/Scene/PointCloud3DTileContentSpec.js b/Specs/Scene/PointCloud3DTileContentSpec.js
index b327f6a85651..b45c5c706682 100644
--- a/Specs/Scene/PointCloud3DTileContentSpec.js
+++ b/Specs/Scene/PointCloud3DTileContentSpec.js
@@ -803,7 +803,6 @@ defineSuite([
         });
     });
 
-
     it('destroys', function() {
         return Cesium3DTilesTester.tileDestroys(scene, pointCloudRGBUrl);
     });

From 82a2780d9ecce10167fca9eb22707308ea27ba02 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 1 Dec 2017 16:00:07 -0500
Subject: [PATCH 32/37] Cleanup

---
 Specs/Scene/Cesium3DTilesetSpec.js | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/Specs/Scene/Cesium3DTilesetSpec.js b/Specs/Scene/Cesium3DTilesetSpec.js
index f1487346875e..841adfd5861e 100644
--- a/Specs/Scene/Cesium3DTilesetSpec.js
+++ b/Specs/Scene/Cesium3DTilesetSpec.js
@@ -2861,7 +2861,7 @@ defineSuite([
         });
     });
 
-    it('clipping planes cull tiles completely inside', function() {
+    it('clipping planes cull tiles completely inside clipping region', function() {
         return Cesium3DTilesTester.loadTileset(scene, tilesetUrl).then(function(tileset) {
             var statistics = tileset._statistics;
             var root = tileset._root;
@@ -2903,11 +2903,8 @@ defineSuite([
         });
     });
 
-    it('clipping planes cull tiles completely inside for i3dm', function() {
+    it('clipping planes cull tiles completely inside clipping region for i3dm', function() {
         return Cesium3DTilesTester.loadTileset(scene, instancedUrl).then(function(tileset) {
-
-            console.log(tileset);
-
             var statistics = tileset._statistics;
             var root = tileset._root;
 

From ca40033736046f1e577555aee4f4f1f623bde8d7 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 1 Dec 2017 16:07:19 -0500
Subject: [PATCH 33/37] i3dm tileset in specs

---
 Specs/Scene/Cesium3DTilesetSpec.js | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/Specs/Scene/Cesium3DTilesetSpec.js b/Specs/Scene/Cesium3DTilesetSpec.js
index 841adfd5861e..1c87581a8a78 100644
--- a/Specs/Scene/Cesium3DTilesetSpec.js
+++ b/Specs/Scene/Cesium3DTilesetSpec.js
@@ -2904,13 +2904,13 @@ defineSuite([
     });
 
     it('clipping planes cull tiles completely inside clipping region for i3dm', function() {
-        return Cesium3DTilesTester.loadTileset(scene, instancedUrl).then(function(tileset) {
+        return Cesium3DTilesTester.loadTileset(scene, tilesetWithExternalResourcesUrl).then(function(tileset) {
             var statistics = tileset._statistics;
             var root = tileset._root;
 
             scene.renderForSpecs();
 
-            expect(statistics.numberOfCommands).toEqual(1);
+            expect(statistics.numberOfCommands).toEqual(6);
 
             tileset.update(scene.frameState);
 
@@ -2924,18 +2924,18 @@ defineSuite([
             tileset.update(scene.frameState);
             scene.renderForSpecs();
 
-            expect(statistics.numberOfCommands).toEqual(1);
+            expect(statistics.numberOfCommands).toEqual(6);
             expect(root._isClipped).toBe(false);
 
-            plane.distance = 4081611.654572015; // center
+            plane.distance = 4081608.4377916814; // center
 
             tileset.update(scene.frameState);
             scene.renderForSpecs();
 
-            expect(statistics.numberOfCommands).toEqual(1);
+            expect(statistics.numberOfCommands).toEqual(6);
             expect(root._isClipped).toBe(true);
 
-            plane.distance = 4081611.654572015 + 142.6291406685467; // center + radius
+            plane.distance = 4081608.4377916814 + 142.19001637409772; // center + radius
 
             tileset.update(scene.frameState);
             scene.renderForSpecs();

From 31079f72bad6ead15800aab8dd9c04a537fc83bf Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 1 Dec 2017 17:10:24 -0500
Subject: [PATCH 34/37] Added i3dm tilesets

---
 Source/Scene/Batched3DModel3DTileContent.js   |  6 +++---
 Source/Scene/ClippingPlanesCollection.js      | 12 ++++++++++--
 Source/Scene/Instanced3DModel3DTileContent.js | 15 ++++++++++++++-
 3 files changed, 27 insertions(+), 6 deletions(-)

diff --git a/Source/Scene/Batched3DModel3DTileContent.js b/Source/Scene/Batched3DModel3DTileContent.js
index 6013c32f9727..ec9df91a15e1 100644
--- a/Source/Scene/Batched3DModel3DTileContent.js
+++ b/Source/Scene/Batched3DModel3DTileContent.js
@@ -14,10 +14,10 @@ define([
         '../Core/RequestType',
         '../Core/RuntimeError',
         '../Renderer/Pass',
-        '../Scene/ClippingPlanesCollection',
         './Cesium3DTileBatchTable',
         './Cesium3DTileFeature',
         './Cesium3DTileFeatureTable',
+        './ClippingPlanesCollection',
         './getAttributeOrUniformBySemantic',
         './Model'
     ], function(
@@ -36,10 +36,10 @@ define([
         RequestType,
         RuntimeError,
         Pass,
-        ClippingPlanesCollections,
         Cesium3DTileBatchTable,
         Cesium3DTileFeature,
         Cesium3DTileFeatureTable,
+        ClippingPlanesCollection,
         getAttributeOrUniformBySemantic,
         Model) {
     'use strict';
@@ -380,7 +380,7 @@ define([
             pickUniformMapLoaded : batchTable.getPickUniformMapCallback(),
             addBatchIdToGeneratedShaders : (batchLength > 0), // If the batch table has values in it, generated shaders will need a batchId attribute
             pickObject : pickObject,
-            clippingPlanes : new ClippingPlanesCollections({
+            clippingPlanes : new ClippingPlanesCollection({
                 enabled : false
             })
         });
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index d1b9bf411386..8200382e642c 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -172,12 +172,20 @@ define([
         }
 
         var length = this.planes.length;
+        var i;
         if (result.planes.length !== length) {
             result.planes = new Array(length);
+
+            for (i = 0; i < length; ++i) {
+                result.planes[i] = new Plane(Cartesian3.UNIT_X, 0.0);
+            }
         }
-        for (var i = 0; i < length; ++i) {
+
+        for (i = 0; i < length; ++i) {
             var plane = this.planes[i];
-            result.planes[i] = new Plane(plane.normal, plane.distance);
+            var resultPlane = result.planes[i];
+            resultPlane.normal = plane.normal;
+            resultPlane.distance = plane.distance;
         }
 
         result.enabled = this.enabled;
diff --git a/Source/Scene/Instanced3DModel3DTileContent.js b/Source/Scene/Instanced3DModel3DTileContent.js
index 2bd40a0ae6db..0e66cfc5989b 100644
--- a/Source/Scene/Instanced3DModel3DTileContent.js
+++ b/Source/Scene/Instanced3DModel3DTileContent.js
@@ -26,6 +26,7 @@ define([
         './Cesium3DTileBatchTable',
         './Cesium3DTileFeature',
         './Cesium3DTileFeatureTable',
+        './ClippingPlanesCollection',
         './ModelInstanceCollection'
     ], function(
         AttributeCompression,
@@ -55,6 +56,7 @@ define([
         Cesium3DTileBatchTable,
         Cesium3DTileFeature,
         Cesium3DTileFeatureTable,
+        ClippingPlanesCollection,
         ModelInstanceCollection) {
     'use strict';
 
@@ -443,7 +445,6 @@ define([
             var modelMatrix = instanceTransform.clone();
             instances[i] = {
                 modelMatrix : modelMatrix,
-                batchId : batchId
             };
         }
 
@@ -514,6 +515,18 @@ define([
         this._modelInstanceCollection.debugWireframe = this._tileset.debugWireframe;
         this._modelInstanceCollection.update(frameState);
 
+        // Update clipping planes
+        var tilesetClippingPlanes = this._tileset.clippingPlanes;
+        if (defined(tilesetClippingPlanes)) {
+            var model = this._modelInstanceCollection._model;
+            if (!defined(model.clippingPlanes)) {
+                model.clippingPlanes = new ClippingPlanesCollection();
+            }
+
+            tilesetClippingPlanes.clone(model.clippingPlanes);
+            model.clippingPlanes.enabled = tilesetClippingPlanes.enabled && this._tile._isClipped;
+        }
+
         // If any commands were pushed, add derived commands
         var commandEnd = frameState.commandList.length;
         if ((commandStart < commandEnd) && frameState.passes.render) {

From b83e288b743c3035c39dfca106f06db2dee66001 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 1 Dec 2017 17:15:57 -0500
Subject: [PATCH 35/37] i3dm specs

---
 .../Instanced3DModel3DTileContentSpec.js      | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/Specs/Scene/Instanced3DModel3DTileContentSpec.js b/Specs/Scene/Instanced3DModel3DTileContentSpec.js
index ab03463ac95e..4c00160251a6 100644
--- a/Specs/Scene/Instanced3DModel3DTileContentSpec.js
+++ b/Specs/Scene/Instanced3DModel3DTileContentSpec.js
@@ -4,8 +4,10 @@ defineSuite([
         'Core/Color',
         'Core/HeadingPitchRange',
         'Core/HeadingPitchRoll',
+        'Core/Plane',
         'Core/Transforms',
         'Scene/Cesium3DTileContentState',
+        'Scene/ClippingPlanesCollection',
         'Scene/TileBoundingSphere',
         'Specs/Cesium3DTilesTester',
         'Specs/createScene'
@@ -15,8 +17,10 @@ defineSuite([
         Color,
         HeadingPitchRange,
         HeadingPitchRoll,
+        Plane,
         Transforms,
         Cesium3DTileContentState,
+        ClippingPlanesCollection,
         TileBoundingSphere,
         Cesium3DTilesTester,
         createScene) {
@@ -305,6 +309,32 @@ defineSuite([
         });
     });
 
+    it('Updates model\'s clipping planes', function() {
+        return Cesium3DTilesTester.loadTileset(scene, withBatchTableUrl).then(function(tileset) {
+            var tile = tileset._root;
+            var content = tile.content;
+            var model = content._modelInstanceCollection._model;
+
+            expect(model.clippingPlanes).toBeUndefined();
+
+            tileset.clippingPlanes = new ClippingPlanesCollection({
+                planes : [
+                    new Plane(Cartesian3.UNIT_X, 0.0)
+                ]
+            });
+            content.update(tileset, scene.frameState);
+
+            expect(model.clippingPlanes).toBeDefined();
+            expect(model.clippingPlanes.planes.length).toBe(1);
+            expect(model.clippingPlanes.enabled).toBe(true);
+
+            tile._isClipped = false;
+            content.update(tileset, scene.frameState);
+
+            expect(model.clippingPlanes.enabled).toBe(false);
+        });
+    });
+
     it('destroys', function() {
         return Cesium3DTilesTester.tileDestroys(scene, withoutBatchTableUrl);
     });

From 2d855b8c79031b7c8a8c26ef73c6fda4a79bfecb Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Fri, 1 Dec 2017 22:15:22 -0500
Subject: [PATCH 36/37] Add instanced tileset to sandcastle example

---
 Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html | 8 +++++++-
 Source/Scene/ClippingPlanesCollection.js              | 2 +-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html
index 22a3fb7d3632..a790e19678dc 100644
--- a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
@@ -55,7 +55,7 @@
 });
 var scene = viewer.scene;
 
-var clipObjects = ['BIM', 'Point Cloud', 'Model'];
+var clipObjects = ['BIM', 'Point Cloud', 'Instanced', 'Model',];
 var viewModel = {
     debugBoundingVolumesEnabled : false,
     edgeStylingEnabled : true,
@@ -211,6 +211,7 @@
 // Power Plant design model provided by Bentley Systems
 var bimUrl = 'https://beta.cesium.com/api/assets/1459?access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzNjUyM2I5Yy01YmRhLTQ0MjktOGI0Zi02MDdmYzBjMmY0MjYiLCJpZCI6NDQsImFzc2V0cyI6WzE0NTldLCJpYXQiOjE0OTkyNjQ3ODF9.SW_rwY-ic0TwQBeiweXNqFyywoxnnUBtcVjeCmDGef4';
 var pointCloudUrl = 'https://beta.cesium.com/api/assets/1460?access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyMzk2YzJiOS1jZGFmLTRlZmYtYmQ4MS00NTA3NjEwMzViZTkiLCJpZCI6NDQsImFzc2V0cyI6WzE0NjBdLCJpYXQiOjE0OTkyNjQ3NTV9.oWjvN52CRQ-dk3xtvD4e8ZnOHZhoWSpJLlw115mbQJM';
+var instancedUrl = '../../../Specs/Data/Cesium3DTiles/Instanced/InstancedOrientation/';
 var modelUrl = '../../SampleData/models/CesiumAir/Cesium_Air.glb';
 
 loadTileset(bimUrl);
@@ -230,6 +231,11 @@
         tileset.readyPromise.then(function () {
             tileset.clippingPlanes.modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(tileset.boundingSphere.center);
         });
+    } else if (newValue === clipObjects[2]) {
+        loadTileset(instancedUrl);
+        tileset.readyPromise.then(function () {
+            tileset.clippingPlanes.modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(tileset.boundingSphere.center);
+        });
     } else {
         loadModel(modelUrl);
     }
diff --git a/Source/Scene/ClippingPlanesCollection.js b/Source/Scene/ClippingPlanesCollection.js
index 8200382e642c..33d21eec26d8 100644
--- a/Source/Scene/ClippingPlanesCollection.js
+++ b/Source/Scene/ClippingPlanesCollection.js
@@ -137,7 +137,7 @@ define([
         var length = planes.length;
 
         var i;
-        if (!defined(array)) {
+        if (!defined(array) || array.length !== length) {
             array = new Array(length);
 
             for (i = 0; i < length; ++i) {

From c8cd6fa82c10feb882593d6ee7dd1ddf9c35bb89 Mon Sep 17 00:00:00 2001
From: ggetz <ggetz881@gmail.com>
Date: Mon, 4 Dec 2017 09:27:11 -0500
Subject: [PATCH 37/37] Tweak sandcastle example

---
 Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html
index a790e19678dc..659492fb649f 100644
--- a/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
+++ b/Apps/Sandcastle/gallery/3D Tiles Clipping Planes.html	
@@ -55,7 +55,7 @@
 });
 var scene = viewer.scene;
 
-var clipObjects = ['BIM', 'Point Cloud', 'Instanced', 'Model',];
+var clipObjects = ['BIM', 'Point Cloud', 'Instanced', 'Model'];
 var viewModel = {
     debugBoundingVolumesEnabled : false,
     edgeStylingEnabled : true,
@@ -105,7 +105,7 @@
 var scratchPlane = new Cesium.Plane(Cesium.Cartesian3.UNIT_X, 0.0);
 function createPlaneUpdateFunction(plane, transform) {
     return function () {
-        plane.distance = Cesium.Math.lerp(plane.distance, targetY, 0.1);
+        plane.distance = targetY;
 
         var transformedPlane = Cesium.Plane.transform(plane, transform, scratchPlane);
         transformedPlane.distance = -transformedPlane.distance;