wgui_categories_util.h

MTK6226修改平台UI的文件介绍

typedef struct _list_matrix_menu_category_history
{
    list_menu_category_history list_menu_history;
    matrix_menu_category_history matrix_menu_history;
} list_matrix_menu_category_history;

#define MMI_MAX_SLIDE_CONTROL 3
typedef struct _slide_control_category_history
{
    U16 n_items;
    U16 history_ID;
    S32 value[MMI_MAX_SLIDE_CONTROL];
    U16 current_focus;
} slide_control_category_history;

typedef struct _panel_category_history
{
    U16 history_ID;  
    U16 focused_panel;
    S32 n_items;  
    S32 focused_element[DM_MAX_PANEL];
} panel_category_history;

/* SLIM Version Menu Style */
typedef enum
{
    WGUI_LIST_MENU_SLIM_STYLE_DEFAULT,  /* By system setting */
    WGUI_LIST_MENU_SLIM_STYLE_NO_ICON,  /* Disable icon display */
    WGUI_LIST_MENU_SLIM_STYLE_NUMBER,   /* Auto numbering */
    WGUI_LIST_MENU_SLIM_STYLE_DRAW_ICON
} wgui_list_menu_slim_style_enum;

/* PMT NEERAJ START 20050425 */
/* TRANSITION_STYLES */
typedef enum
{
    WGUI_TRANSITION_NONE = 0,   /* No Transition */
    WGUI_TRANSITION_L2R = 1,    /* Lef to Right */
    WGUI_TRANSITION_R2L = 2,    /* Right to Left */
    WGUI_TRANSITION_T2D = 3,    /* Top To Down */
    WGUI_TRANSITION_D2T = 4     /* Down To Top */
} wgui_transition_styles;

/* PMT NEERAJ END 20050425 */

/* PMT VIKAS START 20050720 */
/*   Animted title effect   */
#ifdef __MMI_UI_ANIMATED_TITLE_EFFECT__
#define TITLE_IMAGE_ANIMATION_TIMER 50
#define SHIFT_TITLE_IMAGE 5
typedef enum
{
    MMI_UI_TITLE_IMAGE_ANIMATE_ONCE = 0,    /* Title will animate once */
    MMI_UI_TITLE_IMAGE_ANIMATE_CONTINOUS    /* Title will animate continously */
} wgui_title_effect_styles;
#endif /* __MMI_UI_ANIMATED_TITLE_EFFECT__ */ 
/* PMT VIKAS END 20050720 */

#define WGUI_ORDER_TEXT_IMAGE 0x00000000
#define WGUI_ORDER_IMAGE_TEXT 0x00000001

#define WGUI_MAX_POP_UP_DESCRIPTION_STRINGS      MAX_FIXED_ICONTEXT_MENU_ITEMS
#define GDI_TRANSFORM_GRADIENT_COLOR(Color)  gdi_act_color_from_rgb(255,Color.r,Color.g,Color.b),gdi_act_color_from_rgb(255,(Color.r>>1),(Color.g>>1),(Color.b>>1))

/* PMT HIMANSHU START 20050625 */
#if defined(__MMI_UI_TECHNO_STATUS_ICON__)
#define TITLE_TEXT_GAP 2
#endif 
/* PMT HIMANSHU END */

#define MMI_BEFORE_SCREEN                             0x00000000
#define MMI_LEAVE_FULL_SCREEN                         0x00000001
#define MMI_LEAVE_FULL_IDLE_SCREEN                    0x00000002
#define MMI_IN_FULL_SCREEN                            0x00000004
#define MMI_IN_NORMAL_SCREEN                          0x00000008
#define MMI_IN_NORMAL_SCREEN_WITHOUT_STATUSBAR        0x00000010
#define MMI_IN_IDLE_SCREEN                            0x00000020
#define MMI_LEAVE_BG_ON_BOTTOM_SCREEN                 0x00000040        /* 092005 redraw status Calvin */

/***************************************************************************** 
* Extern Global Variable
*****************************************************************************/
extern U32 category_screen_layout_flags;
extern S32 MMI_matrix_bar_height;
extern S32 MMI_matrix_bar_width;
extern S32 MMI_matrix_bar_x;
extern S32 MMI_matrix_bar_y;
extern S32 MMI_title_height;
extern S32 MMI_title_width;
extern S32 MMI_title_x;
extern S32 MMI_title_y;
extern S32 MMI_button_bar_height;
extern S32 MMI_thick_menuitem_height;
extern S32 MMI_menuitem_height;
extern void (*UI_hide_animation_frame_function) (void);

