Table of Contents

This page provides information on the V-Ray Proxy Scene Geometry object. 


Overview


V-Ray Scene (.vrscene) is a file format that allows for assets, such as geometry, materials, and lights, to be shared together between all platforms that run V-Ray. It also supports animation.

A Proxy Scene object is the result of importing a .vrscene file into your scene from the V-Ray "Import Proxy or VRScene" option. Once imported, its parameters are available in the Asset Editor's Geometry tab.

V-Ray Scene materials and geometry are non-editable and lights can only be toggled on and off.

VRayScene proxies do not respond to changes during Interactive rendering. Any transformations or parameter changes of the proxy during Interactive rendering may cause unexpected behavior. This also applies when the V-Ray Live Link is switched on.




UI Paths




||V-Ray Asset Editor|| > Render with V-Ray (dropdown menu) > Export V-Ray Scene File


||V-Ray Asset Editor|| > Geometries (right-click) > Proxy Scene

||V-Ray Asset Editor|| > Create Asset (left -click) > Geometries > Proxy Scene


||V-Ray Objects Toolbar|| > Export as .vrmesh or .vrscene (VRay Proxy)


||V-Ray Objects Toolbar|| >Import a .vrmesh, .abc or .vrscene file




Rhino Menus Ribbon

||V-Ray|| Objects > Export Proxy

||V-Ray|| > Objects > Import Proxy or VRScene




Importing a V-Ray Scene


The easiest way to import a V-Ray scene, is to click on the Import Proxy or V-Ray Scene button and to choose a .vrscene file from your computer.

V-Ray Next for Rhino allows you to import .vrscene files that are exported with any other V-Ray product.

Cameras and render settings are not imported from .vrscene files even if they are present in the files themselves.




Exporting a V-Ray Scene


You can export either the whole scene or a selection of objects as a .vrscene file.

Exporting multiple objects as a .vrscene proxy is possible only when they are grouped together or included into a single component.

Exporting Through the Asset Editor

To export the whole scene, open the Asset Editor, left-click on the arrow in the lower-left corner of the render button , and press the Export V-Ray Scene File button . Another way is from the Extensions menu. You can use the V-Ray menu or the Exporter node of the Grasshopper as well.

Note that for successful export at least one of the selected objects must be regular geometry. The geometry is exported together with its shaders and lightning.

File PathThe name of the file. The file is saved in a custom folder, specified by pressing the Save File icon on the right.

Strip Paths – When enabled, all file paths of the assets in the vrscene are stripped down to file names. Conversion of the paths from absolute to relative allows safe vrscene transfer, as long as its asset files are moved to the same directory.

Hex for Meshes – Compresses geometry data in binary form to reduce its size, so it is preserved without any chance of round off errors.

Hex for Transforms – Compresses object transformation data in binary form to reduce its size, so it is preserved without any chance of round off errors.

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





Exporting Through the Toolbar Button

To create a proxy through the V-Ray Objects Toolbar, 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.

If you want to export a geometry selection, select the geometry and press the Export Proxy button. From the drop-down menu of the Mode option, choose Proxy Scene, and then press Export. Note that the geometry is exported together with its shaders and lightning.

Mode Allows you to choose between Proxy Mesh (.vrmesh) and Proxy Scene (.vrscene) export. The addition of Proxy Scenes allows you to export a selection of geometry, lights, and special objects combined into a single proxy.

File PathThe name of the file. The file is saved in a custom folder, specified by pressing the Save File icon on the right.

Overwrite Existing File When enabled, V-Ray automatically overwrites any existing file with the same name at the specified path.

Strip Paths – When enabled, all file paths of the assets in the vrscene are stripped down to file names. Conversion of the paths from absolute to relative allows safe vrscene transfer, as long as its asset files are moved to the same directory.

Replace Object with ProxyIf enabled, the source object is automatically replaced with its proxy version. Material assignments are preserved.

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




VRayScene Parameters


File Path – Specifies the VRScene file.

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

Preview Faces – Uses an automatically generated number of preview faces.
All Faces  – Displays the full model. 
Bounding Box – Displays a preview of the .vrscene using bounding boxes.
Point (Origin)  – Displays the point of origin and axes directions stored within the VRScene geometry.
Custom PreviewThis option allows for changing the proxy file without affecting/updating the preview geometry. The .vrscene 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

Face Count – Sets the preview face count for the preview if Preview Faces is selected. 

Lights – When enabled, lights from the imported VRScene illuminate the current scene. 

Be aware that depending on the V-Ray scene details, using the All Faces preview type can put substantial load on your system.

Use Mtl Override – When enabled, the global Material Override option in the Render Settings overrides the .vrscene proxy assets. When disabled, the materials in the referenced scene are not affected by the Material Override option in the Render Settings.




Animation


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 behaves. 

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. 

Animation Start – Specifies the frame used for the beginning of the animation. 

Animation Length – Specifies the number of frames used to play the animation. 




Notes


  • Any external assets associated with the imported .vrscene file need to be accessible (have valid paths) for proper render results. Such assets may include image, .ies or .vrmesh files. Alternatively, the assets need to reside in the same folder as the .vrscene file.

  • Certain effects, such as displacement, are not supported for VRScene files exported using V-Ray 3.6 or earlier.
  • Proxy Scene files exported from V-Ray 3.6 for Grasshopper cannot be rendered with the Next version (v4.0 or later) of V-Ray Standalone, V-Ray for Rhino or V-Ray for Grasshopper. There are two workarounds available:

    • Open the .gh scheme(s) and re-export the .vrscene files using V-Ray Next;

    • Manually edit each affected .vrscene file.

  • V-Ray Proxy Scene can be instanced by using the _Array command or Alt+drag in the Rhino viewport.

  • Memory usage can be viewed from the Stats section of the new V-Ray Frame Buffer.

Was this helpful?