win10 vs2022 搭建 cocos2d-x 3.17 开发环境

Posted khlbat

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了win10 vs2022 搭建 cocos2d-x 3.17 开发环境相关的知识，希望对你有一定的参考价值。

引擎下载地址

https://cocos2d-x.org/download/

也可以在 github 下载

https://github.com/cocos2d/cocos2d-x/tags

手册地址

https://docs.cocos2d-x.org/cocos2d-x/v3/zh/

api 文档地址

https://docs.cocos2d-x.org/api-ref/cplusplus/v3x/index.html

hello world

安装注意事项

  1. 需要 python2 , 安装后可以用 python2 的绝对路径运行 cocos 的 setup.py
  2. 如何没有把 python2 加入到环境变量, 可以修改引擎路径下的 tools\\cocos2d-console\\bin\\cocos.bat
@echo off
@python2 绝对路径 "%~dp0/cocos.py" %*

新建项目

cocos new HelloCocos -p com.laolang.hellococos -l cpp

然后打开 proj.win32 目录下的 .sln 文件, 提示升级点确认, 编译运行即可

中文乱码问题

参考:
Cocos2d-x 中文标题设置
Cocos2d-x 中文内容设置

标题直接用下面的函数转一下, Label等内容的中文显示还需要中文字体的支持, 可以从网上下载或者从C盘拷一个, 例如宋体常规, 此字体文件名为:simsun.ttc

std::string CommonUtil::GBKToUTF8(const std::string& strGBK)

    std::string strOutUTF8 = "";
    WCHAR* str1;
    int n = MultiByteToWideChar(CP_ACP, 0, strGBK.c_str(), -1, NULL, 0);
    str1 = new WCHAR[n];
    MultiByteToWideChar(CP_ACP, 0, strGBK.c_str(), -1, str1, n);
    n = WideCharToMultiByte(CP_UTF8, 0, str1, -1, NULL, 0, NULL, NULL);
    char* str2 = new char[n];
    WideCharToMultiByte(CP_UTF8, 0, str1, -1, str2, n, NULL, NULL);
    strOutUTF8 = str2;
    delete[]str1;
    str1 = NULL;
    delete[]str2;
    str2 = NULL;
    return strOutUTF8;

hello world 关键代码注释

