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

#include <stdio.h>
#include <techtype.h>
#include <dbgfuncs.h>
#include "stberc.h"
#include "stbhwav.h"
#include "stbdpc.h"
#include "stbvtc.h"
#include "ap_dbacc.h"
#include "ap_cntrl.h"
#include "app.h"
#include "ap_cfg.h"
#include "ap_uiinfo.h"
#include "dvbmh_int.h"
#include "dvb_video.h"

Functions
void	DVBMH_PlayVideo (U8BIT path, U16BIT video_pid, E_STB_DP_VIDEO_CODEC codec)

E_MhegErr	DVB_MhegVideoPlayDefault (void)
	MHEG5 engine gives control of Video to external application. Set decoding and presentation of Video according to the default user selection. More...

E_MhegErr	DVB_MhegVideoPlayStream (S_DvbComponent *pDvbComponent)
	MHEG5 engine takes control of Video - and informs that Video must be switched to the specified Video stream. This setting takes effect regardless of whether or not an video stream is currently playing. If the locator references a service component that is not currently being broadcast, the audio should be muted until the referenced component is being broadcast. More...

E_MhegErr	DVB_MhegVideoStopStream (void)
	MHEG5 engine takes control of Video - and specifies that decoding and presentation of any Video stream must be stopped. More...

E_MhegErr	DVB_MhegVideoPlayIFrame (U8BIT *pVideoData, U32BIT dataLength, E_VideoEncoding encoding)
	Instruct the controlling application to decode supplied video data. The I-Frame is displayed in the video decoder display buffer. Its scaling and position is affected by calls to DVB_MhegVideoPosition(). Decode and display of I-frames is mutually exclusive to the decoding of video streams. The display of I-frames is subject to decoder format conversion (DFC) and display signaling as specified in section 6.5.4.6 of reference [1]. The DFC and signaling applied is dependant on the Scene or Image aspect ratio, the TV aspect ratio and the I-Frame scaling mode (as derived from the content hook). The I-Frame data passed MUST be copied if it is required after this function returns, as the caller retains exclusive ownership. All other video/iframe functions (eg. DVB_MhegVideoIFrameStop) should apply to the current Iframe (regardless of the encoding specified) More...

E_MhegErr	DVB_MhegVideoStopIFrame (void)
	Instruct the controlling application to stop displaying the previously supplied video data in DVB_MhegVideoPlayIFrame. More...

E_MhegErr	DVB_MhegVideoSetUpdating (E_VideoState displayState)
	Switch between frozen or unfrozen video display (reacting on either the current or subsequent frame), and remain in force until set again. This setting takes effect regardless of whether a video stream is currently playing. This MUST be a non-blocking function. More...

E_MhegErr	DVB_MhegSubtitleSetVisibility (E_DvbSubtitleShowState showState)
	Show or hide DVB subtitles. This operation remains in force until set again by another call to this function. This setting takes effect regardless of whether there is a subtitle stream currently playing. If a subtitle stream starts playing whilst in the hidden state, it will not have a visible effect until the show state is selected. More...

BOOLEAN	DVBMH_ShowSubtitles (void)

BOOLEAN	DVB_MhegGetSubtitlePref (void)
	This function is used by the MHEG-5 engine to determine whether subtitles are currently enabled. This may be used to allow a content provider to make available streams with and without subtitles to avoid streaming unused data. More...

U8BIT	DVB_MhegPrefSubtitleLangs (U32BIT *langs, U8BIT max)
	Get list of preferred subtitle 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. More...

void	DVB_MhegSetScalingResolution (U16BIT width, U16BIT height)
	Set Mheg scaling resolution for video. More...

void	DVB_MhegSetVideoScaling (S_RECTANGLE *scaling)
	Set Mheg video scaling. More...

void	DVB_MhegSetAspectRatio (E_ASPECT_RATIO aspect)
	Set display aspect ratio. More...

E_ASPECT_RATIO	DVB_MhegGetDisplayAspectRatio (void)
	Get display aspect ratio. More...

E_FORMAT_CONVERSION	DVB_MhegGetDecoderFormatConversion (void)
	Return the current decoder format conversion. More...

void	DVB_MhegSetVideoAlignment (E_VIDEO_ASPECT_MODE mode)

Detailed Description

DVB Interface for MHEG5 engine - Tuner.

Date: February 2014

Author: Adam Sturtridge

Function Documentation

E_FORMAT_CONVERSION DVB_MhegGetDecoderFormatConversion ( void )

Return the current decoder format conversion.

Parameters

context - transformation calculator context

Returns: Decoder format conversion

E_ASPECT_RATIO DVB_MhegGetDisplayAspectRatio ( void )

Get display aspect ratio.

Returns: display aspect ratio

