| /* |
| * Copyright 2007 The Android Open Source Project |
| * |
| * Use of this source code is governed by a BSD-style license that can be |
| * found in the LICENSE file. |
| */ |
| |
| #ifndef SkPicture_DEFINED |
| #define SkPicture_DEFINED |
| |
| #include "SkImageDecoder.h" |
| #include "SkRefCnt.h" |
| #include "SkTypes.h" |
| |
| class GrContext; |
| class SkBigPicture; |
| class SkBitmap; |
| class SkCanvas; |
| class SkPictureData; |
| class SkPixelSerializer; |
| class SkStream; |
| class SkWStream; |
| struct SkPictInfo; |
| |
| /** \class SkPicture |
| |
| An SkPicture records drawing commands made to a canvas to be played back at a later time. |
| This base class handles serialization and a few other miscellany. |
| */ |
| class SK_API SkPicture : public SkRefCnt { |
| public: |
| virtual ~SkPicture(); |
| |
| /** |
| * Function signature defining a function that sets up an SkBitmap from encoded data. On |
| * success, the SkBitmap should have its Config, width, height, rowBytes and pixelref set. |
| * If the installed pixelref has decoded the data into pixels, then the src buffer need not be |
| * copied. If the pixelref defers the actual decode until its lockPixels() is called, then it |
| * must make a copy of the src buffer. |
| * @param src Encoded data. |
| * @param length Size of the encoded data, in bytes. |
| * @param dst SkBitmap to install the pixel ref on. |
| * @param bool Whether or not a pixel ref was successfully installed. |
| */ |
| typedef bool (*InstallPixelRefProc)(const void* src, size_t length, SkBitmap* dst); |
| |
| /** |
| * Recreate a picture that was serialized into a stream. |
| * @param SkStream Serialized picture data. Ownership is unchanged by this call. |
| * @param proc Function pointer for installing pixelrefs on SkBitmaps representing the |
| * encoded bitmap data from the stream. |
| * @return A new SkPicture representing the serialized data, or NULL if the stream is |
| * invalid. |
| */ |
| static SkPicture* CreateFromStream(SkStream*, |
| InstallPixelRefProc proc = &SkImageDecoder::DecodeMemory); |
| |
| /** |
| * Recreate a picture that was serialized into a buffer. If the creation requires bitmap |
| * decoding, the decoder must be set on the SkReadBuffer parameter by calling |
| * SkReadBuffer::setBitmapDecoder() before calling SkPicture::CreateFromBuffer(). |
| * @param SkReadBuffer Serialized picture data. |
| * @return A new SkPicture representing the serialized data, or NULL if the buffer is |
| * invalid. |
| */ |
| static SkPicture* CreateFromBuffer(SkReadBuffer&); |
| |
| /** |
| * Subclasses of this can be passed to playback(). During the playback |
| * of the picture, this callback will periodically be invoked. If its |
| * abort() returns true, then picture playback will be interrupted. |
| * |
| * The resulting drawing is undefined, as there is no guarantee how often the |
| * callback will be invoked. If the abort happens inside some level of nested |
| * calls to save(), restore will automatically be called to return the state |
| * to the same level it was before the playback call was made. |
| */ |
| class SK_API AbortCallback { |
| public: |
| AbortCallback() {} |
| virtual ~AbortCallback() {} |
| virtual bool abort() = 0; |
| }; |
| |
| /** Replays the drawing commands on the specified canvas. Note that |
| this has the effect of unfurling this picture into the destination |
| canvas. Using the SkCanvas::drawPicture entry point gives the destination |
| canvas the option of just taking a ref. |
| @param canvas the canvas receiving the drawing commands. |
| @param callback a callback that allows interruption of playback |
| */ |
| virtual void playback(SkCanvas*, AbortCallback* = NULL) const = 0; |
| |
| /** Return a cull rect for this picture. |
| Ops recorded into this picture that attempt to draw outside the cull might not be drawn. |
| */ |
| virtual SkRect cullRect() const = 0; |
| |
| /** Returns a non-zero value unique among all pictures. */ |
| uint32_t uniqueID() const; |
| |
| /** |
| * Serialize to a stream. If non NULL, serializer will be used to serialize |
| * any bitmaps in the picture. |
| * |
| * TODO: Use serializer to serialize SkImages as well. |
| */ |
| void serialize(SkWStream*, SkPixelSerializer* = NULL) const; |
| |
| /** |
| * Serialize to a buffer. |
| */ |
| void flatten(SkWriteBuffer&) const; |
| |
| /** |
| * Returns true if any bitmaps may be produced when this SkPicture |
| * is replayed. |
| */ |
| virtual bool willPlayBackBitmaps() const = 0; |
| |
| /** Return the approximate number of operations in this picture. This |
| * number may be greater or less than the number of SkCanvas calls |
| * recorded: some calls may be recorded as more than one operation, or some |
| * calls may be optimized away. |
| */ |
| virtual int approximateOpCount() const = 0; |
| |
| /** Return true if this picture contains text. |
| */ |
| virtual bool hasText() const = 0; |
| |
| /** Returns the approximate byte size of this picture, not including large ref'd objects. */ |
| virtual size_t approximateBytesUsed() const = 0; |
| |
| /** Return true if the SkStream/Buffer represents a serialized picture, and |
| fills out SkPictInfo. After this function returns, the data source is not |
| rewound so it will have to be manually reset before passing to |
| CreateFromStream or CreateFromBuffer. Note, CreateFromStream and |
| CreateFromBuffer perform this check internally so these entry points are |
| intended for stand alone tools. |
| If false is returned, SkPictInfo is unmodified. |
| */ |
| static bool InternalOnly_StreamIsSKP(SkStream*, SkPictInfo*); |
| static bool InternalOnly_BufferIsSKP(SkReadBuffer*, SkPictInfo*); |
| |
| /** Return true if the picture is suitable for rendering on the GPU. */ |
| virtual bool suitableForGpuRasterization(GrContext*, const char** whyNot = NULL) const = 0; |
| |
| // Sent via SkMessageBus from destructor. |
| struct DeletionMessage { int32_t fUniqueID; }; // TODO: -> uint32_t? |
| |
| // Returns NULL if this is not an SkBigPicture. |
| virtual const SkBigPicture* asSkBigPicture() const { return NULL; } |
| |
| private: |
| // Subclass whitelist. |
| SkPicture(); |
| friend class SkBigPicture; |
| friend class SkEmptyPicture; |
| template <typename> friend class SkMiniPicture; |
| |
| virtual int numSlowPaths() const = 0; |
| |
| // V35: Store SkRect (rather then width & height) in header |
| // V36: Remove (obsolete) alphatype from SkColorTable |
| // V37: Added shadow only option to SkDropShadowImageFilter (last version to record CLEAR) |
| // V38: Added PictureResolution option to SkPictureImageFilter |
| // V39: Added FilterLevel option to SkPictureImageFilter |
| // V40: Remove UniqueID serialization from SkImageFilter. |
| // V41: Added serialization of SkBitmapSource's filterQuality parameter |
| |
| // Only SKPs within the min/current picture version range (inclusive) can be read. |
| static const uint32_t MIN_PICTURE_VERSION = 35, // Produced by Chrome M39. |
| CURRENT_PICTURE_VERSION = 41; |
| |
| static_assert(MIN_PICTURE_VERSION <= 41, |
| "Remove kFontFileName and related code from SkFontDescriptor.cpp."); |
| |
| static bool IsValidPictInfo(const SkPictInfo& info); |
| static SkPicture* Forwardport(const SkPictInfo&, const SkPictureData*); |
| |
| SkPictInfo createHeader() const; |
| SkPictureData* backport() const; |
| |
| mutable uint32_t fUniqueID; |
| }; |
| |
| #endif |