midware/stb/src/vtc.h File Reference

Blank description. More...

#include "techtype.h"
#include "stbhwav.h"
#include "vtctype.h"

Include dependency graph for vtc.h:

Go to the source code of this file.

Data Structures
struct	s_vt_options
Typedefs
typedef struct s_vt_options	S_VT_OPTIONS
typedef void(*	F_VT_NOTIFICATION_CALLBACK )(void *userdata)
Functions
void *	VT_Open (S_VT_OPTIONS *options)
	Open video transformation manager.
void	VT_Close (void *context)
	Close video transformation manager.
void	VT_Enable (void *context, BOOLEAN enable)
	Enable or disable transformation calculations.
void	VT_SetAfd (void *context, U8BIT afd_value)
	Set current AFD (active format descriptor value)
void	VT_SetVideoAspectRatio (void *context, E_ASPECT_RATIO aspect_ratio)
	Set video aspect ratio.
E_ASPECT_RATIO	VT_GetVideoAspectRatio (void *context)
	Get video aspect ratio.
void	VT_SetMhegAspectRatio (void *context, E_ASPECT_RATIO aspect_ratio)
	Set MHEG5 scene aspect ratio.
E_ASPECT_RATIO	VT_GetDisplayAspectRatio (void *context)
	Get display aspect ratio.
void	VT_SetDisplayAspectRatio (void *context, E_ASPECT_RATIO aspect_ratio)
	Set display aspect ratio.
void	VT_SetMhegScalingResolution (void *context, U16BIT width, U16BIT height)
	Set Voyager scaling resolution.
void	VT_SetMhegScaling (void *context, S_RECTANGLE *scaling)
	Set MHEG-5 scaling information.
void	VT_SetAppScaling (void *context, S_RECTANGLE *window)
	Set application scaling information.
void	VT_SetVideoResolution (void *context, U16BIT width, U16BIT height)
	Set video resolution.
void	VT_SetScreenResolution (void *context, U16BIT width, U16BIT height)
	Set screen resolution.
void	VT_SetProfileMheg5 (void *context, BOOLEAN enable)
	Set profile to apply MHEG5 option.
void	VT_SetProfileHbbtv (void *context, BOOLEAN enable)
	Set profile to apply HBBTV option.
void	VT_SetHbbtvWindow (void *context, S_RECTANGLE *output)
	Set HBBTV output window.
void	VT_SetMhegVideoAlignment (void *context, E_VIDEO_ASPECT_MODE wam)
	Set widescreeen alignment mode for MHEG-5.
void	VT_GetVideoTransformation (void *context, S_RECTANGLE *input_rect, S_RECTANGLE *output_rect)
	Get the current video transfromation rectangles.
void	VT_GetWss (void *context, U8BIT *wss)
	Return WSS (wide-screen signalling) value.
void	VT_SetVideoChangedCallback (void *context, F_VT_NOTIFICATION_CALLBACK callback, void *user_data)
	Set video change callback.
void	VT_SetUserPreferenceChangedCallback (void *context, F_VT_NOTIFICATION_CALLBACK callback, void *user_data)
	Set user preference change callback.
E_FORMAT_CONVERSION	VT_GetDecoderFormatConversion (void *context)
	Return the current decoder format conversion.
void	VT_GetScreenResolution (void *context, U16BIT *width, U16BIT *height)
	Return the current screen resolution.
void	VT_GetVideoResolution (void *context, U16BIT *width, U16BIT *height)
	Return the current video resolution.
BOOLEAN	VT_IsOsdScaled (void *context)
	Check if osd must be scaled due to MHEG scene aspect ratio.
void	VT_SetVideoAlignmentPref (void *context, E_VIDEO_ASPECT_MODE alignment)
	Set user preference for video aspect ratio.
void	VT_SetDecoderStatus (void *context, E_STB_AV_DECODER_STATUS status)
	Set the decoder status.
E_STB_AV_DECODER_STATUS	VT_GetDecoderStatus (void *context)
	Get the decoder status.

---

Detailed Description

Blank description.

Date:

01/12/2004

Author:

Ocean Blue

---

Function Documentation

void VT_Close

(

void *

context

)

Close video transformation manager.

**************************************************************************

Parameters:

context

- transformation calculator context

void VT_Enable	(	void *	context,
		BOOLEAN	enable
	)

Enable or disable transformation calculations.

**************************************************************************

Parameters:

context	- transformation calculator context
enable	- TRUE if calculations are enabled, FALSE otherwise

E_FORMAT_CONVERSION VT_GetDecoderFormatConversion

(

void *

context

)

Return the current decoder format conversion.

**************************************************************************

Parameters:

context

- transformation calculator context

Returns:

Decoder format conversion

E_STB_AV_DECODER_STATUS VT_GetDecoderStatus

(

void *

context

)

Get the decoder status.

**************************************************************************

Parameters:

context

- transformation calculator context

Returns:

The decoder status

E_ASPECT_RATIO VT_GetDisplayAspectRatio

(

void *

context

)

Get display aspect ratio.

**************************************************************************

Parameters:

context

- transformation calculator context

Returns:

E_ASPECT_RATIO of display

void VT_GetScreenResolution	(	void *	context,
		U16BIT *	width,
		U16BIT *	height
	)

Return the current screen resolution.

**************************************************************************

Parameters:

context	- transformation calculator context
width	- screen width
height	- screen height

E_ASPECT_RATIO VT_GetVideoAspectRatio

(

void *

context

)

Get video aspect ratio.

**************************************************************************

Parameters:

context

- transformation calculator context

Returns:

aspect_ratio - video aspect ratio

void VT_GetVideoResolution	(	void *	context,
		U16BIT *	width,
		U16BIT *	height
	)

