mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-09-09 05:38:58 +00:00
285 lines
7.6 KiB
C
285 lines
7.6 KiB
C
/**********************************************************************
|
|
*
|
|
* Copyright(c) Imagination Technologies Ltd.
|
|
*
|
|
* The contents of this file are subject to the MIT license as set out below.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"),
|
|
* to deal in the Software without restriction, including without limitation
|
|
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
* and/or sell copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included
|
|
* in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
|
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
|
|
* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
|
|
* OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
|
|
* OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*
|
|
* This License is also included in this distribution in the file called
|
|
* "COPYING".
|
|
*
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
#if !defined(__WSEGL_H__)
|
|
#define __WSEGL_H__
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
// WSEGL Platform-specific definitions
|
|
*/
|
|
#if defined(__linux__)
|
|
#define WSEGL_EXPORT __attribute__((visibility("default")))
|
|
#define WSEGL_IMPORT
|
|
#else
|
|
#define WSEGL_EXPORT
|
|
#define WSEGL_IMPORT
|
|
#endif
|
|
|
|
/*
|
|
// WSEGL API Version Number
|
|
*/
|
|
|
|
#define WSEGL_VERSION 2
|
|
#define WSEGL_DEFAULT_DISPLAY 0
|
|
#define WSEGL_DEFAULT_NATIVE_ENGINE 0
|
|
|
|
#define WSEGL_FALSE 0
|
|
#define WSEGL_TRUE 1
|
|
#define WSEGL_NULL 0
|
|
|
|
#define WSEGL_UNREFERENCED_PARAMETER(param) (param) = (param)
|
|
|
|
/*
|
|
// WSEGL handles
|
|
*/
|
|
typedef void *WSEGLDisplayHandle;
|
|
typedef void *WSEGLDrawableHandle;
|
|
|
|
/*
|
|
// Display capability type
|
|
*/
|
|
typedef enum WSEGLCapsType_TAG
|
|
{
|
|
WSEGL_NO_CAPS = 0,
|
|
WSEGL_CAP_MIN_SWAP_INTERVAL = 1, /* System default value = 1 */
|
|
WSEGL_CAP_MAX_SWAP_INTERVAL = 2, /* System default value = 1 */
|
|
WSEGL_CAP_WINDOWS_USE_HW_SYNC = 3, /* System default value = 0 (FALSE) */
|
|
WSEGL_CAP_PIXMAPS_USE_HW_SYNC = 4, /* System default value = 0 (FALSE) */
|
|
|
|
} WSEGLCapsType;
|
|
|
|
/*
|
|
// Display capability
|
|
*/
|
|
typedef struct WSEGLCaps_TAG
|
|
{
|
|
WSEGLCapsType eCapsType;
|
|
unsigned long ui32CapsValue;
|
|
|
|
} WSEGLCaps;
|
|
|
|
/*
|
|
// Drawable type
|
|
*/
|
|
#define WSEGL_NO_DRAWABLE 0x0
|
|
#define WSEGL_DRAWABLE_WINDOW 0x1
|
|
#define WSEGL_DRAWABLE_PIXMAP 0x2
|
|
|
|
|
|
/*
|
|
// Pixel format of display/drawable
|
|
*/
|
|
typedef enum WSEGLPixelFormat_TAG
|
|
{
|
|
/* These must not be re-ordered */
|
|
WSEGL_PIXELFORMAT_RGB565 = 0,
|
|
WSEGL_PIXELFORMAT_ARGB4444 = 1,
|
|
WSEGL_PIXELFORMAT_ARGB8888 = 2,
|
|
WSEGL_PIXELFORMAT_ARGB1555 = 3,
|
|
WSEGL_PIXELFORMAT_ABGR8888 = 4,
|
|
WSEGL_PIXELFORMAT_XBGR8888 = 5,
|
|
|
|
/* These are compatibility names only; new WSEGL
|
|
* modules should not use them.
|
|
*/
|
|
WSEGL_PIXELFORMAT_565 = WSEGL_PIXELFORMAT_RGB565,
|
|
WSEGL_PIXELFORMAT_4444 = WSEGL_PIXELFORMAT_ARGB4444,
|
|
WSEGL_PIXELFORMAT_8888 = WSEGL_PIXELFORMAT_ARGB8888,
|
|
WSEGL_PIXELFORMAT_1555 = WSEGL_PIXELFORMAT_ARGB1555,
|
|
|
|
} WSEGLPixelFormat;
|
|
|
|
/*
|
|
// Transparent of display/drawable
|
|
*/
|
|
typedef enum WSEGLTransparentType_TAG
|
|
{
|
|
WSEGL_OPAQUE = 0,
|
|
WSEGL_COLOR_KEY = 1,
|
|
|
|
} WSEGLTransparentType;
|
|
|
|
/*
|
|
// Display/drawable configuration
|
|
*/
|
|
typedef struct WSEGLConfig_TAG
|
|
{
|
|
/*
|
|
// Type of drawables this configuration applies to -
|
|
// OR'd values of drawable types.
|
|
*/
|
|
unsigned long ui32DrawableType;
|
|
|
|
/* Pixel format */
|
|
WSEGLPixelFormat ePixelFormat;
|
|
|
|
/* Native Renderable - set to WSEGL_TRUE if native renderable */
|
|
unsigned long ulNativeRenderable;
|
|
|
|
/* FrameBuffer Level Parameter */
|
|
unsigned long ulFrameBufferLevel;
|
|
|
|
/* Native Visual ID */
|
|
unsigned long ulNativeVisualID;
|
|
|
|
/* Native Visual */
|
|
void *hNativeVisual;
|
|
|
|
/* Transparent Type */
|
|
WSEGLTransparentType eTransparentType;
|
|
|
|
/* Transparent Color - only used if transparent type is COLOR_KEY */
|
|
unsigned long ulTransparentColor; /* packed as 0x00RRGGBB */
|
|
|
|
|
|
} WSEGLConfig;
|
|
|
|
/*
|
|
// WSEGL errors
|
|
*/
|
|
typedef enum WSEGLError_TAG
|
|
{
|
|
WSEGL_SUCCESS = 0,
|
|
WSEGL_CANNOT_INITIALISE = 1,
|
|
WSEGL_BAD_NATIVE_DISPLAY = 2,
|
|
WSEGL_BAD_NATIVE_WINDOW = 3,
|
|
WSEGL_BAD_NATIVE_PIXMAP = 4,
|
|
WSEGL_BAD_NATIVE_ENGINE = 5,
|
|
WSEGL_BAD_DRAWABLE = 6,
|
|
WSEGL_BAD_MATCH = 7,
|
|
WSEGL_OUT_OF_MEMORY = 8,
|
|
|
|
/* These are compatibility names only; new WSEGL
|
|
* modules should not use them.
|
|
*/
|
|
WSEGL_BAD_CONFIG = WSEGL_BAD_MATCH,
|
|
|
|
} WSEGLError;
|
|
|
|
/*
|
|
// Drawable orientation (in degrees anti-clockwise)
|
|
*/
|
|
typedef enum WSEGLRotationAngle_TAG
|
|
{
|
|
WSEGL_ROTATE_0 = 0,
|
|
WSEGL_ROTATE_90 = 1,
|
|
WSEGL_ROTATE_180 = 2,
|
|
WSEGL_ROTATE_270 = 3
|
|
|
|
} WSEGLRotationAngle;
|
|
|
|
/*
|
|
// Drawable information required by OpenGL-ES driver
|
|
*/
|
|
typedef struct WSEGLDrawableParams_TAG
|
|
{
|
|
/* Width in pixels of the drawable */
|
|
unsigned long ui32Width;
|
|
|
|
/* Height in pixels of the drawable */
|
|
unsigned long ui32Height;
|
|
|
|
/* Stride in pixels of the drawable */
|
|
unsigned long ui32Stride;
|
|
|
|
/* Pixel format of the drawable */
|
|
WSEGLPixelFormat ePixelFormat;
|
|
|
|
/* User space cpu virtual address of the drawable */
|
|
void *pvLinearAddress;
|
|
|
|
/* HW address of the drawable */
|
|
unsigned long ui32HWAddress;
|
|
|
|
/* Private data for the drawable */
|
|
void *hPrivateData;
|
|
|
|
|
|
} WSEGLDrawableParams;
|
|
|
|
|
|
/*
|
|
// Table of function pointers that is returned by WSEGL_GetFunctionTablePointer()
|
|
//
|
|
// The first entry in the table is the version number of the wsegl.h header file that
|
|
// the module has been written against, and should therefore be set to WSEGL_VERSION
|
|
*/
|
|
typedef struct WSEGL_FunctionTable_TAG
|
|
{
|
|
unsigned long ui32WSEGLVersion;
|
|
|
|
WSEGLError (*pfnWSEGL_IsDisplayValid)(NativeDisplayType);
|
|
|
|
WSEGLError (*pfnWSEGL_InitialiseDisplay)(NativeDisplayType, WSEGLDisplayHandle *, const WSEGLCaps **, WSEGLConfig **);
|
|
|
|
WSEGLError (*pfnWSEGL_CloseDisplay)(WSEGLDisplayHandle);
|
|
|
|
WSEGLError (*pfnWSEGL_CreateWindowDrawable)(WSEGLDisplayHandle, WSEGLConfig *, WSEGLDrawableHandle *, NativeWindowType, WSEGLRotationAngle *);
|
|
|
|
WSEGLError (*pfnWSEGL_CreatePixmapDrawable)(WSEGLDisplayHandle, WSEGLConfig *, WSEGLDrawableHandle *, NativePixmapType, WSEGLRotationAngle *);
|
|
|
|
WSEGLError (*pfnWSEGL_DeleteDrawable)(WSEGLDrawableHandle);
|
|
|
|
WSEGLError (*pfnWSEGL_SwapDrawable)(WSEGLDrawableHandle, unsigned long);
|
|
|
|
WSEGLError (*pfnWSEGL_SwapControlInterval)(WSEGLDrawableHandle, unsigned long);
|
|
|
|
WSEGLError (*pfnWSEGL_WaitNative)(WSEGLDrawableHandle, unsigned long);
|
|
|
|
WSEGLError (*pfnWSEGL_CopyFromDrawable)(WSEGLDrawableHandle, NativePixmapType);
|
|
|
|
WSEGLError (*pfnWSEGL_CopyFromPBuffer)(void *, unsigned long, unsigned long, unsigned long, WSEGLPixelFormat, NativePixmapType);
|
|
|
|
WSEGLError (*pfnWSEGL_GetDrawableParameters)(WSEGLDrawableHandle, WSEGLDrawableParams *, WSEGLDrawableParams *);
|
|
|
|
WSEGLError (*pfnWSEGL_ConnectDrawable)(WSEGLDrawableHandle);
|
|
|
|
WSEGLError (*pfnWSEGL_DisconnectDrawable)(WSEGLDrawableHandle);
|
|
|
|
|
|
} WSEGL_FunctionTable;
|
|
|
|
|
|
WSEGL_IMPORT const WSEGL_FunctionTable *WSEGL_GetFunctionTablePointer(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __WSEGL_H__ */
|
|
|
|
/******************************************************************************
|
|
End of file (wsegl.h)
|
|
******************************************************************************/
|