Table of Contents

This page provides information on V-Ray Proxy Mesh objects.



V-Ray Proxy Mesh allows geometry to be imported from an external mesh at render time only. The geometry is not present in the Revit model and does not take any resources. This allows the rendering of objects with many millions of triangles - more than Revit itself can handle.

For more information, see the Courseware section.


UI Path


Creating Proxy Mesh:

||V-Ray Asset Editor|| > Create Asset > Geometries > Proxy Mesh

||V-Ray Asset Editor|| > Geometry > Proxy Mesh


Assigning Proxy Mesh:

||Appearance Manager|| > Families Tab > V-Ray icon menu > Proxy Mesh


You can also drag-and-drop a V-Ray mesh from the V-Ray Asset Editor onto any geometry listed in the Families tab of V-Ray Appearance Manager. 




V-Ray Proxy Meshes can be imported from two places in the Asset Editor: the Create Asset button and the Geometry category icon (top). Importing a V-Ray Proxy Mesh, however, doesn't add it to the Revit model and respectively to the V-Ray rendering yet. The V-Ray Proxy Mesh then must be assigned to a selected object from the Families Tab in the Appearance Manager. This can be done by either drag-and-dropping the mesh to the Appearance Manager, or from the V-Ray menu icon.

You can import a .vrmesh or an .abc file from your computer. Once the file is loaded into the project, you will need to re-apply materials through the Materials rollout.



The .vrmesh File Format

The .vrmesh file is a special file format that stores Meshes. 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. 

It is important to realize that the mesh is in a "ready to render" format, so further modifications to it are not possible. 




File – Specifies the proxy file.

Use Mtl Override – When disabled, the built-in material slots are not overridden by the global material override options located in the Appearance Manager's Global Overrides tab. 


Materials – When enabled, ignores any material assignment to the proxy object and instead forces the proxy to be rendered using the colors or materials specified in this list.

When a proxy asset is saved as a .vrmat file, both its source file (.vrmesh or .abc) and its referenced material asset files (texture maps) are saved along in a subfolder called Maps.


The Animation rollout settings are not supported yet in Revit.

Enabled () – Turns the Animation on and off.

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

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.