dile_vt.h

Go to the documentation of this file.

/******************************************************************************
 *   LCD TV LABORATORY, LG ELECTRONICS INC., SEOUL, KOREA
 *   Copyright(c) 2011 by LG Electronics Inc.
 *
 *   All rights reserved. No part of this work may be reproduced, stored in a
 *   retrieval system, or transmitted by any means without prior written
 *   permission of LG Electronics Inc.
 *****************************************************************************/
 
 
#ifndef _DILE_VT_H_
#define _DILE_VT_H_
 
/*---------------------------------------------------------
    #include ���ϵ�
    (File Inclusions)
---------------------------------------------------------*/
 
 
/*----------------------------------------------------------------------------------------
    Extern Function Prototype Declaration
----------------------------------------------------------------------------------------*/
#ifdef __cplusplus
extern "C" {
#endif
 
 
typedef void* DILE_VT_HANDLE_T;
 
typedef enum
{
    DILE_VT_VIDEO_FRAME_BUFFER_PLANE_INTERLEAVED = 1,
    DILE_VT_VIDEO_FRAME_BUFFER_PLANE_SEMI_PLANAR,
    DILE_VT_VIDEO_FRAME_BUFFER_PLANE_PLANAR
} DILE_VT_VIDEO_FRAME_BUFFER_PLANE_NUMBER_T;
 
typedef enum
{
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_YUV420_PLANAR = 0,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_YUV420_SEMI_PLANAR,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_YUV420_INTERLEAVED,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_YUV422_PLANAR,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_YUV422_SEMI_PLANAR,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_YUV422_INTERLEAVED,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_YUV444_PLANAR,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_YUV444_SEMI_PLANAR,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_YUV444_INTERLEAVED,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_RGB,
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_ARGB
} DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_T;
 
typedef enum
{
    DILE_VT_VIDEO_INVALID_WINDOW    = -1,
    DILE_VT_VIDEO_WINDOW_0          = 0,
    DILE_VT_VIDEO_WINDOW_1          = 1,
    DILE_VT_VIDEO_WINDOW_2          = 2
} DILE_VT_VIDEO_WINDOW_TYPE_T;
 
typedef enum
{
    DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_NOFX                = 0x00000000,
    DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_ENABLED             = 0x00000001,
    DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_FREEZED             = 0x00000002,
    DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_APPLIED_PQ          = 0x00000004,
    DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_FRAMERATE_DIVIDE    = 0x00000010
} DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_FLAGS_T;
 
typedef enum
{
    DILE_VT_VIDEO_FRAME_BUFFER_AVAILABLE        = 0,
    DILE_VT_VIDEO_FRAME_BUFFER_UNAVAILABLE      = 1,
    DILE_VT_DIMENSION_CHANGED                   = 2
} DILE_VT_EVENT_TYPE_T;
 
typedef enum
{
    DILE_VT_NONE_MIRROR         = 0x00000000,
    DILE_VT_HORIZONTAL_MIRROR   = 0x00000001,
    DILE_VT_VERTICAL_MIRROR     = 0x00000010,
    DILE_VT_EPI_MIRROR          = 0x00000020,
    DILE_VT_ALL                 = 0x00000031
} DILE_VT_MIRROR_FLAGS_T;
 
typedef enum
{
    DILE_VT_PLASMA_DISPLAY      = 0,
    DILE_VT_LCD_DISPLAY,
    DILE_VT_OLED_DISPLAY
} DILE_VT_DISPLAY_TYPE_T;
 
typedef enum
{
    DILE_VT_SCALER_OUTPUT = 0,
    DILE_VT_DISPLAY_OUTPUT
} DILE_VT_DUMP_LOCATION_TYPE_T;
 
typedef enum
{
    DILE_VT_VIDEO_INTERLACED    = 0,
    DILE_VT_VIDEO_PROGRESSIVE
} DILE_VT_VIDEO_TYPE_T;
 
typedef struct
{
    unsigned short x;
    unsigned short y;
    unsigned short w;
    unsigned short h;
} DILE_VT_RECT_T;
 
typedef struct {
    DILE_VT_DISPLAY_TYPE_T      displayType;
    unsigned int                width;
    unsigned int                height;
} DILE_VT_DISPLAY_INFO_T;
 
typedef struct {
    unsigned int    width;
    unsigned int    height;
} DILE_VT_GRAPHIC_INFO_T;
 
typedef struct {
    DILE_VT_DISPLAY_INFO_T  displayInfo;
    DILE_VT_GRAPHIC_INFO_T  graphicInfo;
    DILE_VT_MIRROR_FLAGS_T  mirrorModeFlags;
} DILE_VT_BOARD_INFO_T;
 
 
typedef struct
{
    unsigned int    numOfVideoWindow;
} DILE_VT_DEVICE_CAPABILITY_INFO_T;
 
typedef struct {
    unsigned int                                numOfVideoFrameBuffer;
    DILE_VT_VIDEO_FRAME_BUFFER_PLANE_NUMBER_T   numOfPlane;
} DILE_VT_VIDEO_FRAME_BUFFER_CAPABILITY_INFO_T;
 
typedef struct
{
    unsigned char   bSupportedControlEnabled;
    unsigned char   bSupportedControlFreezed;
    unsigned char   bSupportedControlFramerateDivide;
    unsigned char   bSupportedControlPQ;
} DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_CAPABILITY_INFO_T;
 
typedef struct {
    DILE_VT_RECT_T  maxResolution;
    unsigned char   bLeftTopAlign;
    unsigned char   bSupportInputVideoDeInterlacing;
    unsigned char   bSupportDisplayVideoDeInterlacing;
    unsigned char   bSupportScaleUp;
    unsigned int    scaleUpLimitWidth;
    unsigned int    scaleUpLimitHeight;
    unsigned char   bSupportScaleDown;
    unsigned int    scaleDownLimitWidth;
    unsigned int    scaleDownLimitHeight;
} DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_LIMITATION_INFO_T;
 
typedef struct
{
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_T pixelFormat;
    unsigned int    stride;
    unsigned int    width;
    unsigned int    height;
    unsigned int**  ppPhysicalAddress;
} DILE_VT_VIDEO_FRAME_BUFFER_PROPERTY_INFO_T;
 
typedef struct
{
    unsigned char   bEnabled;
    unsigned char   bFreezed;
    unsigned char   bAppliedPQ;
    unsigned int    framerateDivide;
} DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_INFO_T;
 
typedef struct {
    DILE_VT_VIDEO_TYPE_T        type;
    DILE_VT_RECT_T              region;
    unsigned char               bIs3DVideo;
} DILE_VT_INPUT_VIDEO_INFO_T;
 
typedef struct {
    DILE_VT_VIDEO_TYPE_T        type;
    DILE_VT_RECT_T              maxRegion;
    DILE_VT_RECT_T              activeRegion;
} DILE_VT_OUTPUT_VIDEO_INFO_T;
 
typedef struct {
    unsigned int    stride;
    DILE_VT_RECT_T  maxRegion;
    DILE_VT_RECT_T  activeRegion;
} DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_OUTPUT_INFO_T;
 
typedef struct
{
    DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_INFO_T stateInfo;
    unsigned int framerate;
    DILE_VT_DUMP_LOCATION_TYPE_T dumpLocation;
    DILE_VT_RECT_T outputRegion;
    unsigned char bBlockState;
} DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_PROPERTY_INFO_T;
 
typedef void (*DILE_VT_EVENT_HANDLER_T)(DILE_VT_HANDLE_T handle, DILE_VT_EVENT_TYPE_T eventType, void *eventData, void *userData);
 
#ifndef DILE_STATUS_T
 
typedef enum{
    DILE_OK = 0,
    DILE_NOT_OK = -1,
} _DILE_STATUS_T;
 
#define DILE_STATUS_T _DILE_STATUS_T
 
#endif
 
/*----------------------------------------------------------------------------------------
    Type Definitions - end
----------------------------------------------------------------------------------------*/
 
/*----------------------------------------------------------------------------------------
    Type Definitions for VTV - start
----------------------------------------------------------------------------------------*/
typedef void* DILE_VTV_HANDLE_T;
 
typedef struct {
    unsigned int width;
    unsigned int height;
} DILE_VTV_RESOLUTION_T;
 
typedef struct {
    unsigned char   bSupportInputVideoDeInterlacing;
    unsigned char   bSupportDisplayVideoDeInterlacing;
    unsigned char   bSupportScaleUp;
    unsigned char   bSupportScaleDown;
    unsigned int    scaleUpLimitWidth;
    unsigned int    scaleUpLimitHeight;
    unsigned int    scaleDownLimitWidth;
    unsigned int    scaleDownLimitHeight;
    DILE_VTV_RESOLUTION_T inputBufferMaxResolution;
    DILE_VTV_RESOLUTION_T outputBufferMaxResolution;
    unsigned int    nNumOfInputBuffer;
    unsigned int    nNumOfOutputBuffer;
    unsigned int    nNumOfPlane;
} DILE_VTV_DEVICE_CAPABILITY_INFO_T;
 
typedef struct
{
    DILE_VT_VIDEO_FRAME_BUFFER_PIXEL_FORMAT_T pixelFormat;
    unsigned int    stride;
    unsigned int    width;
    unsigned int    height;
    unsigned int    yFrame[5];
    unsigned int    uFrame[5];
    unsigned int    vFrame[5];
} DILE_VTV_VFB_PROPERTY_INFO_T;
 
typedef struct {
    DILE_VTV_VFB_PROPERTY_INFO_T inputBufferInfo;
    DILE_VTV_VFB_PROPERTY_INFO_T outputBufferInfo;
    unsigned int    inputBufferIndex;
    unsigned int    outputBufferIndex;
    unsigned int    vendorData; 
} DILE_VTV_CALLBACK_INFO_T;
 
typedef void (*DILE_VTV_CALLBACK)(DILE_VTV_CALLBACK_INFO_T *pInfo);
 
DILE_VTV_HANDLE_T DILE_VTV_Init(void);
DILE_STATUS_T DILE_VTV_Finalize(DILE_VTV_HANDLE_T handle);
DILE_STATUS_T DILE_VTV_GetDeviceCapability(DILE_VTV_HANDLE_T handle, DILE_VTV_DEVICE_CAPABILITY_INFO_T *pCapabilityInfo);
DILE_STATUS_T DILE_VTV_RegisterCallback(DILE_VTV_HANDLE_T handle, DILE_VTV_CALLBACK cbFunc);
DILE_STATUS_T DILE_VTV_GetInputBufferResolution(DILE_VTV_HANDLE_T handle, DILE_VTV_RESOLUTION_T *pResolution);
DILE_STATUS_T DILE_VTV_SetInputBufferResolution(DILE_VTV_HANDLE_T handle, DILE_VTV_RESOLUTION_T *pResolution);
DILE_STATUS_T DILE_VTV_GetOutputBufferResolution(DILE_VTV_HANDLE_T handle, DILE_VTV_RESOLUTION_T *pResolution);
DILE_STATUS_T DILE_VTV_SetOutputBufferResolution(DILE_VTV_HANDLE_T handle, DILE_VTV_RESOLUTION_T *pResolution);
DILE_STATUS_T DILE_VTV_GetOutputBufferIndex(DILE_VTV_HANDLE_T handle, unsigned int *pIndex);
DILE_STATUS_T DILE_VTV_SetOutputBufferIndex(DILE_VTV_HANDLE_T handle, unsigned int index, unsigned int vendorData);
DILE_STATUS_T DILE_VTV_GetInputBufferFreeze(DILE_VTV_HANDLE_T handle, unsigned int bufferIndex, unsigned int *pbFreeze);
DILE_STATUS_T DILE_VTV_SetInputBufferFreeze(DILE_VTV_HANDLE_T handle, unsigned int bufferIndex, unsigned int bFreeze);
 
/*----------------------------------------------------------------------------------------
    Type Definitions for VTV - end
----------------------------------------------------------------------------------------*/
 
/*----------------------------------------------------------------------------------------
    Initialize / Finalize Operation
----------------------------------------------------------------------------------------*/
DILE_STATUS_T DILE_VT_Init(void);
 
DILE_STATUS_T DILE_VT_InitEx(unsigned int bufferNum);
 
DILE_STATUS_T DILE_VT_Finalize(void);
 
DILE_STATUS_T DILE_VT_EnableFRCMode(unsigned int bEnableFRC);
 
/*----------------------------------------------------------------------------------------
    Create / Destroy Operation
----------------------------------------------------------------------------------------*/
DILE_VT_HANDLE_T DILE_VT_Create(DILE_VT_VIDEO_WINDOW_TYPE_T videoWindowID);
 
 
/*----------------------------------------------------------------------------------------
    Create / Destroy Operation
----------------------------------------------------------------------------------------*/
DILE_VT_HANDLE_T DILE_VT_CreateEx(DILE_VT_VIDEO_WINDOW_TYPE_T videoWindowID, unsigned int bufferNum);
 
 
DILE_STATUS_T DILE_VT_Destroy(DILE_VT_HANDLE_T handle);
 
/*----------------------------------------------------------------------------------------
    Provide capability of Device & Video Frame Buffer
----------------------------------------------------------------------------------------*/
DILE_STATUS_T DILE_VT_GetDeviceCapability(DILE_VT_HANDLE_T handle, DILE_VT_DEVICE_CAPABILITY_INFO_T *pDeviceCapabilityInfo);
 
DILE_STATUS_T DILE_VT_GetVideoFrameBufferCapability(DILE_VT_HANDLE_T handle, DILE_VT_VIDEO_FRAME_BUFFER_CAPABILITY_INFO_T *pVideoFrameBufferCapabilityInfo);
 
DILE_STATUS_T DILE_VT_GetVideoFrameOutputDeviceCapability(DILE_VT_HANDLE_T handle, DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_CAPABILITY_INFO_T *pVideoFrameOutputDeviceCapabilityInfo);
 
DILE_STATUS_T DILE_VT_GetVideoFrameOutputDeviceLimitation(DILE_VT_HANDLE_T handle, DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_LIMITATION_INFO_T *pVideoFrameOutputDeviceLimitationInfo);
/*----------------------------------------------------------------------------------------
    Register event handler
----------------------------------------------------------------------------------------*/
DILE_STATUS_T DILE_VT_SetEventHandler(DILE_VT_HANDLE_T handle, DILE_VT_EVENT_HANDLER_T eventHandler, void *pUserData);
 
/*----------------------------------------------------------------------------------------
    Provide information of video frame buffer
----------------------------------------------------------------------------------------*/
DILE_STATUS_T DILE_VT_GetAllVideoFrameBufferProperty(DILE_VT_HANDLE_T handle, DILE_VT_VIDEO_FRAME_BUFFER_CAPABILITY_INFO_T *pVideoFrameBufferCapability, DILE_VT_VIDEO_FRAME_BUFFER_PROPERTY_INFO_T *pVideoFrameBufferProperty);
 
DILE_STATUS_T DILE_VT_GetCurrentVideoFrameBufferProperty(DILE_VT_HANDLE_T handle, DILE_VT_VIDEO_FRAME_BUFFER_PROPERTY_INFO_T *pVideoFrameBufferProperty, unsigned int *pIndexOfCurrentVideoFrameBuffer);
 
DILE_STATUS_T DILE_VT_GetVideoFrameBufferSecureVideoState(DILE_VT_HANDLE_T handle, unsigned char *pIsSecureVideo);
/*----------------------------------------------------------------------------------------
    Provide control interface and information of Video Frame Output Device
----------------------------------------------------------------------------------------*/
DILE_STATUS_T DILE_VT_GetVideoFrameOutputDeviceState(DILE_VT_HANDLE_T handle, DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_INFO_T *pVideoFrameOutputDeviceState);
 
DILE_STATUS_T DILE_VT_SetVideoFrameOutputDeviceState(DILE_VT_HANDLE_T handle, DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_FLAGS_T videoFrameOutputDeviceStateFlags, DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_STATE_INFO_T *pVideoFrameOutputDeviceState);
 
DILE_STATUS_T DILE_VT_GetVideoFrameOutputDeviceFramerate(DILE_VT_HANDLE_T handle, unsigned int *pFramerate);
 
DILE_STATUS_T DILE_VT_GetVideoFrameOutputDeviceDumpLocation(DILE_VT_HANDLE_T handle, DILE_VT_DUMP_LOCATION_TYPE_T *pDumpLocation);
 
DILE_STATUS_T DILE_VT_SetVideoFrameOutputDeviceDumpLocation(DILE_VT_HANDLE_T handle, DILE_VT_DUMP_LOCATION_TYPE_T dumpLocation);
 
DILE_STATUS_T DILE_VT_GetVideoFrameOutputDeviceOutputInfo(DILE_VT_HANDLE_T handle, DILE_VT_DUMP_LOCATION_TYPE_T dumpLocation, DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_OUTPUT_INFO_T *pOutputInfo);
 
DILE_STATUS_T DILE_VT_SetVideoFrameOutputDeviceOutputRegion(DILE_VT_HANDLE_T handle, DILE_VT_DUMP_LOCATION_TYPE_T dumpLocation, DILE_VT_RECT_T *pOutputRegion);
 
DILE_STATUS_T DILE_VT_GetVideoFrameOutputDeviceBlockState(DILE_VT_VIDEO_WINDOW_TYPE_T videoWindowID, unsigned char *pbBlockState);
 
DILE_STATUS_T DILE_VT_SetVideoFrameOutputDeviceBlockState(DILE_VT_VIDEO_WINDOW_TYPE_T videoWindowID, unsigned char bBlockState);
 
DILE_STATUS_T DILE_VT_GetVideoFrameOutputDeviceProperty(DILE_VT_VIDEO_WINDOW_TYPE_T videoWindowID, DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_PROPERTY_INFO_T *pVideoFrameOutputDeviceProperty);
 
DILE_STATUS_T DILE_VT_SetVideoFrameOutputDeviceProperty(DILE_VT_VIDEO_WINDOW_TYPE_T videoWindowID, DILE_VT_VIDEO_FRAME_OUTPUT_DEVICE_PROPERTY_INFO_T *pVideoFrameOutputDeviceProperty);
 
/*----------------------------------------------------------------------------------------
    Getting board information
----------------------------------------------------------------------------------------*/
 
DILE_STATUS_T DILE_VT_GetBoardInfo(DILE_VT_HANDLE_T handle, DILE_VT_BOARD_INFO_T *pBoardInfo);
 
/*----------------------------------------------------------------------------------------
    Provide VFOD vsync state
----------------------------------------------------------------------------------------*/
DILE_STATUS_T DILE_VT_WaitVsync(DILE_VT_HANDLE_T handle);
 
/*----------------------------------------------------------------------------------------
    Additional Features
----------------------------------------------------------------------------------------*/
 
DILE_STATUS_T DILE_VT_GetInputVideoInfo(DILE_VT_HANDLE_T handle, DILE_VT_INPUT_VIDEO_INFO_T *pInputVideoInfo);
 
DILE_STATUS_T DILE_VT_GetOutputVideoInfo(DILE_VT_HANDLE_T handle, DILE_VT_OUTPUT_VIDEO_INFO_T *pOutputVideoInfo);
 
DILE_STATUS_T DILE_VT_GetVideoMuteStatus(DILE_VT_HANDLE_T handle, unsigned char *pbOnOff);
 
DILE_STATUS_T DILE_VT_Start(unsigned int *pWaitTime);
 
DILE_STATUS_T DILE_VT_Stop(void);
 
/*----------------------------------------------------------------------------------------
    Debug Menu
----------------------------------------------------------------------------------------*/
void DILE_VT_Debug(void);
 
#ifdef __cplusplus
}
#endif
#endif