Return the current video resolution.

**************************************************************************

Parameters:

context	- transformation calculator context
width	- video width
height	- video height

void VT_GetVideoTransformation	(	void *	context,
		S_RECTANGLE *	input_rect,
		S_RECTANGLE *	output_rect
	)

Get the current video transfromation rectangles.

**************************************************************************

Parameters:

context	- transformation calculator context
input_rect	- input rectangle for transformation
output_rect	- output rectangle for transformation

void VT_GetWss	(	void *	context,
		U8BIT *	wss
	)

Return WSS (wide-screen signalling) value.

**************************************************************************

Parameters:

context	- transformation calculator context
wss	- WSS value

BOOLEAN VT_IsOsdScaled

(

void *

context

)

Check if osd must be scaled due to MHEG scene aspect ratio.

**************************************************************************

Parameters:

context

- transformation calculator context

Returns:

TRUE if osd scaling is required, FALSE otherwise

void* VT_Open

(

S_VT_OPTIONS *

options

)

Open video transformation manager.

**************************************************************************

Parameters:

options

- transformation manager options

Returns:

Pointer to manager context, NULL if cannot be created

void VT_SetAfd	(	void *	context,
		U8BIT	afd_value
	)

Set current AFD (active format descriptor value)

**************************************************************************

Parameters:

context	- transformation calculator context
afd_value	- AFD value

void VT_SetAppScaling	(	void *	context,
		S_RECTANGLE *	window
	)

Set application scaling information.

**************************************************************************

Parameters:

context	- transformation calculator context
window	- output window (screen CS)

Note:

When window is NULL, application scaling is turned off

void VT_SetDecoderStatus	(	void *	context,
		E_STB_AV_DECODER_STATUS	status
	)

Set the decoder status.

**************************************************************************

Parameters:

context	- transformation calculator context
status	- New decoder status

void VT_SetDisplayAspectRatio	(	void *	context,
		E_ASPECT_RATIO	aspect_ratio
	)

Set display aspect ratio.

**************************************************************************

Parameters:

context	- transformation calculator context
aspect_ratio	- video aspect ratio

void VT_SetHbbtvWindow	(	void *	context,
		S_RECTANGLE *	output
	)

Set HBBTV output window.

**************************************************************************

Parameters:

context	- transformation calculator context
output	- window

void VT_SetMhegAspectRatio	(	void *	context,
		E_ASPECT_RATIO	aspect_ratio
	)

Set MHEG5 scene aspect ratio.

**************************************************************************

Parameters:

context	- transformation calculator context
aspect_ratio	- scene aspect ratio

void VT_SetMhegScaling	(	void *	context,
		S_RECTANGLE *	scaling
	)

Set MHEG-5 scaling information.

**************************************************************************

Parameters:

context	- transformation calculator context
scaling	- scaling and positioning transformation

Note:

When scaling is NULL, scaling is ignored and the behaviour will be as if full screen video is mapped to the full screen.

void VT_SetMhegScalingResolution	(	void *	context,
		U16BIT	width,
		U16BIT	height
	)

Set Voyager scaling resolution.

**************************************************************************

Parameters:

context	- transformation calculator context
width
height

void VT_SetMhegVideoAlignment	(	void *	context,
		E_VIDEO_ASPECT_MODE	wam
	)

Set widescreeen alignment mode for MHEG-5.

**************************************************************************

Parameters:

context	- transformation calculator context
wam	- widescreen alignment mode

void VT_SetProfileHbbtv	(	void *	context,
		BOOLEAN	enable
	)

Set profile to apply HBBTV option.

**************************************************************************

Parameters:

context	- transformation calculator context
enable	- TRUE turns MHEG5 option on

void VT_SetProfileMheg5	(	void *	context,
		BOOLEAN	enable
	)

Set profile to apply MHEG5 option.

**************************************************************************

Parameters:

context	- transformation calculator context
enable	- TRUE turns MHEG5 option on

void VT_SetScreenResolution	(	void *	context,
		U16BIT	width,
		U16BIT	height
	)

Set screen resolution.

**************************************************************************

Parameters:

context	- transformation calculator context
width	- screen width (in pixels)
height	- screen height (in pixels)

void VT_SetUserPreferenceChangedCallback	(	void *	context,
		F_VT_NOTIFICATION_CALLBACK	callback,
		void *	user_data
	)

Set user preference change callback.

************************************************************************** The callback is called whenever the video transformation changes as a result of a change in user preferences.

Parameters:

context	- transformation calculator context
callback	- the callback to call
user_data	- user data to pass to the callback

void VT_SetVideoAlignmentPref	(	void *	context,
		E_VIDEO_ASPECT_MODE	alignment
	)

Set user preference for video aspect ratio.

**************************************************************************

Parameters:

context	- transformation calculator context
alignment	- New video alignment preference:

void VT_SetVideoAspectRatio	(	void *	context,
		E_ASPECT_RATIO	aspect_ratio
	)

Set video aspect ratio.

**************************************************************************

Parameters:

context	- transformation calculator context
aspect_ratio	- video aspect ratio

void VT_SetVideoChangedCallback	(	void *	context,
		F_VT_NOTIFICATION_CALLBACK	callback,
		void *	user_data
	)

Set video change callback.

************************************************************************** The callback is called whenever the video transformation is changed for any reason.

Parameters:

context	- transformation calculator context
callback	- the callback to call
user_data	- user data to pass to the callback

void VT_SetVideoResolution	(	void *	context,
		U16BIT	width,
		U16BIT	height
	)

Set video resolution.

**************************************************************************

Parameters:

context	- transformation calculator context
width	- video width (in pixels)
height	- video height (in pixels)