Index: include/core/SkPixelRef.h |
diff --git a/include/core/SkPixelRef.h b/include/core/SkPixelRef.h |
index b87b0dc114b34958ff36f93ea3d464320334ae60..472599eeb3191c1da4a6f252ed98029e5583ef12 100644 |
--- a/include/core/SkPixelRef.h |
+++ b/include/core/SkPixelRef.h |
@@ -14,9 +14,12 @@ |
#include "SkRefCnt.h" |
#include "SkString.h" |
#include "SkFlattenable.h" |
+#include "SkImageInfo.h" |
#include "SkTDArray.h" |
-#define SK_SUPPORT_LEGACY_PIXELREF_CONSTRUCTOR |
+//#define SK_SUPPORT_LEGACY_PIXELREF_CONSTRUCTOR |
+ |
+#define SK_SUPPORT_LEGACY_ONLOCKPIXELS |
#ifdef SK_DEBUG |
/** |
@@ -67,23 +70,44 @@ public: |
/** Return the pixel memory returned from lockPixels, or null if the |
lockCount is 0. |
*/ |
- void* pixels() const { return fPixels; } |
+ void* pixels() const { return fRec.fPixels; } |
/** Return the current colorTable (if any) if pixels are locked, or null. |
*/ |
- SkColorTable* colorTable() const { return fColorTable; } |
+ SkColorTable* colorTable() const { return fRec.fColorTable; } |
/** |
+ * To access the actual pixels of a pixelref, it must be "locked". |
+ * Calling lockPixels returns a LockRec struct (on success). |
+ */ |
+ struct LockRec { |
+ void* fPixels; |
+ SkColorTable* fColorTable; |
+ size_t fRowBytes; |
+ |
+ void zero() { sk_bzero(this, sizeof(*this)); } |
+ }; |
+ |
+ /** |
* Returns true if the lockcount > 0 |
*/ |
bool isLocked() const { return fLockCount > 0; } |
SkDEBUGCODE(int getLockCount() const { return fLockCount; }) |
- /** Call to access the pixel memory, which is returned. Balance with a call |
- to unlockPixels(). |
- */ |
- void lockPixels(); |
+ /** |
+ * Call to access the pixel memory. Return true on success. Balance this |
+ * with a call to unlockPixels(). |
+ */ |
+ bool lockPixels(); |
+ |
+ /** |
+ * Call to access the pixel memory. On success, return true and fill out |
+ * the specified rec. On failure, return false and ignore the rec parameter. |
+ * Balance this with a call to unlockPixels(). |
+ */ |
+ bool lockPixels(LockRec* rec); |
+ |
/** Call to balanace a previous call to lockPixels(). Returns the pixels |
(or null) after the unlock. NOTE: lock calls can be nested, but the |
matching number of unlock calls must be made in order to free the |
@@ -240,14 +264,28 @@ public: |
void addGenIDChangeListener(GenIDChangeListener* listener); |
protected: |
- /** Called when the lockCount goes from 0 to 1. The caller will have already |
- acquire a mutex for thread safety, so this method need not do that. |
- */ |
- virtual void* onLockPixels(SkColorTable**) = 0; |
- /** Called when the lock count goes from 1 to 0. The caller will have |
- already acquire a mutex for thread safety, so this method need not do |
- that. |
- */ |
+#ifdef SK_SUPPORT_LEGACY_ONLOCKPIXELS |
+ virtual void* onLockPixels(SkColorTable**); |
+ virtual bool onNewLockPixels(LockRec*); |
+#else |
+ /** |
+ * On success, returns true and fills out the LockRec for the pixels. On |
+ * failure returns false and ignores the LockRec parameter. |
+ * |
+ * The caller will have already acquired a mutex for thread safety, so this |
+ * method need not do that. |
+ */ |
+ virtual bool onNewLockPixels(LockRec*) = 0; |
+#endif |
+ |
+ /** |
+ * Balancing the previous successful call to onNewLockPixels. The locked |
+ * pixel address will no longer be referenced, so the subclass is free to |
+ * move or discard that memory. |
+ * |
+ * The caller will have already acquired a mutex for thread safety, so this |
+ * method need not do that. |
+ */ |
virtual void onUnlockPixels() = 0; |
/** Default impl returns true */ |
@@ -291,14 +329,14 @@ protected: |
// only call from constructor. Flags this to always be locked, removing |
// the need to grab the mutex and call onLockPixels/onUnlockPixels. |
// Performance tweak to avoid those calls (esp. in multi-thread use case). |
- void setPreLocked(void* pixels, SkColorTable* ctable); |
+ void setPreLocked(void*, size_t rowBytes, SkColorTable*); |
private: |
SkBaseMutex* fMutex; // must remain in scope for the life of this object |
SkImageInfo fInfo; |
- |
- void* fPixels; |
- SkColorTable* fColorTable; // we do not track ownership, subclass does |
+ |
+ // LockRec is only valid if we're in a locked state (isLocked()) |
+ LockRec fRec; |
int fLockCount; |
mutable uint32_t fGenerationID; |