---
title: "vrayCreateProxy"
canonical: "https://documentation.chaos.com/space/VMAYA/111741412/vrayCreateProxy"
format: markdown
---
## **Overview**
---
The .*vrmesh* files and proxy objects can be created through the **vrayCreateProxy** command. Using the command with different flags allows you to export geometry to proxy files and load files to V-Ray Proxy objects.
> Macro (ui-text-box)
>
> You can use the vrayCreateProxy command with both MEL and Python. For the purpose of the documentation, the examples below are written in MEL.
> Macro (ui-text-box)
>
> For a list of all available arguments, run the command with the -help flag in the Maya Script Editor: **vrayCreateProxy** **-help**.
##
**Syntax**
---
The various options are described below:
| **Option** | **Description** |
| --- | --- |
| -createProxyNode | 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. |
| -dir | Specifies the path where the *.vrmesh* file(s) will be created. |
| -existing | Uses existing vrmesh file instead of creating a new one. |
| -node | The 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 filename tag. |
| -animLength | Override end frame when importing a sequence of files with filename tag. |
| -objectPath | Starting path in the Alembic object hierarchy when importing .abc files |
| -geomToLoad | Type of geometry to load:4
1- None
2 - Bounding Box
3 - Preview
4 - Full geometry |
| -flipAxis | Transforms from Max to Maya coordinate system. |
| -noMaterial | If specified, does not create a VRayMeshMaterial for the proxy. |
| -vrayImportProxyRules | Imports material override rules (.xml) from a specified location. |
| -vrayExportProxyRules | Exports material override rules (.xml) to a specified location. |
| -newProxyNode | Uses the new VRayProxy node instead of the old VRayMesh. |
| -animOn | If specified, animated *.vrmesh* files are created. |
| -animType | 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 |
| -startFrame | Specifies the start animation frame when using explicit range. |
| -endFrame | Specifies the end animation frame when using explicit range. |
| -exportHierarchy | Exports full paths including transforms and groups instead of just shape names. |
| -exportType | 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. |
| -fname | Specifies the file name when exporting to multiple *.vrmesh* files. |
| -facesPerVoxel | An integer value that specifies the maximum number of faces that a voxel can hold. |
| -oneVoxelPerMesh | If specified, export each separate mesh to a single voxel. |
| -ignoreHiddenObjects | If specified, hidden objects are not exported. |
| -includeTransformation | If specified and exporting objects in separate files , bake the transformation of each object into the vertex positions in the resulting *.vrmesh* files. |
| -makeBackup | Create a backup *.ma* file containing just the exported objects. |
| -overwrite | If specified, any existing* .vrmesh* files will be overwritten; otherwise, an error will be printed. |
| -previewFaces | Specifies the number of faces in the viewport preview for the proxy object. |
| -previewType | The simplification method to use when generating a preview. Must be one of the following:
"clustering"
"edge_collapse"
"face_sampling"
"combined" |
| -lastSelectedAsPreview | Uses the last selected object as a preview mesh. |
| -pointSize | If 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. |
| -velocityIntervalEnd | A value between 0.0 and 1.0 with the time position within a frame for the ending vertex positions. |
| -velocityIntervalStart | A value between 0.0 and 1.0 with the time position within a frame for the initial vertex positions. |
| -velocityOn | If 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. |
| -vertexColorsOn | If specified, vertex color sets are also exported. |
## **Examples**
---
### 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:
**Single proxy export:**
```
vrayCreateProxy -exportType {1|2} -previewFaces $previewFaces -dir $path -fname $filename [-makeBackup] [-vertexColorsOn] [-ignoreHiddenObjects] [-includeTransformation] [-oneVoxelPerMesh] [-facesPerVoxel $facesPerVoxel]
```
**Animation export:**
```
vrayCreateProxy -exportType {1|2} -dir $path -fname $filename -animOn -animType {0|1|2} -startFrame $startFrame -endFrame $endFrame -previewFaces $previewFaces [-createProxyNode -node $newNodeName] [-velocityOn -velocityIntervalStart $velocityIntervalStart -velocityIntervalEnd $velocityIntervalEnd] [-previewType $previewType];
```
> Macro (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:
```
vrayCreateProxy -node $nodename -existing -dir $path.vrmesh -createProxyNode
```
alembic example:
```
vrayCreateProxy -node $nodename -existing -dir $path.abc -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 the name of the node in the Maya scene.
### Import/Export Material Rules Example
**Import material rules example:**
```
vrayImportProxyRules "pSphere_vrayproxy" "D:/Maya/Proxy/test.xml";
```
**Export material rules example:**
```
vrayExportProxyRules "pSphere_vrayproxy" "D:/Maya/Proxy/test.xml";
```
These commands are equivalent to the existing **Import/Export material rules** button (> Macro (inline-media-image)
), but allow for scripting.