Hazel游戏引擎（082）原生C++脚本（Lambda）

已于 2023-08-06 23:23:49 修改
阅读量273 收藏
点赞数
分类专栏： Hazel游戏引擎 文章标签： 游戏引擎 c++ 脚本系统 lambda
于 2023-08-06 23:16:54 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_34060370/article/details/132137443
版权

文中若有代码、术语等错误，欢迎指正

文章目录

前言

  • 此节目标

    需要给实体添加脚本组件，需先实现用cpp语言来编写脚本

    1. 脚本组件
    2. cpp脚本功能类

  • 此节所作

    给摄像机实体添加脚本组件，在引擎内的Scene视口中引擎人员和游戏开发人员都可以控制摄像机移动

  • 为什么需要添加cpp脚本组件

    • 引擎开发人员需要给引擎某个实体添加脚本功能，从而实现测试时候能运行想要的脚本功能。

      比如：像Unity那样在Scene界面，摄像机可以自由移动，这是内置脚本功能，肯定是使用原生cpp语言来实现的

    • 使用这引擎的游戏开发人员有的人不喜欢用c#，想用cpp来实现脚本编写。

  • 如何出发

    像前面说的，先从API设计开始，再实现内容

    class CameraController : public ScriptableEntity
{
public:
    void OnCreate(){}
    void OnDestroy(){}
    void OnUpdate(Timestep ts){
        // 获取当前挂载CameraController脚本的实体的TransformComponent组件
        auto& transform = GetComponent<TransformComponent>().Transform;
    }
};
// 实体添加脚本组件并且脚本组件关联对应的脚本功能类
m_CameraEntity.AddComponent<NativeScriptComponent>().Bind<CameraController>();

  • 实现难点

    • 在CameraController脚本类内获取挂载了这个脚本的Camear实体的Transform组件。
    • 在Scene视口实现执行摄像机的控制脚本（用户按下wsad，摄像机的脚本能狗响应）。

实现在Scene视口操作摄像机移动

