This page describes the V-Ray Scene node in V-Ray for Maya.


Page Contents

 

Overview


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.

 


 

 


 

UI Path: ||Import .vrscene from Scene Manager|| > Attribute Editor > VRayScene tab


Parameters


 

 

Disable – Turns vrscene off in the render. The proxy preview will still be visible in the viewport to select the node, but the items in the vrscene will not appear in any renders.

File (*.vrscene) – The path and filename of the vrscene loaded into the Scene node.

Flip Axis – Switches objects from using the Z axis in the up direction to using the Y axis.

Add Lights – Loads any V-Ray lights in the vrscene file in your Maya scene.

 

Animation Overrides rollout


 

 

 

Use Animation Overrides – Enables the following parameters found in the Animation Overrides rollout.

Animation Type – Sets the way any animation in the vrscene will play within your current scene.

Loop – The animation will play from the vrscene using the Anim Length setting and if the time range in your current scene is longer than the length of the animation, it will repeat the beginning of the animation again.
Once – The animation in the vrscene will play just once and the end of the animation will hold if the time range is longer than the length of the animation.
Ping-Pong – The animation will play from the vrscene and if the end of the animation is reached, the animation will play in reverse towards the beginning of the animation and will continue back and forth until the end of the time range.
Still – The animation will hold the Anim Start frame for the duration of the time range.

Anim Start – The frame used for the beginning of the animation.

Anim Length – The number of frames used to play the animation.

Anim Offset – The number of frames shifted between the animation and the time range.

Anim Speed – The pace at which the animation will play. The default of 1 will play at the speed for which the animation was created.

 

Render Overrides rollout


 

 

 

Object ID – Overrides the object ID for all objects in the imported vrscene. If the override is not set, i.e. the value is -1 (minus one), V-Ray will use the original object IDs of the vrscene objects.

 

Render Stats subsection

 

 

 

Use Render Stats – Enables the following parameters found in the Render Stats subsection of the Render Overrides rollout.

Overall Visibility – Overrides the transparency of the object(s) in the vrscene. A value of 1 keeps everything the way it was set in the vrscene, while 0 makes them invisible, and anything in between will make them partially transparent.

Primary Visibility – When disabled, the object(s) in the vrscene will not be visible in the render.

Visible in Reflections – When disabled, the object(s) in the vrscene will appear perfectly transparent to reflection rays.

Visible in Refractions – When disabled, the object(s) in the vrscene will appear perfectly transparent to refraction rays.

Casts Shadows – When disabled, the object(s) in the vrscene will not cast shadows.

Receive Shadows – When disabled, the object(s) in the vrscene will not receive shadows.

Visible To GI – When disabled, the object(s) in the vrscene will be considered perfectly transparent to GI rays.

 

Wrapper subsection

 

 

 

Use Wrapper – Enables the following parameters found in the Wrapper subsection of the Render Overrides rollout.

 

Additional Surface Properties

Use Irradiance Map – When enabled, the Irradiance Map will be used to approximate diffuse indirect illumination for the material. If this is off, brute force GI will be used. You can use this for objects in the scene which have small details that are not approximated very well by the Irradiance Map.

Generate GI – Controls the GI generated by the material.

Generate GI Multiplier – A multiplier for the amount of GI generated by the material.

Receive GI – Controls the GI received by the material.

Receive GI Multiplier – A multiplier for the amount of GI received by the material.

Subdivs Mult. – A multiplier for the subdivisions of all secondary ray tracing done for the particular surface.

Generate caustics – When disabled, the material will not generate caustics.

Receive caustics – When disabled, the material will not receive caustics.

Caustics multiplier – Determines the effect of caustics on the material.

 

Matte Properties

Matte surface – Makes the material appear as a matte material, which shows the background instead of the base material on objects. Note that the base material is still used for calculations like GI, caustics, reflections etc.

Alpha contribution – Determines the appearance of the object in the alpha channel of the rendered image. A value of 1.0 means the alpha channel will be derived from the transparency of the base material. A value of 0.0 means the object will not appear in the alpha channel at all and will show the alpha of the objects behind it. A value of -1.0 means that the transparency of the base material will cut out from the alpha of the objects behind. Matte objects are typically given an alpha contribution of -1.0. Note that this option is independent of the Matte surface option (i.e. a surface can have an alpha contribution of -1.0 without being a matte surface).

Generate Render Elements – When enabled, V-Ray will generate Z-Depth, Velocity, Extra Texture and Multi Matte render elements for matte objects. When disabled, V-Ray will not generate any render elements for matte objects  

Shadows – When enabled, makes cast shadows visible on the matte surface.

Affect alpha – When enabled, makes shadows affect the alpha contribution of the matte surface. Areas in perfect shadow will produce white alpha, while completely unoccluded areas will produce black alpha. Note that GI shadows (from skylight) are also computed, however GI shadows on matte objects are not supported by the photon map and the light map GI engines, when these are used as primary engines. You can safely use those with matte surfaces as secondary engines.

Shadow Tint Color – An optional tint for the shadows on the matte surface.

Shadow Brightness – An optional brightness parameter for the shadows on the matte surface. A value of 0.0 will make the shadows completely invisible, while a value of 1.0 will show the full shadows.

Reflection Amount – Shows the reflections from the base material.

Refraction Amount – Shows the refractions from the base material.

GI amount – Determines the amount of GI shadows.

No GI on other mattes – Causes the object to appear as a matte object in reflections, refractions, GI, etc for other matte objects. Note that if this is on, refractions for the matte object might not be calculated (the object will appear as a matte object to itself and will not be able to "see" the refractions on the other side).

Matte for all secondary rays – Normally the base material will be used when an object with a VRayMtlWrapper material is seen through reflections/refractions. Turn this option on to have the VRayMtlWrapper show the environment when seen through reflections/refractions. V-Ray can also do projection mapping to increase the realism.

 

Miscellaneous

GI surface ID – This number can be used to prevent the blending of light cache samples across different surfaces. If two objects have different GI surface IDs, the light cache samples of the two objects will not be blended. This can be useful to prevent light leaks between objects of vastly different illumination.

 

Scene Overrides rollout


With the scene manager, a vrscene can be imported and new instances of it can be made. Each instance can have its own Override Snippet. This allows overrides to be made independently for each instance of the same vrscene.

 

 

 

Use Scene Overrides – Enables the following parameters found in the Scene Overrides rollout.

From File (*.vrscene) – The path and filename of the vrscene used to override the file loaded in the File parameter.

Override Snippet (*.vrscene) – Editor box expects data in the vrscene format.

Snippet Example:

// MATERIAL OVERRIDE EXAMPLES
//

// Create new shadeless material.
BRDFLight shadelessBrdf {
		color=Color(0.15,0.35,0.35);
		affect_gi=false;
}

MtlSingleBRDF shadelessMtl {
		brdf=shadelessBrdf;
}

MtlWrapper shadelessMtlAlpha {
		base_material=shadelessMtl;
		alpha_contribution=-1;
}

 

 

Notes


  • Currently Maya, 3ds Max, MODO, SketchUp and Blender can import vrscenes. All other platforms with V-Ray can export vrscenes.
  • .vrscene files can be exported when you turn on the Export to a .vrscene file option in the V-Ray Common tab before rendering the scene.
  • Cameras and render settings are not imported from .vrscene files even if they are present in the files themselves.
  • VRayScene supports loading sequences of vrscenes when each frame animation data is stored in a separate file.
  • VRayScene is not supported for rendering when used with MASH Instancer and Maya particle Instancer.