This pages outlines some of the most common error and warning messages printed by V-Ray for Maya.
When V-Ray for Maya encounters a problem that prevents it from working properly, a message is displayed indicating what operation has failed. The messages and this reference guide are intended to help you understand what has gone wrong and what steps can be taken to fix the problem or work around it. Error and warning messages are usually printed either in the Maya script editor or the Maya output window. When using Distributed Rendering or V-Ray Standalone, the V-Ray console or terminal where the process is running also prints errors and warnings.
Maya Script Editor
UI Path: ||Windows|| > General Editors > Script Editor
Maya Output Window
Standalone Command Prompt
The contents of the Output Window on Linux and macOS is printed in the console when Maya is started with the Maya application/executable from a console/terminal.
A Fatal Error message means that V-Ray has encountered a crash and has managed to catch the error while preventing the application from exiting directly to desktop.
There are a few different Fatal error messages that you may see during rendering:
If you see a Fatal Error message when rendering, contact the Chaos Group support team with information on how to reproduce the crash. Usually, sharing a scene and the V-Ray logs, along with any steps to reproduce the issue helps the team identify and fix the problem.
An Unhandled exception message means that V-Ray has encountered a crash and has managed to catch the error while preventing the application from exiting directly to desktop.
If you see an Unhandled exception message when rendering, contact the Chaos Group support team with information on how to reproduce the crash. Usually, sharing a scene and the V-Ray logs, along with any steps to reproduce the issue helps the team identify and fix the problem.
Scene bounding box is too large
With extremely large scenes there is a slight chance that a ray misses its target and hits something next to it.
In general, it's safe to ignore this warning, as it may appear when rendering very large scenes, but the chance of actual rendering errors is very slim. However, if you experience issues that you think are related to a very large scene scale, please contact the Chaos Group support team. Keep in mind that sharing a scene and the V-Ray logs, along with any steps to reproduce the issue helps the team identify and fix the problem.
Translator options are disabled
This message means that both the Render and Export to a .vrscene file options are disabled in the Render Settings > Common tab > Translator rollout.
At least one of these two options needs to be enabled for V-Ray to have a task to perform when rendering is started.
Could not get the renderer
This message may appear when V-Ray was required to load but couldn't for some reason.
Check the Maya plugin manager from the Maya Windows menu > Settings/Preferences > Preferences > Plug-in Manager. Click Loaded for vrayformaya.mll and enable Auto load for V-Ray to load each time Maya starts.
In case V-Ray cannot load at all, contact the Chaos Group support team.
Node is not expected as texture input
Some inputs of V-Ray materials and textures expect specific node types and don't work with otheres. For example, the diffuse of VRayMtl expects a texture input and won't work if a material is connected there instead.
In such cases, a message similar to the one below will be printed:
The message notifies of the exact names of the unexpected input and where it is connected. Break the specified connection and use a supported input in its place.
File texture used as normal map has a color correction enabled
Textures used as a normal maps should not have color corrections, as this may lead to unexpected results. If a texture is connected to the Bump Map input of a V-Ray material and Maya's color management is enabled setting the color space for this texture to anything other than Raw, this message will appear:
The message notifies of the exact file node that needs to be set to linear color space. Disable the color corrections for the file node used for normal mapping by selecting the file node, and in the Attribute editor, setting the Color Space option to Raw.
Unsupported primitive type for XGen description
When XGen is used with Primitive Type set to Archive and Use vrscene cache is enabled in the Preview/Output tab of the XGen window, this message may appear in case the vrscene cache does not contain the correct archive geometry.
Recache the vrscene to fix this by selection the XGen description, and in the XGen window > Preview/Output tab click Export vrscene cache.
While it is technically possible to have negative overscan and it is supported with OpenEXR, the overscan value cannot be more than the image region. For example 960x540 and your overscan on one side is -960 or more.
Set a lower overscan value in Render Settings > Overrides tab > Camera rollout.
The Cache representation has no material attached
When using Scene Assembly with the active representation set to GPU cache, V-Ray needs to be specifically instructed for the material to apply on the GPU alembic cache geometry. This is done with Extra V-Ray attributes on the assembly definition node.
Select the assemblyDefinition node. In the Attribute Editor, select Attributes > V-Ray > Scene Assembly. This will append a new rollout to the bottom of the Attribute Editor. Connect the material to the GPU Cache Shader input. See the Scene Assembly page for more details.
The selected particle render type doesn't have radius
VRayMetaball only works with particle types that have a radius attribute. Such particle types are points and spheres. If another particle type is used with VRayMetaball, the following message will appear:
The message notifies of the particle system that is set to an unsupported particle type. Select the specified particle shape node and in the Attribute editor, set the Particle Render Type to Points or Spheres in the Shading rollout.
The current render devices selection will be used only for the current Maya session
The selection of devices for use with GPU rendering from the Maya UI is stored between sessions only on Windows and only for the same user. On macOS and linux, the selection cannot be stored between sesscions and the warning is printed:
If you want to make the selection permanent, it is recommended to use the VRAY_GPU_PLATFORMS environment variable. See the Environment variables page for more details.
V-Ray doesn't support frames at non-integer times in DR
V-Ray doesn't support frames at non-integer times for Distributed Rendering. If you are starting a distributed render from a non-integer frame time such as 1.23, 5.75, 12.5, etc, the following message will be printed:
Set you current time to an integer (whole) number like 1, 2, 20, etc. Avoid starting DR from non-integer frames like 1.2, 20.5, etc. You are rendering from a non-integer frame or your animation starts with such - eg 1.598 - DR can't work with that, integer frame numbers are required , like 1 or 2.
Texture is enabled, but no texture is connected
Enabling the usage of a texture for the Rect or Dome light expects a file node to be connected to the texture input. If texture usage is enabled, but no texture is connected, this warning will be printed:
Disable the Use Tex option for the Rect or Dome light or connect a texture.
Unable to set the value for intensity
The intensity attribute of the light is probably locked when you have tried to change the units. Changing the intensity units does a conversion to the intensity value and the intensity attribute needs to be modified.
Unlock the intensity attribute of the light.
Wrong transformation used in the pre-render stage
When rendering animation, V-Ray does a pre-render export to potentially cache the entire camera animation path. However, in some cases and especially with Maya Hair, the pre-render export is evaluated in batch mode, even though it is not required.
Such evaluations have long been disabled for batch rendering, both by Maya and V-Ray, but there are some rare cases where the new behavior leads to unexpected results, for example when using the camera path and fly-through options of the Light Cache or the Irradiance Map. The MAYA_ENABLE_PRE_RENDER environment variable reverts to the old behavior when set to 1.
Use MAYA_ENABLE_PRE_RENDER=1 if there are rendering issues.
File name prefix contains invalid character
Some characters are reserved for special use in Maya. This error usually appears when the ! or $ sign is used in Render Settings > Common tab > Image File Output rollout > File Name Prefix field.
Refrain from using the ! or $ sign in the File Name Prefix field.
VRay environment volume is already set
This message may appear when creating a VRaySphereFadeVolume node.
There's a few things to keep in mind when creating a VRaySphereFadeVolume node:
- If there is no VRaySphereFadeVolume in the scene, it is created and connected to vraySettings.cam_environmentVolume
- If VRaySphereFadeVolume exists and is not connected to vraySettings.cam_environmentVolume, there are the following cases:
- if nothing is connected to vraySettings.cam_environmentVolume, VRaySphereFadeVolume gets connected to it
- if there is another node connected to vraySettings.cam_environmentVolume, error is printed and nothing is done