Node Wrangler

This add-on gives you several tools that help you work with nodes quickly and efficiently. Many functions work for both the Compositor and shader nodes, and some functions bring features already in the Compositor to the shader nodes as well. Some tools are made for a specific function, however we have made it our goal to allow complete flexibility for you to use the tools in every situation, even where we did not intend.

Activation – Активація

Відкрийте Blender та перейдіть в Preferences – «Уподобання», потім у вкладку Add-ons – «Додатки».
Click Node then Node Wrangler to enable the script.

Usage – Використання

Use panel in Sidebar of node editor or Ctrl-Spacebar keyboard shortcut or individual shortcuts for tools.

Description – Опис

Lazy Connect

Reference – Довідка

Shortcut – Шоткат: Ctrl-RMB-drag, Shift-Ctrl-RMB

Make links between the nodes without having to precisely select the sockets. Just drag from one node to another while holding Ctrl-RMB. The nodes nearest the mouse are used, so you don’t even have to click on one precisely.

Also, use Shift-Ctrl-RMB to show a menu of inputs and outputs to make a more accurate connection. This is useful when working with a large node tree, since you can easily make connections without having to zoom in and out a lot.

Lazy Mix

Reference – Довідка

Shortcut – Шоткат: Alt-RMB-drag

Merge outputs of two nodes using a Mix node or Mix Shader node by dragging from one node to another while holding down Alt-RMB. A Mix node or Mix Shader node will be added and the outputs of the nodes will be connected to it.

Merge – Злиття

Quickly add Mix, Math, Z-Combine, Alpha Over, Mix Shader or Add Shader nodes that will merge outputs of selected nodes.

Merge with Automatic Type Detection

Reference – Довідка

Shortcut – Шоткат: Ctrl-0, Shift-Ctrl-=, Ctrl-Minus, Shift-Ctrl-8, Ctrl-Slash, Shift-Ctrl-Comma, Shift-Ctrl-Period

Selected nodes“ outputs will be merged using Mix, Math, Mix Shader or Add Shader nodes, depending on types of selected nodes.

Add Shift-Ctrl-=: Sets the blend mode or math operation to Add. When shaders are selected an Add Shader will be used.
Multiply Shift-Ctrl-8: Multiply blend mode or math operation.
Subtract Ctrl-Minus: Subtract blend mode or math operation.
Divide Ctrl-Slash: Divide blend mode or math operation.
Mix Ctrl-0: Mix blend mode or when shaders are selected a Mix Shader node will be used.
Greater than Shift-Ctrl-Comma: Greater than math operation.
Less than Shift-Ctrl-Period: Less than math operation.

Merge Using Mix Node

Reference – Довідка

Shortcut – Шоткат: Shift-Ctrl-Alt-=, Ctrl-Alt-Minus, Shift-Ctrl-Alt-8, Ctrl-Alt-Slash

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

Merge Using Z-Combine Node

Reference – Довідка

Shortcut – Шоткат: Ctrl-NumpadPeriod

Z-Combine nodes will be used for merging. If possible – image and Z-Depth outputs will be linked.

Merge Using Alpha Over Node

Reference – Довідка

Shortcut – Шоткат: Ctrl-Alt-0

Alpha Over nodes will be used for merging.

Merge Using Math Node

Reference – Довідка

Shortcut – Шоткат: Shift-Ctrl-=, Shift-Ctrl-Minus, Shift-Ctrl-8, Shift-Ctrl-Slash, Shift-Ctrl-Comma, Shift-Ctrl-Period

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

Batch Change Blend Mode / Math Operation

Reference – Довідка

Shortcut – Шоткат: Alt-Up, Alt-Down, Alt-0, Shift-Alt-=, Alt-Minus, Shift-Alt-8, Alt-Slash, Shift-Alt-Comma, Shift-Alt-Period

Select Mix nodes or Math nodes and change their blend mode or math operation at the same time. Use keys specified above. They will change the blend mode or operation accordingly to: Mix, Add, Subtract, Divide, Less than, Greater than. Use Alt-Up or Alt-Down to go through all available blend modes or math operations.

Change Mix Factor

Reference – Довідка

Shortcut – Шоткат: Alt-Left, Shift-Alt-Left, Alt-Right, Shift-Alt-Right

Change Factor of selected Mix nodes or Mix Shader nodes.

Use Alt-Right to increase it by 0.1.
Use Alt-Left to decrease it by 0.1.
Use Shift-Alt-Right to increase it by 0.01.
Use Shift-Alt-Left to decrease it by 0.01.
Use Shift-Ctrl-Alt-Left to set factor to 0.0. Additional shortcut is Shift-Ctrl-Alt-0.
Use Shift-Ctrl-Alt-Right to set factor to 1.0. Additional shortcut is Shift-Ctrl-Alt-1.

