Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


UI Text Box

For a list of all available arguments, run the command with the -help flag in the Maya Script Editor: vrayCreateProxy -help. 




The various options are described below:


After successful export, replaces the original geometry with proxy nodes. Can also be used along with the -existing option to load an existing proxy file.
Returns a list of the names of the transform nodes directly above the created nodes.

-dirSpecifies the path where the .vrmesh file(s) will be created.
-existingUses existing vrmesh file instead of creating a new one.
-nodeThe name for the new proxy node when -createProxyNode is specified, and a single proxy is created.
-animStart Override start frame when importing a sequence of files with <frame> filename tag.
-animLength Override end frame when importing a sequence of files with <frame> filename tag.
-objectPath Starting path in the Alembic object hierarchy when importing .abc files

Type of geometry to load:4

 1- None

2 - Bounding Box

3 - Preview


4 - Full geometry

-flipAxis  Transforms from Max to Maya coordinate system.
-noMaterialIf specified, does not create a VRayMeshMaterial for the proxy.


Imports material override rules (.xml) from a specified location.

-vrayExportProxyRulesExports material override rules (.xml) to a specified location.
-newProxyNode Uses the new VRayProxy node instead of the old VRayMesh.
-animOnIf specified, animated .vrmesh files are created.

If -animOn is specified, this option determines the animation interval to export:

1 - playback range

2 - animation range

3 - explicit frame range specified with -startFrame and -endFrame

-startFrameSpecifies the start animation frame when using explicit range.
-endFrameSpecifies the end animation frame when using explicit range.
-exportHierarchyExports full paths including transforms and groups instead of just shape names.

Specifies the type of export:

1 - export all selected objects in a single .vrmesh file.

2 - export each selected object in a separate .vrmesh file.

-fnameSpecifies the file name when exporting to multiple .vrmesh files.
-facesPerVoxelAn integer value that specifies the maximum number of faces that a voxel can hold.
-oneVoxelPerMeshIf specified, export each separate mesh to a single voxel.
-ignoreHiddenObjectsIf specified, hidden objects are not exported.
-includeTransformationIf specified and exporting objects in separate files , bake the transformation of each object into the vertex positions in the resulting .vrmesh files.
-makeBackupCreate a backup .ma file containing just the exported objects.
-overwriteIf specified, any existing .vrmesh files will be overwritten; otherwise, an error will be printed.
-previewFacesSpecifies the number of faces in the viewport preview for the proxy object.

The simplification method to use when generating a preview. Must be one of the following:





-lastSelectedAsPreview Uses the last selected object as a preview mesh.
-pointSizeIf higher than 0.0, create a point cloud representation of the mesh. The specified value is used as a minimum size of the disk samples.
-velocityIntervalEndA value between 0.0 and 1.0 with the time position within a frame for the ending vertex positions.
-velocityIntervalStartA value between 0.0 and 1.0 with the time position within a frame for the initial vertex positions.
-velocityOnIf specified, vertex velocity is also exported. This enables motion blur and smooth interpolation of the resulting animated proxies.
The time samples within a frame for computing the velocity are specified with the -velocityIntervalStart and -velocityIntervalEnd options.
-vertexColorsOnIf specified, vertex color sets are also exported.





Export Mesh Example

The command operates on the current selection and has the following syntax, where curly braces {} denote a choice between several values separated by a pipe |, and options in brackets [] are optional:


UI Text Box

Note that $filename has to include the correct extension of the file, that is .abc or .vrmesh.  


Import Mesh Example

.vrmesh example:

Code Block
vrayCreateProxy -node $nodename -existing -dir $path.vrmesh -createProxyNode


alembic example:

Code Block
vrayCreateProxy -node $nodename -existing -dir $ -createProxyNode


This command creates a proxy node and points it to an existing file (.vrmesh or .abc). Please note that "$path.vrmesh/abc" is the full path of the file. $nodename is  $nodename is the name of the node in the Maya scene.


Import/Export Material Rules Example

Import material rules example:

Code Block
vrayImportProxyRules "pSphere_vrayproxy" "D:/Maya/Proxy/test.xml";


Export material rules example:

Code Block
vrayExportProxyRules "pSphere_vrayproxy" "D:/Maya/Proxy/test.xml";


These commands are equivalent to the existing Import/Export material rules button (Image Added), but allow for scripting.