# Blender Python: Custom Enum Flags

I've been trying to set up some custom enum flags. In my situation, there are two variables that I want to share the same enum type setup. So I would like the flags to be interchangeable between them. This is how I currently have it set up. For some reason, the controls do not show up when I draw them after moving the items into their own definition. They seemed to be fine when they defined their own items. Can anyone see where I'm doing this wrong? Or does a UI element just fail to draw when it uses "external" enum items?

def FBXG_Mode(self,context):
items=[ ('GA', "Asset", "Game Asset"),
('LP', "Low", "Low Poly"),
('HP', "High", "High Poly"),
]
return items

bpy.types.collection.FBXGSpawner : EnumProperty(
name="File Spawners",
options={'ENUM_FLAG'},
items=FBXG_Mode,
description="Info",
)

bpy.types.object.FBXGBlocker : EnumProperty(
name="Object Blockers",
options={'ENUM_FLAG'},
items=FBXG_Mode,
description="Info",
)

• Consult the docs docs.blender.org/api/blender2.8/… Using ENUM_FLAG allows multi-select of enum items and requires the item number to be set. Is this what you want? to for example have ability to mark item as both low and high poly? (Probably not). Appears there is no need for the dynamic items method here either, could define the items list items = [(a, b, c), ..] then in defining prop items=items – batFINGER Sep 8 '19 at 2:49
• Yes, they are intended to allow toggling all three states independently. For example, an object can be exported as both an asset and low poly for baking. I'm having trouble understanding your advice. I'm also not clear on what the item "number" would represent? The number of enum entries? I'm very new to python, so its likely my lack of knowledge. My goal here is to just have the two variables have interchangeable flags. So, for example, I can use a flag I detected enabled for collection-spawners in a function that activates object-blockers, without having to manually translate. – Robert Sep 8 '19 at 3:14
• Consult the docs docs.blender.org/api/blender2.8/… items = [(identifier, name, description, icon,  number ), ...]. – batFINGER Sep 8 '19 at 3:41
• Wow, I didn't notice the little scrollbars for each entry until just now. All this time, I assumed the docs only explained the first few elements and moved on. – Robert Sep 8 '19 at 14:44
• Unfortunately, the docs didn't help much even after finally finding the description of the numbers attribute. I don't understand why I would need a unique identifier for a variable that already has one? I tried setting the number attribute of both EnumProperty entries. I tried 7 (bit 1, 2, and 3 all turned on), 8 (the next available bit), and 16 (for kicks). Nothing seems to change. My properties are still invisible with no errors. I appreciate your extreme efforts, though – Robert Sep 8 '19 at 15:03

The reason my enums were not showing up was due to me changing my property definitions to use the ':' operator instead of '=', such as..

bpy.types.collection.FBXGSpawner : EnumProperty(


bpy.types.collection.FBXGSpawner = EnumProperty(


I read that we are supposed to use the ':' operator in Blender 2.8+. If this is the case, maybe someone can help point out what else I may have done wrong to prevent properties from drawing. One of my simple drawing functions..

# draw object settings
def draw(self, contex):
aobject = bpy.context.object
layout = self.layout
box = layout.box()
con = box.row()
con.prop(aobject, "MergeWith")


If anyone knows the reason they were not rendering, post and I will accept it as the answer. Thanks!

Edit: After playing around with the code, I believe this is (at least close) to the correct way to set up a custom enum:

class FBXG_MappingPanel(bpy.types.Panel):

# define enum flags
EnumTypes=[ ('GA', "Asset", "tooltip"),
('LP', "Low", "tooltip"),
('HP', "High", "tooltip"),
]

# define enum variable
EnumVariable= bpy.props.EnumProperty(
name="Title",
options={'ENUM_FLAG'},
items=EnumTypes,
description="tooltip",
)

# define drawing section
def draw(self, context):

# draw
layout = self.layout
row = layout.row()
row.prop_enum(self, "EnumVariable", 'GA', text='Asset')
row.prop_enum(self, "EnumVariable", 'LP', text='Low')
row.prop_enum(self, "EnumVariable", 'HP', text='High')


The biggest mistake I made was not realizing that you need an individual prop_enum() call for each individual flag allowed to be selected. I was trying to use it as a single call. If anyone notices any issues here, that would be appreciated. Also, if anyone can help newcomers understand what the number property is intended for and what purpose it serves, that would also be great. Thanks!

• The : is for a type annotation when declaring the properties (you want to tell Python that your variable is supposed to be of a certain type), not when you want to perform an assignment like here to bpy.types. See: python.org/dev/peps/pep-0526 wiki.blender.org/wiki/Reference/Release_Notes/2.80/Python_API/… in Section Class Property Registration – Robert Gützkow Sep 8 '19 at 17:31
• Ugh, don't declare properties in a panel class. – brockmann Sep 8 '19 at 17:41
• Here you go: pastebin.com/yNKaF1V5 (used the template I suggested yesterday from here: blender.stackexchange.com/questions/57306/…) Note: Usually you want to use an ExportHelper in order to display the properties as part of the Export Dialog rather than using an extra panel. In this case you have to declare all properties within the operator class, see my example 2 days ago: blender.stackexchange.com/a/150922/31447 or have a look into Templates > Python > Operator File Export. – brockmann Sep 8 '19 at 18:15
• Sorry, I'm not sure what you're pointing out to me? Is the point to not define properties inside of panel classes? I was just trying to keep the example code as simple as possible. I'm using PropertyGroup in my code, and adding/deleting the groups in register() and unregister(). – Robert Sep 8 '19 at 19:23
• Yeah, just try to help :) Pointing you to a "correct" version I made out of your code, see the pastebin. And yes, bad example. Defining properties in a panel is no good... Also if you want to get rid of the warnings in the console (when running your code), use annotations :, correct version is: enum_variable : bpy.props.EnumProperty(... (notice: lower case variables). And the main question is: Why you want to display the properties in a panel somewhere? You can define your properties in the operator and display them as part of the File Dialog. @Robert – brockmann Sep 8 '19 at 19:57