Versions Compared

Key

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

...

Section
Column
width62%

The V-Ray Scene node is the result of importing a .vrscene file into your scene from the V-Ray Scene Manager. Its parameters are available in the Attribute Editor after import.

For detailed information on how to export a .vrscene file, see the Exporting and Using V-Ray Scene Files tutorial.

UI Text Box
typetip

V-Ray Object Properties can be assigned to VRayScene nodes to override properties like primary visibility, matte properties and other.

UI Expand
titleUI Path: ||V-Ray Shelf|| > Scene Manager > Import Objects > Attribute Editor > VRayScene tab

Image RemovedImage Added

UI Text Box
typetip

A VRayScene object can also be loaded by dragging and dropping a .vrscene file directly in your viewport. 

Column
width5%

 

Column
width33%

 

...

Section
Column
width62%

Disable – Turns the VRayScene object off in the render. The preview is still visible in the viewport to select the node, but the items in the vrscene do not appear in any renders.

File (*.vrscene) – The path and filename of the vrscene loaded into the Scene node. Animation vrscene can be stored either in one single file, or as a sequence of files with one file per frame. In the latter case, you can use the string <frame0n> in the file name to have it replaced with the current frame number at render time, where n is an integer number specifying the number of digits. For example, if you enter my_vrscene_<frame04>.vrscene as the file name, this will be expanded to my_vrscene_0000.vrscene for frame 0, my_vrscene_0001.vrscene for frame 1, and so on.

Load Mode – Specifies how to load the .vrscene file. 

All – Loads the .vrscene file with all its geometry, lights, shading, volumes, etc. 
Geometry – Loads the .vrscene file with geometry and shading only. This option allows instancing vrscenes using MASH or nParticles. The new scene can be exported as a .vrscene, too. See the Instancing vrscene with MASH/nParticles  examples below.

UI Text Box
typetip

 Geometry Load Mode has several advantages:

  • the instanced scene uses much less memory;
  • much faster render times;
  • makes possible of billions of instances of a geometry.

Flip Axis – Switches objects from using the Z axis in the up direction to using the Y axisControls which axis is used as a vertical - the Y or Z axes for the loaded vrscene. You can choose between:

None – No changes in the axes are applied.
Auto – It aligns the vertical axis of the vrscene with the vertical axis in the scene in cases where the vrscene was not exported from Maya. Use the Auto mode when loading a USD file.
Flip – Switches the Y and Z axes.

Add Lights – When enabled, the lights from the vrscene is used in the render.

Column
width5%

 

Column
width33%

Image RemovedImage Added



...

Anchor
examples
examples

...

UI Expand
titleClick here to expand the MASH example...

This example shows how to instance a vrscene using MASH. A .vrscene is imported with the Scene Manager. The vrscene used in this example consists of one geometry object (an owl), which has a material applied. 

In the VRayScene rollout, change the Load Mode to Geometry. This way, the scene will load only geometry and shading, but it will become available for instancing.

 

Image Modified

 

To instance the scene using MASH, create a MASH Network (MASH > Create MASH Network ). As a Geometry Type, select Instancer

 

 

Adjust the distribution of your MASH network. In the example shown, the original owl scene is instanced 9 times. The instances are distributed in a Grid, with Distance X and Z set to 50.0.

 

 

 

UI Text Box
typetip

The new scene is ready to be rendered or exported as a .vrscene, allowing you multiple instancing of one vrscene.  

...

UI Expand
titleClick here to expand the nParticles example...

Here is how to instance a vrscene with nParticles. Import the .vrscene using the Scene Manager. The vrscene used in this example consists of one geometry object (an owl), which has a material applied. 

In the VRayScene rollout, change the Load Mode to Geometry. This way, the scene will load only geometry and shading, but it will become available for instancing.

 

Image Modified

 

Create the nParticles using the nParticle tool (nParticles > nParticle tool). Select the points in the viewport that will later be instances of the vrscene. Press Enter to create the nParticle node. 

Go to nParticles > Instancer. Select the newly created instancer node and add the vrscene as an instanced object:

 

 

Once done, the vrscene instances load in the viewport and are ready to render. In the example below, the points of the instances are randomly selected. 

 

 

 

UI Text Box
typenote

Note that if you miss to select the Geometry Load Mode of the vrscene, the render will not include the instanced geometry, although it will be visible in the viewport!  

...