Merge "Rename set/get-ConserveMemory" into pi-dev (844ecb32) · Commits · e / os / android_frameworks_base

api/current.txt

+4 −2

Original line number	Diff line number	Diff line
		@@ -13658,17 +13658,17 @@ package android.graphics {
		method public static android.graphics.drawable.Drawable decodeDrawable(android.graphics.ImageDecoder.Source, android.graphics.ImageDecoder.OnHeaderDecodedListener) throws java.io.IOException;
		method public static android.graphics.drawable.Drawable decodeDrawable(android.graphics.ImageDecoder.Source) throws java.io.IOException;
		method public int getAllocator();
		method public boolean getConserveMemory();
		method public android.graphics.Rect getCrop();
		method public int getMemorySizePolicy();
		method public android.graphics.ImageDecoder.OnPartialImageListener getOnPartialImageListener();
		method public android.graphics.PostProcessor getPostProcessor();
		method public boolean isDecodeAsAlphaMaskEnabled();
		method public boolean isMutableRequired();
		method public boolean isUnpremultipliedRequired();
		method public void setAllocator(int);
		method public void setConserveMemory(boolean);
		method public void setCrop(android.graphics.Rect);
		method public void setDecodeAsAlphaMaskEnabled(boolean);
		method public void setMemorySizePolicy(int);
		method public void setMutableRequired(boolean);
		method public void setOnPartialImageListener(android.graphics.ImageDecoder.OnPartialImageListener);
		method public void setPostProcessor(android.graphics.PostProcessor);
		@@ -13680,6 +13680,8 @@ package android.graphics {
		field public static final int ALLOCATOR_HARDWARE = 3; // 0x3
		field public static final int ALLOCATOR_SHARED_MEMORY = 2; // 0x2
		field public static final int ALLOCATOR_SOFTWARE = 1; // 0x1
		field public static final int MEMORY_POLICY_DEFAULT = 1; // 0x1
		field public static final int MEMORY_POLICY_LOW_RAM = 0; // 0x0
		}

		public static final class ImageDecoder.DecodeException extends java.io.IOException {

api/removed.txt

+2 −0

Original line number	Diff line number	Diff line
		@@ -178,10 +178,12 @@ package android.graphics {

		public final class ImageDecoder implements java.lang.AutoCloseable {
		method public deprecated boolean getAsAlphaMask();
		method public deprecated boolean getConserveMemory();
		method public deprecated boolean getDecodeAsAlphaMask();
		method public deprecated boolean getMutable();
		method public deprecated boolean getRequireUnpremultiplied();
		method public deprecated android.graphics.ImageDecoder setAsAlphaMask(boolean);
		method public deprecated void setConserveMemory(boolean);
		method public deprecated android.graphics.ImageDecoder setDecodeAsAlphaMask(boolean);
		method public deprecated android.graphics.ImageDecoder setMutable(boolean);
		method public deprecated android.graphics.ImageDecoder setRequireUnpremultiplied(boolean);

graphics/java/android/graphics/ImageDecoder.java

+63 −32

Original line number	Diff line number	Diff line
		@@ -581,7 +581,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Subsumed by {@link #DecodeException}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public static class IncompleteException extends IOException {};

		/**
		@@ -613,19 +613,19 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Replaced by {@link #DecodeException#SOURCE_EXCEPTION}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public static final int ERROR_SOURCE_EXCEPTION = 1;

		/** @removed
		* @deprecated Replaced by {@link #DecodeException#SOURCE_INCOMPLETE}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public static final int ERROR_SOURCE_INCOMPLETE = 2;

		/** @removed
		* @deprecated Replaced by {@link #DecodeException#SOURCE_MALFORMED_DATA}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public static final int ERROR_SOURCE_ERROR = 3;

		/**
		@@ -1000,7 +1000,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #setTargetSize}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public ImageDecoder setResize(int width, int height) {
		this.setTargetSize(width, height);
		return this;
		@@ -1039,7 +1039,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #setTargetSampleSize}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public ImageDecoder setResize(int sampleSize) {
		this.setTargetSampleSize(sampleSize);
		return this;
		@@ -1125,7 +1125,7 @@ public final class ImageDecoder implements AutoCloseable {
		/**
		* Use a software allocation for the pixel memory.
		*
		* Useful for drawing to a software {@link Canvas} or for
		* <p>Useful for drawing to a software {@link Canvas} or for
		* accessing the pixels on the final output.
		*/
		public static final int ALLOCATOR_SOFTWARE = 1;
		@@ -1133,14 +1133,14 @@ public final class ImageDecoder implements AutoCloseable {
		/**
		* Use shared memory for the pixel memory.
		*
		* Useful for sharing across processes.
		* <p>Useful for sharing across processes.
		*/
		public static final int ALLOCATOR_SHARED_MEMORY = 2;

		/**
		* Require a {@link Bitmap.Config#HARDWARE} {@link Bitmap}.
		*
		* When this is combined with incompatible options, like
		* <p>When this is combined with incompatible options, like
		* {@link #setMutableRequired setMutableRequired(true)} or
		* {@link #setDecodeAsAlphaMaskEnabled setDecodeAsAlphaMaskEnabled(true)},
		* {@link #decodeDrawable decodeDrawable} or {@link #decodeBitmap decodeBitmap}
		@@ -1203,7 +1203,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #setUnpremultipliedRequired}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public ImageDecoder setRequireUnpremultiplied(boolean unpremultipliedRequired) {
		this.setUnpremultipliedRequired(unpremultipliedRequired);
		return this;
		@@ -1219,7 +1219,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #isUnpremultipliedRequired}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public boolean getRequireUnpremultiplied() {
		return this.isUnpremultipliedRequired();
		}
		@@ -1348,7 +1348,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #setMutableRequired}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public ImageDecoder setMutable(boolean mutable) {
		this.setMutableRequired(mutable);
		return this;
		@@ -1364,37 +1364,68 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #isMutableRequired}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public boolean getMutable() {
		return this.isMutableRequired();
		}

		/**
		* Specify whether to potentially save RAM at the expense of quality.
		* Save memory if possible by using a denser {@link Bitmap.Config} at the
		* cost of some image quality.
		*
		* <p>Setting this to {@code true} may result in a {@link Bitmap} with a
		* denser {@link Bitmap.Config}, depending on the image. For example, an
		* opaque {@link Bitmap} with 8 bits or precision for each of its red,
		* green and blue components would decode to
		* {@link Bitmap.Config#ARGB_8888} by default, but setting this to
		* {@code true} will result in decoding to {@link Bitmap.Config#RGB_565}.
		* This necessarily lowers the quality of the output, but saves half
		* the memory used.</p>
		* <p>For example an opaque 8-bit image may be compressed into an
		* {@link Bitmap.Config#RGB_565} configuration, sacrificing image
		* quality to save memory.
		*/
		public static final int MEMORY_POLICY_LOW_RAM = 0;

		/**
		* Use the most natural {@link Bitmap.Config} for the internal {@link Bitmap}.
		*
		* <p>This is the recommended default for most applications and usages. This
		* will use the closest {@link Bitmap.Config} for the encoded source. If the
		* encoded source does not exactly match any {@link Bitmap.Config}, the next
		* highest quality {@link Bitmap.Config} will be used avoiding any loss in
		* image quality.
		*/
		public static final int MEMORY_POLICY_DEFAULT = 1;

		/ @hide /
		@Retention(SOURCE)
		@IntDef(value = { MEMORY_POLICY_DEFAULT, MEMORY_POLICY_LOW_RAM },
		prefix = {"MEMORY_POLICY_"})
		public @interface MemoryPolicy {};

		/**
		* Specify the memory policy for the decoded {@link Bitmap}.
		*
		* <p>Like all setters on ImageDecoder, this must be called inside
		* {@link OnHeaderDecodedListener#onHeaderDecoded onHeaderDecoded}.</p>
		*/
		public void setMemorySizePolicy(@MemoryPolicy int policy) {
		mConserveMemory = (policy == MEMORY_POLICY_LOW_RAM);
		}

		/**
		* Retrieve the memory policy for the decoded {@link Bitmap}.
		*/
		@MemoryPolicy
		public int getMemorySizePolicy() {
		return mConserveMemory ? MEMORY_POLICY_LOW_RAM : MEMORY_POLICY_DEFAULT;
		}

		/** @removed
		* @deprecated Replaced by {@link #setMemorySizePolicy}.
		*/
		@Deprecated
		public void setConserveMemory(boolean conserveMemory) {
		mConserveMemory = conserveMemory;
		}

		/**
		* Return whether this object will try to save RAM at the expense of quality.
		*
		* <p>This returns whether {@link #setConserveMemory} was set to {@code true}.
		* It may still return {@code true} even if the {@code ImageDecoder} does not
		* have a way to save RAM at the expense of quality for this image.</p>
		/** @removed
		* @deprecated Replaced by {@link #getMemorySizePolicy}.
		*/
		@Deprecated
		public boolean getConserveMemory() {
		return mConserveMemory;
		}
		@@ -1421,7 +1452,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #setDecodeAsAlphaMaskEnabled}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public ImageDecoder setDecodeAsAlphaMask(boolean enabled) {
		this.setDecodeAsAlphaMaskEnabled(enabled);
		return this;
		@@ -1430,7 +1461,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #setDecodeAsAlphaMaskEnabled}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public ImageDecoder setAsAlphaMask(boolean asAlphaMask) {
		this.setDecodeAsAlphaMask(asAlphaMask);
		return this;
		@@ -1451,7 +1482,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #isDecodeAsAlphaMaskEnabled}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public boolean getDecodeAsAlphaMask() {
		return mDecodeAsAlphaMask;
		}
		@@ -1459,7 +1490,7 @@ public final class ImageDecoder implements AutoCloseable {
		/** @removed
		* @deprecated Renamed to {@link #isDecodeAsAlphaMaskEnabled}.
		*/
		@java.lang.Deprecated
		@Deprecated
		public boolean getAsAlphaMask() {
		return this.getDecodeAsAlphaMask();
		}