简介
环境: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
}