Index: include/codec/SkCodec.h |
diff --git a/include/codec/SkCodec.h b/include/codec/SkCodec.h |
index dffab6b3779207aeba99084810afb27d8416a097..9f28af010edf26d0ebc2cdaf600ac67423362afa 100644 |
--- a/include/codec/SkCodec.h |
+++ b/include/codec/SkCodec.h |
@@ -29,8 +29,17 @@ public: |
* If this stream represents an encoded image that we know how to decode, |
* return an SkCodec that can decode it. Otherwise return NULL. |
* |
- * If SkPngChunkReader is not NULL, take a ref and pass it to libpng if |
- * the image is a png. |
+ * If the SkPngChunkReader is not NULL then: |
+ * If the image is not a PNG, the SkPngChunkReader will be ignored. |
+ * If the image is a PNG, the SkPngChunkReader will be reffed. |
+ * If the PNG has unknown chunks, the SkPngChunkReader will be used |
+ * to handle these chunks. SkPngChunkReader will be called to read |
+ * any unknown chunk at any point during the creation of the codec |
+ * or the decode. Note that if SkPngChunkReader fails to read a |
+ * chunk, this could result in a failure to create the codec or a |
+ * failure to decode the image. |
+ * If the PNG does not contain unknown chunks, the SkPngChunkReader |
+ * will not be used or modified. |
* |
* If NULL is returned, the stream is deleted immediately. Otherwise, the |
* SkCodec takes ownership of it, and will delete it when done with it. |
@@ -41,8 +50,17 @@ public: |
* If this data represents an encoded image that we know how to decode, |
* return an SkCodec that can decode it. Otherwise return NULL. |
* |
- * If SkPngChunkReader is not NULL, take a ref and pass it to libpng if |
- * the image is a png. |
+ * If the SkPngChunkReader is not NULL then: |
+ * If the image is not a PNG, the SkPngChunkReader will be ignored. |
+ * If the image is a PNG, the SkPngChunkReader will be reffed. |
+ * If the PNG has unknown chunks, the SkPngChunkReader will be used |
+ * to handle these chunks. SkPngChunkReader will be called to read |
+ * any unknown chunk at any point during the creation of the codec |
+ * or the decode. Note that if SkPngChunkReader fails to read a |
+ * chunk, this could result in a failure to create the codec or a |
+ * failure to decode the image. |
+ * If the PNG does not contain unknown chunks, the SkPngChunkReader |
+ * will not be used or modified. |
* |
* Will take a ref if it returns a codec, else will not affect the data. |
*/ |