Item Lists

 



The "Item List" Column of the Node Editor is a special case. It allows you - given the right Attribute Type - to create Custom Dropdowns. 
Item Lists require the Attribute Data Type "mriUserEnum", meaning that only very few nodes will be able to be edited. 

Extension Pack contains 2 Nodes that are specifically designed to work with these Item Lists:


You can edit the Item Lists of these Nodes in 2 ways

  1. directly by selecting them in the Nodegraph and launching the Node Editor
  2. exposing their Dropdown to a Group Node, Material or Custom Procedural and editing the Parent Node with the Node Editor


In the below example we will edit the Item List Switch (X10) Node directly, however the same principle applies to the Item List (X10) Node as well as cases where you are editing their exposed Attributes on a Group Node, Material etc.







  1. Start by selecting your Item List Node. Here we use a "Item List Switch"



  2. Take a look at its Node Properties. We have by default a Dropdown with 10 Items, corresponding to the 10 different Inputs the Node can switch between.

    Our goal is to rename the individual items to have a more clear representation, what each input of the node does - in our example, switching between different colors.
    We will also remove a few entries since we don't need all 10.



  3. With the "Item List Switch" Node selected, launch the Node Editor, by pressing the Hotkey ALT+K or going to the Right Mouse Click Context Menu of the Nodegraph, and choosing the Node Editor in the Edit-Submenu



  4. Locate the "Item List" Column. With default settings, it is the last column on the far right side (you might have to scroll).
    Our node only has two attributes, so we can easily identify the Dropdown Attribute "Switch".

    On more complex Nodes search for Attributes of "Attribute Type": mriUserEnum



  5. Double click on the Item list cell of the Switch Attribute to edit its Items. A dialog will appear, that let's you add,remove,reorder and rename the Dropdown entries



  1. DIALOG USAGE TIPS:
    • press any key to instantly start renaming the selected text item
    • You can use the arrow keys to quick select
    • Use - (minus) button or DEL Hotkey to delete selected items
    • Drag and drop to reorder elements or use arrow up/down buttons

  1. Let's quickly rename our items according to what color they are supposed to switch and delete the others.


  2. Let's hit Apply to close the dialog and edit the Item List Cell and hit Apply in the Main Dialog as well to apply the changes to the node




Extension Pack's Item List Nodes support a maximum of 10 items. Any more will be discarded.



  1. Once the changes have been applied, our Node Dropdown now accurately reflects what inputs it has