| Index: Source/platform/image-decoders/ImageFrame.h
|
| diff --git a/Source/platform/image-decoders/ImageFrame.h b/Source/platform/image-decoders/ImageFrame.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..ab7135722bab75f8f6ffec413086e9c4d5e67aab
|
| --- /dev/null
|
| +++ b/Source/platform/image-decoders/ImageFrame.h
|
| @@ -0,0 +1,236 @@
|
| +/*
|
| + * Copyright (C) 2006 Apple Computer, Inc. All rights reserved.
|
| + * Copyright (C) Research In Motion Limited 2009-2010. All rights reserved.
|
| + *
|
| + * Redistribution and use in source and binary forms, with or without
|
| + * modification, are permitted provided that the following conditions
|
| + * are met:
|
| + * 1. Redistributions of source code must retain the above copyright
|
| + * notice, this list of conditions and the following disclaimer.
|
| + * 2. Redistributions in binary form must reproduce the above copyright
|
| + * notice, this list of conditions and the following disclaimer in the
|
| + * documentation and/or other materials provided with the distribution.
|
| + *
|
| + * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
|
| + * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
| + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
| + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR
|
| + * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
| + * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
| + * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
|
| + * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
|
| + * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
| + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
| + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
| + */
|
| +
|
| +#ifndef ImageFrame_h
|
| +#define ImageFrame_h
|
| +
|
| +#include "platform/PlatformExport.h"
|
| +#include "platform/geometry/IntRect.h"
|
| +#include "platform/graphics/skia/NativeImageSkia.h"
|
| +#include "wtf/Assertions.h"
|
| +#include "wtf/PassRefPtr.h"
|
| +
|
| +namespace WebCore {
|
| +
|
| +// ImageFrame represents the decoded image data. This buffer is what all
|
| +// decoders write a single frame into.
|
| +class PLATFORM_EXPORT ImageFrame {
|
| +public:
|
| + enum Status { FrameEmpty, FramePartial, FrameComplete };
|
| + enum DisposalMethod {
|
| + // If you change the numeric values of these, make sure you audit
|
| + // all users, as some users may cast raw values to/from these
|
| + // constants.
|
| + DisposeNotSpecified, // Leave frame in framebuffer
|
| + DisposeKeep, // Leave frame in framebuffer
|
| + DisposeOverwriteBgcolor, // Clear frame to fully transparent
|
| + DisposeOverwritePrevious // Clear frame to previous framebuffer contents
|
| + };
|
| + // Indicates how non-opaque pixels in the current frame rectangle
|
| + // are blended with those in the previous frame.
|
| + // Notes:
|
| + // * GIF always uses 'BlendAtopPreviousFrame'.
|
| + // * WebP also uses the 'BlendAtopBgcolor' option. This is useful for
|
| + // cases where one wants to transform a few opaque pixels of the
|
| + // previous frame into non-opaque pixels in the current frame.
|
| + enum AlphaBlendSource {
|
| + // Blend non-opaque pixels atop the corresponding pixels in the
|
| + // initial buffer state (i.e. any previous frame buffer after having
|
| + // been properly disposed).
|
| + BlendAtopPreviousFrame,
|
| +
|
| + // Blend non-opaque pixels against fully transparent (i.e. simply
|
| + // overwrite the corresponding pixels).
|
| + BlendAtopBgcolor,
|
| + };
|
| + typedef uint32_t PixelData;
|
| +
|
| + ImageFrame();
|
| +
|
| + ImageFrame(const ImageFrame& other) { operator=(other); }
|
| +
|
| + // For backends which refcount their data, this operator doesn't need to
|
| + // create a new copy of the image data, only increase the ref count.
|
| + ImageFrame& operator=(const ImageFrame& other);
|
| +
|
| + // These do not touch other metadata, only the raw pixel data.
|
| + void clearPixelData();
|
| + void zeroFillPixelData();
|
| + void zeroFillFrameRect(const IntRect&);
|
| +
|
| + // Makes this frame have an independent copy of the provided image's
|
| + // pixel data, so that modifications in one frame are not reflected in
|
| + // the other. Returns whether the copy succeeded.
|
| + bool copyBitmapData(const ImageFrame&);
|
| +
|
| + // Copies the pixel data at [(startX, startY), (endX, startY)) to the
|
| + // same X-coordinates on each subsequent row up to but not including
|
| + // endY.
|
| + void copyRowNTimes(int startX, int endX, int startY, int endY)
|
| + {
|
| + ASSERT(startX < width());
|
| + ASSERT(endX <= width());
|
| + ASSERT(startY < height());
|
| + ASSERT(endY <= height());
|
| + const int rowBytes = (endX - startX) * sizeof(PixelData);
|
| + const PixelData* const startAddr = getAddr(startX, startY);
|
| + for (int destY = startY + 1; destY < endY; ++destY)
|
| + memcpy(getAddr(startX, destY), startAddr, rowBytes);
|
| + }
|
| +
|
| + // Allocates space for the pixel data. Must be called before any pixels
|
| + // are written. Must only be called once. Returns whether allocation
|
| + // succeeded.
|
| + bool setSize(int newWidth, int newHeight);
|
| +
|
| + // Returns a caller-owned pointer to the underlying native image data.
|
| + // (Actual use: This pointer will be owned by BitmapImage and freed in
|
| + // FrameData::clear()).
|
| + PassRefPtr<NativeImageSkia> asNewNativeImage() const;
|
| +
|
| + bool hasAlpha() const;
|
| + const IntRect& originalFrameRect() const { return m_originalFrameRect; }
|
| + Status status() const { return m_status; }
|
| + unsigned duration() const { return m_duration; }
|
| + DisposalMethod disposalMethod() const { return m_disposalMethod; }
|
| + AlphaBlendSource alphaBlendSource() const { return m_alphaBlendSource; }
|
| + bool premultiplyAlpha() const { return m_premultiplyAlpha; }
|
| + SkBitmap::Allocator* allocator() const { return m_allocator; }
|
| + const SkBitmap& getSkBitmap() const { return m_bitmap->bitmap(); }
|
| + // Returns true if the pixels changed, but the bitmap has not yet been notified.
|
| + bool pixelsChanged() const { return m_pixelsChanged; }
|
| +
|
| + size_t requiredPreviousFrameIndex() const
|
| + {
|
| + ASSERT(m_requiredPreviousFrameIndexValid);
|
| + return m_requiredPreviousFrameIndex;
|
| + }
|
| +#if !ASSERT_DISABLED
|
| + bool requiredPreviousFrameIndexValid() const { return m_requiredPreviousFrameIndexValid; }
|
| +#endif
|
| + void setHasAlpha(bool alpha);
|
| + void setOriginalFrameRect(const IntRect& r) { m_originalFrameRect = r; }
|
| + void setStatus(Status);
|
| + void setDuration(unsigned duration) { m_duration = duration; }
|
| + void setDisposalMethod(DisposalMethod disposalMethod) { m_disposalMethod = disposalMethod; }
|
| + void setAlphaBlendSource(AlphaBlendSource alphaBlendSource) { m_alphaBlendSource = alphaBlendSource; }
|
| + void setPremultiplyAlpha(bool premultiplyAlpha) { m_premultiplyAlpha = premultiplyAlpha; }
|
| + void setMemoryAllocator(SkBitmap::Allocator* allocator) { m_allocator = allocator; }
|
| + void setSkBitmap(const SkBitmap& bitmap) { m_bitmap = NativeImageSkia::create(bitmap); }
|
| + // The pixelsChanged flag needs to be set when the raw pixel data was directly modified
|
| + // (e.g. through a pointer or setRGBA). The flag is usually set after a batch of changes was made.
|
| + void setPixelsChanged(bool pixelsChanged) { m_pixelsChanged = pixelsChanged; }
|
| +
|
| + void setRequiredPreviousFrameIndex(size_t previousFrameIndex)
|
| + {
|
| + m_requiredPreviousFrameIndex = previousFrameIndex;
|
| +#if !ASSERT_DISABLED
|
| + m_requiredPreviousFrameIndexValid = true;
|
| +#endif
|
| + }
|
| +
|
| + inline PixelData* getAddr(int x, int y)
|
| + {
|
| + return m_bitmap->bitmap().getAddr32(x, y);
|
| + }
|
| +
|
| + inline void setRGBA(int x, int y, unsigned r, unsigned g, unsigned b, unsigned a)
|
| + {
|
| + setRGBA(getAddr(x, y), r, g, b, a);
|
| + }
|
| +
|
| + static const unsigned div255 = static_cast<unsigned>(1.0 / 255 * (1 << 24)) + 1;
|
| +
|
| + inline void setRGBA(PixelData* dest, unsigned r, unsigned g, unsigned b, unsigned a)
|
| + {
|
| + if (m_premultiplyAlpha && a < 255) {
|
| + if (!a) {
|
| + *dest = 0;
|
| + return;
|
| + }
|
| +
|
| + unsigned alpha = a * div255;
|
| + r = (r * alpha) >> 24;
|
| + g = (g * alpha) >> 24;
|
| + b = (b * alpha) >> 24;
|
| + }
|
| +
|
| + // Call the "NoCheck" version since we may deliberately pass non-premultiplied
|
| + // values, and we don't want an assert.
|
| + *dest = SkPackARGB32NoCheck(a, r, g, b);
|
| + }
|
| +
|
| + inline void setRGBARaw(PixelData* dest, unsigned r, unsigned g, unsigned b, unsigned a)
|
| + {
|
| + *dest = SkPackARGB32NoCheck(a, r, g, b);
|
| + }
|
| +
|
| + // Notifies the SkBitmap if any pixels changed and resets the flag.
|
| + inline void notifyBitmapIfPixelsChanged()
|
| + {
|
| + if (m_pixelsChanged)
|
| + m_bitmap->bitmap().notifyPixelsChanged();
|
| + m_pixelsChanged = false;
|
| + }
|
| +
|
| +private:
|
| + int width() const
|
| + {
|
| + return m_bitmap->bitmap().width();
|
| + }
|
| +
|
| + int height() const
|
| + {
|
| + return m_bitmap->bitmap().height();
|
| + }
|
| +
|
| + RefPtr<NativeImageSkia> m_bitmap;
|
| + SkBitmap::Allocator* m_allocator;
|
| + bool m_hasAlpha;
|
| + // This will always just be the entire buffer except for GIF or WebP
|
| + // frames whose original rect was smaller than the overall image size.
|
| + IntRect m_originalFrameRect;
|
| + Status m_status;
|
| + unsigned m_duration;
|
| + DisposalMethod m_disposalMethod;
|
| + AlphaBlendSource m_alphaBlendSource;
|
| + bool m_premultiplyAlpha;
|
| + // True if the pixels changed, but the bitmap has not yet been notified.
|
| + bool m_pixelsChanged;
|
| +
|
| + // The frame that must be decoded before this frame can be decoded.
|
| + // WTF::kNotFound if this frame doesn't require any previous frame.
|
| + // This is used by ImageDecoder::clearCacheExceptFrame(), and will never
|
| + // be read for image formats that do not have multiple frames.
|
| + size_t m_requiredPreviousFrameIndex;
|
| +#if !ASSERT_DISABLED
|
| + bool m_requiredPreviousFrameIndexValid;
|
| +#endif
|
| +};
|
| +
|
| +} // namespace WebCore
|
| +
|
| +#endif
|
|
|