本篇是创建游戏内核(9)【OO改良版】的续篇,关于该内核的细节说明请参阅创建游戏内核(10)。
接口:
extern IDirect3D9* g_d3d;
extern IDirect3DDevice9* g_d3d_device;
//================================================================================
// functions for D3D display
//================================================================================
BOOL create_display(HWND hwnd, long width, long height, char bpp, BOOL is_window, BOOL use_zbuffer);
BOOL present_display();
BOOL set_texture(short sample, IDirect3DTexture9* texture);
BOOL set_perspective(float fov, float aspect, float near_z, float far_z);
BOOL clear_display_buffer(long color);
BOOL clear_display_zbuffer(float zbuffer);
BOOL clear_display(long color, float zbuffer);
UINT get_display_width();
UINT get_display_height();
UINT get_refresh_rate();
D3DFORMAT get_d3d_format();
BOOL get_display_format(D3DFORMAT* format);
BOOL get_backbuffer_format(D3DFORMAT* format);
BOOL get_display_mode_info(UINT mode_index, D3DDISPLAYMODE* display_mode, D3DFORMAT format);
char get_display_bpp(D3DFORMAT format);
void extract_rgb(D3DCOLOR color, uchar* red, uchar* green, uchar* blue);
BOOL is_window_mode();
BOOL support_hardware();
BOOL use_zbuffer();
BOOL display_format_support(D3DFORMAT format, BOOL is_window, BOOL support_hal);
BOOL set_ambient_light(uchar red, uchar green, uchar blue);
BOOL get_ambient_light(uchar* red, uchar* green, uchar* blue);
BOOL enalbe_alpha_blending(BOOL enable, DWORD source, DWORD dest);
BOOL enable_alpha_testing(BOOL enable);
实现:
IDirect3D9* g_d3d;
IDirect3DDevice9* g_d3d_device;
///////////////////////////////////// functions for D3D display /////////////////////////////////////
//----------------------------------------------------------------------------------------
// Get D3D present paramters.
//----------------------------------------------------------------------------------------
static BOOL _get_present_para(D3DPRESENT_PARAMETERS* present_para)
{
IDirect3DSwapChain9* _swap_chain;
if(FAILED(g_d3d_device->GetSwapChain(1, &_swap_chain)))
return FALSE;
_swap_chain->GetPresentParameters(present_para);
return TRUE;
}
//----------------------------------------------------------------------------------------
// Create Direct3D and Direct3DDevice object.
//----------------------------------------------------------------------------------------
BOOL create_display(HWND hwnd, long width, long height, char bpp, BOOL is_window, BOOL use_zbuffer)
{
if(hwnd == NULL)
return FALSE;
if((g_d3d = Direct3DCreate9(D3D_SDK_VERSION)) == NULL)
return FALSE;
// 1) get current display _format
D3DDISPLAYMODE _display_mode;
if(FAILED(g_d3d->GetAdapterDisplayMode(D3DADAPTER_DEFAULT, &_display_mode)))
return FALSE;
// 2) Configure width, height, bpp; resizing window.
RECT _client_rect;
int _display_width, _display_height;
// configure width
if(width == 0)
{
if(! is_window) // default to screen width if fullscreen
_display_width = _display_mode.Width;
else // otherwise grab from client size
{
GetClientRect(hwnd, &_client_rect);
_display_width = _client_rect.right;
}
}
else
_display_width = width;
// configure height
if(height == 0)
{
if(! is_window) // default to screen height if fullscreen
_display_height = _display_mode.Height;
else // Otherwise grab from client size
{
GetClientRect(hwnd, &_client_rect);
_display_height = _client_rect.bottom;
}
}
else
_display_height = height;
// configure bpp
if(bpp == 0 || is_window)
{
// get display bpp
if(! (bpp = get_display_bpp(_display_mode.Format)))
return FALSE;
}
// resize client window if using windowed mode
if(is_window)
resize_window(hwnd, _display_width, _display_height);
// 3) setup presentation parameters
D3DPRESENT_PARAMETERS _present_para;
// clear presentation structure
ZeroMemory(&_present_para, sizeof(D3DPRESENT_PARAMETERS));
// default to no hardware acceleraton detected
BOOL _support_hal = FALSE;
// setup windowed or fullscreen usage
if(is_window)
{
_present_para.Windowed = TRUE;
_present_para.SwapEffect = D3DSWAPEFFECT_DISCARD;
_present_para.BackBufferFormat = _display_mode.Format;
// see if video card supports hardware acceleration
if(! display_format_support(_display_mode.Format, TRUE, TRUE))
return FALSE;
_support_hal = TRUE;
}
else // fullscreen mode
{
D3DFORMAT _format, _alt_format;
_present_para.Windowed = FALSE;
_present_para.SwapEffect = D3DSWAPEFFECT_FLIP;
_present_para.BackBufferWidth = _display_width;
_present_para.BackBufferHeight = _display_height;
_present_para.FullScreen_RefreshRateInHz = D3DPRESENT_RATE_DEFAULT;
_present_para.PresentationInterval = D3DPRESENT_INTERVAL_ONE;
// figure display mode to use
if(bpp == 32)
{
_format = D3DFMT_X8R8G8B8;
_alt_format = D3DFMT_X8R8G8B8;
}
else if(bpp == 24)
{
_format = D3DFMT_R8G8B8;
_alt_format = D3DFMT_R8G8B8;
}
else if(bpp == 16)
{
_format = D3DFMT_R5G6B5;
_alt_format = D3DFMT_X1R5G5B5;
}
else if(bpp = 8)
{
_format = D3DFMT_P8;
_alt_format = D3DFMT_P8;
}
// check for hal device
if(display_format_support(_format, FALSE, TRUE))
_support_hal = TRUE;
else
{
// check for hal device in alternate _format
if(display_format_support(_alt_format, FALSE, TRUE))
{
_support_hal = TRUE;
_format = _alt_format;
}
else
{
// check for emulation device in alternate _format
if(! display_format_support(_alt_format, FALSE, FALSE))
return FALSE;
else
_format = _alt_format;
}
}
_present_para.BackBufferFormat = _format;
}
// setup zbuffer _format - 16bit
if(use_zbuffer)
{
_present_para.EnableAutoDepthStencil = TRUE;
_present_para.AutoDepthStencilFormat = D3DFMT_D16;
}
else
_present_para.EnableAutoDepthStencil = FALSE;
// create the Direct3D device object
if(FAILED(g_d3d->CreateDevice(D3DADAPTER_DEFAULT, _support_hal ? D3DDEVTYPE_HAL : D3DDEVTYPE_REF,
hwnd, D3DCREATE_SOFTWARE_VERTEXPROCESSING, &_present_para, &g_d3d_device)))
{
if(! use_zbuffer)
return FALSE;
// now, create Direct3D device no use zbuffer.
use_zbuffer = FALSE;
_present_para.EnableAutoDepthStencil = FALSE;
if(FAILED(g_d3d->CreateDevice(D3DADAPTER_DEFAULT, _support_hal ? D3DDEVTYPE_HAL : D3DDEVTYPE_REF,
hwnd, D3DCREATE_SOFTWARE_VERTEXPROCESSING, &_present_para, &g_d3d_device)))
{
return FALSE;
}
}
// 4) set rendering state
g_d3d_device->SetRenderState(D3DRS_LIGHTING, FALSE);
g_d3d_device->SetRenderState(D3DRS_ZENABLE, use_zbuffer ? D3DZB_TRUE : D3DZB_FALSE);
enalbe_alpha_blending(FALSE, 0, 0);
enable_alpha_testing(FALSE);
// enable texture rendering stages and filter types
g_d3d_device->SetTextureStageState(0, D3DTSS_COLORARG1, D3DTA_TEXTURE);
g_d3d_device->SetTextureStageState(0, D3DTSS_COLORARG2, D3DTA_DIFFUSE);
g_d3d_device->SetTextureStageState(0, D3DTSS_COLOROP, D3DTOP_MODULATE);
// set the sampler state value
g_d3d_device->SetSamplerState(0, D3DSAMP_MAGFILTER, D3DTEXF_LINEAR);
g_d3d_device->SetSamplerState(0, D3DSAMP_MINFILTER, D3DTEXF_LINEAR);
// 5) set color and transform matrix
// set default ambient color to white
set_ambient_light(255, 255, 255);
// calculate the _aspect ratio based on window size
float _aspect = (float) _display_height / _display_width;
set_perspective(D3DX_PI/4, _aspect, 1.0f, 10000.0f);
return TRUE;
}
//-------------------------------------------------------------------
// Presents the contents of the next buffer in the sequence of back
// buffers owned by the device.
//-------------------------------------------------------------------
BOOL present_display()
{
if(g_d3d_device == NULL)
return FALSE;
if(FAILED(g_d3d_device->Present(NULL, NULL, NULL, NULL)))
return FALSE;
return TRUE;
}
//-------------------------------------------------------------------
// set texture for Direct3D device.
//-------------------------------------------------------------------
BOOL set_texture(short sample, IDirect3DTexture9* texture)
{
// error checking
if(g_d3d_device == NULL || sample < 0 || sample > 7)
return FALSE;
if(FAILED(g_d3d_device->SetTexture(sample, texture)))
return FALSE;
return TRUE;
}
//-------------------------------------------------------------------
// set perspective projection transform matrix.
//-------------------------------------------------------------------
BOOL set_perspective(float fov, float aspect, float near_z, float far_z)
{
D3DXMATRIX _mat_proj;
if(g_d3d_device == NULL)
return FALSE;
// builds a left-handed perspective projection matrix based on a field of view
D3DXMatrixPerspectiveFovLH(&_mat_proj, fov, aspect, near_z, far_z);
// set projection matrix
if(FAILED(g_d3d_device->SetTransform(D3DTS_PROJECTION, &_mat_proj)))
return FALSE;
return TRUE;
}
//-------------------------------------------------------------------
// clear display buffer with specified color.
//-------------------------------------------------------------------
BOOL clear_display_buffer(long color)
{
if(g_d3d_device == NULL)
return FALSE;
if(FAILED(g_d3d_device->Clear(0, NULL, D3DCLEAR_TARGET, color, 1.0f, 0)))
return FALSE;
return TRUE;
}
//-------------------------------------------------------------------
// clear z-buffer.
//-------------------------------------------------------------------
BOOL clear_display_zbuffer(float zbuffer)
{
if(!g_d3d_device || !use_zbuffer())
return FALSE;
if(FAILED(g_d3d_device->Clear(0, NULL, D3DCLEAR_ZBUFFER, 0, zbuffer, 0)))
return FALSE;
return TRUE;
}
//-------------------------------------------------------------------
// clear screen, if using z-buffer, then clear z-buffer too.
//-------------------------------------------------------------------
BOOL clear_display(long color, float zbuffer)
{
if(g_d3d_device == NULL)
return FALSE;
// only clear screen if no zbuffer
if(! use_zbuffer())
return clear_display_buffer(color);
// clear display buffer and zbuffer
if(FAILED(g_d3d_device->Clear(0, NULL, D3DCLEAR_TARGET | D3DCLEAR_ZBUFFER, color, zbuffer, 0)))
return FALSE;
return TRUE;
}
//----------------------------------------------------------------------------------------
// Return width of adapter display.
//----------------------------------------------------------------------------------------
UINT get_display_width()
{
D3DDISPLAYMODE _display_mode;
g_d3d->GetAdapterDisplayMode(D3DADAPTER_DEFAULT, &_display_mode);
return _display_mode.Width;
}
//----------------------------------------------------------------------------------------
// Return height of adapter display.
//----------------------------------------------------------------------------------------
UINT get_display_height()
{
D3DDISPLAYMODE _display_mode;
g_d3d->GetAdapterDisplayMode(D3DADAPTER_DEFAULT, &_display_mode);
return _display_mode.Height;
}
//----------------------------------------------------------------------------------------
// Return refresh rate of adapter display.
//----------------------------------------------------------------------------------------
UINT get_refresh_rate()
{
D3DDISPLAYMODE _display_mode;
g_d3d->GetAdapterDisplayMode(D3DADAPTER_DEFAULT, &_display_mode);
return _display_mode.RefreshRate;
}
//----------------------------------------------------------------------------------------
// Return Direct3D format of adapter display.
//----------------------------------------------------------------------------------------
D3DFORMAT get_d3d_format()
{
D3DDISPLAYMODE _display_mode;
g_d3d->GetAdapterDisplayMode(D3DADAPTER_DEFAULT, &_display_mode);
return _display_mode.Format;
}
//----------------------------------------------------------------------------------------
// Get primary surface buffer format.
//----------------------------------------------------------------------------------------
BOOL get_display_format(D3DFORMAT* format)
{
// get primary buffer display mode
D3DDISPLAYMODE _display_mode;
if(FAILED(g_d3d_device->GetDisplayMode(1, &_display_mode)))
return FALSE;
*format = _display_mode.Format;
return TRUE;
}
//----------------------------------------------------------------------------------------
// Get back surface buffer
//----------------------------------------------------------------------------------------
BOOL get_backbuffer_format(D3DFORMAT* format)
{
D3DPRESENT_PARAMETERS _present_para;
if(! _get_present_para(&_present_para))
return FALSE;
*format = _present_para.BackBufferFormat;
return TRUE;
}
//-------------------------------------------------------------------
// Get display mode information.
//-------------------------------------------------------------------
BOOL get_display_mode_info(UINT mode_index, D3DDISPLAYMODE* display_mode, D3DFORMAT format)
{
if(g_d3d == NULL)
return FALSE;
// get the number of display modes avaible on this adapter
UINT _max_mode = g_d3d->GetAdapterModeCount(D3DADAPTER_DEFAULT, format);
if(mode_index >= _max_mode)
return FALSE;
// Queries the device to determine whether the specified adapter supports the requested format and display mode.
// This method could be used in a loop to enumerate all the available adapter modes.
if(FAILED(g_d3d->EnumAdapterModes(D3DADAPTER_DEFAULT, format, mode_index, display_mode)))
return FALSE;
return TRUE;
}
//----------------------------------------------------------------------------------------
// Get display mode BPP.
//----------------------------------------------------------------------------------------
char get_display_bpp(D3DFORMAT format)
{
switch(format)
{
// 32 bit modes
case D3DFMT_A8R8G8B8:
case D3DFMT_X8R8G8B8:
return 32;
// 24 bit modes
case D3DFMT_R8G8B8:
return 24;
// 16 bit modes
case D3DFMT_R5G6B5:
case D3DFMT_X1R5G5B5:
case D3DFMT_A1R5G5B5:
case D3DFMT_A4R4G4B4:
return 16;
// 8 bit modes
case D3DFMT_A8P8:
case D3DFMT_P8:
return 8;
}
return 0;
}
//----------------------------------------------------------------------------------------
// Extract red, green, blue from D3D color value.
//----------------------------------------------------------------------------------------
void extract_rgb(D3DCOLOR color, uchar* red, uchar* green, uchar* blue)
{
if(red != NULL) *red = uchar((color >> 16) & 0xff);
if(green != NULL) *green = uchar((color >> 8) & 0xff);
if(blue != NULL) *blue = uchar(color & 0xff);
}
//----------------------------------------------------------------------------------------
// Check whether D3D display mode is windowed or full-screen.
//----------------------------------------------------------------------------------------
BOOL is_window_mode()
{
D3DPRESENT_PARAMETERS _present_para;
if(! _get_present_para(&_present_para))
return FALSE;
return _present_para.Windowed;
}
//----------------------------------------------------------------------------------------
// Check whether D3D support hardware accelerator in current setting.
//----------------------------------------------------------------------------------------
BOOL support_hardware()
{
D3DFORMAT _display_format, _backbuffer_format;
get_display_format(&_display_format);
get_backbuffer_format(&_backbuffer_format);
if(FAILED(g_d3d->CheckDeviceType(D3DADAPTER_DEFAULT, D3DDEVTYPE_HAL,
_display_format, _backbuffer_format, is_window_mode())))
{
return FALSE;
}
return TRUE;
}
//----------------------------------------------------------------------------------------
// Check whether D3D device use zbuffer.
//----------------------------------------------------------------------------------------
BOOL use_zbuffer()
{
D3DPRESENT_PARAMETERS _present_para;
if(! _get_present_para(&_present_para))
return FALSE;
return _present_para.EnableAutoDepthStencil;
}
//-------------------------------------------------------------------
// Check whether specified display mode is supported on this adapter.
//-------------------------------------------------------------------
BOOL display_format_support(D3DFORMAT format, BOOL is_window, BOOL support_hal)
{
// verifies whether a hardware accelerated device type can be used on this adapter
if(FAILED(g_d3d->CheckDeviceType(D3DADAPTER_DEFAULT, support_hal ? D3DDEVTYPE_HAL : D3DDEVTYPE_REF,
format, format, is_window)))
{
return FALSE;
}
return TRUE;
}
//-------------------------------------------------------------------
// set ambient light color.
//-------------------------------------------------------------------
BOOL set_ambient_light(uchar red, uchar green, uchar blue)
{
if(g_d3d_device == NULL)
return FALSE;
D3DCOLOR _color = D3DCOLOR_XRGB(red, green, blue);
if(FAILED(g_d3d_device->SetRenderState(D3DRS_AMBIENT, _color)))
return FALSE;
return TRUE;
}
//-------------------------------------------------------------------
// Get ambient light color.
//-------------------------------------------------------------------
BOOL get_ambient_light(uchar* red, uchar* green, uchar* blue)
{
D3DCOLOR _color;
if(FAILED(g_d3d_device->GetRenderState(D3DRS_AMBIENT, &_color)))
return FALSE;
extract_rgb(_color, red, green, blue);
return TRUE;
}
//-------------------------------------------------------------------
// Enable or disable alpha blending.
//-------------------------------------------------------------------
BOOL enalbe_alpha_blending(BOOL enable, DWORD source, DWORD dest)
{
if(g_d3d_device == NULL)
return FALSE;
// enable or disable alpha blending
if(FAILED(g_d3d_device->SetRenderState(D3DRS_ALPHABLENDENABLE, enable)))
return FALSE;
// set blend type
if(enable)
{
g_d3d_device->SetRenderState(D3DRS_SRCBLEND, source);
g_d3d_device->SetRenderState(D3DRS_DESTBLEND, dest);
}
return TRUE;
}
//-------------------------------------------------------------------
// Enable or disable alpha testing.
//-------------------------------------------------------------------
BOOL enable_alpha_testing(BOOL enable)
{
if(g_d3d_device == NULL)
return FALSE;
if(FAILED(g_d3d_device->SetRenderState(D3DRS_ALPHATESTENABLE, enable)))
return FALSE;
// set alpha testing type
if(enable)
{
g_d3d_device->SetRenderState(D3DRS_ALPHAREF, 0x08);
g_d3d_device->SetRenderState(D3DRS_ALPHAFUNC, D3DCMP_GREATEREQUAL);
}
return TRUE;
}
测试代码:
/***********************************************************************************
PURPOSE:
Test D3D base display function.
***********************************************************************************/
#include "core_common.h"
#include "core_framework.h"
#include "core_graphics.h"
// The 2D vertex format and descriptor
typedef struct
{
float x, y, z; // 2D coordinates
float rhw; // rhw
float u, v; // texture coordinates
} VERTEX;
#define VERTEX_FVF (D3DFVF_XYZRHW | D3DFVF_TEX1)
//===========================================================================
// Defines class APP which public inherits from class FRAMEWORK.
//===========================================================================
class APP : public FRAMEWORK
{
public:
BOOL init()
{
// initialize vertex data
VERTEX _verts[] = {
{ 20.0f, 40.0f, 1.0f, 1.0f, 0.0f, 0.0f },
{ 620.0f, 40.0f, 1.0f, 1.0f, 1.0f, 0.0f },
{ 20.0f, 440.0f, 1.0f, 1.0f, 0.0f, 1.0f },
{ 620.0f, 440.0f, 1.0f, 1.0f, 1.0f, 1.0f }
};
// Create Direct3D and Direct3DDevice object
if(! create_display(g_hwnd, get_window_width(g_hwnd), get_window_height(g_hwnd), 16, TRUE, FALSE))
return FALSE;
BYTE* _vertex_ptr;
// create the vertex buffer and set data
g_d3d_device->CreateVertexBuffer(sizeof(VERTEX) * 4, 0, VERTEX_FVF, D3DPOOL_DEFAULT, &m_vertex_buffer, NULL);
// locks a range of vertex data and obtains a pointer to the vertex buffer memory
m_vertex_buffer->Lock(0, 0, (void**)&_vertex_ptr, 0);
memcpy(_vertex_ptr, _verts, sizeof(_verts));
// unlocks vertex data
m_vertex_buffer->Unlock();
if(! m_texture.load("test.jpg", 0, D3DFMT_UNKNOWN))
return FALSE;
return TRUE;
}
BOOL frame()
{
clear_display_buffer(D3DCOLOR_RGBA(0, 0, 0, 255));
if(SUCCEEDED(g_d3d_device->BeginScene()))
{
// set the vertex stream, shader, and texture.
// binds a vertex buffer to a device data stream
g_d3d_device->SetStreamSource(0, m_vertex_buffer, 0, sizeof(VERTEX));
// set the current vertex stream declation
g_d3d_device->SetFVF(VERTEX_FVF);
// assigns a texture to a stage for a device
set_texture(0, m_texture.get_texture());
// renders a sequence of noindexed, geometric primitives of the specified type from the current set
// of data input stream.
g_d3d_device->DrawPrimitive(D3DPT_TRIANGLESTRIP, 0, 2);
// release texture
set_texture(0, NULL);
g_d3d_device->EndScene();
}
present_display();
return TRUE;
}
BOOL shutdown()
{
release_com(m_vertex_buffer);
release_com(g_d3d_device);
release_com(g_d3d);
return TRUE;
}
private:
TEXTURE m_texture;
LPDIRECT3DVERTEXBUFFER9 m_vertex_buffer;
};
int PASCAL WinMain(HINSTANCE inst, HINSTANCE, LPSTR cmd_line, int cmd_show)
{
APP app;
if(! build_window(inst, "MainClass", "MainWindow", WS_OVERLAPPEDWINDOW, 0, 0, 640, 480))
return -1;
app.run();
return 0;
}