awtk/docs/lcd_rotation.md

## LCD旋转(横屏与竖屏)

有时开发板上接的LCD方向和我们需要的不同，比如LCD缺省是横屏显示的，但我们需要竖屏的效果。如果无法通过修改硬件来实现旋转，就只能用软件来实现了。AWKT目前对双帧缓冲的情况有完善的支持，对基于寄存器的LCD需要在驱动中进行配置。

> 旋转最好由硬件或驱动来做，否则性能会有大弧度下降。本文档提供的方案，主要用于开发前期使用。

### 一、使用方法

1.首先在初始化时，用tk\_init指定LCD的大小(这里LCD的大小是实际大小，不是旋转之后的大小)。

```
/**
 * @method tk_init
 * 初始化TK。
 * @global
 * @scriptable no
 * @param {wh_t} w LCD宽度。
 * @param {wh_t} h LCD高度。
 *
 * @return {ret_t} 返回RET_OK表示成功，否则表示失败。
 */
ret_t tk_init(wh_t w, wh_t h);
```

2.然后用tk\_set\_lcd\_orientation来设置LCD的旋转角度。

```
/**
 * @method tk_set_lcd_orientation
 * 设置屏幕的旋转方向(XXX:目前仅支持0度和90度)。
 * @global
 *
 * @return {ret_t} 返回RET_OK表示成功，否则表示失败。
 */
ret_t tk_set_lcd_orientation(lcd_orientation_t orientation);
```

> 参考：demos/demo_main.c

_____

AWTK目前支持3种LCD实现方式，不同的实现方式对旋转的支持有所不同，下面我们一一介绍。

### 二、基于寄存器的LCD(lcd\_reg)

基于寄存器的LCD(lcd\_reg)，调用tk\_set\_lcd\_orientation只是做了两件事：

* 1.对触摸事件的坐标进行转换。

* 2.设置窗口管理器的大小为旋转之后的大小。

一般的LCD器件可以在驱动中设置像素的扫描顺序，在初始化时设置一下即可(驱动我不太熟悉，没有测试过)，所以AWTK并没有对像素进行相应旋转。

> 参考：http://www.cnblogs.com/amanlikethis/p/3872515.html

### 二、基于FrameBuffer的LCD(lcd\_mem)

基于FrameBuffer的LCD(lcd\_mem)，AWTK对旋转90度做了支持。调用tk\_set\_lcd\_orientation后AWTK会做以下几件事：


* 1.对触摸事件的坐标进行转换。

* 2.设置窗口管理器的大小为旋转之后的大小。

* 3.offline fb为旋转之后的大小，online fb为原始大小。在lcd flush时需要进行旋转(在没有硬件旋转减速的情况下，会增加一点性能开销)。

* 4.在进行平移窗口动画时。AWTK将图片直接贴到online fb上，处于性能的考虑，在截图时进行旋转，在贴图时直接拷贝。所以在lcd\_mem\_draw\_image和lcd\_mem\_take\_snapshot两个函数中做了处理。

### 三、基于VGCanvas的LCD(lcd\_vgcanvas)

基于VGCanvas的LCD(lcd\_vgcanvas)主要用于PC和手机应用程序，目前还没有需求，暂未支持。