[Android/안드로이드] Drawable 에 대한 모든 것.

---

http://developer.android.com/guide/topics/resources/drawable-resource.html 

Bitmap Drawable

 * .png, .jpg, .gif 를 지원하며 xml 로 정의하는 동시에 여러가지 부가적인 속성을 줄 수 있다. 참고로 res/raw 폴더에 들어가지 않은 이미지는 aapt 에 의해 same quality but less memory 가 되도록 optimize 될 수 있다.

<Syntax>

<?xml version="1.0" encoding="utf-8"?>

<bitmap

    xmlns:android="http://schemas.android.com/apk/res/android"

    android:src="@[package:]drawable/drawable_resource"

    android:antialias=["true" | "false"]

    android:dither=["true" | "false"]

    android:filter=["true" | "false"]

    android:gravity=["top" | "bottom" | "left" | "right" | "center_vertical" |

                      "fill_vertical" | "center_horizontal" | "fill_horizontal" |

                      "center" | "fill" | "clip_vertical" | "clip_horizontal"]

    android:tileMode=["disabled" | "clamp" | "repeat" | "mirror"] />

<Example>

<?xml version="1.0" encoding="utf-8"?>

<bitmap xmlns:android="http://schemas.android.com/apk/res/android"

    android:src="@drawable/icon"

    android:tileMode="repeat" />

 
 
 

Nine-patch Drawable

<Syntax>

<?xml version="1.0" encoding="utf-8"?>

<nine-patch

    xmlns:android="http://schemas.android.com/apk/res/android"

    android:src="@[package:]drawable/drawable_resource"

    android:dither=["true" | "false"] />

<Example>

<?xml version="1.0" encoding="utf-8"?>

<nine-patch xmlns:android="http://schemas.android.com/apk/res/android"

    android:src="@drawable/myninepatch"

    android:dither="false" />

Layer List

 * 여러개의 drawable 을 array 로 관리하는 drawable list 라고 보면 된다. 정의된 순서대로 그려준다. 즉 마지막에 정의된 녀석이 가장 Top 에 그려진다. 속성의 top, right 등은 offset 이다.

<Syntax>

<?xml version="1.0" encoding="utf-8"?>

<layer-list

    xmlns:android="http://schemas.android.com/apk/res/android" >

    <item

        android:drawable="@[package:]drawable/drawable_resource"

        android:id="@[+][package:]id/resource_name"

        android:top="dimension"

        android:right="dimension"

        android:bottom="dimension"

        android:left="dimension" />

</layer-list>

<Example>

<?xml version="1.0" encoding="utf-8"?>

<layer-list xmlns:android="http://schemas.android.com/apk/res/android">

    <item>

      <bitmap android:src="@drawable/android_red"

        android:gravity="center" />

    </item>

    <item android:top="10dp" android:left="10dp">

      <bitmap android:src="@drawable/android_green"

        android:gravity="center" />

    </item>

    <item android:top="20dp" android:left="20dp">

      <bitmap android:src="@drawable/android_blue"

        android:gravity="center" />

    </item>

</layer-list>

 

State List

 * object 의 state 에 따른 drawable mapping 을 관리하는 list.

<Syntax>

<?xml version="1.0" encoding="utf-8"?>

<selector xmlns:android="http://schemas.android.com/apk/res/android"

    android:constantSize=["true" | "false"]

    android:dither=["true" | "false"]

    android:variablePadding=["true" | "false"] >

    <item

        android:drawable="@[package:]drawable/drawable_resource"

        android:state_pressed=["true" | "false"]

        android:state_focused=["true" | "false"]

        android:state_hovered=["true" | "false"]

        android:state_selected=["true" | "false"]

        android:state_checkable=["true" | "false"]

        android:state_checked=["true" | "false"]

        android:state_enabled=["true" | "false"]

        android:state_activated=["true" | "false"]

        android:state_window_focused=["true" | "false"] />

</selector>

 
<Example>

<?xml version="1.0" encoding="utf-8"?>

<selector xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:state_pressed="true"

          android:drawable="@drawable/button_pressed" /> <!-- pressed -->

    <item android:state_focused="true"

          android:drawable="@drawable/button_focused" /> <!-- focused -->

    <item android:state_hovered="true"

          android:drawable="@drawable/button_focused" /> <!-- hovered -->

    <item android:drawable="@drawable/button_normal" /> <!-- default -->

</selector>

 

