src/chrome/common/extensions/api/document_scan.idl

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // Use the <code>chrome.document_scan</code> API to discover and retrieve
   6 // images from attached paper document scanners.
   7 namespace documentScan {
   8   dictionary ScanOptions {
   9     // The MIME types that are accepted by the caller.
  10     DOMString[]? mimeTypes;
  11
  12     // The number of scanned images allowed (defaults to 1).
  13     long? maxImages;
  14   };
  15
  16   dictionary ScanResults {
  17     // The data image URLs in a form that can be passed as the "src" value to
  18     // an image tag.
  19     DOMString[] dataUrls;
  20
  21     // The MIME type of |dataUrls|.
  22     DOMString mimeType;
  23   };
  24
  25   // Callback from the <code>scan</code> method; on success
  26   // the results from the scan is returned in |results|.
  27   callback ScanCallback = void (ScanResults results);
  28
  29   interface Functions {
  30     // Performs a document scan.  On success, the PNG data will be
  31     // sent to the callback.
  32     // |options| : <code>Options</code> object containing scan parameters.
  33     // |callback| : Called with the result and data from the scan.
  34     static void scan(ScanOptions options, ScanCallback callback);
  35   };
  36 };