UNREAL 笔记

已于 2024-09-09 11:49:52 修改
阅读量229 收藏
点赞数 3
分类专栏： 游戏 编程 文章标签： 笔记 游戏引擎 unreal engine
于 2024-05-17 16:18:34 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/kenight/article/details/139007073
版权

函数返回引用

  • 函数返回引用与返回指针本质一样都是返回地址, 否则函数将返回数据的拷贝
    ps: 不要将局部(函数中)创建的引用作为函数返回值
// 全局变量
int val = 10;

// 定义函数返回引用
int& RetValRef()
{
	return val;
}

// 将函数作为左值使用时(使用引用接收返回值),返回地址
// 本质上发生 int* const v1 = &val;
int& v1 = RetValRef(); 
// 引用 v1 作为左值可修改 val 的值
v1 = 20;

// 将函数作为右值使用时,返回该地址指向的值
// 本质上发生调用解引用 *val 对 v2 进行赋值
int v2 = RetValRef();
  • UFUNCTION 和 DELEGATE 在蓝图中返回 UStruct 只能使用返回引用或值
  • UFUNCTION 和 DELEGATE 在蓝图中返回 UClass 可以返回裸指针
  • 多播委托在返回结构体引用时, 必须加 const
// 返回 * 将报错, Inappropriate '*' on variable of type 'FLevelUpInfo'
UFUNCTION()
FUStructType* GetStructInfo(int32 XP); 

// 返回引用 OK
UFUNCTION()
FUStructType& GetStructInfo(int32 XP);

 // UClass 返回 * OK
UFUNCTION()
AActor* GetEnemyActor();

// NewValue 如果不加 const 要报错, 但 MyActor 返回 * OK
DECLARE_DYNAMIC_MULTICAST_DELEGATE_ThreeParams(FSomeDelegate, const FAttributeInfoData&, Data, AActor*, MyActor, const FVector&, NewValue);

函数参数是引用

  • 非 const 参数会在蓝图中作为输出 Pin
// 参数 TargetLocation 将作为输出 Pin
UFUNCTION(BlueprintCallable)
void SpawnProjectile(FVector& TargetLocation);
  • const 参数会在蓝图中作为输入 Pin
// 将 TargetLocation 定义为 const, 将作为输入 Pin, 但 TargetLocation 不能在函数体中修改
UFUNCTION(BlueprintCallable)
void SpawnProjectile(const FVector& TargetLocation);

// 或使用 UPARM(ref) 宏, 使用该宏可以在函数体中修改 TargetLocation
UFUNCTION(BlueprintCallable)
void SpawnProjectile(UPARM(ref) FVector& TargetLocation);

修改函数返回值 / 参数显示名称

  • 使用 UPARAM 宏可修改函数参数或返回值的显示名称
UPARAM(DisplayName = "People Name") FString GetName(UPARAM(DisplayName = "Identifier") float id);

关于 UPARAM 标识符的更多用途

  • 推荐使用引用参数作为函数返回值
// 在蓝图节点中输出 Pin 与函数返回值效果一样, 同时使用引用参数还可以返回多个返回值
UFUNCTION(BlueprintCallable)
void GetOverlapActors(TArray<AActor*>& OutActors);

虚幻中的指针

  • 对于智能指针 TSharedPtr, TWeakPtr, and TUniquePtr 不能用于 UObject (UCALSS) 类型, UObject 使用虚幻自己的反射系统管理
  • 什么时候用 raw pointer
    一般函数局部变量与函数返回值使用 raw pinter, 超出范围时局部变量本身自动销毁(不是指向的内存哈)
  • 什么时候用 TObjectPtr
    类的成员变量是 UObject 类型时可使用 TObjectPtr 替代 raw pointer, 注意:不管哪种指针必须标记 UPROPERTY 来让该指针被虚幻垃圾回收跟踪. 如果不想把变量标记为 UPROPERTY 可以使用 TWeakObjectPtr (不是 TWeakPtr), 它所指向的 UObject 被销毁时会置空而不会悬挂.
  • 什么时候用引用
    确定变量有值; 函数形参; 函数返回值; 这几种情况可偏向使用引用
  • 什么时候用智能指针
    不能是 UObject 类型. 所以 USTRUCT 很适合使用. USTRUCT 不属于 UObject 体系, 不由垃圾回收管理,但它可以使用智能指针提供的垃圾回收管理来防止 UObject 被销毁时产生的 USTRUCT 指针悬挂

