Android中的Drawable资源—— ClipDrawable

ClipDrawable是通过设置一个Drawable的当前显示比例来裁剪出另一张Drawable，你可以通过调节这个比例来控制裁剪的宽高，以及裁剪内容占整个容器的权重，通过ClipDrawable的setLevel()方法调节显示比例可以实现类似Progress进度条的效果。ClipDrawable的level值范围在[0,10000]，level的值越大裁剪的内容越少，如果level为10000时则完全显示。

存放位置：res/drawable/

使用方式：
在Java文件中：R.drawable.filename

在xml布局文件中：@[package:]drawable/filename

语法：

<?xml version="1.0" encoding="utf-8"?>
<clip
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/drawable_resource"
    android:clipOrientation=["horizontal" | "vertical"]
    android:gravity=["top" | "bottom" | "left" | "right" | "center_vertical" |
                     "fill_vertical" | "center_horizontal" | "fill_horizontal" |
                     "center" | "fill" | "clip_vertical" | "clip_horizontal"] />

1、android:drawable Drawable资源。 必须。表示该ClipDrawable引用的drawable资源。

2、android:clipOrientation 裁剪的方向。 horizontal:水平方向 vertical:垂直方向

3、android:gravity 指定从哪个地方裁剪。必须是下面一个或多个值（多个值之间用”|”分隔）

• top 将这个对象放在容器的顶部，不改变其大小，当clipOrientation 是”vertical”，从底部(bottom)开始裁剪
• bottom 将这个对象放在容器的底部，不改变其大小。当clipOrientation 是 “vertical”，从顶部(top)开始裁剪
• left 将这个对象放在容器的左部，不改变其大小。当clipOrientation 是 “horizontal”，从右边（right）开始裁剪。这也是默认情况。left 将这个对象放在容器的左部，不改变其大小。当clipOrientation 是 “horizontal”，从右边（right）开始裁剪。这也是默认情况。
• right 将这个对象放在容器的右部，不改变其大小。当clipOrientation 是 “horizontal”，从左边（left）开始裁剪。
• center_vertical 将对象放在垂直中间，不改变其大小。裁剪的情况和”center“一样。
• fill_vertical 垂直方向上不发生裁剪。（除非drawable的level是 0，才会不可见，表示全部裁剪完）
• center_horizontal 将对象放在水平中间，不改变其大小。裁剪的情况和”center“一样。
• fill_horizontal 水平方向上不发生裁剪。（除非drawable的level是 0，才会不可见，表示全部裁剪完）
• center 将这个对象放在水平垂直坐标的中间，不改变其大小。当clipOrientation 是 “horizontal”裁剪发生在左右。当clipOrientation是”vertical”,裁剪发生在上下。
• fill 填充整个容器，不会发生裁剪。(除非drawable的level是 0，才会不可见，表示全部裁剪完)。
• clip_vertical 额外的选项，它能够把它的容器的上下边界，设置为子对象的上下边缘的裁剪边界。裁剪要基于对象垂直重力设置：如果重力设置为top，则裁剪下边，如果设置为bottom，则裁剪上边，否则则上下两边都要裁剪。
• clip_horizontal 额外的选项，它能够把它的容器的左右边界，设置为子对象的左右边缘的裁剪边界。裁剪要基于对象垂直重力设置：如果重力设置为right，则裁剪左边，如果设置为left，则裁剪右边，否则则左右两边都要裁剪。

android:gravity需要和android:clipOrientation配合使用，不同的组合，裁剪的效果也不同。

例如：

<?xml version="1.0" encoding="utf-8"?>
<clip xmlns:android="http://schemas.android.com/apk/res/android" android:drawable="@drawable/android" android:clipOrientation="horizontal" android:gravity="left" />

<ImageView  android:id="@+id/image" android:background="@drawable/clip" android:layout_height="wrap_content" android:layout_width="wrap_content" />

ImageView imageview = (ImageView) findViewById(R.id.image);
ClipDrawable drawable = (ClipDrawable) imageview.getDrawable();
drawable.setLevel(drawable.getLevel() + 1000);