https://github.com/friedererdmann/blender_menus
A simple menu generator for the Blender UI system
https://github.com/friedererdmann/blender_menus
blender blender-addon blender-python
Last synced: 9 months ago
JSON representation
A simple menu generator for the Blender UI system
- Host: GitHub
- URL: https://github.com/friedererdmann/blender_menus
- Owner: friedererdmann
- License: mit
- Created: 2020-06-09T15:28:47.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-06-09T20:48:27.000Z (about 6 years ago)
- Last Synced: 2025-02-02T03:23:47.031Z (over 1 year ago)
- Topics: blender, blender-addon, blender-python
- Language: Python
- Size: 75.2 KB
- Stars: 18
- Watchers: 3
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Blender Menus
A simple menu generator for the Blender UI system
## Testing
Throw into your addon folder, activate the addon (`blender_menu_structure` or "Dynamically created Blender Menu" in the UI) - see the menu!
## Extending the menu
You can very simply just extend the dictionary `menu_hierarchy` if you just want to use the system as is.
### Menu Hierarchy
* ---: Dashes become separators (regardless how many you use)
* "menu" key is how we put in a submenu (as a dictionary value)
* "operator" becomes an operator
* Menus and Operators accept icons (either by Blender keyword or as png from the icon folder)
* Operators accept tooltips
### Functions and Parameters
Your menu entries can provide a function, but no parameters. We provide an example of using partial if you want to pass a function with parameters.
## Extending logic
The `build_menus` and the corresponding `menu_hierarchy` dictionaries are meant as example code. It should be easy from this to extend the logic and build more meaningful menu systems, e.g. checking for naming clashes with operators.
If you want to contribute to this project, please feel free to send back your pushes.
### Lack of proper register and unregister
We do not register and unregister our menu and operator classes properly, so this would be another good step to look into, if you're worried about users loading and unloading your addon or you wanting to re-run the addon with updated menus.