利用者:Bartekskorupa/tests/node efficiency tools

Node Wrangler (aka Nodes Efficiency Tools)
Additional tools for working with nodes

UI location	Node Editor's Properties Panel or Ctrl Space
Version	3.00	Author(s)	Bartek Skorupa, Greg Zaal
Blender	2.69	License	GPL

Executable information

File name	node_efficiency_tools.py
Current version download	http://developer.blender.org/diffusion/BA/browse/master/node_efficiency_tools.py

Links	http://projects.blender.org/tracker/index.php?func=detail&aid=33543&group_id=153&atid=469

About

Set of several tools that speed up working with nodes.

- Merge selected nodes using mix nodes, math nodes or mix/add shaders.
- Batch change blend type, math operation
- Batch change Factors of selected "Mix" and "Mix Shader" nodes
- Align nodes
- Copy settings from active to selected nodes
- Copy labels from active node, linked node or linked socket to selected nodes
- Modify labels of selected nodes.
- Switch node type.
- Add Image texture setup
- Add reroute nodes to outputs of selected nodes
- Link Active Node to Selected Nodes
- Relink from Render Layer to OpenEXR MultiLayer input image and vice versa.
- Delete Unused Nodes.
- Reset Backrop.
- Reload all images.
- Viewer node for Cycles Shaders.
- Detach outputs.
- Quickly link to output node (Composite or Output Material).

How To Use

Use menu in properties panel of Node Editor or CtrlSpace keyboard shortcut or individual shortcuts for tools

Features

Lazy Connect

Lazy Connect

Drag holding down CtrlRMB
Make links between the nodes without having to precisely select the sockets. Just drag from one node to another while holding CtrlRMB

Lazy Mix

Lazy Mix

Drag holding down AltRMB
Merge outputs of two nodes using Mix Node or Mix Shader by dragging from one node to another while holding down AltRMB . Mix node or Mix Shader node will be added and outputs of the nodes will be connected to it.

Merge

Merge Selected Nodes

Quickly add Mix, Math, Mix Shader or Add Shader nodes that will merge outputs of selected nodes.

Merge with automatic type detection

CtrlZero Ctrl+ Ctrl- Ctrl * Ctrl/ Ctrl< Ctrl>
Selected nodes‘ outputs will be merged using Mix, Math, Mix Shader or Add Shader nodes., depending on types of selected nodes.
Ctrl+ sets blend type or math operation to Add. When shaders are selected – Add Shader will be used
Ctrl * multiply blend type or math operation
Ctrl- subtract blend type or math operation
Ctrl/ divide blend type or math operation
CtrlZero mix blend type or when shaders are selected - Mix Shader node will be used
Ctrl> greater than math operation
Ctrl< less than math operation

Merge using Mix node

CtrlAltZero, CtrlAlt+, CtrlAlt-, Ctrl alt *, CtrlAlt/

Using CtrlAlt with proper keys will force to use Mix node for merging no matter what types of nodes are selected.

Merge using Math node

Ctrl⇧ Shift+, Ctrl⇧ Shift-, Ctrl shift *, Ctrl⇧ Shift/, Ctrl⇧ Shift<, Ctrl⇧ Shift>

Using Ctrl⇧ Shift with proper keys will force to use Math node for merging no matter what types of nodes are selected.

Batch change blend type / math operation

Change Blend Type or Math Operation

Alt↑, Alt↓, AltZero, Alt+, Alt-, Alt *, Alt/, Alt>, Alt<
Select mix nodes or math nodes and change their blend type or math operation at the same time. Use keys specified above. They will change blend type or operation accordingly to: mix, add, subtract, divide, less than, greater than. Use Alt↑ or Alt↓ to go through all available blend types or math operations.

Change Mix Factor

Easily Change Mix Factor

Alt←, ⇧ ShiftAlt←, Alt→, ⇧ ShiftAlt→
Change Factor of selected Mix nodes or Mix Shader nodes.
Use Alt→ to increase it by 0.1.
Use Alt← to decrease it by 0.1.
Use Alt⇧ Shift→ to increase it by 0.01.
Use Alt⇧ Shift← to decrease it by 0.01.
Use CtrlAlt⇧ Shift← to set factor to 0.0. Additional shortcut is CtrlAlt⇧ ShiftZero
Use CtrlAlt⇧ Shift→ to set factor to 1.0. Additional shortcut is CtrlAlt⇧ ShiftOne

