MHEG  17.9.0
 All Data Structures Files Functions Variables Typedefs Enumerations Macros Pages
dvb_audio.h
Go to the documentation of this file.
1 /*******************************************************************************
2  * Copyright © 2014 The DTVKit Open Software Foundation Ltd (www.dtvkit.org)
3  * Copyright © 2012 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  *******************************************************************************/
41 #ifndef _DVB_AUDIO_H
42 #define _DVB_AUDIO_H
43 
44 #include "techtype.h"
45 #include "dvblocator.h"
46 #include "mherrors.h"
47 
48 /*---Constant and macro definitions for public use-----------------------------*/
49 
50 /*---Enumerations for public use-----------------------------------------------*/
51 
52 /* Control of the audio decoder's speed. As trick modes are not implemented,
53  * there are only two possibilities
54  */
55 typedef enum
56 {
57  /* Pause the audio decoding */
58  AUDIO_SPEED_PAUSE,
59 
60  /* Resume audio playback after pause */
61  AUDIO_SPEED_PLAY
62 } E_AudioSpeed;
63 
64 
65 typedef enum
66 {
67  AUDIO_ENC_MPEG2,
68  AUDIO_ENC_HEAAC,
69  AUDIO_ENC_E_AC3,
70  AUDIO_ENC_MP3
71 } E_AudioEncoding;
72 
73 /*---Global type defs for public use-------------------------------------------*/
74 
75 /*---Global Function prototypes for public use---------------------------------*/
76 
83 E_MhegErr DVB_MhegAudioPlayDefault(void);
84 
90 E_MhegErr DVB_MhegAudioStopStream(void);
91 
104 E_MhegErr DVB_MhegAudioPlayStream(S_DvbComponent *pDvbComponent);
105 
134 E_MhegErr DVB_MhegAudioPlayClip( U8BIT *pAudioData,
135  U32BIT dataLength,
136  U32BIT repeatCount,
137  E_AudioEncoding encoding );
138 
147 E_MhegErr DVB_MhegAudioStopClip(void);
148 
160 E_MhegErr DVB_MhegAudioSetSpeed(E_AudioSpeed speed);
161 
173 E_MhegErr DVB_MhegAudioSetVolume(S32BIT volumeAdjust);
174 
183 U8BIT DVB_MhegPrefAudioLangs(U32BIT *langs,U8BIT max);
184 
194 BOOLEAN DVB_MhegAudioDescriptionPref(void);
195 
196 #endif /* _PM_AUDIO_H */
Definition: dvblocator.h:37
E_MhegErr DVB_MhegAudioPlayDefault(void)
MHEG5 engine gives control of Audio to external application. Set decoding and presentation of Audio a...
MHEG5 engine interface error codes.
BOOLEAN DVB_MhegAudioDescriptionPref(void)
This function is used by the MHEG-5 engine to determine whether audio description is currently enable...
System Wide Global Technical Data Type Definitions.
U8BIT DVB_MhegPrefAudioLangs(U32BIT *langs, U8BIT max)
Get list of preferred audio languages. If there is no preference then zero is returned. This only writes into array up to 'max' items This MUST be a non-blocking function, returning results immediately.
E_MhegErr DVB_MhegAudioStopClip(void)
Instruct the controlling application that playback of the previously supplied audio clip should be st...
E_MhegErr DVB_MhegAudioPlayStream(S_DvbComponent *pDvbComponent)
MHEG5 engine takes control of Audio - and informs that Audio must be switched to the specified Audio ...
Definition of DVB locator and DVB component types.
E_MhegErr DVB_MhegAudioPlayClip(U8BIT *pAudioData, U32BIT dataLength, U32BIT repeatCount, E_AudioEncoding encoding)
Instruct the controlling application that the provided audio sound clip should be played...
E_MhegErr DVB_MhegAudioSetVolume(S32BIT volumeAdjust)
Adjust sound level for any external application sourced audio. A setting of 0 dB means leave the audi...
E_MhegErr DVB_MhegAudioSetSpeed(E_AudioSpeed speed)
Instruct the controlling application that playback of the previously supplied audio clip should be pa...
E_MhegErr DVB_MhegAudioStopStream(void)
MHEG5 engine takes control of Audio - and specifies that decoding and presentation of any Audio strea...