Notifications API support for images with multiple scale factors.

chrome/common/extensions/api/notifications.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.
 
 // Use the <code>chrome.notifications</code> API to create rich notifications
 // using templates and show these notifications to users in the system tray.
 namespace notifications {
   [noinline_doc] enum TemplateType {
     // icon, title, message, expandedMessage, up to two buttons
     basic,
@@ skipping 18 matching lines @@
   };
 
   dictionary NotificationItem {
     // Title of one item of a list notification.
     DOMString title;
 
     // Additional details about this item.
     DOMString message;
   };
 
-  [nodoc] dictionary NotificationBitmap {
-    long width;
-    long height;
-    ArrayBuffer? data;
+  // Contains an array of RGBA bitmap data, 32 bits per channel.  |data|
+  // should therefore have a length equal to 4 * width * height.
+  dictionary BitmapData {
+    ArrayBuffer data;
+    double width;
+    double height;
+  };
+
+  dictionary ImageRepresentation {
+    // The pixel ratio for which this bitmap is intended.
+    double density;
+
+    // A URL from which the image will be downloaded.
+    (DOMString or BitmapData) src;
   };
 
   dictionary NotificationButton {
     DOMString title;
+
+    // The icon used with the button.  Useful for giving users immediate context,
+    // but title must provide all necessary information about the action to be
+    // taken. Either an icon URL or a spec must be provided.
     DOMString? iconUrl;
-    [nodoc] NotificationBitmap? iconBitmap;
+    ImageRepresentation[]? iconReps;
   };
 
   dictionary NotificationOptions {
     // Which type of notification to display.
     // <em>Required for $(ref:notifications.create)</em> method.
     TemplateType? type;
 
-    // Sender's avatar, app icon, or a thumbnail for image notifications.
-    // <em>Required for $(ref:notifications.create)</em> method.
+    // Sender's avatar, app icon, or a thumbnail for image notifications. This
+    // image in the notification is most useful when it provides specific
+    // context, such as an avatar, or contact photo.
+    // Either an iconUrl or an ImageRepresentation must be provided.
     DOMString? iconUrl;
-    [nodoc] NotificationBitmap? iconBitmap;
+    ImageRepresentation[]? iconReps;
 
     // Title of the notification (e.g. sender name for email).
     // <em>Required for $(ref:notifications.create)</em> method.
     DOMString? title;
 
     // Main notification content.
     // <em>Required for $(ref:notifications.create)</em> method.
     DOMString? message;
 
     // Alternate notification content with a lower-weight font.
     DOMString? contextMessage;
 
     // Priority ranges from -2 to 2. -2 is lowest priority. 2 is highest. Zero
     // is default.
     long? priority;
 
     // A timestamp associated with the notification, in milliseconds past the
     // epoch (e.g. <code>Date.now() + n</code>).
     double? eventTime;
 
     // Text and icons for up to two notification action buttons.
     NotificationButton[]? buttons;
 
-    // Secondary notification content.
-    [nodoc] DOMString? expandedMessage;
+    // Secondary notification content.  This field is deprecated and unused.
+    [deprecated] DOMString? expandedMessage;
 
-    // Image thumbnail for image-type notifications.
+    // Image thumbnail for image-type notifications.  This field will be rendered
+    // in a very prominent position at a larger size than the icon. Either an
+    // imageUrl or an imageSpec must be provided.
     DOMString? imageUrl;
-    [nodoc] NotificationBitmap? imageBitmap;
+    ImageRepresentation[]? imageReps;
 
     // Items for multi-item notifications.
     NotificationItem[]? items;
 
     // Current progress ranges from 0 to 100.
     long? progress;
 
     // Whether to show UI indicating that the app will visibly respond to
     // clicks on the body of a notification.
     boolean? isClickable;
@@ skipping 58 matching lines @@
     static void onButtonClicked(DOMString notificationId, long buttonIndex);
 
     // The user changes the permission level.
     static void onPermissionLevelChanged(PermissionLevel level);
 
     // The user clicked on a link for the app's notification settings.
     static void onShowSettings();
   };
 
 };