MTK 层的基础知识笔记

1.      gdi_layer_clear （） ---- 将整个层刷成单一颜色（层激活后要立即执行）。

2.      gdi_layer_set_source_key （） ----- 将某一颜色设为层的通透色，在层合并的时候，系统会自动将层与通透色相同的颜色忽略掉（就是说这一点上看到的是底下层的颜色） gdi_layer_set_source_key(TRUE,GDI_COLOR_BLUE);

3.      gdi_layer_create(20,20,136,130, &my_layer);---- 用来创建层，其前四个参数指出层的位置及大小（位置是以实际屏幕左上角为原点的），最后一个参数时刚创建的层句柄地址，用以返回所创建的层。（要注意一点的是，应为创建层时系统要为其分配动态内存空间，而系统保留的内存一般只够创建一个 UI_device_width * UI_device_height 大小的层，所以如果调用 gdi_layer_create 时内存不足系统就会 ASSERT 。解决的办法是使用函数 gdi_layer_create_using_outside_memeory, 即自己申请内存，然后作为参数传进去创建层。 ）

4.    gdi_layer_set_active(my_layer);---- 任何时刻有且只能有一个层处于激活状态，所有的绘画函数都是默认画到这个层中（激活层中），所以想要在层上绘画必须先将其激活。创建层并不会自动激活，需要手动将其激活。 不过，由于在多层的处理中需要在各个层之间切换激活，所以我们经常用到的是 gdi_layer_push_and_set_active(gdi_handle handle) ，此函数会把当前的激活层入栈而激活参数层，等到下次需要激活栈中的层时，只需要用函数 gdi_layer_pop_and_restore_active() 激活就可以了。

5.    gdi_layer_get_base_handle(&base_layer);---- 获取基础层 

    gdi_layer_set_active(base_layer);// 主动将基础层还原为激活状态

    gui_BLT_double_buffer(0,0,UI_device_width -1, UI_device_height -1);

6.    gui_BLT_double_buffer （）---- 用来合并层，但在使用之前先得用gdi_layer_set_blt_layer(base_layer,my_laye,NULL,NULL); 指明是哪几个层需要合并，函数gui_BLT_double_buffer 能接受四个层句柄，也就是说我们系统同一时刻最多能合并四个层（当然创建的层可以不止这个数）。另外要注意参数的顺序，第一个传入的层是放在最底下的，然后依次往上码。也可以直接用函数gdi_layer_blt_(base_layer,my_laye,NULL,NULL ，0,0,UI_device_width -1, UI_device_height -1); 进行图层合并。效果一样。

7.    gdi_layer_set_clip(40,25, 100, 100); --- 所谓剪切，就是在层中设一个限制区域，只有在这个区域中的绘画才是有效的，否则就会被自动忽略。剪切特效有两个特点：1 ，每个层一定有而且只能有一个剪切区域。2 ，剪切区域一经设置，永久生效。所有剪切区域用完后最后用gdi_layer_reset_clip 还原（如不还原则有可能什么东西都画不上来）。

8.    gdi_layer_set_opacity(TRUE, 128); 第一个参数指明要不要开启半透明效果，第二个参数是透明度的取值，范围从0 至255 ，值越小表示透明度越高，当取值为0 时就会完全被透掉，255 即完全不透明。

9.    gdi_layer_free(my_layer);--- 创建层需要为其分配内层空间，所以层用完后也要手动将其释放（切记一定要释放，否则别的程序就无法创建层了）：

10. gui_lock_double_buffer(); 和gui_unlock_double_buffer(); 锁屏

11. gdi_layer_clear_background(GDI_COLOR_RED); // 把背景全刷成红色

12. 剪切区的使用：使用顺序：

        gui_push_clip();// 保存剪切区

       gui_set_clip(0, 0, MEEPOMENU_TEMP_LAYER_WIDTH - 1, MEEPOMENU_TEMP_LAYER_HEIGHT - 1);// 设置剪切区

       gui_pop_clip();// 回复剪切区

代码使用样例：

     gui_lock_double_buffer();// 锁屏

    gui_push_clip();// 保存当前剪切区

    gdi_layer_push_and_set_active(MeepoMenu_temp_layer_prev);// 保存当前激活层到栈中，并激活参数（ MeepoMenu_temp_layer_prev ）层。

    old_alpha_layer = gdi_image_abm_set_source_layer(MeepoMenu_temp_layer_prev);// 设置图片在此层上通透，并返回之前的通透层

    gdi_layer_set_source_key(TRUE, GDI_COLOR_TRANSPARENT);// 设置通透颜色

    gdi_layer_clear_background(GDI_COLOR_BLACK);// 把背景刷成黑色

    gui_set_clip(0, 0, MEEPOMENU_TEMP_LAYER_WIDTH - 1, MEEPOMENU_TEMP_LAYER_HEIGHT - 1);// 设置剪切区

    GetMeepoMenuPageImg(meepomenu_page_prev, &img_id, &str_id);// 获取要绘制的图片的 id

     gui_show_image(0, 0, (PU8) GetImage((U16) (img_id)));

    gui_show_image(0, 0, (PU8) GetImage((U16) (str_id)));

    gdi_layer_pop_and_restore_active();// 从栈中弹出之前保存的激活层，并激活

    if (old_alpha_layer)

    {

        gdi_image_abm_set_source_layer(old_alpha_layer);// 重新设置通透层

    }

    gui_pop_clip();// 弹出之前保存的剪切区

    gui_unlock_double_buffer();// 解锁