stb_vtc.h File Reference

Video Transformation Calculator. More...

#include "techtype.h"
#include "osdtype.h"
#include "vtctype.h"

Go to the source code of this file.

Functions
E_ASPECT_RATIO	STB_VTGetDisplayAspectRatio (void)
	This function is called so the MHEG application can find out the type of display hardware being used by the receiver. Meaning the display ratio set by the customer configuration. More...
E_FORMAT_CONVERSION	STB_VTGetDecoderFormatConversion (void)
	This function is called so the MHEG application can find out the current video aspect ratio conversion applied by the receiver. More...
void	STB_VTSetMhegScalingResolution (U16BIT width, U16BIT height)
	Set MHEG5 scaling resolution for video. More...
void	STB_VTSetMhegVideoScaling (S_RECTANGLE *scaling)
	Specify position and scaling required by MHEG5 for display of video or iframe. The scaling rectangle gives the raw MHEG5 transformation. The default resolution for this rectangle is the screen resolution. More...
void	STB_VTSetMhegAspectRatio (E_ASPECT_RATIO ratio)
	Notify the controlling application of the aspect ratio of the currently running MHEG-5 Scene object. More...
void	STB_VTSetMhegVideoAlignment (E_VIDEO_ASPECT_MODE alignment)
	This function is called to force the video alignment used by the receiver when a 16:9 video is played with 4:3 scene. Default value of mode is CENTRE_CUT_OUT (1). More...

Detailed Description

Video Transformation Calculator.

Date

23/12/2013

Author

Adam Sturtridge

Function Documentation

E_FORMAT_CONVERSION STB_VTGetDecoderFormatConversion

(

void

)

This function is called so the MHEG application can find out the current video aspect ratio conversion applied by the receiver.

Returns

current video format conversion

E_ASPECT_RATIO STB_VTGetDisplayAspectRatio

(

void

)

This function is called so the MHEG application can find out the type of display hardware being used by the receiver. Meaning the display ratio set by the customer configuration.

Returns

aspect ratio of the display

void STB_VTSetMhegAspectRatio

(

E_ASPECT_RATIO

ratio

)

Notify the controlling application of the aspect ratio of the currently running MHEG-5 Scene object.

This information should be used to set the decoder format conversion and display signaling when video is shown in "tuner mode", as described in section 6.5.4.7 of reference [1].

The aspect ratio of I-frames can also be inferred from the scene aspect ratio, as described in section 4.7.1 of reference [1]. The scene aspect ratio can be used to determine decoder format conversion and display signaling when I-frames are being presented, as described in section 6.5.4.6 of reference [1]. Alternatively, the actual aspect ratio of the I-frame may be used.

Parameters

ratio

- MHEG Scene aspect ratio of 16:9, 4:3 or unspecifed (undefined)

void STB_VTSetMhegScalingResolution	(	U16BIT	width,
		U16BIT	height
	)

Set MHEG5 scaling resolution for video.

Parameters

width	- width resolution
height	- height resolution

Returns

void

void STB_VTSetMhegVideoAlignment

(

E_VIDEO_ASPECT_MODE

alignment

)

This function is called to force the video alignment used by the receiver when a 16:9 video is played with 4:3 scene. Default value of mode is CENTRE_CUT_OUT (1).

Parameters

alignment

Video 'widescreen' alignment

void STB_VTSetMhegVideoScaling

(

S_RECTANGLE *

scaling

)

Specify position and scaling required by MHEG5 for display of video or iframe. The scaling rectangle gives the raw MHEG5 transformation. The default resolution for this rectangle is the screen resolution.

Parameters

scaling

pointer to scaling rectangle, NULL means full screen