us.temerity.pipeline.plugin.MayaMiExportAction.v2_0_11
Class MayaMiExportAction

java.lang.Object
  us.temerity.pipeline.Named
      us.temerity.pipeline.PluginID
          us.temerity.pipeline.BasePlugin
              us.temerity.pipeline.BaseAction
                  us.temerity.pipeline.plugin.MayaMiExportAction.v2_0_11.MayaMiExportAction

All Implemented Interfaces:

Serializable, Cloneable, Comparable<PluginID>, Glueable

public class MayaMiExportAction
extends BaseAction

Exports MentalRay entities from a Maya scene.

See the Maya documentation for the MEL command (Mayatomr) for details. This action defines the following single valued parameters:

Maya Scene

The source node which contains the Maya scene file.

Output Format

The format of the output MI file.

Render Global Options

Export Exact Hierarchy

Tries to preserve the DAG hierarchy during processing. This produces additional mental ray instgroup entities. There are certain unresolved material inheritance issues in this mode, but it works well in the general case. Deeply nested DAG hierarchies may be translated much faster compared to the standard Maya iterator mode that always flattens the DAG.

Export Full DAG Path

Uses the full DAG path names instead of the shortest possible name for mental ray scene entities. This is not required to generate a valid scene, but ensures reproducible names even if DAG entity names are reused in Maya. On the other hand, with deeply nested DAG hierarchy names, you may exceed the maximum supported name length in mental ray.

Export Textures First

Collects all file texture references in the scene first. This ensures that missing texture files are reported early in the process, but may slow down scene processing depending on the number of file textures being used. It may also write out textures references that are never used in the shading graph, because it doesn't perform a complete scene graph traversal for performance reasons.

Export Post Effects

Lets you export post effects. This will create lots of maya garbage in your camera and shader scenes. Probably best to leave this off unless you specifically need this functionality.

Export Assigned Only

This option ignores objects without materials during translation so that they are not part of the final rendered scene.

Export Visible Only

This option ignores non-animated invisible scene entities during translation so that they are not part of the final rendered scene. This option is on by default.

Optimize Anim Detection

When this option is turned on, the processing of non-animated geometry is significantly optimized because mental ray for Maya detects animated nodes prior to processing the scene. This is especially useful for scenes that contain many static objects and only a few simply animated objects.

Use Default Light

Should the default light be turned on. By default this is off.

Fragment Export

Export Set

The name of the Maya Set used to select the DAG nodes to export from the Maya scene. If unset, then the entire scene will be exported.

Export Children

Whether to additionally export all child DAGs of the nodes selected for export.

Export Materials

Whether to additionally export all materials associated with the nodes selected for export.

Export Connections

Whether to additionally export shading nodes which are connected to (driving) the nodes selected for export.

Exported Entities

Links
Includes
Versions
Textures
Objects
Groups
Lights
Cameras
Materials
Options
Functions
Function Decls
Phenomena Decls
User Data

Object Instances
Light Instances
Group Instances
Camera Instances
Function Instances

Render

Custom Text
Custom Shaders
Custom Phenomena

MEL Scripts

Pre Export MEL

The source node which contains the MEL script to evaluate before exporting begins.

Post Export MEL

The source node which contains the MEL script to evaluate after exporting ends.

See Also:

Serialized Form

Field Summary

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

MayaMiExportAction()

Method Summary

SubProcessHeavy

prep(ActionAgenda agenda, File outFile, File errFile) Construct a SubProcessHeavy instance which when executed will fulfill the given action agenda.

Methods inherited from class us.temerity.pipeline.BaseAction

addPreset, addPresetValues, addSingleParam, chmod, cleanupLater, clearAllLinkParams, clearLinkParams, clone, createTemp, createTemp, equals, equalSingleParams, equalSourceParams, fromGlue, getInitialSourceParams, getPluginType, getPresetChoices, getPresetValues, getSecondarySequences, getSecondarySourceNames, getSecondarySourceParam, getSecondarySourceParams, getSecondarySourceParamValue, getSingleLayout, getSingleParam, getSingleParams, getSingleParamValue, getSourceLayout, getSourceNames, getSourceParam, getSourceParams, getSourceParamValue, getTempDir, getTempPath, hasSecondarySourceParams, hasSingleParams, hasSourceParams, initSecondarySourceParams, initSourceParams, removeAllSourceParams, removeSecondarySourceParams, removeSecondarySourceParams, removeSourceParams, setSecondarySourceParamValue, setSingleLayout, setSingleParamValue, setSingleParamValues, setSourceLayout, setSourceParamValue, setSourceParamValues, supportsSourceParams, toGlue

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

Constructor Detail

MayaMiExportAction

public MayaMiExportAction()

Method Detail

prep

public SubProcessHeavy prep(ActionAgenda agenda,
                            File outFile,
                            File errFile)
                     throws PipelineException

Construct a SubProcessHeavy instance which when executed will fulfill the given action agenda.

Overrides:

prep in class BaseAction

Parameters:

agenda - 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.

Returns:

The SubProcess which will fulfill the agenda.

Throws:

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.