开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > MTK > 查看源码
gui.h
资源名称：mmi.rar　[点击查看]
上传用户：lqx1163
上传日期：2014-08-13
资源大小：9183k
文件大小：43k
源码类别：

MTK

开发平台：

C/C++

gui.h：源码内容
  1. /*****************************************************************************
  2. *  Copyright Statement:
  3. *  --------------------
  4. *  This software is protected by Copyright and the information contained
  5. *  herein is confidential. The software may not be copied and the information
  6. *  contained herein may not be used or disclosed except with the written
  7. *  permission of MediaTek Inc. (C) 2005
  8. *
  9. *  BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
  10. *  THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK SOFTWARE")
  11. *  RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON
  12. *  AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES,
  13. *  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
  14. *  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
  15. *  NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
  16. *  SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
  17. *  SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH
  18. *  THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO
  19. *  NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S
  20. *  SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM.
  21. *
  22. *  BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE
  23. *  LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
  24. *  AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE,
  25. *  OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO
  26. *  MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE. 
  27. *
  28. *  THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE
  29. *  WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF
  30. *  LAWS PRINCIPLES.  ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND
  31. *  RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER
  32. *  THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC).
  33. *
  34. *****************************************************************************/
  36. /*****************************************************************************
  37.  *
  38.  * Filename:
  39.  * ---------
  40.  *   gui.h
  41.  *
  42.  * Project:
  43.  * --------
  44.  *   MAUI
  45.  *
  46.  * Description:
  47.  * ------------
  48.  *   Primitive UI variables & wrappers
  49.  *
  50.  * Author:
  51.  * -------
  52.  * -------
  53.  * -------
  54.  * -------
  55.  *
  56.  *==============================================================================
  57.  *             HISTORY
  58.  * Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
  59.  *------------------------------------------------------------------------------
  60.  * removed!
  61.  *
  62.  * removed!
  63.  * removed!
  64.  * removed!
  65.  *
  66.  * removed!
  67.  * removed!
  68.  * removed!
  69.  *
  70.  * removed!
  71.  * removed!
  72.  * removed!
  73.  *
  74.  * removed!
  75.  * removed!
  76.  * removed!
  77.  *
  78.  * removed!
  79.  * removed!
  80.  * removed!
  81.  *
  82.  * removed!
  83.  * removed!
  84.  * removed!
  85.  *
  86.  * removed!
  87.  * removed!
  88.  * removed!
  89.  *
  90.  * removed!
  91.  * removed!
  92.  * removed!
  93.  *
  94.  * removed!
  95.  * removed!
  96.  * removed!
  97.  *
  98.  * removed!
  99.  * removed!
  100.  * removed!
  101.  *
  102.  * removed!
  103.  * removed!
  104.  * removed!
  105.  *
  106.  * removed!
  107.  * removed!
  108.  * removed!
  109.  *
  110.  * removed!
  111.  * removed!
  112.  * removed!
  113.  *
  114.  * removed!
  115.  * removed!
  116.  * removed!
  117.  *
  118.  * removed!
  119.  * removed!
  120.  * removed!
  121.  *
  122.  * removed!
  123.  * removed!
  124.  * removed!
  125.  *
  126.  * removed!
  127.  * removed!
  128.  * removed!
  129.  *
  130.  * removed!
  131.  * removed!
  132.  * removed!
  133.  *
  134.  * removed!
  135.  * removed!
  136.  * removed!
  137.  *
  138.  * removed!
  139.  * removed!
  140.  * removed!
  141.  *
  142.  * removed!
  143.  * removed!
  144.  * removed!
  145.  *
  146.  * removed!
  147.  * removed!
  148.  * removed!
  149.  *
  150.  * removed!
  151.  * removed!
  152.  * removed!
  153.  *
  154.  * removed!
  155.  * removed!
  156.  * removed!
  157.  *
  158.  *------------------------------------------------------------------------------
  159.  * Upper this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
  160.  *==============================================================================
  161.  *******************************************************************************/
  163. /**
  164.  * Copyright Notice
  165.  * ?2002 - 2003, Pixtel Communications, Inc., 1489 43rd Ave. W.,
  166.  * Vancouver, B.C. V6M 4K8 Canada. All Rights Reserved.
  167.  *  (It is illegal to remove this copyright notice from this software or any
  168.  *  portion of it)
  169.  */
  171. /**********************************************************************************
  172.    Filename:      gui.h
  173.    Author:        manju
  174.    Date Created:  August-13-2002
  175.    Contains:      PixTel UI routines header
  176.                Contains several parts and has been split to multiple
  177.                code files. See other files named gui_*.c and gui_*.h
  178.                This file contains common functions and data (prototypes only).
  179. **********************************************************************************/
  181. #ifndef __GUI_H__
  182. #define __GUI_H__
  184. #include "stdC.h"
  185. #include "CustDataRes.h"
  186. #include "gui_config.h"
  187. #include "CustThemesRes.h"
  188. #include "MMI_features.h"
  190. #include "gdi_const.h"
  191. #include "gdi_datatype.h"
  193. #ifdef __cplusplus
  194. extern "C"
  195. {
  196. #endif /* __cplusplus */ 
  198.     /* global device screen size                    */
  199.     extern S32 UI_device_width;
  200.     extern S32 UI_device_height;
  202.     /* UI globals                                */
  203.     extern S32 UI_clip_x1;
  204.     extern S32 UI_clip_y1;
  205.     extern S32 UI_clip_x2;
  206.     extern S32 UI_clip_y2;
  207.     extern S32 UI_old_clip_x1;
  208.     extern S32 UI_old_clip_y1;
  209.     extern S32 UI_old_clip_x2;
  210.     extern S32 UI_old_clip_y2;
  211.     extern S32 UI_text_x;
  212.     extern S32 UI_text_y;
  213.     extern S32 UI_text_height;
  214.     extern S32 UI_pointer_x;
  215.     extern S32 UI_pointer_y;
  216.     extern color UI_text_color;
  217.     extern color UI_text_border_color;
  218.     extern U8 UI_printf_buffer[];
  220.     /* MACRO:   calculates the percentage              */
  221. #define pixtel_percent(x,p)   ((x)*(p)/(100))
  223.     /* MACRO:   toggles a value                        */
  224. #define pixtel_toggle(x)   x=(U8)((x)?0:1)
  226.     /* MACRO:   divides, adds 1 if there is a remainder      */
  227. #define pixtel_highdivide(x,y)   ((((x)%(y))>0)?(((x)/(y))+1):((x)/(y)))
  229.     /* Base functions required by the UI system:    */
  230.     /* All UI components will use these functions      */
  231.     /* And will not directly use any other OS/system   */
  232.     /* related functions.                        */
  234.     extern void (*gui_putpixel) (S32 x, S32 y, color c);
  235.     extern void (*gui_draw_vertical_line) (S32 y1, S32 y2, S32 x, color c);
  236.     /* MTK ISSUE 30 */
  237.     extern void (*gui_draw_vert_line_type) (S32 y1, S32 y2, S32 x, color c, S32 type_line);
  238.     extern void (*gui_draw_hori_line_type) (S32 x1, S32 x2, S32 y, color c, S32 type_line);
  239.     extern void (*gui_draw_rectangle_type) (S32 x1, S32 y1, S32 x2, S32 y2, color c, S32 type_line);
  240.     /* MTK ISSUE 30 END */
  241.     extern void (*gui_draw_horizontal_line) (S32 x1, S32 x2, S32 y, color c);
  242.     extern void (*gui_line) (S32 x1, S32 y1, S32 x2, S32 y2, color c);
  243.     extern void (*gui_wline) (S32 x1, S32 y1, S32 x2, S32 y2, color c, S32 w);
  244.     extern void (*gui_draw_rectangle) (S32 x1, S32 y1, S32 x2, S32 y2, color c);
  245.     extern void (*gui_fill_rectangle) (S32 x1, S32 y1, S32 x2, S32 y2, color c);
  246.     extern void (*gui_cross_hatch_fill_rectangle) (S32 x1, S32 y1, S32 x2, S32 y2, color c);
  247.     extern void (*gui_hatch_fill_rectangle) (S32 x1, S32 y1, S32 x2, S32 y2, color c);
  248.     extern void (*gui_alternate_cross_hatch_fill_rectangle) (S32 x1, S32 y1, S32 x2, S32 y2, color c1, color c2);
  249.     extern void (*gui_alternate_hatch_fill_rectangle) (S32 x1, S32 y1, S32 x2, S32 y2, color c1, color c2);
  251.     extern void (*gui_set_text_clip) (S32 x1, S32 y1, S32 x2, S32 y2);
  252.     extern void (*gui_get_text_clip) (S32 *x1, S32 *y1, S32 *x2, S32 *y2);
  253.     extern void (*gui_set_text_clip_preset) (S32 x1, S32 y1, S32 x2, S32 y2);
  254.     extern void (*gui_set_clip) (S32 x1, S32 y1, S32 x2, S32 y2);
  255.     extern void (*gui_set_clip_with_bounding_box) (S32 x1, S32 y1, S32 x2, S32 y2, S32 bx1, S32 by1, S32 bx2, S32 by2);
  256.     extern void (*gui_get_clip) (S32 *x1, S32 *y1, S32 *x2, S32 *y2);
  257.     extern void (*gui_set_clip_preset) (S32 x1, S32 y1, S32 x2, S32 y2);
  258.     extern void (*gui_reset_clip) (void);
  259.     extern void (*gui_push_text_clip) (void);
  260.     extern void (*gui_pop_text_clip) (void);
  261.     extern void (*gui_push_clip) (void);
  262.     extern void (*gui_pop_clip) (void);
  263.     extern void (*gui_reset_text_clip) (void);
  265.     extern void (*gui_set_line_height) (S32 height);
  266.     extern void (*gui_move_text_cursor) (S32 x, S32 y);
  267.     extern void (*gui_set_text_color) (color c);
  268.     extern void (*gui_set_text_border_color) (color c);
  269.     extern S32(*gui_printf) (const S8 *format, ...);
  270.     extern S32(*gui_sprintf) (UI_string_type _text, const S8 *format, ...);
  271.     extern void (*gui_print_text) (UI_string_type _text);
  272.     /* MTK add to support print n characters */
  273.     extern void (*gui_print_text_n) (UI_string_type _text, int _n);
  274.     extern void (*gui_print_bordered_text_n) (UI_string_type _text, int _n);
  275.     /* MTK end */
  276.     extern void (*gui_print_bordered_text) (UI_string_type _text);
  277.     extern void (*gui_print_character) (UI_character_type _c);
  278.     //MTK Elvis for Thai
  279.     //MTK Elvis for stacked character
  280.     extern void (*gui_print_stacked_character) (UI_character_type _curCh, UI_character_type _pre2Ch,
  281.                                                 UI_character_type _preCh);
  282.     extern void (*gui_print_bordered_stacked_character) (UI_character_type _curCh, UI_character_type _pre2Ch,
  283.                                                          UI_character_type _preCh);
  284.     /* MTK end */
  286.     /* MTK Leo add */
  287.     extern void (*gui_print_bordered_character) (UI_character_type _c);
  288.     /* MTK Leo end */
  290.     extern U8 gui_print_truncated_text2(S32 x, S32 y, S32 xwidth, UI_string_type *s);
  291.     extern U8 gui_print_truncated_bordered_text2(S32 x, S32 y, S32 xwidth, UI_string_type *s);
  293.     extern void *(*gui_malloc) (size_t size);
  294.     extern void (*gui_free) (void *ptr);
  296.     extern S32(*gui_get_character_width) (UI_character_type c);
  297.     extern void (*gui_measure_character) (UI_character_type c, S32 *width, S32 *height);
  298.     extern S32(*gui_get_character_height) (void);
  299.     extern S32(*gui_get_string_width) (UI_string_type text);
  300.     extern S32(*gui_get_string_width_n) (UI_string_type text, S32 n);
  301.     extern S32(*gui_get_string_width_w) (UI_string_type text, S32 w);
  302.     extern S32(*gui_get_string_width_wn) (UI_string_type text, S32 w, S32 n);
  303.     extern S32(*gui_get_string_height) (UI_string_type text);
  304.     extern void (*gui_measure_string) (UI_string_type text, S32 *width, S32 *height);
  305.     extern void (*gui_measure_string_n) (UI_string_type text, S32 n, S32 *width, S32 *height);
  306.     extern void (*gui_measure_string_w) (UI_string_type text, S32 w, S32 *width, S32 *height);
  307.     extern void (*gui_measure_string_wn) (UI_string_type text, S32 w, S32 n, S32 *width, S32 *height);
  309.     extern void (*gui_set_font) (UI_font_type f);
  310.     extern void (*gui_show_image) (S32 x, S32 y, PU8 i);
  311.     extern void (*gui_show_transparent_image) (S32 x, S32 y, PU8 i, UI_transparent_color_type t);
  312.     extern void (*gui_measure_image) (PU8 i, S32 *width, S32 *height);
  313.     extern S32(*gui_image_n_frames) (PU8 i);
  314.     extern void (*gui_start_timer) (S32 count, void (*callback) (void));
  315.     extern void (*gui_cancel_timer) (void (*callback) (void));
  316.     extern void (*gui_hide_animated_image) (S32 x, S32 y, UI_animated_image_handle i);
  317.     extern void (*gui_register_hide_animation_frame) (UI_animated_image_handle i,
  318.                                                       void (*f) (S32 x1, S32 y1, S32 x2, S32 y2));
  319.     extern U8(*gui_show_transparent_animated_image_frame) (S32 x, S32 y, PU8 i, UI_transparent_color_type t,
  320.                                                            S16 frame_number);
  321.     extern U8(*gui_show_animated_image_frame) (S32 x, S32 y, PU8 i, S16 frame_number);
  322.     extern void (*gui_hide_animations) (void);
  324.     /* extern UI_animated_image_handle              (*gui_show_transparent_animated_image)(S32 x,S32 y,PU8 i,UI_transparent_color_type t); */
  325.     extern UI_animated_image_handle(*gui_show_transparent_animated_image_frames) (S32 x, S32 y, PU8 i,
  326.                                                                                   UI_transparent_color_type t,
  327.                                                                                   S16 start_frame, S16 end_frame);
  328.     /* extern UI_animated_image_handle              (*gui_show_animated_image)(S32 x,S32 y,PU8 i); */
  329.     extern UI_transparent_color_type(*gui_transparent_color) (U8 r, U8 g, U8 b);
  330.     extern color(*gui_color) (U8 r, U8 g, U8 b);
  331.     extern color(*gui_color32) (U8 r, U8 g, U8 b, U8 alpha);
  332.     extern void (*gui_color_RGB) (color c, U8 *r, U8 *g, U8 *b);
  333.     extern UI_string_type(*gui_strcpy) (UI_string_type text1, UI_string_type text2);
  334.     extern UI_string_type(*gui_strncpy) (UI_string_type text1, UI_string_type text2, S32 n);
  335.     extern S32(*gui_strcmp) (UI_string_type text1, UI_string_type text2);
  336.     extern S32(*gui_strlen) (UI_string_type text);
  337.     extern S32(*gui_strncmp) (UI_string_type text1, UI_string_type text2, S32 n);
  338.     extern UI_string_type(*gui_strcat) (UI_string_type text1, UI_string_type text2);
  339.     extern UI_string_type(*gui_itoa) (S32 value, UI_string_type s, S32 radix);
  340.     extern S32(*gui_atoi) (UI_string_type s);
  341.     extern void *(*gui_memcpy) (void *d, const void *s, S32 n);
  342.     extern UI_character_type(*gui_get_next_character) (UI_string_type *s);
  343.     extern UI_character_type(*gui_get_previous_character) (UI_string_type *s);
  345.     /* MTK00612 Bear */
  346. #ifdef MMI_ON_HARDWARE_P
  347.     extern void mtk_animation_cyclic(void);
  348.     extern void mtk_show_animation(S32 x, S32 y, U8 *image);
  349.     extern void mtk_show_animation_frames(S32 x, S32 y, U8 *image, S32 start_frame);
  350. #endif /* MMI_ON_HARDWARE_P */ 
  351.     /* MTK00612 Bear End */
  353. #if(UI_DOUBLE_BUFFER_SUPPORT)
  355.     extern void (*gui_BLT_double_buffer) (S32 x1, S32 y1, S32 x2, S32 y2);
  356.     extern void (*gui_lock_double_buffer) (void);
  357.     extern void (*gui_unlock_double_buffer) (void);
  359. #endif /* (UI_DOUBLE_BUFFER_SUPPORT) */ 
  361.     /* Supported image type */
  362. #define IMAGE_TYPE_INVALID                GDI_IMAGE_TYPE_INVALID
  363. #define IMAGE_TYPE_BMP                    GDI_IMAGE_TYPE_BMP
  364. #define IMAGE_TYPE_BMP_SEQUENCE           GDI_IMAGE_TYPE_BMP_SEQUENCE
  365. #define IMAGE_TYPE_GIF                    GDI_IMAGE_TYPE_GIF
  366. #define IMAGE_TYPE_DEVICE_BITMAP          GDI_IMAGE_TYPE_DEVICE_BITMAP
  367. #define IMAGE_TYPE_DEVICE_BITMAP_SEQUENCE GDI_IMAGE_TYPE_DEVICE_BITMAP_SEQUENCE
  368. #define IMAGE_TYPE_BMP_FILE               GDI_IMAGE_TYPE_BMP_FILE
  369. #define IMAGE_TYPE_GIF_FILE               GDI_IMAGE_TYPE_GIF_FILE
  370. #define IMAGE_TYPE_WBMP_FILE              GDI_IMAGE_TYPE_WBMP_FILE
  371. #define IMAGE_TYPE_JPG                    GDI_IMAGE_TYPE_JPG
  372. #define IMAGE_TYPE_JPG_FILE               GDI_IMAGE_TYPE_JPG_FILE
  373. #define IMAGE_TYPE_WBMP                   GDI_IMAGE_TYPE_WBMP
  374. #define IMAGE_TYPE_AVI                    GDI_IMAGE_TYPE_AVI
  375. #define IMAGE_TYPE_AVI_FILE               GDI_IMAGE_TYPE_AVI_FILE
  376. #define IMAGE_TYPE_3GP                    GDI_IMAGE_TYPE_3GP
  377. #define IMAGE_TYPE_3GP_FILE               GDI_IMAGE_TYPE_3GP_FILE
  378. #define IMAGE_TYPE_MP4                    GDI_IMAGE_TYPE_MP4
  379. #define IMAGE_TYPE_MP4_FILE               GDI_IMAGE_TYPE_MP4_FILE
  380. #define IMAGE_TYPE_JPG_SEQUENCE           GDI_IMAGE_TYPE_JPG_SEQUENCE
  381. #ifdef __MMI_DOWNLOADABLE_THEMES_SUPPORT__
  382. #define IMAGE_TYPE_BMP_FILE_OFFSET        GDI_IMAGE_TYPE_BMP_FILE_OFFSET
  383. #define IMAGE_TYPE_GIF_FILE_OFFSET        GDI_IMAGE_TYPE_GIF_FILE_OFFSET
  384. #endif /* __MMI_DOWNLOADABLE_THEMES_SUPPORT__ */
  385. #define IMAGE_TYPE_PNG                    GDI_IMAGE_TYPE_PNG
  386. #define IMAGE_TYPE_PNG_SEQUENCE           GDI_IMAGE_TYPE_PNG_SEQUENCE
  387. #define IMAGE_TYPE_PPN                    (GDI_IMAGE_TYPE_SUM + 1)//070306 Alpha layer
  388. #define IMAGE_TYPE_M3D                    GDI_IMAGE_TYPE_M3D
  389. #define IMAGE_TYPE_SWFLASH                GDI_IMAGE_TYPE_SWFLASH
  390. #define IMAGE_TYPE_SVG                    GDI_IMAGE_TYPE_SVG//070406 SVG support
  391. #define IMAGE_TYPE_SVG_FILE               GDI_IMAGE_TYPE_SVG_FILE
  392. #ifdef __MMI_RESOURCE_ENFB_SUPPORT__
  393. #define IMAGE_TYPE_ENFB                   255//100206 ENFB support
  394. #endif
  396.     /* 101205 audio resource Calvin Satrt */
  397. #define AUDIO_TYPE_INVALID             0
  398. #define AUDIO_TYPE_MP3                 5
  399. #define AUDIO_TYPE_IMY                 18
  400. #define AUDIO_TYPE_MID                 17
  401. #define AUDIO_TYPE_WAV                 13
  402. #define AUDIO_TYPE_MMF                 20
  403. #define AUDIO_TYPE_PCM                 7
  404. #define AUDIO_TYPE_DVI                 11
  405. #define AUDIO_TYPE_AMR                 3
  406. #define AUDIO_TYPE_AAC                 6
  407. #define AUDIO_TYPE_WMA                 29
  408. #define AUDIO_TYPE_M4A                 25
  409.     /* 101205 audio resource Calvin End */
  411.     /* Some standard functions: Need to be implemented through wrappers.    */
  412.     /* See the character set support functions, gui_get_next_character   */
  413.     /* and gui_get_previous_character                           */
  415.     extern U8 gui_linebreak_character(UI_character_type c);
  416.     extern U8 gui_endofstring_character(UI_character_type c);
  418.     extern color gui_blend_two_color(color c1, color c2, S32 weight1, S32 weight2);
  420. #define  UI_GRADIENT_COLOR_VERTICAL          0x00000100
  421. #define  UI_GRADIENT_COLOR_HORIZONTAL        0x00000000
  422. #define UI_GRADIENT_COLOR_FLIP               0x00000200
  424.     extern void gui_initialize_gradient_color(gradient_color *gc, color *c, U8 *p, U8 n);
  425.     extern void gui_gradient_fill_rectangle(S32 x1, S32 y1, S32 x2, S32 y2, gradient_color *gc, U32 flags);
  427.     /* Filled Area border theme                  */
  428.     typedef struct _UI_filled_area_border_theme
  429.     {
  430.         color filled_area_outer_light_border;
  431.         color filled_area_inner_light_border;
  432.         color filled_area_outer_dark_border;
  433.         color filled_area_inner_dark_border;
  434.     } UI_filled_area_border_theme;
  436.     extern UI_filled_area_border_theme *current_filled_area_border_theme;
  438.     /*
  439.      * UI filled area structure
  440.      * -------------------
  441.      * bits 0-7:         filler types
  442.      * bit    8:            1=vertical filler, 0=horizontal filler (used for gradients and textures)
  443.      * bit  9:           flip filler
  444.      * bit    10:        (reserved)
  445.      * bit  11:       (reserved)
  446.      * bit    12:        border yes/no
  447.      * bit  13:       border size 0=single line, 1=double line
  448.      * bit  14:       3D border
  449.      * bit  15:       rounded border
  450.      * bit    16:        1=elevated border, 0=depressed border
  451.      * bit    17:        1=filled area with shadow
  452.      * bit  18:            1=filled area with double line shadow, 0=single line shadow
  453.      * bit  19:       (reserved)
  454.      * bit  20:       left rounded border
  455.      * bit  21:       right rounded border
  456.      * bit  22:       Draw only horizontal lines in borders
  457.      * bit  24:       transparent color
  458.      */
  460.     /* Bits 0-7: filler type */
  461. #define UI_FILLED_AREA_MASK_TYPE                            0x000000FF
  462.     /* --- */
  463. #define UI_FILLED_AREA_TYPE_COLOR                           0x00000000
  464. #define UI_FILLED_AREA_TYPE_GRADIENT_COLOR                  0x00000001
  465. #define UI_FILLED_AREA_TYPE_TEXTURE                         0x00000002
  466. #define UI_FILLED_AREA_TYPE_BITMAP                          0x00000003
  467. #define UI_FILLED_AREA_TYPE_HATCH_COLOR                     0x00000004
  468. #define UI_FILLED_AREA_TYPE_ALTERNATE_HATCH_COLOR           0x00000005
  469. #define UI_FILLED_AREA_TYPE_CROSS_HATCH_COLOR               0x00000006
  470. #define UI_FILLED_AREA_TYPE_ALTERNATE_CROSS_HATCH_COLOR     0x00000007
  471. #define UI_FILLED_AREA_TYPE_NO_BACKGROUND                   0x00000008
  472. #define UI_FILLED_AREA_TYPE_CUSTOM_FILL_TYPE1               0x00000009  /* Popup description 1 */
  473. #define UI_FILLED_AREA_TYPE_CUSTOM_FILL_TYPE2               0x0000000A  /* Popup description 2 */
  474. #define UI_FILLED_AREA_TYPE_3D_BORDER                       0x0000000B
  476.     /* Bit 8: horiztonal or vertical fill for gradient color */
  477. #define UI_FILLED_AREA_MASK_FILL_DIRECTION                  0x00000100
  478.     /* --- */
  479. #define UI_FILLED_AREA_HORIZONTAL_FILL                      0x00000000
  480. #define UI_FILLED_AREA_VERTICAL_FILL                        0x00000100
  482.     /* Bit 9: flip fill or not */
  483. #define UI_FILLED_AREA_FLIP_FILL                            0x00000200
  485.     /* Bits 12-13: single-double-border */
  486. #define UI_FILLED_AREA_MASK_BORDER_WIDTH                    0x00003000
  487.     /* --- */
  488. #define UI_FILLED_AREA_TYPE_NO_BORDER                       0x00000000
  489. #define UI_FILLED_AREA_BORDER                               0x00001000
  490. #define UI_FILLED_AREA_SINGLE_BORDER                        0x00001000  /* Contain UI_FILLED_AREA_BORDER */
  491. #define UI_FILLED_AREA_DOUBLE_BORDER                        0x00003000  /* Contain UI_FILLED_AREA_BORDER */
  493.     /* Bits 14: 3D border */
  494. #define UI_FILLED_AREA_3D_BORDER                            0x00004000
  496.     /* Bits 15: Rounded border */
  497. #define UI_FILLED_AREA_ROUNDED_BORDER                       0x00008000
  499.     /* Bits 16: Elevated or depressed border */
  500. #define UI_FILLED_AREA_MASK_ELEVATION                       0x00010000
  501.     /* --- */
  502. #define UI_FILLED_AREA_ELEVATED_BORDER                      0x00010000
  503. #define UI_FILLED_AREA_DEPRESSED_BORDER                     0x00000000
  505.     /* Combination of Bit 14 and 16 */
  506. #define UI_FILLED_AREA_3D_ELEVATED_BORDER                   (UI_FILLED_AREA_ELEVATED_BORDER | UI_FILLED_AREA_3D_BORDER)
  507. #define UI_FILLED_AREA_3D_DEPRESSED_BORDER                  (UI_FILLED_AREA_DEPRESSED_BORDER | UI_FILLED_AREA_3D_BORDER)
  509.     /* Bits 17-18: single-double-shadown */
  510. #define UI_FILLED_AREA_MASK_SHADOW                          0x00060000
  511.     /* --- */
  512. #define UI_FILLED_AREA_SHADOW                               0x00020000
  513. #define UI_FILLED_AREA_SHADOW_DOUBLE_LINE                   0x00040000
  515.     /* Bit 20: Left rounded border for Dalmatian style */
  516. #define UI_FILLED_AREA_LEFT_ROUNDED_BORDER                  0x00100000
  518.     /* Bit 21: Right rounded border for Dalmatian style */
  519. #define UI_FILLED_AREA_RIGHT_ROUNDED_BORDER                 0x00200000
  521.     /* Bit 22: Draw only horizontal lines w/o vertical lines in UI_FILLED_AREA_BORDER */
  522. #define UI_FILLED_AREA_NO_VERTICAL_LINE                     0x00400000
  524.     /* Bit 24: Transparent color filler */
  525. #define UI_FILLED_AREA_TYPE_TRANSPARENT_COLOR               0x01000000
  527.     extern UI_filled_area *current_UI_filler;
  529.     //PMT VIKAS START 20050520
  530.     //PMT VIKAS START 20051217
  531. #if defined (__MMI_UI_TRANSPARENT_EFFECT__) || defined (__MMI_UI_LIST_HIGHLIGHT_EFFECTS__) || defined(__MMI_UI_TRANSPARENT_EFFECT_IN_DALMATIAN_CALENDAR__)      /* 072505 Calvin modified */
  532.     /* PMT VIKAS END 20051217 */
  533.     extern void gui_fill_transparent_color(S32 x1, S32 y1, S32 x2, S32 y2, color c);
  534.     extern void gui_transparent_color_filler(S32 x1, S32 y1, S32 x2, S32 y2, color c);
  535.     extern U8 gui_transparent_color_part_value(S32 color_value, S32 opacity_value);
  536.     extern void gui_set_transparent_source_layer(S32);
  537.     extern gdi_handle gui_get_transparent_source_layer(void);   /* 110705 WAP menu Clavin add */
  538.     extern void gui_reset_transparent_source_layer(void);
  540.     /* PMT VIKAS START 20050630 */
  541.     extern S32 gui_is_current_transparency_with_multi_layer(void);
  542.     /* PMT VIKAS END 20050630 */
  543. #endif /* defined (__MMI_UI_TRANSPARENT_EFFECT__) || defined (__MMI_UI_LIST_HIGHLIGHT_EFFECTS__) || defined(__MMI_UI_TRANSPARENT_EFFECT_IN_DALMATIAN_CALENDAR__) */ 
  544.     //PMT VIKAS END
  545.     //PMT VIKAS START 20050707
  546.     extern void gui_fill_left_rounded_border(S32 rx1, S32 ry1, S32 rx2, S32 ry2, UI_filled_area *f);
  547.     extern void gui_fill_right_rounded_border(S32 rx1, S32 ry1, S32 rx2, S32 ry2, UI_filled_area *f);
  548.     /* PMT VIKAS END 20050707 */
  549.     extern void gui_shadow_filled_area(S32 x1, S32 y1, S32 x2, S32 y2, UI_filled_area *f);
  550.     extern void gui_draw_filled_area(S32 x1, S32 y1, S32 x2, S32 y2, UI_filled_area *f);
  552.     /* void gui_greyscale_rectangle(S32 x1,S32 y1,S32 x2,S32 y2, S32 white_value); */
  553.     extern void gui_greyscale_rectangle(S32 x1, S32 y1, S32 x2, S32 y2, S32 white_value, S32 black_value);      /* 102605 greyscale Calvin chnaged */
  555.     /* PMT HIMANSHU START 20050916 */
  557.     typedef enum
  558.     {
  559.         MMI_GRADIENT_RECT_ROUNDED_CORNER_TOP_LEFT = 0,
  560.         MMI_GRADIENT_RECT_ROUNDED_CORNER_TOP_RIGHT,
  561.         MMI_GRADIENT_RECT_ROUNDED_CORNER_BOTTOM_LEFT,
  562.         MMI_GRADIENT_RECT_ROUNDED_CORNER_BOTTOM_RIGHT
  563.     } mmi_gradient_rect_rounded_corner_style_enum;
  565.     extern void gui_draw_rounded_corner(
  566.                     S32 x1,
  567.                     S32 y1,
  568.                     S32 size,
  569.                     color rect_color_start,
  570.                     color rect_color_end,
  571.                     S32 levle,
  572.                     mmi_gradient_rect_rounded_corner_style_enum corner_style);
  574.     extern void gui_draw_gradient_rounded_rectangle(
  575.                     S32 x1,
  576.                     S32 y1,
  577.                     S32 x2,
  578.                     S32 y2,
  579.                     color start_color,
  580.                     color end_color,
  581.                     S32 border_width);
  583.     /* PMT HIMANSHU END 20050916 */
  585.     typedef struct _UI_HLS_color
  586.     {
  587.         /* Hue */
  588.         U16 h;  /* 0-360 */
  589.         /* Lightness */
  590.         U8 l;   /* 0-255 */
  591.         /* Saturation */
  592.         U8 s;   /* 0-255 */
  593.     } UI_HLS_color;
  594.     extern void gui_RGB_to_HLS(color rgb, UI_HLS_color *hls);
  595.     extern void gui_HLS_to_RGB(UI_HLS_color hls, color *rgb);
  597.     /* UI object co-ordinates structure       */
  599.     typedef struct _UI_object_coordinates
  600.     {
  601.         S32 x;
  602.         S32 y;
  603.         S32 width;
  604.         S32 height;
  605.     } UI_object_coordinates;
  607.     /* Dummy functions called by UI elements by default, during events
  608.        Do not remove any of these functions.  */
  610.     extern void UI_dummy_function(void);
  611.     extern void UI_dummy_function_byte(U8 a);
  612.     extern void UI_dummy_function_s32(S32 a);
  613.     extern void UI_dummy_function_character(UI_character_type c);
  615.     /* Functions for switching graphics context  */
  617.     extern void UI_set_main_LCD_graphics_context(void);
  618.     extern void UI_set_sub_LCD_graphics_context(void);
  619.     extern U8 UI_test_sub_LCD_graphics_context(void);
  621.     /* Function to print truncated text */
  622.     extern void gui_print_truncated_text(S32 x, S32 y, S32 xwidth, UI_string_type s);
  623.     /* MTK Leo add */
  624.     extern void gui_print_truncated_borderd_text(S32 x, S32 y, S32 xwidth, UI_string_type s);
  625.     /* MTK Leo end */
  626.     /* PMT START PERSIAN */
  627. #define IS_ARABIC_CHARACTER(c)                                                                                          
  628.    (( ( ((UI_character_type)(c)>=(UI_character_type)0x0600) && ((UI_character_type)(c)<=(UI_character_type)0x06FF) ) || 
  629.    ( ((UI_character_type)(c)>=(UI_character_type)0xFB50) && ((UI_character_type)(c)<=(UI_character_type)0xFDFF) ) ||    
  630.    ( ((UI_character_type)(c)>=(UI_character_type)0xFE70) && ((UI_character_type)(c)<=(UI_character_type)0xFEFF) ) )?(1):(0))
  631.     /* PMT END PERSIAN */
  633.     /* Common string macros */
  635. #ifdef __ASCII
  637. #define UI_STRING_GET_NEXT_CHARACTER(p,c)                                                 
  638.       {                                                                                   
  639.          (c)=*((U8*)(p))++;                                                               
  640.       }
  642. #define UI_STRING_GET_PREVIOUS_CHARACTER(p,c)                                                
  643.       {                                                                                      
  644.          (c)=*(--((U8*)(p)));                                                                
  645.       }
  647. #define UI_STRING_INSERT_CHARACTER(p,c)                                                      
  648.       {                                                                                      
  649.          *((U8*)(p))++=(c);                                                                  
  650.       }
  652. #endif /* __ASCII */ 
  654. #ifdef __UCS2_ENCODING
  656.     /* Warning: Currently, these macros assume Little endian format only */
  658. #define UI_STRING_GET_NEXT_CHARACTER(p,c)                                                    
  659.       {                                                                                      
  660.          c=(UI_character_type)((*((p)+0))|((*((p)+1))<<8));                                  
  661.          (p)+=2;                                                                             
  662.       }
  664. #define UI_STRING_GET_PREVIOUS_CHARACTER(p,c)                                                
  665.       {                                                                                      
  666.          p-=2;                                                                               
  667.          c=(UI_character_type)((*((p)+0))|((*((p)+1))<<8));                                  
  668.       }
  670. #define UI_STRING_INSERT_CHARACTER(p,c)                                                      
  671.       {                                                                                      
  672.          (*((p))++)=(U8)(((c)&0xff));                                                        
  673.          (*((p))++)=(U8)(((c)>>8));                                                          
  674.       }
  676. #endif /* __UCS2_ENCODING */ 
  678. #define UI_TEST_CR_CHARACTER1(c)              (((UI_character_type)(c)==(UI_character_type)0x0D)?(1):(0))
  679. #define UI_TEST_CR_CHARACTER(c)               (((*(UI_character_type*)&(c))==(UI_character_type)0x0D)?(1):(0))
  681. #define UI_TEST_LF_CHARACTER1(c)              (((UI_character_type)(c)==(UI_character_type)0x0A)?(1):(0))
  682. #define UI_TEST_LF_CHARACTER(c)               (((*(UI_character_type*)&(c))==(UI_character_type)0x0A)?(1):(0))
  684. #define UI_TEST_ESC_CHARACTER1(c)             (((UI_character_type)(c)==(UI_character_type)0x1B)?(1):(0))
  685. #define UI_TEST_ESC_CHARACTER(c)              (((*(UI_character_type*)&(c))==(UI_character_type)0x1B)?(1):(0))
  688. #define UI_STRING_LINE_BREAK_CHARACTER1(c)    (((UI_character_type)(c)==(UI_character_type)'n')?(1):(0))
  689. #define UI_STRING_LINE_BREAK_CHARACTER(c)     (((*(UI_character_type*)&(c))==(UI_character_type)'n')?(1):(0))
  692. #define UI_STRING_END_OF_STRING_CHARACTER1(c) (((UI_character_type)(c)==(UI_character_type)'')?(1):(0))
  693. #define UI_STRING_END_OF_STRING_CHARACTER(c)  (((*(UI_character_type*)&(c))==(UI_character_type)'')?(1):(0))
  696. #define UI_STRING_SPACE_CHARACTER1(c)         (((UI_character_type)(c)==(UI_character_type)' ')?(1):(0))
  697. #define UI_STRING_SPACE_CHARACTER(c)          (((*(UI_character_type*)&(c))==(UI_character_type)' ')?(1):(0))
  700. #define UI_TEST_8895_1_CHAR_IN_GSM_DEF_CHAR(c)  (((c)==163 ||(c)==165 || (c)==232 ||(c)==233 ||(c)==249 ||(c)==236 ||(c)==242 ||(c)==199 ||(c)==216 ||(c)==248 ||(c)==197 ||(c)==229 ||(c)==198 ||(c)==230 ||(c)==223 ||(c)==200 ||(c)==164 ||(c)==161 ||(c)==196 ||(c)==214 ||(c)==209 ||(c)==220 ||(c)==167 ||(c)==191 ||(c)==228 ||(c)==246 ||(c)==241 ||(c)==252 ||(c)==224)?(1):(0))
  702. #define UI_TEST_UCS2_CHARACTER(c)            (((c)&0xff80) && ( !UI_TEST_8895_1_CHAR_IN_GSM_DEF_CHAR(c)))?(1):(0)
  704. #define UI_TEST_UCS2_INCREMENT_COUNT(c,count)   if(UI_TEST_UCS2_CHARACTER(c)) ((count)++)
  706. #define UI_TEST_UCS2_DECREMENT_COUNT(c,count)   if(UI_TEST_UCS2_CHARACTER(c) && ((count)>0)) ((count)--)
  708. #define UI_UCS2_STRING_HALF_LENGTH(x)        (((x)&3)?(((x)>>1)+1):((x)>>1))
  710.     /* MTK Terry for Phone Book Name Length */
  711.     // #define UI_UCS2_STRING_HALF_LENGTH_MINUS_ONE(x)      (((x)&3)?(((x)>>1)-1):(((x)>>1)-2))
  712. #define UI_UCS2_STRING_HALF_LENGTH_MINUS_ONE(x) (((x)&3)?(((x)>>1)-1):(((x)>>1)))
  714. #define UI_UCS2_STRING_HALF_LENGTH_MINUS_FORTYFOUR(x) (((x)&3)?(((x)>>1)-87):(((x)>>1)-88))
  716. #define UI_HINDI_CHARACTER_UCS2_RANGE(x)     ( (((U16)(x) > 0x900)&&((U16)(x) < 0x971) || ((U16)(x)>59647 && (U16)(x)<59828))?(1) : (0) )
  718. #define UI_TEST_UCS2_INCREMENT_COUNT_SET_LENGTH(c,count,allocated_length,length)                   
  719.       {  if(UI_TEST_UCS2_CHARACTER(c))                                                             
  720.          {  if((count)==0) (length)=UI_UCS2_STRING_HALF_LENGTH(allocated_length);                  
  721.             (count)++;                                                                             
  722.          }                                                                                         
  723.       }
  725.     /* Added for n/2-1 Chinese characters input mode   */
  726. #define UI_TEST_UCS2_INCREMENT_COUNT_SET_LENGTH_TYPE2(c,count,allocated_length,length)                
  727.       {  if(UI_TEST_UCS2_CHARACTER(c))                                                                
  728.          {  if((count)==0) (length)=UI_UCS2_STRING_HALF_LENGTH_MINUS_ONE(allocated_length);           
  729.             (count)++;                                                                                
  730.          }                                                                                            
  731.       }
  732.     /* Added for n/2-44 Chinese characters input mode  */
  733. #define UI_TEST_UCS2_INCREMENT_COUNT_SET_LENGTH_TYPE3(c,count,allocated_length,length)                      
  734.       {  if(UI_TEST_UCS2_CHARACTER(c))                                                                      
  735.          {  if((count)==0) (length)=UI_UCS2_STRING_HALF_LENGTH_MINUS_FORTYFOUR(allocated_length);           
  736.             (count)++;                                                                                      
  737.          }                                                                                                  
  738.       }
  740. #define UI_TEST_UCS2_DECREMENT_COUNT_SET_LENGTH(c,count,allocated_length,length)                   
  741.       {  if(UI_TEST_UCS2_CHARACTER(c) && ((count)>0))                                              
  742.          {  ((count)--);                                                                           
  743.             if((count)==0) (length)=(allocated_length);                                            
  744.          }                                                                                         
  745.       }
  747. #define UI_TEST_UCS2_CHANGE_COUNT_SET_LENGTH(old_c,c,count,allocated_length,length)                   
  748.       {  UI_TEST_UCS2_DECREMENT_COUNT_SET_LENGTH(old_c,count,allocated_length,length);                
  749.          UI_TEST_UCS2_INCREMENT_COUNT_SET_LENGTH(c,count,allocated_length,length);                    
  750.       }
  752.     /* Added for n/2-1 Chinese characters input mode   */
  753. #define UI_TEST_UCS2_CHANGE_COUNT_SET_LENGTH_TYPE2(old_c,c,count,allocated_length,length)             
  754.       {  UI_TEST_UCS2_DECREMENT_COUNT_SET_LENGTH(old_c,count,allocated_length,length);                
  755.          UI_TEST_UCS2_INCREMENT_COUNT_SET_LENGTH_TYPE2(c,count,allocated_length,length);              
  756.       }
  758.     /* Added for n/2-44 Chinese characters input mode  */
  759. #define UI_TEST_UCS2_CHANGE_COUNT_SET_LENGTH_TYPE3(old_c,c,count,allocated_length,length)             
  760.       {  UI_TEST_UCS2_DECREMENT_COUNT_SET_LENGTH(old_c,count,allocated_length,length);                
  761.          UI_TEST_UCS2_INCREMENT_COUNT_SET_LENGTH_TYPE3(c,count,allocated_length,length);              
  762.       }
  764. #define UI_TEST_UCS2_COUNT_SET_LENGTH(count,allocated_length,length)                            
  765.       {  if((count)>0) (length)=UI_UCS2_STRING_HALF_LENGTH(allocated_length);                   
  766.       }
  768.     /* Added for n/2-1 Chinese characters input mode   */
  769. #define UI_TEST_UCS2_COUNT_SET_LENGTH_TYPE2(count,allocated_length,length)                            
  770.       {  if((count)>0) (length)=UI_UCS2_STRING_HALF_LENGTH_MINUS_ONE(allocated_length);               
  771.       }
  773.     /* Added for n/2-44 Chinese characters input mode  */
  774. #define UI_TEST_UCS2_COUNT_SET_LENGTH_TYPE3(count,allocated_length,length)                                  
  775.       {  if((count)>0) (length)=UI_UCS2_STRING_HALF_LENGTH_MINUS_FORTYFOUR(allocated_length);               
  776.       }
  778.     extern void UI_disable_alignment_timers(void);
  779.     extern void UI_enable_alignment_timers(void);
  781.     /* Page break character equivalent needs to be added  */
  782.     /* Euro character equivalent = 0xA2             */
  784. #define UI_TEST_GSM_EXTENDED(c)     
  785. (     (c==0xA2)                     
  786.    || (c=='^')                      
  787.    || (c=='{')                      
  788.    || (c=='}')                      
  789.    || (c=='\')                     
  790.    || (c=='[')                      
  791.    || (c=='~')                      
  792.    || (c==']')                      
  793.    || (c=='|')                      
  794. )                                   
  796.     /* 
  797.      * Painter Component: encapsulates various painting operations with common interface
  798.      */
  800.     /* Custom-defined callback type to draw a rectangle region 
  801.        (x, y) is the left-top corner of drawing
  802.        (clip_x1, clip_y1, clip_x2, clip_y2) is the clipping area. */
  803.     typedef void (*gui_util_painter_callback_type)(
  804.                     S32 x, 
  805.                     S32 y, 
  806.                     S32 clip_x1, 
  807.                     S32 clip_y1, 
  808.                     S32 clip_x2, 
  809.                     S32 clip_y2);
  811.     /* Types of painting operations */
  812.     typedef enum 
  813.     {
  814.         /* Do nothing */
  815.         GUI_UTIL_PAINTER_TYPE_EMPTY = 0,
  816.         /* Fill transparent color */
  817.         GUI_UTIL_PAINTER_TYPE_TRANSPARENT,
  818.         /* Draw an image */
  819.         GUI_UTIL_PAINTER_TYPE_IMAGEID,
  820.         /* Call a custom-defined callback routine */
  821.         GUI_UTIL_PAINTER_TYPE_CALLBACK,
  822.         /* Use a filler */
  823.         GUI_UTIL_PAINTER_TYPE_FILLER,
  824.         /* Last dummy enum type */
  825.         GUI_UTIL_PAINTER_TYPE_END_OF_ENUM
  826.     } gui_util_painter_type_enum;
  828.     /* Painter UI component */
  829.     typedef struct
  830.     {
  831.         gui_util_painter_type_enum type;
  832.         union
  833.         {
  834.             MMI_ID_TYPE imageid;
  835.             gui_util_painter_callback_type callback;
  836.             const UI_filled_area *filler;
  837.         } _u;
  838.     } gui_util_painter_struct;
  840.     extern void gui_util_painter_create_empty(gui_util_painter_struct *p);
  841.     extern void gui_util_painter_create_transparent(gui_util_painter_struct *p);
  842.     extern void gui_util_painter_create_imageid(
  843.                     gui_util_painter_struct *p, 
  844.                     MMI_ID_TYPE imageid);
  845.     extern void gui_util_painter_create_callback(
  846.                     gui_util_painter_struct *p, 
  847.                     gui_util_painter_callback_type callback);
  848.     extern void gui_util_painter_create_filler(
  849.                     gui_util_painter_struct *p, 
  850.                     const UI_filled_area *filler);
  852.     extern void gui_util_painter_show_clipped(
  853.         const gui_util_painter_struct *p, 
  854.         S32 x, 
  855.         S32 y, 
  856.         S32 clip_x1, 
  857.         S32 clip_y1, 
  858.         S32 clip_x2, 
  859.         S32 clip_y2);
  860.         
  861.     extern void gui_util_painter_show(const gui_util_painter_struct *p, S32 x1, S32 y1, S32 x2, S32 y2);
  863.     /* 
  864.      * Clean-up of GUI components 
  865.      * To avoid clean-up each UI component explicitly in WGUI/draw manager/widget, 
  866.      * general cleanup mechanism is provided here.
  867.      */
  869. #define GUI_MAX_CLEANUP_HOOK  16
  871.     typedef void (*gui_cleanup_hook_hdlr) (void);
  873.     extern void gui_add_cleanup_hook(gui_cleanup_hook_hdlr fp);
  874.     extern void gui_remove_cleanup_hook(gui_cleanup_hook_hdlr fp);
  875.     extern void gui_cleanup(void);
  877.     /* PMT VIKAS START 20051209 */
  878.     /* Pre cleanup functions for GUI components */
  880.     typedef void (*gui_pre_cleanup_hook_hdlr) (void);
  882.     extern void gui_add_pre_cleanup_hook(gui_cleanup_hook_hdlr fp);
  883.     extern void gui_remove_pre_cleanup_hook(gui_cleanup_hook_hdlr fp);
  884.     extern void gui_pre_cleanup(void);
  885.     /* PMT VIKAS END 20051209 */
  886.     /* Touch Panel Events */
  888.     typedef enum
  889.     {
  890.         GUI_PEN_EVENT_PARAM_VOID,
  891.         GUI_PEN_EVENT_PARAM_INTEGER,
  892.         GUI_PEN_EVENT_PARAM_INTEGER2,
  893.         GUI_PEN_EVENT_PARAM_INTEGER3,
  894.         GUI_PEN_EVENT_PARAM_POINTER,
  895.         GUI_PEN_EVENT_PARAM_POINTER_INTEGER,
  896.         GUI_PEN_EVENT_PARAM_POINTER_INTEGER2
  897.     } gui_pen_event_param_enum;
  899.     typedef struct _mmi_gui_pen_event_param_struct
  900.     {
  901.         gui_pen_event_param_enum type;
  902.         union
  903.         {
  904.             int i;
  905.             void *p;
  906.         } _u;
  907.         int i2;
  908.         int i3;
  909.     } gui_pen_event_param_struct;
  911. #define GUI_PEN_EVENT_PARAM_SET_VOID(_s) do {_s->type = GUI_PEN_EVENT_PARAM_VOID;} while (0)
  913. #define GUI_PEN_EVENT_PARAM_SET_INTEGER(_s, _i) do {_s->type = GUI_PEN_EVENT_PARAM_INTEGER;  
  914.                                                    _s->_u.i = _i;                            
  915.                                                    } while (0)
  917. #define GUI_PEN_EVENT_PARAM_SET_INTEGER2(_s, _i, _i2) do {_s->type = GUI_PEN_EVENT_PARAM_INTEGER2; 
  918.                                                    _s->_u.i = _i;                                  
  919.                                                    _s->i2 = _i2;                                   
  920.                                                    } while (0)
  922. #define GUI_PEN_EVENT_PARAM_SET_INTEGER3(_s, _i, _i2, _i3) do {_s->type = GUI_PEN_EVENT_PARAM_INTEGER3;  
  923.                                                    _s->_u.i = _i;                                        
  924.                                                    _s->i2 = _i2;                                         
  925.                                                    _s->i3 = _i3;                                         
  926.                                                    } while (0)
  928. #define GUI_PEN_EVENT_PARAM_SET_POINTER(_s, _p) do {_s->type = GUI_PEN_EVENT_PARAM_POINTER;  
  929.                                                    _s->_u.p = _p;                            
  930.                                                    } while (0)
  932. #define GUI_PEN_EVENT_PARAM_SET_POINTER_INTEGER(_s, _p, _i2) do {_s->type = GUI_PEN_EVENT_PARAM_POINTER_INTEGER;  
  933.                                                    _s->_u.p = _p;                                                 
  934.                                                    _s->i2 = _i2;                                                  
  935.                                                    } while (0)
  937. #define GUI_PEN_EVENT_PARAM_SET_POINTER_INTEGER2(_s, _p, _i2, _i3) do {_s->type = GUI_PEN_EVENT_PARAM_POINTER_INTEGER2; 
  938.                                                    _s->_u.p = _p;                                                       
  939.                                                    _s->i2 = _i2;                                                        
  940.                                                    _s->i3 = _i3;                                                        
  941.                                                    } while (0)
  943. #ifdef __cplusplus
  944. }
  945. #endif 
  947. #endif /* __GUI_H__ */