Versions Compared


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



Page Contents

Table of Contents


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


Image RemovedImage Added



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.


Image RemovedImage Added



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.


If Replace objects with new proxy is enabled, the original meshes will be automatically replaced with their proxy versions.

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 reapply re-apply materials through the material editor.




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



Image Added

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 (Image Added) – 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.




Fancy Bullets
  • 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.