1 files changed, 54 insertions, 0 deletions
diff --git a/mobile/android/geckoview/src/main/java/org/mozilla/geckoview/Image.java b/mobile/android/geckoview/src/main/java/org/mozilla/geckoview/Image.java
new file mode 100644
index 0000000000..34bf6b0161
--- /dev/null
+++ b/mobile/android/geckoview/src/main/java/org/mozilla/geckoview/Image.java
@@ -0,0 +1,54 @@
+/* -*- Mode: Java; c-basic-offset: 4; tab-width: 20; indent-tabs-mode: nil; -*-
+ * vim: ts=4 sw=4 expandtab:
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+package org.mozilla.geckoview;
+
+import android.graphics.Bitmap;
+import androidx.annotation.AnyThread;
+import androidx.annotation.NonNull;
+import org.mozilla.gecko.annotation.WrapForJNI;
+import org.mozilla.gecko.util.GeckoBundle;
+import org.mozilla.gecko.util.ImageResource;
+
+/** Represents an Web API image resource as used in web app manifests and media session metadata. */
+@AnyThread
+public class Image {
+  private final ImageResource.Collection mCollection;
+
+  /* package */ Image(final ImageResource.Collection collection) {
+    mCollection = collection;
+  }
+
+  /* package */ static Image fromSizeSrcBundle(final GeckoBundle bundle) {
+    return new Image(ImageResource.Collection.fromSizeSrcBundle(bundle));
+  }
+
+  /**
+   * Get the best version of this image for size <code>size</code>. Embedders are encouraged to
+   * cache the result of this method keyed with this instance.
+   *
+   * @param size pixel size at which this image will be displayed at.
+   * @return A {@link GeckoResult} that resolves to the bitmap when ready. Will resolve
+   *     exceptionally to {@link ImageProcessingException} if the image cannot be processed.
+   */
+  @NonNull
+  public GeckoResult<Bitmap> getBitmap(final int size) {
+    return mCollection.getBitmap(size);
+  }
+
+  /** Thrown whenever an image cannot be processed by {@link #getBitmap} */
+  @WrapForJNI
+  public static class ImageProcessingException extends RuntimeException {
+    /**
+     * Build an instance of this class.
+     *
+     * @param message description of the error.
+     */
+    public ImageProcessingException(final String message) {
+      super(message);
+    }
+  }
+}