From a383b3f646cbc1fd870f2694d4fac24340834916 Mon Sep 17 00:00:00 2001 From: Patrick Dubroy Date: Thu, 20 Jan 2011 16:48:59 -0800 Subject: Update Bitmap.recycle() doc for heap-allocated pixel data --- graphics/java/android/graphics/Bitmap.java | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/graphics/java/android/graphics/Bitmap.java b/graphics/java/android/graphics/Bitmap.java index e67ceeda9e74..2b4a410aae24 100644 --- a/graphics/java/android/graphics/Bitmap.java +++ b/graphics/java/android/graphics/Bitmap.java @@ -165,10 +165,12 @@ public final class Bitmap implements Parcelable { } /** - * Free up the memory associated with this bitmap's pixels, and mark the - * bitmap as "dead", meaning it will throw an exception if getPixels() or - * setPixels() is called, and will draw nothing. This operation cannot be - * reversed, so it should only be called if you are sure there are no + * Free the native object associated with this bitmap, and clear the + * reference to the pixel data. This will not free the pixel data synchronously; + * it simply allows it to be garbage collected if there are no other references. + * The bitmap is marked as "dead", meaning it will throw an exception if + * getPixels() or setPixels() is called, and will draw nothing. This operation + * cannot be reversed, so it should only be called if you are sure there are no * further uses for the bitmap. This is an advanced call, and normally need * not be called, since the normal GC process will free up this memory when * there are no more references to this bitmap. -- cgit v1.2.3-59-g8ed1b