Level List

 * 대체가능한 drawable 들을 list 형태로 가지고 있는 drawable. android:maxLevel 과 android:minLevel 이라는 property 를 설정할 수 있고, 코드에서 setLevel() 또는 setImageLevel() 이 call 되면 level 에 mapping 되는 녀석의 drawable 을 보여준다. 정확한 match 가 안 될때에는 level 보다 낮은 maxLevel 값을 찾아 mapping 한다. 예를 들어 maxLevel 이 10, 15 인 drawable 2개가 있는데, setLevel 이 12 라면, maxLevel 10 인 녀석의 drawable 을 보여준다.

<Syntax>

<?xml version="1.0" encoding="utf-8"?>

<level-list

    xmlns:android="http://schemas.android.com/apk/res/android" >

    <item

        android:drawable="@drawable/drawable_resource"

        android:maxLevel="integer"

        android:minLevel="integer" />

</level-list>

 

<Example>

<?xml version="1.0" encoding="utf-8"?>

<level-list xmlns:android="http://schemas.android.com/apk/res/android" >

    <item

        android:drawable="@drawable/status_off"

        android:maxLevel="0" />

    <item

        android:drawable="@drawable/status_on"

        android:maxLevel="1" />

</level-list>

 

Transition Drawable

 * 2개의 drawable 을 설정하고 fade 효과를 줄 수 있는 drawable 이다. startTransition() 과 reverseTransition() 을 통해 transition 효과를 준다.

<Syntax>

<?xml version="1.0" encoding="utf-8"?>

<transition

xmlns:android="http://schemas.android.com/apk/res/android" >

    <item

        android:drawable="@[package:]drawable/drawable_resource"

        android:id="@[+][package:]id/resource_name"

        android:top="dimension"

        android:right="dimension"

        android:bottom="dimension"

        android:left="dimension" />

</transition>

 
<Example>

<?xml version="1.0" encoding="utf-8"?>

<transition xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:drawable="@drawable/on" />

    <item android:drawable="@drawable/off" />

</transition>

 

Inset Drawable

 * 특정 거리를 두고 그린 drawable. View 의 실제 bound 보다 더 작은 drawable 을 사용할 때 유용하다.

<Syntax>

<?xml version="1.0" encoding="utf-8"?>

<inset

    xmlns:android="http://schemas.android.com/apk/res/android"

    android:drawable="@drawable/drawable_resource"

    android:insetTop="dimension"

    android:insetRight="dimension"

    android:insetBottom="dimension"

    android:insetLeft="dimension" />

 

<Example>

<?xml version="1.0" encoding="utf-8"?>

<inset xmlns:android="http://schemas.android.com/apk/res/android"

    android:drawable="@drawable/background"

    android:insetTop="10dp"

    android:insetLeft="10dp" />

 

Clip Drawable

 * Drawable 을 level 에 맞게 clip 하는 것. setLevel() 을 통해 level 설정 가능하다.

<Syntax>

<?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"] />

<Example>

<?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" />

 

Scale Drawable

 * Level 값으로 scale 하는 drawable.

<Syntax>

<?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" />

 
<Example>

<?xml version="1.0" encoding="utf-8"?>

<scale xmlns:android="http://schemas.android.com/apk/res/android"

    android:drawable="@drawable/logo"

    android:scaleGravity="center_vertical|center_horizontal"

    android:scaleHeight="80%"

    android:scaleWidth="80%" />

 

Shape Drawable

<Syntax>

<?xml version="1.0" encoding="utf-8"?>

<shape

    xmlns:android="http://schemas.android.com/apk/res/android"

    android:shape=["rectangle" | "oval" | "line" | "ring"] >

    <corners

        android:radius="integer"

        android:topLeftRadius="integer"

        android:topRightRadius="integer"

        android:bottomLeftRadius="integer"

        android:bottomRightRadius="integer" />

    <gradient

        android:angle="integer"

        android:centerX="integer"

        android:centerY="integer"

        android:centerColor="integer"

        android:endColor="color"

        android:gradientRadius="integer"

        android:startColor="color"

        android:type=["linear" | "radial" | "sweep"]

        android:useLevel=["true" | "false"] />

    <padding

        android:left="integer"

        android:top="integer"

        android:right="integer"

        android:bottom="integer" />

    <size

        android:width="integer"

        android:height="integer" />

    <solid

        android:color="color" />

    <stroke

        android:width="integer"

        android:color="color"

        android:dashWidth="integer"

        android:dashGap="integer" />

</shape>

 

<Example>

<?xml version="1.0" encoding="utf-8"?>

<shape xmlns:android="http://schemas.android.com/apk/res/android"

    android:shape="rectangle">

    <gradient

        android:startColor="#FFFF0000"

        android:endColor="#80FF00FF"

        android:angle="45"/>

    <padding android:left="7dp"

        android:top="7dp"

        android:right="7dp"

        android:bottom="7dp" />

    <corners android:radius="8dp" />

</shape>