Index: include/core/SkBitmap.h |
diff --git a/include/core/SkBitmap.h b/include/core/SkBitmap.h |
index 4dcf3272262e09c2524920e3ae9917610a1acf1f..1dd2c8034f686ff5155fe7011c88fd1acfdab1b2 100644 |
--- a/include/core/SkBitmap.h |
+++ b/include/core/SkBitmap.h |
@@ -128,6 +128,13 @@ public: |
* Set the bitmap's alphaType, returning true on success. If false is |
* returned, then the specified new alphaType is incompatible with the |
* Config, and the current alphaType is unchanged. |
+ * |
+ * Note: this changes the alphatype for the underlying pixels, which means |
+ * that all bitmaps that might be sharing (subsets of) the pixels will |
+ * be affected. This is an expensive change for some backends (e.g. GPU) |
+ * since changing the alphatype can invalidate internal caches. Thus this |
+ * call should only be made if it is associated with real changes to the |
+ * pixel data. |
*/ |
bool setAlphaType(SkAlphaType); |