v_letterbox
Vitis Drivers API Documentation
Overview

Data Structures

struct  XV_Lbox_l2
 Letterbox Layer 2 data. More...
 

Enumerations

enum  XLboxColorId
 This typedef contains the different background colors available. More...
 

Functions

int XV_LBoxInitialize (XV_Lbox_l2 *InstancePtr, u16 DeviceId)
 This function initializes the core instance. More...
 
void XV_LBoxStart (XV_Lbox_l2 *InstancePtr)
 This function starts the letter box core. More...
 
void XV_LBoxStop (XV_Lbox_l2 *InstancePtr)
 This function stops the letter box core. More...
 
void XV_LBoxSetActiveWin (XV_Lbox_l2 *InstancePtr, XVidC_VideoWindow *ActiveWindow, u32 FrameWidth, u32 FrameHeight)
 This function configures the letterbox active window. More...
 
void XV_LboxSetBackgroundColor (XV_Lbox_l2 *InstancePtr, XLboxColorId ColorId, XVidC_ColorFormat cfmt, XVidC_ColorDepth bpc)
 This function configures the background color to be painted outside active window. More...
 
void XV_LBoxDbgReportStatus (XV_Lbox_l2 *InstancePtr)
 This function prints LBox IP status on the console. More...
 

Enumeration Type Documentation

This typedef contains the different background colors available.

Function Documentation

void XV_LBoxDbgReportStatus ( XV_Lbox_l2 InstancePtr)

This function prints LBox IP status on the console.

Parameters
InstancePtris the pointer to the core instance.
Returns
None

References XV_letterbox_Config::BaseAddress, and XV_letterbox::Config.

int XV_LBoxInitialize ( XV_Lbox_l2 InstancePtr,
u16  DeviceId 
)

This function initializes the core instance.

Parameters
InstancePtris a pointer to core instance to be worked upon
DeviceIdis instance id of the core
Returns
XST_SUCCESS if device is found and initialized XST_DEVICE_NOT_FOUND if device is not found
void XV_LBoxSetActiveWin ( XV_Lbox_l2 InstancePtr,
XVidC_VideoWindow *  ActiveWindow,
u32  FrameWidth,
u32  FrameHeight 
)

This function configures the letterbox active window.

All pixels within the window are passed to the output as-is. Any pixel outside the defined window will be clamped to the programmed background color

Parameters
InstancePtris a pointer to the core instance to be worked on.
ActiveWindowis structure that contains window coordinates and size
FrameWidthis the input stream width
FrameHeightis the input stream height
Returns
None
void XV_LboxSetBackgroundColor ( XV_Lbox_l2 InstancePtr,
XLboxColorId  ColorId,
XVidC_ColorFormat  cfmt,
XVidC_ColorDepth  bpc 
)

This function configures the background color to be painted outside active window.

Parameters
InstancePtris a pointer to the core instance to be worked on.
ColorIdis the background color requested
cfmtis the color format of the input stream
bpcis the color depth (bits per channel)
Returns
None
void XV_LBoxStart ( XV_Lbox_l2 InstancePtr)

This function starts the letter box core.

Parameters
InstancePtris a pointer to the core instance to be worked on.
Returns
None
void XV_LBoxStop ( XV_Lbox_l2 InstancePtr)

This function stops the letter box core.

Parameters
InstancePtris a pointer to the core instance to be worked on.
Returns
None