UE4中C++编程（一）

一： C++工程和Gameplay框架

GameInstance

它适合放置独立于关卡的信息，比如说显示UI。

GameMode

表示游戏玩法， 包含游戏进行的规则和胜利条件等等信息，游戏模式是和关卡绑定在一起的，一个关卡只能有一个游戏模式，但是一个游戏可以有多个关卡。它通常和记录规则的GameState组合在一起。

Pawn/Character

Pawn指的是活动的游戏主体。Character是指可移动的，有碰撞的人物。其信息一般记录在PlayerState中。

PlayerController

虚幻抽象出来的一个层，用于控制Pawn行动。

需要注意的是：在新建工程文件夹中，当需要更新版本时，只需要上传“Content“、”Config“、”Source“、”Binuries“以及sln解决方案文件和UE project文件。

二：UE4基本类型与容器

基本类型：

bool大小:1 byte—— 1 byte=8 bit 取值范围:true或者false

uint8大小: 1 byte——子主题1   取值范围0~255

int32大小:4 byte—— int 取值范围-2^32 ~+2^32-1

float大小:4 byte        取值范围: 2^32 ~+2^32-1

int64大小:8 byte       取值范围-2^64 ~+2^64-1

FNames大小:12 byte    用途:FNames不区分大小写。它们为不可变,FName无法被操作。FNames的存储系统和静态特性决定了通过键进行FNames的查找和访问速度较快。FName子系统的另一个功能是使用散列表为FName转换提供快速字符串。

FString大小:12 byte     与FName和FText不同，FString可以与搜索、修改并且与其他字符串比较。不过，这些操作会导致FString的开销比不可变字符串类更大。这是因为FString对象保存自己的字符数组，而FName和FText对象保存共享字符数组的指针，并且可以完全根据索引值建立相等性。

FText大小:24 byte        一般用作显示和文本本地化

Fvector  三维向量

FVector2D  二维向量

Frotator       Pitch是围绕Y轴旋转，也叫做俯仰角；Yaw是围绕Z轴旋转，也叫偏航角；Rol是围绕X轴旋转，也叫翻滚角

容器：1、单个变量2、数组3、集合4、映射

需要注意的是：对于变量的定义，分为两种类型：一种使用默认数据类型，如bool bTestBoolean，一种是使用C++的位域模式，如 uint8 bTestB:1。使用位域可以节省内存空间。

三：UE4反射常用的宏UPROPERTY和UFUNCTION

反射数据描述了类在运行时的内容。这些数据所存储的信息包括类的名称、类中的数据成员、每个数据成员的类型、每个成员位于对象内存映像的偏移（offset），此外，它也包含类的所有成员函数信息。

在UE4反射机制中，具体来看，对于一个类（UClass），我们可以获得这个类的所有属性和方法，而对于一个类对象（UObject），我们可以调用它所拥有的方法和属性，前提是这些属性和方法被纳入到UE4的反射系统。

UPROPERTY

EditAnywhere

在编辑中可见。且可编辑

EditDefaultsOnly

只在类默认设置中可见

EditInstanceOnly

可通过属性窗口进行编辑，但只能在实例上进行，不能在原型上进行

VisibleAnywhere

在编辑中可见，且不可编辑

BlueplptReadOnly

蓝图只读

BlueprintReadWrite

蓝图可读可写

UFUNCTION

BlueprintCallable

此函数可在蓝图或关卡蓝图图表中执行。

BlueprintPure

此函数不对拥有它的对象产生任何影响，可在蓝图或关卡蓝图图表中执行。

BlueprintlmplementableEvent

需要在蓝图里面重载

BlueprintNativeEvent

此函数旨在被蓝图覆盖掉，但是也具有默认原生实现。用于声明名称与主函数相同的附加函数，但是末尾添加了lmplementation,是写入代码的位置。如果未找到任何蓝图覆盖，该自动生成的代码将调用Implementation方法。

CalllnEditor

可通过细节(Details) 面板中的按钮在编辑器中的选定实例上调用此函数。

元数据说明集：UPROPERTY(..., meta=())

举例：UPROPERTY(EditAnywhere, meta=(ClampMin=”10”, ClampMax=”100”))，表示下面定义的变量在10~100之间。

四： UE4类型的枚举UE4类型的结构体

