This thread is an introduction to the Win32
DirectDraw API.
DirectDraw is an interface that allows the programmer more direct access to the video system than the earlier GDI and GDI+ interfaces.
According to Microsoft (https://learn.microsoft.com/en-us/previous-versions/windows/desktop/bb153255(v=vs.85)):
QuoteThe DirectDraw application programming interface (API) is the component of DirectX that enables you to directly manipulate display memory, the hardware blitter, hardware overlay support, and flipping surface support. For more information, see the Microsoft.DirectX.DirectDraw managed code reference documentation.
In this thread you'll find coding examples showing how to use DirectDraw, as well as discussions and questions and answers regarding that interface.
Note: Be aware that this is actually an old interface that, according to Microsoft, has been "deprecated":
QuoteWarning: Microsoft DirectDraw has been deprecated. Deprecated components of Microsoft DirectX 9.0 for Managed Code are considered obsolete. While these components are still supported in this release of DirectX 9.0 for Managed Code, they may be removed in the future. When writing new applications, you should avoid using these deprecated components. When modifying existing applications, you are strongly encouraged to remove any dependency on these components.
2 examples using DirectDraw.
Very old but, maybe you can use it.
Quote from: Siekmanski on March 02, 2025, 11:13:02 AM2 examples using DirectDraw.
Very old but, maybe you can use it.
I credit you (and your coding style) with making DirectX click for me. Really. Thank you!
David: It's coming soon; I'm working on it now. BTW, this thread is a very good idea for many of us.
Quote from: Siekmanski on March 02, 2025, 11:13:02 AM2 examples using DirectDraw.
include\ddraw.inc(731) : error A2181: initializer must be a string or single item
include\ddraw.inc(731) : error A2138: invalid data initializer
include\ddraw.inc(774) : error A2181: initializer must be a string or single item
include\ddraw.inc(774) : error A2138: invalid data initializerDoes your code require an older version of ddraw.inc?
Looking at that file (
ddraw.inc), I only see prototypes for the following functions:
- DDGetAttachedSurfaceLcl()
- DDInternalLock()
- DDInternalUnlock()
- DSoundHelp()
- DirectDrawCreate()
- DirectDrawCreateClipper()
- DirectDrawCreateEx()
- DirectDrawEnumerate() (4 flavors, A/W & "Ex")
- GetDDSurfaceLocal()
- GetSurfaceFromDC()
No primitives, like line, ellipse, etc., so I guess that's all up to the programmer to create? (I still really have no clue how this all works.)
Those are just wrapper functions.
DirectDraw is COM based.
Ah, so. So the real functions are pointed to in the vtable. Gotcha.
Quote from: jj2007 on March 03, 2025, 08:10:22 AMQuote from: Siekmanski on March 02, 2025, 11:13:02 AM2 examples using DirectDraw.
include\ddraw.inc(731) : error A2181: initializer must be a string or single item
include\ddraw.inc(731) : error A2138: invalid data initializer
include\ddraw.inc(774) : error A2181: initializer must be a string or single item
include\ddraw.inc(774) : error A2138: invalid data initializer
Does your code require an older version of ddraw.inc?
Marinus has code and include files+libs linked somewhere around here. He was once helping felipe get a handle on DirectDraw stuff way back whenever... I recall only bits of it, it could have been 3D stuff. Maybe in the GameDevelopment section?
Later:
I found what I was thinking of Here (https://masm32.com/board/index.php?msg=75640). But the link no longer works there.
Also further down, Siekmanski mentioned using DX9...
Quote from: Siekmanski on April 11, 2018, 08:02:41 AMDid you download the latest DirectX9 End-User Runtimes?
DirectX End-User Runtimes (June 2010)
https://www.microsoft.com/en-us/download/details.aspx?id=8109
I would think that is what his code posted above uses, as he said they were 'old' examples.
Maybe Siekmanski will come back and shed some light on this, but he doesn't visit here very often anymore.
include\ddraw.inc(731) : error A2181: initializer must be a string or single item
include\ddraw.inc(731) : error A2138: invalid data initializer
include\ddraw.inc(774) : error A2181: initializer must be a string or single item
include\ddraw.inc(774) : error A2138: invalid data initializerJust define LARGE_INTEGER in your code.
Quote from: sinsi on March 03, 2025, 05:12:12 PMJust define LARGE_INTEGER in your code.
With LARGE_INTEGER equ QWORD I get internal assembler errors
MASM : fatal error A1016: Internal error
Version 10.00.40219.01
ExceptionCode = C0000005
ExceptionFlags = 00000000
ExceptionAddress = 0096484FMasm 6.14 complains about the structure in Windows.inc, line 8112:
LARGE_INTEGER UNION
STRUCT
LowPart DWORD ?
HighPart DWORD ?
ENDS
QuadPart QWORD ?
LARGE_INTEGER ENDSWithout defining:
include\ddraw.inc(731) : error A2181: initializer must be a string or single item
Which is kind of funny because ddraw.inc is just 44 lines short...
Confucius say "When you dash off a glib answer you tend to get bitten in the bum :sad: "
I have problems building too.
After looking at a couple of the example source files posted here, I have a request to make:
If you're going to post a programming example here, please, PLEASE COMMENT IT! Nothing more useless than an example that might work but gives the uninitiated programmer no clue as to HOW it works.
Even commented pseudocode would be better than uncommented actual ASM code.
If it's deprecated, why not go for Direct2D?
Quote from: jj2007 on March 04, 2025, 11:19:16 PMIf it's deprecated, why not go for Direct2D?
also Direct2D is deprecated and included to Direct3D since version 9
So... how complicated would it be to draw a circle in Direct3D?
Quote from: jj2007 on March 05, 2025, 07:33:53 AMSo... how complicated would it be to draw a circle in Direct3D?
at this point i borrow a thing like Agatha Christie, why you don't ask from Siekmanski
Quotealso Direct2D is deprecated and included to Direct3D since version 9
Classic Microsoft, deprecating something years before they've even invented it
I wouldn't be against folks posting examples of those other APIs (Direct2D and Direct3D) here, since they're somewhat related to DirectDraw.
It's all good. (Even if it's "deprecated"!)
Use the provided files msvcrt.lib and msvcrt.inc and it should work.
All libs and include files are in the zip file
Here some examples to use Direct3D9 in 2D mode.
Another dd example, that needs no external include or lib files and uses GDI to draw to primary surface.
Quote from: Siekmanski on March 05, 2025, 12:03:02 PMHere some examples to use Direct3D9 in 2D mode.
To build S_lib_Sprite.asm, replace all sprintf with crt_sprintf. However, it hangs in D3DDrawText :cool:
00401275 |. 68 544D4000 push offset szString_buffer ; /Arg6 = ASCII "FPS: 0.049 Timer: 20.567"
0040127A |. 68 00FFFFFF push -100 ; |Arg5 = -100
0040127F |. FF35 B8414000 push dword ptr [??0023] ; |Arg4 = 41600000
00401285 |. FF35 B4414000 push dword ptr [??0022] ; |Arg3 = 0
0040128B |. FF35 B0414000 push dword ptr [??0021] ; |Arg2 = 0
00401291 |. FF35 04404000 push dword ptr [g_pD3DDevice] ; |Arg1 = 7E8BE0
00401297 |. E8 5C0D0000 call D3DDrawText ; \S_lib_Sprite.D3DDrawText
More precisely, here:
CPU Disasm
Address Hex dump Command Comments
0040216C |. 8B55 08 mov edx, [arg1]
0040216F |. 8B12 mov edx, [edx]
00402171 |. FF75 F4 push dword ptr [local.3]
00402174 |. 6A 00 push 0
00402176 |. FF75 F8 push dword ptr [local.2]
00402179 |. 6A 00 push 0
0040217B |. 6A 00 push 0
0040217D |. 6A 04 push 4
0040217F |. FF75 08 push dword ptr [arg1]
00402182 |. FF92 48010000 call near [edx+148] ; hangs here
Quote from: _japheth on March 05, 2025, 04:11:40 PMAnother dd example, that needs no external include or lib files and uses GDI to draw to primary surface.
Builds & runs fine. You may have to add
\masm32\bin\jwasm in the make.bat
to run old ddraw code,probably some old ddraw game installed before with ddraw makes it works
I have made many ddraw code SSE,even MMX
compared to pixelshaders,SSE have limited to fast sqrt =pixelshader way of drawing circles