AppDelegate的applicationDidFinishLaunching方法
其四个方法含义分别为(https://blog.csdn.net/xiayao2012/article/details/49472423)

initGLContextAttrs();//设置 OpenGL环境
applicationDidFinishLaunching(); //逻辑初始化
applicationDidEnterBackground(); //切换到后台
applicationWillEnterForeground(); //切换到前台

bool AppDelegate::applicationDidFinishLaunching() 
    // 初始化 director
    auto director = Director::getInstance();
    auto glview = director->getOpenGLView();
    // 初始化 opengl 试图
    if(!glview) 
        glview = GLViewImpl::createWithRect(CommonUtil::GBKToUTF8("第一个 Cocos2d-X 程序"), cocos2d::Rect(0, 0, resolutionSize.width, resolutionSize.height));
        director->setOpenGLView(glview);
    

    // 开启左下角 FPS 状态信息
    director->setDisplayStats(true);
    // 设置 FPS 为 60, 默认为 60
    director->setAnimationInterval(1.0f / 60);

    // 设置屏幕分辨率
    glview->setDesignResolutionSize(resolutionSize.width, resolutionSize.height, ResolutionPolicy::NO_BORDER);

    register_all_packages();

    // 创建 Hello World 场景, 对象的释放交给 cocos2d-x 管理
    auto scene = HelloWorld::createScene();

    // 运行
    director->runWithScene(scene);

    return true;

HelloWorldScene的init方法

bool HelloWorld::init()

    // 先执行父类的 init
    if (!Scene::init())
    
        return false;
    

    // 获得可视区域大小
    const auto visibleSize = Director::getInstance()->getVisibleSize();
    log("width:%f , height:%f", visibleSize.width, visibleSize.height);
    // 获得原点位置 左下角
    const Vec2  origin = Director::getInstance()->getVisibleOrigin();
    log("x:%f , y:%f", origin.x, origin.y);


    // 关闭按钮, 是一个 MenuItemImage, 表示一个菜单项
    auto closeItem = MenuItemImage::create(
        "CloseNormal.png", // 非选中状态
        "CloseSelected.png", // 选中状态
        CC_CALLBACK_1(HelloWorld::menuCloseCallback, this) // 回调函数
    );
    // 按钮位置, 窗口右下角
    const float x = origin.x + visibleSize.width - closeItem->getContentSize().width / 2;
    const float y = origin.y + closeItem->getContentSize().height / 2;
    closeItem->setPosition(Vec2(x, y));

    // 把菜单项添加到菜单中
    auto menu = Menu::create(closeItem, NULL);
    menu->setPosition(Vec2::ZERO);
    // 菜单添加到当前层
    this->addChild(menu, 1);

    // Hello World 文本
    const auto label = Label::createWithTTF(CommonUtil::GBKToUTF8("第一个程序"), CommonUtil::GetDefaultFontPath(), 24);
    // 设置文本位置
    label->setPosition(Vec2(origin.x + visibleSize.width / 2, origin.y + visibleSize.height - label->getContentSize().height));
    // 文本添加到当前层
    this->addChild(label, 1);

    // 创建背景图片
    const auto sprite = Sprite::create("HelloWorld.png");
    // 图片位置
    sprite->setPosition(Vec2(visibleSize.width / 2 + origin.x, visibleSize.height / 2 + origin.y));
    // 背景图片添加到当前层
    this->addChild(sprite, 0);

    return true;

OpenGL是什么？Win10+VS2019下搭建glfw+glad开发环境

1、什么是OpenGL

什么是OpenGL

  • OpenGL 是一套API接口。
    学习这套接口，就可以在那些支持OpenGL的机器上正常使用这些接口，在屏幕上看到绘制的结果。

  • 显卡厂商的支持
    这套接口是 Khronos(科纳斯) 这个组织在维护，怎么维护呢? 就是写一个说明书，指导各个GPU厂家，如果他们要支持OpenGL的话，要怎么实现一个具体的OpenGL库。Khronos说要实现glDrawArray这个接口，那么厂家就得在他的库里实现这个接口。如果不实现，那么就不算支持OpenGL。也有一些接口不一定要实现。
    Khronos每隔一段时间发布一个新的OpenGL API版本，就是发布这个说明书。一般两个，一个是core profile，一定要实现的，还有另一个是为了兼容旧版本接口的说明书。
    厂家实现的OpenGL库的内容其实就是厂家自己的团队整合自己的图形知识以及GPU硬件的指令。
    OpenGL的Open指的是接口是开放的，而具体实现的库一般都是不公开的。目前据我所知，mesa 3d是一个开源的实现。

  • 与Direct3D的关系
    像AMD、Nvidia等图形硬件厂家还得支持Direct3D，所以他们还得按照微软的接口说明书，整合Direct3D的库给Windows使用。
    在Windows上，还有一种情况，就是这个OpenGL库可能是Direct3D接口的一个封装(Wrapper)。表面上调用OpenGL接口，实际上里面的实现是间接调用了Direct3D接口。

  • 另外OpenGL 只是关注于怎么调用接口实现绘画 。
    为了使用OpenGL，还得初始化一个OpenGL环境。这个环境需要AGL、WGL、GLX这些库里的接口来建立。这几个库分别对应苹果系统、Windows、还有Linux的X-Window，没有实现跨平台。
    这也是为什么存在glut（已经不更新了，代替者freeglut，不支持macOS）、glfw这些 “半”跨平台的框架帮助你轻松地在各平台下使用OpenGL。

  • 与OpenCV的关系
    OpenCV是Intel开源计算机视觉库。
    Opencv是从图像到数据
    OpenGL是从数据到图像

OpenGL主要功能是什么

  • 1、建模：OpenGL图形库除了提供基本的点、线、多边形的绘制函数外，还提供了复杂的三维物体（球、锥、多面体、茶壶等）以及复杂曲线和曲面绘制函数。

  • 2、变换：OpenGL图形库的变换包括基本变换和投影变换。基本变换有平移、旋转、缩放、镜像四种变换，投影变换有平行投影（又称正射投影）和透视投 影两种变换。其变换方法有利于减少算法的运行时间，提高三维图形的显示速度。

  • 3、颜色模式设置：OpenGL颜色模式有两种，即RGBA模式和颜色索引（Color Index）。

  • 4、光照和材质设置：OpenGL光有自发光（Emitted Light）、环境光（Ambient Light）、漫反射光（Diffuse Light）和高光（Specular Light）。材质是用光反射率来表示。场景（Scene）中物体最终反映到人眼的颜色是光的红绿蓝分量与材质红绿蓝分量的反射率相乘后形成的颜色。

  • 5、纹理映射（Texture Mapping）。利用OpenGL纹理映射功能可以十分逼真地表达物体表面细节。

  • 6、位图显示和图象增强图象功能除了基本的拷贝和像素读写外，还提供融合（Blending）、抗锯齿（反走样）（Antialiasing）和雾（fog）的特殊图象效果处理。以上三条可使被仿真物更具真实感，增强图形显示的效果。

  • 7、双缓存动画（Double Buffering）双缓存即前台缓存和后台缓存，简言之，后台缓存计算场景、生成画面，前台缓存显示后台缓存已画好的画面。

2、OpenGL环境配置

① OpenGL的组成部分
————先来看一篇引用文章（OpenGL的前生今世）

OpenGL中的各类库

gl.h

gl库是核心库，gl中包含了最基本的3D函数，可以再本地电脑中的： C:\\Program Files (x86)\\ Microsoft SDKs\\Windows \\v7.0A\\Include\\gl 路径下找到gl.h头文件，打开后可以看到其中定义的上百个相关函数。

glu.h

glu是实用库，包含有43个函数，函数名的前缀为glu。glu 为了减轻繁重的编程工作，glu对gl中的函数进行部分封装，glu函数通过调用核心库的函数，为开发者提供相对简单的用法，实现一些较为复杂的操作。如果算术好，在不使用glu库的情况下，使用gl库可以实现同样的效果。

glut.h

gult：OpenGL工具库 OpenGL Utility Toolkit。 glut是基本的窗口界面，是独立于gl和glu的，如果不喜欢用glut可使用MFC和Win32窗口等代替。但是glut是跨平台的，这就保证了我们编出的程序具有跨平台性，而使用MFC或Win32只能在windows操作系统上使用。
主要包括窗口操作函数，窗口初始化、窗口大小、窗口位置等函数；回调函数：响应刷新消息、键盘消息、鼠标消息等等。 这个头文件自动包含了gl.h和glu.h，编程时不必再次包含它们。

freeglut.h

各种教程和书里常见的是闭源的GLUT。但由于GLUT的作者已经很久没更新过了（最后更新于2000年！= =），所以其他人另外做了一个接口兼容GLUT的freeglut，开源而且一直在维护中。可以理解为glut的替代库。

glew

GLUT或者FREEGLUT主要是1.0的基本函数功能；GLEW是使用OPENGL2.0之后的一个工具函数。不同的显卡公司，也会发布一些只有自家显卡才支持的扩展函数，你要想用这数涵数，不得不去寻找最新的glext.h,有了GLEW扩展库，你就再也不用为找不到函数的接口而烦恼，因为GLEW能自动识别你的平台所支持的全部OpenGL高级扩展函数。也就是说，只要包含一个glew.h头文件，你就能使用gl,glu,glext,wgl,glx的全部函数。
glad和glew的作用相同，可看做它的升级版。

glfw.h

GLFW无愧于其号称的lightweight的OpenGL框架，一个头文件，很少量的API，就完成了任务。GLFW的开发目的是用于替代glut的，从代码和功能上来看，我想它已经完全的完成了任务。它是一个轻量级的，开源的，跨平台的library。支持OpenGL及OpenGL ES，用来管理窗口，读取输入，处理事件等。因为OpenGL没有窗口管理的功能，所以很多热心的人写了工具来支持这些功能，比如早期的glut，现在的freeglut等。那么GLFW有何优势呢？glut太老了，最后一个版本还是90年代的。freeglut完全兼容glut，算是glut的代替品，功能齐全，但是bug太多。稳定性也不好（不是我说的啊），GLFW应运而生。并且glfw也是跨平台的~！
glfw可以看做是freeglut的升级版，freeglut可以看做是glut的升级版

  • 综上所述，为了安装一个OpenGL，你需要一个3D函数库和一个窗口管理库。
    3D函数库可选：gl&glu，升级版glew，再升级glad。
    窗口管理库可选：glut，升级版freeglut，再升级glfw。

② 窗口管理库GLFW的安装

  • GLFW官网下载：https://www.glfw.org/download.html
    windows一般下载 ，32-bit.。此处32和64指的不是本机器的位数，而是生成目标的位数。 windows pre-compiled binaries，为windows预编译版本

  • 整理所需文件到另一个文件夹：需要include文件夹和本机对应版本的"lib-vc20**"文件夹。如我的vs是2019，就复制include和lib-vc2019。

  • 打开VS2019，新建一个c++win32控制台项目

  • 依次点击“视图" —>“属性页”, 在vc++目录，“包含目录”和“库目录”分别添加解压复制后的Incude和lib目录。 注意路径。

  • 在 “连接器” ->“附加依赖项”中添加“opengl32.lib”和"glfw3.lib"，用分号隔开

  • 在在源文件中添加如下代码测试环境

    #include <GLFW/glfw3.h>

int main(void)

	GLFWwindow* window;

	/* Initialize the library */
	if (!glfwInit())
		return -1;

	/* Create a windowed mode window and its OpenGL context */
	window = glfwCreateWindow(640, 480, "Hello World", NULL, NULL);
	if (!window)
	
		glfwTerminate();
		return -1;
	

	/* Make the window's context current */
	glfwMakeContextCurrent(window);

	/* Loop until the user closes the window */
	while (!glfwWindowShouldClose(window))
	
		/* Render here */
		glClear(GL_COLOR_BUFFER_BIT);

		glBegin(GL_TRIANGLES);
		glVertex2d(0.5f, 0.5f);
		glVertex2d(-0.5f, -0.5f);
		glVertex2d(0.5f, -0.5f);

		glEnd();

		/* Swap front and back buffers */
		glfwSwapBuffers(window);

		/* Poll for and process events */
		glfwPollEvents();
	

	glfwTerminate();
	return 0;

③3D函数库 glad的安装

  • glad官网下载：https://glad.dav1d.de/
    语言选择C/C++，在API选项中，选择3.3以上的OpenGL(gl)版本（因为glfw不支持更早的版本，>=3.3都可以，具体可以看显卡支持到哪个版本 ）。
    之后将模式(Profile)设置为Core，并且保证生成加载器(Generate a loader)的选项是选中的。
    现在可以先（暂时）忽略拓展(Extensions)中的内容。
    都选择完之后，点击生成(Generate)按钮来生成库文件。

  • 下载glad.zip文件解压，就可以得到我们需要的include\\glad\\ glad.h、include\\KHR\\ khrplatform.h和src\\ glad.c这3个文件

  • 进入VS2019项目，在项目属性 ----> C/C++ —> 附加包含目录 —> your_path\\glad\\include

  • 最后在项目中添加glad.c 文件

  • 以下代码测试是否安装成功

    #include <glad\\glad.h>   //这个必须放在GLFW之前
#include <GLFW\\glfw3.h>

#include <iostream>

void framebuffer_size_callback(GLFWwindow* window, int width, int height);
void processInput(GLFWwindow* window);

// settings
const unsigned int SCR_WIDTH = 800;
const unsigned int SCR_HEIGHT = 600;

const char* vertexShaderSource = "#version 330 core\\n"
"layout (location = 0) in vec3 aPos;\\n"
"void main()\\n"
"\\n"
"   gl_Position = vec4(aPos.x, aPos.y, aPos.z, 1.0);\\n"
"\\0";
const char* fragmentShaderSource = "#version 330 core\\n"
"out vec4 FragColor;\\n"
"void main()\\n"
"\\n"
"   FragColor = vec4(1.0f, 0.5f, 0.2f, 1.0f);\\n"
"\\n\\0";

int main() 

	// glfw: initialize and configure
	// ------------------------------
	glfwInit(); //glfw 初始化
	//设置OpenGL版本等信息
	glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);
	glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3);
	glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);

