This is an old revision of the document!
Table of Contents
Instance Filter (WiP)
The Instance Filter node allows you to select instances in the viewport and filter in a node graph depending on the selection.
Controls
Instancer
The node needs to know which Instancer in the scene to work on. This pop-up allows you to select any item with an attached Instancer.
Selection
This displays the current selection as a comma separated list of index number, from 0 to the total number of instances - 11).
You can change this list as well to modify the current selection.
Invert
This inverts the output of the node. What is tagged as selected will be tagged as un-selected and vice versa.
Instance Picker
Enables the ability to pick instances in any viewport. This will draw the instance index at the pivot point of every index. Un-selected indices will be drawn in the item colour, selected indices at a bright yellow.
You can use the left mouse button to select individual instances by clicking on the respective index. Use the next control to change that behaviour to a toggle.
A right click will remove the index from the selection.
Left Mouse Button
This changes the behaviour of the left mouse button to either select an instance or toggle the selection for it.
Node Inputs
Index
You can use this input to override the current index number to filter against. On most cases this is not necessary.
new
If you connect any output from another node to this input, it will create a pair of inputs as well as an output on this node.
The name and type of these will be defined by the output that has been connected to the node. The two inputs will have “True” and “False” appended to their names, matching the value of the boolean input that will pass them through. The output connected to the node will be connected to the “True” input.
Depending on the state of the boolean value, either the “True” or the “False” input will be passed through to the output.
You can add multiple inputs/outputs to the node - which may also have different types.
Node Outputs
Filter
The filter output is set to 0 if the current instances is not in the selection or 1 if it us.
This can be used in conjunction with the Boolean Logic, Boolean Comparison or Boolean Switch nodes to create more complex networks.
This plugin is our Plugin of the Month for September 2020, made possible by the finest patrons on Patreon.