# RenderMan Interface Specification

The RenderMan Interface Specification, or RISpec in short, is an open API developed by Pixar Animation Studios to describe three-dimensional scenes and turn them into digital photorealistic images. It includes the RenderMan Shading Language.
As Pixar's technical specification for a standard communications protocol (or interface) between modeling programs and rendering programs capable of producing photorealistic-quality images, RISpec is a similar concept to PostScript but for describing 3D scenes rather than 2D page layouts. Thus, modelling programs which understand the RenderMan Interface protocol can send data to rendering software which implements the RenderMan Interface, without caring what rendering algorithms are utilized by the latter.
The interface was first published in 1988 (version 3.0) and was designed to be sufficiently future proof to encompass advances in technology for a significant number of years. The current revision is 3.2.1, released in November 2005.
What set the RISpec apart from other standards of the time was that it allowed using high-level geometric primitives, like quadrics or bicubic patches, to specify geometric primitives implicitly, rather than relying on a modeling application to generate polygons approximating these shapes explicitly beforehand. Another novelty introduced by the RISpec at the time was the specification of a shading language.
The RenderMan shading language allows material definitions of surfaces to be described not only by adjusting a small set of parameters, but in an arbitrarily complex fashion by using a C-like programming language to write shading procedures commonly known as procedural textures and shaders. Lighting, and displacements on the surface, are also programmable using the shading language. The shading language allows each statement to be executed in a SIMD manner, but does not insist on it. Another feature that sets renderers based on the RISpec apart from many other renderers is the ability to output arbitrary variables as an image: surface normals, separate lighting passes and pretty much anything else can be output from the renderer in a single pass.
RenderMan has much in common with OpenGL (developed by the now-defunct Silicon Graphics), despite the two APIs being targeted to different sets of users (OpenGL to real-time hardware-assisted rendering and RenderMan to photorealistic off-line rendering). Both APIs take the form of a stack-based state machine with (conceptually) immediate rendering of geometric primitives. It is possible to implement either API in terms of the other.

## Required capabilities

For a renderer to call itself "RenderMan-compliant", it must implement at least the following capabilities:
* A complete hierarchical graphics state, including the attribute and transformation stacks and the active light list.
* Orthographic and perspective viewing transformations.
* Depth-based hidden-surface elimination.
* Pixel filtering and spatial anti-aliasing.
* Gamma correction and dithering before quantization.
* Output of images containing any combination of RGB, A, and Z. The resolutions of these files must be as specified by the user.
* All of the geometric primitives described in the specification, and provide all of the standard primitive variables applicable to each primitive.
* The ability to perform shading calculations through user-programmable shading
* The ability to index texture maps, environment maps, and shadow depth maps
* The fifteen standard light source, surface, volume, displacement, and imager shaders required by the specification. Any additional shaders, and any deviations from the standard shaders presented in this specification, must be documented by providing the equivalent shader expressed in the RenderMan shading language.

## Optional advanced capabilities

Additionally, the renderer may implement any of the following optional capabilities:
* Area light sources
* Depth of field
* Displacement mapping
* Environment mapping
* Global illumination
* Level of detail
* Motion blur
* Special camera projections
* Spectral colors
* Ray tracing
* Solid modeling
* Volume shading