强行在MFC窗体中渲染Cocos2d-x 3.6
GuyaWeiren2015-06-29 15:14:063696 次阅读
【前言】
把Cocos2d-x渲染到另一个应用程序框架中的方法,在2.x时代有很多大神已经实现了,而3.x的做法网上几乎找不着。这两天抽空强行折腾了一下,不敢独享,贴出来供大家参考。
【已知存在的问题】
程序退出时会发生非常严重的内存泄漏,博主检查了很久,但技术不够暂时无法解决。如果有大神能搞定,求告知一下做法,谢谢!
在程序从开始运行到关闭期间,有且仅有一个Cocos2d-x窗体存在时可以选择性无视内存泄漏。如果非常在意这一点,建议使用Cocos2d-x 2.2.6这个版本,放在MFC中的内存泄漏很小。
*使用VLD检查泄漏会报错
【为什么要这么做】
在进行游戏开发途中,多多少少会用到一些辅助工具,比如Cocos Studio。但是在更多的时候,Cocos Studio并不能以不变应万变(比如在博文《我用Cocos2d-x制作〈Love Live!学院偶像祭〉的Live场景》中提到的谱面编辑器的功能,Cocos Studio无法做到)。在这种情况下,开发人员就需要一款针对当前项目而设计的工具。
如果辅助工具需要提供丰富的界面和控件,纯用Cocos2d-x来制作就会十分鸡肋。比如这个打开文件的控件:
当然,一定要做的话用Cocos2d-x也是可以做的,但是相当麻烦。如果有兴趣可以自己尝试写一下,提高自己的姿势水平。
所以这个时候应当把Cocos2d-x层放在一个提供了各种控件的应用程序框架里面,Cocos2d-x仅用于做显示,其余的数据操作交由框架完成。
目前博主比较熟悉的框架是MFC和C# Winform。说实话C# Winform做窗体比MFC方便快捷太多。但是如果使用C# Winform就得去做C#调用C++,同时对于某些特定参数(比如string到const char*的转换)必须做特殊处理,比较麻烦,否则DLL堆栈会出错。而MFC不存在这个问题。
【核心思想】
Cocos2d-x在Windows上运行起来是一个窗口,那么在其内部一定调用了CreateWindowEx这个API。那么只要我们找到这个API,把参数设为子窗口,并把父窗口的句柄传进去,就可以达到要求。创建出来的窗体就是父窗体中的子窗体了。
还要注意一点是Cocos2d-x原生程序有一个自己的消息循环,如果直接调用Application::run会导致MFC层卡死,我们需要把消息循环交给框架的主线程来操作。
流程图如下:
【需要的工具】
1、 安装了MFC组件的Visual Studio 2013
2、 Cocos2d-x 3.6
3、 GLFW (下载地址:点我)
4、 CMake(下载地址:点我)
【操作步骤】
1、创建项目
创建一个MFC项目(我使用的对话框型)。注意在向导中“MFC的使用”这一项要选择“在共享DLL中使用MFC”:
2、拷贝必要文件
把Cocos2d-xx的源码和模板项目中的Classes和Resources文件夹拷贝到项目目录下(项目模板位于引擎目录\templates\cpp-template-default下),一定要使用这个结构:
3、修改项目属性
打开MFC项目解决方案,在属性管理器(视图——属性管理器)中为项目添加Cocos2d-x的两个属性表。属性表位于解决方案目录\cocos2d\cocos\2d:
然后将libcocos2d,libbox2d,libspine加入解决方案中,并把libcocos2d设为MFC项目的依赖项:
再在MFC项目的附加包含目录中加入:
1
2
3
4
5
6
7
8
9
|
$(EngineRoot)cocos\audio\include
$(EngineRoot)external
$(EngineRoot)external\chipmunk\include\chipmunk
$(EngineRoot)extensions
..\Classes
..
%(AdditionalIncludeDirectories)
$(_COCOS_HEADER_WIN32_BEGIN)
$(_COCOS_HEADER_WIN32_END)
|
预处理器定义中加入:
附加库目录中加入:
1
2
|
$(_COCOS_LIB_PATH_WIN32_BEGIN)
$(_COCOS_LIB_PATH_WIN32_END)
|
附加依赖项加入:
1
2
3
|
$(_COCOS_LIB_WIN32_BEGIN)
$(_COCOS_LIB_WIN32_END)
libcocos2d.lib
|
再修改项目属性——工作目录,以及生成目录:
再将Classes下的所有文件加入MFC项目:
最后设置不使用预编译头,不然每加入一个类都得加上#include “stdafx.h”,麻烦:
4、修改GLFW
Cocos2d-x 2.x中创建窗口在CCEGLView类中完成,直接修改它就行。到3.x后使用glfw管理窗口,CreateWindowEx被封装进去了。而Cocos2d-x并没有附带glfw的源码,只有头文件和lib文件。所以我们需要下载glfw的源码进行修改。
用CMakeGUI打开GLFW,source code处选择下下来的glfw解压的文件夹,build the binaries选择生成解决方案的文件夹,然后生成对应VS版本的解决方案(glfw解压的文件夹不要删除):
然后打开生成的sln,查找CreateWindowEx,修改它所在的函数(win32_window.c,633行):
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
|
static int createWindow(_GLFWwindow* window,
const _GLFWwndconfig* wndconfig,
const _GLFWctxconfig* ctxconfig,
const _GLFWfbconfig* fbconfig,
HWND parent) // 父窗体句柄
{
int xpos, ypos, fullWidth, fullHeight;
WCHAR * wideTitle;
window->win32.dwStyle = WS_CHILDWINDOW | WS_VISIBLE; // 子窗体样式
window->win32.dwExStyle = WS_EX_APPWINDOW | WS_EX_WINDOWEDGE;
xpos = 0;
ypos = 0;
fullWidth = wndconfig->width;
fullHeight = wndconfig->height;
wideTitle = _glfwCreateWideStringFromUTF8(wndconfig->title);
if (!wideTitle)
{
_glfwInputError(GLFW_PLATFORM_ERROR,
"Win32: Failed to convert window title to UTF-16" );
return GL_FALSE;
}
window->win32.handle = CreateWindowExW(window->win32.dwExStyle,
_GLFW_WNDCLASSNAME,
wideTitle,
window->win32.dwStyle,
xpos, ypos,
fullWidth, fullHeight,
parent, // 传入父窗体句柄
NULL, // No window menu
GetModuleHandleW(NULL),
window); // Pass object to WM_CREATE
//
// ...
}
|
然后从内向外依次修改调用它的地方:
win32_window.c,769行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
int _glfwPlatformCreateWindow(_GLFWwindow* window,
const _GLFWwndconfig* wndconfig,
const _GLFWctxconfig* ctxconfig,
const _GLFWfbconfig* fbconfig,
HWND parent)
{
// ...
//
if (!createWindow(window, wndconfig, ctxconfig, fbconfig, parent))
return GL_FALSE;
// ...
//
if (!createWindow(window, wndconfig, ctxconfig, fbconfig, parent))
return GL_FALSE;
//
// ...
}
|
internal.h,524行
1
2
3
4
5
|
int _glfwPlatformCreateWindow(_GLFWwindow* window,
const _GLFWwndconfig* wndconfig,
const _GLFWctxconfig* ctxconfig,
const _GLFWfbconfig* fbconfig,
HWND parent);
|
window.c,116行
1
2
3
4
5
6
7
8
9
10
11
12
|
GLFWAPI GLFWwindow* glfwCreateWindow( int width, int height,
const char * title,
GLFWmonitor* monitor,
GLFWwindow* share,
int parent)
{
// ...
//
if (!_glfwPlatformCreateWindow(window, &wndconfig, &ctxconfig, &fbconfig, ( HWND )parent))
//
// ...
}
|
glfw3.h,1645行:
1
|
GLFWAPI GLFWwindow* glfwCreateWindow( int width, int height, const char * title, GLFWmonitor* monitor, GLFWwindow* share, int parent);
|
改好后使用MinSizeRel选项进行编译,编译好后在GLFW解决方案目录\src\MinSizeRel下找到glfw3.lib文件,连同glfw3.h(在glfw解压目录\include\GLFW)一起,分别放入MFC项目解决方案目录\cocos2d\external\glfw3\prebuilt\win32 和 MFC项目解决方案目录\cocos2d\external\glfw3\include\win32下覆盖原文件。
5、修改Cocos层
在GLViewImpl类(3.2中是GLView类)的头文件中加入一个方法和成员:
1
2
3
4
5
|
public :
static void SetParent( HWND parent){ m_sParent = parent; }
private :
static HWND m_sParent;
|
别忘了在cpp中加入
1
|
HWND GLViewImpl::m_sParent = NULL;
|
然后修改GLViewImpl::initWithRect方法,修改调用glfwCreateWindow的地方:
1
2
3
4
5
6
7
8
9
10
11
12
13
|
bool GLViewImpl::initWithRect( const std::string& viewName, Rect rect, float frameZoomFactor)
{
// ...
//
_mainWindow = glfwCreateWindow(rect.size.width * _frameZoomFactor,
rect.size.height * _frameZoomFactor,
_viewName.c_str(),
_monitor,
nullptr,
( int )m_sParent); // 传入父窗口句柄
//
// ...
}
|
修改Application类的run方法,去掉里面的消息循环:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
int Application::run()
{
PVRFrameEnableControlWindow( false );
initGLContextAttrs();
// Initialize instance and cocos2d.
if (!applicationDidFinishLaunching())
{
return 1;
}
// Retain glview to avoid glview being released in the while loop
Director::getInstance()->getOpenGLView()->retain();
return 0;
}
|
6、编辑MFC窗体
接下来在MFC窗体中添加一个Picture Control控件,控件ID设为IDC_RENDERWND,然后选中控件(非常蛋疼的是只能在控件边框处点击才能选中)点右键——“添加变量”:
7、添加渲染类
在解决方案资源管理器中的MFC项目上点右键——“添加”——“类…”,添加一个MFC类:
然后修改类:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
#pragma once
// CRenderWnd
class CRenderWnd : public CWnd
{
DECLARE_DYNAMIC(CRenderWnd)
public :
CRenderWnd();
virtual ~CRenderWnd();
protected :
DECLARE_MESSAGE_MAP()
public :
afx_msg void OnTimer( UINT_PTR nIDEvent);
afx_msg void OnDestroy();
public :
void Initialize();
private :
BOOL m_bInited;
};
|
实现:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
// RenderWnd.cpp : 实现文件
//
#include "stdafx.h"
#include "Cocos2dxMFC.h"
#include "RenderWnd.h"
#include "cocos2d.h"
#include "AppDelegate.h"
// CRenderWnd
IMPLEMENT_DYNAMIC(CRenderWnd, CWnd)
CRenderWnd::CRenderWnd()
: m_bInited(FALSE)
{
}
CRenderWnd::~CRenderWnd()
{
}
BEGIN_MESSAGE_MAP(CRenderWnd, CWnd)
ON_WM_TIMER()
ON_WM_DESTROY()
END_MESSAGE_MAP()
// CRenderWnd 消息处理程序
AppDelegate app;
void CRenderWnd::Initialize()
{
cocos2d::GLViewImpl::SetParent( this ->GetSafeHwnd());
cocos2d::Application::getInstance()->run();
this ->m_bInited = TRUE;
SetTimer(1, 1, NULL);
}
void CRenderWnd::OnTimer( UINT_PTR nIDEvent)
{
if ( this ->m_bInited)
{
auto director = cocos2d::Director::getInstance();
director->mainLoop();
director->getOpenGLView()->pollEvents();
CWnd::OnTimer(nIDEvent);
}
}
void CRenderWnd::OnDestroy()
{
CWnd::OnDestroy();
if ( this ->m_bInited)
{
auto director = cocos2d::Director::getInstance();
director->getOpenGLView()->release();
director->end();
director->mainLoop();
this ->m_bInited = FALSE;
}
}
|
然后将刚才绑定的控件m_RenderWnd的类型由CStatic改为CRenderWnd,并在主窗体的OnInitDialog方法中加入一行:
1
2
3
4
5
6
7
8
9
10
|
BOOL CCocos2dxMFCDlg::OnInitDialog()
{
// ...
//
// TODO: 在此添加额外的初始化代码
this ->m_RenderWnd.Initialize();
return TRUE; // 除非将焦点设置到控件,否则返回 TRUE
}
|
8、运行起来
理论上要做的操作已经做完了,现在只需要编译就能运行起来。然而触控会这么好心地做好事不留坑嘛?
当然不会了~传说cocos系列的坑连起来可以绕地球多少圈来着,这里噗通一下就入坑了,不信你F5一下:
这什么鬼?!其实是ApplicationProtocol中Platform枚举中的一个值和MFC的某个宏同名了。解决方法是在stdafx.h中加入这样一句:
然后继续编译。当然是坑不单行,又报错:
不过这个简单,根据报错内容,在项目的预处理器定义中加入_CRT_SECURE_NO_WARNINGS。
按理说最后是不是应该出现一个BOSS级深坑来着?BOSS来了:此时编译可以通过了,但是一运行必然报错。看看输出窗口:
嗷,原来是找不到文件。但是我们之前已经设置了工作目录,Resources下面也有文件啊(这个坑在2.2.6中并没有)。
从Label::createWithTTF一路追踪下去,最后发现Cocos2d-x搜索文件的目录是在这里设置的(CCFileUtils-win32.cpp 59行):
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
static void _checkPath()
{
if (0 == s_resourcePath.length())
{
WCHAR *pUtf16ExePath = nullptr;
_get_wpgmptr(&pUtf16ExePath);
// We need only directory part without exe
WCHAR *pUtf16DirEnd = wcsrchr(pUtf16ExePath, L ‘\\‘ );
char utf8ExeDir[CC_MAX_PATH] = { 0 };
int nNum = WideCharToMultiByte(CP_UTF8, 0, pUtf16ExePath, pUtf16DirEnd-pUtf16ExePath+1, utf8ExeDir, sizeof (utf8ExeDir), nullptr, nullptr);
s_resourcePath = convertPathFormatToUnixStyle(utf8ExeDir);
}
}
|
_get_wpgmptr是个嘛玩意?查一下可以知道,这个函数用于取得进程exe所在的目录。
我们再看看Cocos2d-x 2.2.6中对应的部分(CCFileUtilsWin32.cpp 34行):
1
2
3
4
5
6
7
8
9
10
11
|
static void _checkPath()
{
if (! s_pszResourcePath[0])
{
WCHAR wszPath[MAX_PATH] = {0};
int nNum = WideCharToMultiByte(CP_ACP, 0, wszPath,
GetCurrentDirectoryW( sizeof (wszPath), wszPath),
s_pszResourcePath, MAX_PATH, NULL, NULL);
s_pszResourcePath[nNum] = ‘\\‘ ;
}
}
|
很明显,2.2.6中使用GetCurrentDirectoryW获取当前目录的,使用这个函数就能获取正确的工作目录了。为什么用cocos new出来的3.6项目没这个问题?因为new出来的项目的预链接事件中最后有这么一句:
这个命令会把Resources下的所有文件拷贝到输出目录(也就是进程exe所在的目录)下,自然不会出现找不到文件的问题了。
不知道这么做的意义和目的是什么?但是此时我想说:
我还想说:
修改的方法很简单,参考2.2.6把_checkPath中_get_wpgmptr函数改为GetCurrentDirectoryW:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
static void _checkPath()
{
if (0 == s_resourcePath.length())
{
char pathBuffer[MAX_PATH] = { 0 };
WCHAR wszPath[MAX_PATH] = { 0 };
int nNum = WideCharToMultiByte(CP_ACP, 0, wszPath,
GetCurrentDirectory( sizeof (wszPath), wszPath),
pathBuffer, MAX_PATH, NULL, NULL);
pathBuffer[nNum] = ‘\\‘ ;
s_resourcePath = pathBuffer;
}
}
|
9、最后的小修改
如果你用的MFC窗体是一个Dialog类型的,运行后会发现按回车或Esc后窗体直接关闭了。所以还需要屏蔽掉回车和Esc键的响应。在MFC对话框类中添加一个方法重写PreTranslateMessage:
1
2
|
private :
virtual BOOL PreTranslateMessage(MSG* pMsg);
|
实现:
1
2
3
4
5
6
7
8
9
10
11
|
BOOL CCocos2dxMFCDlg::PreTranslateMessage(MSG* pMsg)
{
if (pMsg->message == WM_KEYDOWN)
{
if (pMsg->wParam == VK_ESCAPE || pMsg->wParam == VK_RETURN)
{
return TRUE;
}
}
return CDialogEx::PreTranslateMessage(pMsg);
}
|
【运行起来】
如果编译没有出错的话,运行起来会看到这个样子:
只要将接口留出来,就可以很方便地通过MFC层的控件来控制cocos层了。至于要做成一个什么样的工具,全靠大家发挥咯~
【后记】
采用这套思路理论上可以把cocos渲染到任何一个支持调用C++层代码的框架中。
需要渲染在C# Winform中的童鞋请看这篇博客,里面有讲处理方法及string到const char*的转换。
来源网址:http://www.cnblogs.com/GuyaWeiren/p/4600937.html
时间: 2024-10-08 23:38:43