2 /* DirectDraw Base Functions
4 * Copyright 1997-1999 Marcus Meissner
5 * Copyright 1998 Lionel Ulmer (most of Direct3D stuff)
6 * Copyright 2000 TransGaming Technologies Inc.
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 #include "wine/port.h"
32 #include "wine/exception.h"
33 #include "ddraw_private.h"
35 #include "wine/debug.h"
37 WINE_DEFAULT_DEBUG_CHANNEL(ddraw
);
39 /******************************************************************************
40 * debug output functions
48 #define FE(x) { x, #x }
54 void (*func
)(const void *);
58 #define ME(x,f,e) { x, #x, (void (*)(const void *))(f), offsetof(STRUCT, e) }
60 #define DDRAW_dump_flags(flags,names,num_names) \
61 DDRAW_dump_flags_(flags, names, num_names, 1)
63 static void DDRAW_dump_flags_(DWORD flags
, const flag_info
* names
,
64 size_t num_names
, int newline
)
68 for (i
=0; i
< num_names
; i
++)
69 if (names
[i
].val
& flags
)
70 DPRINTF("%s ", names
[i
].name
);
76 static void DDRAW_dump_members(DWORD flags
, const void* data
,
77 const member_info
* mems
, size_t num_mems
)
81 for (i
=0; i
< num_mems
; i
++)
83 if (mems
[i
].val
& flags
)
85 DPRINTF(" - %s : ", mems
[i
].name
);
86 mems
[i
].func((const char *)data
+ mems
[i
].offset
);
92 void DDRAW_dump_DDBLTFX(DWORD flagmask
)
94 static const flag_info flags
[] =
96 FE(DDBLTFX_ARITHSTRETCHY
),
97 FE(DDBLTFX_MIRRORLEFTRIGHT
),
98 FE(DDBLTFX_MIRRORUPDOWN
),
99 FE(DDBLTFX_NOTEARING
),
100 FE(DDBLTFX_ROTATE180
),
101 FE(DDBLTFX_ROTATE270
),
102 FE(DDBLTFX_ROTATE90
),
103 FE(DDBLTFX_ZBUFFERRANGE
),
104 FE(DDBLTFX_ZBUFFERBASEDEST
)
107 DDRAW_dump_flags(flagmask
, flags
, sizeof(flags
)/sizeof(flags
[0]));
110 void DDRAW_dump_DDBLTFAST(DWORD flagmask
)
112 static const flag_info flags
[] =
114 FE(DDBLTFAST_NOCOLORKEY
),
115 FE(DDBLTFAST_SRCCOLORKEY
),
116 FE(DDBLTFAST_DESTCOLORKEY
),
120 DDRAW_dump_flags(flagmask
, flags
, sizeof(flags
)/sizeof(flags
[0]));
123 void DDRAW_dump_DDBLT(DWORD flagmask
)
125 static const flag_info flags
[] =
128 FE(DDBLT_ALPHADESTCONSTOVERRIDE
),
129 FE(DDBLT_ALPHADESTNEG
),
130 FE(DDBLT_ALPHADESTSURFACEOVERRIDE
),
131 FE(DDBLT_ALPHAEDGEBLEND
),
133 FE(DDBLT_ALPHASRCCONSTOVERRIDE
),
134 FE(DDBLT_ALPHASRCNEG
),
135 FE(DDBLT_ALPHASRCSURFACEOVERRIDE
),
141 FE(DDBLT_KEYDESTOVERRIDE
),
143 FE(DDBLT_KEYSRCOVERRIDE
),
145 FE(DDBLT_ROTATIONANGLE
),
147 FE(DDBLT_ZBUFFERDESTCONSTOVERRIDE
),
148 FE(DDBLT_ZBUFFERDESTOVERRIDE
),
149 FE(DDBLT_ZBUFFERSRCCONSTOVERRIDE
),
150 FE(DDBLT_ZBUFFERSRCOVERRIDE
),
155 DDRAW_dump_flags(flagmask
, flags
, sizeof(flags
)/sizeof(flags
[0]));
158 void DDRAW_dump_DDSCAPS(const DDSCAPS2
*in
)
160 static const flag_info flags
[] = {
161 FE(DDSCAPS_RESERVED1
),
163 FE(DDSCAPS_BACKBUFFER
),
166 FE(DDSCAPS_FRONTBUFFER
),
167 FE(DDSCAPS_OFFSCREENPLAIN
),
170 FE(DDSCAPS_PRIMARYSURFACE
),
171 FE(DDSCAPS_PRIMARYSURFACELEFT
),
172 FE(DDSCAPS_SYSTEMMEMORY
),
174 FE(DDSCAPS_3DDEVICE
),
175 FE(DDSCAPS_VIDEOMEMORY
),
177 FE(DDSCAPS_WRITEONLY
),
180 FE(DDSCAPS_LIVEVIDEO
),
184 FE(DDSCAPS_RESERVED2
),
185 FE(DDSCAPS_ALLOCONLOAD
),
186 FE(DDSCAPS_VIDEOPORT
),
187 FE(DDSCAPS_LOCALVIDMEM
),
188 FE(DDSCAPS_NONLOCALVIDMEM
),
189 FE(DDSCAPS_STANDARDVGAMODE
),
190 FE(DDSCAPS_OPTIMIZED
)
192 static const flag_info flags2
[] = {
193 FE(DDSCAPS2_HARDWAREDEINTERLACE
),
194 FE(DDSCAPS2_HINTDYNAMIC
),
195 FE(DDSCAPS2_HINTSTATIC
),
196 FE(DDSCAPS2_TEXTUREMANAGE
),
197 FE(DDSCAPS2_RESERVED1
),
198 FE(DDSCAPS2_RESERVED2
),
200 FE(DDSCAPS2_HINTANTIALIASING
),
201 FE(DDSCAPS2_CUBEMAP
),
202 FE(DDSCAPS2_CUBEMAP_POSITIVEX
),
203 FE(DDSCAPS2_CUBEMAP_NEGATIVEX
),
204 FE(DDSCAPS2_CUBEMAP_POSITIVEY
),
205 FE(DDSCAPS2_CUBEMAP_NEGATIVEY
),
206 FE(DDSCAPS2_CUBEMAP_POSITIVEZ
),
207 FE(DDSCAPS2_CUBEMAP_NEGATIVEZ
),
208 FE(DDSCAPS2_MIPMAPSUBLEVEL
),
209 FE(DDSCAPS2_D3DTEXTUREMANAGE
),
210 FE(DDSCAPS2_DONOTPERSIST
),
211 FE(DDSCAPS2_STEREOSURFACELEFT
)
214 DDRAW_dump_flags_(in
->dwCaps
, flags
, sizeof(flags
)/sizeof(flags
[0]), 0);
215 DDRAW_dump_flags_(in
->dwCaps2
, flags2
, sizeof(flags2
)/sizeof(flags2
[0]), 0);
218 void DDRAW_dump_pixelformat_flag(DWORD flagmask
)
220 static const flag_info flags
[] =
222 FE(DDPF_ALPHAPIXELS
),
225 FE(DDPF_PALETTEINDEXED4
),
226 FE(DDPF_PALETTEINDEXEDTO8
),
227 FE(DDPF_PALETTEINDEXED8
),
233 FE(DDPF_PALETTEINDEXED1
),
234 FE(DDPF_PALETTEINDEXED2
),
238 DDRAW_dump_flags_(flagmask
, flags
, sizeof(flags
)/sizeof(flags
[0]), 0);
241 void DDRAW_dump_paletteformat(DWORD dwFlags
)
243 static const flag_info flags
[] =
246 FE(DDPCAPS_8BITENTRIES
),
248 FE(DDPCAPS_INITIALIZE
),
249 FE(DDPCAPS_PRIMARYSURFACE
),
250 FE(DDPCAPS_PRIMARYSURFACELEFT
),
251 FE(DDPCAPS_ALLOW256
),
258 DDRAW_dump_flags(dwFlags
, flags
, sizeof(flags
)/sizeof(flags
[0]));
261 void DDRAW_dump_pixelformat(const DDPIXELFORMAT
*pf
) {
263 DDRAW_dump_pixelformat_flag(pf
->dwFlags
);
264 if (pf
->dwFlags
& DDPF_FOURCC
) {
265 DPRINTF(", dwFourCC code '%c%c%c%c' (0x%08lx) - %ld bits per pixel",
266 (unsigned char)( pf
->dwFourCC
&0xff),
267 (unsigned char)((pf
->dwFourCC
>> 8)&0xff),
268 (unsigned char)((pf
->dwFourCC
>>16)&0xff),
269 (unsigned char)((pf
->dwFourCC
>>24)&0xff),
274 if (pf
->dwFlags
& DDPF_RGB
) {
276 DPRINTF(", RGB bits: %ld, ", pf
->u1
.dwRGBBitCount
);
277 switch (pf
->u1
.dwRGBBitCount
) {
278 case 4: cmd
= "%1lx"; break;
279 case 8: cmd
= "%02lx"; break;
280 case 16: cmd
= "%04lx"; break;
281 case 24: cmd
= "%06lx"; break;
282 case 32: cmd
= "%08lx"; break;
283 default: ERR("Unexpected bit depth !\n"); cmd
= "%d"; break;
285 DPRINTF(" R "); DPRINTF(cmd
, pf
->u2
.dwRBitMask
);
286 DPRINTF(" G "); DPRINTF(cmd
, pf
->u3
.dwGBitMask
);
287 DPRINTF(" B "); DPRINTF(cmd
, pf
->u4
.dwBBitMask
);
288 if (pf
->dwFlags
& DDPF_ALPHAPIXELS
) {
289 DPRINTF(" A "); DPRINTF(cmd
, pf
->u5
.dwRGBAlphaBitMask
);
291 if (pf
->dwFlags
& DDPF_ZPIXELS
) {
292 DPRINTF(" Z "); DPRINTF(cmd
, pf
->u5
.dwRGBZBitMask
);
295 if (pf
->dwFlags
& DDPF_ZBUFFER
) {
296 DPRINTF(", Z bits : %ld", pf
->u1
.dwZBufferBitDepth
);
298 if (pf
->dwFlags
& DDPF_ALPHA
) {
299 DPRINTF(", Alpha bits : %ld", pf
->u1
.dwAlphaBitDepth
);
304 void DDRAW_dump_colorkeyflag(DWORD ck
)
306 static const flag_info flags
[] =
308 FE(DDCKEY_COLORSPACE
),
310 FE(DDCKEY_DESTOVERLAY
),
312 FE(DDCKEY_SRCOVERLAY
)
315 DDRAW_dump_flags(ck
, flags
, sizeof(flags
)/sizeof(flags
[0]));
318 static void DDRAW_dump_DWORD(const void *in
) {
319 DPRINTF("%ld", *((const DWORD
*) in
));
321 static void DDRAW_dump_PTR(const void *in
) {
322 DPRINTF("%p", *((const void **) in
));
324 void DDRAW_dump_DDCOLORKEY(const DDCOLORKEY
*ddck
) {
325 DPRINTF(" Low : %ld - High : %ld", ddck
->dwColorSpaceLowValue
, ddck
->dwColorSpaceHighValue
);
328 void DDRAW_dump_surface_desc(const DDSURFACEDESC2
*lpddsd
)
330 #define STRUCT DDSURFACEDESC2
331 static const member_info members
[] =
333 ME(DDSD_CAPS
, DDRAW_dump_DDSCAPS
, ddsCaps
),
334 ME(DDSD_HEIGHT
, DDRAW_dump_DWORD
, dwHeight
),
335 ME(DDSD_WIDTH
, DDRAW_dump_DWORD
, dwWidth
),
336 ME(DDSD_PITCH
, DDRAW_dump_DWORD
, u1
.lPitch
),
337 ME(DDSD_LINEARSIZE
, DDRAW_dump_DWORD
, u1
.dwLinearSize
),
338 ME(DDSD_BACKBUFFERCOUNT
, DDRAW_dump_DWORD
, dwBackBufferCount
),
339 ME(DDSD_MIPMAPCOUNT
, DDRAW_dump_DWORD
, u2
.dwMipMapCount
),
340 ME(DDSD_REFRESHRATE
, DDRAW_dump_DWORD
, u2
.dwRefreshRate
),
341 ME(DDSD_ALPHABITDEPTH
, DDRAW_dump_DWORD
, dwAlphaBitDepth
),
342 ME(DDSD_LPSURFACE
, DDRAW_dump_PTR
, lpSurface
),
343 ME(DDSD_CKDESTOVERLAY
, DDRAW_dump_DDCOLORKEY
, u3
.ddckCKDestOverlay
),
344 ME(DDSD_CKDESTBLT
, DDRAW_dump_DDCOLORKEY
, ddckCKDestBlt
),
345 ME(DDSD_CKSRCOVERLAY
, DDRAW_dump_DDCOLORKEY
, ddckCKSrcOverlay
),
346 ME(DDSD_CKSRCBLT
, DDRAW_dump_DDCOLORKEY
, ddckCKSrcBlt
),
347 ME(DDSD_PIXELFORMAT
, DDRAW_dump_pixelformat
, u4
.ddpfPixelFormat
)
350 DDRAW_dump_members(lpddsd
->dwFlags
, lpddsd
, members
,
351 sizeof(members
)/sizeof(members
[0]));
354 void DDRAW_dump_cooperativelevel(DWORD cooplevel
)
356 static const flag_info flags
[] =
358 FE(DDSCL_FULLSCREEN
),
359 FE(DDSCL_ALLOWREBOOT
),
360 FE(DDSCL_NOWINDOWCHANGES
),
362 FE(DDSCL_ALLOWMODEX
),
364 FE(DDSCL_SETFOCUSWINDOW
),
365 FE(DDSCL_SETDEVICEWINDOW
),
366 FE(DDSCL_CREATEDEVICEWINDOW
)
372 DDRAW_dump_flags(cooplevel
, flags
, sizeof(flags
)/sizeof(flags
[0]));
376 void DDRAW_dump_DDCAPS(const DDCAPS
*lpcaps
) {
377 static const flag_info flags1
[] = {
379 FE(DDCAPS_ALIGNBOUNDARYDEST
),
380 FE(DDCAPS_ALIGNSIZEDEST
),
381 FE(DDCAPS_ALIGNBOUNDARYSRC
),
382 FE(DDCAPS_ALIGNSIZESRC
),
383 FE(DDCAPS_ALIGNSTRIDE
),
386 FE(DDCAPS_BLTFOURCC
),
387 FE(DDCAPS_BLTSTRETCH
),
390 FE(DDCAPS_OVERLAYCANTCLIP
),
391 FE(DDCAPS_OVERLAYFOURCC
),
392 FE(DDCAPS_OVERLAYSTRETCH
),
394 FE(DDCAPS_PALETTEVSYNC
),
395 FE(DDCAPS_READSCANLINE
),
396 FE(DDCAPS_STEREOVIEW
),
399 FE(DDCAPS_ZOVERLAYS
),
402 FE(DDCAPS_COLORKEYHWASSIST
),
403 FE(DDCAPS_NOHARDWARE
),
404 FE(DDCAPS_BLTCOLORFILL
),
405 FE(DDCAPS_BANKSWITCHED
),
406 FE(DDCAPS_BLTDEPTHFILL
),
408 FE(DDCAPS_CANCLIPSTRETCHED
),
409 FE(DDCAPS_CANBLTSYSMEM
)
411 static const flag_info flags2
[] = {
412 FE(DDCAPS2_CERTIFIED
),
413 FE(DDCAPS2_NO2DDURING3DSCENE
),
414 FE(DDCAPS2_VIDEOPORT
),
415 FE(DDCAPS2_AUTOFLIPOVERLAY
),
416 FE(DDCAPS2_CANBOBINTERLEAVED
),
417 FE(DDCAPS2_CANBOBNONINTERLEAVED
),
418 FE(DDCAPS2_COLORCONTROLOVERLAY
),
419 FE(DDCAPS2_COLORCONTROLPRIMARY
),
420 FE(DDCAPS2_CANDROPZ16BIT
),
421 FE(DDCAPS2_NONLOCALVIDMEM
),
422 FE(DDCAPS2_NONLOCALVIDMEMCAPS
),
423 FE(DDCAPS2_NOPAGELOCKREQUIRED
),
424 FE(DDCAPS2_WIDESURFACES
),
425 FE(DDCAPS2_CANFLIPODDEVEN
),
426 FE(DDCAPS2_CANBOBHARDWARE
),
427 FE(DDCAPS2_COPYFOURCC
),
428 FE(DDCAPS2_PRIMARYGAMMA
),
429 FE(DDCAPS2_CANRENDERWINDOWED
),
430 FE(DDCAPS2_CANCALIBRATEGAMMA
),
431 FE(DDCAPS2_FLIPINTERVAL
),
432 FE(DDCAPS2_FLIPNOVSYNC
),
433 FE(DDCAPS2_CANMANAGETEXTURE
),
434 FE(DDCAPS2_TEXMANINNONLOCALVIDMEM
),
436 FE(DDCAPS2_SYSTONONLOCAL_AS_SYSTOLOCAL
)
438 static const flag_info flags3
[] = {
439 FE(DDCKEYCAPS_DESTBLT
),
440 FE(DDCKEYCAPS_DESTBLTCLRSPACE
),
441 FE(DDCKEYCAPS_DESTBLTCLRSPACEYUV
),
442 FE(DDCKEYCAPS_DESTBLTYUV
),
443 FE(DDCKEYCAPS_DESTOVERLAY
),
444 FE(DDCKEYCAPS_DESTOVERLAYCLRSPACE
),
445 FE(DDCKEYCAPS_DESTOVERLAYCLRSPACEYUV
),
446 FE(DDCKEYCAPS_DESTOVERLAYONEACTIVE
),
447 FE(DDCKEYCAPS_DESTOVERLAYYUV
),
448 FE(DDCKEYCAPS_SRCBLT
),
449 FE(DDCKEYCAPS_SRCBLTCLRSPACE
),
450 FE(DDCKEYCAPS_SRCBLTCLRSPACEYUV
),
451 FE(DDCKEYCAPS_SRCBLTYUV
),
452 FE(DDCKEYCAPS_SRCOVERLAY
),
453 FE(DDCKEYCAPS_SRCOVERLAYCLRSPACE
),
454 FE(DDCKEYCAPS_SRCOVERLAYCLRSPACEYUV
),
455 FE(DDCKEYCAPS_SRCOVERLAYONEACTIVE
),
456 FE(DDCKEYCAPS_SRCOVERLAYYUV
),
457 FE(DDCKEYCAPS_NOCOSTOVERLAY
)
459 static const flag_info flags4
[] = {
460 FE(DDFXCAPS_BLTALPHA
),
461 FE(DDFXCAPS_OVERLAYALPHA
),
462 FE(DDFXCAPS_BLTARITHSTRETCHYN
),
463 FE(DDFXCAPS_BLTARITHSTRETCHY
),
464 FE(DDFXCAPS_BLTMIRRORLEFTRIGHT
),
465 FE(DDFXCAPS_BLTMIRRORUPDOWN
),
466 FE(DDFXCAPS_BLTROTATION
),
467 FE(DDFXCAPS_BLTROTATION90
),
468 FE(DDFXCAPS_BLTSHRINKX
),
469 FE(DDFXCAPS_BLTSHRINKXN
),
470 FE(DDFXCAPS_BLTSHRINKY
),
471 FE(DDFXCAPS_BLTSHRINKYN
),
472 FE(DDFXCAPS_BLTSTRETCHX
),
473 FE(DDFXCAPS_BLTSTRETCHXN
),
474 FE(DDFXCAPS_BLTSTRETCHY
),
475 FE(DDFXCAPS_BLTSTRETCHYN
),
476 FE(DDFXCAPS_OVERLAYARITHSTRETCHY
),
477 FE(DDFXCAPS_OVERLAYARITHSTRETCHYN
),
478 FE(DDFXCAPS_OVERLAYSHRINKX
),
479 FE(DDFXCAPS_OVERLAYSHRINKXN
),
480 FE(DDFXCAPS_OVERLAYSHRINKY
),
481 FE(DDFXCAPS_OVERLAYSHRINKYN
),
482 FE(DDFXCAPS_OVERLAYSTRETCHX
),
483 FE(DDFXCAPS_OVERLAYSTRETCHXN
),
484 FE(DDFXCAPS_OVERLAYSTRETCHY
),
485 FE(DDFXCAPS_OVERLAYSTRETCHYN
),
486 FE(DDFXCAPS_OVERLAYMIRRORLEFTRIGHT
),
487 FE(DDFXCAPS_OVERLAYMIRRORUPDOWN
)
489 static const flag_info flags5
[] = {
490 FE(DDFXALPHACAPS_BLTALPHAEDGEBLEND
),
491 FE(DDFXALPHACAPS_BLTALPHAPIXELS
),
492 FE(DDFXALPHACAPS_BLTALPHAPIXELSNEG
),
493 FE(DDFXALPHACAPS_BLTALPHASURFACES
),
494 FE(DDFXALPHACAPS_BLTALPHASURFACESNEG
),
495 FE(DDFXALPHACAPS_OVERLAYALPHAEDGEBLEND
),
496 FE(DDFXALPHACAPS_OVERLAYALPHAPIXELS
),
497 FE(DDFXALPHACAPS_OVERLAYALPHAPIXELSNEG
),
498 FE(DDFXALPHACAPS_OVERLAYALPHASURFACES
),
499 FE(DDFXALPHACAPS_OVERLAYALPHASURFACESNEG
)
501 static const flag_info flags6
[] = {
503 FE(DDPCAPS_8BITENTRIES
),
505 FE(DDPCAPS_INITIALIZE
),
506 FE(DDPCAPS_PRIMARYSURFACE
),
507 FE(DDPCAPS_PRIMARYSURFACELEFT
),
508 FE(DDPCAPS_ALLOW256
),
514 static const flag_info flags7
[] = {
515 FE(DDSVCAPS_RESERVED1
),
516 FE(DDSVCAPS_RESERVED2
),
517 FE(DDSVCAPS_RESERVED3
),
518 FE(DDSVCAPS_RESERVED4
),
519 FE(DDSVCAPS_STEREOSEQUENTIAL
),
522 DPRINTF(" - dwSize : %ld\n", lpcaps
->dwSize
);
523 DPRINTF(" - dwCaps : "); DDRAW_dump_flags(lpcaps
->dwCaps
, flags1
, sizeof(flags1
)/sizeof(flags1
[0]));
524 DPRINTF(" - dwCaps2 : "); DDRAW_dump_flags(lpcaps
->dwCaps2
, flags2
, sizeof(flags2
)/sizeof(flags2
[0]));
525 DPRINTF(" - dwCKeyCaps : "); DDRAW_dump_flags(lpcaps
->dwCKeyCaps
, flags3
, sizeof(flags3
)/sizeof(flags3
[0]));
526 DPRINTF(" - dwFXCaps : "); DDRAW_dump_flags(lpcaps
->dwFXCaps
, flags4
, sizeof(flags4
)/sizeof(flags4
[0]));
527 DPRINTF(" - dwFXAlphaCaps : "); DDRAW_dump_flags(lpcaps
->dwFXAlphaCaps
, flags5
, sizeof(flags5
)/sizeof(flags5
[0]));
528 DPRINTF(" - dwPalCaps : "); DDRAW_dump_flags(lpcaps
->dwPalCaps
, flags6
, sizeof(flags6
)/sizeof(flags6
[0]));
529 DPRINTF(" - dwSVCaps : "); DDRAW_dump_flags(lpcaps
->dwSVCaps
, flags7
, sizeof(flags7
)/sizeof(flags7
[0]));
531 DPRINTF(" - dwNumFourCCCodes : %ld\n", lpcaps
->dwNumFourCCCodes
);
532 DPRINTF(" - dwCurrVisibleOverlays : %ld\n", lpcaps
->dwCurrVisibleOverlays
);
533 DPRINTF(" - dwMinOverlayStretch : %ld\n", lpcaps
->dwMinOverlayStretch
);
534 DPRINTF(" - dwMaxOverlayStretch : %ld\n", lpcaps
->dwMaxOverlayStretch
);
536 DPRINTF(" - ddsCaps : "); DDRAW_dump_DDSCAPS(&lpcaps
->ddsCaps
); DPRINTF("\n");