Adds touch calibration methods to system_display.idl 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 15 matching lines @@
     // The y-axis distance from the top bound.
     long top;
 
     // The x-axis distance from the right bound.
     long right;
 
     // The y-axis distance from the bottom bound.
     long bottom;
   };
 
+  dictionary Point {
+    // The x-coordinate of the point.
+    long x;
+
+    // The y-coordinate of the point.
+    long y;
+  };
+
+  dictionary TouchCalibrationPair {
+    // The coordinates of the display point.
+    Point displayPoint;
+
+    // The coordinates of the touch point corresponding to the display point.
+    Point touchPoint;
+  };
+
+  dictionary TouchCalibrationPairQuad {
+    // First pair of touch and display point required for touch calibration.
+    TouchCalibrationPair pair1;
+
+    // Second pair of touch and display point required for touch calibration.
+    TouchCalibrationPair pair2;
+
+    // Third pair of touch and display point required for touch calibration.
+    TouchCalibrationPair pair3;
+
+    // Fourth pair of touch and display point required for touch calibration.
+    TouchCalibrationPair pair4;
+  };
+
   dictionary DisplayMode {
     // The display mode width in device independent (user visible) pixels.
     long width;
 
     // The display mode height in device independent (user visible) pixels.
     long height;
 
     // The display mode width in native pixels.
     long widthInNativePixels;
 
@@ skipping 189 matching lines @@
 
     // Resets the overscan insets for a display to the last saved value (i.e
     // before Start was called).
     // |id|: The display's unique identifier.
     static void overscanCalibrationReset(DOMString id);
 
     // Complete overscan adjustments for a display  by saving the current values
     // and hiding the overlay.
     // |id|: The display's unique identifier.
     static void overscanCalibrationComplete(DOMString id);
+
+    // Starts touch calibration for a display. This will show an overlay on the
+    // screen and initialize the UX for touch calibration. If touch calibration
+    // for display |id| is in progress this will do nothing.

[stevenjb, 2016/11/29 18:53:29]

We should throw an error of calibration is in progress (or can not be started).

[malaykeshav, 2016/11/30 00:53:16]

Done

+    // |id|: The display's unique identifier.
+    static void touchCalibrationStart(DOMString id);
+
+    // Sets the touch calibration pairs for a display. These |pairs| would be
+    // used to calibrate the touch screen for display |id|. If touch calibration
+    // for display |id| is in progress this will do nothing.
+    // |id|: The display's unique identifier.
+    // |pairs|: The pairs of point used to calibrate the display.
+    // |bounds|: Bounds of the display when the touch calibration was performed.
+    //     |bounds.left| and |bounds.top| values are no-op.

[stevenjb, 2016/11/29 18:53:29]

s/no-op/ignored/ ?

[malaykeshav, 2016/11/30 00:53:16]

Done

+    static void touchCalibrationSet(DOMString id,
+                                    TouchCalibrationPairQuad pairs,
+                                    Bounds bounds);
+
+    // Resets the touch calibration for the display and removes the saved
+    // calibration data.
+    // |id|: The display's unique identifier.
+    static void touchCalibrationReset(DOMString id);
   };
 
   interface Events {
     // Fired when anything changes to the display configuration.
     static void onDisplayChanged();
   };
 };