引擎中的对象处理

  • 不再被引用或已被显式标记为销毁的 UObject 将被垃圾回收机制定期清除
  • 只有标记了 UProperty 的 AActor 或 UActorComponent 的指针变量以及容器中存储的指针,在清理时会自动赋空值 (= nullptr)
  • 对于未标记 UProperty 的原始指针,它引用的 UObject 被销毁时不会被赋空值,将出现悬挂指针.
  • UStruct 被当作数值类型处理并且不会垃圾回收, new 出来的 UStruct 可使用智能指针管理回收

IsValid

IsValid 既判断 nullptr 又判断是否准备被销毁(等待垃圾回收)

// Enemy 有可能会被销毁时使用 IsValid
if(IsValid(Enemy)) {...}
// 如果只是简单的 Proerty 等可使用
if(MaterialInstance) {...}

C++ 中定义接口

  • 对于无返回值的接口可以在 Event Graph 中实现 (类似 custom event),对于有返回值的接口需要通过 Override Function 来实现.
  • 在蓝图中调用接口时可像静态函数一样调用 (不需要Cast),如果 Target 未实现该函数则会略过该函数的调用
/**
 * 定义为 BlueprintImplementableEvent 的函数
 * 表明该方法将只能在蓝图中实现,不能在 C++ 中实现
 * 函数不能加 virtual,会导致编译报错
 * 使用 const 将引用参数变更为输入 PIN (否则会作为输出 PIN)
 * 接口中的 BlueprintCallable 表明该函数将作为静态函数可在蓝图中直接调用
 */
UFUNCTION(BlueprintImplementableEvent, BlueprintCallable)
void DoMotionWarp(const FVector& FacingTarget);

/**
 * 定义为 BlueprintNativeEvent 的函数
 * 表明即可在蓝图中实现, 也可在 C++ 中定义默认实现
 * 函数不能加 virtual,会导致编译报错
 * 在 C++ 中实现该函数需要加上 _Implementation
 */
UFUNCTION(BlueprintNativeEvent, BlueprintCallable)
void SetCombatTarget(AActor* InCombatTarget);

在 C++ 中调用 BlueprintNativeEvent 接口,需要调用 Native C++ 实现的版本

// 判断是否实现接口
if (Actor->Implements<UCombatInterface>())
{
	// 调用 Native C++ 的实现
	if (!ICombatInterface::Execute_IsDead(Actor))
	{
		OutActors.AddUnique(Actor);
	}
}

在接口中使用 BlueprintNativeEvent 返回引用时发现报错(返回类型不匹配)

// 报错
UFUNCTION(BlueprintNativeEvent, BlueprintCallable)
TArray<FTaggedMontage>& GetAttackMontages();

// 改这样实现
UFUNCTION(BlueprintNativeEvent, BlueprintCallable)
void GetAttackTaggedMontages(TArray<FTaggedMontage>& OutTaggedMontages);

DELEGATE 小坑

  • DYNAMIC Delegate 参数需要加名称
/* DYNAMIC delegate 参数需要加名称 */
DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnFloatValueChangedSignature, float, Value);
  • 非 DYNAMIC Delegate 参数不能加名称, 否则报错 ‘参数过多’
/* 推荐参考官方定义方式 */
DECLARE_MULTICAST_DELEGATE_OneParam(FOnFloatValueChangedNative, float /* NewValue */);

DYNAMIC Delegate 对绑定对象保持弱引用关系, 对象销毁后不再调用绑定的函数. 但注意发现在 UserWidget Remove from parent 后再次重新绑定会造成重复的累积绑定,原因可能是未被立即回收,需要手动调用 Unbind 函数

字符串

  • TEXT()宏(注意不是FText)是根据环境判断是否为字符串前面加 ‘L’, 如 TEXT(“AB”) 相当于 L"AB", 又叫宽字符串
  • 字符串前面加 ‘L’ 的意思是将字符串作为 Unicode 编码方式解析, 否则作为 ANSI 编码来解析. Unicode 每个字符占两个字节, ANSI 占一个且内容少容易乱码

常用 FunctionLibrary

// 创建 AudioComponent 并挂载到指定组件上, 跟随物体并持续发声
UGameplayStatics::SpawnSoundAttached
// 在指定位置播放声音, 一次性音效
UGameplayStatics::PlaySoundAtLocation
// 在指定位置创建 NiagaraComponent
UNiagaraFunctionLibrary::SpawnSystemAtLocation
// 额外的 DrawDebug 方法
UKismetSystemLibrary::DrawDebugArrow
// 各种物理检测函数
UKismetSystemLibrary::SphereTraceSingle

