common_api.h

在MTK下开发的一个词典项目

extern	void	mmi_frm_sms_send_sms_rsp(void *inMsg);	


extern	GDI_HANDLE	Draw_Picture_by_name		//通用画图函数
(
	unsigned char driv,
	char *gb_name,
	int off_XX,
	int off_YY,
	unsigned char is_anim
);

extern	GDI_HANDLE	MY_Draw_Picture_by_name		//适用于同时画大量的图,开始和结束要调用Begin,end
(
	unsigned char driv,
	char *gb_name,
	int off_XX,
	int off_YY,
	unsigned char is_anim
);

extern	GDI_HANDLE	Draw_Picture_ondesk_by_name		//通用画图函数,桌面专用
(
	unsigned char driv,
	char *gb_name,
	int off_XX,
	int off_YY,
	unsigned char is_anim
);

extern	void	Set_GOBACK_NORMAL(void);			//防死机的补丁
extern	void	Return_and_DisplayIdleScreen(void);		//返回待机界面
extern	int	MY_OPENFILE(unsigned char divc,char *file_name,unsigned int type);	//打开指定文件
extern	void	MY_GB_TO_UNICODE				//GB码转换成UNICODE码
(
	unsigned char *pOutBuffer,
	unsigned char *pInBuffer,
	unsigned int OutLen
);
extern	int	MY_DELETE_FILE(unsigned char divc, char *file_name);	//删除指定文件
extern	int	FS_Open(const unsigned short * FileName, unsigned int Flag);	//打开文件,文件名是UNICODE码
extern	int	FS_Close(int FileHandle);					//关闭文件
//读写操作
extern	int	FS_Read(int FileHandle, void * DataPtr, unsigned int Length, unsigned int * Read);
extern	int	FS_Write(int FileHandle, void * DataPtr, unsigned int Length, unsigned int * Written);
extern	int	FS_Seek(int FileHandle, int Offset, int Whence);
extern	int	FS_Delete(const unsigned short * FileName);	//删除文件,文件名是UNICODE码
extern	int	FS_GetFileSize(int FileHandle, unsigned int* Size);	//得到文件大小
extern	int	FS_GetDrive(UINT Type, UINT Serial, UINT AltMask);
extern	void	MY_Renamefile(char *name,char *newname);	//文件重命名
extern	int	FS_Rename(const WCHAR *FileName, const WCHAR *NewName);
extern	void	StartTimer(U16 timerid, U32 delay, FuncPtr funcPtr);
extern	void	HW_StartTimer(U16 timerid, U32 delay, FuncPtr funcPtr);

extern	kal_int8	soc_create
(
	kal_uint8	domain,
	kal_uint8	type,
	kal_uint8	protocol,
	kal_uint16	mod_id,
	kal_uint32	nwk_account_id
);
extern	kal_int8	soc_close(kal_int8 s);
extern	kal_int8	soc_accept(kal_int8 s, sockaddr_struct *addr);
extern	kal_int8	soc_connect(kal_int8 s, sockaddr_struct *addr);
extern	kal_int32	soc_send
(
	kal_int8	s,
	kal_uint8	*buf,
	kal_int32	len,
	kal_uint8	flags
);
extern	kal_int32	soc_recv
(
	kal_int8	s,
	kal_uint8	*buf,
	kal_int32	len,
	kal_uint8	flags
);

extern	kal_int8	soc_gethostbyname
(
	kal_bool		is_blocking,
	kal_uint16		mod_id,
	kal_int32		request_id,
	const	kal_char	*domain_name,
	kal_uint8		*addr,
	kal_uint8		*addr_len,
	kal_uint8		access_id,
	kal_uint32		account_id
);

extern	kal_int8	soc_setsockopt
(
	kal_int8	s,
	kal_uint16	option,
	kal_uint8	*val,
	kal_uint8	val_size
);

#ifndef MMI_ON_HARDWARE_P
	soc_init_win32();
#endif

//禁止显示状态条
extern	void	hide_status_icon_bars(void);

