Reconfiguring RfM

Reconfiguring RfM

As mentioned in the Extensions documentation, RenderMan for Maya uses .rman files as extensions to the initialization files to define the RfM globals interface within Maya, accessible RenderMan attributes, options, and parameters, and all of the RfM nodes that integrate with Maya.

Overrides

Users can add simple overrides to their .rman files for just about any type of node. Nodes that you want to override are specified by adding "Overrides" to the template type keyword (like NodeType). We support NodeTypeOverrides, NodeOptionsOverrides, MenuOverrides, TabOverrides.

Here are some examples in an extension file that a user might load:

rman "-version 1" {

   # Changes the default value of shading rate in the globals
   NodeTypeOverrides settings:job:Job {
       riattr ShadingRate {
           default 42
        }
   }

   # Changes the default image type in the globals
   NodeTypeOverrides settings:display:Primary {
        riopt Display:type {
           default {tiff}
        }
   }

   # NodeOptions are the context sensitive list of optional settings
   # that appear in the attribute manager when any object is selected.
   # You can add to a list or change defaults of settings already in a list.
   # In this example, the default value of the Color setting is changed to red
   # in the NodeOptions lists for material nodes.
   NodeOptionsOverrides {kLambert kRampShader kLayeredShader RenderManShader kSurfaceShader} {
        riattr Color {
           default {1 0 0}
           state optional
        }
   }

   # Adds a new tab to the globals, to the right of factory tabs.
   Tab "MyNewTab" {
        group "My Stuff" open {
           control settings:job:Job ShadingRate
        }
   }

   # Appends a new scroll group at the bottom of the existing "Features" tab.
   TabOverrides "Features" {
        group "My Stuff" open {
           control settings:job:Job ShadingRate
        }
   }

   # Adds a new menu entry in the AE to the context sensitive
   # Attributes->RenderMan menu when shape nodes are selected.
   MenuOverrides kGeometric {
       menuitem "Add Shading Rate" {
            addsetting ShadingRate
       }
   }
}