【前言】
上一篇讲了怎么把Cocos2d-x 3.6渲染进MFC窗体,这里来讲一下怎么在C# Winform中做到同样的功能。如果你不熟悉MFC的使用但对C# Winform比较在行,请往下看。
这一篇是作为上一篇的副属文,所以文中提到的部分操作需要在上一篇中找……博主懒逼不在这复制粘贴了。
【核心思想】
同上一章不同的是,C#是托管环境,并不能直接用“对象.方法()”这样的形式来访问Cocos层的代码。我们需要在其间建立一个DLL层(C++编写)作为Cocos层的接口,让C#通过接口来控制Cocos层。
【需要的工具】
1、 安装了C#组件的Visual Studio 2013
2、 Cocos2d-x 3.6
3、 GLFW (下载地址:点我)
4、 CMake(下载地址:点我)
【操作步骤】
1、 创建C# Winform项目
.NET的版本随意,使用默认的即可。
2、 拷贝必要文件
参考上一篇
3、 创建空的C++项目
VS2013创建的C++ DLL项目默认是Win8.1平台的,不知道里面装了什么奇怪的东西进去……于是手动创建干净的DLL项目。项目名称自定,我使用的是“App”
添加完成后,将App项目设为C#项目的依赖项。
4、 在解决方案中加入Cocos项目
将libcocos2d,libbox2d,libspine加入解决方案中,并把libcocos2d设为App项目的依赖项。
5、 修改C++项目的属性
在属性管理器(视图——属性管理器)中为项目添加cocos2dx的两个属性表。属性表位于解决方案目录\cocos2d\cocos\2d:
常规页面,按照打框处设置:
调试页面,设置工作目录:
附加包含目录中加入:
$(EngineRoot)cocos\audio\include
$(EngineRoot)external
$(EngineRoot)external\chipmunk\include\chipmunk
$(EngineRoot)extensions
..\Classes
..
%(AdditionalIncludeDirectories)
$(_COCOS_HEADER_WIN32_BEGIN)
$(_COCOS_HEADER_WIN32_END)
预处理器定义中加入:
_WIN32
_WINDOWS
COCOS2D_DEBUG=1
_CRT_SECURE_NO_WARNINGS
附加库目录中加入:
$(_COCOS_LIB_PATH_WIN32_BEGIN)
$(_COCOS_LIB_PATH_WIN32_END)
附加依赖项加入:
$(_COCOS_LIB_WIN32_BEGIN)
$(_COCOS_LIB_WIN32_END)
libcocos2d.lib
6、 修改GLFW
同上一篇
7、 修改Cocos层
同上一篇,以及修改CCFileUtils-win32.cpp 59行的方法:
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;
}
}
8、 为C++项目添加代码
首先添加一个标准DLL源文件dllmain.cpp(名字必须是这个):
// dllmain.cpp : Defines the entry point for the DLL application.
#include <windows.h> BOOL APIENTRY DllMain( HMODULE hModule,DWORD ul_reason_for_call,LPVOID lpReserved)
{
switch (ul_reason_for_call)
{
case DLL_PROCESS_ATTACH:
case DLL_THREAD_ATTACH:
break;
case DLL_THREAD_DETACH:
case DLL_PROCESS_DETACH:
//instance will be deleted automatically
break;
}
return TRUE;
}
然后将Classes文件夹中的源码加入到项目中:
最后添加接口(文件名自定,我使用的API.h和API.cpp),头文件:
#pragma once #define DLLEXPORT __declspec(dllexport) extern "C"
{
DLLEXPORT void Initialize(HWND parent);
DLLEXPORT void MainLoop();
DLLEXPORT void Destory();
};
实现:
#include "API.h" #include "cocos2d.h"
#include "AppDelegate.h" extern "C"
{
AppDelegate app;
DLLEXPORT void Initialize(HWND parent)
{
cocos2d::GLViewImpl::SetParent(parent);
cocos2d::Application::getInstance()->run();
} DLLEXPORT void MainLoop()
{
auto director = cocos2d::Director::getInstance();
director->mainLoop();
director->getOpenGLView()->pollEvents();
} DLLEXPORT void Destory()
{
auto director = cocos2d::Director::getInstance();
director->getOpenGLView()->release();
director->end();
director->mainLoop();
}
}
之后可以根据需求在接口中添加更多的函数。
⑨、 修改C#项目的属性
设置输出路径:
设置工作目录和启用本机代码调试(勾上后可以调试C++层):
10、 为C#项目添加代码
添加一个调用DLL代码的类,我使用的名字叫NativeInterface:
using System;
using System.Runtime.InteropServices; namespace Cocos2dxCSharp
{
class NativeInterface
{
const string DLL_NAME = "App.dll"; [DllImport(DLL_NAME, CallingConvention = CallingConvention.Cdecl)]
public static extern void Initialize(int parent); [DllImport(DLL_NAME, CallingConvention = CallingConvention.Cdecl)]
public static extern void MainLoop(); [DllImport(DLL_NAME, CallingConvention = CallingConvention.Cdecl)]
public static extern void Destory();
}
}
在窗体编辑器中,对窗体添加Load和FormClosing两个事件响应方法,再拖一个Panel控件和一个Timer控件到窗体上。Timer控件的Interval值设为10,并添加Tick事件的响应方法。
然后完成方法:
private void Form1_Load(object sender, EventArgs e)
{
this.timer1.Start();
NativeInterface.Initialize(this.panel1.Handle.ToInt32());
} private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
this.timer1.Stop();
NativeInterface.Destory();
} private void timer1_Tick(object sender, EventArgs e)
{
NativeInterface.MainLoop();
}
11、 运行起来
如果编译没有出错的话,运行起来会看到这个样子:
【字符串传递处理】
普通的数据类型(int,float这些)是可以直接作为参数或返回值传递的。虽然C#中的string类型和C++中的const char*类型也是对应的,但是在调试过程中,如果不做处理会报错。
因为调试时C#的托管堆栈和C++的DLL堆栈并不属于同一块内存,就好比你拿着“城隍庙”这个地址,在成都找到的是各种电子元件,在上海找到的是各种小吃。
这里有篇博文讲了参数如何传递,我大概整理了一下:
1、字符串作为参数
C++:参数为char*
C#:参数为string,用[MarshalAs(UnmanagedType.LPStr)]修饰
[DllImport("A.dll)"]
static extern void Function([MarshalAs(UnmanagedType.LPStr)]string val);
2、字符串作为返回值
C++:返回值为char*
C#:返回值为string,使用[return:MarshalAs(UnmanagedType.LPStr)]修饰
[DllImport("A.dll)"]
[return:MarshalAs(UnmanagedType.LPStr)]
static extern string Function();
3、字符串作为输入输出参数
C++:参数为char*
C#:参数为byte[](那篇博文提到的用StringBuilder我这里传不了,不解)
[DllImport("A.dll)"]
static extern void Function(byte[] intoutVal);
如果要传递宽字符,使用UnmanagedType.LPWStr即可。