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

extensions/common/api/system_display.idl

 // Copyright 2013 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.
 
 // Use the <code>system.display</code> API to query display metadata.
 namespace system.display {
 
   dictionary Bounds {
     // The x-coordinate of the upper-left corner.
     long left;
@@ skipping 111 matching lines @@
 
     // True if this is the primary display.
     boolean isPrimary;
 
     // True if this is an internal display.
     boolean isInternal;
 
     // True if this display is enabled.
     boolean isEnabled;
 
+    // True for all displays when in unified desktop mode. See documentation
+    // for $(ref:enableUnifiedDesktop).
+    boolean isUnified;
+
     // The number of pixels per inch along the x-axis.
     double dpiX;
 
     // The number of pixels per inch along the y-axis.
     double dpiY;
 
     // The display's clockwise rotation in degrees relative to the vertical
     // position.
     // Currently exposed only on ChromeOS. Will be set to 0 on other platforms.
     long rotation;
@@ skipping 14 matching lines @@
     // The list of available display modes. The current mode will have
     // isSelected=true. Only available on Chrome OS. Will be set to an empty
     // array on other platforms.
     DisplayMode[] modes;
 
     // True if this display has a touch input device associated with it.
     boolean hasTouchSupport;
   };
 
   dictionary DisplayProperties {
+    // Chrome OS only. If set to true, changes the display mode to unified
+    // desktop (see $(ref:enableUnifiedDesktop) for details). If set to false,
+    // unified desktop mode will be disabled. This is only valid for the
+    // primary display. If provided, mirroringSourceId must not be provided and
+    // other properties may not apply. This is has no effect if not provided.
+    boolean? isUnified;
+
     // Chrome OS only. If set and not empty, enables mirroring for this display.
     // Otherwise disables mirroring for this display. This value should indicate
     // the id of the source display to mirror, which must not be the same as the
     // id passed to setDisplayProperties. If set, no other property may be set.
     DOMString? mirroringSourceId;
 
     // If set to true, makes the display primary. No-op if set to false.
     boolean? isPrimary;
 
     // If set, sets the display's overscan insets to the provided values. Note
@@ skipping 20 matching lines @@
     long? boundsOriginX;
 
     // If set, updates the display's logical bounds origin along y-axis.
     // See documentation for <code>boundsOriginX</code> parameter.
     long? boundsOriginY;
 
     // If set, updates the display mode to the mode matching this value.
     DisplayMode? displayMode;
   };
 
+  dictionary GetInfoFlags {
+    // If set to true, only a single $(ref:DisplayUnitInfo) will be returned
+    // by $(ref:getInfo) when in unified desktop mode (see
+    // $(ref:enableUnifiedDesktop)). Defaults to false.
+    boolean? singleUnified;
+  };
+
   callback DisplayInfoCallback = void (DisplayUnitInfo[] displayInfo);
   callback DisplayLayoutCallback = void (DisplayLayout[] layouts);
   callback SetDisplayUnitInfoCallback = void();
   callback SetDisplayLayoutCallback = void();
   callback NativeTouchCalibrationCallback = void(boolean success);
 
   interface Functions {
-    // Get the information of all attached display devices.
-    static void getInfo(DisplayInfoCallback callback);
+    // Requests the information for all attached display devices.
+    // |flags|: Options affecting how the information is returned.
+    // |callback|: The callback to invoke with the results.
+    static void getInfo(optional GetInfoFlags flags,
+                        DisplayInfoCallback callback);
 
-    // Get the layout info for all displays.
+    // Requests the layout info for all displays.
     // NOTE: This is only available to Chrome OS Kiosk apps and Web UI.
+    // |callback|: The callback to invoke with the results.
     static void getDisplayLayout(DisplayLayoutCallback callback);
 
     // Updates the properties for the display specified by |id|, according to
     // the information provided in |info|. On failure, $(ref:runtime.lastError)
     // will be set.
     // NOTE: This is only available to Chrome OS Kiosk apps and Web UI.
     // |id|: The display's unique identifier.
     // |info|: The information about display properties that should be changed.
     //     A property will be changed only if a new value for it is specified in
     //     |info|.
@@ skipping 83 matching lines @@
     // display.
     // |id|: The display's unique identifier.
     static void clearTouchCalibration(DOMString id);
   };
 
   interface Events {
     // Fired when anything changes to the display configuration.
     static void onDisplayChanged();
   };
 };