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

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

MTK

开发平台：

C/C++

TouchScreenGprot.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.  * Filename:
  38.  * ---------
  39.  *   TouchScreenGprot.h
  40.  *
  41.  * Project:
  42.  * --------
  43.  *   MAUI
  44.  *
  45.  * Description:
  46.  * ------------
  47.  *   Low-level Touch Screen API
  48.  *
  49.  * Author:
  50.  * -------
  51.  * -------
  52.  *
  53.  *==============================================================================
  54.  *             HISTORY
  55.  * Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
  56.  *------------------------------------------------------------------------------
  57.  * removed!
  58.  *
  59.  * removed!
  60.  * removed!
  61.  * removed!
  62.  *
  63.  * removed!
  64.  * removed!
  65.  * removed!
  66.  *
  67.  * removed!
  68.  * removed!
  69.  * removed!
  70.  *
  71.  * removed!
  72.  * removed!
  73.  * removed!
  74.  *
  75.  * removed!
  76.  * removed!
  77.  * removed!
  78.  *
  79.  * removed!
  80.  * removed!
  81.  * removed!
  82.  *
  83.  * removed!
  84.  * removed!
  85.  * removed!
  86.  *
  87.  * removed!
  88.  * removed!
  89.  * removed!
  90.  *
  91.  * removed!
  92.  * removed!
  93.  * removed!
  94.  *
  95.  * removed!
  96.  * removed!
  97.  * removed!
  98.  *
  99.  *------------------------------------------------------------------------------
  100.  * Upper this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
  101.  *==============================================================================
  102.  *******************************************************************************/
  103. #ifndef _TOUCH_SCREEN_GPROT_H
  104. #define _TOUCH_SCREEN_GPROT_H
  106. #ifndef _KAL_NON_SPECIFIC_GENERAL_TYPES_H
  107. #error "kal_non_specific_general_types.h should be included "
  108. #endif 
  110. #ifndef _PIXCOM_DATA_TYPES_H
  111. #include "PixtelDataTypes.h"
  112. #endif 
  114. /***************************************************************************** 
  115. * Define
  116. *****************************************************************************/
  118. /*
  119.  * Whether to support Stroke LongTap Event. 
  120.  * We can use Stroke LongTap event in handwriting to control the editor
  121.  */
  122. #undef MMI_PEN_SUPPORT_STROKE_LONGTAP
  124. /* Number of doubles in one set of  calibation data */
  125. #define PEN_CALIBRATION_DATA_SIZE   4
  127. /* Utility macro functions */
  128. #define PEN_CHECK_BOUND(x, y, x1, y1, width, height) ((x) >= (x1) && (y) >= (y1) && (x) < ((x1) + (width)) && (y) < ((y1) + (height)))
  130. #define PEN_ABS(a, b) (((a) > (b)) ? (a-b) : (b-a))
  132. #define PEN_MIN(a, b) (((a) > (b)) ? (b) : (a))
  134. #define PEN_MAX(a, b) (((a) > (b)) ? (a) : (b))
  136. /* Delay time for Pen LongTap */
  137. #define MMI_PEN_LONGTAP_TIME           (60)     /* multiple of 10ms */
  139. /* Delay time for Pen Repeat */
  140. #define MMI_PEN_REPEAT_TIME            (30)     /* multiple of 10ms */
  142. /* Delay time for Stroke LongTap (MMI_PEN_SUPPORT_STROKE_LONGTAP) */
  143. #define MMI_PEN_STROKE_LONGTAP_TIME    (80)     /* multiple of 10ms */
  145. /* Sampling period of Event-Based pen events (~ 12 samples/sec) */
  146. #define MMI_PEN_SAMPLING_PERIOD_1      (8)      /* multiple of 10ms */
  148. /* Sampling period of Stroke-Based pen events (50 samples/sec) */
  149. #define MMI_PEN_SAMPLING_PERIOD_2      (2)      /* multiple of 10ms */
  151. /* If pen does not move over this distance, donot generate Pen Move event at all. */
  152. #define MMI_PEN_SKIP_MOVE_OFFSET                5
  154. /* If pen does not move over this distance, donot generate Stroke Move event at all. */
  155. #define MMI_PEN_SKIP_STROKE_MOVE_OFFSET         1
  157. /* Maximum move offset for generating LongTap event */
  158. #define MMI_PEN_SKIP_LONGTAP_OFFSET             10
  160. /* Maximum move offset for generating Stroke-LongTap event (MMI_PEN_SUPPORT_STROKE_LONGTAP) */
  161. #define MMI_PEN_SKIP_STROKE_LONGTAP_OFFSET      14
  163. /* Minimum offset to Pen Down position in order to switch from event-based mode to stroke-based mode */
  164. #if defined(MMI_PEN_SUPPORT_STROKE_LONGTAP) || defined(__MMI_HANDWRITING_PAD__)
  165. #define MMI_PEN_STROKE_MIN_OFFSET               0
  166. #else 
  167. #define MMI_PEN_STROKE_MIN_OFFSET               9
  168. #endif 
  170. #ifdef __MMI_HANDWRITING_PAD__
  171. #define IS_ENABLE_FLAG(data, f)        ( (data & (f)) == (f) )
  173. /* Touch Pad flag */
  174. #define TP_MAPPING_KEY_MASK   (0x000000FF)
  175. #define TP_MAPPING_KEY        (0x00000100)
  176. #define TP_CUSTOM_HANDLE      (0x00000200)
  177. #define TP_CONTROL_AREA       (0x80000000)
  178. #define TP_HANDWRITING_AREA   (0x40000000)
  179. #define TP_HANDWRITING_SUPPORTS_FULL_AREA   (0x20000000)
  181. #endif /* __MMI_HANDWRITING_PAD__ */ 
  183. /***************************************************************************** 
  184. * Typedef 
  185. *****************************************************************************/
  187. typedef enum
  188. {
  189.     MMI_PEN_EVENT_DOWN,
  190.     MMI_PEN_EVENT_UP,
  191.     MMI_PEN_EVENT_LONG_TAP,
  192.     MMI_PEN_EVENT_REPEAT,
  193.     MMI_PEN_EVENT_MOVE,
  194.     MMI_PEN_EVENT_ABORT,
  195.     MMI_PEN_EVENT_TYPE_MAX
  196. } mmi_pen_event_type_enum;
  198. typedef enum
  199. {
  200.     MMI_PEN_STROKE_DOWN,
  201.     MMI_PEN_STROKE_UP,
  202.     MMI_PEN_STROKE_MOVE,
  203.     MMI_PEN_STROKE_LONGTAP,
  204.     MMI_PEN_STROKE_TYPE_MAX
  205. } mmi_pen_stroke_type_enum;
  207. typedef struct
  208. {
  209.     S16 x;
  210.     S16 y;
  211. } mmi_pen_point_struct;
  213. typedef struct
  214. {
  215.     S16 x1, y1, x2, y2;
  216. } mmi_pen_handwriting_area_struct;
  218. typedef struct
  219. {
  220.     mmi_pen_point_struct *points;
  221.     S16 num;
  222. } mmi_pen_polygon_area_struct;
  224. typedef struct
  225. {
  226.     double data[PEN_CALIBRATION_DATA_SIZE];
  227. } mmi_pen_calibration_struct;
  229. typedef void (*mmi_pen_hdlr) (mmi_pen_point_struct pos);
  231. #ifdef __MMI_HANDWRITING_PAD__
  232. typedef struct tp_area_struct_tag
  233. {
  234.     kal_uint32 id;
  235.     kal_uint32 flag;
  236.     const mmi_pen_point_struct *pos;
  237.     mmi_pen_hdlr *hdlr_table;
  239. } tp_area_struct;
  241. /* for handwriting pad (end) */
  242. #endif /* __MMI_HANDWRITING_PAD__ */ 
  244. /***************************************************************************** 
  245. * Extern Global Variable
  246. *****************************************************************************/
  247. #ifdef __MMI_HANDWRITING_PAD__
  248. extern const mmi_pen_point_struct tp_calibration_point[];
  249. extern const tp_area_struct tp_area_table[];
  250. #endif /* __MMI_HANDWRITING_PAD__ */ 
  252. /***************************************************************************** 
  253. * Extern Global Function
  254. *****************************************************************************/
  255. extern void mmi_pen_dummy_hdlr(mmi_pen_point_struct);
  257. extern void mmi_pen_config_sampling_period(kal_uint32 low, kal_uint32 high);
  258. extern void mmi_pen_config_timeout_period(kal_uint32 longtap, kal_uint32 repeat, kal_uint32 stroke_longtap);
  259. extern void mmi_pen_config_move_offset(
  260.                 kal_uint32 event_based,
  261.                 kal_uint32 stroke_based,
  262.                 kal_uint32 long_tap,
  263.                 kal_uint32 stroke_long_tap);
  265. extern void mmi_pen_init(void);
  267. extern void mmi_pen_block(void);
  268. //KP Jerry add on 2007-4-11 start
  269. #ifdef __MMI_PEN_BLOCK_WHEN_KAYPAD_LOCKED__
  270. extern void mmi_pen_forced_block(void);
  271. #endif/*__MMI_PEN_BLOCK_WHEN_KAYPAD_LOCKED__*/
  272. //KP Jerry add on 2007-4-11 end
  273. extern void mmi_pen_unblock(void);
  275. extern void mmi_pen_enable(void);
  276. extern void mmi_pen_disable(void);
  277. //KP Jerry add on 2007-4-11 start
  278. #ifdef __MMI_PEN_BLOCK_WHEN_KAYPAD_LOCKED__
  279. extern void mmi_pen_forced_disable(void);
  280. #endif/*__MMI_PEN_BLOCK_WHEN_KAYPAD_LOCKED__*/
  281. //KP Jerry add on 2007-4-11 end
  282. extern void mmi_pen_reset(void);
  284. extern void mmi_pen_get_state(kal_bool *is_enabled, kal_bool *is_pen_down);
  286. /* Calibration */
  287. extern void mmi_pen_start_calibration(kal_uint16 num, const mmi_pen_point_struct *points);
  288. extern void mmi_pen_set_calibration_data(const mmi_pen_calibration_struct *data);
  289. extern void mmi_pen_read_calibration_data(mmi_pen_calibration_struct *data);
  291. /* Event-based API */
  292. extern void mmi_pen_register_down_handler(mmi_pen_hdlr pen_fp);
  293. extern void mmi_pen_register_long_tap_handler(mmi_pen_hdlr pen_fp);
  294. extern void mmi_pen_register_repeat_handler(mmi_pen_hdlr pen_fp);
  295. extern void mmi_pen_register_move_handler(mmi_pen_hdlr pen_fp);
  296. extern void mmi_pen_register_up_handler(mmi_pen_hdlr pen_fp);
  297. extern void mmi_pen_register_abort_handler(mmi_pen_hdlr pen_fp);
  299. /* Stroke-based API */
  300. extern void mmi_pen_start_capture_strokes(
  301.                 kal_uint32 max_points,
  302.                 mmi_pen_point_struct *point_array,
  303.                 kal_uint32 num_regions,
  304.                 const mmi_pen_handwriting_area_struct *region_array,
  305.                 const mmi_pen_handwriting_area_struct *ext_region);
  306. extern void mmi_pen_stop_capture_strokes(void);
  308. extern void mmi_pen_change_handwriting_area(
  309.                 kal_uint32 num_regions,
  310.                 const mmi_pen_handwriting_area_struct *region_array,
  311.                 const mmi_pen_handwriting_area_struct *ext_region);
  313. extern void mmi_pen_begin_strokes_of_character(void);
  314. extern void mmi_pen_end_strokes_of_character(void);
  316. extern void mmi_pen_register_stroke_down_handler(mmi_pen_hdlr pen_fp);
  317. extern void mmi_pen_register_stroke_move_handler(void (*begin_fp) (void), void (*end_fp) (void), mmi_pen_hdlr pen_fp);
  318. extern void mmi_pen_register_stroke_up_handler(mmi_pen_hdlr pen_fp);
  319. extern void mmi_pen_register_stroke_longtap_handler(mmi_pen_hdlr pen_fp);
  321. extern void mmi_pen_peek_stroke_state(BOOL *has_unfinished_stroke);
  323. /* Handwriting Pad */
  325. #ifdef __MMI_HANDWRITING_PAD__
  326. extern void mmi_frm_setup_default_pen_handler(void);
  327. extern S32 mmi_pen_check_inside_control_area();
  328. #endif /* __MMI_HANDWRITING_PAD__ */ 
  330. /* Utility API */
  331. extern BOOL mmi_pen_check_inside_polygon(mmi_pen_polygon_area_struct *polygon, mmi_pen_point_struct pos);
  333. #endif /* _TOUCH_SCREEN_GPROT_H */