DDraw 创建表面简单介绍
看到一篇关键DDraw 的文章，转载一下方便自己记录。正文如下。
创建表面
创建DDraw对象和设置协作级别请看《一个简单的DDraw应用程序》
设置模式
SetDisplayMode为设置视频模式的函数
HRESULT SetDisplayMode(DWORD dwWidth, // 屏幕宽 DWORD dwHeight, // 屏幕高 DWORD dwBPP, // 每个像素的位数, 8,16,24, 等. DWORD dwRefreshRate, // 刷新频率,0为默认 DWORD dwFlags); // 标记字，一般为 0 即可
| 视频模式 |
|||
| Width |
Height |
BPP |
Mode X |
| 320 |
200 |
8 |
* |
| 320 |
240 |
8 |
* |
| 320 |
400 |
8 |
* |
| 512 |
512 |
8,16,24,32 |
|
| 640 |
480 |
8,16,24,32 |
|
| 800 |
600 |
8,16,24,32 |
|
| 1024 |
768 |
8,16,24,32 |
|
| 1280 |
1024 |
8,16,24,32 |
|
设置模式源代码下载
色彩深度
现在用色彩深度多数为8、16、24、32
当选择8位的色彩深度的时候，我们需要一个调色板。
调色板数据结构
先了解调色板数据结构：
typedef struct tagPALETTEENTRY{ BYTE peRed; // red component 8-bits BYTE peGreen; // green component 8-bits BYTE peBlue; // blue component 8-bits BYTE peFlags; // 把这个标记设置为 PC_NOCOLLAPSE } PALETTEENTRY;
要创建一个调色板只要定义下面这样的数组。
PALETTEENTRY palette[256];
然后填充这个数组，注意的是把peFlags设置为PC_NOCOLLAPSE，因为我们不想Win32/DirectX优化我们的调色板。
PALETTEENTRY palette[ 256 ]; // 调色板 // 初始化调色板数组 for ( int color = 1 ; color < 255 ; color ++ ) { // 随机填充RGB值 palette[color].peRed = rand() % 256 ; palette[color].peGreen = rand() % 256 ; palette[color].peBlue = rand() % 256 ; palette[color].peFlags = PC_NOCOLLAPSE; // 不优化调色板 } // 把0项填充为黑色 palette[ 0 ].peRed = 0 ; palette[ 0 ].peGreen = 0 ; palette[ 0 ].peBlue = 0 ; palette[ 0 ].peFlags = PC_NOCOLLAPSE; // 把255项填充为白色 palette[ 255 ].peRed = 255 ; palette[ 255 ].peGreen = 255 ; palette[ 255 ].peBlue = 255 ; palette[ 255 ].peFlags = PC_NOCOLLAPSE;
创建调色板对象
| CreatePalette()控制标记 |
|
| 值 |
描述 |
| DDPCAPS_1BIT |
1位色彩。色彩表包含2项 |
| DDPCAPS_2BIT |
2位色彩。色彩表包含4项 |
| DDPCAPS_4BIT |
4位色彩。色彩表包含16项 |
| DDPCAPS_8BIT |
8位色彩。色彩表包含256项.最常用 |
| DDPCAPS_8BITENTRIES |
用于一个称为索引调色板的高级我改，适用于1、2和4位调色板，在此我们只要设置为否 |
| DDPCAPS_ALPHA |
表示想关的PALETTEENTRY结构peFlags成员将被翻译成一个控制透明的8位alpha值。用这个标记创建 的调色板只配置能到一个用DDSCAPS_TEXTURE性能标记创建的D3D纹理表面 |
| DDPCAPS_ALLOW256 |
表示这个调色板可以定义所有256个项。正常情况下，0项和255项分别相应地接收黑和白，并且在某些系统如NT上你在任何情况下都不能写这些项。然而，大多数情况下你不需要这个标记，因为为0项通常都是黑并且大多数调色板在255项为白的时候也能工作。 |
| DDPCAPS_INITIALIZE |
用lpDDColorArray传递的色彩数组中的色彩初始化调色板。使得调色板数据能被传递并下载到硬件调色板 |
| DDPCAPS_PRIMARYSURFACE |
这个调色板配置到主显示表面。改变调色板的色表会立即影响显示，除非DDPSETPAL_VSYNC是特定的值并受去拷的 |
| DDPCAPS_VSYNC |
强制调色板更新并只能在垂直的空白期执行。最小色彩异常和闪烁。不过还示获完全支持。 |
上面搞那么多控制标记，但一般是下面组合。
DDPCAPS_8BIT | DDPCAPS_ALLOW256 | DDPCAPS_INITIALIZE
如果不考虑设置色彩项0和255可以忽略DDPCAPS_ALLOW256
如果CreatePalette()调用中没有传递调色板，可以忽略DDPCAPS_INITIALIZE
创建显示表面
有两种显示表面：主显示表面 和 从显示表面
主显示表面：直接对应于被视频卡光栅化的实际显存，且任何时候都是可见的。在任何DDraw程序里我们只能有一个主显示表面，它直接指向图像并常驻VRAM。
从显示表面：它可以是任意大小，可以驻留在VRAM或是系统内存，可以有任意多个。
创建一个表面只要再个步骤：
1.填充一个DDSURFACEDESC2数据结构，来描述创建的显示表面。
2.调用IDirectDraw7::CreateSurface()来创建显示表面。
这个结构值成员比较多。我们只要了解粗体部分即可。
dwSize：本结构自身的大小。
dwFlags：指示DDraw会把有次数拨款哪个域中或从哪个域查询数据。见下表。
| DDSURFACEDESC2结构中dwFlags域的可选标志 |
|
| Value |
Description |
| DDSD_ALPHABITDEPTH |
表明dwAlphaBitDepth 成员有效. |
| DDSD_BACKBUFFERCOUNT |
表明dwBackBufferCount 成员有效. |
| DDSD_CAPS |
表明ddsCaps 成员有效. |
| DDSD_CKDESTBLT |
表明ddckCKDestBlt 成员有效. |
| DDSD_CKDESTOVERLAY |
表明ddckCKDestOverlay 成员有效. |
| DDSD_CKSRCBLT |
表明ddckCKSrcBlt 成员有效. |
| DDSD_CKSRCOVERLAY |
表明ddckCKSrcOverlay 成员有效. |
| DDSD_HEIGHT |
表明dwHeight 成员有效. |
| DDSD_LINEARSIZE |
表明dwLinearSize 成员有效. |
| DDSD_LPSURFACE |
表明lpSurface 成员有效. |
| DDSD_MIPMAPCOUNT |
表明dwMipMapCount 成员有效. |
| DDSD_PITCH |
表明lPitch 成员有效. |
| DDSD_PIXELFORMAT |
表明ddpfPixelFormat 成员有效. |
| DDSD_REFRESHRATE |
表明dwRefreshRate 成员有效. |
| DDSD_TEXTURESTAGE |
表明dwTextureStage 成员有效. |
| DDSD_WIDTH |
表明dwWidth 成员有效. |
dwHeight： 显示表面以像素计的宽度。
dwWidth：显示表面以像素计的高度。
lPitch：水平内存间距。它是该显式模式中每行上的字节数。注意：视VRAM的布局而定，lPitch可以是是任何值。因此当你倾向于逐行方总一个DDraw显示表面内存时，必须用lPitch来移到下一行，而不是用每像素字节数乘宽度。
dwBackBufferCount：后备缓冲或连锁于主显示表面的从属离屏切换缓冲的数目。
lpSurface：用于获取指向所创建的显示表面所驻留的实际内存的指针。
ddckCKDestBlt：目标色彩键。
ddckCKSrcBlt：源色彩键。
ddsCaps：返回所请求的显示表面的一些未在别处定义的属性。它也是一个结构体
| DDraw显示表面的功能控制设置 |
|
| 值 |
描述 |
| DDSCAPS_BACKBUFFER |
表示该显示表面的是一个平面翻转结构的后备缓冲 |
| DDSCAPS_COMPLEX |
表示正在描述一个复杂的显示表面，该表面拥有一个主表面缓冲和一或多个后备缓冲以生成翻转链 |
| DDSCAPS_FLIP |
表示该显示表面是一个平台翻转结构的一部分。当这个功能标记传递给CreateSurface方法时，将会创建 一个前端缓冲和一或多个后备缓冲 |
| DDSCAPS_LOCALVIDMEM |
表示该显示表面存在于真下的本地显存，而不是非本地显存中。如果指定该标记，DDSCAPS_VIDEOMEMORY也要指定。 |
| DDSCAPS_MODEX |
表示该显示表面是一个320*320或320*240ModelX显示平面 |
| DDSCAPS_NONLOCALVIDMEM |
表示该显示表面存在于非本地显存而非真正的本地显存中，如果批定了该标志DDSCAPS_VIDEOMEMORY不能要指定。 |
| DDSCAPS_OFFSCREENPLAIN |
表示该显示表面将一个离屏表面，不是一个特殊的表面，如覆盖、纹理、z-缓冲、前端缓冲、后端缓冲或是alpha缓冲平面。通常用于图元精灵（Sprite） |
| DDSCAPS_OWNDC |
表示该显示表面uqf会长期有一个设备上下文关联 |
| DDSCAPS_PRIMARYSURFACE |
表示该显示表面是主显示表面，代表其时用户可见的内容 |
| DDSCAPS_STANDARDVGAMODE |
表示该表面是一个标准的VGA平面，而且不是一个ModelX平面些标记不能与DDSCAPS_MODEX标记同时使用 |
| DDSCAPS_SYSTEMMEMORY |
表示该显示表面内存从系统内存分配 |
| DDSCAPS_VIDEOMEMORY |
表示该显示表面存在于显存中 |
关联调色板
加解锁
要访问任何显示表面—主显示表面、从显示表面等。必须 对内存加锁和解锁。没有任何保证 说VRAM会留在同样的地方。它可能是虚拟的，但对它上锁，它就会在锁住期间保持同样的地址空间以便控制。
| Lock（）方法的控制标记 |
|
| 值 |
描述 |
| DDLOCK_READONLY |
表示被锁的显示表面的是只读的 |
| DDLOCK_SURFACEMEMORYPTR |
表示将要返回一个指向特定RECT顶部的有效的内存指针，如果没有指定矩形，将会返回一个指向显示表面顶部的指针 |
| DDLOCK_WAIT |
如果由于正在进行一个块传输操作而不能获得一个锁，该 方法会重试直到得到锁或是有另外的错误发生，如DDERR_SURFACEBUSY |
| DDLOCK_WRITEONLY |
表示被锁的显示表面是可写的 |
使用IDirectDrawSurface7::Unlock()方法解锁
声明如下：
HRESULT Unlock(LPRECT lpRect); // lpRect为在lock函数中第一个参数的Rect
下面是完整例子
完整例子源代码下载
运行效果如下：
方煜宽 2011.05.21
转载请保留下面链接
http://www.cnblogs.com/fangyukuan/archive/2011/05/21/2052728.html