15c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)/* 25c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Copyright (C) 2006 Samuel Weinig (sam.weinig@gmail.com) 35c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Copyright (C) 2004, 2005, 2006 Apple Computer, Inc. All rights reserved. 45c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 55c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * Redistribution and use in source and binary forms, with or without 65c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * modification, are permitted provided that the following conditions 75c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * are met: 85c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 1. Redistributions of source code must retain the above copyright 95c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * notice, this list of conditions and the following disclaimer. 105c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 2. Redistributions in binary form must reproduce the above copyright 115c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * notice, this list of conditions and the following disclaimer in the 125c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * documentation and/or other materials provided with the distribution. 135c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * 145c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY 155c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 165c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 175c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR 185c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 195c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 205c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 215c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY 225c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 235c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 2402772c6a72f1ee0b226341a4f4439970c29fc861Ben Murdoch * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 255c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) */ 265c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 275c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)#ifndef Image_h 285c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)#define Image_h 295c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 30a854de003a23bf3c7f95ec0f8154ada64092ff5cTorne (Richard Coles)#include "platform/PlatformExport.h" 311e202183a5dc46166763171984b285173f8585e5Torne (Richard Coles)#include "platform/geometry/IntRect.h" 32f79f16f17ddc4f842d7b7a38603e280e94be826aTorne (Richard Coles)#include "platform/graphics/Color.h" 33f79f16f17ddc4f842d7b7a38603e280e94be826aTorne (Richard Coles)#include "platform/graphics/GraphicsTypes.h" 341e202183a5dc46166763171984b285173f8585e5Torne (Richard Coles)#include "platform/graphics/ImageOrientation.h" 35a854de003a23bf3c7f95ec0f8154ada64092ff5cTorne (Richard Coles)#include "platform/graphics/skia/NativeImageSkia.h" 3693ac45cfc74041c8ae536ce58a9534d46db2024eTorne (Richard Coles)#include "third_party/skia/include/core/SkXfermode.h" 37197021e6b966cfb06891637935ef33fff06433d1Ben Murdoch#include "wtf/Assertions.h" 387757ec2eadfa2dd8ac2aeed0a4399e9b07ec38cbBen Murdoch#include "wtf/PassRefPtr.h" 397757ec2eadfa2dd8ac2aeed0a4399e9b07ec38cbBen Murdoch#include "wtf/RefCounted.h" 407757ec2eadfa2dd8ac2aeed0a4399e9b07ec38cbBen Murdoch#include "wtf/RefPtr.h" 417757ec2eadfa2dd8ac2aeed0a4399e9b07ec38cbBen Murdoch#include "wtf/RetainPtr.h" 427757ec2eadfa2dd8ac2aeed0a4399e9b07ec38cbBen Murdoch#include "wtf/text/WTFString.h" 435c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 44c1847b1379d12d0e05df27436bf19a9b1bf12deaTorne (Richard Coles)namespace blink { 455c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 465c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)class FloatPoint; 475c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)class FloatRect; 485c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)class FloatSize; 495c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)class GraphicsContext; 50bfe3590b1806e3ff18f46ee3af5d4b83078f305aTorne (Richard Coles)class Length; 515c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)class SharedBuffer; 525c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 535c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)// This class gets notified when an image creates or destroys decoded frames and when it advances animation frames. 545c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)class ImageObserver; 555c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 56a854de003a23bf3c7f95ec0f8154ada64092ff5cTorne (Richard Coles)class PLATFORM_EXPORT Image : public RefCounted<Image> { 575c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) friend class GeneratedImage; 585c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) friend class CrossfadeGeneratedImage; 59bfe3590b1806e3ff18f46ee3af5d4b83078f305aTorne (Richard Coles) friend class GradientGeneratedImage; 605c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) friend class GraphicsContext; 615c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 625c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)public: 635c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual ~Image(); 645267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 655c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) static PassRefPtr<Image> loadPlatformResource(const char* name); 6602772c6a72f1ee0b226341a4f4439970c29fc861Ben Murdoch static bool supportsType(const String&); 675c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 685c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual bool isSVGImage() const { return false; } 695c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual bool isBitmapImage() const { return false; } 70926b001d589ce2f10facb93dd4b87578ea35a855Torne (Richard Coles) virtual bool currentFrameKnownToBeOpaque() = 0; 715c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 728abfc5808a4e34d6e03867af8bc440dee641886fTorne (Richard Coles) // Derived classes should override this if they can assure that the current 738abfc5808a4e34d6e03867af8bc440dee641886fTorne (Richard Coles) // image frame contains only resources from its own security origin. 748abfc5808a4e34d6e03867af8bc440dee641886fTorne (Richard Coles) virtual bool currentFrameHasSingleSecurityOrigin() const { return false; } 755c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 765c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) static Image* nullImage(); 775c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) bool isNull() const { return size().isEmpty(); } 785c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 795c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual void setContainerSize(const IntSize&) { } 805c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual bool usesContainerSize() const { return false; } 815c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual bool hasRelativeWidth() const { return false; } 825c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual bool hasRelativeHeight() const { return false; } 835c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual void computeIntrinsicDimensions(Length& intrinsicWidth, Length& intrinsicHeight, FloatSize& intrinsicRatio); 845c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 855c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual IntSize size() const = 0; 865c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) IntRect rect() const { return IntRect(IntPoint(), size()); } 875c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) int width() const { return size().width(); } 885c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) int height() const { return size().height(); } 895c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual bool getHotSpot(IntPoint&) const { return false; } 905c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 915c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) bool setData(PassRefPtr<SharedBuffer> data, bool allDataReceived); 925c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual bool dataChanged(bool /*allDataReceived*/) { return false; } 935267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 945c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual String filenameExtension() const { return String(); } // null string if unknown 955c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 96c0e19a689c8ac22cdc96b291a8d33a5d3b0b34a4Torne (Richard Coles) virtual void destroyDecodedData(bool destroyAll) = 0; 975c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 98926b001d589ce2f10facb93dd4b87578ea35a855Torne (Richard Coles) SharedBuffer* data() { return m_encodedImageData.get(); } 995c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 1005c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) // Animation begins whenever someone draws the image, so startAnimation() is not normally called. 1015c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) // It will automatically pause once all observers no longer want to render the image anywhere. 10210f88d5669dbd969c059d61ba09fa37dd72ac559Ben Murdoch enum CatchUpAnimation { DoNotCatchUp, CatchUp }; 10310f88d5669dbd969c059d61ba09fa37dd72ac559Ben Murdoch virtual void startAnimation(CatchUpAnimation = CatchUp) { } 1045c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual void stopAnimation() {} 1055c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual void resetAnimation() {} 1065267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 107d5428f32f5d1719f774f62e19147104ca245a3abTorne (Richard Coles) // True if this image can potentially animate. 108d5428f32f5d1719f774f62e19147104ca245a3abTorne (Richard Coles) virtual bool maybeAnimated() { return false; } 109d5428f32f5d1719f774f62e19147104ca245a3abTorne (Richard Coles) 1103c9e4aeaee9f9b0a9a814da07bcb33319c7ea363Ben Murdoch // Typically the ImageResource that owns us. 1115c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) ImageObserver* imageObserver() const { return m_imageObserver; } 1125c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) void setImageObserver(ImageObserver* observer) { m_imageObserver = observer; } 1135c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 1145c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) enum TileRule { StretchTile, RoundTile, SpaceTile, RepeatTile }; 1155c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 116d5428f32f5d1719f774f62e19147104ca245a3abTorne (Richard Coles) virtual PassRefPtr<NativeImageSkia> nativeImageForCurrentFrame() { return nullptr; } 1175c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 118c1847b1379d12d0e05df27436bf19a9b1bf12deaTorne (Richard Coles) virtual PassRefPtr<Image> imageForDefaultFrame(); 119c1847b1379d12d0e05df27436bf19a9b1bf12deaTorne (Richard Coles) 120521d96ec04ace82590870fb04353ec4f82bb150fTorne (Richard Coles) virtual void drawPattern(GraphicsContext*, const FloatRect&, 121521d96ec04ace82590870fb04353ec4f82bb150fTorne (Richard Coles) const FloatSize&, const FloatPoint& phase, CompositeOperator, 122e38fbeeb576b5094e34e038ab88d9d6a5c5c2214Torne (Richard Coles) const FloatRect&, WebBlendMode = WebBlendModeNormal, const IntSize& repeatSpacing = IntSize()); 1235c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 124197021e6b966cfb06891637935ef33fff06433d1Ben Murdoch#if ENABLE(ASSERT) 1255c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual bool notSolidColor() { return true; } 1265c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)#endif 1275c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 1285c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)protected: 1295c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) Image(ImageObserver* = 0); 1305c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 1315267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) static void fillWithSolidColor(GraphicsContext*, const FloatRect& dstRect, const Color&, CompositeOperator); 13293ac45cfc74041c8ae536ce58a9534d46db2024eTorne (Richard Coles) static FloatRect adjustForNegativeSize(const FloatRect&); // A helper method for translating negative width and height values. 13393ac45cfc74041c8ae536ce58a9534d46db2024eTorne (Richard Coles) 134e38fbeeb576b5094e34e038ab88d9d6a5c5c2214Torne (Richard Coles) virtual void draw(GraphicsContext*, const FloatRect& dstRect, const FloatRect& srcRect, CompositeOperator, WebBlendMode) = 0; 135e38fbeeb576b5094e34e038ab88d9d6a5c5c2214Torne (Richard Coles) virtual void draw(GraphicsContext*, const FloatRect& dstRect, const FloatRect& srcRect, CompositeOperator, WebBlendMode, RespectImageOrientationEnum); 1365267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) void drawTiled(GraphicsContext*, const FloatRect& dstRect, const FloatPoint& srcPoint, const FloatSize& tileSize, 137e38fbeeb576b5094e34e038ab88d9d6a5c5c2214Torne (Richard Coles) CompositeOperator, WebBlendMode, const IntSize& repeatSpacing); 1385267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) void drawTiled(GraphicsContext*, const FloatRect& dstRect, const FloatRect& srcRect, const FloatSize& tileScaleFactor, TileRule hRule, TileRule vRule, CompositeOperator); 1395c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 1405c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) // Supporting tiled drawing 1415c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual bool mayFillWithSolidColor() { return false; } 1425c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) virtual Color solidColor() const { return Color(); } 1435267f701546148b83dfbe1d151cb184385bb5c22Torne (Richard Coles) 1445c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)private: 145926b001d589ce2f10facb93dd4b87578ea35a855Torne (Richard Coles) RefPtr<SharedBuffer> m_encodedImageData; 1465c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) ImageObserver* m_imageObserver; 1475c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)}; 1485c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 149a854de003a23bf3c7f95ec0f8154ada64092ff5cTorne (Richard Coles)#define DEFINE_IMAGE_TYPE_CASTS(typeName) \ 150a854de003a23bf3c7f95ec0f8154ada64092ff5cTorne (Richard Coles) DEFINE_TYPE_CASTS(typeName, Image, image, image->is##typeName(), image.is##typeName()) 151a854de003a23bf3c7f95ec0f8154ada64092ff5cTorne (Richard Coles) 152e38fbeeb576b5094e34e038ab88d9d6a5c5c2214Torne (Richard Coles)} // namespace blink 1535c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles) 1545c87bf8b86a7c82ef50fb7a89697d8e02e2553beTorne (Richard Coles)#endif 155