Delete Unused Nodes

AltX
Clean your node tree. Delete all of the nodes that don’t contribute to the final result.

Swap Outputs

Swap Outputs

AltS
Select two nodes that have something linked to their outputs. AltS will swap the outputs. What originally was linked to output of the first node will now be linked to output of the second node and vice verca.

Reset Backdrop

Z
Reset position and scale of the backdrop.

Add UV Layout attribute node

Quickly add coordinates for a certain UV map

(Add node menu) Add attribute node with the attribute automatically set to UV Layout.

Add Vertex Color attribute node

(Add node menu) Add attribute node with the attribute automatically set to vertex color.

Shader Viewer

A viewer node for Cycles materials

Ctrl⇧ ShiftLMB
Viewer Node for shaders. Ctrl⇧ ShiftLMB and the output of the node will be linked to newly created Emission Shader and Material Output. Easy way of prewiewing textures.

Frame Selected

Put the selected nodes in a frame

⇧ ShiftP
Select nodes and „wrap“ them in Frame node by hitting ⇧ ShiftP. Immediately after that hit F6 to set the color and label of the Frame.

Reload Images

AltR
All of the images used in the node tree (Image inputs, textures) can be reloaded by hitting AltR.

Switch Node Type

Switch Node Type

⇧ ShiftS
Change the type of selected node(s) to any other type. Hit ⇧ ShiftS and you’ll get the menu ordered exactly the same as Add Node Menu. Choose the new type.

Copy Settings

Copy Settings from Active to Selected

⇧ ShiftC
Copy settings of active node to all selected nodes of the same type.

Copy Label

⇧ ShiftC
Copy labels all selected nodes basing on various criteria.
Labels can be copied from labels (names) of active node ⇧ ShiftV,
or from names (labels) of nodes that are linked to selected ones or from the names of sockets that the selected nodes are linked to.
All options will be revealed in submenu after hitting ⇧ ShiftC

Clear Label

AltL
Clear labels of selected nodes.

Modify Label

Modify Labels of Selected Nodes

⇧ ShiftAltL
Batch change labels of selected nodes. Add text to beginning, to end, replace parts of text.

Add Texture Setup

Add Image Textrure with Coordinates

CtrlT
Select any shader node, CtrlT and image texture with nodes controlling co-ordinates will be added.

Add Reroutes to Outputs

Add Reroute Nodes to Outputs of Selected

/
Reroute nodes will be added and linked to each output of each selected node.

Link Active to Selected

Link Active Node to Selected

\, K, ⇧ ShiftK, ", ⇧ Shift", (colon) ;, Shift ;
Link active node to selected nodes basing on various criteria.
\ - call main "Link Active to Selected" menu.
K – link active to all selected. Use ⇧ ShiftK to force to replace existing links.
(quote) " – link only to selected nodes that have the same name/label as active node (Shift (quote) " to replace existing links)
(colon) ; - link selected when name of output matches the name or label of selected node.
Handy for replacing sources. For example Render Layer to image (multi layer exr).

Align Nodes

Shift equal Align nodes horizontally or vertically. Same as S-X-0 or S-Y-0, but with even spacing between the nodes.

Select within frame (parent/children)

] – select all nodes wrapped in selected Frame node.
[ - select frame node that selected nodes are wrapped in.

Detach Outputs

Detach Outputs of Selected Nodes

⇧ ShiftAltD
Detach output of selected node leaving linked inputs.

Link to Output Node

O
In compositing – link to Composite output.
In materials – link to Material Output node.

Links and Support

• Questions, comments, suggestions, and bug reports should be sent to the author's email address.
• Video Tutorial at author's page (Outdated. Several new features not included there)
• Changelog

Known Issues

No known issues at the moment

Credits and special thanks

---

• Back to Extensions:2.6/Py/Scripts