C++ OpenGL 3D Game Tutorial 2: Making OpenGL 3D Engine学习笔记

视频地址https://www.youtube.com/watch?v=PH5kH8h82L8&list=PLv8DnRaQOs5-MR-zbP1QUdq5FL0FWqVzg&index=3

一、main类

接上一篇内容，main.cpp的内容增加了一些代码，显得严谨一些：

#include<OGL3D/Game/OGame.h>
#include<iostream>

int main()
{
	try {
		OGame game;
		game.Run();
	}
	catch (const std::exception& e)
	{
		std::cout << e.what() << std::endl;
		return 1;
	}

	return 0;
}

二、OGame类

然后是Game类的添加了很多内容：

Game.h文件：

#pragma once
#include<memory>

class OGraphicsEngine;
class OWindow;
class OGame
{
public:
	OGame();
	~OGame();

	virtual void onCreate();
	virtual void onUpdate();
	virtual void onQuit();

	void Run();
protected:
	bool m_isRunning = true;
	std::unique_ptr<OGraphicsEngine> m_graphicsEngine;
	std::unique_ptr<OWindow> m_display;
};

Game.cpp文件：

#include<OGL3D/Graphics/OGraphicsEngine.h>
#include<OGL3D/Window/OWindow.h>
#include<OGL3D/Game/OGame.h>
#include<Windows.h>

OGame::OGame()
{
	m_graphicsEngine = std::make_unique<OGraphicsEngine>();
	m_display = std::make_unique<OWindow>();

	m_display->makeCurrentContext();
}

OGame::~OGame()
{
}

void OGame::onCreate()
{
	m_graphicsEngine->clear(OVec4(1,0,0,1));

	m_display->present(false);
}

void OGame::onUpdate()
{
}

void OGame::onQuit()
{
}

void OGame::Run()
{
	onCreate();

	MSG msg;
	while (m_isRunning)
	{
		msg = {};
		if (PeekMessage(&msg, NULL, NULL, NULL, PM_REMOVE))
		{
			if (msg.message == WM_QUIT)
			{
				m_isRunning = false;
				continue;
			}
			else 
			{
				TranslateMessage(&msg);
				DispatchMessage(&msg);
			}
		}

		onUpdate();
	}

	onQuit();
}

和上一篇相比，在构造函数里面创建了OGraphicEngine对象，同时执行了OWindow对象m_display的方法makeCurrentContext，这个方法也是OWindow类在本次视频里面后加的。需要注意的是，这两行代码的顺序不能错：

m_graphicsEngine = std::make_unique<OGraphicsEngine>();
m_display = std::make_unique<OWindow>();

因为OWindow构造期间需要获取的HDC里面的内容，而这个HDC内容要在OGraphicsEngine构造期间设置，所以必定要先构造OGraphicsEngine对象，顺序颠倒了肯定不行。

同时OGame类里面还添加onCreate、onUpdate、onQuit方法，注意一下这三个方法的调用时机就好了。

三、OWindow类

Owindow.h文件

#pragma once

#include<Windows.h>
class OWindow
{
public:
		OWindow();
		~OWindow();

		void makeCurrentContext();
		void present(bool vsync);
private:
	HWND m_handle = nullptr;
	HGLRC m_context = nullptr;
};

OWindow.cpp文件

#include<OGL3D/Window/OWindow.h>
#include<glad/glad.h>
#include<glad/glad_wgl.h>
#include <Windows.h>
#include<assert.h>

LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)
{
	switch (msg)
	{
	case WM_DESTROY:
	{
		OWindow* window = (OWindow*)GetWindowLongPtr(hwnd, GWLP_USERDATA);
		break;
	}
	case WM_CLOSE:
	{
		PostQuitMessage(0);
		break;
	}
	default:
		return DefWindowProc(hwnd, msg, wParam, lParam);
	}
	return NULL;
}

