DVBCore  17.9.0
Open Source DVB Engine
 All Data Structures Files Functions Typedefs Macros Pages
Typedefs | Functions
stbvtc.h File Reference

Header file - macros and function prototypes for public use. More...

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

Go to the source code of this file.

Typedefs

typedef void(* F_NOTIFY_VIDEO_AR )(E_ASPECT_RATIO ar)
 

Functions

void STB_VTInitialise (void)
 Initialise the VTC module. More...
 
void STB_VTSetVideoOutput (S_RECTANGLE *output)
 DVBCore application output window for entire video. More...
 
E_ASPECT_RATIO STB_VTGetDisplayAspectRatio (void)
 Get display aspect ratio. More...
 
void STB_VTSetDisplayAspectRatio (E_ASPECT_RATIO aspect_ratio)
 Set display aspect ratio. More...
 
void STB_VTSetMhegEnable (BOOLEAN enable)
 Turn on or off MHEG5 scaling calculation. More...
 
void STB_VTSetMhegScalingResolution (U16BIT width, U16BIT height)
 Set MHEG5 scaling resolution for video. More...
 
void STB_VTSetMhegVideoScaling (S_RECTANGLE *scaling)
 Set video scaling by MHEG5. More...
 
void STB_VTSetMhegAspectRatio (E_ASPECT_RATIO aspect_ratio)
 Set scene aspect ratio (MHEG-5 specific) More...
 
void STB_VTSetMhegVideoAlignment (E_VIDEO_ASPECT_MODE mode)
 Set MHEG5 widescreen alignment. More...
 
void STB_VTSetHbbtvEnable (BOOLEAN enable)
 Turn on or off HBBTV scaling calculation. More...
 
void STB_VTSetHbbtvVideoWindow (S_RECTANGLE *rect)
 Set video scaling by HBBTV. More...
 
void STB_VTSetVideoAlignmentPref (E_VIDEO_ASPECT_MODE pref)
 Set video alignment preference. More...
 
void STB_VTCSetCustomModeCallback (F_VT_CUSTOM_MODE_CALLBACK callback)
 Sets the callback used to control the format conversion when the aspect mode set by STB_VTSetVideoAlignmentPref is ASPECT_MODE_CUSTOM. More...
 
void STB_VTSetVideoPrefChangedCallback (void(*callback)(void *), void *user_data)
 Set video preferences change callback. More...
 
void STB_VTSetVideoRatioCallback (F_NOTIFY_VIDEO_AR ar)
 Set video preferences change callback. More...
 
E_FORMAT_CONVERSION STB_VTGetDecoderFormatConversion (void)
 Return the current decoder format conversion. More...
 
void STB_VTGetVideoResolution (U16BIT *width, U16BIT *height)
 Return the current video resolution. More...
 
E_ASPECT_RATIO STB_VTGetVideoAspectRatio (void)
 Return the current video aspect ratio. More...
 

Detailed Description

Header file - macros and function prototypes for public use.

Date
27/02/2012
Author
Ocean Blue

Function Documentation

void STB_VTCSetCustomModeCallback ( F_VT_CUSTOM_MODE_CALLBACK  callback)

Sets the callback used to control the format conversion when the aspect mode set by STB_VTSetVideoAlignmentPref is ASPECT_MODE_CUSTOM.

Parameters
callbackFunction used by the VTC module to determine what format conversion needs to be applied.
E_FORMAT_CONVERSION STB_VTGetDecoderFormatConversion ( void  )

Return the current decoder format conversion.


Returns
The current format conversion
E_ASPECT_RATIO STB_VTGetDisplayAspectRatio ( void  )

Get display aspect ratio.


Parameters
aspect_ratio- display aspect ratio
Returns
None
E_ASPECT_RATIO STB_VTGetVideoAspectRatio ( void  )

Return the current video aspect ratio.


Returns
E_ASPECT_RATIO aspect ratio
void STB_VTGetVideoResolution ( U16BIT *  width,
U16BIT *  height 
)

Return the current video resolution.


Parameters
width- video width
height- video height
Returns
None
void STB_VTInitialise ( void  )

Initialise the VTC module.


Parameters
None
Returns
None
void STB_VTSetDisplayAspectRatio ( E_ASPECT_RATIO  aspect_ratio)

Set display aspect ratio.


Parameters
aspect_ratio- display aspect ratio
Returns
None
void STB_VTSetHbbtvEnable ( BOOLEAN  enable)

Turn on or off HBBTV scaling calculation.


Parameters
enableTRUE - turn on HbbTV calculations
Returns
None

Parameters
enableTRUE - turn on MHEG5 calculations
Returns
None
void STB_VTSetHbbtvVideoWindow ( S_RECTANGLE rect)

Set video scaling by HBBTV.


Parameters
rectoutput window rectangle
Returns
None
void STB_VTSetMhegAspectRatio ( E_ASPECT_RATIO  aspect_ratio)

Set scene aspect ratio (MHEG-5 specific)


Parameters
aspect_ratio- scene aspect ratio
Returns
None
void STB_VTSetMhegEnable ( BOOLEAN  enable)

Turn on or off MHEG5 scaling calculation.


Parameters
enableTRUE - turn on MHEG5 calculations
Returns
None
void STB_VTSetMhegScalingResolution ( U16BIT  width,
U16BIT  height 
)

Set MHEG5 scaling resolution for video.


Parameters
width- width resolution
height- height resolution
Returns
None

Set MHEG5 scaling resolution for video.


Parameters
width- width resolution
height- height resolution
Returns
None
void STB_VTSetMhegVideoAlignment ( E_VIDEO_ASPECT_MODE  mode)

Set MHEG5 widescreen alignment.


Parameters
mode- widescreen alignment mode
Returns
None
void STB_VTSetMhegVideoScaling ( S_RECTANGLE scaling)

Set video scaling by MHEG5.


Parameters
scaling- scaling transformation (offset, size)
Returns
None

Set video scaling by MHEG5.


Parameters
scaling- scaling transformation (offset, size)
Returns
None
void STB_VTSetVideoAlignmentPref ( E_VIDEO_ASPECT_MODE  alignment)

Set video alignment preference.


Parameters
pref- video alignment
Returns
None
void STB_VTSetVideoOutput ( S_RECTANGLE output)

DVBCore application output window for entire video.


Parameters
output- output video rectangle
Returns
None

Parameters
output- output video rectangle. NULL means full-screen, unless MHEG says duifferently.
Returns
None
void STB_VTSetVideoPrefChangedCallback ( void(*)(void *)  callback,
void *  user_data 
)

Set video preferences change callback.


The callback function is called when video transformation is changed as a result of a user preference change (only).

Parameters
callback- callback for notification
user_data- user data for the callback
Returns
None
void STB_VTSetVideoRatioCallback ( F_NOTIFY_VIDEO_AR  ar)

Set video preferences change callback.


The callback function is called when video transformation is changed as a result of a user preference change (only).

Parameters
callback- callback for notification
user_data- user data for the callback
Returns
None