- Plumbs through native touch calibration from MD settings to display manager via the system dis…

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 189 matching lines @@
     long? boundsOriginY;
 
     // If set, updates the display mode to the mode matching this value.
     DisplayMode? displayMode;
   };
 
   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);
 
     // Get the layout info for all displays.
     // NOTE: This is only available to Chrome OS Kiosk apps and Web UI.
     static void getDisplayLayout(DisplayLayoutCallback callback);
 
     // Updates the properties for the display specified by |id|, according to
@@ skipping 49 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 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.
     // |id|: The display's unique identifier.
-    static void touchCalibrationStart(DOMString id);
+    // |callback|: Optional callback to inform the caller that the touch
+    //      calibration has ended. The argument of the callback informs if the
+    //      calibration was a success or not.
+    static void showNativeTouchCalibration(
+        DOMString id, optional NativeTouchCalibrationCallback 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.
+    // |id|: The display's unique identifier.
+    static void startCustomTouchCalibration(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.
+    // 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.
     // |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 ignored.
-    static void touchCalibrationSet(DOMString id,
-                                    TouchCalibrationPairQuad pairs,
-                                    Bounds bounds);
+    static void completeCustomTouchCalibration(TouchCalibrationPairQuad pairs,
+                                               Bounds 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.
     // |id|: The display's unique identifier.
-    static void touchCalibrationReset(DOMString id);
+    static void clearTouchCalibration(DOMString id);
   };
 
   interface Events {
     // Fired when anything changes to the display configuration.
     static void onDisplayChanged();
   };
 };