先讲一下UE4中的命名规范，

Axxxxx 表示继承自Actor类

Uxxxxx 表示继承自Object类

Fxxxxx 表示C++中自己创建的

Exxxxx 表示枚举类型

Ixxxxx 表示接口类型

Sxxxx 表示Slate

枚举定义方式：

UENUM(BlueprintType)

enum EcustomColorType   //或者enum class EcustomColorType :uint8

{

  RED,

  BLUE,

  YELLOW

};

结构体定义方式：

USTRUCT(BliueprintType)

Struct FtestStruct

{

  GENERATED USTRUCT BODY()

  Int32 ss;

}

五： Aactor、Component、Uobject

Aactor、Component：汽车与轮子的关系

Uobject：四大功能：反射、垃圾回收（GC）、序列化、COD（class object default）

六：基本类型转换

{
//FString To FName
FString Str = TEXT("TestString");
FName Name = FName(*Str);
//FName To FString
FString TargetFString = Name.ToString();
}

{
//std::string to FString
std::string stdStr = "TestString";
FString MyStr(stdStr.c_str());

//FString To char*
char* c = TCHAR_TO_UTF8(*MyStr);
// FString to std::string
std::string TargetString(c);

}

{
//FString to Int32
FString Str = TEXT("TestString");
int32 i = FCString::Atoi(*Str);
//or
i = atoi(TCHAR_TO_UTF8(*Str));

// FString to float
int32 f = FCString::Atof(*Str);
//or
f = atof(TCHAR_TO_UTF8(*Str));

//FString To bool
bool bNewbool = Str.ToBool();

// Int32 to FString
FString TStr = FString::FromInt(123);
// float to FString
FString TStr1 = FString::SanitizeFloat(36.23f);
// bool to FString
int32 b = true;
FString Out= b ? TEXT("true"): TEXT("false");
}
{
//FString to TCHAR*
FString Str1(TEXT("TestString"));
const TCHAR* MyTChar = *Str1;

//FString to FText
FText MyText = FText::FromString(Str1);

//FText to FName
FName Name = FName(*MyText.ToString());

//FName to FText
FText MyText1 = FText::FromName(Name);

}
{
//FString To TArray<uint8>

FString Str = "Hello UE4";//原数据

TArray<uint8> outDataArray;//目标数据

TCHAR* CharData = Str.GetCharArray().GetData();
int32 Len = FCString::Strlen(CharData);
for (int i = 0; i < Len; i++)
{
uint8* dst = (uint8*)TCHAR_TO_UTF8(CharData);
CharData++;
outDataArray.Add(*dst);
}
//FString To TArray<uint8>
FBase64::Decode(Str, outDataArray);

//TArray<uint8> To FString
const std::string cstr(reinterpret_cast<const char*>(outDataArray.GetData()), outDataArray.Num());
FString  MyStr1(cstr.c_str());

//TArray<uint8> To FString
FString DestStr = FBase64::Encode(outDataArray);

}
{
//枚举转字符串
enum ETempEnum
{
One,
Two,
Three,
};
{
//通过枚举类型的名字找到对应枚举类型的COD class object defalut
const UEnum* EnumPtr = FindObject<UEnum>(ANY_PACKAGE, TEXT("ETempEnum"), true);
if (EnumPtr)
{
FString str = EnumPtr->GetNameStringByIndex(ETempEnum::Two);
}
}
//字符串转枚举
{
//通过枚举类型的名字找到对应枚举类型的COD class object defalut
const UEnum* EnumPtr = FindObject<UEnum>(ANY_PACKAGE, TEXT("ETempEnum"), true);
if (EnumPtr)
{
ETempEnum OutEnum= (ETempEnum)EnumPtr->GetIndexByNameString(TEXT("Three"));
}
}
}
//额外补充
{
//FString To Md5
FString String("sdsafasfasf");
FMD5::HashAnsiString(*String);

// FString To Sha1
FSHA1 Sha1Gen;
Sha1Gen.Update((unsigned char*)TCHAR_TO_ANSI(*String), FCString::Strlen(*String));
Sha1Gen.Final();

FString Sha1String;
for (int32 i = 0; i < 20; i++)
{
Sha1String += FString::Printf(TEXT("%02x"), Sha1Gen.m_digest[i]);
}

}