Overview

ScaleDrawable与ClipDrawable类似,可以根据设置的level值对drawable进行缩放,但与ClipDrawable不同的是,ScaleDrawable还可以根据设置android:scaleWidthandroid: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:

<?xml version="1.0" encoding="utf-8"?>
<scale xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/image"
    android:scaleGravity="center_vertical|center_horizontal"
    android:scaleHeight="50%"
    android:scaleWidth="50%" />

然后在layout中使用:

<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%,那么图片长和宽都是原来的一倍,图片大小实际是原来大小的四分之一。