db&w documentation wiki

finest software | finest docs

Site Tools


tools:instance_filter

This is an old revision of the document!


Instance Filter

The Instance Filter node allows you to select instances in the viewport and filter in a node graph depending on the selection.

The passing through of values depending on the selection is similar to the Boolean Switch Node.

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

20200924-143124.png_400

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, where “True” is used if the instance is a part of the selection, “False” if it's not. The output connected to the node will be connected to the “True” input.

Depending on the current instance being selected, 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.

To remove any of the input/output pairs, right click on either of them and use the Node Menu.

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.

1)
Yeah, that's a computer thing ;)
tools/instance_filter.1600950711.txt.gz · Last modified: 2020/09/24 14:31 by lightwolf