查看 Graph Node 源码

  • 材质节点源码
    UnrealEngine\Engine\Source\Runtime\Engine\Private\Materials\MaterialExpressions.cpp
Unreal网络架构
zjjwch的博客
03-11 3134
综述 多玩家游戏与共享现实有关：所有的玩家都感觉他们都在同一世界里，在这个世界里以不同视角看着相同的事件发生。最初的多玩家游戏是双玩家的调制解调器游戏，以DOOM为代表，而现在多玩家游戏已经进化成为大型的、持久的、交互形式更加自由的游戏，如Quake2，Unreal和Ultima Online，共享现实背后的技术已经有了巨大的进步。 从一开始就实现网络！ 需要实现的一件重要事
Unreal源码笔记-000-从启动到打开项目
NONElgh的博客
04-06 1011
LaunchEngineLoop.cpp 偶然发现LaunchEngineLoop.cpp，遂进行研究，研究所得如下： Overview 文件路径 Engine\Source\Runtime\Launch\Private\LaunchEngineLoop.cpp 特点 某些关键的全局变量在这个文件的方法中被创建： GEditor GEngine GUnrealEd GShaderCompili...
UPARAM(ref)的含义
haisong1991的博客
04-06 1573
用于将&amp;参数标记为传入参数static bool Sort(UPARAM(ref) TArray&lt;UObject*&gt;&amp; array_to_sort, TArray&lt;UObject*&gt;&amp; array_to_sort_ref);
UE4里的全局变量，全局函数，便于工程里其他模块代码访问，以及Blueprint的访问
山楂卷的专栏
02-24 3115
原文链接：http://blog.csdn.net/u010153703/article/details/380626271. 单例Unreal Engine的wiki上，Rama给了一个教程，教大家如何存储不常改变的全局数据，便于运行时从任何cpp或者Blueprint访问之。https://wiki.unrealengine.com/Global_Data_Access,_Data_Stora...
(UE4 4.20 )UE4的GC(垃圾回收)编程规范
qq_29523119的博客
01-12 1万+
UObject系统的GC UPROPERTY 引用 当我们在一个UObject类声明各种继承UObject的 变量时，得加UPROPERTY(), 这个可以让UE4帮我们自动管理UObject的垃圾回收(引用计数)。UPROPERTY不仅仅用于反射变量到编辑器上编辑，也涉及UObject变量的GC。 如下面所示： UCLASS(config=Game) class AMyProje......
ue4 关于ufunction 函数 参数 用引用 UPARAM(ref)
opk8848的专栏
03-15 4122
uparam参数 必须放在第一个参数位置
UnrealEngineNote:Unreal Engine 笔记
04-12
UnrealEngineNote （一）理解基础 基础概念和技巧。无论出于什么原因，只要你想掌握虚幻引擎，都推荐你读一读。 本部分介绍了虚幻引擎的基本原理及其工具，包括虚幻编辑器界面、引擎的各个基本模块、以及其他重要...
Unreal源码笔记-001-计算FPS
NONElgh的博客
02-26 537
路径 Engine\Source\Runtime\Engine\Public\UnrealEngine.h 代码 // Calculate the average frame time by using the stats system. inline void CalculateFPSTimings() { extern ENGINE_API float GAverageFPS; exter...
UnrealEngine3源码分析笔记
12-20
UnrealEngine3 源码分析笔记 UnrealEngine3 源码分析笔记是基于虚幻 3 引擎源码的分析，主要讲解引擎的主要技术和设计思路。本文将以 Core 库为主，涵盖对象管理、内存管理、脚本编译、引擎启动流程等方面。 一、...
【学习笔记】Unreal（虚幻）4引擎入门（三）
野生C++程序员
06-08 2272
UE4入门学习笔记第三弹
【学习笔记】UE4——TSoftClassPtr＜T＞ ptr/TSoftObjectPtr＜T＞ ptr
qq_45777198的博客
08-06 6073
前言 本文章仅作为个人学习笔记，本章中包含错误、过时、遗漏知识点等问题，因此请读者发现上述问题请谅解并且欢迎指正。本文更新时间：2020-8-6 引用 虚幻4官方中文文档： TSoftClassPtr: https://docs.unrealengine.com/en-US/API/Runtime/CoreUObject/UObject/TSoftClassPtr/index.html TSoftObjectPtr https://docs.unrealengine.com/en-US/API/Run
Unreal Engine 4 的C++智能指针
Kingtem的博客
05-29 3575
介绍       在UE4中可以使用C++的智能指针，虽然UE4自身已经对UObject及其派生对象有了较好的垃圾回收机制，但开发者还是会遇到使用指针管理对象的时候。我对其使用方法和类型做了一些简单总结。内智能指针的主要类型分为：TSharedPtr, TSharedRef, TWeakPtr, TAutoPtr。其特性主要总结为几点：类似常规C++指针；可防止内存溢出；有线程安全机制；可虚拟化任...
UE4 全局变量的应用(蓝图)
Louts.
10-26 1万+
4.20 1，创建全局变量，命名为MyGameInstance 2，创建一个变量，命名为MyB 3，在项目设置中 搜索GameInstence，并选中创建的全局变量 4，在蓝图里调用全局变量 5，成功打印 ...
UE4 创建关卡全局变量
Deveuper的博客
09-08 7077
创建关卡全局变量(关卡加载，不同关卡间的数据传递) 1.创建蓝图 ,继承GameInstance。在其中创建变量Life 2.在ProjectsSetting中，Map&Modes中，最后一项，选择刚刚创建的蓝图 3.在关卡蓝图1中编辑，获取GameInstances变量 4.在关卡蓝图2中编辑，获取刚才设置的GameInstances...
[UE4]TSubobjectPtr和C++传统指针的区别
玄冬Wong
03-11 962
  主要有以下区别（1和2的前提条件要满足：指针所在的class必须是UObjcct的子类）：   1，TSubobjectPtr指针是UE4 API里面为C++传统指针(Native C++ Pointer)提供的智能指针。 当指针指向的对象被Destroy以后，TSubobjectPtr会被自动置零，C++传统指针需要你手动置NULL。   2，如果TSubobjectPtr加...