BOOLEAN DVB_MhegGetSubtitlePref ( void )

This function is used by the MHEG-5 engine to determine whether subtitles are currently enabled. This may be used to allow a content provider to make available streams with and without subtitles to avoid streaming unused data.

Returns: BOOLEAN; TRUE if the user turned the subtitles on, FALSE otherwise.

U8BIT DVB_MhegPrefSubtitleLangs	(	U32BIT *	langs,
		U8BIT	max
	)

Get list of preferred subtitle 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.

Parameters

langs	Array of ISO 639 language codes to be returned
max	maximum number of preferred languages required by caller

Returns: number of actual language code preferences

void DVB_MhegSetAspectRatio ( E_ASPECT_RATIO aspect )

Set display aspect ratio.

Parameters

aspect - display aspect ratio

Returns: None

void DVB_MhegSetScalingResolution	(	U16BIT	width,
		U16BIT	height
	)

Set Mheg scaling resolution for video.

Parameters

width	- width resolution
height	- height resolution

Returns: None

void DVB_MhegSetVideoScaling ( S_RECTANGLE * scaling )

Set Mheg video scaling.

Parameters

scaling - scaling transformation (offset, size)

Returns: None

E_MhegErr DVB_MhegSubtitleSetVisibility ( E_DvbSubtitleShowState showState )

Show or hide DVB subtitles. This operation remains in force until set again by another call to this function. This setting takes effect regardless of whether there is a subtitle stream currently playing. If a subtitle stream starts playing whilst in the hidden state, it will not have a visible effect until the show state is selected.

Parameters

showState MHEG5_DVB_SUBTITLE_SHOW if subtitles should be shown MHEG5_DVB_SUBTITLE_HIDE if subtitles should be hidden

Returns

- MHERR_OK on success

MHERR_OTHER controlling application specific error.

E_MhegErr DVB_MhegVideoPlayDefault ( void )

MHEG5 engine gives control of Video to external application. Set decoding and presentation of Video according to the default user selection.

Returns: MHERR_OK - Success, MHERR_OTHER - failure

E_MhegErr DVB_MhegVideoPlayIFrame	(	U8BIT *	pVideoData,
		U32BIT	dataLength,
		E_VideoEncoding	encoding
	)

Instruct the controlling application to decode supplied video data. The I-Frame is displayed in the video decoder display buffer. Its scaling and position is affected by calls to DVB_MhegVideoPosition(). Decode and display of I-frames is mutually exclusive to the decoding of video streams. The display of I-frames is subject to decoder format conversion (DFC) and display signaling as specified in section 6.5.4.6 of reference [1]. The DFC and signaling applied is dependant on the Scene or Image aspect ratio, the TV aspect ratio and the I-Frame scaling mode (as derived from the content hook). The I-Frame data passed MUST be copied if it is required after this function returns, as the caller retains exclusive ownership. All other video/iframe functions (eg. DVB_MhegVideoIFrameStop) should apply to the current Iframe (regardless of the encoding specified)

Parameters

pVideoData	Pointer to video data block
dataLength	Length of video data block.
encoding	Video encoding used in iframe

Returns

- MHERR_OK on success

MHERR_BAD_PARAMETER invalid parameter
MHERR_OTHER controlling application specific error.

E_MhegErr DVB_MhegVideoPlayStream ( S_DvbComponent * pDvbComponent )

MHEG5 engine takes control of Video - and informs that Video must be switched to the specified Video stream. This setting takes effect regardless of whether or not an video stream is currently playing. If the locator references a service component that is not currently being broadcast, the audio should be muted until the referenced component is being broadcast.

Returns

- MHERR_OK on success

MHERR_BAD_PARAMETER invalid parameter
MHERR_OTHER controlling application specific error.

E_MhegErr DVB_MhegVideoSetUpdating ( E_VideoState displayState )

Switch between frozen or unfrozen video display (reacting on either the current or subsequent frame), and remain in force until set again. This setting takes effect regardless of whether a video stream is currently playing. This MUST be a non-blocking function.

Parameters

displayState VGR_VIDEO_FREEZE or VGR_VIDEO_UNFREEZE

Returns

- MHERR_OK on success

MHERR_OTHER controlling application specific error.

E_MhegErr DVB_MhegVideoStopIFrame ( void )

Instruct the controlling application to stop displaying the previously supplied video data in DVB_MhegVideoPlayIFrame.

Returns

- MHERR_OK on success

MHERR_OTHER controlling application specific error.

E_MhegErr DVB_MhegVideoStopStream ( void )

MHEG5 engine takes control of Video - and specifies that decoding and presentation of any Video stream must be stopped.

Returns: MHERR_OK - Success, MHERR_OTHER - failure

Functions

Detailed Description

Function Documentation