1、Visual C#编写 3D 游戏框架示例在本文中，我假定你的所有开发工作都将使用 Visual Studio .NET 2003 来完成1 2 下一页你可能对实际地编写游戏代码期待已久了。由于 DirectX SDK 2004 年夏季更新包含了一个牢固的示例框架组件，并且它被设计成能在你自己的代码中直接使用，同时还为你处理了很多事务，所以你只要简单的使用它，就可以节省大量的时间和精力。本文中的例子使用的就是这个示例框架组件，在本文中，你将学习到的内容有： 如何建立自己的项目 如何使用示例框架组件来列举设备 建立项目在本文中，我假定你的所有开发工作都将使用 Visual Studio .NET
2、 2003 来完成。如果你不希望使用这个环境，可以使用命令行编译代码，它允许你使用任意的文本编辑器或集成开发环境（IDE）。启动 Visual Studio .NET 2003 并点击起始页面中的“新建项目“ 按钮。如果你没有使用起始页面，可以点击“文件“ 菜单下的 “新建“子菜单中的“ 项目“菜单项，或者使用 Ctrl+Shift+N。选择“Visual C#项目“区域中的“Windows 项目“数据项。把这个项目命名为 Blockers，这是游戏的名称。在你查看自动生成的代码之前，首先把示例框架组件添加到你的项目中。一般情况下，我会在“解决方案浏览器“ 中建立一个新文件夹，并把这些文件放入
3、一个这个独立的文件夹中（把这个文件夹的名字取为 Framework）。右键点击这个新建的文件夹，从“添加“ 菜单中选择“添加已有的项“。导航到 DirectX SDK 文件夹，你会发现该示例框架文件位于SamplesManagedCommon 文件夹中，选择每个文件并添加到你的项目中。在示例框架组件被添加到项目中以后，你就可以去掉自动生成的代码了。这些代码中的大部分都是用于建立别致的 Windows 窗体应用程序的，因此，它与我们编写游戏的代码是无关的。用列表 1 中的代码替换已有的代码和类（Form1）。列表 1：空的框架组件using System;using System.Configu
4、ration;using Microsoft.DirectX;using Microsoft.DirectX.Direct3D;using Microsoft.Samples.DirectX.UtilityToolkit;public class GameEngine : IDeviceCreation/程序入口。初始化所有部分并进入一个消息处理循环。用空闲时间显示场景static int Main() using(Framework sampleFramework = new Framework()return sampleFramework.ExitCode;这段新代码中有三个地方比较突出
5、。首先，你可能注意到了除了静态的 main 方法之外，删除了所有东西，而且 main 方法也被修改过。剩余的代码是 Windows 窗体设计器的支撑代码。由于这个应用程序不需要使用该设计器，因此这些代码就没有用了，可以被删除。其次，这段代码不能编译，因为游戏引擎希望实现的两个接口还未实现。再次，这段代码实际上没有做任何事务。在你开始解决后面两个问题之前，你必须添加一些引用。由于你准备在这个项目中显示奇特的 3D 图像，你就必须给项目添加能执行这样的显示操作的组件的引用。本文采用受控 DirectX来执行这种操作，因此你需要在“项目“ 菜单中选择“添加引用“。图 1 显示了弹出的对话框。图 1：
6、添加引用对话框如果你安装了 DirectX 9 SDK 2004 年夏季更新，你会发现有多个版本的受控 DirectX 组件可供使用。请选择最新的版本（1.0.2902.0 版本）。对于这个项目来说，你需要添加三个不同的组件引用： Microsoft.DirectX Microsoft.DirectX.Direct3D Microsoft.DirectX.Direct3DXDirectX 根（root）组件包含了辅助显示计算的数学结构。其它两个组件相应地包含了Direct3D 和 D3DX 的功能。添加这些引用之后，你可以简单地查看一下列表 1 中添加的 using语句，以确保名字空间被正确地
7、引用了。这个步骤可以确保你不需要完整地限定类型。例如，如果不添加 using 语句，那么声明一个 Direct3D 设备变量，就必须使用下面的语句：Microsoft.DirectX.Direct3D.Device device = null;Using 语句可以减少很多输入内容（没有人希望在声明一个变量时输入全部的内容）。由于你已经增加了 using 语句，就可以使用如下所示的声明语句了：private Device device = null;你可以看到，用这种方式声明变量简单多了，节省了大量的输入。在了解这些信息之后，你可以开始修补应用程序编译过程中的错误了，并准备好编写第一个 3D 游
8、戏了。你现在必须实现的唯一一个接口是 IDeviceCreation，它控制着设备的列举和建立。你可能会想“列举设备做什么？我只有一个监视器 “！尽管一般情况下是这样的，但是现在的显卡实际上是支持多个监视器的，即使你只有一个设备，你仍然拥有多个可选择的模式。显示器的格式可能不同（你可以在 Windows 桌面设置中看到这些种类，例如 16 位色和 32 位色）。全屏幕模式下的高度和宽度也可能有不同的值，你甚至于还可以控制屏幕的刷新率。总而言之，还是有些事情需要解决。列表 2 中的代码修补的应用程序中的编译错误。列表 2：实现接口/ 设备初始化的时候调用。这段代码检查设备最小的性能，/ 如果没有
9、通过检查，就返回 falsepublic bool IsDeviceAcceptable(Caps caps, Format adapterFormat,Format backBufferFormat, bool windowed)if (!Manager.CheckDeviceFormat(caps.AdapterOrdinal, caps.DeviceType, adapterFormat, Usage.QueryPostPixelShaderBlending, ResourceType.Textures, backBufferFormat)return false;if (caps.Ma
10、xActiveLights = 0)return false;return true;/ 在建立某个设备之前，这个回调函数会被立即调用，以允许应用程序修改设备的 / 设置信息。它提供的设置参数包含了框架组件为新设备挑选的设置， 并且应用程序/ 可以直接对这个结构进行任何需要的修改。请注意，示例框架没有纠正无效的/ 设备设置信息，因此必须小心地返回有效的设备设置，否则建立设备就会失败。 public void ModifyDeviceSettings(DeviceSettings settings, Caps caps)/ 这个应用程序没有使用任何 get 方法，它被设计成在一个纯设备上工作。/
11、 因此如果受到支持并且使用 HWVP，就建立一个纯设备。if ( (caps.DeviceCaps.SupportsPureDevice) 请你查看一下声明的 IsDeviceAcceptable 方法。在示例框架忙着枚举系统中的设备的时候，它会在每个找到的组合上调用该方法。注意到该方法返回一个布尔型值吗？这使得你有权利告诉示例框架你认为某个设备是否符合需求。但是，在你仔细查看第一个方法中的代码的时候，请先看一下声明的第二个方法（ModifyDeviceSettings ）。某个设备被建立之前，示例框架会立即调用这个方法，允许你加入任何希望的选项。但是你要小心地使用参数选项，因为它可能导致设备
12、建立失败。现在我们回到第一个方法：我们先看一下它的参数。首先，它带有一个 Caps 类型的参数，它是设备性能的简单结构体。该结构体包含了具体设备的巨量信息，可以帮助你决定某个类型是不是你正在使用的设备类型。其后的两个参数都是特定设备的格式参数：一个是后台的缓冲区格式，另一个是设备的格式。请注意后台缓冲区是实际要显示的数据（象素）在发送给显卡处理并输出到屏幕之前所存储的地方。后台缓冲区的格式决定了可以显示多少种色彩。大多数格式遵循特定的命名习惯-每个字符跟着一个数字，例如 A8R8G8B8。字符所指定的构成部分拥有与其后面的数字相同数量的位（bit）。在A8R8G8B8 中，该格式可以包含 32
13、 位色彩信息，alpha 、red、green 和 blue 各用 8 位。最常见的构成是：A AlphaR RedG GreenB BlueX Unused你可以查看 DirectX SDK 文档得到更多关于格式的信息。由于我们还需要知道该设备时候可以显示在窗体中，所以这个方法还有一个参数（最后一个）。尽管大多数游戏都运行在全屏模式下，但是编写和调试在全屏模式下运行的游戏却很困难。在调试过程中，这个应用程序在窗体模式而不是全屏模式下显示。 请注意窗体模式是我们运行的大多数应用程序的显示方式。其中大多数应用程序带有边框和控制菜单，右上角带有最小化、最大化和关闭按钮。在全屏模式下，应用程序覆盖了
14、整个屏幕，并且在大多数情况下没有边框。如果全屏模式使用了另外的屏幕大小（你当前使用的桌面），你可以改变桌面的分辨率。你可能注意到了默认行为是接受该设备，但是在接受之前进行了两项检查。第一项检查确保了传递进来的设备可以进行 alpha 混合（游戏的用户界面需要这个），如果它不能够实现，就返回 false 表明这个设备不能被接受。接着，它检查是否支持活动光源（ active light）的能力。没有光源的屏幕看起来是平面的、是假的，因此一般至少需要一个光源。还有一些代码在设备建立之前的确修改了该设备，你可能想知道这段代码的作用。能够执行处理过程的设备需要用多种方法来显示顶点，要么在硬件中计算或软件
15、中计算，或者两者都使用。如果处理过程完全在硬件中进行，这就是另外一种模式，就叫做“纯硬件设备“ ，它潜在地提供了更高的性能。这段代码检查你当前是否要建立一个硬件处理设备，如果你正准备这样做，并且该纯设备是可以使用的，那么它就切换到这种模式中。你不能建立纯设备（如果该设备是可用的）的唯一情形是你计划调用该设备上的某个 get 方法或属性。由于在这个例子中你不需要这样操作，所以你可以自由地使用能力更加强大的设备。示例框架中有一些不安全（unsafe）的代码，因此你需要更新自己的项目并处理这些问题。见图 2。图 2：允许不安全的代码列举所有设备选项现在你可以让框架组件开始列举系统中的设备了。首先，为
16、游戏引擎类声明一个构造函数，并把 main 中建立的示例框架实例作为参数传递进去。如列表 3 所示。列表 3：添加构造函数private Framework sampleFramework = null; / 示例的框架组件/ 建立该类的一个新的实例public GameEngine(Framework f) / 存储框架组件sampleFramework = f; 该构造函数除了存储示例框架实例之外没有做其它的任何操作，这是因为这个实例是游戏中其它的一切东西几乎都需要使用的。在你调用示例框架之后，它所做的第一件事情是试图列举系统中的所有设备。在你的项目文件中，你在 Framework 文件夹
17、中可以看到 dxmutenum.cs 文件。这个文件包含了列举系统中所有设备所需要的全部代码。由于理解如何列举和为什么列举设备是非常重要的，所以请你打开这个文件。你首先应该注意到 Enumeration 类自身是不能被创建的，并且每个可用的成员和方法都是用 static（静态的）关键字声明的。由于在正常情况下（最少是现在）应用程序在运行的时候，你的图形硬件是不会改变的，因此这些列举代码只需要在应用程序开头运行一次。列举工作是从 Enumerate 方法开始的，该方法在设备建立之前被示例框架调用。请注意，这个方法的唯一参数是你自己在游戏引擎类中所实现的接口。这个接口被保存下来，因为随后，随着设备
18、组合的列举，会调用 IsDeviceAcceptable 方法来决定某个设备是否应该添加到有效设备列表中。那么设备到底是怎样列举出来的呢？这些功能都位于受控 DirectX 的 Manager 类中。如果你非常熟悉非受控的 DirectX 应用程序编程接口（API ），那么我告诉你，这个类映射了 IDirect3D9 组件对象模型（COM）接口。请留意列表 4 中的Enumerate 方法中的第一个循环。列表 4：列举设备/ 查找系统中的每个适配器for each(AdapterInformation ai in Manager.Adapters)EnumAdapterInformation
19、adapterInfo = new EnumAdapterInformation();/ 存储一些信息adapterInfo.AdapterOrdinal = (uint)ai.Adapter; / 序号adapterInfo.AdapterInformation = ai.Information; / 信息/ 获取这个适配器上的所有显示模式 / 建立一个所有显示适配器格式的临时列表adapterFormatList.Clear();/ 现在检测支持哪种格式for(int i = 0; i maximumWidth) |(dm.Height maximumHeight) |(dm.Refres
20、hRate maximumRefresh) )continue; / 这种格式是无效的/ 添加到列表中adapterInfo.displayModeList.Add(dm);/ 如果先前并不存在就把它添加到格式列表中if (!adapterFormatList.Contains(dm.Format)adapterFormatList.Add(dm.Format);/ 获取适配器显示模式DisplayMode currentAdapterMode = ai.CurrentDisplayMode;/ 检查这种格式是否在列表中if (!adapterFormatList.Contains(curre
21、ntAdapterMode.Format)adapterFormatList.Add(currentAdapterMode.Format);/ 对显示模式列表进行排序adapterInfo.displayModeList.Sort(sorter);/ 获取这个适配器上每个设备的信息EnumerateDevices(adapterInfo, adapterFormatList);/ 如果适配器上至少有一个设备，并且它是兼容的，就把它添加到列表中if (adapterInfo.deviceInfoList.Count 0)adapterInformationList.Add(adapterInfo
22、);Manager 类的 Adapters（适配器）属性是一个包含了系统中所有 “适配器“信息的集合。“ 适配器“这个术语可能有点不恰当，但是它的基本定义是指任何监视器可以连接到的东西。例如，假设你有一块 ATI Radeon 9800 XT 显卡。虽然只有一块显卡，但是可能把两个不同的监视器连接到它上面（通过视频图形适配器VGA端口和后面的数字视觉接口DVI 端口）。当用这两种监视器的时候，这块显卡就有两个适配器，因此是两种设备。请注意这是一种通过把设备创建为适配器组的方式在“不同的“ 设备之间共享资源的方法。这种方法受到了少许限制。你可以查阅DirectX 文档了解更多的信息。这个循环至少
23、会迭代一次，这依赖于你的系统。在把当前活动的适配器的基本信息存储起来以后，代码必须找到在全屏模式下这个适配器可以支持的所有显示模式。你可能发现了受到支持的模式都可以直接从当前正在列举的适配器信息中直接列举出来，代码也是这样做的。列举某个适配器模式的时候，第一步是检查最小和最大的范围集合。大多数设备支持很多模式，但是其中很多我们现在不会使用了。很多年前，你可能见过在 320x200 全屏窗口中运行游戏，但是现在不会发生这种情况（除非你正好在玩手持式游戏，例如 Gameboy Advance）。示例框架选择的最小的大小为 640x480 窗体，没有设置最大的尺寸。请注意示例框架选择的最小尺寸为 6
24、40x480 并不意味着在全屏模式下它就会选择最小的尺寸。在全屏模式下，示例框架选择最好的可用尺寸，它一般是当前桌面的大小（通常不是 640x480 的）。在符合框架组件需求的受到支持的模式被添加到列表中后，当前的显示模式就会被添加进来，因为这个模式肯定受到支持。最后，通过实现 IComparer 接口，这些模式会被排序。见列表 5。列表 5：对显示模式进行排序public class DisplayModeSorter : IComparer/ 比较两种显示模式public int Compare(object x, object y)DisplayMode d1 = (DisplayMod
25、e)x;DisplayMode d2 = (DisplayMode)y;if (d1.Width d2.Width)return +1;if (d1.Width d2.Height)return +1;if (d1.Height d2.Format)return +1;if (d1.Format d2.RefreshRate)return +1;if (d1.RefreshRate 0)/ 有，把它添加到列表中adapterInfo.deviceInfoList.Add(deviceInfo);/ 打开异常处理开关DirectXException.EnableExceptions();查看这段
26、代码的时候，你必须注意两个非常重要的信息。你能猜到是哪两个吗？如果你猜的是对 DirectXException 类的调用那就对了。第一个调用关闭了受控 DirectX 部件内部任何异常的产生。你可能会怀疑这样做的优点，实际上这样做是出于性能的考虑。捕捉和抛出异常是很昂贵的操作，而这段代码可能产生大量的异常。你可能希望尽快地执行列举过程，因此过程中产生的任何异常都被简单地忽略了，在这个 函数执行完之后，就恢复正常的异常处理过程。这段代码看起来相当简洁，你可能会问“这段代码为什么倾向于产生异常呢“ ？我有一个很好的答案：大多数情形是某种设备不支持 DirectX 9。也许你没有升级显卡驱动程序或当
27、前的显卡驱动程序所需要的必要代码路径不正确；也可能是由于显卡本身太老了，没有能力支持 DirectX 9；有时候一些人通过包含不支持 DirectX 9的 PCI 显卡激活了系统中的多监视器模式。这个方法中的代码试图得到这个适配器的性能信息并列举出不同的组合方式，并且它试图获取每个可用的设备的这些信息。可能的设备类型包括： 硬件（Hardware）-建立的最常见的设备类型。呈现过程由硬件（显卡）来完成。 引用（Reference）-这种设备不管硬件是否能够执行处理过程，可以呈现 Direct3D 运行时支持的任何设置。所有的处理过程在软件中进行，这意味着在游戏中这种设备类型很慢。 软件（Sof
28、tware）- 除非你编写了光栅化程序（rasterizer），否则永远不会使用这个选项。假设在列举过程中找到了某些设备组合，就把它存储到列表中。列举类存储了少量的列表，示例框架在以后可以使用它们。列表 7 是 EnumerateDeviceCombos 方法。列表 7：列举设备组合private static void EnumerateDeviceCombos(EnumAdapterInformation adapterInfo, EnumDeviceInformation deviceInfo, ArrayList adapterFormatList)/ 查找这种设备支持哪种适配器格式f
29、or each(Format adapterFormat in adapterFormatList)for(int i = 0; i backbufferFormatsArray.Length; i+)bool windowed = false;doif (!windowed) if (!Manager.CheckDeviceType(int)adapterInfo.AdapterOrdinal, deviceInfo.DeviceType, adapterFormat, backbufferFormatsArrayi, windowed)continue; / 不支持的/ 我们需要加速象素阴
30、影混合吗？if (isPostPixelShaderBlendingRequired)if (!Manager.CheckDeviceFormat(int)adapterInfo.AdapterOrdinal, deviceInfo.DeviceType, adapterFormat, Usage.QueryPostPixelShaderBlending, ResourceType.Textures, backbufferFormatsArrayi)continue; / 不支持的/ 如果提供了某个应用程序回调函数，就要确保这个设备受到该应用程序的支持if (deviceCreationInt
31、erface != null)if (!deviceCreationInterface.IsDeviceAcceptable(deviceInfo.Caps, adapterFormat, backbufferFormatsArrayi,windowed)continue; / 应用程序不喜欢这个设备EnumDeviceSettingsCombo deviceCombo = new EnumDeviceSettingsCombo();/ 存储信息deviceCombo.AdapterOrdinal = adapterInfo.AdapterOrdinal;deviceCombo.DeviceT
32、ype = deviceInfo.DeviceType;deviceCombo.AdapterFormat = adapterFormat;deviceCombo.BackBufferFormat = backbufferFormatsArrayi;deviceCombo.IsWindowed = windowed;BuildDepthStencilFormatList(deviceCombo);BuildMultiSampleTypeList(deviceCombo);if (deviceCombo.multiSampleTypeList.Count = 0)continue;BuildCo
33、nflictList(deviceCombo);BuildPresentIntervalList(deviceInfo, deviceCombo);deviceCombo.adapterInformation = adapterInfo;deviceCombo.deviceInformation = deviceInfo;/ 把组合添加到设备列表中deviceInfo.deviceSettingsList.Add(deviceCombo);windowed = !windowed;while (windowed);总结在本文中，你开始建立了第一个游戏项目，并且看到了示例框架的一些内容。你看到了大量的列举系统中可能支持的设备组合的代码。这个示例框架是你在未来编写游戏的一个重要的出发点。