/* high level wrappers  */
extern UI_string_type MMI_title_string;
extern UI_string_type MMI_message_string;
extern PU8 MMI_title_icon;
extern PU8 MMI_title_icon2;
extern PU8 MMI_message_icon;
extern S32 MMI_menu_shortcut_number;
extern UI_string_type MMI_highlighted_item_text;

extern S32 MMI_current_menu_type;

/* extern S32 MMI_main_menu_type; */
extern S16 MMI_current_input_type;

/* extern S16 MMI_saved_input_type; */
extern U8 flag_scroll;
extern U8(*test_change_input_mode) (void);
extern U8 MMI_english_input_mode_flag;
extern stFontAttribute UI_DEFAULT_FONT;
extern void (*MMI_list_highlight_handler) (S32 item_index);
extern void (*MMI_matrix_highlight_handler) (S32 item_index);
extern void (*MMI_circular_3D_highlight_handler) (S32 item_index);

extern void (*wgui_inputbox_RSK_function) (void);

extern void (*ExitCategoryFunction) (void);
extern void (*RedrawCategoryFunction) (void);
extern void (*RedrawSpellingOrCandidateBoxesFunction) (void);
extern U8 *(*GetCategoryHistory) (U8 *history_buffer);
extern S32(*GetCategoryHistorySize) (void);

/* Globals  */
extern gdi_handle animation_handle;

/*** Store the value of height, width , x, y position of title bar ,status icons
popup dialog in global variables these valeu r also #define in wgui.h */

/* Bear - 040228 move init value to wgui.c */
extern S32 MMI_matrix_bar_height;
extern S32 MMI_matrix_bar_x;
extern S32 MMI_matrix_bar_y;
extern S32 MMI_matrix_bar_width;
extern S32 MMI_title_height;
extern S32 MMI_title_width;
extern S32 MMI_title_x;
extern S32 MMI_title_y;
extern S32 MMI_button_bar_height;
extern S32 MMI_menuitem_height;

extern S32 MMI_pop_up_dialog_x;
extern S32 MMI_pop_up_dialog_y;
extern S32 MMI_pop_up_dialog_width;
extern S32 MMI_pop_up_dialog_height;
extern S32 MMI_pop_up_dialog_full_height;

extern U8 wgui_switch_title_with_status_bar;    /* 0: Title, 1: Status icons  */
extern U8 wgui_category_screen_no_buttons;

/* Store the clipping value of current image */
extern S32 wgui_image_clip_x1;
extern S32 wgui_image_clip_y1;
extern S32 wgui_image_clip_x2;
extern S32 wgui_image_clip_y2;

/* Support for displaying animations in Category screens:
   These functions allow the display of a single animated
   icon in any category screen. The position of the icon
   is decided by the category screen                  */
extern PU8 _MMI_animated_icon;
extern U8 *_MMI_animated_icon_name;
extern S32 _MMI_animated_icon_x;
extern S32 _MMI_animated_icon_y;
extern UI_animated_image_handle _MMI_animated_icon_handle;

extern UI_pop_up_description wgui_pop_up_description;

/* store number of strigs of pop up */
extern S32 wgui_pop_up_descriptions_n_strings;

/* store current index of popup */
extern S32 wgui_current_pop_up_description_index;

/* store number of popup */
extern S32 wgui_pop_up_descriptions_n_items;

/* store flag of popup */
extern U8 wgui_pop_up_description_flag;

extern wgui_pop_up_description_string_type wgui_pop_up_description_strings[WGUI_MAX_POP_UP_DESCRIPTION_STRINGS];

extern U8 *checklist_category_menu_item_states;
extern S32 item_checked;
extern void (*checkbox_toggle_DONE_RSK_function) (void);
extern void (*checkbox_toggle_BACK_RSK_function) (void);

/** Store the title string of current main lcd scrren */
extern UI_string_type MMI_title_string;

/** Store the address of title icon display on current main lcd scrren title bar */
extern PU8 MMI_title_icon;

/** Store the address of title icon display on current main lcd scrren title bar */
extern PU8 MMI_title_icon2;

/* Store the scrolling text of title bar */
extern scrolling_text scrolling_title_text;

/* Scrolling title support */
/** global variables store value of x,y,width of title bar text , icon to scroll the text on title bar */
extern S32 scrolling_title_icon_x;
extern S32 scrolling_title_icon_y;

/* Store the message of current multibox dispaly on main lcd */
extern UI_string_type MMI_message_string;
extern UI_string_type MMI_message_string2;

