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

api/current.txt

+4 −0

Original line number	Diff line number	Diff line
		@@ -9735,9 +9735,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

+34 −17

Original line number	Diff line number	Diff line
		@@ -167,17 +167,6 @@ public class Canvas {
		finalizer(oldCanvas);
		}

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

		/**
		* Returns null.
		*
		@@ -390,6 +379,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 +396,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 +424,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 +440,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