#ifdef __APPLE__
	glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE); // uncomment this statement to fix compilation on OS X
#endif

	// glfw window creation
	// --------------------
	//创建GLFW窗口
	GLFWwindow* window = glfwCreateWindow(SCR_WIDTH, SCR_HEIGHT, "LearnOpenGL", NULL, NULL);
	if (window == NULL) 

		std::cout << "Failed to create GLFW window" << std::endl;
		glfwTerminate();
		return -1;
	
	//设置当前上下文
	glfwMakeContextCurrent(window);
	glfwSetFramebufferSizeCallback(window, framebuffer_size_callback);

	// glad: load all OpenGL function pointers
	// ---------------------------------------
	//把OpenGL的函数指针导入给GLAD
	if (!gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)) 

		std::cout << "Failed to initialize GLAD" << std::endl;
		return -1;
	

	// build and compile our shader program
	// ------------------------------------
	// vertex shader
	int vertexShader = glCreateShader(GL_VERTEX_SHADER);
	glShaderSource(vertexShader, 1, &vertexShaderSource, NULL);
	glCompileShader(vertexShader);
	// check for shader compile errors
	int success;
	char infoLog[512];
	glGetShaderiv(vertexShader, GL_COMPILE_STATUS, &success);
	if (!success) 

		glGetShaderInfoLog(vertexShader, 512, NULL, infoLog);
		std::cout << "ERROR::SHADER::VERTEX::COMPILATION_FAILED\\n" << infoLog << std::endl;
	
	// fragment shader
	int fragmentShader = glCreateShader(GL_FRAGMENT_SHADER);
	glShaderSource(fragmentShader, 1, &fragmentShaderSource, NULL);
	glCompileShader(fragmentShader);
	// check for shader compile errors
	glGetShaderiv(fragmentShader, GL_COMPILE_STATUS, &success);
	if (!success) 

		glGetShaderInfoLog(fragmentShader, 512, NULL, infoLog);
		std::cout << "ERROR::SHADER::FRAGMENT::COMPILATION_FAILED\\n" << infoLog << std::endl;
	
	// link shaders
	int shaderProgram = glCreateProgram();
	glAttachShader(shaderProgram, vertexShader);
	glAttachShader(shaderProgram, fragmentShader);
	glLinkProgram(shaderProgram);
	// check for linking errors
	glGetProgramiv(shaderProgram, GL_LINK_STATUS, &success);
	if (!success) 

		glGetProgramInfoLog(shaderProgram, 512, NULL, infoLog);
		std::cout << "ERROR::SHADER::PROGRAM::LINKING_FAILED\\n" << infoLog << std::endl;
	
	glDeleteShader(vertexShader);
	glDeleteShader(fragmentShader);

	// set up vertex data (and buffer(s)) and configure vertex attributes
	// ------------------------------------------------------------------
	float vertices[] = 

		0.5f, 0.5f, 0.0f,  // top right
		0.5f, -0.5f, 0.0f,  // bottom right
		-0.5f, -0.5f, 0.0f,  // bottom left
		-0.5f, 0.5f, 0.0f   // top left 
	;
	unsigned int indices[] = 
		// note that we start from 0!
		  0, 1, 3,  // first Triangle
		  1, 2, 3   // second Triangle
	;
	unsigned int VBO, VAO, EBO;
	glGenVertexArrays(1, &VAO);
	glGenBuffers(1, &VBO);
	glGenBuffers(1, &EBO);
	// bind the Vertex Array Object first, then bind and set vertex buffer(s), and then configure vertex attributes(s).
	glBindVertexArray(VAO);

	glBindBuffer(GL_ARRAY_BUFFER, VBO);
	glBufferData(GL_ARRAY_BUFFER, sizeof(vertices), vertices, GL_STATIC_DRAW);

	glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, EBO);
	glBufferData(GL_ELEMENT_ARRAY_BUFFER, sizeof(indices), indices, GL_STATIC_DRAW);

	glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 3 * sizeof(float), (void*)0);
	glEnableVertexAttribArray(0);

	// note that this is allowed, the call to glVertexAttribPointer registered VBO as the vertex attribute's bound vertex buffer object so afterwards we can safely unbind
	glBindBuffer(GL_ARRAY_BUFFER, 0);

	// remember: do NOT unbind the EBO while a VAO is active as the bound element buffer object IS stored in the VAO; keep the EBO bound.
	//glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, 0);

	// You can unbind the VAO afterwards so other VAO calls won't accidentally modify this VAO, but this rarely happens. Modifying other
	// VAOs requires a call to glBindVertexArray anyways so we generally don't unbind VAOs (nor VBOs) when it's not directly necessary.
	glBindVertexArray(0);

	// uncomment this call to draw in wireframe polygons.
	//glPolygonMode(GL_FRONT_AND_BACK, GL_LINE);

	// render loop
	// -----------
	//循环渲染
	while (!glfwWindowShouldClose(window)) 

		// input
		// -----
		processInput(window);

		// render
		// ------
		glClearColor(0.2f, 0.3f, 0.3f, 1.0f);
		glClear(GL_COLOR_BUFFER_BIT);

		// draw our first triangle
		glUseProgram(shaderProgram);
		glBindVertexArray(VAO); // seeing as we only have a single VAO there's no need to bind it every time, but we'll do so to keep things a bit more organized
		//glDrawArrays(GL_TRIANGLES, 0, 6);
		glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0);
		// glBindVertexArray(0); // no need to unbind it every time 

		// glfw: swap buffers and poll IO events (keys pressed/released, mouse moved etc.)
		// -------------------------------------------------------------------------------
		//交换缓存
		glfwSwapBuffers(window);
		//事件处理
		glfwPollEvents();
	

	// optional: de-allocate all resources once they've outlived their purpose:
	// ------------------------------------------------------------------------
	glDeleteVertexArrays(1, &VAO);
	glDeleteBuffers(1, &VBO);
	glDeleteBuffers(1, &EBO);

	// glfw: terminate, clearing all previously allocated GLFW resources.
	// ------------------------------------------------------------------
	//停止
	glfwTerminate();
	return 0;


