|
TEMERITY | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectus.temerity.pipeline.Named
us.temerity.pipeline.PluginID
us.temerity.pipeline.BasePlugin
us.temerity.pipeline.BaseAction
us.temerity.pipeline.plugin.CommonActionUtils
us.temerity.pipeline.plugin.PythonActionUtils
us.temerity.pipeline.plugin.MRayActionUtils
us.temerity.pipeline.plugin.MRayRenderAction.v2_2_1.MRayRenderAction
public class MRayRenderAction
Renders a collection of MI files using Mental Ray Standalone.
All of the MI file dependencies of the target image which set the Order per-source sequence parameter will be processed. The frame range rendered will be limited by frame numbers of the target images. The Action invokes a new instance of the Mental Ray renderer for each MI file. This is due to how Mental Ray keeps library information loaded when rendering multiple MIs. Since each MI file may potentially have a different set of library files and includes, a separate invocation of 'ray' is necessary to ensure that each one runs in the correct environment.
This action defines the following single valued parameters:
evaluate).
evaluate).
evaluate).
This action defines the following per-source parameters:
Lights - Contains light shaders, objects and instances used to illuminate the geometry being rendered and possibly required by shaders.
Shaders - Contains "material" and "shader" statements required by the geometry to be rendered.
Geometry - Contains "instance" statements for the geometry to be rendered.
InstGroups - Contains "instgroup" statements for instances found in pre-processed geometry MI files and "$include" statements for those files. Typically generated by the MRayInstGroup Action.
Cameras - Contains the camera object and instance used to render the images. May contain additional cameras as well, but they will be ignored.
CamOverride - Contains MI statements which should be used to override settings for the specified render camera as an increment. Typically generated by the MRayCamOverride Action.
Options - Contains an "option" statement specifying render globals.
If the environmental variable MRAY_BINARY is defined, its value will be used as the name of the renderer executable instead of the "ray" (Unix/MacOS) or "ray345.exe" (Windows). On Windows, the renderer name should include the ".exe" extension.
By default, the "python" program is used by this action when running on Windows to process the MI files. An alternative program can be specified by setting PYTHON_BINARY in the Toolset environment to the name of the Python interpertor this Action should use. When naming an alternative Python interpretor under Windows, make sure to include the ".exe" extension in the program name.
| Field Summary | |
|---|---|
static String |
aBaseLibraries
|
static String |
aCameraName
|
static String |
aCameras
|
static String |
aCamOverride
|
static String |
aContains
|
static String |
aFramebufferType
|
static String |
aGeometry
|
static String |
aIncludePath
|
static String |
aInstGroups
|
static String |
aKeepTempFiles
|
static String |
aLibraryPath
|
static String |
aLights
|
static String |
aMayaShaders
|
static String |
aOptions
|
static String |
aRenderVerbosity
|
static String |
aShaderIncs
|
static String |
aShaders
|
static String |
aTexturePath
|
| Fields inherited from class us.temerity.pipeline.plugin.CommonActionUtils |
|---|
aExtraOptions |
| Fields inherited from class us.temerity.pipeline.BasePlugin |
|---|
pDescription |
| Fields inherited from class us.temerity.pipeline.PluginID |
|---|
pVendor, pVersionID |
| Fields inherited from class us.temerity.pipeline.Named |
|---|
pName |
| Constructor Summary | |
|---|---|
MRayRenderAction()
|
|
| Method Summary | |
|---|---|
TreeMap<String,ActionParam> |
getInitialSourceParams()
Get an initial set of action parameters associated with an upstream node. |
SubProcessHeavy |
prep(ActionAgenda agenda,
File outFile,
File errFile)
Construct a SubProcessHeavy instance which when executed will
fulfill the given action agenda. |
boolean |
supportsSourceParams()
Does this action support per-source parameters? |
| Methods inherited from class us.temerity.pipeline.plugin.MRayActionUtils |
|---|
getMRayProgram, getMRayProgram |
| Methods inherited from class us.temerity.pipeline.plugin.PythonActionUtils |
|---|
createPythonSubProcess, createPythonSubProcess, createPythonSubProcess, getPythonFileVerify, getPythonFileVerify, getPythonFileVerify, getPythonFileVerify, getPythonFileVerify, getPythonFileVerify, getPythonIndent, getPythonLaunchHeader, getPythonLaunchPipeHeader, getPythonProgram, getPythonProgram |
| Methods inherited from class us.temerity.pipeline.BasePlugin |
|---|
addSupport, compareTo, getDescription, getFullMessage, getPluginID, getResource, getResources, getResourceSize, getSupports, isUnderDevelopment, removeSupport, setSupports, supports, toString, underDevelopment |
| Methods inherited from class us.temerity.pipeline.PluginID |
|---|
getVendor, getVersionID |
| Methods inherited from class us.temerity.pipeline.Named |
|---|
getName |
| Methods inherited from class java.lang.Object |
|---|
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Field Detail |
|---|
public static final String aCameraName
public static final String aFramebufferType
public static final String aKeepTempFiles
public static final String aRenderVerbosity
public static final String aBaseLibraries
public static final String aMayaShaders
public static final String aIncludePath
public static final String aLibraryPath
public static final String aTexturePath
public static final String aContains
public static final String aShaderIncs
public static final String aLights
public static final String aShaders
public static final String aGeometry
public static final String aInstGroups
public static final String aCameras
public static final String aCamOverride
public static final String aOptions
| Constructor Detail |
|---|
public MRayRenderAction()
| Method Detail |
|---|
public boolean supportsSourceParams()
supportsSourceParams in class BaseActionpublic TreeMap<String,ActionParam> getInitialSourceParams()
getInitialSourceParams in class BaseAction
public SubProcessHeavy prep(ActionAgenda agenda,
File outFile,
File errFile)
throws PipelineException
SubProcessHeavy instance which when executed will
fulfill the given action agenda.
prep in class BaseActionagenda - The agenda to be accomplished by the action.outFile - The file to which all STDOUT output is redirected.errFile - The file to which all STDERR output is redirected.
PipelineException - If unable to prepare a SubProcess due to illegal, missing or imcompatable
information in the action agenda or a general failure of the prep method code.
|
TEMERITY | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||