V-Ray for Blender Quick Start Guide
About V-Ray for Blender
Installing V-Ray Standalone
Installing V-Ray for Blender
Updating V-Ray for Blender
Initial setup of V-Ray for Blender
Setting up Distributed Rendering
This guide is to serve as a reference for installation of V-Ray for Blender.
You can download the latest official version of V-Ray for Blender from http://www.chaosgroup.com with the account supplied to you by Chaos Group or your reseller.
If you experience any problems please check the Troubleshooting section. If you are still having problems please contact our support team: http://www.chaosgroup.com/en/2/support.html
In order to render with V-Ray for Blender you need:
V-Ray is a free plug-in for Blender that exports your scene into a .vrscene file which can be rendered by the V-Ray Stand Alone application. In order to use it you need to install a custom Blender build which has the V-Ray plug-in and scene exporter properly integrated.
V-Ray Standalone is a standalone application that can render .vrscene files exported from 3ds Max, Maya, Softimage or Blender. It is sold and licensed separately by Chaos Group. For more information on the licensing policy refer to the Licensing section.
Please make sure that your system fulfills these requirements before installing V-Ray.
Intel Pentium IV or compatible processor with SSE2 support
4 GB RAM and 4 GB swap minimum – recommended 8 GB or more RAM, 8 GB or more swap file
Windows XP Professional SP2, Windows Vista, Windows 7, Windows 8, 32 bit and 64 bit, Ubuntu 12.04, Apple® Mac OS® X 10.6.5 or higher (Snow Leopard)
Required for hardware lock, preferably USB 2.0.
Only IPv4 is supported. IPv6 is currently not supported.
1. Log into our website and download the installation file for V-Ray Standalone.
2. Make sure you have administrative privileges, run the installer and follow the instructions.
3. Restart your session (relogin) after the installation is complete
1. Log into our web site at www.chaosgroup.com and download the latest build for V-Ray For Blender.
2. Run the installer file.
3. Upon the start of the installation Windows may ask you for permission to run the installer with administrator privileges. Please confirm.
4. You are presented with the Welcome screen. Clickto continue.
5. You will be presented with the V-Ray for Blender licensing agreement. Please take a moment to review the agreement. Click thebutton to proceed:
6. Specify the installation path and clickto continue.
7. Chose wether to install Windows Start Menu shortcuts. Clickto continue.
8. The installation will commence and once it's complete it will show you the following screen. Click Close to finish:
Download and unpack the archive and you are ready to go.
The custom V-Ray for Blender build is compiled for Ubuntu 12.04 and later.
To install it download and unpack the archive. You should restart the session (re-login) after the installation in order for it to work.
Should any issues with dependencies arise refer to the FAQ.
V-Ray for Blender consists of several components which need to be updated separately.
V-Ray for Blender and V-Ray Standalone are updated by downloading and installing the latest available version from our web site.
The Exporter component is updated more often to address user requests. To update it go to the render settings and in the Exporter panel click on the Update Exporter button.
Please make sure that you have the appropriate administrative rights before trying to update the Exporter. To do that right click on the V-RayBlender icon and pick "Run as Administrator"
To run V-Ray for Blender go to Windows Start > All Programs >VRayBlender 2.xx> VRayBlender.
1. Choose V-Ray as a rendering engine as shown in the image below.
To enable the preview of materials and textures using V-Ray you need to select V-Ray(material preview) as a render engine.
2. Set up the render preview
V-Ray has it's own frame buffer used to preview the rendered image. To avoid rendering in both frame buffers - V-Ray's and Blenders' go to the Render Setup and in the Render panel set the Display parameter to Keep UI
3. Set up the V-Ray Standalone connection.
V-Ray For Blender will automatically detect any V-Ray Standalone installation using V-Ray's environment variables. Since there may be more than one V-Ray Standalone installed V-Ray for Blender will search for the installation path according to the following hierarchy:
- %VRAY_PATH% - this variable shows where V-Ray Standalone is installed
- %VRAY_FOR_MAYA_* - this variable shows where V-Ray for Maya is installed
- %PATH% - this variable allows you to manually specify the location of V-Ray Standalone
If you need to manually specify the vray.exe that you want to use you can do that by disabling the "Detect V-Ray" check box in the Exporter panel under Render Settings. This will show you the Path field which you can use to specify the location of the V-Ray Standalone executional file.
4. Set up the Exporter.
V-Ray for Blender is set up to work in two stages. In the first stage the scene is exported to a .vrscene file which is then transferred to and rendered by V-Ray Standalone in the second stage. For that to happen the Exporter will save the scene in a temporary folder on your hard drive:
For Windows that is C:\Users\%USERNAME%\AppData\Local\Temp
For Linux that is /tmp/
For OS X that is: /var/folders/xg/<tmp-value>/
You can also manually set the folder to which the .vrscene is exported. To that go to the Render Settings and in the Exporter panel set the Export to parameter to User-defined directory. Now you can specify a location in the field below.
Distributed rendering is the process in which several machines in a network are used to render a single image. The machine which distributes the tasks is called a Render Master and all other machines are called Render Slaves.
To set up a Render Slave you need to run V-Ray Standalone and then in the console type:
vray -server -portNumber=n
where n is the network port number that is going to be used for Distributed Rendering. Please make sure it matches the one set in the Render Master setup
In the Render Settings open the Renderer panel and enable the Distributed rendering. This will create a new panel called Distributed rendering which holds all the options seen on the right.
Set the port number. Make sure it matches the port number set for the render slaves.
Add render slaves by pressing the +/- button on the right. Specify an IP address or host name. You can use the check box on the right of each Render slave to quickly include or exclude it from the distributed rendering.
All machines need to have access to the scene assets. V-Ray could automatically transfer all needed assets by enabling the Transfer Assets checkbox.
If you choose to disable that option (not recommended) you will need to manually specify the type of network used and the location of all render assets
V-Ray for Blender is still being developed. If you encounter an issue please submit a bug report so that we can fix it in the upcoming builds.
To do that once you experience an issue open the Blender System Console by going to Window>System Console and perform the same steps you did when you got the issue. Copy the contents of the system console and submit it at https://github.com/bdancer/vb25/issues