You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

 This is a legacy documentation space! Please refer to V-Ray Next for Rhino help for most up-to-date information.

Page Contents



V-Ray Proxy allows geometry to be imported from an external mesh at render time only. The geometry is not present in the Rhino scene and does not take any resources. This allows the rendering of scenes with many millions of triangles.

V-Ray Proxies can be created and imported through the V-Ray Proxy tab of the V-Ray Toolbar, and they can be managed from the Geometry tab of the V-Ray Asset Editor.



Exporting a Mesh to a File

To create a V-Ray Proxy, select the desired mesh or meshes to export into the proxy file, then right-click the Export Proxy icon. Alternatively, you can click the Export Proxy icon, select the mesh(es), then press the Enter key.

The V-Ray Proxy Creation window will appear with options for saving the proxy file.




File Path – The name of the file. The file will be saved in a custom folder, specified by pressing the Save File icon on the right.

Preview type – Chooses the method for generating the proxy preview:

Face Skipping (very fast)  – The fastest preview method.
Refined Clustering (quality)  – Slightly slower, but generates a more precise preview mesh.
Vertex Clustering (fast) – This method is fast and generates a fairly precise preview mesh.

Faces in Preview – Specifies how many faces are going to be used to show a preview of the proxy in the viewport.

Overwrite Existing File – When enabled, V-Ray will automatically overwrite any existing vrmesh files.

Replace Object with Proxy – Enables the original meshes to automatically replace their proxy versions.

Export – Exports the .vrmesh file to the specified folder. 


When making a proxy there is no way to recover the nurbs information or data once the geometry is converted into a proxy.  Make a backup of your nurbs data if you want to preserve the original nurb geometry.


Import a V-Ray Proxy


To import a V-Ray mesh, right-click the Import Proxy button and choose a previously created .vrmesh file from your computer. Once loaded into the scene you will need to re-apply materials through the material editor.

Note that .vrmesh files do not save specific material information. You must save and reload the materials manually, or save the proxy file inside a Rhino file for later use as a component.

Right-clicking the Import Proxy button also gives you the option to load a .vrscene file


Basic Parameters


Main Parameters

File – Specifies the proxy file.

Preview Type – Specifies the viewport preview mode.  This does not affect the final render. 

Proxy Preview – Portions of the mesh will be previewed in the viewport with some faces hidden.

Whole Mesh – The entire mesh will be previewed in the viewport.

Bounding Box – Previews are shown as bounding boxes.

Point (Origin) –Previews the mesh as a bounding box outline with its own point of origin and axes indicators.

Custom Preview – This option allows for changing the proxy file without affecting/updating the preview geometry. Proxies in existing projects will be loaded with the Custom Preview enabled by default making sure that no custom user preview geometry gets deleted by the automatic update. 

Be aware that depending on your V-Ray proxy object detail, using it in Whole Mesh preview type can put substantial load on your system.



Animation Parameters

Enabled () – Turns the Animation on and off.

Playback type – Determines how playback will behave. 

Loop – The animation plays to the end and loops back to the first frame once it has finished.

 Once – The animation plays once.

Ping-pong – The animation is looped by playing it backwards once the last frame has been reached and then playing it forward again when the first frame is reached again.

Playback Speed – A multiplier for the speed of the animation. A value of 1.0 plays the animation at normal speed, while 2.0 plays it at double speed and 0.5 plays it at half speed. Putting negative numbers here will make the animation play backwards. This option may not work very well for sequences of .vrmesh files. 

Start Offset – Offsets the beginning of the animation by the given number of frames. The default value of 0.0 starts the animation at the first available frame. You can use positive as well as negative values here. 

The .vrmesh File Format

Meshes are exported to a special .vrmesh file format. It contains all geometric information for a mesh - vertices and face topology as well as texture channels, face material IDs, smoothing groups, normals - in short, everything that is needed to render the mesh. In addition, the mesh is pre-processed 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 realize that the mesh is in a "ready to render" format. No further modifications to the mesh are expected. Modifiers cannot be applied to the mesh, and it cannot be animated it in any way except for the proxy object's position/orientation.


  • If several proxies linked to the same .vrmesh file need to be created, it's better to make them blocks - this will save memory since the .vrmesh file will be loaded only once.
  • The resulting .vrmesh files can be rendered outside of Rhino - for example, by V-Ray for 3ds Max, V-Ray for Maya, V-Ray for Softimage and in the standalone version of V-Ray.
  • Be aware that depending on the V-Ray proxy object detail, using the preview type Whole mesh might put substantial load on your system.