1. 项目概述重温经典图形编程的魅力最近在整理旧硬盘时翻出了一个十几年前用Visual C 6.0和DirectDraw写的“水波纹效果”演示程序。重新打开工程看着那熟悉的MFC界面和一行行略显“古老”的代码不禁感慨万千。在如今WebGL、Unity、Unreal Engine大行其道的时代DirectDraw早已是尘封在历史中的技术微软也早已停止对其支持。但正是这些“过时”的技术构成了我们这一代程序员图形编程的启蒙。这个项目不仅仅是一个实现水波纹特效的代码示例它更像是一个时间胶囊封装了那个年代在有限硬件资源下程序员们如何绞尽脑汁用CPU实时演算复杂视觉效果的热情与智慧。这个水波纹效果的核心原理是模拟一个二维水面网格的波动传播。你可以想象用一个石子投入平静的池塘涟漪会一圈圈扩散开来遇到边界还会反射。在程序中我们用两个二维数组通常称为“高度场”或“位移缓冲区”来记录水面每个“像素点”在上一帧和当前帧的“高度”或能量状态。通过一个简单的物理公式通常是相邻点的平均值减去当前点的某种衰减我们就能计算出下一帧每个点的状态从而实现波纹的扩散、衰减和叠加。最后再根据这个动态的“高度场”去扭曲一张背景纹理比如一幅风景图让背景图像看起来像是在水下波动从而产生逼真的水波倒影效果。整个过程完全由CPU计算不涉及任何硬件加速因此对算法效率的要求极高。虽然DirectDraw已退出历史舞台但学习这个项目依然有它的价值。对于想深入理解计算机图形学底层原理特别是实时模拟和渲染技术的新手来说这是一个绝佳的“麻雀虽小五脏俱全”的案例。它涵盖了双缓冲绘图、内存直接操作、物理模拟简化、纹理映射扭曲等核心概念。通过亲手实现它你能深刻理解“每一帧像素是如何被计算和绘制出来的”这种底层认知是使用现代高级图形API时不可或缺的。接下来我将带你一步步拆解这个经典实例从环境搭建到原理实现再到代码优化和问题排查分享那些当年踩过的坑和总结出的技巧。2. 环境准备与DirectDraw基础2.1 开发环境搭建拥抱经典或寻求兼容要复现这个项目你首先需要一个能编译DirectDraw程序的开发环境。最原汁原味的当然是Visual C 6.0配合古老的DirectX SDK如August 2007版或更早。VC6的工程文件.dsp, .dsw和编译器在今天看来已经非常陈旧在Windows 10/11上直接安装和运行可能会遇到各种兼容性问题比如安装失败、IDE闪退等。注意如果你坚持使用VC6建议在虚拟机如VMware或VirtualBox中安装一个Windows XP或Windows 7的镜像这是最稳定的方式。但考虑到便利性我更推荐下面的现代方案。对于大多数想学习原理而非考古的开发者我推荐使用Visual Studio 2019或2022的社区版。它们是免费的并且对C的支持非常完善。关键步骤在于让现代VS能够识别和链接DirectDraw库获取DirectX头文件和库你需要一个包含ddraw.h和ddraw.lib的DirectX SDK。微软最后的独立SDK是“DirectX SDK (June 2010)”。安装后记下安装路径例如C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\。配置VS项目打开VS创建一个新的“空项目”或“Win32控制台应用程序”项目。右键项目 - 属性 -配置属性 - VC目录。在“包含目录”中添加DirectX SDK的Include文件夹路径。在“库目录”中添加DirectX SDK的Lib\x8632位程序或Lib\x6464位程序路径。由于DirectDraw是古老的32位技术通常编译为32位x86程序兼容性更好。链接库文件在项目属性 -链接器 - 输入 - 附加依赖项中添加ddraw.lib和dxguid.lib。dxguid.lib提供了DirectDraw接口的GUID定义必不可少。解决兼容性冲突新版本Windows SDK自Windows 8以后中的sal.h头文件可能与老DirectX SDK的某些定义冲突。一个常见的解决方法是在项目属性 -C/C - 高级中设置“禁用特定警告”为4996针对某些不安全的函数如sprintf并在包含ddraw.h之前在stdafx.h或源文件顶部添加宏定义#define DIRECTINPUT_VERSION 0x0800。有时甚至需要调整包含目录的顺序确保老SDK的路径在新Windows SDK路径之前。2.2 DirectDraw核心对象与初始化流程DirectDraw是DirectX中负责2D图形绘制的组件它允许程序直接操作显示内存实现高速的位图块传输Blitting。它的核心对象模型并不复杂LPDIRECTDRAW7 (DirectDraw对象)这是总入口代表显示硬件。通过DirectDrawCreateEx函数创建。LPDIRECTDRAWSURFACE7 (DirectDraw表面)这是绘图发生的地方。表面就是一块内存区域可以驻留在显存或系统内存中。我们至少需要两个表面主表面 (Primary Surface)对应显示器的可见区域一般是全屏模式下的整个屏幕或窗口模式下的客户区。它是离屏的直接翻转到前台显示。后缓冲表面 (Back Buffer Surface)我们在这一帧绘制的内容先放在这里绘制完成后通过“翻转Flip”或“位块传输Blt”操作交换到主表面从而实现双缓冲避免画面撕裂。LPDIRECTDRAWPALETTE (调色板)对于8位256色模式需要用它来管理颜色索引。我们的水波纹示例通常使用16位或24/32位高彩色模式所以可以忽略调色板。初始化DirectDraw的典型流程如下这段代码展示了如何为窗口模式创建一个带有后缓冲的DirectDraw对象// 1. 创建DirectDraw对象 LPDIRECTDRAW7 lpDD NULL; HRESULT hr DirectDrawCreateEx(NULL, (void**)lpDD, IID_IDirectDraw7, NULL); if (FAILED(hr)) { /* 错误处理 */ } // 2. 设置协作级别窗口模式 hr lpDD-SetCooperativeLevel(hWnd, DDSCL_NORMAL); // hWnd是窗口句柄 if (FAILED(hr)) { /* 错误处理 */ } // 3. 描述主表面窗口模式的主表面就是客户区 DDSURFACEDESC2 ddsd; ZeroMemory(ddsd, sizeof(ddsd)); ddsd.dwSize sizeof(ddsd); ddsd.dwFlags DDSD_CAPS; ddsd.ddsCaps.dwCaps DDSCAPS_PRIMARYSURFACE; // 4. 创建主表面 LPDIRECTDRAWSURFACE7 lpPrimary NULL; hr lpDD-CreateSurface(ddsd, lpPrimary, NULL); if (FAILED(hr)) { /* 错误处理 */ } // 5. 描述后缓冲表面 ZeroMemory(ddsd, sizeof(ddsd)); ddsd.dwSize sizeof(ddsd); ddsd.dwFlags DDSD_CAPS | DDSD_WIDTH | DDSD_HEIGHT; ddsd.ddsCaps.dwCaps DDSCAPS_OFFSCREENPLAIN; ddsd.dwWidth 640; // 你的后缓冲宽度 ddsd.dwHeight 480; // 你的后缓冲高度 // 6. 创建后缓冲表面 LPDIRECTDRAWSURFACE7 lpBackBuffer NULL; hr lpDD-CreateSurface(ddsd, lpBackBuffer, NULL); if (FAILED(hr)) { /* 错误处理 */ }实操心得在窗口模式下主表面的大小和位置由系统管理我们不能直接锁定Lock它进行像素级绘制。正确的做法是所有绘图操作都在后缓冲表面lpBackBuffer上完成然后使用lpPrimary-Blt或BltFast函数将后缓冲的内容拷贝到主表面的对应位置通常是客户区矩形。这是窗口模式DirectDraw编程的一个关键点新手常犯的错误就是试图直接画在主表面上。3. 水波纹效果的核心算法解析3.1 物理模型简化的波动方程水波纹的模拟本质上是对二维波动方程的数值求解。一个完整的水波物理模型非常复杂但在实时图形中我们采用一个极度简化但效果惊人的算法常被称为“水池算法”或“细胞自动机算法”。我们准备两个大小与屏幕或渲染区域相同的二维数组buf1和buf2它们交替扮演“当前帧高度场”和“上一帧高度场”的角色。数组中的每个元素代表水面某一点的垂直位移可以理解为波峰或波谷的高度。核心的扩散计算公式如下伪代码表示// 假设 buf1 是当前帧 buf2 是上一帧 for (int y 1; y height-1; y) { for (int x 1; x width-1; x) { // 计算周围四个点的平均值 short sum (buf2[y-1][x] buf2[y1][x] buf2[y][x-1] buf2[y][x1]) / 2; // 新的高度 平均值 - 当前高度 short newHeight sum - buf1[y][x]; // 应用阻尼衰减使波纹逐渐消失 newHeight newHeight * damping / 256; // damping是一个衰减因子如240 // 更新当前帧缓冲区 buf1[y][x] newHeight; } }计算完成后交换buf1和buf2的角色为下一帧计算做准备。这个公式的直观理解想象水面是一个由许多小弹簧连接起来的网格。某个点被按下能量注入后它会拉动周围的点周围的点又会拉动更远的点能量就这样传播开来。公式中的(sum / 2) - buf1[y][x]实现了能量的传递和惯性。衰减因子damping模拟了水的粘滞阻力使波动能量逐渐耗散。这个算法计算量小每个点只依赖其四个直接邻居非常适合用CPU实时计算。3.2 纹理扭曲将高度场转化为视觉画面有了动态的高度场buf1我们如何让它看起来像水波呢答案是纹理扭曲。我们有一张背景纹理比如一张蓝天白云的BMP图片我们希望根据水波的高度来偏移采样这张纹理的位置模拟光线在水面折射的效果。最简单的扭曲方法是使用位移映射。对于渲染目标后缓冲表面上的每个像素(x, y)查询该点在高度场buf1中对应的“高度”值h。同时也查询其相邻点(x1, y)和(x, y1)的高度值计算出该点高度的“梯度”或“导数”这代表了水面的倾斜程度。根据倾斜程度计算出一个纹理坐标的偏移量(dx, dy)。从背景纹理的(x dx, y dy)位置取样颜色绘制到后缓冲的(x, y)位置。一个常用的简化版本是直接使用当前点及其相邻点的高度差来作为偏移量int offsetX (buf1[y][x1] - buf1[y][x-1]) / 32; // 除以一个系数控制扭曲强度 int offsetY (buf1[y1][x] - buf1[y-1][x]) / 32; int texX (x offsetX) (texWidth - 1); // 使用位与()进行环绕如果纹理是2的幂次方 int texY (y offsetY) (texHeight - 1); COLORREF color GetPixelFromTexture(texX, texY); // 从背景纹理获取颜色 SetPixelOnBackBuffer(x, y, color); // 绘制到后缓冲通过这种方式平静的水面所有高度为0会原样显示背景图。一旦有波纹高度变化相邻点的高度差不为零就会产生纹理坐标偏移从而形成扭曲的视觉效果波峰和波谷处的扭曲方向相反非常符合直觉。3.3 能量注入如何制造涟漪一个静止的水面是无聊的。我们需要互动来产生波纹。在程序中通常通过鼠标点击或移动来“投石入水”。当用户在屏幕(mx, my)点击时我们就在高度场数组的对应位置“注入”能量。注意不能只在一个点注入那样产生的波纹会很不自然。通常是以点击点为中心在一个小圆形区域内增加一个脉冲void DropStone(int x, int y, int radius, int strength) { for (int j -radius; j radius; j) { for (int i -radius; i radius; i) { if (i*i j*j radius*radius) { // 圆形区域 int idx (yj) * width (xi); // 在 buf1 和 buf2 中都注入能量模拟一个初始的“凸起” buf1[idx] strength; buf2[idx] strength; } } } }此外让鼠标拖动时持续产生波纹可以模拟手指划过水面的效果。只需在鼠标移动事件中在旧位置和新位置之间连线上的一系列点调用DropStone函数即可。4. 性能优化与关键实现细节4.1 内存布局与计算优化在90年代末到21世纪初CPU速度和内存带宽远比今天紧张。因此这个算法的优化至关重要很多技巧在今天看来仍有启发意义。使用一维数组代替二维数组C/C中二维数组在内存中不是连续存储的或者通过双重指针访问会有额外开销。声明一个一维数组short *buf new short[width * height]然后通过buf[y * width x]来访问(x, y)点能获得更好的缓存局部性循环计算时速度显著提升。使用整数运算最初的算法使用整数short而非浮点数来计算高度。short16位的范围-32768~32767足够表示高度且整数加减和乘除尤其是除以2的幂次的速度远快于浮点运算。衰减因子damping也用一个0-256之间的整数表示乘法后用右移8位8来代替除法。循环展开与指针操作在内层循环中使用指针递增代替数组索引计算。甚至可以手动展开几次循环减少循环控制开销。例如short *pPrev buf2 (y*width) 1; short *pCurr buf1 (y*width) 1; for (int x 1; x width-1; x) { short sum (*(pPrev - width) *(pPrev width) *(pPrev - 1) *(pPrev 1)) 1; // 除以2 *pCurr (sum - *pCurr) * damping 8; pPrev; pCurr; }边界处理波纹传播到边界需要处理。简单的做法是设定边界点的高度恒为0固定边界这样波纹到达边界会被“吸收”或反射较弱。更逼真的做法是让边界点的高度等于其内侧相邻点的高度重复边界模拟波纹在边界处的反射但这需要额外的计算。4.2 DirectDraw高效绘图技巧计算出了扭曲后的图像数据如何快速绘制到DirectDraw表面上是另一个挑战。直接使用SetPixel函数是性能杀手绝对不可取。表面锁定与直接内存访问DirectDraw允许我们“锁定”一个表面获取指向其显存或系统内存的指针然后像操作普通内存数组一样直接写入像素数据。这是最快的方法。DDSURFACEDESC2 ddsd; ZeroMemory(ddsd, sizeof(ddsd)); ddsd.dwSize sizeof(ddsd); lpBackBuffer-Lock(NULL, ddsd, DDLOCK_WAIT | DDLOCK_WRITEONLY, NULL); // 锁定表面 BYTE *pSurface (BYTE*)ddsd.lpSurface; // 指向表面内存的指针 int pitch ddsd.lPitch; // 表面内存的行跨度字节数可能大于宽度*字节深度 // ... 使用指针和pitch写入像素数据 ... lpBackBuffer-Unlock(NULL); // 操作完成后必须解锁重要提示lPitch行跨度非常重要。由于内存对齐等原因表面一行像素所占的字节数可能略大于宽度 * 每像素字节数。写入数据时必须使用pSurface y * pitch x * bytesPerPixel来计算地址而不是假设内存是紧密打包的。颜色格式处理DirectDraw表面可能使用不同的像素格式16位RGB565、24位RGB、32位ARGB等。在锁定表面后你需要根据ddsd.ddpfPixelFormat成员来判断颜色格式并将你的RGB颜色值正确组装成对应的二进制格式写入内存。例如对于16位565格式WORD color16 ((r 3) 11) | ((g 2) 5) | (b 3); // 将24位RGB转换为16位565 *((WORD*)(pSurface y*pitch x*2)) color16; // 假设每像素2字节双缓冲与页面翻转在窗口模式下我们使用后缓冲绘图然后Blt到主表面。在全屏独占模式下可以创建带后缓冲的翻转链通过Flip操作来交换前后台表面效率更高且无撕裂。创建主表面时指定DDSCAPS_FLIP和DDSCAPS_COMPLEX并设置dwBackBufferCount然后使用CreateSurface创建带后缓冲的主表面最后通过lpPrimary-Flip(NULL, DDFLIP_WAIT)进行翻转。5. 常见问题与调试技巧实录即使理解了原理在实现过程中也一定会遇到各种问题。下面是我当年遇到的一些典型坑点及解决方法。5.1 编译与链接问题问题error LNK2001: 无法解析的外部符号 _DirectDrawCreateEx16。原因与解决这是最常见的链接错误说明项目没有正确链接ddraw.lib库。请严格按照2.1节中“配置VS项目”的步骤检查“附加依赖项”和“库目录”是否设置正确。确保平台工具集和库的位数匹配x86项目链接x86的lib。问题fatal error C1083: 无法打开包括文件: “ddraw.h”: No such file or directory。原因与解决包含目录路径错误或DirectX SDK未安装。检查包含目录路径确保路径中存在ddraw.h文件。注意Windows SDK新版VS自带中不包含DirectDraw的头文件必须安装老版的DirectX SDK。问题sal.h中的编译错误如“_In_宏重定义”。原因与解决这是老DirectX SDK头文件与新Windows SDK头文件不兼容。解决方案是在包含任何Windows头文件之前先定义WIN32_LEAN_AND_MEAN和VC_EXTRALEAN宏来减少冲突。最根本的解决方法是调整包含目录顺序确保老SDK路径在前或者使用网络上一些整理好的、兼容新编译器的独立DirectDraw头文件/库包。5.2 运行时与渲染问题问题程序运行后窗口一片黑或者画面不更新。排查步骤检查HRESULTDirectDraw几乎每个函数调用都返回HRESULT。务必检查每一个调用是否成功SUCCEEDED(hr)。可以使用FAILED(hr)宏判断失败时用GetLastError()或格式化HRESULT来获取详细信息。检查表面锁定确保在绘图前成功锁定了后缓冲表面Lock返回DD_OK并且在绘图后及时Unlock。忘记解锁会导致后续的Blt或Flip失败。检查Blt操作窗口模式下确保Blt的目标矩形是客户区有效区域。可以使用GetClientRect(hWnd, rcClient)获取客户区矩形。Blt的最后一个参数可以设置为DDBLT_WAIT它会等待位块传输完成。验证计算循环在计算水波纹高度场的循环后添加一个简单的测试比如将高度场直接可视化为灰度图高度值映射为亮度输出到后缓冲看看计算本身是否在工作。问题水波纹效果很弱几乎看不见或者扭曲方向很奇怪。原因与解决衰减因子过大damping值太接近256导致能量衰减过快。尝试将其设为240或更小。纹理偏移系数不当在纹理扭曲计算中(buf1[y][x1] - buf1[y][x-1]) / divisor这个divisor除数控制扭曲强度。除数太大偏移量太小效果不明显除数太小偏移量过大画面会撕裂成无意义的噪点。通常需要根据高度场的数值范围进行调试从32、64开始尝试。高度场数据范围溢出如果能量注入过大或计算迭代中数值不断增长可能导致short类型溢出变成无意义的负数或正数破坏模拟。在注入能量和每帧计算后可以加入简单的钳制Clamp操作将高度值限制在-MAX_AMPLITUDE到MAX_AMPLITUDE之间。问题程序运行一段时间后越来越卡。原因与解决内存泄漏确保所有创建的DirectDraw接口LPDIRECTDRAW7,LPDIRECTDRAWSURFACE7在程序退出前都正确调用Release()方法。可以使用_CrtDumpMemoryLeaks()需包含crtdbg.h并定义_CRTDBG_MAP_ALLOC在调试模式下检查内存泄漏。没有限制帧率主循环如果没有延时会以最高速运行占用大量CPU。可以在每帧计算和渲染结束后加入一个简单的帧率控制例如Sleep(1)或使用timeGetTime计算帧间隔确保每秒不超过60帧。算法复杂度如果渲染区域width * height很大双重循环的计算量是O(n²)。在当时的硬件下320x240或640x480是更现实的分辨率。可以考虑只计算和渲染一个较小的区域或者降低更新频率每两帧计算一次。5.3 调试工具与技巧使用调试输出在关键步骤如初始化成功、锁定表面成功、注入能量点使用OutputDebugString函数输出日志在Visual Studio的“输出”窗口中查看这对于追踪程序流程非常有用。简化问题当效果不正常时先屏蔽掉水波纹计算和纹理扭曲。尝试用最简单的代码在后缓冲上画一个纯色、一个渐变或者一个位图确保DirectDraw的基础绘图功能是正常的。检查数据在纹理扭曲计算中可以在循环内部打印出几个关键点的offsetX、offsetY值看看它们是否在预期的合理范围内比如-10到10之间。利用现代图形调试器虽然DirectDraw本身没有现代API那样的图形调试器但你可以在计算完成后将高度场数据或最终像素数据输出到一个文件或者用GDI函数在窗口另一个区域绘制出来进行可视化调试。实现这个水波纹效果的过程就像是在与一段历史对话。它没有炫酷的着色器没有复杂的物理引擎但却用最质朴的代码揭示了实时图形模拟的核心思想。当你看到自己编写的循环让静态的图片泛起阵阵涟漪那种成就感是独特的。希望这份详细的拆解不仅能帮你复现这个经典效果更能让你理解其背后每一行代码的意义。或许你可以尝试用现代C和SDL2库来重写它让这个经典算法在新的平台上焕发生机。
DirectDraw水波纹效果：从CPU模拟到纹理扭曲的经典图形编程实践
1. 项目概述重温经典图形编程的魅力最近在整理旧硬盘时翻出了一个十几年前用Visual C 6.0和DirectDraw写的“水波纹效果”演示程序。重新打开工程看着那熟悉的MFC界面和一行行略显“古老”的代码不禁感慨万千。在如今WebGL、Unity、Unreal Engine大行其道的时代DirectDraw早已是尘封在历史中的技术微软也早已停止对其支持。但正是这些“过时”的技术构成了我们这一代程序员图形编程的启蒙。这个项目不仅仅是一个实现水波纹特效的代码示例它更像是一个时间胶囊封装了那个年代在有限硬件资源下程序员们如何绞尽脑汁用CPU实时演算复杂视觉效果的热情与智慧。这个水波纹效果的核心原理是模拟一个二维水面网格的波动传播。你可以想象用一个石子投入平静的池塘涟漪会一圈圈扩散开来遇到边界还会反射。在程序中我们用两个二维数组通常称为“高度场”或“位移缓冲区”来记录水面每个“像素点”在上一帧和当前帧的“高度”或能量状态。通过一个简单的物理公式通常是相邻点的平均值减去当前点的某种衰减我们就能计算出下一帧每个点的状态从而实现波纹的扩散、衰减和叠加。最后再根据这个动态的“高度场”去扭曲一张背景纹理比如一幅风景图让背景图像看起来像是在水下波动从而产生逼真的水波倒影效果。整个过程完全由CPU计算不涉及任何硬件加速因此对算法效率的要求极高。虽然DirectDraw已退出历史舞台但学习这个项目依然有它的价值。对于想深入理解计算机图形学底层原理特别是实时模拟和渲染技术的新手来说这是一个绝佳的“麻雀虽小五脏俱全”的案例。它涵盖了双缓冲绘图、内存直接操作、物理模拟简化、纹理映射扭曲等核心概念。通过亲手实现它你能深刻理解“每一帧像素是如何被计算和绘制出来的”这种底层认知是使用现代高级图形API时不可或缺的。接下来我将带你一步步拆解这个经典实例从环境搭建到原理实现再到代码优化和问题排查分享那些当年踩过的坑和总结出的技巧。2. 环境准备与DirectDraw基础2.1 开发环境搭建拥抱经典或寻求兼容要复现这个项目你首先需要一个能编译DirectDraw程序的开发环境。最原汁原味的当然是Visual C 6.0配合古老的DirectX SDK如August 2007版或更早。VC6的工程文件.dsp, .dsw和编译器在今天看来已经非常陈旧在Windows 10/11上直接安装和运行可能会遇到各种兼容性问题比如安装失败、IDE闪退等。注意如果你坚持使用VC6建议在虚拟机如VMware或VirtualBox中安装一个Windows XP或Windows 7的镜像这是最稳定的方式。但考虑到便利性我更推荐下面的现代方案。对于大多数想学习原理而非考古的开发者我推荐使用Visual Studio 2019或2022的社区版。它们是免费的并且对C的支持非常完善。关键步骤在于让现代VS能够识别和链接DirectDraw库获取DirectX头文件和库你需要一个包含ddraw.h和ddraw.lib的DirectX SDK。微软最后的独立SDK是“DirectX SDK (June 2010)”。安装后记下安装路径例如C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)\。配置VS项目打开VS创建一个新的“空项目”或“Win32控制台应用程序”项目。右键项目 - 属性 -配置属性 - VC目录。在“包含目录”中添加DirectX SDK的Include文件夹路径。在“库目录”中添加DirectX SDK的Lib\x8632位程序或Lib\x6464位程序路径。由于DirectDraw是古老的32位技术通常编译为32位x86程序兼容性更好。链接库文件在项目属性 -链接器 - 输入 - 附加依赖项中添加ddraw.lib和dxguid.lib。dxguid.lib提供了DirectDraw接口的GUID定义必不可少。解决兼容性冲突新版本Windows SDK自Windows 8以后中的sal.h头文件可能与老DirectX SDK的某些定义冲突。一个常见的解决方法是在项目属性 -C/C - 高级中设置“禁用特定警告”为4996针对某些不安全的函数如sprintf并在包含ddraw.h之前在stdafx.h或源文件顶部添加宏定义#define DIRECTINPUT_VERSION 0x0800。有时甚至需要调整包含目录的顺序确保老SDK的路径在新Windows SDK路径之前。2.2 DirectDraw核心对象与初始化流程DirectDraw是DirectX中负责2D图形绘制的组件它允许程序直接操作显示内存实现高速的位图块传输Blitting。它的核心对象模型并不复杂LPDIRECTDRAW7 (DirectDraw对象)这是总入口代表显示硬件。通过DirectDrawCreateEx函数创建。LPDIRECTDRAWSURFACE7 (DirectDraw表面)这是绘图发生的地方。表面就是一块内存区域可以驻留在显存或系统内存中。我们至少需要两个表面主表面 (Primary Surface)对应显示器的可见区域一般是全屏模式下的整个屏幕或窗口模式下的客户区。它是离屏的直接翻转到前台显示。后缓冲表面 (Back Buffer Surface)我们在这一帧绘制的内容先放在这里绘制完成后通过“翻转Flip”或“位块传输Blt”操作交换到主表面从而实现双缓冲避免画面撕裂。LPDIRECTDRAWPALETTE (调色板)对于8位256色模式需要用它来管理颜色索引。我们的水波纹示例通常使用16位或24/32位高彩色模式所以可以忽略调色板。初始化DirectDraw的典型流程如下这段代码展示了如何为窗口模式创建一个带有后缓冲的DirectDraw对象// 1. 创建DirectDraw对象 LPDIRECTDRAW7 lpDD NULL; HRESULT hr DirectDrawCreateEx(NULL, (void**)lpDD, IID_IDirectDraw7, NULL); if (FAILED(hr)) { /* 错误处理 */ } // 2. 设置协作级别窗口模式 hr lpDD-SetCooperativeLevel(hWnd, DDSCL_NORMAL); // hWnd是窗口句柄 if (FAILED(hr)) { /* 错误处理 */ } // 3. 描述主表面窗口模式的主表面就是客户区 DDSURFACEDESC2 ddsd; ZeroMemory(ddsd, sizeof(ddsd)); ddsd.dwSize sizeof(ddsd); ddsd.dwFlags DDSD_CAPS; ddsd.ddsCaps.dwCaps DDSCAPS_PRIMARYSURFACE; // 4. 创建主表面 LPDIRECTDRAWSURFACE7 lpPrimary NULL; hr lpDD-CreateSurface(ddsd, lpPrimary, NULL); if (FAILED(hr)) { /* 错误处理 */ } // 5. 描述后缓冲表面 ZeroMemory(ddsd, sizeof(ddsd)); ddsd.dwSize sizeof(ddsd); ddsd.dwFlags DDSD_CAPS | DDSD_WIDTH | DDSD_HEIGHT; ddsd.ddsCaps.dwCaps DDSCAPS_OFFSCREENPLAIN; ddsd.dwWidth 640; // 你的后缓冲宽度 ddsd.dwHeight 480; // 你的后缓冲高度 // 6. 创建后缓冲表面 LPDIRECTDRAWSURFACE7 lpBackBuffer NULL; hr lpDD-CreateSurface(ddsd, lpBackBuffer, NULL); if (FAILED(hr)) { /* 错误处理 */ }实操心得在窗口模式下主表面的大小和位置由系统管理我们不能直接锁定Lock它进行像素级绘制。正确的做法是所有绘图操作都在后缓冲表面lpBackBuffer上完成然后使用lpPrimary-Blt或BltFast函数将后缓冲的内容拷贝到主表面的对应位置通常是客户区矩形。这是窗口模式DirectDraw编程的一个关键点新手常犯的错误就是试图直接画在主表面上。3. 水波纹效果的核心算法解析3.1 物理模型简化的波动方程水波纹的模拟本质上是对二维波动方程的数值求解。一个完整的水波物理模型非常复杂但在实时图形中我们采用一个极度简化但效果惊人的算法常被称为“水池算法”或“细胞自动机算法”。我们准备两个大小与屏幕或渲染区域相同的二维数组buf1和buf2它们交替扮演“当前帧高度场”和“上一帧高度场”的角色。数组中的每个元素代表水面某一点的垂直位移可以理解为波峰或波谷的高度。核心的扩散计算公式如下伪代码表示// 假设 buf1 是当前帧 buf2 是上一帧 for (int y 1; y height-1; y) { for (int x 1; x width-1; x) { // 计算周围四个点的平均值 short sum (buf2[y-1][x] buf2[y1][x] buf2[y][x-1] buf2[y][x1]) / 2; // 新的高度 平均值 - 当前高度 short newHeight sum - buf1[y][x]; // 应用阻尼衰减使波纹逐渐消失 newHeight newHeight * damping / 256; // damping是一个衰减因子如240 // 更新当前帧缓冲区 buf1[y][x] newHeight; } }计算完成后交换buf1和buf2的角色为下一帧计算做准备。这个公式的直观理解想象水面是一个由许多小弹簧连接起来的网格。某个点被按下能量注入后它会拉动周围的点周围的点又会拉动更远的点能量就这样传播开来。公式中的(sum / 2) - buf1[y][x]实现了能量的传递和惯性。衰减因子damping模拟了水的粘滞阻力使波动能量逐渐耗散。这个算法计算量小每个点只依赖其四个直接邻居非常适合用CPU实时计算。3.2 纹理扭曲将高度场转化为视觉画面有了动态的高度场buf1我们如何让它看起来像水波呢答案是纹理扭曲。我们有一张背景纹理比如一张蓝天白云的BMP图片我们希望根据水波的高度来偏移采样这张纹理的位置模拟光线在水面折射的效果。最简单的扭曲方法是使用位移映射。对于渲染目标后缓冲表面上的每个像素(x, y)查询该点在高度场buf1中对应的“高度”值h。同时也查询其相邻点(x1, y)和(x, y1)的高度值计算出该点高度的“梯度”或“导数”这代表了水面的倾斜程度。根据倾斜程度计算出一个纹理坐标的偏移量(dx, dy)。从背景纹理的(x dx, y dy)位置取样颜色绘制到后缓冲的(x, y)位置。一个常用的简化版本是直接使用当前点及其相邻点的高度差来作为偏移量int offsetX (buf1[y][x1] - buf1[y][x-1]) / 32; // 除以一个系数控制扭曲强度 int offsetY (buf1[y1][x] - buf1[y-1][x]) / 32; int texX (x offsetX) (texWidth - 1); // 使用位与()进行环绕如果纹理是2的幂次方 int texY (y offsetY) (texHeight - 1); COLORREF color GetPixelFromTexture(texX, texY); // 从背景纹理获取颜色 SetPixelOnBackBuffer(x, y, color); // 绘制到后缓冲通过这种方式平静的水面所有高度为0会原样显示背景图。一旦有波纹高度变化相邻点的高度差不为零就会产生纹理坐标偏移从而形成扭曲的视觉效果波峰和波谷处的扭曲方向相反非常符合直觉。3.3 能量注入如何制造涟漪一个静止的水面是无聊的。我们需要互动来产生波纹。在程序中通常通过鼠标点击或移动来“投石入水”。当用户在屏幕(mx, my)点击时我们就在高度场数组的对应位置“注入”能量。注意不能只在一个点注入那样产生的波纹会很不自然。通常是以点击点为中心在一个小圆形区域内增加一个脉冲void DropStone(int x, int y, int radius, int strength) { for (int j -radius; j radius; j) { for (int i -radius; i radius; i) { if (i*i j*j radius*radius) { // 圆形区域 int idx (yj) * width (xi); // 在 buf1 和 buf2 中都注入能量模拟一个初始的“凸起” buf1[idx] strength; buf2[idx] strength; } } } }此外让鼠标拖动时持续产生波纹可以模拟手指划过水面的效果。只需在鼠标移动事件中在旧位置和新位置之间连线上的一系列点调用DropStone函数即可。4. 性能优化与关键实现细节4.1 内存布局与计算优化在90年代末到21世纪初CPU速度和内存带宽远比今天紧张。因此这个算法的优化至关重要很多技巧在今天看来仍有启发意义。使用一维数组代替二维数组C/C中二维数组在内存中不是连续存储的或者通过双重指针访问会有额外开销。声明一个一维数组short *buf new short[width * height]然后通过buf[y * width x]来访问(x, y)点能获得更好的缓存局部性循环计算时速度显著提升。使用整数运算最初的算法使用整数short而非浮点数来计算高度。short16位的范围-32768~32767足够表示高度且整数加减和乘除尤其是除以2的幂次的速度远快于浮点运算。衰减因子damping也用一个0-256之间的整数表示乘法后用右移8位8来代替除法。循环展开与指针操作在内层循环中使用指针递增代替数组索引计算。甚至可以手动展开几次循环减少循环控制开销。例如short *pPrev buf2 (y*width) 1; short *pCurr buf1 (y*width) 1; for (int x 1; x width-1; x) { short sum (*(pPrev - width) *(pPrev width) *(pPrev - 1) *(pPrev 1)) 1; // 除以2 *pCurr (sum - *pCurr) * damping 8; pPrev; pCurr; }边界处理波纹传播到边界需要处理。简单的做法是设定边界点的高度恒为0固定边界这样波纹到达边界会被“吸收”或反射较弱。更逼真的做法是让边界点的高度等于其内侧相邻点的高度重复边界模拟波纹在边界处的反射但这需要额外的计算。4.2 DirectDraw高效绘图技巧计算出了扭曲后的图像数据如何快速绘制到DirectDraw表面上是另一个挑战。直接使用SetPixel函数是性能杀手绝对不可取。表面锁定与直接内存访问DirectDraw允许我们“锁定”一个表面获取指向其显存或系统内存的指针然后像操作普通内存数组一样直接写入像素数据。这是最快的方法。DDSURFACEDESC2 ddsd; ZeroMemory(ddsd, sizeof(ddsd)); ddsd.dwSize sizeof(ddsd); lpBackBuffer-Lock(NULL, ddsd, DDLOCK_WAIT | DDLOCK_WRITEONLY, NULL); // 锁定表面 BYTE *pSurface (BYTE*)ddsd.lpSurface; // 指向表面内存的指针 int pitch ddsd.lPitch; // 表面内存的行跨度字节数可能大于宽度*字节深度 // ... 使用指针和pitch写入像素数据 ... lpBackBuffer-Unlock(NULL); // 操作完成后必须解锁重要提示lPitch行跨度非常重要。由于内存对齐等原因表面一行像素所占的字节数可能略大于宽度 * 每像素字节数。写入数据时必须使用pSurface y * pitch x * bytesPerPixel来计算地址而不是假设内存是紧密打包的。颜色格式处理DirectDraw表面可能使用不同的像素格式16位RGB565、24位RGB、32位ARGB等。在锁定表面后你需要根据ddsd.ddpfPixelFormat成员来判断颜色格式并将你的RGB颜色值正确组装成对应的二进制格式写入内存。例如对于16位565格式WORD color16 ((r 3) 11) | ((g 2) 5) | (b 3); // 将24位RGB转换为16位565 *((WORD*)(pSurface y*pitch x*2)) color16; // 假设每像素2字节双缓冲与页面翻转在窗口模式下我们使用后缓冲绘图然后Blt到主表面。在全屏独占模式下可以创建带后缓冲的翻转链通过Flip操作来交换前后台表面效率更高且无撕裂。创建主表面时指定DDSCAPS_FLIP和DDSCAPS_COMPLEX并设置dwBackBufferCount然后使用CreateSurface创建带后缓冲的主表面最后通过lpPrimary-Flip(NULL, DDFLIP_WAIT)进行翻转。5. 常见问题与调试技巧实录即使理解了原理在实现过程中也一定会遇到各种问题。下面是我当年遇到的一些典型坑点及解决方法。5.1 编译与链接问题问题error LNK2001: 无法解析的外部符号 _DirectDrawCreateEx16。原因与解决这是最常见的链接错误说明项目没有正确链接ddraw.lib库。请严格按照2.1节中“配置VS项目”的步骤检查“附加依赖项”和“库目录”是否设置正确。确保平台工具集和库的位数匹配x86项目链接x86的lib。问题fatal error C1083: 无法打开包括文件: “ddraw.h”: No such file or directory。原因与解决包含目录路径错误或DirectX SDK未安装。检查包含目录路径确保路径中存在ddraw.h文件。注意Windows SDK新版VS自带中不包含DirectDraw的头文件必须安装老版的DirectX SDK。问题sal.h中的编译错误如“_In_宏重定义”。原因与解决这是老DirectX SDK头文件与新Windows SDK头文件不兼容。解决方案是在包含任何Windows头文件之前先定义WIN32_LEAN_AND_MEAN和VC_EXTRALEAN宏来减少冲突。最根本的解决方法是调整包含目录顺序确保老SDK路径在前或者使用网络上一些整理好的、兼容新编译器的独立DirectDraw头文件/库包。5.2 运行时与渲染问题问题程序运行后窗口一片黑或者画面不更新。排查步骤检查HRESULTDirectDraw几乎每个函数调用都返回HRESULT。务必检查每一个调用是否成功SUCCEEDED(hr)。可以使用FAILED(hr)宏判断失败时用GetLastError()或格式化HRESULT来获取详细信息。检查表面锁定确保在绘图前成功锁定了后缓冲表面Lock返回DD_OK并且在绘图后及时Unlock。忘记解锁会导致后续的Blt或Flip失败。检查Blt操作窗口模式下确保Blt的目标矩形是客户区有效区域。可以使用GetClientRect(hWnd, rcClient)获取客户区矩形。Blt的最后一个参数可以设置为DDBLT_WAIT它会等待位块传输完成。验证计算循环在计算水波纹高度场的循环后添加一个简单的测试比如将高度场直接可视化为灰度图高度值映射为亮度输出到后缓冲看看计算本身是否在工作。问题水波纹效果很弱几乎看不见或者扭曲方向很奇怪。原因与解决衰减因子过大damping值太接近256导致能量衰减过快。尝试将其设为240或更小。纹理偏移系数不当在纹理扭曲计算中(buf1[y][x1] - buf1[y][x-1]) / divisor这个divisor除数控制扭曲强度。除数太大偏移量太小效果不明显除数太小偏移量过大画面会撕裂成无意义的噪点。通常需要根据高度场的数值范围进行调试从32、64开始尝试。高度场数据范围溢出如果能量注入过大或计算迭代中数值不断增长可能导致short类型溢出变成无意义的负数或正数破坏模拟。在注入能量和每帧计算后可以加入简单的钳制Clamp操作将高度值限制在-MAX_AMPLITUDE到MAX_AMPLITUDE之间。问题程序运行一段时间后越来越卡。原因与解决内存泄漏确保所有创建的DirectDraw接口LPDIRECTDRAW7,LPDIRECTDRAWSURFACE7在程序退出前都正确调用Release()方法。可以使用_CrtDumpMemoryLeaks()需包含crtdbg.h并定义_CRTDBG_MAP_ALLOC在调试模式下检查内存泄漏。没有限制帧率主循环如果没有延时会以最高速运行占用大量CPU。可以在每帧计算和渲染结束后加入一个简单的帧率控制例如Sleep(1)或使用timeGetTime计算帧间隔确保每秒不超过60帧。算法复杂度如果渲染区域width * height很大双重循环的计算量是O(n²)。在当时的硬件下320x240或640x480是更现实的分辨率。可以考虑只计算和渲染一个较小的区域或者降低更新频率每两帧计算一次。5.3 调试工具与技巧使用调试输出在关键步骤如初始化成功、锁定表面成功、注入能量点使用OutputDebugString函数输出日志在Visual Studio的“输出”窗口中查看这对于追踪程序流程非常有用。简化问题当效果不正常时先屏蔽掉水波纹计算和纹理扭曲。尝试用最简单的代码在后缓冲上画一个纯色、一个渐变或者一个位图确保DirectDraw的基础绘图功能是正常的。检查数据在纹理扭曲计算中可以在循环内部打印出几个关键点的offsetX、offsetY值看看它们是否在预期的合理范围内比如-10到10之间。利用现代图形调试器虽然DirectDraw本身没有现代API那样的图形调试器但你可以在计算完成后将高度场数据或最终像素数据输出到一个文件或者用GDI函数在窗口另一个区域绘制出来进行可视化调试。实现这个水波纹效果的过程就像是在与一段历史对话。它没有炫酷的着色器没有复杂的物理引擎但却用最质朴的代码揭示了实时图形模拟的核心思想。当你看到自己编写的循环让静态的图片泛起阵阵涟漪那种成就感是独特的。希望这份详细的拆解不仅能帮你复现这个经典效果更能让你理解其背后每一行代码的意义。或许你可以尝试用现代C和SDL2库来重写它让这个经典算法在新的平台上焕发生机。
