VRayScene

This page provides information on the VRayScene node.

Overview

VRayScene allows for assets to be shared between all platforms that run V-Ray. It loads a previously saved .vrscene file into V-Ray for 3ds Max and supports rendering geometry, lights and materials. In addition, it allows you to load scene overrides from a .vrscene file.

VRayScene can also be used to load a USD file. For more information on USD in V-Ray, see the USD page.

To learn how to export a .vrscene file, refer to the V-Ray Scene Exporter page.

To learn how to import a .vrscene file previously exported from Chaos Enscape, refer to the Enscape VRScene Importer page.

UI Path

Parameters

Enabled – Enables or disables loading of the .vrscene.

File (*.vrscene) – Allows you to browse for and specify the .vrscene file. Please note that you can also load a V-Ray Scene by dragging and dropping a .vrscene file directly in your viewport. To specify that a file is a part of a sequence, the string <frame0n> should be added in order to replace the current frame number, where n is the frame padding. For example scene_01.vrscene needs <frame02> to load the sequence; scene_001.vrscene -<frame03>; scene_0001 - <frame04>.

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.

Flip Axis – Controls 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 3ds Max. Use the Auto mode when loading a USD file.
Flip – Switches the Y and Z axes.

Scale – Allows the vrscene or USD to be quickly scaled up or down.

Add Lights – When enabled, uses any lights in the .vrscene file.

Animation

Use Anim. Overrides – Enables Animation overrides.

Playback – Specifies how to read the animation in the .vrscene.

Loop – Plays the entire animation, then restarts on the initial frame.
Play once – Plays the animation once, then displays the last frame of the animation for all further frames.
Ping-pong – When the end of the animation is reached, the animation is reversed.
Still – Displays only one frame.

Start – Sets the frame for the first frame of the animation.

Length – Sets the length of the animation. If this value is less than the total number of frames, the animation is clipped. If it is greater than the number of frames, the Type option determines how the extra frames are interpreted.

Offset – Shifts the start frame.

Speed – Speed multiplier for the animation. A value of 1 plays the animation at normal speed.

Scene Overrides

Use Scene Override – Enables the scene override.

From File (*.vrscene) – Allows you to specify a .vrscene that will be used for the scene override.

Edit Override Snippet – Launches an editor window that allows code snippets for editing the scene override settings.

Snippet Examples:

Example: Material Override

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">//Material Override Example</span><span data-v-c2b1f83f="" class="line"> </span><span data-v-c2b1f83f="" class="line">//Override object's assigned material</span><span data-v-c2b1f83f="" class="line">Node <Sphere001*>{</span><span data-v-c2b1f83f="" class="line"> material=Asphalt;</span><span data-v-c2b1f83f="" class="line">} </span></code>

Example: Disable Light

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">//Light Override Example</span><span data-v-c2b1f83f="" class="line"> </span><span data-v-c2b1f83f="" class="line">//Disable a light</span><span data-v-c2b1f83f="" class="line">LightRectangle <VRayLight001*>{</span><span data-v-c2b1f83f="" class="line"> enabled=0;</span><span data-v-c2b1f83f="" class="line">} </span></code>

Example: Object Visibility

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">//Object Visibility Example</span><span data-v-c2b1f83f="" class="line"> </span><span data-v-c2b1f83f="" class="line">//Make an object invisible</span><span data-v-c2b1f83f="" class="line">Node <Teapot001*>{</span><span data-v-c2b1f83f="" class="line"> visible=0;</span><span data-v-c2b1f83f="" class="line">} </span></code>

Viewport Parameters

View as – Controls the display of the V-Ray Scene in the viewport. This does not affect the final render.

Bounding box – Displays vrscene meshes in the viewport as boxes.
Face skip – Previews the faces of the vrscene meshes.
Vertex cluster – Represents the vrscene meshes in the viewport as vertex clusters.
Refined cluster – Represents the vrscene meshes in the viewport as refined vertex clusters.
Full mesh – Shows the vrscene geometry as full meshes.

Decimation – When enabled, controls the quality of the preview for Face skip, Vertex cluster, and Refine cluster modes. Lowering the Decimation value, refines the preview.

Draw Lights – When enabled (default state), displays vrscene lights in the viewport.

Draw Hair – When enabled (default state), displays vrscene Hair in the viewport.