TYPE: ROP
TITLE: RenderMan ROP

This output operator is used to drive the RenderMan rendering program.  The
operator sets up all necessary options and then invokes the renderer.
Alternatively, the output can be saved to disk as a script file to be rendered
later.

Arguments may be passed to the script and variable expansion is done before
calling the script.

Specific parameters other than those listed below map directly to a feature in
RenderMan. Various options and attributes can be set using these parameters.  If
a parameter is blank, then no value will be output in the RIB (i.e.  the default
values from the rendermn.ini file will be used).
    
Please see the RenderMan documentation for the explanation of the
RenderMan-specific parameters.

Parameters:
    Render               - Begins the render.
    Camera               - Which camera to render the scene from.
    Visible Objects      - List of objects visible in the rendered scene.
    Unload SOPs          - Unload SOP geometry after used by the render
    Output Picture       - Where the output of the render should be directed.
    Image Device         - Format of the rendered image.
    Frame Range          - Allows specification of a range of frames to render.
    Start/End/Inc        - Specifies the first & last frames and the increment.
                           Note that when rendering a sequence of images with a
                           fraction Inc, $N is the number of the frame rendered,
                           $F is the nearest integer frame number, $FF is the 
                           floating point frame number
    Initialize Simulation SOPs - force all simulation SOPs to be reset.
    Generate Script File - Outputs the renderer's script file instead of
                           feeding the data to the renderer directly.
    Script File          - Filename of the script file to create.
    Render Command       - The command used to invoke the renderer.  Can be
                           modified with the popup window.
    Super Sample         - Number of rays sent per pixel in x and y when
                           antialiasing.
    Override Camera Res  - Allows specification of the render resolution.
    Resolution           - Resolution to render at.
    Pixel Aspect         - Specifies pixel aspect ratio of the intended
                           viewing device.
    Fields               - Specifies how to render for devices using interlaced
                           fields.  Full frame option renders all scanlines on 
                           every frame.
    Depth of Field       - Allows rendering of depth of field effects.
    Jitter               - Toggles jittering while rendering.
    Gamma                - Gamma correction factor used.
    Pre-Render Script    - Execute this script before any rendering.
    Pre-Frame Script     - Execute this script before each frame
    Post-Frame Script    - Execute this script after each frame
    Post-Render Script   - Execute this script after all rendering

Local Variables:
    N        - The current frame of the range specified.  This always
               starts at 1.
    NRENDER  - Total number of frames being rendered.

See also: Mantra(mantra), mental ray(mental)
