Merge "Rename set/get-ConserveMemory" into pi-dev

am: d2c218f78a

Change-Id: Ib503dcfca248abdc31ee879bb4bef7a7c1af7977
This commit is contained in:
Leon Scroggins III
2018-04-05 14:11:12 -07:00
committed by android-build-merger
3 changed files with 69 additions and 34 deletions

View File

@@ -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 {

View File

@@ -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);

View File

@@ -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();
}