RenderPasses

Introduced

v6.0

Categories

render

Description

Renders a sequence of frames from the specified passes, or the current pass, if none specified.

A render pass creates a picture layer of a scene that can be composited with any other passes to create a complete image.

This command can optionally accept a start frame and an end frame to render to override the pass settings. If no start frame or end frame is provided the command uses the default settings from the pass (which can be either a sequence or a set of frames).

Scripting Syntax

RenderPasses( [Passes], [StartFrame], [EndFrame], [StepFrame], [Verbose] );

Parameters

Parameter Type Description
Passes String Passes to render

Default Value: Current pass

StartFrame Number Start frame for the rendering

Default Value: Pass Settings

EndFrame Number End frame for the rendering

Default Value: Pass Settings

StepFrame Number Frame step increment for the rendering

Default Value: Pass Settings

Verbose siRenderVerbosity Force progress report output on or off, or use values from the renderer's options

Default Value: siRenderVerbosityDefault

Examples

VBScript Example

'
'       This example creates a cone with some animation on it and then
'       uses the default pass to render out every other frame.
'
' Create a new scene with only 6 frames 
NewScene , false
SetValue "PlayControl.Out", 6
' Add a cone with some animation
Set oCone = CreatePrim( "Cone", "MeshSurface" )
SaveKey oCone & ".kine.local.posx," _
        & oCone & ".kine.local.posy," _
        & oCone & ".kine.local.posz", _
        1
SetValue "PlayControl.Key", 6
SetValue "PlayControl.Current", 6
Translate oCone, _
        6.94824213992454, _
        2.46082959410157, _
        -0.246082959410157, _
        siRelative, _
        siView, _
        siObj, _
        siXYZ
SaveKey oCone & ".kine.local.posx," _
        & oCone & ".kine.local.posy," _
        & oCone & ".kine.local.posz", _
        6
' Render the default pass from frame 1 to frame 6 with a step of 2
RenderPasses "Passes.Default_Pass", 1, 6, 2

See Also

RenderPassesFrameSet RenderAllPasses CreatePass GetCurrentPass SetCurrentPass DeleteCurrentPass