UE4使用GameInstance设置全局变量(不同关卡、类之间数据传递)
蒙双眼看世界
03-12 1万+
UE4使用GameInstance设置全局变量
一个 Git 库内管理多个子项目
热门推荐
MaiYo_
09-05 2万+
1.先下载 Git 客户端 (官网) 2.创建项目文件夹与.gitignore 就这个造型 注意 .gitignore 文件的写法，如： /bin 只能忽略根目录下 bin 文件夹 bin 与 bin/ 则可忽略所以子项目下 bin 文件夹 3.使用 Git 客户端在该文件夹 (spring-security-example) 下创建本地仓库 下一步 4
VS Code 版本控制
MaiYo_
06-09 1万+
1.安装 Git: sudo apt-get install git 全局配置 git config --global user.name "YourName" git config --global user.email "YourName@gmail.com" 查看配置 git config user.name git config user.email 或 git c
Spring boot 处理 error 的套路
MaiYo_
08-18 1万+
参考官方文档： Spring boot 处理 error 的基本流程： Controller -> 发生错误 -> BasicErrorController -> 根据 @RequestMapping(produces) 判断调用 errorHtml 或者 error 方法 errorHtml -> getErrorAttributes -> ErrorViewResolver
ue5 gas 学习笔记
最新发布
07-14
UE5是Unreal Engine 5的简称，是一款广泛应用于游戏开发和虚拟现实领域的强大游戏引擎。UE5 Gas是其中的一个特性，主要用来模拟气体、烟雾和液体的行为。 UE5 Gas引擎在虚拟空间中实现了基于物理的气体模拟，可以帮助开发者创造出逼真的烟雾、雾气、火焰等气体效果。它能够模拟气体的流动、燃烧、扩散和散射等特性，让游戏中的气体场景更加真实感人。 UE5 Gas的运作原理是通过对气体分子进行模拟计算来实现。它使用了基于压力和密度的数学方程，以及流体动力学算法，来模拟气体分子之间的相互作用。通过控制气体分子的速度、密度和位置，可以模拟出气体的各种行为，如烟雾的向上升起、火焰的蔓延等。 使用UE5 Gas可以实现一些特殊效果，比如通过控制烟雾的密度和颜色，可以营造出神秘的氛围；通过模拟液体的流动和散射特性，可以实现逼真的水面效果。开发者还可以调整气体的渲染和交互参数，以满足不同场景的需求。 UE5 Gas的学习需要一定的计算机图形学基础和编程知识。开发者可以通过阅读官方文档、参加培训课程和实践项目来学习。掌握UE5 Gas后，开发者可以创作出更加逼真、震撼的游戏画面，提升游戏的视觉效果，为玩家带来更好的游戏体验。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值