This page provides information on the Create V-Ray Proxy window.



The Create V-Ray Proxy window allows you to save (export) mesh files so that they can be imported back into a scene using V-Ray Proxy Import.

Meshes are exported to a special .vrmesh file format. This file contains all geometric information for a mesh such as vertices and face topology as well as texture channels, face material IDs, smoothing groups, and normals. In short, everything that is needed to render the mesh is included in the file. In addition, the mesh is preprocessed and subdivided into chunks for easier access. The file also contains a simplified version of the mesh used for preview purposes in the viewports.

It is important to note that the mesh is in a "ready to render" format. No further modifications to the mesh are expected. You can't change the mesh, or animate it in any way other than animating the position/orientation of the proxy object. There is no way to recover the original mesh from a .vrmesh file (this can be done in principle, but is currently not supported). Therefore, if you plan on doing modifications to the mesh, you should keep it in a Houdini file (which may be different from the file that gets rendered in the end).

UI Path


||V-Ray Shelf|| > Export VRayProxy button






Filepath – The directory where the mesh file is saved.

Overwrite Existing File(s) – When enabled, V-Ray automatically overwrites any existing files.

Create Intermediate Dirs – When enabled, intermediate directories are created during the export process.

Objects – Specifies objects to be exported.

Save Hidden and Templated Geometry – When enabled, includes geometry that is not visible or used for a template.

Export Each Object In Separate File – Creates a different file for each selected object. The name of each file is derived from the name of the corresponding Houdini node. Unless the World Transform option is enabled, the transformation of an object is not included in its mesh file, and the corresponding proxy must have the same transformation as the original object if it is to appear in the same place. Note that you can use this option even with a single object, which will cause the object's pivot to be preserved in the exported  .vrmesh  file.

Use Last As Preview – When enabled, the last mesh that was selected using Shift + click is used as a preview mesh for the proxy.

Transform – This option is for exporting objects in separate files. It specifies if the transformation of each object should be baked into the vertex positions in the resulting .vrmesh files.

None – Transformation information is not baked.
World Transform – Each object has its world transform information baked.

Export Animation – If the mesh is animated, enable this option to export the animation in the .vrmesh file. Note that when exporting each mesh to a separate file, only the vertex animation is included in the file. Any animations that are part of the transformations of the original mesh are left there.

Animation Range – When exporting animation, this specifies how the exported frame range is determined.

Use playback range – Houdini playback range determines the exported animation range.
Use animation range – The Houdini animation range determines the exported animation range.
Custom range – Allows the user to specify a custom range using the provided input fields.

Export Velocity (slower, enables motion blur) – Enabling this option exports velocity information for the moving objects. This makes it possible to add motion blur to the final animation. However, exporting this extra information takes longer. If you are not going to need motion blur it makes sense to disable this option.

Velocity Range – When exporting velocity, this specifies the range for which velocity information is exported.

Simplification Type – Specifies the simplification method to use when generating a preview.

Face Sampling –  The method used in V-Ray versions prior to 3.1. The fastest preview method.
Simplify Clustering – This method is fast and generates a fairly precise preview mesh.
Simplify Edge CollapseSlightly slower, but generates a more precise preview mesh.
Simplify Combined – Slightly slower, but generates a more precise preview mesh.

Max Preview Faces – Specifies the maximum number of faces to display for the preview.

Max Preview Strands – Specifies the maximum number of strands to display for the preview.

One Voxel Per Mesh – Exports each separate mesh to a single voxel. This generally tends to make rendering faster if there is enough RAM, however it causes V-Ray to load the entire mesh at once, which might slow down the rendering if the dynamic memory limit is close to being reached. If you intend to use the V-Ray proxy as a geometry cache for characters or other relatively small objects, enabling this option will improve performance.

Max Faces Per Voxel – Specifies the maximum number of faces that a voxel can hold. Increase this value for meshes with a large number of faces.

Export Point Clouds – When enabled, creates a point cloud representation of the mesh.

Lowest Level Point Size – Specifies a minimum size of the disk samples for creating a point cloud.

Create Proxy – Creates a V-Ray Proxy using the above settings.


Page Contents ×