Making ShadowMap constructor private

Apps/Sandcastle/gallery/development/Multiple Shadows.html

@@ -64,7 +64,7 @@
             camera.lookAtTransform(Cesium.Matrix4.IDENTITY);
 
             var shadowMap = new Cesium.ShadowMap({
-                context : scene.context,
+                scene : scene,
                 lightCamera : pointLightCamera,
                 isPointLight : true,
                 softShadows : false

Apps/Sandcastle/gallery/development/Shadows.html

@@ -410,30 +410,30 @@
 
     if (lightSource === 'Fixed') {
         shadowOptions = {
-            context : context,
+            scene : scene,
             lightCamera : fixedLightCamera,
             cascadesEnabled : false
         };
     } else if (lightSource === 'Point') {
         shadowOptions = {
-            context : context,
+            scene : scene,
             lightCamera : pointLightCamera,
             isPointLight : true
         };
     } else if (lightSource === 'Spot') {
         shadowOptions = {
-            context : context,
+            scene : scene,
             lightCamera : spotLightCamera,
             cascadesEnabled : false
         };
     } else if (cascades === 4) {
         shadowOptions = {
-            context : context,
+            scene : scene,
             lightCamera : lightCamera
         };
     } else if (cascades === 1) {
         shadowOptions = {
-            context : context,
+            scene : scene,
             lightCamera : lightCamera,
             numberOfCascades : 1
         };

CHANGES.md

@@ -9,6 +9,7 @@ Change Log
     * Removed separate `heading`, `pitch`, `roll` parameters from `Transform.headingPitchRollToFixedFrame` and `Transform.headingPitchRollQuaternion`. Pass a `headingPitchRoll` object instead. [#4843](https://github.com/AnalyticalGraphicsInc/cesium/pull/4843)
     * The property `binornmal` has been renamed to `bitangent` for `Geometry` and `VertexFormat`. [#4856](https://github.com/AnalyticalGraphicsInc/cesium/pull/4856)
     * A handful of `CesiumInspectorViewModel` properties were removed or changed from variables to functions.  See [#4857](https://github.com/AnalyticalGraphicsInc/cesium/pull/4857)
+    * The `ShadowMap` constructor has been made private. See [#4010](https://github.com/AnalyticalGraphicsInc/cesium/issues/4010)
 * Added support for custom geocoder services and autocomplete [#4723](https://github.com/AnalyticalGraphicsInc/cesium/pull/4723).
     * Added [Custom Geocoder Sandcastle example](http://localhost:8080/Apps/Sandcastle/index.html?src=Custom%20Geocoder.html)
 * Added `GeocoderService`, an interface for geocoders.

Source/Scene/Scene.js

@@ -563,7 +563,7 @@ define([
          * @type {ShadowMap}
          */
         this.shadowMap = new ShadowMap({
-            context : context,
+            scene : this,
             lightCamera : this._sunCamera,
             enabled : defaultValue(options.shadows, false)
         });

Source/Scene/ShadowMap.js

@@ -107,37 +107,28 @@ define([
 
     /**
      * Creates a shadow map from the provided light camera.
+     * <p>
+     *     Use {@link Viewer#shadowMap}
+     * </p>
      *
      * The normalOffset bias pushes the shadows forward slightly, and may be disabled
      * for applications that require ultra precise shadows.
      *
      * @alias ShadowMap
-     * @constructor
-     *
-     * @param {Object} options An object containing the following properties:
-     * @param {Context} options.context The context in which to create the shadow map.
-     * @param {Camera} options.lightCamera A camera representing the light source.
-     * @param {Boolean} [options.enabled=true] Whether the shadow map is enabled.
-     * @param {Boolean} [options.isPointLight=false] Whether the light source is a point light. Point light shadows do not use cascades.
-     * @param {Boolean} [options.pointLightRadius=100.0] Radius of the point light.
-     * @param {Boolean} [options.cascadesEnabled=true] Use multiple shadow maps to cover different partitions of the view frustum.
-     * @param {Number} [options.numberOfCascades=4] The number of cascades to use for the shadow map. Supported values are one and four.
-     * @param {Number} [options.maximumDistance=5000.0] The maximum distance used for generating cascaded shadows. Lower values improve shadow quality.
-     * @param {Number} [options.size=2048] The width and height, in pixels, of each shadow map.
-     * @param {Boolean} [options.softShadows=false] Whether percentage-closer-filtering is enabled for producing softer shadows.
-     * @param {Number} [options.darkness=0.3] The shadow darkness.
+     * @internalConstructor
      *
      * @exception {DeveloperError} Only one or four cascades are supported.
      *
      * @demo {@link http://cesiumjs.org/Cesium/Apps/Sandcastle/index.html?src=Shadows.html|Cesium Sandcastle Shadows Demo}
+     *
      */
     function ShadowMap(options) {
         options = defaultValue(options, defaultValue.EMPTY_OBJECT);
-        var context = options.context;
+        var scene = options.scene;
 
         //>>includeStart('debug', pragmas.debug);
-        if (!defined(context)) {
-            throw new DeveloperError('context is required.');
+        if (!defined(scene)) {
+            throw new DeveloperError('scene is required.');
         }
         if (!defined(options.lightCamera)) {
             throw new DeveloperError('lightCamera is required.');
@@ -149,6 +140,8 @@ define([
 
         this._enabled = defaultValue(options.enabled, true);
         this._softShadows = defaultValue(options.softShadows, false);
+        this._normalOffset = defaultValue(options.normalOffset, true);
+        this._normalOffsetScale = defaultValue(options.normalOffsetScale, 0.1);
         this.dirty = true;
 
         /**
@@ -183,6 +176,7 @@ define([
         // In IE11 and Edge polygon offset is not functional.
         // TODO : Also disabled for instances of Firefox and Chrome running ANGLE that do not support depth textures.
         // Re-enable once https://github.com/AnalyticalGraphicsInc/cesium/issues/4560 is resolved.
+        var context = scene._context;
         var polygonOffsetSupported = true;
         if (FeatureDetection.isInternetExplorer() || FeatureDetection.isEdge() || ((FeatureDetection.isChrome() || FeatureDetection.isFirefox()) && FeatureDetection.isWindows() && !context.depthTexture)) {
             polygonOffsetSupported = false;
@@ -193,8 +187,8 @@ define([
             polygonOffset : polygonOffsetSupported,
             polygonOffsetFactor : 1.1,
             polygonOffsetUnits : 4.0,
-            normalOffset : true,
-            normalOffsetScale : 0.5,
+            normalOffset : this._normalOffset,
+            normalOffsetScale : this._normalOffsetScale,
             normalShading : true,
             normalShadingSmooth : 0.3,
             depthBias : 0.0001
@@ -204,8 +198,8 @@ define([
             polygonOffset : polygonOffsetSupported,
             polygonOffsetFactor : 1.1,
             polygonOffsetUnits : 4.0,
-            normalOffset : true,
-            normalOffsetScale : 0.1,
+            normalOffset : this._normalOffset,
+            normalOffsetScale : this._normalOffsetScale,
             normalShading : true,
             normalShadingSmooth : 0.05,
             depthBias : 0.00002
@@ -215,8 +209,8 @@ define([
             polygonOffset : false,
             polygonOffsetFactor : 1.1,
             polygonOffsetUnits : 4.0,
-            normalOffset : false,
-            normalOffsetScale : 0.0,
+            normalOffset : this._normalOffset,
+            normalOffsetScale : this._normalOffsetScale,
             normalShading : true,
             normalShadingSmooth : 0.1,
             depthBias : 0.0005
@@ -384,6 +378,40 @@ define([
             }
         },
 
+        /**
+         * Determines if a normal bias will be applied to shadows.
+         *
+         * @memberof ShadowMap.prototype
+         * @type {Boolean}
+         * @default true
+         */
+        normalOffset : {
+            get : function() {
+                return this._normalOffset;
+            },
+            set : function(value) {
+                this.dirty = this._normalOffset !== value;
+                this._normalOffset = value;
+            }
+        },
+
+        /**
+         * Amount to offset shadows by along the normal. Addresses shadow acne problems.
+         *
+         * @memberof ShadowMap.prototype
+         * @type {Number}
+         * @default 0.1
+         */
+        normalOffsetScale : {
+            get : function() {
+                return this._normalOffsetScale;
+            },
+            set : function(value) {
+                this.dirty = this._normalOffsetScale !== value;
+                this._normalOffsetScale = value;
+            }
+        },
+
         /**
          * Determines if soft shadows are enabled. Uses pcf filtering which requires more texture reads and may hurt performance.
          *

Specs/Scene/ShadowMapSpec.js

@@ -275,7 +275,7 @@ defineSuite([
         lightCamera.lookAt(center, new Cartesian3(0.0, 0.0, 1.0));
 
         scene.shadowMap = new ShadowMap({
-            context : scene.context,
+            scene : scene,
             lightCamera : lightCamera
         });
     }
@@ -289,7 +289,7 @@ defineSuite([
         lightCamera.lookAt(center, new Cartesian3(0.0, 0.0, 1.0));
 
         scene.shadowMap = new ShadowMap({
-            context : scene.context,
+            scene : scene,
             lightCamera : lightCamera,
             numberOfCascades : 1
         });
@@ -313,7 +313,7 @@ defineSuite([
         lightCamera.lookAt(center, new Cartesian3(0.0, 0.0, 20.0));
 
         scene.shadowMap = new ShadowMap({
-            context : scene.context,
+            scene : scene,
             lightCamera : lightCamera,
             cascadesEnabled : false
         });
@@ -331,7 +331,7 @@ defineSuite([
         lightCamera.lookAt(center, new Cartesian3(0.0, 0.0, 20.0));
 
         scene.shadowMap = new ShadowMap({
-            context : scene.context,
+            scene : scene,
             lightCamera : lightCamera,
             cascadesEnabled : false
         });
@@ -345,7 +345,7 @@ defineSuite([
         lightCamera.position = center;
 
         scene.shadowMap = new ShadowMap({
-            context : scene.context,
+            scene : scene,
             lightCamera : lightCamera,
             isPointLight : true
         });
@@ -390,7 +390,7 @@ defineSuite([
 
     it('sets default shadow map properties', function() {
         scene.shadowMap = new ShadowMap({
-            context : scene.context,
+            scene : scene,
             lightCamera : new Camera(scene)
         });
 
@@ -413,15 +413,15 @@ defineSuite([
     it('throws without options.lightCamera', function() {
         expect(function() {
             scene.shadowMap = new ShadowMap({
-                context : scene.context
+                scene : scene
             });
         }).toThrowDeveloperError();
     });
 
     it('throws when options.numberOfCascades is not one or four', function() {
         expect(function() {
             scene.shadowMap = new ShadowMap({
-                context : scene.context,
+                scene : scene,
                 lightCamera : new Camera(scene),
                 numberOfCascades : 3
             });
@@ -511,7 +511,7 @@ defineSuite([
         lightCamera.lookAt(center, new Cartesian3(1.0, 0.0, 0.1));
 
         scene.shadowMap = new ShadowMap({
-            context : scene.context,
+            scene : scene,
             lightCamera : lightCamera
         });
 
@@ -564,7 +564,7 @@ defineSuite([
         lightCamera.lookAt(center, new Cartesian3(0.0, 0.0, 1.0));
 
         scene.shadowMap = new ShadowMap({
-            context : scene.context,
+            scene : scene,
             lightCamera : lightCamera
         });
 
@@ -848,7 +848,7 @@ defineSuite([
         lightCamera.lookAt(center, new Cartesian3(0.0, 0.0, 1.0));
 
         scene.shadowMap = new ShadowMap({
-            context : scene.context,
+            scene : scene,
             lightCamera : lightCamera
         });