文字+代码描述

  • 声明class CameraController继承ScriptableEntity

    class CameraController : public ScriptableEntity {
    void OnCreate(){}
    void OnDestroy() {}
    void OnUpdate(Timestep ts) { auto& transform = GetComponent<TransformComponent>().Transform;}

  • 摄像机实体添加NativeScriptComponent脚本组件,并传入CameraController给Bind()函数

    m_CameraEntity.AddComponent<NativeScriptComponent>().Bind<CameraController>();

  • NativeScriptComponent脚本组件接收到CameraController作为参数T

    将3个function属性（create,Onupdate,destroy）都绑定为T中的3个对应函数（create,Onupdate,destroy

    并且1个function（InstantiateFunction）用来实例化ScriptableEntity派生类。

    struct NativeScriptComponent {
    ScriptableEntity* Instance = nullptr;
    // 关键地方//
    std::function<void()> InstantiateFunction;
    std::function<void()> DestroyInstanceFunction;
    std::function<void(ScriptableEntity*)> OnCreateFunction;
    std::function<void(ScriptableEntity*)> OnDestroyFunction;
    std::function<void(ScriptableEntity*, Timestep)> OnUpdateFunction;
    template<typename T>
    void Bind() {
        // 这里绑定的函数功能是：根据T动态实例化Instanse。
        InstantiateFunction = [&]() {Instance = new T(); };// 引用值捕获Instance（捕获了CameraController，所以实例化CameraController）
        DestroyInstanceFunction = [&]() {delete (T*)Instance; Instance = nullptr; };// 为什么一定要转换为T，因为是在继承的情况下，起提示作用
        // 这里是绑定T的函数
        OnCreateFunction = [](ScriptableEntity* instance) {((T*)instance)->OnCreate(); };
        OnDestroyFunction = [](ScriptableEntity* instance) {((T*)instance)->OnDestroy(); };
        OnUpdateFunction = [](ScriptableEntity* instance, Timestep ts) {((T*)instance)->OnUpdate(ts); };
    }
};

  • 在Scene.cpp的OnUpdate函数中。

    遍历所属这个场景所拥有NativeScriptComponent脚本组件的实体ID，并且用lambda迭代循环实体列表，参数是实体的ID和NativeScriptComponent脚本组件实例对象的引用nsc。

    • 用nsc执行function实例化Instance，即ScriptableEntity *Instance = new CameraController();

    • 再用nsc.Instance->m_Entity = Entity{ entity, this };

      指定CameraController脚本的m_Entity是实体ID，让脚本与实体关联起来

    • 由function调用CameraController脚本的OnCreate、OnUpdate函数

      // 引擎运行的时候更新脚本。
{   //  [=]是隐式值捕获，捕获ts
    m_Registry.view<NativeScriptComponent>().each([=](auto entity, auto& nsc) {
        if (!nsc.Instance) {
            // 实例化CameraController
            nsc.InstantiateFunction();
            nsc.Instance->m_Entity = Entity{ entity, this };
            // 执行CameraController脚本的OnCreate函数
            nsc.OnCreateFunction(nsc.Instance);
        }
        // 执行CameraController脚本的OnUpdate函数
        nsc.OnUpdateFunction(nsc.Instance, ts);
    });
}

    • 在CameraController.OnUpdate函数中获取摄像机实体的transform组件

      void OnUpdate(Timestep ts) {
// 获取当前挂载CameraController脚本的实体的TransformComponent组件
auto& transform = GetComponent<TransformComponent>().Transform;

图画描述

用类图+活动图描述的，不符合软件工程规范，大意是这样。

请添加图片描述

相关代码

  • ScriptableEntity.h

    #pragma once
#include "Entity.h"
namespace Hazel {
	class ScriptableEntity {
	public:
		template<typename T>
		T& GetComponent() {
			return m_Entity.GetComponent<T>(); // 根据Entity类找到关联的组件
		}
	private:
		Entity m_Entity; // 拥有此脚本的实体
		friend class Scene;
	};
}

  • Components.h

    struct NativeScriptComponent {
    ScriptableEntity* Instance = nullptr;
    // 关键地方//
    std::function<void()> InstantiateFunction;
    std::function<void()> DestroyInstanceFunction;

    std::function<void(ScriptableEntity*)> OnCreateFunction;
    std::function<void(ScriptableEntity*)> OnDestroyFunction;
    std::function<void(ScriptableEntity*, Timestep)> OnUpdateFunction;

    template<typename T>
    void Bind() {
        // 这里绑定的函数功能是：根据T动态实例化Instanse
        InstantiateFunction = [&]() {Instance = new T(); };// 引用值捕获Instance（捕获了CameraController，所以实例化CameraController）
        DestroyInstanceFunction = [&]() {delete (T*)Instance; Instance = nullptr; };// 为什么一定要转换为T，因为是在继承的情况下，起提示作用

        // 这里是绑定T的函数
        OnCreateFunction = [](ScriptableEntity* instance) {((T*)instance)->OnCreate(); };
        OnDestroyFunction = [](ScriptableEntity* instance) {((T*)instance)->OnDestroy(); };
        OnUpdateFunction = [](ScriptableEntity* instance, Timestep ts) {((T*)instance)->OnUpdate(ts); };
    }
};

    • create function声明与定义 同等写法1

      std::function<void()> OnCreateFunction;// 声明
// 这里隐式捕获的是“Bind函数里的this指针“
OnCreateFunction = [&]() {((T*)Instance)->OnCreate(); };// 定义形式1, 省略使用this调用全局的Instance属性
nsc.OnCreateFunction();// 使用

    • create function声明与定义 同等写法2

      std::function<void()> OnCreateFunction;// 声明
// 这里隐式捕获的是“Bind函数里的this指针“
OnCreateFunction = [&]() {((T*)this->Instance)->OnCreate(); };// 定义形式2, 显式使用this调用全局的Instance属性
nsc.OnCreateFunction();// 使用

    • create function声明与定义 错误写法1

      std::function<void()> OnCreateFunction;// 声明
// 未捕获Bind函数的this指针，此时this是lamda函数作用域的this指针，无Instance属性
OnCreateFunction = []() {((T*)this->Instance)->OnCreate(); };
nsc.OnCreateFunction();// 使用

    • create function声明与定义 错误写法2

      std::function<void()> OnCreateFunction;// 声明
// Instance是全局的，不在Bind函数内不能捕获
OnCreateFunction = [&Instance]() {((T*)Instance)->OnCreate(); };
nsc.OnCreateFunction();// 使用

  • EditorLayer.cpp

    class CameraController : public ScriptableEntity {
    public:
    void OnCreate(){}
    void OnDestroy() {}
    void OnUpdate(Timestep ts) {
        // 获取当前挂载CameraController脚本的实体的TransformComponent组件
        auto& transform = GetComponent<TransformComponent>().Transform;
        float speed = 5.0f;

        if (Input::IsKeyPressed(KeyCode::A))
            transform[3][0] -= speed * ts;
        if (Input::IsKeyPressed(KeyCode::D))
            transform[3][0] += speed * ts;
        if (Input::IsKeyPressed(KeyCode::W))
            transform[3][1] += speed * ts;![请添加图片描述](https://img-blog.csdnimg.cn/c720177bebaf4b2190e7e2f007860398.png)

        if (Input::IsKeyPressed(KeyCode::S))
            transform[3][1] -= speed * ts;
    }
};
m_CameraEntity.AddComponent<NativeScriptComponent>().Bind<CameraController>();

  • Scene.cpp

    // 引擎运行的时候更新脚本。
{//  [=]是隐式值捕获，捕获ts
    m_Registry.view<NativeScriptComponent>().each([=](auto entity, auto& nsc) {
        if (!nsc.Instance) {
            nsc.InstantiateFunction();
            nsc.Instance->m_Entity = Entity{ entity, this };
            // 执行CameraController脚本的OnCreate函数
            nsc.OnCreateFunction(nsc.Instance);
        }
        // 执行CameraController脚本的OnUpdate函数
        nsc.OnUpdateFunction(nsc.Instance, ts);
    });
}

涉及的C++知识

delete

针对此节这段代码

DestroyInstanceFunction = [&]() {delete (T*)Instance; Instance = nullptr; };// 为什么一定要转换为T，因为是在继承的情况下，起提示作用

写的demo

#include <iostream>
using namespace std;
class ScriptableEntity {
public:
	virtual ~ScriptableEntity() { cout << "~ScriptableEntity()" << endl; }
};
class CameraController : public ScriptableEntity {
public:
	virtual ~CameraController() { cout << "~CameraController()" << endl; }
};
void main() {
	// s1是在栈上的，若*s = &s1;当显示删除delete s; s1的内存会被清除，但是出了main作用域，s1又会被清理一遍，所以会报错。
	//ScriptableEntity s1;
	//ScriptableEntity* s = &s1;
    //delete s;

	ScriptableEntity* sp1 = new ScriptableEntity;
	// 这两种删除方式都只会调用~ScriptableEntity()
	delete sp1;
	//delete (ScriptableEntity*)sp1;

	ScriptableEntity* sp2 = new CameraController;
	// 这两种删除方式都会调用 ~CameraController() 然后 ~ScriptableEntity()
	//delete sp2;
	delete (CameraController*)sp2;// 提示作用
}

lambda简要

#include <iostream>
using namespace std;
/*
捕获:
	将当前作用域的变量，可以放进lambda{}里使用。[c1]为值捕获，[&c1]为引用捕获
隐式捕获：
	在捕获的基础上可以简化代码，不用写出捕获哪个变量。
	[=]{return c1;} 表示隐式值捕获，捕获的变量即{}里用到的c1变量
	[&]{return c1;} 表示隐式引用捕获，捕获的变量即{}里用到的c1变量
*/
// 1.值捕获
void fcn1()
{
	size_t v1 = 42;
	auto f = [v1] {return v1; };
	//auto f = [v1]()mutable{return ++v1; }; // 加了mutable才可以修改
	v1 = 0;
	auto j = f();
	cout << j << endl; // 42
}
// 2.引用捕获
void fcn2()
{
	size_t v1 = 42;
	auto f = [&v1] {return v1; };
	v1 = 0;
	auto j = f();
	cout << j << endl;// 0
}
// 3.隐式捕获
void fcn3() {
	// 3.1隐式值捕获
	size_t v1 = 42;
	auto f1 = [=] {return v1; };
	//auto f1 = [v1]()mutable{return ++v1; }; // 加了mutable才可以修改
	v1 = 0;
	auto j1 = f1();
	cout << j1 << endl; // 42
	// 3.2隐式引用捕获
	size_t v2 = 42;
	auto f2 = [&] {return v2; };
	v2 = 0;
	auto j2 = f2();
	cout << j2 << endl; // 0
}
void main()
{
	fcn1();
	fcn2();
	fcn3();
}

​

刘建杰
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 1
    评论
专栏目录
使用 Godot 游戏引擎为 Apple 的 visionOS 创建游戏和应用的平台
u012842807的专栏
04-20 1118
该游戏的特色是一张由图块组成的地图，以及一个从图块平移到图块以跟踪角色的摄像机。还有敌方怪物绕过障碍物来攻击你的角色。但是，如果您正在构建具有大量移动部件的东西，游戏引擎可以帮助您管理复杂的场景并避免重新实现常见的游戏系统。您将获得 Godot 编辑器的强大功能以及visionOS 出色的原生渲染功能，例如。，一款使用 GodotVision 制作的 VisionOS 游戏。粗略地说：Godot 是后端，RealityKit 是前端。，并将本机空间手势连接到 Godot 中的事件。创建游戏和应用程序。
c入门基础题（3）
最新发布
梦昼初
04-26 511
1、找出数组中最大元素的位置（下标值） 输入 多组测试，每组先输入一个不大于10的整数n 然后是n个整数 输出 输出这n个整数中最大的元素及下标值 样例输入 4 1 4 5 6 样例输出 6 3 #include<stdio.h> int main(){ int a[20]; int n,x=0,y,z,s,m,f; int i,j; while(scanf("%d",&n)!=EOF){ for(i=1;i<=n;i++){ scanf("%d",&y)
C++ 中lambda表达式的编译器实现原理
08-31
C++ 11加入了一个非常重要的特性——Lambda表达式。这篇文章主要介绍了C++ 中lambda表达式的编译器实现原理,需要的朋友可以参考下
C++-lambda闭包函数.pdf
02-28
c++ C++_lambda闭包函数.pdf
lambda：受Cherno的3D游戏引擎Hazel启发的游戏引擎
02-04
lambda：受Cherno的3D游戏引擎Hazel启发的游戏引擎
C++ Lambda Story
02-18
This book shows the story of lambda expressions in C++. You’ll learn how to use this powerful feature in a step-by-step manner, slowly digesting the new capabilities and enhancements that come with each revision of the C++ Standard. We’ll start with C++98/03, and then we’ll move on to the latest C++ Standards. • C++98/03 - how to code without lambda support. What was the motivation for the new modern C++ feature? • C++11 - early days. You’ll learn about all the elements of a lambda expression an
C++ Lambda Story - From C++98 to C++20.pdf
06-05
本书适⽤于所有喜欢了解现代 C++ 特性：Lambda 表达式 的 C++ 开发⼈员。 校阅历史 2019 年 03 ⽉ 25 ⽇ - 第⼀版上线！ C++ Lambda Story - From C++98 to C++20.md 1/1/2023 3 / 92 2020 年 01 ⽉ 05 ⽇ - 语法、更好的例⼦、措辞、IIFE 部分、C++20 更新。 2020 年 04 ⽉ 17 ⽇ - C++20 章节重写、语法、措辞、布局。 2020 年 04 ⽉ 30 ⽇ - 从 C++11、C++17 和 C++20 中的 lambda 派⽣ 2020 年 06 ⽉ 19 ⽇ - 主要更新： 改进了 C++03 章节，添加了有关标准库中的辅助函数对象的部分。 添加了有关如何操作的新部分从 C++14 章节中不推荐使⽤的 bind1stin 转换为现代替代⽅案。 C++11 和 C++17 章节中改进和扩展的 IFFE 部分 带有 lambda 技术列表的新附录 带有五⼤ lambda 功能列表的新附录，改编⾃博客文章 带有更新副标题的新标题图片 整本书的许多较⼩改进 ...
C++11：lambda表达式
Man9o
03-09 8117
通常lambda表达式用于封装一些传递给算法或异步函数的代码。C++11中引入了λ表达式，它可以用来定义一个**内联 (inline)**的函数，作为一个本地的对象或者一个参数。内联函数是一种编译器优化技术，它可以避免函数调用的开销，提高执行效率。λ表达式可以被编译器自动内联展开，从而减少函数调用的次数。但是，并不是所有的λ表达式都会被内联，这取决于编译器的实现和优化策略。
C++11：lambda表达式详细介绍
热门推荐
luoyayun361的专栏
03-15 1万+
前言 Lambda（匿名函数）表达式是C++11最重要的特性之一，lambda来源于函数式编程的概念，也是现代编程语言的一个特点。 优点如下： 声明式编程风格：就地匿名定义目标函数或函数对象，有更好的可读性和可维护性。 简洁：不需要额外写一个命名函数或函数对象，，避免了代码膨胀和功能分散。 更加灵活：在需要的时间和地点实现功能闭包。 概念及基本用法 lambda表达式定义了一个匿名函数，并且可以捕获一定范围内的变量。语法形式如下： [ capture ] ( params ) opt -> ret
【C++】 Lambda表达式详解
kinghzking的专栏
06-09 1981
仿函数的语法几乎和我们普通的函数调用一样，不过作为仿函数的类，都必须重载operator()运算符，仿函数与Lamdba表达式的作用是一致的。如果Lambda表达式的函数体只有一条语句，且该语句的返回值类型可以自动推导，则可以省略返回值类型和return关键字。记得去年立了一个重学C++新特性的flag，可是真的太忙了，大部分精力都花在全栈上了，今年开始看一些开源源码，发现各种奇怪的语法，根本看不懂，，它可以方便地定义一个匿名函数，从而简化代码的编写。，可以像函数一样被调用，也可以作为函数参数或返回值。
【C++】Lambda 表达式详解
宫瑞阳的博客
07-04 3773
Lambda表达式
【C】 初识C语言
努力学习C/C++
04-21 759
从本篇开始，带你从不会C语言到精通C语言。这篇是让大家对C语言有个初步的了解。下面的内容会拆分不同篇幅单独进行详细讲叙。数据类型变量、常量字符串转义字符注释选择语句循环语句函数数组操作符常见关键字define定义常量和宏指针结构体1.什么是C语言？C语言是一门面向过程的计算机编程语言，与C++、C#、Java等面向对象编程语言有所不同。C语言的设计目标是提供一种能以简易的方式编译、处理低级存储器、仅产生少量的机器码以及不需要任何运行环境支持便能运行的编程语言。
C++ WebServer的细节理解
我的博客
04-22 594
在非阻塞模式下，如果 I/O 操作不能立即完成（例如，因为没有数据可读 或 写缓冲区满），系统不会让调用进程阻塞等待，而是立即返回一个错误（通常为 EAGAIN 或 EWOULDBLOCK）。先查询文件描述符 fd 当前的标志，然后将 O_NONBLOCK 标志加入其中，并通过 F_SETFL 来更新文件描述符，最终实现将该文件描述符切换为非阻塞模式。这意味着，如果没有待处理的连接请求（即没有客户端尝试连接到服务器），accept() 会一直阻塞，直到有新的连接请求到达或发生其他特定条件（如超时）为止。
C++——初识模板
qq_74245477的博客
04-22 884
之前实现的数据结构，比如栈，我们为了便于修改存储的数据类型，通常使用typedef来重定义数据类型，但是这样有一个缺陷，会导致我们定义的栈存储的都是一种数据，如果同时需要两个栈，一个存储int，一个存储自定义类型，那么typedef就不管用了。比如：当用int类型使用函数模板时，编译器通过对实参类型的推演，将T确定为int类型，然后产生一份专门处理int类型的代码，对于字符类型也是如此。概念：函数模板代表了一个函数家族，该函数模板与类型无关，在使用时被参数化，根据实参类型产生函数的特定类型的版本。
C语言：贪吃蛇游戏（万字解读超详细）
2301_80655639的博客
04-20 1045
贪吃蛇这个游戏应该我们小时候都玩过吧我相信能够点进这个博客的应该都很熟悉这个游戏了如果对这个游戏不熟悉的可以网上查查怎么玩，这样才能对这个游戏有个清晰的认知该篇博客需要拥有C语言基础（对指针熟悉、会链表的使用）下面我们需要先学习一些C语言之外的东西认真坚持看完，我相信你一定能完成这个接近500行的C语言贪吃蛇项目该类型内部封装了两个成员，一个x，一个y，代表坐标我们可以将我们的控制台理解为一个平面坐标图横向正方向是x轴正方向，竖向负方向是y轴正方向。
C++中的抽象类
hh121386的博客
04-23 182
C++中的抽象类
CSAPP | Lab2-Bomb Lab详细解析
wangs29的博客
04-24 1246
邪恶的邪恶博士在我们班的机器上安放了大量的“二元炸弹”。二进制炸弹是一个由一系列阶段组成的程序。每个阶段都要求你在 stdin 上键入一个特定的字符串。如果你键入了正确的字符串，那么这个阶段就会被拆除，炸弹就会进入下一个阶段。否则，炸弹会通过打印“ BOOM 然后终止。当每个阶段都被拆除时，炸弹就会被拆除。我们要处理的炸弹太多了，所以我们给每个学生一个炸弹去拆除。你们的任务，你们别无选择，只能接受，就是在due date前拆除炸弹。祝你好运，欢迎加入拆弹小组！
掉落回弹问题（C语言）
m0_67184754的博客
04-22 349
【代码】掉落回弹问题（C语言）
项目——C++协程库
qq_44736340的博客
04-20 86
1。
c++14 lambda
10-14
C++14 引入了一些新的 lambda 表达式的特性，比如泛型 lambda、lambda 捕获初始化等。Lambda 表达式是一种匿名函数，可以在需要函数对象的地方使用，比如 STL 算法中的函数对象参数。 Lambda 表达式的基本语法如下： ``` [capture list] (params list) mutable exception-> return type { function body } ``` 其中，`capture list` 指定了 lambda 表达式所捕获的变量列表；`params list` 指定了 lambda 表达式的参数列表；`mutable` 关键字用于指定 lambda 表达式是否可以修改其所捕获的变量；`exception` 指定了 lambda 表达式可能抛出的异常类型；`return type` 指定了 lambda 表达式的返回类型；`function body` 是 lambda 表达式的函数体。 下面是一个简单的 lambda 表达式示例： ```c++ auto f = [](int x, int y) -> int { return x + y; }; int z = f(1, 2); // z = 3 ``` 在这个示例中，我们定义了一个 lambda 表达式 `f`，它接受两个 `int` 类型的参数，并返回它们的和。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

刘建杰

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值