- FrankFirsching changed review status to Awaiting Review
- 4 mo
A utility add-on, that eases documenting and maintaining node graphs. It supports easy one-click creation and editing of annotation frames with text blocks. On the side panel of any graph editor, this add-on creates a new section "Node annotator" within the Node tab.
A convenience edit field for the newly introduced Blender 4.2 property for the node group's tool-tip. This property is usually found on the Group tab. The add-on paints a small info icon into the header of node groups, that have a description and thus a tooltip. This behavior can be turned off in the preferences.
This command creates a new yellow annotation box in the current node graph in the middle of the view. It also creates a new text block and associates it with the annotation. As a last step it opens a new window with the text editor to enter the annotation text.
The edit annotation command opens a new window with the text editor to edit the selected annotation text.
The refactoring section can be used to find usages of custom node groups within the graph.
A drop down box, that allows to specify which node groups to search within the currently edited node tree.
A similar drop down box, but this one specifies the type of the node group to use for replacing a found node.
Starts the search and lists the results in the list box below. Every entry has 2 buttons, one to replace the found node with the "Replacement type" and one to jump to that node.
This button refactors all occurrences of the search type to the replacement type.
Bugfix release. Fixed some python exceptions accessing non-existent objects.
This extension does not require special permissions.
Hello Frank, thank you for the submission.
Before we approve, there are some things that need to be fixed or cleared up.
Version of the add-on is already shown in add-on preferences, no need to add it separately by yourself.
Icons in your preview image seem to filled with black. Is that done on purpose?
What you have in preview images (x and y nodes) would make better Featured/Thumbnail than what you have now. On regular scale current thumbnail isn't eligible and just looks like grey square with noise in it. First image better communicates what add-on is than second one.
Add-on seems to be completely broken in Shader Editor. When I try to do simple search and replace with two shader nodes I get error
"RuntimeError: Error: Cannot add node of type GeometryNodeGroup to node tree 'Shader Nodetree' Not a geometry node tree"
Which is incorrect. I'm not sure exactly what is causing the error, but it should be fixed. Additionally. Error messages need to be added correctly, so that user only sees info and not the entire RuntimeError. You can use self.report for showing errors.
I have general doubts about if this functionality can work in Shader and Compositor, where main node trees are not node groups, but I can test better after this bug is resolved. Currently I can't test any further until this gets out of the way.
Additionally, these are recommendations that will not block the add-on, but would be nice if you adopt so that add-on better fits Blender:
Hello Nika,
thanks for the review. Topics are now fixed.
Also implemented your proposal to place the notes above the selected active node. This is a good idea. When there's no selection, the middle of the screen is still chosen.
Sorry for delay and thanks for patience Frank.
Approving now.
One thing you can change is that when you're in the subgroup it lets you search and replace with same group. And of course when you're inside "Cavity" group and replace something with "Cavity" it creates Missing Data-block group.
uploaded new version: Add-on "Node Annotator" v0.4.0
uploaded new version: Add-on "Node Annotator" v0.4.1
Sign in to comment.
Ready for review