The V-Ray.exe project
go to table of contents

Command line parameters

One can override all of the V-Ray executable options through the command line parameters which are passed when executing V-Ray.exe.

List of V-Ray.exe command line parameters. The order of the parameters passed is irrelevant. Please note that if you wish to use blanks in the parameter values, usually in the file names, you have to put double-quotes. Note the syntax in the examples below.

Parameter Meaning Examples
-output After finishing the rendering process saves the rendered buffer to this file. Currently supported format is PNG. Make sure you use the .PNG extension - otherwise no file will be saved. The directory ,if provided, in the file name must exis -. otherwise the file will not be saved v-ray.exe -output=firstoutput.png

v-ray.exe -output="c:\program files\3dsmax50\images\my file.png"

v-ray.exe -output=c:/temp.png
-numframes Sets the numbers of frames to render before exiting. If this parameter is not set - the rendering will continue forever until the dialog box is closed manually by a user. Setting a value of -1 will cause an endless render until a user closes the dialog. v-ray.exe -numframes=4

v-ray.exe -numframes="3"

v-ray.exe -numframes=-1
-useao Turns on/off the ambient occlusion v-ray.exe -useao=1

v-ray.exe -useao=0
-incao Turns on/off the incremental ambient occlusion sampling mode.

v-ray.exe -incao=1

v-ray.exe -incao=0

-aosamples Sets the number of Ambient Occlusion samples to make per render. v-ray.exe -aosamples=2

v-ray.exe -aosamples="4"
-useaa Turns on/off the anti-aliasing supersampling v-ray.exe -useaa=1

v-ray.exe -useaa=0
-aasamples Sets the number of anti-aliasing samples per super-sampled pixel. v-ray.exe -aasamples=2

v-ray.exe -aasamples="4"
-aathresh Sets the threshold value for the anti-aliasing algorithm. Any difference in the color above this value of neighbouring pixels will force the AA to go into supersampling. v-ray.exe -aathresh="0.2"

v-ray.exe -aathresh=0.03
-vrmeshfile This vrnesh file will be imported and will be rendered. Multiple parameters vremshfile can be specified. Thus - on can import multiple vrmesh file into one scene and render it all. v-ray.exe -vrmeshfile="c:\test\mesh_01.vrmesh" -vrmeshfile="c:\test\mesh_02.vrmesh"

v-ray.exe -vrmeshfile=c:\test\kitten.vrmesh
-rtshadow Turns on/off the raytraced shadows v-ray.exe -rtshadow=0

v-ray.exe -rtshadow="1"

Examples of how to set up the V-Ray.exe through command line parameters

The following example imports two v-ray mesh files ourface.vrmesh and rabbit.vrmesh files, turns on anti-aliasing and after the user closes the GUI - saves the rendered result to c:\auto.png

v-ray.exe -vrmeshfile="C:/projects/vrayexe_tests/ourface.vrmesh" -vrmeshfile="C:/projects/vrayexe_tests/rabbit.vrmesh" -useaa=1 -output="c:/auto.png" -aathresh=0
 
The following example imports the mesh file rabbit.vrmesh, turns on ambient occlusion(AO), turns on the AO incremental sampling and saves the final image after the user closes the dialog box to c:\rabbitao.png file

v-ray.exe -useao=1 -incao=1 -vrmeshfile="C:/projects/vrayexe_tests/rabbit.vrmesh" -output="c:/rabbitao.png"
 
The following example imports the mesh file rabbit.vrmesh, turns on ambient occlusion, turns on the AO incremental sampling, sets the number of AO samples to 2 per rendered frame, renders 20 frames and afterwards closes and saves the final image to c:\rabbit20.png

v-ray.exe -useao=1 -incao=1 -aosamples=2 -vrmeshfile="C:/projects/vrayexe_tests/rabbit.vrmesh" -output="c:/rabbitao.png" -numframes=20

This help index is copyright ©2001-2004 by Chaos Group Ltd.
No part of the V-Ray.exe documentation can be reproduced without explicit permission from Chaos Group. All trademarks and copyrights belong to their respective owners. V-Ray, V-Ray.exe, V-Ray.exe documentation are property of Chaos Group Ltd.