Add ability to change display settings to chrome.systemInfo.display

chrome/common/extensions/api/system_info_display.idl

 // Copyright (c) 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.
 
 namespace systemInfo.display {
 
   dictionary Bounds {
     // The x-coordinate of the upper-left corner.
     long left;
 
@@ skipping 60 matching lines @@
     // The display's insets within its screen's bounds.
     // Currently exposed only on ChromeOS. Will be set to empty insets on
     // other platforms.
     Insets overscan;
 
     // The usable work area of the display within the display bounds. The work
     // area excludes areas of the display reserved for OS, for example taskbar
     // and launcher.
     Bounds workArea;
   };
+
+  dictionary SetDisplayUnitInfoParams {

[asargent_no_longer_on_chrome, 2013/06/14 17:02:59]

nit: let's rename this to something like "DisplayProperties"

[tbarzic, 2013/06/14 17:40:09]

Done.

+    // If set and not empty, starts mirroring between this and the display with
+    // the provided id (the system will determine which of the displays is
+    // actually mirrored).
+    // If set and not empty, stops mirroring between this and the display with
+    // the specified id (if mirroring is in progress).
+    // If set, no other parameter 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
+    // that overscan values may not be negative or larger than a half of the
+    // screen's size. Overscan cannot be changed on the internal monitor.
+    // It's applied after <code>isPrimary</code> parameter.
+    Insets? overscan;
+ 
+    // If set, updates the display's rotation.
+    // Legal values are [0, 90, 180, 270]. The rotation is set clockwise,
+    // relative to the display's vertical position.
+    // It's applied after <code>overscan</code> paramter.
+    long? rotation;
+ 
+    // If set, updates the display's logical bounds origin along x-axis. Applied
+    // together with <code>boundsOriginY</code>, if <code>boundsOriginY</code>
+    // is set. Note that, when updating the display origin, some constraints
+    // will be applied, so the final bounds origin may be different than the one
+    // set. The final bounds can be retrieved using $ref:getDisplayInfo.
+    // The bounds origin is applied after <code>rotation</code>.
+    // The bounds origin cannot be changed on the primary display. Note that is
+    // also invalid to set bounds origin values if <code>isPrimary</code> is
+    // also set (as <code>isPrimary</code> parameter is applied first).
+    long? boundsOriginX;
+ 
+    // If set, updates the display's logical bounds origin along y-axis.
+    // See documentation for <code>boundsOriginX</code> parameter.
+    long? boundsOriginY;
+  };
   
   callback DisplayInfoCallback = void (DisplayUnitInfo[] displayInfo);
+  callback SetDisplayUnitInfoCallback = void();
 
   interface Functions {
     // Get the information of all attached display devices.
     static void getDisplayInfo(DisplayInfoCallback callback);
+
+    // Updates the properties for the display specified by |id|, according to
+    // the parameters provided in |info|. On failure, $ref:runtime.lastError
+    // will be set.
+    // |id|: The display's unique identifier.
+    // |info|: The information about display parameters that should be changed,
+    //     including their new values.
+    // |callback|: Empty function called when the function finishes. To find out
+    //     whether the function succeeded, $ref:runtime.lastError should be
+    //     queried. 
+    static void setDisplayProperties(
+        DOMString id,
+        SetDisplayUnitInfoParams info,
+        optional SetDisplayUnitInfoCallback callback);
   };
   
   interface Events {
     // Fired when anything changes to the display configuration.
     static void onDisplayChanged();
   };
 };