// process all input: query GLFW whether relevant keys are pressed/released this frame and react accordingly
// ---------------------------------------------------------------------------------------------------------
//输入处理函数
void processInput(GLFWwindow* window) 

	if (glfwGetKey(window, GLFW_KEY_ESCAPE) == GLFW_PRESS)
		glfwSetWindowShouldClose(window, true);


// glfw: whenever the window size changed (by OS or user resize) this callback function executes
//窗口大小设置回调函数
// ---------------------------------------------------------------------------------------------
void framebuffer_size_callback(GLFWwindow* window, int width, int height) 

	// make sure the viewport matches the new window dimensions; note that width and 
	// height will be significantly larger than specified on retina displays.
	glViewport(0, 0, width, height);

以上是关于win10 vs2022 搭建 cocos2d-x 3.17 开发环境的主要内容，如果未能解决你的问题，请参考以下文章

cocos2d-x(vs2012)环境搭建(第一篇)[版本号:cocos2d-x-3.1.1]

[游戏开发日志]Windows下Cocos2d-x 3.14环境搭建

如何在win7上搭建Android cocos2d-x-3.3开发环境

arm版win11运行vs2022

Win8.1下COCOS2D-X 3.4环境搭建

WIN10 1703 + VS2017 + WDK10驱动开发环境搭建