DVB Interface for MHEG5 engine - Audio. More...

#include <stdio.h>
#include <techtype.h>
#include <dbgfuncs.h>
#include "stbgc.h"
#include "stberc.h"
#include "app.h"
#include "ap_cfg.h"
#include "ap_uiinfo.h"
#include "dvb_misc.h"
#include "dvb_ci.h"

Functions
E_MhegErr	DVB_MhegRequestMPEGDecoder (E_DecoderRequest request, BOOLEAN *pResult)
	This function requests exclusive access to a MPEG decoder and video plane to display I-frames. The MPEG decoder shall be available when no other application environment is active. More...

E_MhegErr	DVB_MhegSuppressMHEGGraphics (BOOLEAN suppress)
	Toggle between displaying MHEG graphics and subtitles on platforms that do not support them both symultaneously, while kepping the MHEG application running. Platforms that can display both symultaneously may ignore calls to this function. More...

void	DVB_MhegPromotionalLinkControl (BOOLEAN isEnabled)
	This function is relevant to PVR products that support NativeApplicationExtension for broadcast-triggered native applications, or "Promotional Linking". See sections 8.5.11 and 13.6.4 of reference [1]. More...

E_MhegErr	DVB_MhegGetLocalTime (S_DateTime *pDateAndTime)
	Provide the current local time and date, normally from the system real time clock, with any local time conversions (if necessary). The returned time should take into account local timezone and daylight saving settings. More...

U8BIT	DVB_MhegOsdLanguageCodes (U32BIT *langcodes, U8BIT max)
	Return the language of the native UI (menu etc.) as a list of language codes in 32 bit integer form. This may include alternative language codes which refer to same language (e.g. 'wel' and 'cym' which give 0x) More...

Detailed Description

DVB Interface for MHEG5 engine - Audio.

Date: Janauary 2014

Author: Adam Sturtridge

Function Documentation

E_MhegErr DVB_MhegGetLocalTime ( S_DateTime * pDateAndTime )

Provide the current local time and date, normally from the system real time clock, with any local time conversions (if necessary). The returned time should take into account local timezone and daylight saving settings.

This MUST be a non-blocking function, returning results immediately.

pDateAndTime Pointer to return current local time and date

U8BIT DVB_MhegOsdLanguageCodes	(	U32BIT *	langcodes,
		U8BIT	max
	)

Return the language of the native UI (menu etc.) as a list of language codes in 32 bit integer form. This may include alternative language codes which refer to same language (e.g. 'wel' and 'cym' which give 0x)

Parameters

language	pointer to array of language codes
max	max number of language codes

Returns: The number of language code 32 bit values

void DVB_MhegPromotionalLinkControl ( BOOLEAN isEnabled )

This function is relevant to PVR products that support NativeApplicationExtension for broadcast-triggered native applications, or "Promotional Linking". See sections 8.5.11 and 13.6.4 of reference [1].

The state can be changed by MHEG application at any time (eg. while promotional link icon is being displayed). The PVR product must remember this state. It can only be changed by another call to this function from Voyager.

If the external application is displaying any promotional linking and the state is set to FALSE, then this must be removed from the screen.

Also, the state indicates whether MHEG group 3 keys (CANCEL, RED, GREEN, YELLOW, BLUE, TEXT) may be intercepted by the external application for promotional linking. Only when the state is set to TRUE, can group 3 keys be used for broadcast-triggered native application. If the key is not consumed for this purpose, then it must be presented to VGR_NotifyKeyPress(), as normal.

Parameters

isEnabled TRUE - Promotional linking is allowed FALSE - disable promotional linking.

E_MhegErr DVB_MhegRequestMPEGDecoder	(	E_DecoderRequest	request,
		BOOLEAN *	pResult
	)

This function requests exclusive access to a MPEG decoder and video plane to display I-frames. The MPEG decoder shall be available when no other application environment is active.

Parameters

request	MHEG5_DECODER_REQUEST if access to the MPEG decoder is requested MHEG5_DECODER_RELEASE if access to the MPEG decoder is released
pResult	TRUE if access to the MPEG decoder is granted FALSE if access to the MPEG decoder is not granted, or if request is MHEG5_DECODER_RELEASE

Returns: The following return values are allowed from this function: MHERR_OK - Success. MHERR_BAD_PARAMETER - Invalid parameter. MHERR_OTHER - Controlling application specific error.

E_MhegErr DVB_MhegSuppressMHEGGraphics ( BOOLEAN suppress )

Toggle between displaying MHEG graphics and subtitles on platforms that do not support them both symultaneously, while kepping the MHEG application running. Platforms that can display both symultaneously may ignore calls to this function.

Parameters

suppress TRUE: Suppress the MHEG Graphics and enable the subtitles. FALSE: Enable the MHEG Graphics and suppress subtitles.

Returns: The following return values are allowed from this function: MHERR_OK - Success. MHERR_BAD_PARAMETER - Invalid parameter. MHERR_OTHER - Controlling application specific error.

Functions

Detailed Description

Function Documentation