Getting Started with Commands

This page provides some basic examples of command line options to get you started with V-Ray Standalone.

Overview

When V-Ray Standalone is started, there are two usage options:

vray -server;

or

vray <option> <option>,

where option (case-sensitive) is one of the following: [] means optional string, {} means the string can be repeated zero or more times.

For full list of commands, please visit the V-Ray Standalone Command Line Options page.

Examples

Render a scene

In this example an input .vrscene file path is specified and an output image file is specified. If you want to save the output render in a specific location, use the full path for -imgFIle, otherwise it is saved to the scene location.

<code><span class="line"><span>vray -sceneFile="D:\Scenes\owl.vrscene" -imgFile="Owl_Render.png"</span></span></code>

Set frame width/height:

<code><span class="line"><span>vray -sceneFile="D:\Scenes\owl.vrscene" -imgFile="Owl_Render.png" -imgWidth=500 -imgHeight=500</span></span></code>

Set camera for vrscenes with multiple cameras. The name should correspond to the camera settings scene_name parameter:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -camera="VRayCam001"</span></code>

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -camera="VRayCam003"</span></code>

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -camera="PhysCamera004"</span></code>

Specify a render region:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -region=113;86;329;309</span></code>

Specify animation frames:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -imgFile="Owl_Render.png" -frames=1;3;7</span></code>

Alternatively, you can also set animation frames to be rendered in ranges:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -imgFile="Owl_Render.png" -frames=1-7 -frames=10-15</span></code>

Select rendering device - CPU as RT engine:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -rtEngine=1</span></code>

Select rendering device - CUDA:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -rtEngine=5</span></code>

Select rendering device - RTX:

Remapping a scene path location:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" remapPath ="D:\Scenes\Assets\"="D:\Scenes\New\Assets\"</span></code>

Include vrscene files exported as separate files:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -include="D:\Scenes\owl_geometry.vrscene" -include="D:\Scenes\owl_lights.vrscene"</span></code>

Override Secondary GI Engine to Brute Force using PluginType::parameterName format:

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -parameterOverride=SettingsGI::secondary_engine=2</span></code>

Delete resumable rendering file after successful render

<code data-v-c2b1f83f=""><span data-v-c2b1f83f="" class="line">vray -sceneFile="D:\Scenes\owl.vrscene" -imgFile="Owl_Render.png" -resume=1 -deleteResumableFileOnSuccess=1</span></code>