Page 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 SketchUp scene and does not take any resources. This allows the rendering of scenes with many millions of triangles - more than SketchUp itself can handle.

UI Paths



||Extensions|| > V-Ray > V-Ray Objects > Export Proxy
||Extensions|| > V-Ray > V-Ray Objects > Import Proxy or V-Ray Scene

||V-Ray Objects Toolbar|| > Proxy buttons



Exporting a Mesh to a File

Exporting a mesh can be done in one of two ways: Through the V-Ray Object Toolbar, or through the Extension Context menu.

To create a proxy through the Button bar, select the group or component you want to export. The icon will remain inactive until an object in the scene is selected. When you select a group or component in the scene the Export Proxy button will become active.

Click the Export Proxy Icon to open the Export Proxy window.  

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. 


Importing a V-Ray Proxy

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

The .vrmesh files load material information in the Materials' list as a new material with a prefix the name of the file. You can change the settings of the existing material or apply a new one through the same place.

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



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 the V-Ray proxy object detail, using the preview type Whole Mesh can put substantial load on your system.



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. 


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 SketchUp - for example, by V-Ray for 3ds Max, V-Ray for Maya, V-Ray for Softimage and in the standalone version of V-Ray.

  • Proxy UV mapping cannot be modified and it is not affected by SketchUp's material size. Adjustments are possible only through the V-Ray texture placement settings.
  • Displacement of Proxy object is not supported.