...
Grouping objects
Linking objects
Giving hints to the renderer like intersection priority
User attributes for customizing output or pipeline functions
Altering visibility for certain effects like trace sets, camera or reflection visibility, etc.
Some options for optimization like trace depth and relative pixel variance
attributes
| Name | Type | Default | Description |
|---|---|---|---|
| grouping:membership | string |
...
| null | Grouping membership used for linking |
...
...
| identifier:id | integer |
...
| 0 |
...
| Lower 32 bits of 64 bit object id |
...
...
| identifier:id2 | integer |
...
| 0 |
...
| Upper 32 bits of 64 bit object id |
...
...
| identifier:lpegroup | string |
...
| null | Grouping membership used for light path expressions |
...
| , example, keylight |
...
| identifier:name | string |
...
| null | Instance path name |
...
...
| lightfilter:subset | string |
...
| null | Active light filter groups in lighting |
...
...
| lighting:excludesubset | string |
...
| null | Exclude light groups from lighting |
...
...
| lighting:mute | integer |
...
| 0 |
...
| Mutes light emission |
...
...
| lighting:subset | string |
...
| null | Light groups active in lighting |
...
...
| Ri:Matte | integer |
...
| 0 |
...
| Indicates a matte object |
...
...
| Ri:ReverseOrientation | integer |
...
| 0 |
...
| Flip shading normals |
...
...
| Ri:Sides | integer |
...
| 2 |
...
| Geometry can be one or two sided |
...
...
| shade:relativepixelvariance | float |
...
| 1 |
...
| PixelVariance multiplier for camera visible objects |
...
| , allows you to alter the samples relative to the global setting | |
| trace:holdout | integer |
...
| 0 |
...
| Indicates holdout object |
...
| , useful in holdout workflow |
...
| trace:intersectpriority | integer |
...
| 0 |
...
| Raytrace intersection priority for nested dielectrics |
...
...
| trace:maxdiffusedepth | integer |
...
| 1 |
...
| Maximum diffuse light bounces |
...
...
| trace:maxspeculardepth | integer |
...
| 2 |
...
| Maximum specular light bounces |
...
...
| trace:reflectexcludesubset | string |
...
| null | Exclude object groups from |
...
| reflections |
...
| trace:reflectsubset | string |
...
| null | Object groups visible to reflections |
...
...
| trace:shadowexcludesubset | string |
...
| null | Exclude object groups from casting shadows |
...
...
| trace:shadowsubset | string |
...
| null | Object groups active in shadows |
...
| attributes trace:transmitexcludesubset | string |
...
| null | Exclude object groups from transmission/refractions |
...
...
| trace:transmitsubset | string |
...
| null | Object groups visible to transmission/refractions |
...
...
| user:<name> <type> <value> | any | null | Arbitrary instance user data |
...
...
| visibility:camera | integer |
...
| 1 |
...
| Indicates if object is visible to the camera |
...
...
| visibility:indirect | integer |
...
| 1 |
...
| Indicates if object is visible to indirect (reflection and specular refraction) rays |
...
...
| visibility:transmission | integer |
...
| 1 |
...
| Indicates if object is visible to shadow rays |
...
Primvars
Primvars can be set and manipulated on different types of geometry (as available for that type of geometry). This can allow pattern networks and shaders to retrieve this information at render time.
...
primvars:Hyperboloid N <detail> normal [] Description
primvars:Hyperboloid Ri:point1 point [1 0 -1] Description
primvars:Hyperboloid Ri:point2 point [0 1 1] Description
primvars:Hyperboloid Ri:thetamax float [360] Description
primvars:Hyperboloid s <detail> float [] Description
primvars:Hyperboloid st <detail> float[2] [] Description
primvars:Hyperboloid t <detail> float [] Description
NuPatch (NURBS)
primvars:NuPatch N <detail> normal [] Description
primvars:NuPatch P vertex point [required] Description
primvars:NuPatch Pref vertex <point|hpoint> [] Reference P.
primvars:NuPatch Pw vertex hpoint [required] Description
primvars:NuPatch Ri:nu integer [required] Description
primvars:NuPatch Ri:nv integer [required] Description
primvars:NuPatch Ri:Orientation string ["outside"] Geometric winding order
primvars:NuPatch Ri:trimknot float[n] [] Description
primvars:NuPatch Ri:trimmax float[n] [] Description
primvars:NuPatch Ri:trimmin float[n] [] Description
primvars:NuPatch Ri:trimn integer[n] [] Description
primvars:NuPatch Ri:trimncurves integer[n] [] Description
primvars:NuPatch Ri:trimnloops integer [] Description
primvars:NuPatch Ri:trimorder integer[n] [] Description
primvars:NuPatch Ri:trimu float[n] [] Description
primvars:NuPatch Ri:trimv float[n] [] Description
primvars:NuPatch Ri:trimw float[n] [] Description
primvars:NuPatch Ri:uknot float[n] [required] Description length (Ri:uorder + Ri:nu)
primvars:NuPatch Ri:umax float [optional] Description
primvars:NuPatch Ri:umin float [optional] Description
primvars:NuPatch Ri:uorder integer [required] Description
primvars:NuPatch Ri:vknot float[n] [] Description length (Ri:vorder + Ri:nv)
primvars:NuPatch Ri:vmax float [optional] Description
primvars:NuPatch Ri:vmin float [optional] Description
primvars:NuPatch Ri:vorder integer [required] Description
primvars:NuPatch s <detail> float [] Description
primvars:NuPatch st <detail> float[2] [] Description
primvars:NuPatch t <detail> float [] Description
primvars:NuPatch trimcurve:sense string ["inside"] Description
...