# 如何使用 packed 图片

## 1. 介绍

有时我们把多张小图片打包成一张大图片，这种做法在游戏行业和串口屏经常使用。这样做有以下几个原因：

* 美术做图方便。

* 现存的资源就是这样，懒得去切图。

* 在有 GPU 的时候，可以在一定程度提高性能。

最新的 AWTK 对 packed 图片提供了支持。本文介绍一下如何使用 packed 的图片。

## 2. 如何指定 packed 图片中的子图

在 style 中指定图片名称时，用#分隔图片名称和子图区域。指定子图区域的方式有以下几种：

* 空字符串。表示使用控件当前的 xywh 来决定子图的位置和大小。如：

```
<pressed    bg_image="image_packed_fg#"/>
```

> 如果当前控件的区域是 (10, 20, 30, 40)，那么子图的区域也是 (10, 20, 30, 40)。

* g。表示使用控件当前的 xywh 来决定子图的位置和大小，xy 转换成全局坐标。如：

```
<pressed    bg_image="image_packed_fg#g"/>
```

> 如果当前控件的区域是 (10, 20, 30, 40)，相对于窗口的坐标是 50, 60，那么子图的区域就是 (50, 60, 30, 40)。

* xywh(x,y,w,h) 指定子图的绝对坐标。如：

```
 <pressed    bg_image="image_packed_fg#xywh(106,0,106,54)"/>
```
> 那么子图的区域就是 (106,0,106,54) 

* grid(rows,cols,row,col) 将图片划分为 rows 行 cols 列等大小的网格。row 和 col 指定使用哪一格的子图。如：

```
<pressed    bg_image="image_packed_fg#grid(4,3,0,2)"/
```

> 如果图片大小是 80x60，那么子图的区域就是 (40,0,20,20) 

## 3. 示例

这里有两张图片：

* 正常时的效果

![](../design/default/images/xx/image_packed_bg.jpg)

* 按下时的效果

![](../design/default/images/xx/image_packed_fg.jpg)

> 两张图看起来有些相近，第二张是把第一张调暗后得到的，不过运行起来后按下效果很明显的。

### 3.1 UI 文件

```xml<window>
<window>
  <view style="image_packed" x="c" y="m" w="320" h="216" children_layout="default(r=4,c=3)">
    <button style="num_1"/>
    <button style="num_2"/>
    <button style="num_3"/>
    <button style="num_4"/>
    <button style="num_5"/>
    <button style="num_6"/>
    <button style="num_7"/>
    <button style="num_8"/>
    <button style="num_9"/>
    <button style="dot"/>
    <button style="num_0"/>
    <button style="backspace"/>
  </view>
</window>
```

### 3.2 Style 文件

* 使用第一张图为 view 的背景图。按钮在正常情况什么都不用显示。

* 按钮在 pressed 状态下背景用指定区域的图片。

* 本例子演示来各种用法。通常使用缺省用法即可：

```
	<pressed bg_image="image_packed_fg#" />
```

```xml
<button>
	<style name="num_1">
		<normal />
		<pressed bg_image="image_packed_fg#xywh(0,0,106,54)" />
	</style>
	<style name="num_2">
		<normal />
		<pressed bg_image="image_packed_fg#xywh(106,0,106,54)" />
	</style>
	<style name="num_3">
		<normal />
		<pressed bg_image="image_packed_fg#grid(4,3,0,2)" />
	</style>
	<style name="num_4">
		<normal />
		<pressed bg_image="image_packed_fg#grid(4,3,1,0)" />
	</style>
	<style name="num_5">
		<normal />
		<pressed bg_image="image_packed_fg#grid(4,3,1,1)" />
	</style>
	<style name="num_6">
		<normal />
		<pressed bg_image="image_packed_fg#grid(4,3,1,2)" />
	</style>
	<style name="num_7">
		<normal />
		<pressed bg_image="image_packed_fg#grid(4,3,2,0)" />
	</style>
	<style name="num_8">
		<normal />
		<pressed bg_image="image_packed_fg#grid(4,3,2,1)" />
	</style>
	<style name="num_9">
		<normal />
		<pressed bg_image="image_packed_fg#grid(4,3,2,2)" />
	</style>
	<style name="dot">
		<normal />
		<pressed bg_image="image_packed_fg#" />
	</style>
	<style name="num_0">
		<normal />
		<pressed bg_image="image_packed_fg#" />
	</style>
	<style name="backspace">
		<normal />
		<pressed bg_image="image_packed_fg#" />
	</style>
</button>
<view>
	<style name="image_packed">
		<normal bg_image="image_packed_bg" />
	</style>
</view>
```

### 3.3 运行示例

```
./bin/preview_ui design/default/ui/image_packed.xml
```

## 4. 限制

* 目前只能在 style 中使用。

* draw\_type 只支持 default|scale|center|icon 等几种。