vector_xml属性

vector_xml属性

矢量图形对应的XML文件定义在res/drawable下，在XML文件中的根标签是vector。

矢量图形的xml文件支持以下标签：

vector：根标签，表示一个矢量动画。矢量图形对应的Java类是VectorDrawable。VectorDrawable没有提供setPathData之类的方法，所以我们只能在XML内定义矢量图形。vector标签下支持0个或多个group标签，表示一组路径的集合，在group内定义一个或多个path标签，定义要被绘制的路径，也可以不加group，直接在vector下定义一个或多个path标签，group/path标签下还支持clip-path标签。

vector支持的属性：

1）android:name：定义矢量图形的名称

2）android:width：定义Drawable的宽度，支持所有dimension单位，一般使用dp。drawable的宽度不一定是最终绘制宽度，比如给ImageView设置backgroud则Drawable绘制宽度等于ImageView的宽度，给ImageView设置src则在ImageView大于Drawable宽度时，Drawable绘制宽度等于自己定义的宽度。

3）android:height：定义Drawable的宽度，支持所有dimension单位，一般是dp。其它同上。

4）android:viewportWidth：定义矢量图形的视图(viewport)空间的宽度，viewport是一个虚拟的canvas，后面所有的path都在该坐标系上绘制。坐标系左上方为(0,0)，横轴从左向右，纵轴从上到下。横轴可视区域就是0~viewportWidth。不用写单位。

5）android:viewportHeight：定义矢量图形的可视区域的高度。其它见上。[0,0]~[viewportWidth,viewportHeight]定义了虚拟canvas的可视区域。不用写单位。

6）android:tint：作为染色(tint)的色彩应用到drawable上。默认不应用tint。

7）android:tintMode：tint颜色的Porter-Duff混合模式，默认是src_in。

8）android:autoMirrored：如果drawable布局方向是RTL(right-to-left)时，drawable绘制是否需要镜像化（镜像化就是绕自身x轴中线旋转180度）。

9）android:alpha：drawble的透明度，取值0～1

group：

定义一组路径和子group，另外还定义了转换信息(transformation information)。转换信息定义在vector指定的视图区域内（与viewport坐标系相同）。定义的应用转换的顺序是缩放–>旋转–>平移，所以同时定义的这些属性最先应用scaleX/scaleY属性，最后应用translateX/translateY属性。

group支持的属性：

1）android:name：定义group的名称

2）android:rotation：group对应矢量图形的旋转角度，取值是360度制。

3）android:pivotX：Group旋转和缩放时的中心点的X轴坐标。取值基于viewport视图的坐标系，不能使用百分比。

4）android:pivotY：Group旋转和缩放时的中心点的Y轴坐标。取值基于viewport视图的坐标系，不能使用百分比。

5）android:scaleX：Group在X轴上的缩放比例，最先应用到图形上。

6）android:scaleY：Group在Y轴上的缩放比例，最先应用到图形上。

7）android:translateX：Group在X轴的平移距离，取值基于viewport视图的坐标系。最后应用到图形上。

8）android:translateY：Group在Y轴的平移距离，取值基于viewport视图的坐标系。最后应用到图形上。

path：

定义一个路径，一个路径即可以表示一块填充区域也可以表示一根线条。

path支持的属性：

1）android:name：定义路径的名称

2）android:pathData：定义路径的数据，路径由多条命令组成，格式与SVG标准的path data的d属性完全相同，路径命令的参数定义在viewport视图的坐标系。

3）android:fillColor：指定填充路径的颜色，一般是一个颜色值，在SDK24及以上，可以指定一个颜色状态列表或者一个渐变的颜色。如果在此属性上做渐变动画，新的属性值会覆盖此值。如果不指定，则path不被填充。

4）android:strokeColor：指定路径线条的颜色，一般是一个颜色值，在SDK24及以上，可以指定一个颜色状态列表或者一个渐变的颜色。如果在此属性上做渐变动画，新的属性值会覆盖此值。如果不指定，则path的线条不会绘制出来。

5）android:strokeWidth：指定路径线条的宽度，基于viewport视图的坐标系（不要dp/px之类的结尾）。

6）android:strokeAlpha：指定路径线条的透明度。

7）android:fillAlpha：指定填充区域的透明度。

8）android:trimPathStart：取值从0到1，表示路径从哪里开始绘制。0~trimPathStart区间的路径不会被绘制出来。

9）android:trimPathEnd：取值从0到1，表示路径绘制到哪里。trimPathEnd~1区间的路径不会被绘制出来。

10）android:trimPathOffset：平移可绘制区域，取值从0到1，线条从(trimPathOffset+trimPathStart绘制到trimPathOffset+trimPathEnd)，注意：trimPathOffset+trimPathEnd如果超过1，其实也是绘制的的，绘制的是0～trimPathOffset+trimPathEnd-1的位置。

11）android:strokeLineCap：设置线条首尾的外观，三个值：butt（默认，向线条的每个末端添加平直的边缘）, round（向线条的每个末端添加圆形线帽）, square（向线条的每个末端添加正方形线帽。）。

12）android:strokeLineJoin：设置当两条线条交汇时，创建什么样的边角（线段连接类型）：三个值：miter（默认，创建尖角）,round（创建圆角）,bevel（创建斜角） 。

13）android:strokeMiterLimit：设置设置最大斜接长度，斜接长度指的是在两条线交汇处内角和外角之间的距离。只有当 lineJoin 属性为 “miter” 时，miterLimit 才有效。

14）android:fillType：**设置路径的填充类型，与SVG格式的”fill-rule”属性相同。

clip-path：

定义当前裁切的路径。裁切路径只能用于当前group和其子元素，只有在裁切路径内的元素才会被显示出来。clip-path定义后才会影响后面path的绘制，如果一个group内有多个path，clip-path定义在第三位，则前面两个path不受其影响，后面的path受其影响。如果希望clip-path对整个group都生效，应放在第一位。

clip-path支持的属性：

1）android:name：定义裁切路径的名称

2）android:pathData：定义裁切路径，取值与上面讲的pathData相同。

//VectorDrawableCompat的xml
<vector xmlns:android="http://schemas.android.com/apk/res/android"
    <!-- 图片本身的大小 -->
    android:width="500px"
    android:height="500px"
    <!-- 画布的大小 -->
    android:viewportHeight="500"
    android:viewportWidth="500">
    <!-- 用来把多个path或者subgroup组合起来，group提供了一些属性比如旋转、缩放、平移。这些属性值的变化会反应在它内部的path和subgroup元素上-->
    <group
        android:scaleX="5.0"
        android:scaleY="5.0"
        //图像旋转角度
        android:rotation="45.0">
        <!-- 这里group和path有一个name属性，这个属性用来在使用动画时指定动画要驱动的对象 -->
        <path
            android:name="star"
            android:pathData="M 50.0,90.0 L 82.9193546357,27.2774101308 L"
            android:strokeColor="@color/colorAccent"
            android:strokeWidth="2" />
    </group>
</vector>

//定义AnimatedVectorDrawableCompat的xml
<?xml version="1.0" encoding="utf-8"?>
<animated-vector xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/vector_drawable">
    <target
        android:name="star"
        android:animation="@animator/star_anim" />
</animated-vector>

根元素是animated-vector，并且有一个必须的属性android:drawable用来指定要驱动的矢量图对象。子标签target一方面用来指定要驱动的矢量图内的group和path的名称(这里和VectorDrawableCompat的xml中的group和path名称对应)；另一方面指定要使用哪个属性动画来驱动group和path的属性进行变化来产生动画效果。