UE4中的位掩码(Bitmask)的介绍和使用

简介

环境:UE 4.25

位掩码(Bitmask)

位掩码是一串二进制数(比如子网掩码),每一位是一个Flag,表示一种状态,一个32位的位掩码就可以表示32种状态的组合。如果期望使用多个bool变量共同作用与同一个地方,就可以使用位掩码来实现。

  • 使用位掩码是为了控制一组bool变量,用一个变量就可以表示丰富的状态。
  • 使用枚举是为了给每个Flag命名,增强可读性。

位操作

由于位掩码是使用二进制来表示一个Flag,所以最常使用的操作就是位运算:与(&)、非(~)、或(|)、异或(^)、左移(<<)和右移(>>)。
bit

蓝图位掩码

蓝图创建位掩码可查看官方教程

创建位掩码

总结一下过程可分为3步:

  1. 创建一个蓝图枚举,并将Bitmask Flags设为true
    1

  2. 在蓝图中创建一个整型变量,设置为Bitmask,最多支持32个Flags
    2

  3. 使用它
    3
    其中常用的操作为:
    • 隐式转化为bool:判断Bitmask中是否含有Flags。
    • 按位非(Bitwise NOT):得到一个相反的Bitmask。
    • 按位与(Bitwise AND):得到一个含有共同Flags的Bitmask。
    • 按位或(Bitwise OR):得到一个含有所有Flags的Bitmask。

使用方式示例

• 打开Flag:
open
• 关闭Flag:
close
• 判断是否包含Flag:
if

C++位掩码

在C++中使用位掩码有更大的自由度。可以使用int32、int64、uint32等表示掩码,而蓝图只支持int32。同时,表示Bitflags的枚举类型也可以使用uint32、uint64等,而蓝图只支持uint8。
Bitmask常用的操作(变量作为示范):

	//int32 MyBitmask = 3;
	//int32 MyFlag = 1;
	MyBitmask |= MyFlag; //打开Flag
	MyBitmask &= ~MyFlag; //关闭Flag
	if (MyBitmask & MyFlag) { /*Do something*/ }//判断Flag是否打开

方式一

可以利用左移操作设置枚举值,使得枚举变量对应的值与它的Bitmask的Flag值是一样的。

UENUM(meta = (Bitflags))
enum class EMyTypeEnum :uint32
{
	Type1 = (1 << 0),
	Type2 = (1 << 1),
	Type3 = (1 << 2),
	Type4 = (1 << 3),
	Type5 = (1 << 4),
	Type6 = (1 << 5)
};
	UPROPERTY(EditAnywhere, BlueprintReadWrite,meta = (Bitmask,BitmaskEnum = "EMyTypeEnum"))
		int32 MyTypeBitmask;

判断Bitmask中是否包含枚举对应的Flag(直接转化即可得到Flag值):

	if (MyTypeBitmask & static_cast<uint32>(EMyTypeEnum::Type2))
	{
		//Do something
	}

方式二

如果需要同时在C++和蓝图中都获得良好的体验,则需要添加函数或宏来获得枚举对应正确的Bitmask值。
使用宏从正常顺序的枚举值得到Flag值:

#define TOFLAG(Enum) (1 << static_cast<uint8>(Enum))

蓝图和C++都可以使用该枚举作为Bitflags:

UENUM(BlueprintType, meta = (Bitflags))
enum class EMyTypeEnum :uint8
{
	Type1, //= 0
	Type2, //= 1
	Type3, //= 2
	Type4, //= 3
	Type5, //= 4
	Type6  //= 5
};
	UPROPERTY(EditAnywhere, BlueprintReadWrite,meta = (Bitmask,BitmaskEnum = "EMyTypeEnum"))
		int32 MyTypeBitmask;

判断Bitmask中是否包含枚举对应的Flag(使用宏得到Flag值)

	if (MyTypeBitmask & TOFLAG(EMyTypeEnum::Type2))
	{
		//Do something
	}

版权声明:本文为weixin_43844254原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明。