update docs

README.md

@@ -113,6 +113,7 @@ bin\demo1
 * [AWTK中的资源管理器](docs/resource_manager.md)
 * [AWTK中的窗口动画](docs/window_animator.md)
 * [AWTK中的控件动画](docs/widget_animator.md)
+# [LCD旋转(横屏与竖屏)](docs/lcd_rotation.md)
 
 ### 2.HowTos
 * [如何在非GUI线程操作GUI控件](docs/how_to_non_gui_thread_operate_widget.md)

docs/lcd_rotation.md

@@ -0,0 +1,73 @@
+## 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和手机应用程序，目前还没有需求，暂未支持。
+
+
+
+