Load 2x resources on demand

ui/gfx/image/image_skia.h

 // Copyright (c) 2012 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.
 
 #ifndef UI_GFX_IMAGE_IMAGE_SKIA_H_
 #define UI_GFX_IMAGE_IMAGE_SKIA_H_
 
 #include <vector>
 
 #include "base/basictypes.h"
@@ skipping 19 matching lines @@
 // ImageSkia is cheap to copy and intentionally supports copy semantics.
 class UI_EXPORT ImageSkia {
  public:
   typedef std::vector<ImageSkiaRep> ImageSkiaReps;
 
   // Creates an instance with no bitmaps.
   ImageSkia();
 
   // Creates an instance that will use the |source| to get the image
   // for scale factors. |size| specifes the size of the image in DIP.
+  // ImageSkia owns |source|.
   ImageSkia(ImageSkiaSource* source, const gfx::Size& size);
 
   // Adds ref to passed in bitmap.
   // DIP width and height are set based on scale factor of 1x.
   // TODO(pkotwicz): This is temporary till conversion to gfx::ImageSkia is
   // done.
   ImageSkia(const SkBitmap& bitmap);
 
   ImageSkia(const gfx::ImageSkiaRep& image_rep);
 
@@ skipping 12 matching lines @@
 
 #if defined(OS_WIN)
   // Converts to gfx::ImageSkiaRep and SkBitmap.
   // TODO(pkotwicz): This is temporary till conversion to gfx::ImageSkia is
   // done.
   operator SkBitmap&() const { return GetBitmap(); }
 #endif
 
   ~ImageSkia();
 
+  // Returns a deep copy of this ImageSkia which has its own storage with
+  // the same ImageSkiaRep instances. This can be safely passed to and
+  // manipulated by another thread.
+  ImageSkia DeepCopy() const;
+
   // Returns true if this object is backed by the same ImageSkiaStorage as
   // |other|. Will also return true if both images are isNull().
   bool BackedBySameObjectAs(const gfx::ImageSkia& other) const;
 
   // Adds |image_rep| to the image reps contained by this object.
   void AddRepresentation(const gfx::ImageSkiaRep& image_rep);
 
   // Removes the image rep of |scale_factor| if present.
   void RemoveRepresentation(ui::ScaleFactor scale_factor);
 
   // Returns true if the object owns an image rep whose density matches
   // |scale_factor| exactly.
   bool HasRepresentation(ui::ScaleFactor scale_factor) const;
 
   // Returns the image rep whose density best matches
   // |scale_factor|.
   // Returns a null image rep if the object contains no image reps.
   const gfx::ImageSkiaRep& GetRepresentation(
       ui::ScaleFactor scale_factor) const;
 
 #if defined(OS_MACOSX)
   // Returns the image reps contained by this object.
   // If the image has a source, this method will attempt to generate
   // representations from the source for all supported scale factors.
   // Mac only for now.
   std::vector<ImageSkiaRep> GetRepresentations() const;
 #endif  // OS_MACOSX
 
+  // Make the image skia read only. Once it becomes read only,
+  // it can be safely accessed by any threads.
+  void SetReadOnly();
+  bool IsReadOnly() const;
+
   // Returns true if this is a null object.
   // TODO(pkotwicz): Merge this function into empty().
   bool isNull() const { return storage_ == NULL; }
 
   // Width and height of image in DIP coordinate system.
   int width() const;
   int height() const;
   gfx::Size size() const;
 
   // Returns pointer to 1x bitmap contained by this object. If there is no 1x
   // bitmap, the bitmap whose scale factor is closest to 1x is returned.
   // This function should only be used in unittests and on platforms which do
   // not support scale factors other than 1x.
   // TODO(pkotwicz): Return null SkBitmap when the object has no 1x bitmap.
   const SkBitmap* bitmap() const { return &GetBitmap(); }
 
   // Returns a vector with the image reps contained in this object.
   // There is no guarantee that this will return all images rep for
   // supported scale factors.
   // TODO(oshima): Update all use of this API and make this to fail
   // when source is used.
   std::vector<gfx::ImageSkiaRep> image_reps() const;
 
+  // Delete the ImageSkiaSource if any. It will make GetRepresentation
+  // thread safe because it will no longer update the storage.
+  void DeleteSource();
+
+  // When the source is available, generates all ImageReps for
+  // supported scale factors. This method is defined as const as
+  // the state change in the storage is agnostic to the caller.
+  void EnsureRepsForSupportedScaleFactors() const;
+
  private:
   // Initialize ImageSkiaStorage with passed in parameters.
   // If the image rep's bitmap is empty, ImageStorage is set to NULL.
   void Init(const gfx::ImageSkiaRep& image_rep);
 
   SkBitmap& GetBitmap() const;
 
   // A refptr so that ImageRepSkia can be copied cheaply.
   scoped_refptr<internal::ImageSkiaStorage> storage_;
 };
 
 }  // namespace gfx
 
 #endif  // UI_GFX_IMAGE_IMAGE_SKIA_H_