/** Store the address of icon display on content area of current main lcd scrren */
extern PU8 MMI_message_icon;
extern PU8 MMI_message_icon2;

/* store teh current shorcut number display on right side of title bar in case of menu screen */
extern S32 MMI_menu_shortcut_number;

/* Store the text of current highlighted item in menu */
extern UI_string_type MMI_highlighted_item_text;

/* high level wrappers  */
extern PU8 MMI_mm_animation;

extern U8 gMMI_UI_U8_flag_1, gMMI_UI_U8_flag_2;
extern U16 gMMI_UI_U16_var_1, gMMI_UI_U16_var_2;
extern S32 gMMI_UI_S32_var_1, gMMI_UI_S32_var_2, gMMI_UI_S32_var_3, gMMI_UI_S32_var_4;
extern void *gMMI_UI_ptr_1, *gMMI_UI_ptr_2, *gMMI_UI_ptr_3, *gMMI_UI_ptr_4;

/* varbale of type slide_control used in slide control screen */
extern slide_control *MMI_current_slide_control;

/* extern slide_control MMI_slide_control1,MMI_slide_control2; */
extern slide_control MMI_slide_control[MMI_MAX_SLIDE_CONTROL];

/* store current slide control value */
extern S32 *MMI_current_slide_control_value;

#if (0)
/* under construction !*/
/* under construction !*/
/* under construction !*/
/* under construction !*/
#endif /* (0) */ 
extern S32 *MMI_slide_control_value[MMI_MAX_SLIDE_CONTROL];

extern S32 gOnFullScreen;

/* Add for Draw Manager */
extern S32 g_gui_current_catid;

/***************************************************************************** 
* Extern Global Function
*****************************************************************************/
extern U8 *dummy_get_history(U8 *buffer);
extern S32 dummy_get_history_size(void);

extern PU8 get_image(MMI_ID_TYPE i);
extern U8 *get_audio(MMI_ID_TYPE i, U8 *type, U32 *filelen);  /* 101205 audio resource Calvin added */
extern UI_string_type get_string(MMI_ID_TYPE i);
extern UI_string_type get_string_lang(MMI_ID_TYPE i, S8 *ssc_str);

extern void initialize_category_screens(void);
extern void reset_category_functions(void);
extern void SetCategoryScreenLayout(U32 flags);

extern void wgui_show_animation(void);
extern void wgui_show_transparent_animation(void);
extern void wgui_set_animation(S32 x, S32 y, MMI_ID_TYPE img);
extern void wgui_set_animation_y(S32 x, S32 y, MMI_ID_TYPE img);
extern void wgui_set_animation_image(S32 x, S32 y, PU8 img);
extern void wgui_set_animation_image_y(S32 x, S32 y, PU8 img);
extern void wgui_measure_set_animation(S32 x, S32 y, S32 *width, S32 *height, MMI_ID_TYPE img);
extern void wgui_measure_set_animation_y(S32 x, S32 y, S32 *width, S32 *height, MMI_ID_TYPE img);
extern void wgui_measure_set_animation_image(S32 x, S32 y, S32 *width, S32 *height, PU8 img);
extern void wgui_measure_set_animation_image_y(S32 x, S32 y, S32 *width, S32 *height, PU8 img);
extern void wgui_hide_animation(void);

extern void wgui_fill_rectangle_clip(S32 x1, S32 y1, S32 x2, S32 y2, color c);
extern void clear_screen(void);
extern void clear_screen_with_color(color c);
extern void clear_buttonbar(void);
extern void set_button_bar_height(S32 height);
extern void clear_contentarea(void);
extern void draw_arrow_indication(S8 left, S8 right, S8 up, S8 down);
extern void SetHighlightedItem(S32 item_index);
extern S32 GetHighlightedItem(void);
extern UI_string_type get_item_text(S32 index);
extern UI_string_type get_dynamic_item_text(S32 index);

#ifdef ENABLE_BOTTOM_NAVIGATION_KEYS
extern void gui_show_key_navigation(S32 index);
extern void gui_show_navigation_keys(void);
#endif /* ENABLE_BOTTOM_NAVIGATION_KEYS */ 
extern void DisableCategoryScreenScrollBar(void);
extern void SetupCategoryKeyHandlers(void);

extern void wgui_set_java_screen(void);//021007 Java title
extern void wgui_unset_java_screen(void);
extern void entry_full_screen(void);
extern void leave_full_screen(void);
extern void in_idle_screen(void);