////设置文字光标
extern	void	UI_move_text_cursor(S32 x, S32 y);
////设置文字颜色
extern	void	UI_set_text_color(color c);
////颜色转换
extern	color	UI_color(U8 r, U8 g, U8 b);
////格式化输出
extern	S32	UI_printf(const S8 *format, ...);
////输出文字
extern	void	UI_print_text(UI_string_type text);
////文字边缘颜色
extern	void	UI_set_text_border_color(color c);
////输出带边缘的文字
extern	void	UI_print_bordered_text(UI_string_type text);
////得到当前字的宽度
extern	S32	UI_get_character_width(UI_character_type c);
////得到当前字的高度
extern	S32	UI_get_character_height(void);
////设置字体
extern	void	UI_set_font(UI_font_type f);
extern	void	close_title_status_icon(void);					//禁止显示状态条
extern	void	refresh_status_icon_display(void);				//退出程序时恢复用
extern	char	*xumx_i_strstr(char *buf, char *str);				//忽略大小写的字符串匹配函数
extern	void	Show_Text_Best							//显示文字
(
	unsigned short xx,////x坐标
	unsigned short yy,////y坐标
	unsigned short text_width, ////文字区域的长度
	unsigned short text_height,////文字区域的高度
	unsigned char *text_pt,////UNICODE的文字数据
	unsigned char R,////RGB颜色中的R
	unsigned char G,////RGB颜色中的G
	unsigned char B ////RGB颜色中的B
);
extern	void	Show_Bordor_Text_Best
(
	unsigned short xx,////x坐标
	unsigned short yy,////y坐标
	unsigned short text_width, ////文字区域的长度
	unsigned short text_height,////文字区域的高度
	unsigned char *text_pt,////UNICODE的文字数据
	unsigned char R,////RGB颜色中的R
	unsigned char G,////RGB颜色中的G
	unsigned char B,////RGB颜色中的B
	unsigned char BR,//边框R分量
	unsigned char BG,//边框G分量
	unsigned char BB//边框B分量
);
extern	void	Text_Clip_Begin(void);						//显示文件之前用
extern	void	Text_Clip_End(void);						//显示文字结束用,才能显示出来
extern	unsigned	int	UCS2_Text_len(unsigned short *text_pt);		//UNICODE码串的长度
extern	unsigned short mmi_chset_text_to_ucs2_str				//GB转UNICODE码时用到
(
	unsigned char *dest,
	unsigned short dest_size,
	unsigned char *src,
	TextEncodingEnum encoding
);
//注册窗口用的通用函数
extern	void	MY_Register_Category(void fun_ptr(void),int catid);
extern	void	MY_exitcatfun(void);	//窗口退出函数,功能只是停掉动画
extern	void	MY_graph_begin(void);
extern	void	MY_graph_and_text_begin(void);
extern	void	MY_graph_and_text_end(void);
extern	void	MY_graph_end(void);
extern	void	MY_donothing(void);	//返回函数
//得到屏幕背景和恢复背景
extern	int	MY_scr_get_scr_date(unsigned short x,unsigned short y,unsigned short x2,unsigned short y2,unsigned char *buf);
extern	int	MY_scr_put_scr_date(unsigned short x,unsigned short y,unsigned short x2,unsigned short y2,unsigned char *buf);
extern	void	MY_put_pixel(int x,int y,unsigned short color);
extern	int	MY_compute_diff_time(int oh,int om,int os,int nh,int nm,int ns);
//返回日期差,以天为单位
extern	int	MY_compute_diff_day(int oldy,int oldm,int oldd,int cury,int curm,int curd);
//显示文本控件
//必须两个函数都调用,不需要标题时标题长度传个0,其它参数传空
//只设置了上下方向键两个按键处理,进入时其它按键句柄自己设,退出时重置句柄
//如果带触笔,要用到以下两个函数翻页
extern	void	MY_show_text_down_Fun(void);
extern	void	MY_show_text_up_Fun(void);
extern	int	MY_set_show_text_to_screen_title
	(
		int title_len,
		unsigned char *title,unsigned short x,unsigned short y,
		unsigned char title_r,unsigned char title_g,unsigned char title_b
	);
extern	void	MY_show_character_to_screen
	(
		unsigned short x,unsigned short y,int pixel_width,int step_y,int line,
		unsigned char R,unsigned char G,unsigned char B,
		int data_from,	//数据来源,为0表示来自文件,否则来自数组
		char *bg,unsigned short bg_x,unsigned short bg_y,
		unsigned char *show_file_path	//data_from=0表示文件路径,否则表示要显示的数据
	);
//结束

//用于设置数字输入框用,对外接口只需要设置相应的输入框信息,然后调用MY_start_input_digit
//退出时调用取值函数得到输入框的值
//程序会重置10个数字键和左右键的句柄,其它的不变,退出此程序时要重新设置按键,或清空句柄
//程序只设置了数字键和左右方向键共12个按键处理,其它的调用之前设好
extern	void	MY_set_digit_inputbox(int which_box,int x,int y,int width,int height,int ch_x,int ch_y,
		unsigned char bk_R,unsigned char bk_G,unsigned char bk_B,
		unsigned char ch_R,unsigned char ch_G,unsigned char ch_B,
		unsigned char sbk_R,unsigned char sbk_G,unsigned char sbk_B,
		unsigned char sch_R,unsigned char sch_G,unsigned char sch_B,
		int content);

