[556] | 1 | /*!****************************************************************************
|
---|
| 2 | @File pvr2d.h
|
---|
| 3 | @Title PVR2D external header file
|
---|
| 4 | @Author Imagination Technologies
|
---|
| 5 | @Copyright Copyright (c) by Imagination Technologies Limited.
|
---|
| 6 | This specification is protected by copyright laws and contains
|
---|
| 7 | material proprietary to Imagination Technologies Limited.
|
---|
| 8 | You may use and distribute this specification free of charge for implementing
|
---|
| 9 | the functionality therein, without altering or removing any trademark, copyright,
|
---|
| 10 | or other notice from the specification.
|
---|
| 11 | @Platform Generic
|
---|
| 12 | @Description PVR2D definitions for PVR2D clients
|
---|
| 13 | ******************************************************************************/
|
---|
| 14 |
|
---|
| 15 |
|
---|
| 16 | /******************************************************************************
|
---|
| 17 | Modifications :-
|
---|
| 18 | $Log: pvr2d.h $
|
---|
| 19 | ******************************************************************************/
|
---|
| 20 |
|
---|
| 21 | #ifndef _PVR2D_H_
|
---|
| 22 | #define _PVR2D_H_
|
---|
| 23 |
|
---|
| 24 | #ifdef __cplusplus
|
---|
| 25 | extern "C" {
|
---|
| 26 | #endif
|
---|
| 27 |
|
---|
| 28 | /* PVR2D Platform-specific definitions */
|
---|
| 29 | #define PVR2D_EXPORT
|
---|
| 30 | #define PVR2D_IMPORT
|
---|
| 31 |
|
---|
| 32 |
|
---|
| 33 | #define PVR2D_REV_MAJOR 2
|
---|
| 34 | #define PVR2D_REV_MINOR 1
|
---|
| 35 |
|
---|
| 36 | typedef enum
|
---|
| 37 | {
|
---|
| 38 | PVR2D_FALSE = 0,
|
---|
| 39 | PVR2D_TRUE
|
---|
| 40 | } PVR2D_BOOL;
|
---|
| 41 |
|
---|
| 42 |
|
---|
| 43 | /* error codes */
|
---|
| 44 | typedef enum
|
---|
| 45 | {
|
---|
| 46 | PVR2D_OK = 0,
|
---|
| 47 | PVR2DERROR_INVALID_PARAMETER = -1,
|
---|
| 48 | PVR2DERROR_DEVICE_UNAVAILABLE = -2,
|
---|
| 49 | PVR2DERROR_INVALID_CONTEXT = -3,
|
---|
| 50 | PVR2DERROR_MEMORY_UNAVAILABLE = -4,
|
---|
| 51 | PVR2DERROR_DEVICE_NOT_PRESENT = -5,
|
---|
| 52 | PVR2DERROR_IOCTL_ERROR = -6,
|
---|
| 53 | PVR2DERROR_GENERIC_ERROR = -7,
|
---|
| 54 | PVR2DERROR_BLT_NOTCOMPLETE = -8,
|
---|
| 55 | PVR2DERROR_HW_FEATURE_NOT_SUPPORTED = -9,
|
---|
| 56 | PVR2DERROR_NOT_YET_IMPLEMENTED = -10,
|
---|
| 57 | PVR2DERROR_MAPPING_FAILED = -11
|
---|
| 58 | }PVR2DERROR;
|
---|
| 59 |
|
---|
| 60 |
|
---|
| 61 | /* pixel formats */
|
---|
| 62 | typedef enum
|
---|
| 63 | {
|
---|
| 64 | PVR2D_1BPP = 0,
|
---|
| 65 | PVR2D_RGB565,
|
---|
| 66 | PVR2D_ARGB4444,
|
---|
| 67 | PVR2D_RGB888,
|
---|
| 68 | PVR2D_ARGB8888,
|
---|
| 69 | PVR2D_ARGB1555,
|
---|
| 70 | PVR2D_ALPHA8,
|
---|
| 71 | PVR2D_ALPHA4,
|
---|
| 72 | PVR2D_PAL2,
|
---|
| 73 | PVR2D_PAL4,
|
---|
| 74 | PVR2D_PAL8,
|
---|
| 75 | PVR2D_VGAEMU
|
---|
| 76 |
|
---|
| 77 | }PVR2DFORMAT;
|
---|
| 78 |
|
---|
| 79 |
|
---|
| 80 | /* wrap surface type */
|
---|
| 81 | typedef enum
|
---|
| 82 | {
|
---|
| 83 | PVR2D_WRAPFLAG_NONCONTIGUOUS = 0,
|
---|
| 84 | PVR2D_WRAPFLAG_CONTIGUOUS = 1,
|
---|
| 85 |
|
---|
| 86 | }PVR2DWRAPFLAGS;
|
---|
| 87 |
|
---|
| 88 | /* flags for control information of additional blits */
|
---|
| 89 | typedef enum
|
---|
| 90 | {
|
---|
| 91 | PVR2D_BLIT_DISABLE_ALL = 0x0000, /* disable all additional controls */
|
---|
| 92 | PVR2D_BLIT_CK_ENABLE = 0x0001, /* enable colour key */
|
---|
| 93 | PVR2D_BLIT_GLOBAL_ALPHA_ENABLE = 0x0002, /* enable standard global alpha */
|
---|
| 94 | PVR2D_BLIT_PERPIXEL_ALPHABLEND_ENABLE = 0x0004, /* enable per-pixel alpha bleding */
|
---|
| 95 | PVR2D_BLIT_PAT_SURFACE_ENABLE = 0x0008, /* enable pattern surf (disable fill) */
|
---|
| 96 | PVR2D_BLIT_FULLY_SPECIFIED_ALPHA_ENABLE = 0x0010, /* enable fully specified alpha */
|
---|
| 97 | PVR2D_BLIT_ROT_90 = 0x0020, /* apply 90 degree rotation to the blt */
|
---|
| 98 | PVR2D_BLIT_ROT_180 = 0x0040, /* apply 180 degree rotation to the blt */
|
---|
| 99 | PVR2D_BLIT_ROT_270 = 0x0080, /* apply 270 degree rotation to the blt */
|
---|
| 100 | PVR2D_BLIT_COPYORDER_TL2BR = 0x0100, /* copy order overrides */
|
---|
| 101 | PVR2D_BLIT_COPYORDER_BR2TL = 0x0200,
|
---|
| 102 | PVR2D_BLIT_COPYORDER_TR2BL = 0x0400,
|
---|
| 103 | PVR2D_BLIT_COPYORDER_BL2TR = 0x0800,
|
---|
| 104 | PVR2D_BLIT_COLKEY_SOURCE = 0x1000, /* Key colour is on the source surface */
|
---|
| 105 | PVR2D_BLIT_COLKEY_DEST = 0x2000 /* Key colour is on the destination surface */
|
---|
| 106 |
|
---|
| 107 | } PVR2DBLITFLAGS;
|
---|
| 108 |
|
---|
| 109 | /* standard alpha-blending functions, AlphaBlendingFunc field of PVR2DBLTINFO */
|
---|
| 110 | typedef enum
|
---|
| 111 | {
|
---|
| 112 | PVR2D_ALPHA_OP_SRC_DSTINV = 1, /* source alpha : Cdst = Csrc*Asrc + Cdst*(1-Asrc) */
|
---|
| 113 | PVR2D_ALPHA_OP_SRCP_DSTINV = 2 /* premultiplied source alpha : Cdst = Csrc + Cdst*(1-Asrc) */
|
---|
| 114 | } PVR2D_ALPHABLENDFUNC;
|
---|
| 115 |
|
---|
| 116 | /* blend ops for fully specified alpha */
|
---|
| 117 | typedef enum
|
---|
| 118 | {
|
---|
| 119 | PVR2D_BLEND_OP_ZERO = 0,
|
---|
| 120 | PVR2D_BLEND_OP_ONE = 1,
|
---|
| 121 | PVR2D_BLEND_OP_SRC = 2,
|
---|
| 122 | PVR2D_BLEND_OP_DST = 3,
|
---|
| 123 | PVR2D_BLEND_OP_GLOBAL = 4,
|
---|
| 124 | PVR2D_BLEND_OP_SRC_PLUS_GLOBAL = 5,
|
---|
| 125 | PVR2D_BLEND_OP_DST_PLUS_GLOBAL = 6
|
---|
| 126 | }PVR2D_BLEND_OP;
|
---|
| 127 |
|
---|
| 128 |
|
---|
| 129 | typedef void* PVR2D_HANDLE;
|
---|
| 130 |
|
---|
| 131 |
|
---|
| 132 | /* Fully specified alpha blend : pAlpha field of PVR2DBLTINFO structure */
|
---|
| 133 | /* a fully specified Alpha Blend operation is defined as */
|
---|
| 134 | /* DST (ALPHA) = (ALPHA_1 * SRC (ALPHA)) + (ALPHA_3 * DST (ALPHA)) */
|
---|
| 135 | /* DST (RGB) = (ALPHA_2 * SRC (RGB)) + (ALPHA_4 * DST (RGB)) */
|
---|
| 136 | /* if the pre-multiplication stage is enabled then the equations become the following: */
|
---|
| 137 | /* PRE_MUL = ((SRC(A)) * (Global Alpha Value)) */
|
---|
| 138 | /* DST (ALPHA) = (ALPHA_1 * SRC (ALPHA)) + (PRE_MUL * DST (ALPHA)) */
|
---|
| 139 | /* DST (RGB) = (ALPHA_2 * SRC (RGB)) + (PRE_MUL * DST (RGB)) */
|
---|
| 140 | /* if the transparent source alpha stage is enabled then a source alpha of zero forces the */
|
---|
| 141 | /* source to be transparent for that pixel regardless of the blend equation being used. */
|
---|
| 142 | typedef struct _PVR2D_ALPHABLT
|
---|
| 143 | {
|
---|
| 144 | PVR2D_BLEND_OP eAlpha1;
|
---|
| 145 | PVR2D_BOOL bAlpha1Invert;
|
---|
| 146 | PVR2D_BLEND_OP eAlpha2;
|
---|
| 147 | PVR2D_BOOL bAlpha2Invert;
|
---|
| 148 | PVR2D_BLEND_OP eAlpha3;
|
---|
| 149 | PVR2D_BOOL bAlpha3Invert;
|
---|
| 150 | PVR2D_BLEND_OP eAlpha4;
|
---|
| 151 | PVR2D_BOOL bAlpha4Invert;
|
---|
| 152 | PVR2D_BOOL bPremulAlpha; /* enable pre-multiplication stage */
|
---|
| 153 | PVR2D_BOOL bTransAlpha; /* enable transparent source alpha stage */
|
---|
| 154 | PVR2D_BOOL bUpdateAlphaLookup; /* enable and update the 1555-Lookup alpha table */
|
---|
| 155 | unsigned char uAlphaLookup0; /* 8 bit alpha when A=0 in a 1555-Lookup surface */
|
---|
| 156 | unsigned char uAlphaLookup1; /* 8 bit alpha when A=1 in a 1555-Lookup surface */
|
---|
| 157 | unsigned char uGlobalRGB; /* Global Alpha Value for RGB, 0=transparent 255=opaque */
|
---|
| 158 | unsigned char uGlobalA; /* Global Alpha Value for Alpha */
|
---|
| 159 |
|
---|
| 160 | } PVR2D_ALPHABLT, *PPVR2D_ALPHABLT;
|
---|
| 161 |
|
---|
| 162 |
|
---|
| 163 | /* surface memory info structure */
|
---|
| 164 | typedef struct _PVR2DMEMINFO
|
---|
| 165 | {
|
---|
| 166 | void *pBase;
|
---|
| 167 | unsigned long ui32MemSize;
|
---|
| 168 | unsigned long ui32DevAddr;
|
---|
| 169 | unsigned long ulFlags;
|
---|
| 170 | void *hPrivateData;
|
---|
| 171 | void *hPrivateMapData;
|
---|
| 172 |
|
---|
| 173 | }PVR2DMEMINFO, *PPVR2DMEMINFO;
|
---|
| 174 |
|
---|
| 175 |
|
---|
| 176 | #define PVR2D_MAX_DEVICE_NAME 20
|
---|
| 177 |
|
---|
| 178 | typedef struct _PVR2DDEVICEINFO
|
---|
| 179 | {
|
---|
| 180 | unsigned long ulDevID;
|
---|
| 181 | char szDeviceName[PVR2D_MAX_DEVICE_NAME];
|
---|
| 182 | }PVR2DDEVICEINFO;
|
---|
| 183 |
|
---|
| 184 |
|
---|
| 185 | typedef struct _PVR2DISPLAYINFO
|
---|
| 186 | {
|
---|
| 187 | unsigned long ulMaxFlipChains;
|
---|
| 188 | unsigned long ulMaxBuffersInChain;
|
---|
| 189 | PVR2DFORMAT eFormat;
|
---|
| 190 | unsigned long ulWidth;
|
---|
| 191 | unsigned long ulHeight;
|
---|
| 192 | long lStride;
|
---|
| 193 | unsigned long ulMinFlipInterval;
|
---|
| 194 | unsigned long ulMaxFlipInterval;
|
---|
| 195 |
|
---|
| 196 | }PVR2DDISPLAYINFO;
|
---|
| 197 |
|
---|
| 198 |
|
---|
| 199 | typedef struct _PVR2DBLTINFO
|
---|
| 200 | {
|
---|
| 201 | unsigned long CopyCode; /* rop code */
|
---|
| 202 | unsigned long Colour; /* fill colour */
|
---|
| 203 | unsigned long ColourKey; /* colour key */
|
---|
| 204 | unsigned char GlobalAlphaValue; /* global alpha blending */
|
---|
| 205 | unsigned char AlphaBlendingFunc; /* per-pixel alpha-blending function */
|
---|
| 206 |
|
---|
| 207 | PVR2DBLITFLAGS BlitFlags; /* additional blit control information */
|
---|
| 208 |
|
---|
| 209 | PVR2DMEMINFO *pDstMemInfo; /* destination memory */
|
---|
| 210 | unsigned long DstOffset; /* byte offset from start of allocation to destination surface pixel 0,0 */
|
---|
| 211 | long DstStride; /* signed stride, the number of bytes from pixel 0,0 to 0,1 */
|
---|
| 212 | long DstX, DstY; /* pixel offset from start of dest surface to start of blt rectangle */
|
---|
| 213 | long DSizeX,DSizeY; /* blt size */
|
---|
| 214 | PVR2DFORMAT DstFormat; /* dest format */
|
---|
| 215 | unsigned long DstSurfWidth; /* size of dest surface in pixels */
|
---|
| 216 | unsigned long DstSurfHeight; /* size of dest surface in pixels */
|
---|
| 217 |
|
---|
| 218 | PVR2DMEMINFO *pSrcMemInfo; /* source mem, (source fields are also used for patterns) */
|
---|
| 219 | unsigned long SrcOffset; /* byte offset from start of allocation to src/pat surface pixel 0,0 */
|
---|
| 220 | long SrcStride; /* signed stride, the number of bytes from pixel 0,0 to 0,1 */
|
---|
| 221 | long SrcX, SrcY; /* pixel offset from start of surface to start of source rectangle */
|
---|
| 222 | /* for patterns this is the start offset within the pattern */
|
---|
| 223 | long SizeX,SizeY; /* source rectangle size or pattern size in pixels */
|
---|
| 224 | PVR2DFORMAT SrcFormat; /* source/pattern format */
|
---|
| 225 | PVR2DMEMINFO *pPalMemInfo; /* source/pattern palette memory containing argb8888 colour table */
|
---|
| 226 | unsigned long PalOffset; /* byte offset from start of allocation to start of palette */
|
---|
| 227 | unsigned long SrcSurfWidth; /* size of source surface in pixels */
|
---|
| 228 | unsigned long SrcSurfHeight; /* size of source surface in pixels */
|
---|
| 229 |
|
---|
| 230 | PVR2DMEMINFO *pMaskMemInfo; /* mask memory, 1bpp format implied */
|
---|
| 231 | unsigned long MaskOffset; /* byte offset from start of allocation to mask surface pixel 0,0 */
|
---|
| 232 | long MaskStride; /* signed stride, the number of bytes from pixel 0,0 to 0,1 */
|
---|
| 233 | long MaskX, MaskY; /* mask rect top left (mask size = blt size) */
|
---|
| 234 | unsigned long MaskSurfWidth; /* size of mask surface in pixels */
|
---|
| 235 | unsigned long MaskSurfHeight; /* size of mask surface in pixels */
|
---|
| 236 |
|
---|
| 237 | PPVR2D_ALPHABLT pAlpha; /* fully specified alpha blend */
|
---|
| 238 |
|
---|
| 239 | }PVR2DBLTINFO, *PPVR2DBLTINFO;
|
---|
| 240 |
|
---|
| 241 | typedef struct _PVR2DRECT
|
---|
| 242 | {
|
---|
| 243 | long left, top;
|
---|
| 244 | long right, bottom;
|
---|
| 245 | } PVR2DRECT;
|
---|
| 246 |
|
---|
| 247 | typedef struct
|
---|
| 248 | {
|
---|
| 249 | PVR2DMEMINFO *pSurfMemInfo; /* surface memory */
|
---|
| 250 | unsigned long SurfOffset; /* byte offset from start of allocation to destination surface pixel 0,0 */
|
---|
| 251 | long Stride; /* signed stride */
|
---|
| 252 | PVR2DFORMAT Format;
|
---|
| 253 | unsigned long SurfWidth; /* surface size in pixels */
|
---|
| 254 | unsigned long SurfHeight;
|
---|
| 255 |
|
---|
| 256 | } PVR2D_SURFACE, *PPVR2D_SURFACE;
|
---|
| 257 |
|
---|
| 258 | typedef struct
|
---|
| 259 | {
|
---|
| 260 | unsigned long *pUseCode; /* USSE code */
|
---|
| 261 | unsigned long UseCodeSize; /* usse code size in bytes */
|
---|
| 262 |
|
---|
| 263 | } PVR2D_USECODE, *PPVR2D_USECODE;
|
---|
| 264 |
|
---|
| 265 | typedef struct
|
---|
| 266 | {
|
---|
| 267 | PVR2D_SURFACE sDst; /* destination surface */
|
---|
| 268 | PVR2D_SURFACE sSrc; /* source surface */
|
---|
| 269 | PVR2DRECT rcDest; /* destination rectangle */
|
---|
| 270 | PVR2DRECT rcSource; /* source rectangle */
|
---|
| 271 | PVR2D_HANDLE hUseCode; /* custom USE code (NULL implies source copy) */
|
---|
| 272 | unsigned long UseParams[2]; /* per-blt params for use code */
|
---|
| 273 |
|
---|
| 274 | } PVR2D_3DBLT, *PPVR2D_3DBLT;
|
---|
| 275 |
|
---|
| 276 |
|
---|
| 277 | #define MAKE_COPY_BLIT(src,soff,dest,doff,sx,sy,dx,dy,sz)
|
---|
| 278 |
|
---|
| 279 | typedef void* PVR2DCONTEXTHANDLE;
|
---|
| 280 | typedef void* PVR2DFLIPCHAINHANDLE;
|
---|
| 281 |
|
---|
| 282 |
|
---|
| 283 | // CopyCode field of PVR2DBLTINFO structure:
|
---|
| 284 | // the CopyCode field of the PVR2DBLTINFO structure should contain a rop3 or rop4 code.
|
---|
| 285 | // a rop3 is an 8 bit code that describes a blt with three inputs : source dest and pattern
|
---|
| 286 | // rop4 is a 16 bit code that describes a blt with four inputs : source dest pattern and mask
|
---|
| 287 | // common rop3 codes are defined below
|
---|
| 288 | // a colour fill blt is processed in the pattern channel as a constant colour with a rop code of 0xF0
|
---|
| 289 | // PVR2D_BLIT_PAT_SURFACE_ENABLE defines whether the pattern channel is a surface or a fill colour.
|
---|
| 290 | // a rop4 is defined by two rop3 codes, and the 1 bit-per-pixel mask surface defines which is used.
|
---|
| 291 | // a common rop4 is 0xAAF0 which is the mask copy blt used for text glyphs.
|
---|
| 292 | // CopyCode is taken to be a rop4 when pMaskMemInfo is non zero, otherwise it is assumed to be a rop3
|
---|
| 293 | // use the PVR2DMASKROP4 macro below to construct a rop4 from two rop3's
|
---|
| 294 | // rop3a is the rop used when mask pixel = 1, and rop3b when mask = 0
|
---|
| 295 | #define PVR2DROP4(rop3b, rop3a) ((rop3b<<8)|rop3a)
|
---|
| 296 |
|
---|
| 297 | /* common rop codes */
|
---|
| 298 | #define PVR2DROPclear 0x00 /* 0 (whiteness) */
|
---|
| 299 | #define PVR2DROPset 0xFF /* 1 (blackness) */
|
---|
| 300 | #define PVR2DROPnoop 0xAA /* dst (used for masked blts) */
|
---|
| 301 |
|
---|
| 302 | /* source and dest rop codes */
|
---|
| 303 | #define PVR2DROPand 0x88 /* src AND dst */
|
---|
| 304 | #define PVR2DROPandReverse 0x44 /* src AND NOT dst */
|
---|
| 305 | #define PVR2DROPcopy 0xCC /* src (used for source copy and alpha blts) */
|
---|
| 306 | #define PVR2DROPandInverted 0x22 /* NOT src AND dst */
|
---|
| 307 | #define PVR2DROPxor 0x66 /* src XOR dst */
|
---|
| 308 | #define PVR2DROPor 0xEE /* src OR dst */
|
---|
| 309 | #define PVR2DROPnor 0x11 /* NOT src AND NOT dst */
|
---|
| 310 | #define PVR2DROPequiv 0x99 /* NOT src XOR dst */
|
---|
| 311 | #define PVR2DROPinvert 0x55 /* NOT dst */
|
---|
| 312 | #define PVR2DROPorReverse 0xDD /* src OR NOT dst */
|
---|
| 313 | #define PVR2DROPcopyInverted 0x33 /* NOT src */
|
---|
| 314 | #define PVR2DROPorInverted 0xBB /* NOT src OR dst */
|
---|
| 315 | #define PVR2DROPnand 0x77 /* NOT src OR NOT dst */
|
---|
| 316 |
|
---|
| 317 | /* pattern rop codes */
|
---|
| 318 | #define PVR2DPATROPand 0xA0 /* pat AND dst */
|
---|
| 319 | #define PVR2DPATROPandReverse 0x50 /* pat AND NOT dst */
|
---|
| 320 | #define PVR2DPATROPcopy 0xF0 /* pat (used for solid color fills and pattern blts) */
|
---|
| 321 | #define PVR2DPATROPandInverted 0x0A /* NOT pat AND dst */
|
---|
| 322 | #define PVR2DPATROPxor 0x5A /* pat XOR dst */
|
---|
| 323 | #define PVR2DPATROPor 0xFA /* pat OR dst */
|
---|
| 324 | #define PVR2DPATROPnor 0x05 /* NOT pat AND NOT dst */
|
---|
| 325 | #define PVR2DPATROPequiv 0xA5 /* NOT pat XOR dst */
|
---|
| 326 | #define PVR2DPATROPinvert 0x55 /* NOT dst */
|
---|
| 327 | #define PVR2DPATROPorReverse 0xF5 /* pat OR NOT dst */
|
---|
| 328 | #define PVR2DPATROPcopyInverted 0x0F /* NOT pat */
|
---|
| 329 | #define PVR2DPATROPorInverted 0xAF /* NOT pat OR dst */
|
---|
| 330 | #define PVR2DPATROPnand 0x5F /* NOT pat OR NOT dst */
|
---|
| 331 |
|
---|
| 332 | /* common rop4 codes */
|
---|
| 333 | #define PVR2DROP4MaskedCopy PVR2DROP4(PVR2DROPnoop,PVR2DROPcopy) /* masked source copy blt (used for rounded window corners etc) */
|
---|
| 334 | #define PVR2DROP4MaskedFill PVR2DROP4(PVR2DROPnoop,PVR2DPATROPcopy) /* masked colour fill blt (used for text) */
|
---|
| 335 |
|
---|
| 336 | /* Legacy support */
|
---|
| 337 | #define PVR2DROP3_PATMASK PVR2DPATROPcopy
|
---|
| 338 | #define PVR2DROP3_SRCMASK PVR2DROPcopy
|
---|
| 339 |
|
---|
| 340 | /* pixmap memory alignment */
|
---|
| 341 | #define PVR2D_ALIGNMENT_4 4 /* DWORD alignment */
|
---|
| 342 | #define PVR2D_ALIGNMENT_ANY 0 /* no alignment */
|
---|
| 343 | #define PVR2D_ALIGNMENT_PALETTE 16 /* 16 byte alignment is required for palettes */
|
---|
| 344 |
|
---|
| 345 | /* Heap number for PVR2DGetFrameBuffer */
|
---|
| 346 | #define PVR2D_FB_PRIMARY_SURFACE 0
|
---|
| 347 |
|
---|
| 348 | #define PVR2D_PRESENT_PROPERTY_SRCSTRIDE (1 << 0)
|
---|
| 349 | #define PVR2D_PRESENT_PROPERTY_DSTSIZE (1 << 1)
|
---|
| 350 | #define PVR2D_PRESENT_PROPERTY_DSTPOS (1 << 2)
|
---|
| 351 | #define PVR2D_PRESENT_PROPERTY_CLIPRECTS (1 << 3)
|
---|
| 352 | #define PVR2D_PRESENT_PROPERTY_INTERVAL (1 << 4)
|
---|
| 353 |
|
---|
| 354 |
|
---|
| 355 | #define PVR2D_CREATE_FLIPCHAIN_SHARED (1 << 0)
|
---|
| 356 | #define PVR2D_CREATE_FLIPCHAIN_QUERY (1 << 1)
|
---|
| 357 |
|
---|
| 358 | /* Functions that the library exports */
|
---|
| 359 |
|
---|
| 360 | PVR2D_IMPORT
|
---|
| 361 | int PVR2DEnumerateDevices(PVR2DDEVICEINFO *pDevInfo);
|
---|
| 362 |
|
---|
| 363 | PVR2D_IMPORT
|
---|
| 364 | PVR2DERROR PVR2DCreateDeviceContext(unsigned long ulDevID,
|
---|
| 365 | PVR2DCONTEXTHANDLE* phContext,
|
---|
| 366 | unsigned long ulFlags);
|
---|
| 367 |
|
---|
| 368 | PVR2D_IMPORT
|
---|
| 369 | PVR2DERROR PVR2DDestroyDeviceContext(PVR2DCONTEXTHANDLE hContext);
|
---|
| 370 |
|
---|
| 371 | PVR2D_IMPORT
|
---|
| 372 | PVR2DERROR PVR2DGetDeviceInfo(PVR2DCONTEXTHANDLE hContext,
|
---|
| 373 | PVR2DDISPLAYINFO *pDisplayInfo);
|
---|
| 374 |
|
---|
| 375 | PVR2D_IMPORT
|
---|
| 376 | PVR2DERROR PVR2DGetScreenMode(PVR2DCONTEXTHANDLE hContext,
|
---|
| 377 | PVR2DFORMAT *pFormat,
|
---|
| 378 | long *plWidth,
|
---|
| 379 | long *plHeight,
|
---|
| 380 | long *plStride,
|
---|
| 381 | int *piRefreshRate);
|
---|
| 382 |
|
---|
| 383 | PVR2D_IMPORT
|
---|
| 384 | PVR2DERROR PVR2DGetFrameBuffer(PVR2DCONTEXTHANDLE hContext,
|
---|
| 385 | int nHeap,
|
---|
| 386 | PVR2DMEMINFO **ppsMemInfo);
|
---|
| 387 |
|
---|
| 388 | PVR2D_IMPORT
|
---|
| 389 | PVR2DERROR PVR2DMemAlloc(PVR2DCONTEXTHANDLE hContext,
|
---|
| 390 | unsigned long ulBytes,
|
---|
| 391 | unsigned long ulAlign,
|
---|
| 392 | unsigned long ulFlags,
|
---|
| 393 | PVR2DMEMINFO **ppsMemInfo);
|
---|
| 394 |
|
---|
| 395 | PVR2D_IMPORT
|
---|
| 396 | PVR2DERROR PVR2DMemWrap(PVR2DCONTEXTHANDLE hContext,
|
---|
| 397 | void *pMem,
|
---|
| 398 | unsigned long ulFlags,
|
---|
| 399 | unsigned long ulBytes,
|
---|
| 400 | unsigned long alPageAddress[],
|
---|
| 401 | PVR2DMEMINFO **ppsMemInfo);
|
---|
| 402 |
|
---|
| 403 | PVR2D_IMPORT
|
---|
| 404 | PVR2DERROR PVR2DMemMap(PVR2DCONTEXTHANDLE hContext,
|
---|
| 405 | unsigned long ulFlags,
|
---|
| 406 | void *hPrivateMapData,
|
---|
| 407 | PVR2DMEMINFO **ppsDstMem);
|
---|
| 408 |
|
---|
| 409 | PVR2D_IMPORT
|
---|
| 410 | PVR2DERROR PVR2DMemFree(PVR2DCONTEXTHANDLE hContext,
|
---|
| 411 | PVR2DMEMINFO *psMemInfo);
|
---|
| 412 |
|
---|
| 413 | PVR2D_IMPORT
|
---|
| 414 | PVR2DERROR PVR2DBlt(PVR2DCONTEXTHANDLE hContext,
|
---|
| 415 | PVR2DBLTINFO *pBltInfo);
|
---|
| 416 |
|
---|
| 417 | PVR2D_IMPORT
|
---|
| 418 | PVR2DERROR PVR2DBltClipped(PVR2DCONTEXTHANDLE hContext,
|
---|
| 419 | PVR2DBLTINFO *pBltInfo,
|
---|
| 420 | unsigned long ulNumClipRects,
|
---|
| 421 | PVR2DRECT *pClipRects);
|
---|
| 422 |
|
---|
| 423 | PVR2D_IMPORT
|
---|
| 424 | PVR2DERROR PVR2DQueryBlitsComplete(PVR2DCONTEXTHANDLE hContext,
|
---|
| 425 | PVR2DMEMINFO *pMemInfo,
|
---|
| 426 | unsigned int uiWaitForComplete);
|
---|
| 427 |
|
---|
| 428 | PVR2D_IMPORT
|
---|
| 429 | PVR2DERROR PVR2DSetPresentBltProperties(PVR2DCONTEXTHANDLE hContext,
|
---|
| 430 | unsigned long ulPropertyMask,
|
---|
| 431 | long lSrcStride,
|
---|
| 432 | unsigned long ulDstWidth,
|
---|
| 433 | unsigned long ulDstHeight,
|
---|
| 434 | long lDstXPos,
|
---|
| 435 | long lDstYPos,
|
---|
| 436 | unsigned long ulNumClipRects,
|
---|
| 437 | PVR2DRECT *pClipRects,
|
---|
| 438 | unsigned long ulSwapInterval);
|
---|
| 439 |
|
---|
| 440 | PVR2D_IMPORT
|
---|
| 441 | PVR2DERROR PVR2DPresentBlt(PVR2DCONTEXTHANDLE hContext,
|
---|
| 442 | PVR2DMEMINFO *pMemInfo,
|
---|
| 443 | long lRenderID);
|
---|
| 444 |
|
---|
| 445 | PVR2D_IMPORT
|
---|
| 446 | PVR2DERROR PVR2DCreateFlipChain(PVR2DCONTEXTHANDLE hContext,
|
---|
| 447 | unsigned long ulFlags,
|
---|
| 448 | unsigned long ulNumBuffers,
|
---|
| 449 | unsigned long ulWidth,
|
---|
| 450 | unsigned long ulHeight,
|
---|
| 451 | PVR2DFORMAT eFormat,
|
---|
| 452 | long *plStride,
|
---|
| 453 | unsigned long *pulFlipChainID,
|
---|
| 454 | PVR2DFLIPCHAINHANDLE *phFlipChain);
|
---|
| 455 |
|
---|
| 456 | PVR2D_IMPORT
|
---|
| 457 | PVR2DERROR PVR2DDestroyFlipChain(PVR2DCONTEXTHANDLE hContext,
|
---|
| 458 | PVR2DFLIPCHAINHANDLE hFlipChain);
|
---|
| 459 |
|
---|
| 460 | PVR2D_IMPORT
|
---|
| 461 | PVR2DERROR PVR2DGetFlipChainBuffers(PVR2DCONTEXTHANDLE hContext,
|
---|
| 462 | PVR2DFLIPCHAINHANDLE hFlipChain,
|
---|
| 463 | unsigned long *pulNumBuffers,
|
---|
| 464 | PVR2DMEMINFO *psMemInfo[]);
|
---|
| 465 |
|
---|
| 466 | PVR2D_IMPORT
|
---|
| 467 | PVR2DERROR PVR2DSetPresentFlipProperties(PVR2DCONTEXTHANDLE hContext,
|
---|
| 468 | PVR2DFLIPCHAINHANDLE hFlipChain,
|
---|
| 469 | unsigned long ulPropertyMask,
|
---|
| 470 | long lDstXPos,
|
---|
| 471 | long lDstYPos,
|
---|
| 472 | unsigned long ulNumClipRects,
|
---|
| 473 | PVR2DRECT *pClipRects,
|
---|
| 474 | unsigned long ulSwapInterval);
|
---|
| 475 |
|
---|
| 476 | PVR2D_IMPORT
|
---|
| 477 | PVR2DERROR PVR2DPresentFlip(PVR2DCONTEXTHANDLE hContext,
|
---|
| 478 | PVR2DFLIPCHAINHANDLE hFlipChain,
|
---|
| 479 | PVR2DMEMINFO *psMemInfo,
|
---|
| 480 | long lRenderID);
|
---|
| 481 |
|
---|
| 482 | PVR2D_IMPORT
|
---|
| 483 | PVR2DERROR PVR2DGetAPIRev(long *lRevMajor, long *lRevMinor);
|
---|
| 484 |
|
---|
| 485 | PVR2D_IMPORT
|
---|
| 486 | PVR2DERROR PVR2DLoadUseCode (const PVR2DCONTEXTHANDLE hContext, const unsigned char *pUseCode,
|
---|
| 487 | const unsigned long UseCodeSize, PVR2D_HANDLE *pUseCodeHandle);
|
---|
| 488 | PVR2D_IMPORT
|
---|
| 489 | PVR2DERROR PVR2DFreeUseCode (const PVR2DCONTEXTHANDLE hContext, const PVR2D_HANDLE hUseCodeHandle);
|
---|
| 490 |
|
---|
| 491 | PVR2D_IMPORT
|
---|
| 492 | PVR2DERROR PVR2DBlt3D (const PVR2DCONTEXTHANDLE hContext, const PPVR2D_3DBLT pBlt3D);
|
---|
| 493 |
|
---|
| 494 | #ifdef __cplusplus
|
---|
| 495 | }
|
---|
| 496 | #endif
|
---|
| 497 |
|
---|
| 498 | #endif /* _PVR2D_H_ */
|
---|
| 499 |
|
---|
| 500 | /******************************************************************************
|
---|
| 501 | End of file (pvr2d.h)
|
---|
| 502 | ******************************************************************************/
|
---|