Overview
ScaleDrawable与ClipDrawable类似,可以根据设置的level值对drawable进行缩放,但与ClipDrawable不同的是,ScaleDrawable还可以根据设置android:scaleWidth
和android:scaleHeight
进行相应百分比的缩放。
创建和使用
语法:
<?xml version="1.0" encoding="utf-8"?>
<scale
xmlns:android="http://schemas.android.com/apk/res/android"
android:drawable="@drawable/drawable_resource"
android:scaleGravity=["top" | "bottom" | "left" | "right" | "center_vertical" |
"fill_vertical" | "center_horizontal" | "fill_horizontal" |
"center" | "fill" | "clip_vertical" | "clip_horizontal"]
android:scaleHeight="percentage"
android:scaleWidth="percentage" />
元素:
<scale>
定义一个ScaleDrawable,必须作为根元素。
- android:drawable Drawable 资源。必须的。引用一个drawable资源。
- android:scaleHeight 缩放的高度,以百分比的方式表示drawable的缩放。形式例如:100%,12.5%。
- android:scaleWidth 缩放的宽度,以百分比的方式表示drawable的缩放。形式例如:100%,12.5%。
- android:scaleGravity 指定缩放后的gravity的位置。必须是下面的一个或多个值(多个值之间用”|”分隔)
- top 将这个对象放在容器的顶部,不改变其大小。
- bottom 将这个对象放在容器的底部,不改变其大小。
- left 将这个对象放在容器的左部,不改变其大小。默认值。
- right 将这个对象放在容器的右部,不改变其大小。
- center_vertical 将对象放在垂直中间,不改变其大小。
- fill_vertical 如果需要的话,该对象的垂直尺寸将增加,以便完全填充它的容器。
- center_horizontal 将对象放在水平中间,不改变其大小。
- fill_horizontal 如果需要的话,该对象的水平尺寸将增加,以便完全填充它的容器。
- center 将对象放置在其容器的中心和水平轴的中心位置,而不改变它的大小。
- fill 如果需要的话,该对象的水平和垂直方向的大小将增加,使得完全填充它的容器。
- clip_vertical 可以设置为在其容器边界上的顶部和/或底部边缘的附加选项。该剪辑是基于垂直gravity:一个顶部gravity剪辑的底部边缘,底部重力剪辑的顶部边缘,既不剪辑两个边。
- clip_horizontal 与clip_vertical类似,只是剪辑是基于水平gravity。
来看下面的例子,在res/drawable/scale.xml中定义一个ScaleDrawable:
<ImageView
android:id="@+id/imgView"
android:src="@drawable/scale"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
但是如果我们直接运行,发现并没有显示图片,查看ScaleDrawable的源码,发现draw()方法有判断getLevel() != 0
才绘制。而我们在没有setLevel()
时,默认getLevel()
都是0
android/platform/frameworks/base/graphics/java/android/graphics/drawable/ScaleDrawable.java:
@Override
public void draw(Canvas canvas) {
final Drawable d = getDrawable();
if (d != null && d.getLevel() != 0) {
d.draw(canvas);
}
}
所以如果我们想正常显示图片,还需要设置drawable的level。
ImageView imageview = (ImageView) findViewById(R.id.image);
ScaleDrawable drawable = (ScaleDrawable) imageview.getDrawable();
drawable.setLevel(1);
那么为什么设置了level之后就会显示图片呢,而且我们应该设置多大呢?我们继续看源码,当设置level之后会触发onLevelChange事件:
@Override
protected boolean onLevelChange(int level) {
super.onLevelChange(level);
onBoundsChange(getBounds());
invalidateSelf();
return true;
}
我们可以看到在onLevelChange中又调用了onBoundsChange():
@Override
protected void onBoundsChange(Rect bounds) {
final Drawable d = getDrawable();
final Rect r = mTmpRect;
final boolean min = mState.mUseIntrinsicSizeAsMin;
final int level = getLevel();
int w = bounds.width();
if (mState.mScaleWidth > 0) {
final int iw = min ? d.getIntrinsicWidth() : 0;
w -= (int) ((w - iw) * (MAX_LEVEL - level) * mState.mScaleWidth / MAX_LEVEL);
}
int h = bounds.height();
if (mState.mScaleHeight > 0) {
final int ih = min ? d.getIntrinsicHeight() : 0;
h -= (int) ((h - ih) * (MAX_LEVEL - level) * mState.mScaleHeight / MAX_LEVEL);
}
final int layoutDirection = getLayoutDirection();
Gravity.apply(mState.mGravity, w, h, bounds, r, layoutDirection);
if (w > 0 && h > 0) {
d.setBounds(r.left, r.top, r.right, r.bottom);
}
}
我们注意到在计算图片长宽的表达式中有几个变量,final int iw = min ? d.getIntrinsicWidth() : 0;这行中的min = mState.mUseIntrinsicSizeAsMin;其实也是从xml文件中读取的:
state.mUseIntrinsicSizeAsMin = a.getBoolean(
R.styleable.ScaleDrawable_useIntrinsicSizeAsMinimum, state.mUseIntrinsicSizeAsMin);
但是我们一般没有设置这个值,默认为false,所以iw和ih也默认为0,MAX_LEVEL为10000.那么上面的表达式就可以简化为
w -= (int) (w * (10000 - level) * mState.mScaleWidth / 10000);
h -= (int) (h * (10000 - level) * mState.mScaleHeight / 10000);
如果我们设置level=10000,即为:
w -= 0
h -= 0
也就是图片原始大小,没有缩放效果。当level=0时图片又没有显示,所以我们一般设置level为1,这样,图片就会根据xml中的android:scaleWidth和android:scaleHeight进行相应的缩放了。例如我们设置长宽缩放比例为50%,那么图片长和宽都是原来的一倍,图片大小实际是原来大小的四分之一。