DVBCore  20.3.0
DVBCore Documentation
Classes | Typedefs | Functions
vtc.h File Reference

Blank description. More...

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

Go to the source code of this file.

Classes

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

Detailed Description

Blank description.

Date
01/12/2004
Author
Ocean Blue

Definition in file vtc.h.

Function Documentation

◆ VT_Close()

void VT_Close ( void *  context)

Close video transformation manager.


Parameters
context- transformation calculator context

Definition at line 412 of file vtc.c.

◆ VT_Enable()

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

Definition at line 424 of file vtc.c.

◆ VT_GetDecoderFormatConversion()

E_FORMAT_CONVERSION VT_GetDecoderFormatConversion ( void *  context)

Return the current decoder format conversion.


Parameters
context- transformation calculator context
Returns
Decoder format conversion

Definition at line 939 of file vtc.c.

◆ VT_GetDecoderStatus()

E_STB_AV_DECODER_STATUS VT_GetDecoderStatus ( void *  context)

Get the decoder status.


Parameters
context- transformation calculator context
Returns
The decoder status

Definition at line 1049 of file vtc.c.

◆ VT_GetDisplayAspectRatio()

E_ASPECT_RATIO VT_GetDisplayAspectRatio ( void *  context)

Get display aspect ratio.


Parameters
context- transformation calculator context
Returns
E_ASPECT_RATIO of display

Definition at line 533 of file vtc.c.

◆ VT_GetScreenResolution()

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

Definition at line 960 of file vtc.c.

◆ VT_GetVideoAspectRatio()

E_ASPECT_RATIO VT_GetVideoAspectRatio ( void *  context)

Get video aspect ratio.


Parameters
context- transformation calculator context
Returns
aspect_ratio - video aspect ratio

Definition at line 492 of file vtc.c.

◆ VT_GetVideoResolution()

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

Definition at line 977 of file vtc.c.

◆ VT_GetVideoTransformation()

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

Definition at line 863 of file vtc.c.

◆ VT_GetWss()

void VT_GetWss ( void *  context,
U8BIT *  wss 
)

Return WSS (wide-screen signalling) value.


Parameters
context- transformation calculator context
wss- WSS value

Definition at line 879 of file vtc.c.

◆ VT_IsOsdScaled()

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

Definition at line 1007 of file vtc.c.

◆ VT_Open()

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

Definition at line 348 of file vtc.c.

◆ VT_SetAfd()

void VT_SetAfd ( void *  context,
U8BIT  afd_value 
)

Set current AFD (active format descriptor value)


Parameters
context- transformation calculator context
afd_value- AFD value

Definition at line 446 of file vtc.c.

◆ VT_SetAppScaling()

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

Definition at line 686 of file vtc.c.

◆ VT_SetCustomModeCallback()

void VT_SetCustomModeCallback ( void *  context,
F_VT_CUSTOM_MODE_CALLBACK  callback 
)

Set customer mode callback.


Parameters
context- transformation calculator context
callback- callback

Definition at line 613 of file vtc.c.

◆ VT_SetDecoderStatus()

void VT_SetDecoderStatus ( void *  context,
E_STB_AV_DECODER_STATUS  status 
)

Set the decoder status.


Parameters
context- transformation calculator context
status- New decoder status

Definition at line 1029 of file vtc.c.

◆ VT_SetDisplayAspectRatio()

void VT_SetDisplayAspectRatio ( void *  context,
E_ASPECT_RATIO  aspect_ratio 
)

Set display aspect ratio.


Parameters
context- transformation calculator context
aspect_ratio- video aspect ratio

Definition at line 548 of file vtc.c.

◆ VT_SetHbbtvWindow()

void VT_SetHbbtvWindow ( void *  context,
S_RECTANGLE output 
)

Set HBBTV output window.


Parameters
context- transformation calculator context
output- window

Definition at line 832 of file vtc.c.

◆ VT_SetMhegAspectRatio()

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

Set MHEG5 scene aspect ratio.


Parameters
context- transformation calculator context
aspect_ratio- MHEG5 scene aspect ratio

Definition at line 510 of file vtc.c.

◆ VT_SetMhegScaling()

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.

Definition at line 657 of file vtc.c.

◆ VT_SetMhegScalingResolution()

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

Set Voyager scaling resolution.


Parameters
context- transformation calculator context
width
heightSet Voyager scaling resolution.

Parameters
context- transformation calculator context
width
height

Definition at line 633 of file vtc.c.

◆ VT_SetMhegVideoAlignment()

void VT_SetMhegVideoAlignment ( void *  context,
E_VIDEO_ASPECT_MODE  mode 
)

Set widescreeen alignment mode for MHEG-5.


Parameters
context- transformation calculator context
wam- widescreen alignment mode

Definition at line 770 of file vtc.c.

◆ VT_SetProfileHbbtv()

void VT_SetProfileHbbtv ( void *  context,
BOOLEAN  enable 
)

Set profile to apply HBBTV option.


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

Parameters
context- transformation calculator context
enable- TRUE turns HBBTV option on

Definition at line 811 of file vtc.c.

◆ VT_SetProfileMheg5()

void VT_SetProfileMheg5 ( void *  context,
BOOLEAN  enable 
)

Set profile to apply MHEG5 option.


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

Definition at line 790 of file vtc.c.

◆ VT_SetScreenResolution()

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)

Definition at line 744 of file vtc.c.

◆ VT_SetUserPreferenceChangedCallback()

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

Definition at line 921 of file vtc.c.

◆ VT_SetVideoAlignmentPref()

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:

Set user preference for video aspect ratio.


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

Definition at line 572 of file vtc.c.

◆ VT_SetVideoAspectRatio()

void VT_SetVideoAspectRatio ( void *  context,
E_ASPECT_RATIO  aspect_ratio 
)

Set video aspect ratio.


Parameters
context- transformation calculator context
aspect_ratio- video aspect ratio

Definition at line 469 of file vtc.c.

◆ VT_SetVideoChangedCallback()

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

Definition at line 898 of file vtc.c.

◆ VT_SetVideoResolution()

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)

Definition at line 717 of file vtc.c.