Page tree


We set grouping membership to geometry with the categories parameter on the geometry in order to use them in trace set or shadow subset. 

Simple Tokens:

  • Asterisk * - Everything, the default
  • Only the object name/path - Include the following object, sphere_object
  • Caret ^ - Exclude the following object, ^sphere_object
  • The @ symbol - Include this bundle/grouping of objects, @carEngine

As an example of its usage, in the PxrRectLight below, we simply specify that grouping membership name in the Light Mask and add the caret ^ to exclude the specified light path. In the example below, the grid object is not lit by the PxrRectLight. Note that this can be done through the UI for the Light Bank and light Linking but also works for trace sets. You may also just say ^pxrrectlight and omit the /obj/ path

Below we omit the reflection of a sphere object as well as the light from the rect light.

Another common requirement is to ignore shadows cast from specific objects. To do this, Edit the Parameter Interface (the cog wheel at the Object Name field)

You can add the Shadow Mask by copying and renaming the Reflection Mask as shown below. You can then use the field to select what objects are allowed to or excluded from shadowing the object.