Implement a JavaScript API for document scanning

chrome/common/extensions/api/document_scan.idl

Index: chrome/common/extensions/api/document_scan.idl
diff --git a/chrome/common/extensions/api/document_scan.idl b/chrome/common/extensions/api/document_scan.idl
new file mode 100644
index 0000000000000000000000000000000000000000..20d78f73dfbc5a036a3798868df2f508d0a7960a
--- /dev/null
+++ b/chrome/common/extensions/api/document_scan.idl
@@ -0,0 +1,29 @@
+// Copyright 2014 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>chrome.document_scan</code> API to discover and retrieve
+// images from attached paper document scanners.
+namespace documentScan {
+  dictionary ScanOptions {
+    // The MIME types that are accepted by the caller.
+    DOMString[]? accepted_mime_types;
+
+    // The number of scanned images allowed (defaults to 1).
+    long? scannedImageCount;
+  };
+
+  // Callback from the <code>scan</code> method; on success (result == true)
+  // images from the scan is returned in the |data_urls| strings which can be
+  // passed as the "src" value to an image tag.  The image data is of the
+  // type |mime_type|.
+  callback ScanCallback = void (DOMString[] data_urls, DOMString mime_type);
+
+  interface Functions {
+    // Performs a document scan.  On success, the PNG data will be
+    // sent to the callback.
+    // |options| : <code>ScanOptions</code> object containing scan parameters.
+    // |callback| : Called with the result and data from the scan.
+    static void scan(ScanOptions options, ScanCallback callback);
+  };
+};