Overview

PathDrawable is a Drawable that draws simple shapes using Path object.

It uses extremely simplified SVG data format used in <path> tag for d attribute, see here for more info.

You can create PathDrawable object in two ways: in xml file or by API calls.

XML file format is pretty simple: <layers> must be the root tag. It must contain one or more <layer> tags.

Attributes

<layers> tag attributes:

• path_width (format="float") - path bounds width (required)
• path_height (format="float") - path bounds height (required)
• android:background - background drawable, see android:background attr
• android:padding - drawable padding
• scale_type - scale type for layer scaling (defaults to fill), must be one of the following constant values:

• fill
• start
• center
• end

<layer> tag attributes:

• android:tag (format="string") - layer tag, used with PathDrawable.findLayerByTag(Object) to get the layer with given tag
• data (format="string") - path data (required)
• stroke_color (format="color") - stroke color (defaults to #fff)
• stroke_width (format="dimension") - stroke width (defaults to 1)
• stroke_style - path stroke style (defaults to stroke), must be one or more (separated by '|') of the following constant values:

• stroke
• fill

• cap_type - path cap type (defaults to square), must be one of the following constant values:

• butt
• round
• square

Samples

The sample xml file:

<?xml version="1.0" encoding="utf-8"?>
<layers xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/apk/res-auto"
    tools:path_width="32" tools:path_height="32"
    android:background="#ed0"
>
    <layer android:tag="layer0"
	    tools:data="M 32,32 L 32,0 C 15.540043,29.087754 4.2291386,12.026918 0,32 C 5.0306191,31.989233 32,32 32,32 z"
        tools:stroke_color="#a500c200"
        tools:stroke_style="fill"
    />
    <layer android:tag="layer1"
        tools:data="M 0,0 L 32,0 C 32,0 29.59354,13.827725 21.59354,21.827725 C 13.59354,29.827725 0,32 0,32 z"
        tools:stroke_color="#a8c50000"
        tools:stroke_style="fill"
   />
</layers>

Typical usage:

View view = ...;
// create a new PathDrawable from res/xml/square.xml
PathDrawable pd = new PathDrawable(context, R.xml.square);
view.setBackgroundDrawable(pd);

or:

View view = ...;
// create a new PathDrawable 
PathDrawable pd = new PathDrawable(32, 32);
String data = "M 2,2 L 30,2 L 30,30 L 2,30 z";
pd.addLayer(data, 0xff00ff00, 5, Style.STROKE, Cap.ROUND);
view.setBackgroundDrawable(pd);

or you can directly add your PathDrawable xml definition in the layout file using

app:xml_drawable="@xml/..."

attribute, see static_layout.xml and StaticPathDrawable.java for details.

Snapshot of some PathDrawables:

Thank you.