Add menu mode plumbing for WebVR mode.

chrome/browser/resources/vr_shell/vr_shell_ui_api.js

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 var api = {};
 
 /**
  * Enumeration of scene update commands.
  * @enum {number}
  * @const
  */
 api.Command = {
   'ADD_ELEMENT': 0,
   'UPDATE_ELEMENT': 1,
   'REMOVE_ELEMENT': 2,
   'ADD_ANIMATION': 3,
   'REMOVE_ANIMATION': 4,
-  'UPDATE_BACKGROUND': 5
+  'CONFIGURE_SCENE': 5
 };
 
 /**
  * Sends one or more commands to native scene management. Commands are used
  * to add, modify or remove elements and animations. For examples of how to
  * format command parameters, refer to examples in scene.js.
  * @param {Array<Object>} commands
  */
 api.sendCommands = function(commands) {
   if (commands.length > 0) {
@@ skipping 504 matching lines @@
   /**
    * Set the animation's easing.
    * @param {api.Easing} easing
    */
   setEasing(easing) {
     this.easing = easing;
   }
 };
 
 /**
+ * Scene configuration class. Use this object to generate the payload of a
+ * CONFIGURE_SCENE command.
+ * @struct
+ */
+api.SceneConfiguration = class {
+  constructor() {
+    /** @private {!Object} */
+    this.properties = {};
+  }
+
+  getCommandPayload() {
+    return this.properties;
+  }
+
+  /**
+   * Set the background color of the scene.
+   * @param {{r: number, b: number, g: number, a: number}} color
+   */
+  setBackgroundColor(color) {
+    this.properties.backgroundColor = color;
+  }
+
+  /**
+   * Set the radius of the background-bounding sphere.
+   * @param {number} distance
+   */
+  setBackgroundDistance(distance) {
+    this.properties.backgroundDistance = distance;
+  }
+
+  /**
+   * Enable or disable rendering of the laser and reticle.
+   * @param {boolean} enabled
+   */
+  setCursorEnabled(enabled) {
+    this.properties.drawCursor = enabled;
+  }
+
+  /**
+   * Enable or disable rendering of WebVR content in the foreground. Rendering
+   * defaults to enable when on a WebVR page. This property allows rendering to
+   * be disabled, for purposes of showing an alternate UI (such as a menu).
+   * @param {boolean} enabled
+   */
+  setWebVrRenderingEnabled(enabled) {

[tiborg, 2017/03/16 19:40:23]

Maybe call it setShowWebVrPresentation or so? Since WebVR is still rendered.

[cjgrant, 2017/03/20 15:34:57]

Now that this controls rendering of WebVR vs UI and cursor, I like the original
name better.  Or, it could be setWebVrRenderingModeEnabled(), to show it has a
broader impact...  Thoughts?

[tiborg, 2017/03/20 15:56:08]

setWebVrRenderingModeEnabled() sounds good to me.

[cjgrant, 2017/03/20 17:57:22]

Done.

+    this.properties.drawWebVr = enabled;
+  }
+};
+
+/**
  * Abstract class handling webui command calls from native.  The UI must
  * subclass this and override the handlers.
  * @abstract
  */
 api.NativeCommandHandler = class {
   /**
    * @param {api.Mode} mode
    */
   onSetMode(mode) {}
 
@@ skipping 127 matching lines @@
     if ('removeTab' in dict) {
       this.onRemoveTab(dict['removeTab']);
     }
     if ('canGoBack' in dict) {
       this.onSetHistoryButtonsEnabled(dict['canGoBack'], dict['canGoForward']);
     }
 
     this.onCommandHandlerFinished()
   }
 };