MPP Programming Interface Reference Manual  jpl-r3.0.0-rc1
mpi_osd.h File Reference

MPI for OSD. More...

#include "mpi_index.h"

Data Structures

struct  MPI_OSD_POLYGON_ATTR_S
 Structure for the attribute of OSD polygon. More...
 
struct  MPI_OSD_LINE_ATTR_S
 Structure for the attribute of OSD line. More...
 
struct  MPI_OSD_BIND_ATTR_S
 Structure for the attribute of OSD bind. More...
 
struct  MPI_OSD_CANVAS_ATTR_S
 Structure for the attribute of canvas information. More...
 
struct  MPI_OSD_RGN_ATTR_S
 Structure for the attribute of OSD region. More...
 

Macros

#define MPI_OSD_MAX_HANDLE   (32)
 
#define MPI_OSD_MAX_BIND_CHANNEL   (4)
 
#define MPI_OSD_MAX_POLYGON_POINT_NUM   (32)
 
#define MPI_OSD_MAX_LINE_POINT_NUM   (2)
 
#define MPI_OSD_MAX_WIDTH   (8192)
 
#define MPI_OSD_MAX_HEIGHT   (8192)
 
#define MPI_OSD_QP_OFFSET_MAX   (6)
 
#define MPI_OSD_QP_OFFSET_MIN   (-6)
 
#define MPI_OSD_THICKNESS_MIN   (2)
 
#define MPI_OSD_THICKNESS_MAX   (8)
 

Typedefs

typedef INT32 OSD_HANDLE
 a typedef for OSD handle.
 
typedef INT32 OSD_MODULE
 a typedef for OSD bind module.
 

Enumerations

enum  MPI_OSD_COLOR_FORMAT_E { MPI_OSD_COLOR_FORMAT_AYUV_3544, MPI_OSD_COLOR_FORMAT_PALETTE_16, MPI_OSD_COLOR_FORMAT_PALETTE_8, MPI_OSD_COLOR_FORMAT_NUM }
 OSD color format. More...
 
enum  MPI_OSD_OVERLAY_E {
  MPI_OSD_OVERLAY_POLYGON, MPI_OSD_OVERLAY_LINE, MPI_OSD_OVERLAY_BITMAP, MPI_OSD_OVERLAY_BITMAP_BYPASS,
  MPI_OSD_OVERLAY_NUM
}
 OSD overlay type. More...
 

Functions

INT32 MPI_createOsdRgn (OSD_HANDLE *handle, const MPI_OSD_RGN_ATTR_S *p_osd_attr)
 Create an OSD region. More...
 
INT32 MPI_destroyOsdRgn (OSD_HANDLE handle)
 Destroy an OSD region. More...
 
INT32 MPI_bindOsdToChn (OSD_HANDLE handle, const MPI_OSD_BIND_ATTR_S *p_osd_bind)
 Binding an OSD region to a encoder channel. More...
 
INT32 MPI_unbindOsdFromChn (OSD_HANDLE handle, const MPI_OSD_BIND_ATTR_S *p_osd_bind)
 Unbind OSD region from a video channel. More...
 
INT32 MPI_getOsdRgnAttr (OSD_HANDLE handle, MPI_OSD_RGN_ATTR_S *p_osd_attr)
 Get OSD region attributes. More...
 
INT32 MPI_setOsdRgnAttr (OSD_HANDLE handle, const MPI_OSD_RGN_ATTR_S *p_osd_attr)
 Set OSD region attributes. More...
 
INT32 MPI_getOsdCanvas (OSD_HANDLE handle, MPI_OSD_CANVAS_ATTR_S *p_canvas_attr)
 Get the canvas information. More...
 
INT32 MPI_updateOsdCanvas (OSD_HANDLE handle)
 Update canvas to OSD. More...
 

Detailed Description

MPI for OSD.

Macro Definition Documentation

#define MPI_OSD_MAX_BIND_CHANNEL   (4)

OSD max bind per channel.

#define MPI_OSD_MAX_HANDLE   (32)

OSD max handle per channel.

#define MPI_OSD_MAX_HEIGHT   (8192)

OSD region max height.

