This page provides information on the V-Ray Scene Exporter standalone tool.
The .vrscene file format is an ASCII file that can be exported from 3ds Max. It contains information about the geometry, lights, and shaders in the scene and can be rendered with the V-Ray Standalone. Additionally the file can be used to transfer shaders from 3ds Max to Maya.
To learn how to import vrscene files, refer to the VRayScene page.
To learn how to import vrscene files, exported from Enscape, refer to the Enscape VRScene Importer page.
UI path: ||V-Ray menu|| > .vrscene exporter
In V-Ray 6 for 3ds Max this tool has been moved to the V-Ray Menu and is no longer available in the quad menu. For earlier V-Ray versions, go to 3ds Max Quad menu > .vrscene exporter. |
|
One way to use .vrscene files is to render them with V-Ray Standalone, which is included with the installation of V-Ray for 3ds Max.
Open a V-Ray Standalone command prompt from Start menu > All Programs > V-Ray 5 for 3ds Max NNNN > Tools > V-Ray Standalone command prompt. This runs V-Ray Standalone and displays all the available options. For example, if you want to render an already exported .vrscene file from frames 0 to 10, you can use this command:
vray -sceneFile="c:\temp\my_file.vrscene" -imgFile="c:\temp\render.png" -frames=1-10 |
The vrayExportVRScene MAXScript command can be used to export the current 3ds Max scene into a .vrscene file from the current viewport. The script is typically used with the name of the file to export (vrayExportVRScene <filename>). Additional flags can be used to specify certain details of what is included in the .vrscene file. A few of these flags are listed below. For a complete list, please see the V-Ray GPU Functions section on the MAXScript page. Note: The exporter takes the render settings from V-Ray GPU, thus it must be the current production renderer, otherwise default rendering settings will be exported.
Flag | Description |
---|---|
[separateFiles: true|false] | If set to true, the scene components will be split into different files depending on their type (view transformation, lights, mesh geometry, node transformations, materials, textures, and bitmaps). |
[exportLights: true|false] | If set to true, the V-Ray lights in the scene will be included in the .vrscene export. |
[exportNodes: true|false] | If set to true, all V-Ray plugin nodes in the scene will be included in the .vrscene export. |
[prefix: <prefix string>] | If the prefix keyword is specified, the prefix string will be added in front of all plugin names in the resulting .vrscene file. |
[startFrame: <startFrame>] [endFrame: <endFrame>] | If the startFrame and endFrame options are specified, an animated .vrscene file is exported for the specified frames. |
[stripPaths: true|false] | If the stripPaths option is set to true, then any assets (bitmaps, irradiance maps, IES files etc.) are only written with their file name, without the path. |
Note: Currently the .vrscene export follows the settings in the V-Ray GPU ActiveShade renderer for export of proxies, X-Ref scenes and containers, particle systems and displacement.
Currently incremental export is performed only using MAXScript. The idea behind it is exporting a sequence in portions to several files. The first file is a standard sequence export. It contains full data for the initial frame and only the modifications on it in the consecutive frames, as usual. The incremental export on the other side writes only these modifications for the frames in a new file, and then on render the complete frame data is collected using the initial export file too. These files are then included in another file which is the one we use to render the scene.
For example, prepare a scene with animation and type the following in the MAXScript Listener window:
vrayExportVRScene "S:\\incremental\\frames0-10.vrscene" startFrame:0 endFrame:10 |
The above command exports a sequence from frame 0 to frame 10 in a standard way. It is important that you specify the start and end frame – otherwise, the exported file will not contain any animation. The start frame you specify here will be the base frame for the rest of the files. For the incremental files, you need to add the parameter "incrBaseFrame". It must be equal to the start frame you used in the previous command and must be the last parameter of the vrayExportVRScene command like this:
vrayExportVRScene "S:\\incremental\\frames10-20.vrscene" startFrame:10 endFrame:20 incrBaseFrame:0 |
You can make multiple files like this but always using the same base frame:
vrayExportVRScene "S:\\incremental\\frames20-30.vrscene" startFrame:20 endFrame:30 incrBaseFrame:0 vrayExportVRScene "S:\\incremental\\frames30-40.vrscene" startFrame:30 endFrame:40 incrBaseFrame:0 |
Finally, you create a combined .vrscene by including the base file and the other files like this (combined.vrscene):
#include "frames0-10.vrscene" #include "frames10-20.vrscene" #include "frames20-30.vrscene" #include "frames30-40.vrscene" |
Use the combined .vrscene file to render any frames.