Delete Unused Nodes

Reference – Довідка

Shortcut – Шоткат: Alt-X

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

Swap Links

Reference – Довідка

Shortcut – Шоткат: Alt-S

Select two nodes that have something linked to their outputs. Alt-S 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 versa.

Or, select one node with a single linked input – Alt-S will cycle the link through the available input sockets. Or, select one node with two linked inputs – Alt-S will swap the two links. If more than two inputs are linked, the two with matching types will be swapped (such as a Mix node’s two color inputs).

Reset Backdrop – Скинення Тла

Reference – Довідка

Shortcut – Шоткат: Z

Reset position and scale of the backdrop.

Add UV Layout Attribute Node

Reference – Довідка

Menu – Меню: Header ‣ Add menu

Add Attribute node with the attribute set to UV Layout.

Add Vertex Color Attribute Node

Reference – Довідка

Menu – Меню: Header ‣ Add menu

Add an Attribute node with the attribute set to Color Attribute.

Shader Viewer

Reference – Довідка

Shortcut – Шоткат: Shift-Ctrl-LMB

Viewer Node for shaders. Shift-Ctrl-LMB and the output of the node will be linked to newly created Emission shader and Material Output. This is an easy way of previewing textures.

Frame Selected – Вибране в Кадр

Reference – Довідка

Shortcut – Шоткат: Shift-P

Select nodes and «wrap» them in Frame node by hitting Shift-P. Immediately after that hit F6 to set the color and label of the Frame.

Reload Images

Reference – Довідка

Shortcut – Шоткат: Alt-R

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

Switch Node Type

Reference – Довідка

Shortcut – Шоткат: Shift-S

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

Copy Settings – Копія Устав

Reference – Довідка

Shortcut – Шоткат: Shift-C

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

Copy Label

Reference – Довідка

Shortcut – Шоткат: Shift-C

Copy labels all selected nodes based on various criteria. Labels can be copied from labels (names) of active node Shift-V, 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 Shift-C.

Clear Label

Reference – Довідка

Shortcut – Шоткат: Alt-L

Clear labels of selected nodes.

Modify Label

Reference – Довідка

Shortcut – Шоткат: Shift-Alt-L

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

Add Texture Setup

Reference – Довідка

Shortcut – Шоткат: Ctrl-T

Select any shader node, Ctrl-T and an image texture with nodes controlling coordinates will be added. If you select any texture node, only the Texture Coordinate and Mapping nodes will be added. A background shader will get an Environment Texture node with generated mapping.

Add Reroutes to Outputs

Reference – Довідка

Shortcut – Шоткат: Slash

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

Link Active to Selected

Reference – Довідка

Shortcut – Шоткат: Backslash, K, Shift-K, ', Shift-', ;, Shift-;

Link active node to selected nodes basing on various criteria.

Backslash – Call main Link Active to Selected menu.
K – Link active to all selected. Use Shift-K to force to replace existing links.
Shift-' – Link only to selected nodes that have the same name/label as active node (Shift-' to replace existing links).
; – 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

Reference – Довідка

Shortcut – Шоткат: Shift-=

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

Reference – Довідка

Shortcut – Шоткат: Shift-Alt-D

Detach output of selected node leaving linked inputs.

Link to Output Node

Reference – Довідка

Shortcut – Шоткат: O

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

Add Image Sequence

Reference – Довідка

Menu – Меню: Add ‣ Input menu for composite nodes, or Add ‣ Texture menu for shader nodes

Select just one image from a sequence in the File Browser and it will automatically detect the length of the sequence and set the node appropriately.

Add Multiple Images

Reference – Довідка

Menu – Меню: Add ‣ Input menu for composite nodes, or Add ‣ Texture menu for shader nodes

Simply allows you to select more than one image and adds a node for each. (Useful for importing multiple render passes or renders for image stacking.)

Дивись також

Please see the old Wiki for the archived original docs.

Reference – Довідка

Category – Категорія: Node – Вузол
Description – Опис: Various tools to enhance and speed up node-based workflow.
Location – Локація: Node editor ‣ Sidebar or see the hotkeys of individual tools.
File – Файл: node_wrangler.py
Author – Автор: Bartek Skorupa, Greg Zaal, Sebastian Koenig, Christian Brinkmann, Florian Meyer
License – Ліцензія: GPL
Note – Примітка: Цей додаток поставляється у комплекті з Blender’ом.