// 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. #include "ui/gfx/image/image_skia.h" #include <algorithm> #include <cmath> #include <limits> #include "base/logging.h" #include "base/memory/scoped_ptr.h" #include "base/threading/non_thread_safe.h" #include "ui/gfx/image/image_skia_operations.h" #include "ui/gfx/image/image_skia_source.h" #include "ui/gfx/rect.h" #include "ui/gfx/size.h" #include "ui/gfx/skia_util.h" namespace gfx { namespace { // static gfx::ImageSkiaRep& NullImageRep() { CR_DEFINE_STATIC_LOCAL(ImageSkiaRep, null_image_rep, ()); return null_image_rep; } std::vector<float>* g_supported_scales = NULL; } // namespace namespace internal { namespace { class Matcher { public: explicit Matcher(float scale) : scale_(scale) { } bool operator()(const ImageSkiaRep& rep) const { return rep.scale() == scale_; } private: float scale_; }; } // namespace // A helper class such that ImageSkia can be cheaply copied. ImageSkia holds a // refptr instance of ImageSkiaStorage, which in turn holds all of ImageSkia's // information. Having both |base::RefCountedThreadSafe| and // |base::NonThreadSafe| may sounds strange but necessary to turn // the 'thread-non-safe modifiable ImageSkiaStorage' into // the 'thread-safe read-only ImageSkiaStorage'. class ImageSkiaStorage : public base::RefCountedThreadSafe<ImageSkiaStorage>, public base::NonThreadSafe { public: ImageSkiaStorage(ImageSkiaSource* source, const gfx::Size& size) : source_(source), size_(size), read_only_(false) { } ImageSkiaStorage(ImageSkiaSource* source, float scale) : source_(source), read_only_(false) { ImageSkia::ImageSkiaReps::iterator it = FindRepresentation(scale, true); if (it == image_reps_.end() || it->is_null()) source_.reset(); else size_.SetSize(it->GetWidth(), it->GetHeight()); } bool has_source() const { return source_.get() != NULL; } std::vector<gfx::ImageSkiaRep>& image_reps() { return image_reps_; } const gfx::Size& size() const { return size_; } bool read_only() const { return read_only_; } void DeleteSource() { source_.reset(); } void SetReadOnly() { read_only_ = true; } void DetachFromThread() { base::NonThreadSafe::DetachFromThread(); } // Checks if the current thread can safely modify the storage. bool CanModify() const { return !read_only_ && CalledOnValidThread(); } // Checks if the current thread can safely read the storage. bool CanRead() const { return (read_only_ && !source_.get()) || CalledOnValidThread(); } // Returns the iterator of the image rep whose density best matches // |scale|. If the image for the |scale| doesn't exist in the storage and // |storage| is set, it fetches new image by calling // |ImageSkiaSource::GetImageForScale|. If the source returns the image with // different scale (if the image doesn't exist in resource, for example), it // will fallback to closest image rep. std::vector<ImageSkiaRep>::iterator FindRepresentation( float scale, bool fetch_new_image) const { ImageSkiaStorage* non_const = const_cast<ImageSkiaStorage*>(this); ImageSkia::ImageSkiaReps::iterator closest_iter = non_const->image_reps().end(); ImageSkia::ImageSkiaReps::iterator exact_iter = non_const->image_reps().end(); float smallest_diff = std::numeric_limits<float>::max(); for (ImageSkia::ImageSkiaReps::iterator it = non_const->image_reps().begin(); it < image_reps_.end(); ++it) { if (it->scale() == scale) { // found exact match fetch_new_image = false; if (it->is_null()) continue; exact_iter = it; break; } float diff = std::abs(it->scale() - scale); if (diff < smallest_diff && !it->is_null()) { closest_iter = it; smallest_diff = diff; } } if (fetch_new_image && source_.get()) { DCHECK(CalledOnValidThread()) << "An ImageSkia with the source must be accessed by the same thread."; ImageSkiaRep image = source_->GetImageForScale(scale); // If the source returned the new image, store it. if (!image.is_null() && std::find_if(image_reps_.begin(), image_reps_.end(), Matcher(image.scale())) == image_reps_.end()) { non_const->image_reps().push_back(image); } // If the result image's scale isn't same as the expected scale, create // null ImageSkiaRep with the |scale| so that the next lookup will // fallback to the closest scale. if (image.is_null() || image.scale() != scale) { non_const->image_reps().push_back(ImageSkiaRep(SkBitmap(), scale)); } // image_reps_ must have the exact much now, so find again. return FindRepresentation(scale, false); } return exact_iter != image_reps_.end() ? exact_iter : closest_iter; } private: virtual ~ImageSkiaStorage() { // We only care if the storage is modified by the same thread. // Don't blow up even if someone else deleted the ImageSkia. DetachFromThread(); } // Vector of bitmaps and their associated scale. std::vector<gfx::ImageSkiaRep> image_reps_; scoped_ptr<ImageSkiaSource> source_; // Size of the image in DIP. gfx::Size size_; bool read_only_; friend class base::RefCountedThreadSafe<ImageSkiaStorage>; }; } // internal ImageSkia::ImageSkia() : storage_(NULL) { } ImageSkia::ImageSkia(ImageSkiaSource* source, const gfx::Size& size) : storage_(new internal::ImageSkiaStorage(source, size)) { DCHECK(source); // No other thread has reference to this, so it's safe to detach the thread. DetachStorageFromThread(); } ImageSkia::ImageSkia(ImageSkiaSource* source, float scale) : storage_(new internal::ImageSkiaStorage(source, scale)) { DCHECK(source); if (!storage_->has_source()) storage_ = NULL; // No other thread has reference to this, so it's safe to detach the thread. DetachStorageFromThread(); } ImageSkia::ImageSkia(const ImageSkiaRep& image_rep) { Init(image_rep); // No other thread has reference to this, so it's safe to detach the thread. DetachStorageFromThread(); } ImageSkia::ImageSkia(const ImageSkia& other) : storage_(other.storage_) { } ImageSkia& ImageSkia::operator=(const ImageSkia& other) { storage_ = other.storage_; return *this; } ImageSkia::~ImageSkia() { } // static void ImageSkia::SetSupportedScales(const std::vector<float>& supported_scales) { if (g_supported_scales != NULL) delete g_supported_scales; g_supported_scales = new std::vector<float>(supported_scales); std::sort(g_supported_scales->begin(), g_supported_scales->end()); } // static const std::vector<float>& ImageSkia::GetSupportedScales() { DCHECK(g_supported_scales != NULL); return *g_supported_scales; } // static float ImageSkia::GetMaxSupportedScale() { return g_supported_scales->back(); } // static ImageSkia ImageSkia::CreateFrom1xBitmap(const SkBitmap& bitmap) { return ImageSkia(ImageSkiaRep(bitmap, 1.0f)); } scoped_ptr<ImageSkia> ImageSkia::DeepCopy() const { ImageSkia* copy = new ImageSkia; if (isNull()) return scoped_ptr<ImageSkia>(copy); CHECK(CanRead()); std::vector<gfx::ImageSkiaRep>& reps = storage_->image_reps(); for (std::vector<gfx::ImageSkiaRep>::iterator iter = reps.begin(); iter != reps.end(); ++iter) { copy->AddRepresentation(*iter); } // The copy has its own storage. Detach the copy from the current // thread so that other thread can use this. if (!copy->isNull()) copy->storage_->DetachFromThread(); return scoped_ptr<ImageSkia>(copy); } bool ImageSkia::BackedBySameObjectAs(const gfx::ImageSkia& other) const { return storage_.get() == other.storage_.get(); } void ImageSkia::AddRepresentation(const ImageSkiaRep& image_rep) { DCHECK(!image_rep.is_null()); // TODO(oshima): This method should be called |SetRepresentation| // and replace the existing rep if there is already one with the // same scale so that we can guarantee that a ImageSkia instance contains only // one image rep per scale. This is not possible now as ImageLoader currently // stores need this feature, but this needs to be fixed. if (isNull()) { Init(image_rep); } else { CHECK(CanModify()); storage_->image_reps().push_back(image_rep); } } void ImageSkia::RemoveRepresentation(float scale) { if (isNull()) return; CHECK(CanModify()); ImageSkiaReps& image_reps = storage_->image_reps(); ImageSkiaReps::iterator it = storage_->FindRepresentation(scale, false); if (it != image_reps.end() && it->scale() == scale) image_reps.erase(it); } bool ImageSkia::HasRepresentation(float scale) const { if (isNull()) return false; CHECK(CanRead()); ImageSkiaReps::iterator it = storage_->FindRepresentation(scale, false); return (it != storage_->image_reps().end() && it->scale() == scale); } const ImageSkiaRep& ImageSkia::GetRepresentation(float scale) const { if (isNull()) return NullImageRep(); CHECK(CanRead()); ImageSkiaReps::iterator it = storage_->FindRepresentation(scale, true); if (it == storage_->image_reps().end()) return NullImageRep(); return *it; } void ImageSkia::SetReadOnly() { CHECK(storage_.get()); storage_->SetReadOnly(); DetachStorageFromThread(); } void ImageSkia::MakeThreadSafe() { CHECK(storage_.get()); EnsureRepsForSupportedScales(); // Delete source as we no longer needs it. if (storage_.get()) storage_->DeleteSource(); storage_->SetReadOnly(); CHECK(IsThreadSafe()); } bool ImageSkia::IsThreadSafe() const { return !storage_.get() || (storage_->read_only() && !storage_->has_source()); } int ImageSkia::width() const { return isNull() ? 0 : storage_->size().width(); } gfx::Size ImageSkia::size() const { return gfx::Size(width(), height()); } int ImageSkia::height() const { return isNull() ? 0 : storage_->size().height(); } std::vector<ImageSkiaRep> ImageSkia::image_reps() const { if (isNull()) return std::vector<ImageSkiaRep>(); CHECK(CanRead()); ImageSkiaReps internal_image_reps = storage_->image_reps(); // Create list of image reps to return, skipping null image reps which were // added for caching purposes only. ImageSkiaReps image_reps; for (ImageSkiaReps::iterator it = internal_image_reps.begin(); it != internal_image_reps.end(); ++it) { if (!it->is_null()) image_reps.push_back(*it); } return image_reps; } void ImageSkia::EnsureRepsForSupportedScales() const { DCHECK(g_supported_scales != NULL); // Don't check ReadOnly because the source may generate images // even for read only ImageSkia. Concurrent access will be protected // by |DCHECK(CalledOnValidThread())| in FindRepresentation. if (storage_.get() && storage_->has_source()) { for (std::vector<float>::const_iterator it = g_supported_scales->begin(); it != g_supported_scales->end(); ++it) storage_->FindRepresentation(*it, true); } } void ImageSkia::Init(const ImageSkiaRep& image_rep) { // TODO(pkotwicz): The image should be null whenever image rep is null. if (image_rep.sk_bitmap().empty()) { storage_ = NULL; return; } storage_ = new internal::ImageSkiaStorage( NULL, gfx::Size(image_rep.GetWidth(), image_rep.GetHeight())); storage_->image_reps().push_back(image_rep); } SkBitmap& ImageSkia::GetBitmap() const { if (isNull()) { // Callers expect a ImageSkiaRep even if it is |isNull()|. // TODO(pkotwicz): Fix this. return NullImageRep().mutable_sk_bitmap(); } // TODO(oshima): This made a few tests flaky on Windows. // Fix the root cause and re-enable this. crbug.com/145623. #if !defined(OS_WIN) CHECK(CanRead()); #endif ImageSkiaReps::iterator it = storage_->FindRepresentation(1.0f, true); if (it != storage_->image_reps().end()) return it->mutable_sk_bitmap(); return NullImageRep().mutable_sk_bitmap(); } bool ImageSkia::CanRead() const { return !storage_.get() || storage_->CanRead(); } bool ImageSkia::CanModify() const { return !storage_.get() || storage_->CanModify(); } void ImageSkia::DetachStorageFromThread() { if (storage_.get()) storage_->DetachFromThread(); } } // namespace gfx