ImageReference

public class ImageReference
extends Object implements VersionedParcelable

Reference to an image. This class encapsulates a 'content://' style URI plus metadata that allows consumers to know the image they will receive and how to handle it.

• Sizing: Producers will always provide an image "original" size which defines the image aspect ratio. When requesting these images, consumers must always specify a desired size (width and height) based on UI available space and the provided aspect ration. Producers can use this "requested" size to select the best version of the requested image, and producers can optionally resize the image to exactly match the "requested" size provided, but consumers should not assume that the received image will match such size. Instead, consumers should always assume that the image will require additional scaling.
• Content: Producers should avoid including margins around the image content.
• Format: Content URI must reference a file with MIME type 'image/png', 'image/jpeg' or 'image/bmp' (vector images are not supported).
• Color: Images can be either "tintable" or not. A "tintable" image is such that all its content is defined in its alpha channel, while its color (all other channels) can be altered without losing information (e.g.: icons). A non "tintable" images contains information in all its channels (e.g.: photos).
• Caching: Given the same image reference and the same requested size, producers must return the exact same image. This means that it should be safe for the consumer to cache an image once downloaded and use this image reference plus requested size as key, for as long as they need. If a producer needs to provide a different version of a certain image, they must provide a different image reference (e.g. producers can opt to include version information as part of the content URI).

Summary

Public methods

public boolean equals (Object o)

public Uri getContentUri (int width, 
                int height)

public int getOriginalHeight ()

public int getOriginalWidth ()

public int hashCode ()

public boolean isTintable ()

public String toString ()