extern	void	MY_start_input_digit(int startid,int endid);
extern	int	MY_digit_get_buffer_content(int which_box);
//数字输入框END
//以下函数用于显示列表,重设了上下方向键两个句柄,返回时清空按键
//退出时调用MY_list_get_select_item得到列表选中的项目序号
//设置列表文本相关的函数
extern	void	MY_list_set_item_character(unsigned char **content,
			int total_num,int item_per_page,int step_y,int roll_item,
			unsigned char ch_R,unsigned char ch_G,unsigned char ch_B,
			unsigned char sch_R,unsigned char sch_G,unsigned char sch_B,
			int x,int y);
//设置列表背景相关内容
extern	void	MY_list_set_list_character(unsigned short x,unsigned short y,
			int width,int height,int direct,
			unsigned char bg_R,unsigned char bg_G,unsigned char bg_B,
			unsigned char sbg_R,unsigned char sbg_G,unsigned char sbg_B,
			unsigned char bor_R,unsigned char bor_G,unsigned char bor_B);
//设置分隔线属性
extern	void	MY_list_set_curline_character(int x,int y,int height_pixel,int len,
			unsigned char R,unsigned char G,unsigned char B);
//设置滚动条属性
extern	void	MY_list_set_rollbar_character(int width_pixel,
			unsigned char bg_R,unsigned char bg_G,unsigned char bg_B,
			unsigned char R,unsigned char G,unsigned B);
//开始显示列表
extern	void	MY_start_show_listtable(void);
//得到列表当前选中项的序号
extern	int	MY_list_get_select_item(void);
//列表函数,END

extern	int	MY_gen_wap_http_request(char *ip,char *pathname,char *host,int offset[],int len[],int offsetcount);
//文件下载函数,临时文件名,主机IP,要下载的文件,HOST字段,多次偏移时的特征字段,偏移位置,长度,偏移次数
extern	int	MY_http_downloaddata_with_multioffset(char *tempfilename,char *ip,
			char *pathname,char *host,char *special_str,
			int offset[],int len[],int offsetcount);

extern	void	MY_write_error_info(char *info);

/*//得到字形数据
#ifdef __MMI_HINDI_ALG__
extern	U32	GetFontdata(U32 Ch, stFontAttribute Font, U8 **ppCharData, U16 *pnWidth, U16 *pnDWidth, U16 *pnHeight);
#else 
extern	U32	GetFontdata(U32 Ch, stFontAttribute Font, U8 **ppCharData, U16 *pnWidth, U16 *pnHeight);
#endif
*/
extern S32	my_getfontdata(U32 Ch, stFontAttribute Font, U8 **ppCharData, U16 *pnWidth, U16 *pnHeight);

//按像素输出字符串函数
extern	void	MY_show_str_by_pixel(int x,int y,int width,int height,int t,int v,
			     unsigned char *uni_buf,
			     unsigned char R,
			     unsigned char G,
			     unsigned char B);
//滚屏用的函数
extern	void	MY_character_set_run_id(int id);
extern	void	MY_character_set_roll_screen
	(
		int timerid,int cycle,unsigned char *bk_buf,
		unsigned char R,unsigned char G,unsigned char B,
		int character_type,
		unsigned char BR,unsigned char BG,unsigned char BB,
		int skip_pixel,int skip_pixel_once,int posflag,int fun_ptr(void)
	);
extern	void	MY_character_start_roll_screen(unsigned char *buf,int x1,int y1,int x2,int y2,int flag);
//返回GB码TEXT显示时的总行数,并将每一行的起始下标记录到ARRAY数组中.负数表示出错状态
//array,数组记录每行起始的下标;maxline,最大行数,即ARRAY的边界值;TEXT,GB码的文本串;PIXEL,每行的像素数
extern	int	roll_news_analacy_text_by_pixel(int array[],int maxline,unsigned char *text,int pixel);
extern	void	MY_show_copyright(int timer_id,int delay,void return_fun(void));
//得到系统时间的接口,目前只兼容25和28平台
extern	void	MY_getdatetime(MYTIME *t);
extern	void	MY_send_message(unsigned char *content,unsigned char *num);
//非阻塞式下载
extern	void	MY_download_stop_download(void);
extern	void	MY_noblock_download_file(char *tempfilename,int filecount,
			void download_finish_exec_fun(int result),
			int analacy_download_file(char *tempfile,int whichfile),
			int gen_request(int whichfile));