Add convenience methods, to encourage usage of ALL_SAVE_FLAG (39b7353a) · Commits · e / os / android_frameworks_base

api/current.txt

+4 −0

Original line number	Diff line number	Diff line
		@@ -9708,9 +9708,13 @@ package android.graphics {
		method public int save();
		method public int save(int);
		method public int saveLayer(android.graphics.RectF, android.graphics.Paint, int);
		method public int saveLayer(android.graphics.RectF, android.graphics.Paint);
		method public int saveLayer(float, float, float, float, android.graphics.Paint, int);
		method public int saveLayer(float, float, float, float, android.graphics.Paint);
		method public int saveLayerAlpha(android.graphics.RectF, int, int);
		method public int saveLayerAlpha(android.graphics.RectF, int);
		method public int saveLayerAlpha(float, float, float, float, int, int);
		method public int saveLayerAlpha(float, float, float, float, int);
		method public void scale(float, float);
		method public final void scale(float, float, float, float);
		method public void setBitmap(android.graphics.Bitmap);

graphics/java/android/graphics/Canvas.java

+30 −27

Original line number	Diff line number	Diff line
		@@ -21,8 +21,6 @@ import android.text.SpannableString;
		import android.text.SpannedString;
		import android.text.TextUtils;

		import javax.microedition.khronos.opengles.GL;

		/**
		* The Canvas class holds the "draw" calls. To draw something, you need
		* 4 basic components: A Bitmap to hold the pixels, a Canvas to host
		@@ -167,29 +165,6 @@ public class Canvas {
		finalizer(oldCanvas);
		}

		/**
		* Gets the native canvas pointer.
		*
		* @return The native pointer.
		*
		* @hide
		*/
		public long getNativeCanvas() {
		return mNativeCanvas;
		}

		/**
		* Returns null.
		*
		* @deprecated This method is not supported and should not be invoked.
		*
		* @hide
		*/
		@Deprecated
		protected GL getGL() {
		return null;
		}

		/**
		* Indicates whether this Canvas uses hardware acceleration.
		*
		@@ -390,6 +365,13 @@ public class Canvas {
		saveFlags);
		}

		/**
		* Convenience for saveLayer(bounds, paint, {@link #ALL_SAVE_FLAG})
		*/
		public int saveLayer(RectF bounds, Paint paint) {
		return saveLayer(bounds, paint, ALL_SAVE_FLAG);
		}

		/**
		* Helper version of saveLayer() that takes 4 values rather than a RectF.
		*/
		@@ -400,6 +382,13 @@ public class Canvas {
		saveFlags);
		}

		/**
		* Convenience for saveLayer(left, top, right, bottom, paint, {@link #ALL_SAVE_FLAG})
		*/
		public int saveLayer(float left, float top, float right, float bottom, Paint paint) {
		return saveLayer(left, top, right, bottom, paint, ALL_SAVE_FLAG);
		}

		/**
		* This behaves the same as save(), but in addition it allocates an
		* offscreen bitmap. All drawing calls are directed there, and only when
		@@ -421,6 +410,13 @@ public class Canvas {
		return native_saveLayerAlpha(mNativeCanvas, bounds, alpha, saveFlags);
		}

		/**
		* Convenience for saveLayerAlpha(bounds, alpha, {@link #ALL_SAVE_FLAG})
		*/
		public int saveLayerAlpha(RectF bounds, int alpha) {
		return saveLayerAlpha(bounds, alpha, ALL_SAVE_FLAG);
		}

		/**
		* Helper for saveLayerAlpha() that takes 4 values instead of a RectF.
		*/
		@@ -430,6 +426,13 @@ public class Canvas {
		alpha, saveFlags);
		}

		/**
		* Helper for saveLayerAlpha(left, top, right, bottom, alpha, {@link #ALL_SAVE_FLAG})
		*/
		public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha) {
		return saveLayerAlpha(left, top, right, bottom, alpha, ALL_SAVE_FLAG);
		}

		/**
		* This call balances a previous call to save(), and is used to remove all
		* modifications to the matrix/clip state since the last save call. It is