renderStacks

  1. Home
  2. Docs
  3. renderStacks
  4. Main UI
  5. Working with Treeview

Working with Treeview

Treeview Common UI interaction

  • You can select multiple items by holding CTRL or SHIFT.
  • Almost all actions could be done for multiple selected nodes.
  • You can only select multiple nodes if all node type you are selecting such as pass, passgroup, pmodifier are same.
  • You can drag and drop to reorder nodes
  • Double click pass/passgroup will expand and collapse the branch.
  • Expand/Collapse status will be saved in the scene file
  • Double click pmodifier will allow you to rename the pmodifier
  • If you hold CTRL while drag-and-droping pmodifier, the pmodifier will be copied.
  • If you hold SHIFT while drag-and-droping pmodifier, the pmodifier will be instanced.

Working with Passes

  • You can not have duplicated name pass
  • Case-insensitive. You can not make bty if there is Bty
  • By default, only alphanumeric character and _ and – are allowed. You can set own filter with maxscript.
  • Internally a pass has full name which combines the pass name and pass group name if it has one. For example,the pass full name of “Bty” pass under “Tree” passgroup is “Tree/Pass”.

How to add pass

  1. Click Add Pass button or press “A” when the treeview is activated.
  2. Type pass name in the Make new pass dialog.
    You can make multiple passes at once using comma as separators.
  • If passes were selected, the newly added pass will be inserted after the lase selected pass.
  • If passes in passgroups or passgroups were selected, passes will be added into each passgroup.
  • If a same name pass exists already, the newly added pass will be automatically renamed by adding 3 digit suffix or updating 3 digit suffix to random number.
    For example, “Bty” will become “Bty056”. If you already have “Bty022” and add “Bty056”, it will become “Bty079”

How to duplicate passes

  1. Select the passes you want to duplicate.
  2. Click Duplicate Node button or Press “D.
  • The pass will be duplicated with and its pmodifiers.
  • Duplicated pass will have 3 digit suffix to prevent a duplicated pass name. renderStacks doesn’t allow to have duplicated pass full name.
  • If you hold SHIFT while duplicating pass, all pmodifier in the duplicated pass will be instanced.

How to duplicate pass with pass title button

  • If you have selected only one pass, you can duplicate the pass by pressing pass title button while holding CTRL at the top of the Pass modify panel.
  • If you hold SHIFT while pressing the pass title button, all pmodifier in the duplicated pass will be instanced.

How to re-order passes

  • Drag and drop into other pass node
  • If you drag and drop to a passgroup, it will move the passes into the pass group.

How to rename a pass

  1. Click Rename pass/passgroup button or Press “R”.
  2. Type new name in the dialog
  • If the new pass name is already exists, it will automatically get a random 3 digit number as suffix.
  • You can not rename base depot, “::base”. That’s not even a pass!
  • You can also rename from Note rollout

How to delete passes

  1. Select passes.
  2. Click Delete Node button ot press “Del”.
  3. A confirmation dialog will pop up. Click Yes.

Working with Pmodifiers

How to add pmodifiers – Tab menu

  1. When you are in the treeview, press Tab to open Add Pmodifier dialog.
    To add a pass, you need to select pass or pmodifier.
    If you select multiple pass, pmodifiers will be added to all selected passes.
  2. Type search word to filter pmodifier types. As you start to type search word. You will see the search word what you have type and the pmodifier list will be updated.
  3. Press Enter or double click the pmodifier you want to add.
  4. If you want to add multiple pmodifier types at once, select them while holding CTRL and SHIFT keys
  5. Then, press the Enter.
  6. To close the dialog, press ESC or click “X” button at the top right corner.
  • Some pmodifier requires subname like ObjParams and ManyObjParams. For that kind of pmodifier, you must defined subname. After you created a subnamed pmodifier, the subnamed pmodifier will appear in the pmodifier list just like any other pmodifiers.

How to add pmodifier – right click menu

  • Pmodifier also can be added via right-click menu of treeview.
  • Since there is no UI for subname in the right-click menu. You can not make pmodifier which requires subname.

How to duplicate pmodifiers

  1. Select the passes you want to duplicate.
  2. Click Duplicate Node button or Press “D.
  • When a node is duplicated , it will automatically get a random 3 digit number as suffix.
  • You can use this to localize base pmodifier for the selected pass.

How to rename pmodifier

  1. Double-click pmodifier in the treeview.
  2. Rename and press Enter.
  3. You can also rename from Note rollout
  • You can not rename base pmodifier name

How to delete pmodifiers

  1. Select pmodifiers
  2. Click Delete Node button or press “Del”.
  3. A confirmation dialog will pop up. Click Yes.
  • If you delete any base pmodifier, you will see this warning/confirmation.
    Basically you can not have a type of pmodifier without having the base pmodifier for the type. If you delete base pmodifier, you must delete all pmodifier of the type. If you choose Yes, all pmodifiera of the type will be deleted.

How to copy/paste pmodifier

  1. Select pmodifiers.
  2. Click Copy Modifiers button or CTRL+C.
  3. Select target passes.
  4. Click Paste Modifiers button or CTRL+V.
    If you want to paste pmodifiers as instance, press SHIFT while paste.

How to copy/paste pmodifier with drag-and-drop

  1. Select pmodifiers.
  2. Drag and drop to reorder or move pmodifiers from pass to pass
  3. CTRL+Drag and drop will copy pmodifiers to other pass or duplicate in the same pass.
  4. SHIFT+Drag and drop will instance pmodifiers to other pass.
    You can not have same instanced pmodifier in the same pass.
  • You can drag and drop into other pmodifier or pass.
  • You can not drag and drop into ::base depot.
  • If you have selected only one pmodifier and hold ALT while drag-and-dropiing, the pmodifier will replace the target pmodifier if two modifier’s type is same.

How to deinstance pmodifier

  1. Select pmodifiers.
  2. Click Deinstance pmodifiers button or press “D”
  • If you deinstance base pmodifier in a pass, it will make a copy of local pmodifier. It is same as duplicating the pmodifier.

Working with passgroup

How to group passes

  1. Select passes
  2. Press group passes button or “G”.
  3. Name dialog will popup. Input passgroup name.
  4. Press Enter.
  • Same naming rule as pass
  • If a same name passgroup exists already, the newly added passgroup will be automatically renamed by adding 3 digit suffix or updating 3 digit suffix to random number.

How to add new pass to a passgroup

  1. Select passgroup.
  2. Press “Add new pass” button.
  3. Name the new pass.
  4. Press “Make new pass”
  5. New passes will be added under selected passgroups.

How to ungroup passgroups

  1. Select passgroups
  2. Press “Ungroup passgroup” button
  3. Or, you can use “Delete Node” button, too.