简介

环境：UE 4.25

位掩码（Bitmask）

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

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

位操作

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

蓝图位掩码

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

创建位掩码

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

创建一个蓝图枚举，并将Bitmask Flags设为true

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

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

使用方式示例

• 打开Flag： • 关闭Flag： • 判断是否包含Flag：

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 }