GAPI编程实践

最新推荐文章于 2024-09-24 17:47:05 发布

cnjet

最新推荐文章于 2024-09-24 17:47:05 发布

阅读量1.2k

点赞数

文章标签：编程 microsoft windows structure properties 游戏

GAPI编程实践

(发布时间2000年6月2日)

尽管在Pocket PC平台上，游戏开发人员不能使用DirectDraw 来开发游戏，但最近有一个好消息，就是 Microsoft 专门为Pocket PC新开发了一个名叫“GAPI”的游戏API （Game Application Interface）。它不仅可以直接访问显示内存，而且可以访问Pocket PC硬件按键。

您需要具备GAPI SDK、运行动态链接库（Runtime DLLs），以及位于EVTools 第二张光盘“PocketPCSDK/Program Files/Support/GameAPI”目录下的一个示例程序。

步骤1：创建一个示例程序“Hello World” GAPI 没有集成在Pocket PC SDK之中。所以要进行一些预备步骤：

手动地把“GX.H”包含文件复制到Pocket PC SDK的“Include”目录下。把依赖CPU类型“GX.LIB”文件复制到Pocket PC SDK的相应“Lib”目录下。最后，把依赖CPU类型的“GX.DLL” 文件复制到Pocket PC的“Windows”目录。

现在，您可以开始建立您的第一个简单的“Hello World” 程序了。启动eMbedded Visual C++，创建一个新的Pocket PC应用程序，然后把它命名为“FirstGX”。在向导创建了新工程后，让我们添加GAPI初始化调用。把下面的代码行添加到InitInstance 函数的末尾：

// Try opening the Display for Full screen access

if (GXOpenDisplay(hWnd, GX_FULLSCREEN) == 0) {

return FALSE; // we won't be able to draw.

}

// Initialize the Hardware Buttons

GXOpenInput();

// Get the Display properties

g_gxdp = GXGetDisplayProperties();

// Get information about the Hardware Keys and fills

// the g_gxkl structure

g_gxkl = GXGetDefaultKeys(GX_NORMALKEYS);

return TRUE;

这段代码使用了必须在FirstGX.cpp 源文件的全局空间里定义的两个变量。为避免编译错误，我们还必须我们的代码里包含进GX.H 文件：

直接在eMbedded Visual C++ 向导创建的包含文件中添加以下行：

#include "gx.h"

GXDisplayProperties g_gxdp; // GX struct

GXKeyList g_gxkl; // GX struct

我们应该在关闭应用程序之前将Game API 清理干净。在WinMain 函数的末尾插入下面两行代码：

GXCloseDisplay();

GXCloseInput();

步骤2：直接在显示内存中进行写操作

在我们开始编写代码之前，我们必须回忆一下。根据Pocket PC硬件的不同，您可能有16位的彩色显示器（Casio、HP、或Compaq）或者8位的显示器（黑白或彩色，例如Compaq Aero 1550）。为了断定您的Pocket PC 显示器是什么样的，您可以检查一下g_gxdp 结构的cBPP成员。它会告诉您您的显示器究竟是多少位的。

在直接访问16位显示的显示内存之前，您必须要知道显示控制器是如何来解释16位色彩掩码的。有两种可能的标志设置：KfDirect555 和 kfDirect565。555 把一个 XRRRRRGG.GGGBBBBB色彩掩码转换成Red-Green-Blue形式的短变量，而565 会把它转换成RRRRRXGG.GGGBBBBB的形式。