#define MPI_OSD_MAX_LINE_POINT_NUM   (2)

OSD max point per line.

#define MPI_OSD_MAX_POLYGON_POINT_NUM   (32)

OSD max point per polygon.

#define MPI_OSD_MAX_WIDTH   (8192)

OSD region max width.

#define MPI_OSD_QP_OFFSET_MAX   (6)

OSD max qp offset.

#define MPI_OSD_QP_OFFSET_MIN   (-6)

OSD min qp offset.

#define MPI_OSD_THICKNESS_MAX   (8)

OSD max thickness.

#define MPI_OSD_THICKNESS_MIN   (2)

OSD min thickness.

Enumeration Type Documentation

OSD color format.

Enumerator
MPI_OSD_COLOR_FORMAT_AYUV_3544 

AYUV 3544 color format.

MPI_OSD_COLOR_FORMAT_PALETTE_16 

Palette 16 bits color format.

MPI_OSD_COLOR_FORMAT_PALETTE_8 

Palette 8 bits color format.

MPI_OSD_COLOR_FORMAT_NUM 

The max numbers of color format.

OSD overlay type.

Enumerator
MPI_OSD_OVERLAY_POLYGON 

Overlay polygon.

MPI_OSD_OVERLAY_LINE 

Overlay line.

MPI_OSD_OVERLAY_BITMAP 

Overlay bitmap.

MPI_OSD_OVERLAY_BITMAP_BYPASS 

Overlay bitmap.

MPI_OSD_OVERLAY_NUM 

The max numbers of operation mode.

Function Documentation

INT32 MPI_bindOsdToChn ( OSD_HANDLE  handle,
const MPI_OSD_BIND_ATTR_S p_osd_bind 
)

Binding an OSD region to a encoder channel.

Parameters
[in]handleOSD handle.
[in]p_osd_bindthe attributes of binding.
See also
MPI_unbindOsdFromChn()
Returns
The execution result.
INT32 MPI_createOsdRgn ( OSD_HANDLE handle,
const MPI_OSD_RGN_ATTR_S p_osd_attr 
)

Create an OSD region.

Parameters
[out]handleOSD handle.
[in]p_osd_attrthe attributes of a OSD.
See also
MPI_destroyOsdRgn()
Returns
The execution result.
INT32 MPI_destroyOsdRgn ( OSD_HANDLE  handle)

Destroy an OSD region.

Parameters
[in]handleOSD handle.
See also
MPI_createOsdRgn()
Returns
The execution result.
INT32 MPI_getOsdCanvas ( OSD_HANDLE  handle,
MPI_OSD_CANVAS_ATTR_S p_canvas_attr 
)

Get the canvas information.

Parameters
[in]handleOSD handle.
[out]p_canvas_attrthe information of a canvas.
See also
MPI_updateOsdCanvas()
Returns
The execution result.
INT32 MPI_getOsdRgnAttr ( OSD_HANDLE  handle,
MPI_OSD_RGN_ATTR_S p_osd_attr 
)

Get OSD region attributes.

Parameters
[in]handleOSD handle.
[in]p_osd_attrthe attributes of an OSD.
See also
MPI_setOsdRgnAttr()
Returns
The execution result.
INT32 MPI_setOsdRgnAttr ( OSD_HANDLE  handle,
const MPI_OSD_RGN_ATTR_S p_osd_attr 
)

Set OSD region attributes.

Parameters
[in]handleOSD handle.
[in]p_osd_attrthe attributes of an OSD.
See also
MPI_getOsdRgnAttr()
Returns
The execution result.
INT32 MPI_unbindOsdFromChn ( OSD_HANDLE  handle,
const MPI_OSD_BIND_ATTR_S p_osd_bind 
)

Unbind OSD region from a video channel.

Parameters
[in]handleOSD handle.
[in]p_osd_bindthe attributes of binding.
See also
MPI_bindOsdToChn()
Returns
The execution result.
INT32 MPI_updateOsdCanvas ( OSD_HANDLE  handle)

Update canvas to OSD.

Parameters
[in]handleOSD handle.
See also
MPI_getOsdCanvas()
Returns
The execution result.