OWindow::OWindow()
{
	WNDCLASSEX wc = {};
	wc.cbSize = sizeof(WNDCLASSEX);
	wc.lpszClassName = L"OGL3DWindow";
	wc.lpfnWndProc = WndProc;

	auto classId = RegisterClassEx(&wc);
	assert(classId);

	RECT rc = { 0,0,1024,768 };
	AdjustWindowRect(&rc, WS_OVERLAPPED | WS_CAPTION | WS_SYSMENU, false);

	m_handle = CreateWindowEx(NULL,
		MAKEINTATOM(classId),
		L"Parcode | OpenGL 3D Game",
		WS_OVERLAPPEDWINDOW,
		CW_USEDEFAULT,
		CW_USEDEFAULT,
		rc.right - rc.left, rc.bottom - rc.top,
		NULL, NULL, NULL, NULL);

	assert(m_handle);

	SetWindowLongPtr(m_handle, GWLP_USERDATA, (LONG_PTR)this);

	ShowWindow(m_handle, SW_SHOW);
	UpdateWindow(m_handle);

	HDC hDC = GetDC(m_handle);

	int pixelFormatAttributes[] = {
		WGL_DRAW_TO_WINDOW_ARB,GL_TRUE,
		WGL_SUPPORT_OPENGL_ARB,GL_TRUE,
		WGL_DOUBLE_BUFFER_ARB,GL_TRUE,
		WGL_ACCELERATION_ARB,WGL_FULL_ACCELERATION_ARB,
		WGL_PIXEL_TYPE_ARB,WGL_TYPE_RGBA_ARB,
		WGL_COLOR_BITS_ARB,24,
		WGL_DEPTH_BITS_ARB,24,
		WGL_STENCIL_BITS_ARB,8,
		0
	};

	int iPixelFormat = 0;
	UINT numFormats = 0;
	wglChoosePixelFormatARB(hDC, pixelFormatAttributes, nullptr, 1, &iPixelFormat, &numFormats);
	assert(numFormats);

	PIXELFORMATDESCRIPTOR pixelFormatDesc = {};
	DescribePixelFormat(hDC, iPixelFormat, sizeof(PIXELFORMATDESCRIPTOR), &pixelFormatDesc);
	SetPixelFormat(hDC, iPixelFormat, &pixelFormatDesc);

	int openAttributes[] = {
	WGL_CONTEXT_MAJOR_VERSION_ARB,4,
	WGL_CONTEXT_MINOR_VERSION_ARB,6,
	WGL_CONTEXT_PROFILE_MASK_ARB,WGL_CONTEXT_CORE_PROFILE_BIT_ARB,
	0
	};

	m_context = wglCreateContextAttribsARB(hDC, 0, openAttributes);
	assert(m_context);
}

OWindow::~OWindow()
{
	wglDeleteContext(m_context);
	DestroyWindow(m_handle);
}

void OWindow::makeCurrentContext()
{
	wglMakeCurrent(GetDC(m_handle), m_context);
}

void OWindow::present(bool vsync)
{
	wglSwapIntervalEXT(vsync);
	wglSwapLayerBuffers(GetDC(m_handle), WGL_SWAP_MAIN_PLANE);
}

创建窗口

        这里需要解释一些创建窗口的问题，其实在上一篇文件里就应该解释，但是当时理解的也不到位，这里算是补充一下。
        WNDCLASSEX创建一个名称为wc的结构体实例，这个实例相当于我们事先写一份要创建窗口的类型申请表，RegisterClass这个函数就是把wc这个申请表提交(注册)给Window系统，然后当需要创建窗口时，Window系统就会按这个申请表来创建。
        RegisterClass的形参是指向WNDCLASSEX结构体的指针，这个指针会加入到system atom table即SAT中，这样系统就可以通过查找这张表来找到用户自定义的窗口类，window预定义的窗口类指针也在SAT中。

