MHEG  17.9.0
 All Data Structures Files Functions Variables Typedefs Enumerations Macros Pages
mheg5_keypress.h
Go to the documentation of this file.
1 /*******************************************************************************
2  * Copyright © 2014 The DTVKit Open Software Foundation Ltd (www.dtvkit.org)
3  * Copyright © 2013 Ocean Blue Software Ltd
4  *
5  * This file is part of a DTVKit Software Component
6  * You are permitted to copy, modify or distribute this file subject to the terms
7  * of the DTVKit 1.0 Licence which can be found in licence.txt or at www.dtvkit.org
8  *
9  * THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
10  * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES
11  * OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
12  *
13  * If you or your organisation is not a member of DTVKit then you have access
14  * to this source code outside of the terms of the licence agreement
15  * and you are expected to delete this and any associated files immediately.
16  * Further information on DTVKit, membership and terms can be found at www.dtvkit.org
17  *******************************************************************************/
25 #ifndef _MHEG5_KEYPRESS_H
26 #define _MHEG5_KEYPRESS_H
27 
28 #include "techtype.h"
29 
30 /*---Constant and macro definitions for public use-----------------------------*/
31 
32 /*---Enumerations for public use-----------------------------------------------*/
33 
34 /* User interface key presses given to MHEG5 engine */
35 typedef enum
36 {
37  MHEG5_KEY_UP,
38  MHEG5_KEY_DOWN,
39  MHEG5_KEY_LEFT,
40  MHEG5_KEY_RIGHT,
41  MHEG5_KEY_0,
42  MHEG5_KEY_1,
43  MHEG5_KEY_2,
44  MHEG5_KEY_3,
45  MHEG5_KEY_4,
46  MHEG5_KEY_5,
47  MHEG5_KEY_6,
48  MHEG5_KEY_7,
49  MHEG5_KEY_8,
50  MHEG5_KEY_9,
51  MHEG5_KEY_SELECT,
52  MHEG5_KEY_CANCEL,
53  MHEG5_KEY_HELP,
54  MHEG5_KEY_RED,
55  MHEG5_KEY_GREEN,
56  MHEG5_KEY_YELLOW,
57  MHEG5_KEY_BLUE,
58  MHEG5_KEY_TEXT,
59  MHEG5_KEY_INFO,
60  MHEG5_KEY_EPG,
61  MHEG5_KEY_STOP,
62  MHEG5_KEY_PLAY,
63  MHEG5_KEY_PAUSE,
64  MHEG5_KEY_SKIP_FWD,
65  MHEG5_KEY_SKIP_BACK,
66  MHEG5_KEY_FAST_FWD,
67  MHEG5_KEY_REWIND,
68  MHEG5_KEY_PLAY_PAUSE,
69  MHEG5_KEY_RECORD,
70 
71  /* Last item is not a real key and should not be passed as a key press
72  * It is only useful as definitive value for total number of keys */
73  TOTAL_MHEG5_KEYS
74 } E_MHEG5_KEY;
75 
76 /*---Global type defs for public use-------------------------------------------*/
77 
78 /*---Global Function prototypes for public use---------------------------------*/
79 
86 BOOLEAN MHEG5_NotifyKeyPress( E_MHEG5_KEY key );
87 
94 BOOLEAN MHEG5_IsKeyNeeded( E_MHEG5_KEY key );
95 
109 
116 void MHEG5_KeySupportDisabled(E_MHEG5_KEY key);
117 
123 void MHEG5_KeySupportEnabled(E_MHEG5_KEY key);
124 
125 
126 #endif // _MHEG5_KEYPRESS_H
void MHEG5_KeySupportEnabled(E_MHEG5_KEY key)
Key press support is enabled. May be called after the key has been disabled by MHEG5_KeySupportDisabl...
Definition: mh5keypress.c:1293
void MHEG5_KeySupportDisabled(E_MHEG5_KEY key)
Inform MHEG5 engine that key is not supported by the platform or product. By default MHEG5 engine ass...
Definition: mh5keypress.c:1280
System Wide Global Technical Data Type Definitions.
BOOLEAN MHEG5_NotifyKeyPress(E_MHEG5_KEY key)
Notify MHEG5 engine of a key press. If FALSE is returned, the external application may use the key...
Definition: mh5keypress.c:1214
BOOLEAN MHEG5_IsPromotionalLinkingEnabled(void)
This function is relevant to PVR products that support NativeApplicationExtension for broadcast-trigg...
Definition: mh5keypress.c:1269
BOOLEAN MHEG5_IsKeyNeeded(E_MHEG5_KEY key)
Enquire from MHEG5 engine about whether a key is needed, without actually passing the key to it...
Definition: mh5keypress.c:470