MD Settings: Display: Add unified desktop control and modify api

third_party/closure_compiler/externs/system_display.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.
 
 // This file was generated by:
 //   ./tools/json_schema_compiler/compiler.py.
 // NOTE: The format of types has changed. 'FooType' is now
 //   'chrome.system.display.FooType'.
 // Please run the closure compiler before committing changes.
 // See https://chromium.googlesource.com/chromium/src/+/master/docs/closure_compilation.md
@@ skipping 99 matching lines @@
 chrome.system.display.DisplayLayout;
 
 /**
  * @typedef {{
  *   id: string,
  *   name: string,
  *   mirroringSourceId: string,
  *   isPrimary: boolean,
  *   isInternal: boolean,
  *   isEnabled: boolean,
+ *   isUnified: boolean,
  *   dpiX: number,
  *   dpiY: number,
  *   rotation: number,
  *   bounds: !chrome.system.display.Bounds,
  *   overscan: !chrome.system.display.Insets,
  *   workArea: !chrome.system.display.Bounds,
  *   modes: !Array<!chrome.system.display.DisplayMode>,
  *   hasTouchSupport: boolean
  * }}
  * @see https://developer.chrome.com/extensions/system.display#type-DisplayUnitInfo
@@ skipping 101 matching lines @@
 
 /**
  * Complete overscan adjustments for a display  by saving the current values and
  * hiding the overlay.
  * @param {string} id The display's unique identifier.
  * @see https://developer.chrome.com/extensions/system.display#method-overscanCalibrationComplete
  */
 chrome.system.display.overscanCalibrationComplete = function(id) {};
 
 /**
- * Starts native touch calibration for a display. This will show an overlay on
- * the screen and initialize the UX for touch calibration. If another native
- * touch calibration is already in progress this will throw an error.
+ * Displays the native touch calibration UX for the display with |id| as display
+ * id. This will show an overlay on the screen with required instructions on how
+ * to proceed. The callback will be invoked in case of successful calibraion
+ * only. If the calibration fails, this will throw an error.
  * @param {string} id The display's unique identifier.
+ * @param {function(boolean):void=} callback Optional callback to inform the
+ *     caller that the touch      calibration has ended. The argument of the

[xiyuan, 2017/04/05 21:41:45]

nit: The space between "touch" and "calibration" here and similar one in the
next line looks strange.

[stevenjb, 2017/04/06 01:56:09]

This is generated.

+ *     callback informs if the      calibration was a success or not.
  * @see https://developer.chrome.com/extensions/system.display#method-showNativeTouchCalibration
  */
-chrome.system.display.showNativeTouchCalibration = function(id) {};
+chrome.system.display.showNativeTouchCalibration = function(id, callback) {};
 
 /**
  * Starts custom touch calibration for a display. This should be called when
  * using a custom UX for collecting calibration data. If another touch
  * calibration is already in progress this will throw an error.
  * @param {string} id The display's unique identifier.
  * @see https://developer.chrome.com/extensions/system.display#method-startCustomTouchCalibration
  */
 chrome.system.display.startCustomTouchCalibration = function(id) {};
 
 /**
  * Sets the touch calibration pairs for a display. These |pairs| would be used
  * to calibrate the touch screen for display with |id| called in
  * startCustomTouchCalibration(). Always call |startCustomTouchCalibration|
  * before calling this method. If another touch calibration is already in
  * progress this will throw an error.
  * @param {!chrome.system.display.TouchCalibrationPairQuad} pairs The pairs of
  *     point used to calibrate the display.
  * @param {!chrome.system.display.Bounds} bounds Bounds of the display when the
- *     touch calibration was performed. |bounds.left| and |bounds.top|
+ *     touch calibration was performed.     |bounds.left| and |bounds.top|

[xiyuan, 2017/04/05 21:41:45]

nit: remove extra spaces ?

[stevenjb, 2017/04/06 01:56:09]

ditto.

  *     values are ignored.
  * @see https://developer.chrome.com/extensions/system.display#method-completeCustomTouchCalibration
  */
 chrome.system.display.completeCustomTouchCalibration = function(pairs, bounds) {};
 
 /**
- * Resets the touch calibration for the display and removes the saved
- * calibration data.
+ * Resets the touch calibration for the display and brings it back to its
+ * default state by clearing any touch calibration data associated with the
+ * display.
  * @param {string} id The display's unique identifier.
  * @see https://developer.chrome.com/extensions/system.display#method-clearTouchCalibration
  */
 chrome.system.display.clearTouchCalibration = function(id) {};
 
 /**
  * Fired when anything changes to the display configuration.
  * @type {!ChromeEvent}
  * @see https://developer.chrome.com/extensions/system.display#event-onDisplayChanged
  */
 chrome.system.display.onDisplayChanged;