SAT实际上实现了一种用于查询的映射，ATOM（翻译过来叫“原子”）实际类型是short，即16整数。ATOM表（原子表）是一个系统定义的用于存放字符串和相应的标识符的表。程序把一个字符串放入ATOM表，获得一个相应的16位整数，这个整数就叫原子，可以用来访问该字符串。一个被放进原子表的字符串叫做原子名称。

只有系统才可直接访问这张表，但在调用某些api函数时，如Registerclass，可以告知系统来存取这张表。当然，还有本地原子表和全局原子表，这些表应用程序是可以直接访问的。

MAKEINTATOM 宏 (位于winbase.h)将指定的原子转换为对应的字符串地址，以便可以将其传递给接受原子或字符串的函数。调用CreateWindowEx就用到了这个宏。

获取绘制上下文

后面补充的代码是从

HDC hDC = GetDC(m_handle);

这行代码开始，一直到

assert(m_context);

这行代码结束，其核心的目的是获取绘制上下文，就是 m_context 。而获取上下文的代码时使用的代码是：

m_context = wglCreateContextAttribsARB(hDC, 0, openAttributes);

总体来说对我是个晕头转向的过程，不过大概就是先要获取形参，第一个是hDC，也是唯一需要说明一下的，这个内容有点儿多，查了老半天也是很糊涂的，先能明白多少算多少。

HDC——Handle of the Device Context，中文意思是“设备上下文句柄”，这个东西会在后面多次用到。HDC是一种包含有关某个设备（如显示器或打印机）的绘制属性信息的 Windows 数据结构。所有绘制调用都通过设备上下文对象进行，这些对象封装了用于绘制线条、形状和文本的 Windows API。

虽然说GetDC函数很容易就获取了这个hDC，但是对其像素格式进行设置。就是下面的代码：

SetPixelFormat(hDC, iPixelFormat, &pixelFormatDesc);

这个过程设计好几个函数，基本没看明白，估计照着写就行。

就说一个wglChoosePixelFormatARB函数吧，它能够找到合适的像素格式。

Windows下要通过程序设置多重采样，必须使用wglChoosePixelFormatARB这个函数。正确使用这个函数的关键，就是需要创建一个临时窗体，通过这个窗体，我们可以获取必须的基础像素格式，然后再使用wglChoosePixelFormatARB这个函数，得到可用的多重采样像素格式，最后，对渲染窗口设置这个像素格式即可。

四、OGraphicsEngine类

新增加了OGraphicsEngine类，先贴出代码：

OGraphicsEngine.h文件：

#pragma once
#include<OGL3D/Math/OVec4.h>

class OGraphicsEngine
{
public:
	OGraphicsEngine();
	~OGraphicsEngine();
public:
	void clear(const OVec4& color);
};

OGraphicsEngine.cpp文件：

#include<OGL3D/Graphics/OGraphicsEngine.h>
#include<glad/glad.h>
#include<glad/glad_wgl.h>
#include<assert.h>
#include<stdexcept>

OGraphicsEngine::OGraphicsEngine()
{
	WNDCLASSEX wc = {};
	wc.cbSize = sizeof(WNDCLASSEX);
	wc.lpszClassName = L"OGL3DDummyWindow";
	wc.lpfnWndProc = DefWindowProc;
	wc.style = CS_OWNDC;

	auto classId = RegisterClassEx(&wc);
	assert(classId);

	auto dummyWindow = CreateWindowEx(NULL, MAKEINTATOM(classId), L"", WS_OVERLAPPED | WS_CAPTION | WS_SYSMENU, CW_USEDEFAULT, CW_USEDEFAULT,
		CW_USEDEFAULT, CW_USEDEFAULT, NULL, NULL, NULL, NULL);

	assert(dummyWindow);

	HDC dummyDC = GetDC(dummyWindow);

	PIXELFORMATDESCRIPTOR pixelFormatDesc = {};
	pixelFormatDesc.nSize = sizeof(PIXELFORMATDESCRIPTOR);
	pixelFormatDesc.nVersion = 1;
	pixelFormatDesc.iPixelType = PFD_TYPE_RGBA;
	pixelFormatDesc.dwFlags = PFD_DRAW_TO_WINDOW | PFD_SUPPORT_OPENGL | PFD_DOUBLEBUFFER;
	pixelFormatDesc.cColorBits = 32;
	pixelFormatDesc.cAlphaBits = 8;
	pixelFormatDesc.cDepthBits = 24;
	pixelFormatDesc.cStencilBits = 8;
	pixelFormatDesc.iLayerType = PFD_MAIN_PLANE;

	auto iPixelFormat = ChoosePixelFormat(dummyDC, &pixelFormatDesc);
	SetPixelFormat(dummyDC, iPixelFormat, &pixelFormatDesc);

	auto dummyContext = wglCreateContext(dummyDC);
	assert(dummyContext);

	wglMakeCurrent(dummyDC, dummyContext);

	if (!gladLoadWGL(dummyDC))throw std::runtime_error("OGraphic Engine Error:gladLoadWGL failed.");
	if (!gladLoadGL())throw std::runtime_error("OGraphic Engine Error:gladLoadGL failed.");

	wglMakeCurrent(dummyDC, 0);
	wglDeleteContext(dummyContext);
	ReleaseDC(dummyWindow, dummyDC);
	DestroyWindow(dummyWindow);
}

OGraphicsEngine::~OGraphicsEngine()
{
}

void OGraphicsEngine::clear(const OVec4& color)
{
	glClearColor(color.x,color.y,color.z,color.w);
	glClear(GL_COLOR_BUFFER_BIT);
}

choosePixelFormat从HDC中选择最匹配的内容，返回一个索引（iPixelFormat，开头的i应该就是index）。

SetPixelformat函数将指定设备上下文（HDC）的像素格式设置为索引（iPixelFormat）指定的格式。

这一通操作意思就是你开始定义的PIXELFORMATDESCRIPTOR只是你自己一厢情愿的想法，设备（显示器或者打印机）有可能支持（这当然最好），也有可能不支持，一旦不支持，就给你找个最接近你要求的参数凑合用用。

wglCreateContext（为什么是wgl开头呢？应该是来源于Wingdi.h文件的GL函数，wingdi应该就是Window Graphic Deviec Interface）函数创建一个呈现上下文，该上下文适用于在 hdc 引用的设备上绘图。

其返回值是HGLRC类型（the Handle of GL Rendering Context，GL渲染上下文句柄）

wglMakeCurrent就是指示后续在hdc上的绘制工作都是基于dummyContext的。

绕了一大圈都是为了这两句：

	if (!gladLoadWGL(dummyDC))throw std::runtime_error("OGraphic Engine Error:gladLoadWGL failed.");
	if (!gladLoadGL())throw std::runtime_error("OGraphic Engine Error:gladLoadGL failed.");

先说一下，通过throw抛出异常会终止线程。

这两句也都是对hDC状态进行设置。

五、补充

补充两个文件，一个是OVec4.h文件，另一个是OPerequisites.h文件。

OVec4.h文件：

#pragma once
#include<OGL3D/OPerequisites.h>

class OVec4
{
public:
	OVec4() {}
	OVec4(f32 x, f32 y, f32 z, f32 w) :x(x), y(y), z(z), w(w) {}
	~OVec4() {}

public:
	f32 x = 0, y = 0, z = 0, w = 0;
};

OPerequisites.h文件：

#pragma once

typedef float f32;

六、后记

说实话，Window编程真的很绕，很晦涩（其实本来想说很**，但我要保持优雅的底线），也许这就是垄断的结果吧。其实以前开发苹果App的时候，感觉苹果对开发者就很不友好（对玩家用户倒是友好得很！），禁不住回想在Unity环境下用C#编程，似乎真的很美好（Long Live Unity！）。不过话说回来，开发游戏引擎的通常比使用引擎做游戏的工资更高，算是对被这种代码折磨的补偿吧 :D