Lele's Vray Tools

155 votes
V. 1.41ss - SP2
Date Updated: 
Author Name: 
Emanuele Lecchi

A set of tools to aid in the daily VRay work.

Updated to install with Max 2014.

WARNING: there is NO guarantee than any of the tools will work as intended, that they won't break your scenes in dramatic fashion, or skin your cat while you aren't looking.
This update comes purely because i needed the Physcam Autofocus for a personal test, and noticed they didn't install or run.
Having lost the source code for the encrypted parts, all i could do was to patch fix the (very ugly, with hindsight) installer and individual script launchers.
At least the autofocus routines still work in vray 3.0.
Feel free to let me know of issues, but also know that without a complete rewrite (quite unlikely), the fixes won't be forthcoming.

Updated for VRay 1.5 SP2.

The installer from V. 1.4ss - SP2 onward now has an option to automatically add the scripts to a ctrl+shift+alt quadmenu.
Notice it should append the scripts to whatever is already in the quadmenu (nothing, by default).
Please report any odd behavior, or undesired effect: it's a first attempt at the code, and may contain issues.

Anything to Physcam v.1.4: converts max standard cameras and viewports to VRay Physical Cameras, along with FoV animation.V.1.4 corrects a bug with camera views conversion, copies across clipping planes' ranges , and allows for individual camera naming at creation, rather than later by hand.

Matrix-Weighted Exposimeter V. 1.21 : very similar in principle to that of dSLR, it allows for different weighting of each slice/square in which the image is divided, as well as allowing a different range of pixel brightnesses to be chosen for the exposure (akin to real world lens filters).
Entirely customisable for behaviour.Now with auto-white balance and preset manager!

From V. 1.16 it supports exposure / White Balance animation through the script.
Please note this is not meant to be a frame by frame tool: doing so will result in flickering (like for standard dSLRs) and will likey lead to max crashes due to maxscript memory heap overload.
Keep previews small, Nth frame at around 1 second, and go in and refine by hand activating "Auto Key" from the max interface and exposing the problematic areas.

The Sample Rate calculator, new with 1.19, is an early attempt at DMC AA optimisation.
It will render a sample pass with whatever DMC AA (ONLY!) settings you have, analise the sample rate, and guestimate a new threshold value (AA noise threshold only) so that the BIAS setting may be met (+- 2.5%).
The BIAS indicates the pixel brightness average in the sample pass (where ~0 is min sampling, and ~1 is max sampling).
V.1.21 fixes the inconsistencies in vray versions when using QMC (now brute force) as a method for exposure GI.

Physcam Auto-Focus:Finds the closest object surface directly in front of the camera, and focuses the VRay Physical Camera to it.
Added DoF Preview rendering (near-realtime) for Physical Cameras which have been created with the Physcam Converter Script (so physical cameras parented to, and overlapping perfectly, a standard one) .
The function works only under Max2008, due to the fact that previos viewport grabbing methods would refresh the framebuffer before grabbing, losing the DoF effect. Implementation for earlier versions is possible and under study.
A drawback of the new grabbing method, though, is that you'll have to have the current viewport (the one selected just before pressing the script button, any viewport will do.) free of dialog boxes and such, as the grab will read from video memory and grab those as well.
For this reason, the script now pops up in the BOTTOM RIGHT CORNER of your screen, away from what's normally the camera view.

Please note that the preview is NOT accurate as to the Physcam. It's just meant as a visual queue to understand where the camera has focused.

VRay Realtime Sky V.1.01: Allows realtime update of the VRay sky in viewport, through any change of sun position or parameter. Changes the Sun intensity for DISPLAY ONLY, not at rendertime, to allow for sky visibility without a Physical camera exposure. IMPORTANT NOTE: it's strongly suggested to keep the Background Texture Size at something like 256 in the vieport driver preferences to obtain optimal realtime performance. If updates seem sluggish, slow, or impossible, that's what you want to change.
Updated the to refresh the viewport as soon as it's activated, and changed the viewport-only multiplier to 0.02 to better reflect the default Physcam camera exposure for the new Vray Sun and Sky models.

VRay rendertime infos 1.2: Shows some useful settings while vray is rendering, to allow for easy troubleshooting of scenes that seem to render for "too long", without interrupting the rendering phase Now with material interpolation min/max settings.Added in some GI options (don't render final image, GI modes and so on)

VRay Light Monkey V0.3 : allows for mass change of vray light's properties, for selected or all, in very quick fashion.Updated for 1.5 Final-sp1

VRay stuff collector V.1.1: Collects VRay specific objects and maps (proxies, VRay HDRI maps and so on) along with the max file and normal maps into a folder Now with support for IES profiles

Physcam parameters cloner: allows for quick copy/paste operations on VRay Physical Cameras

Physcam Presets Deck: Similar to the one above, but with a neat 12-slots deck which is session persistant and immediate in its usage

PPT/LC calculator: Expresses sample sizes in pixels (rather than normalised image ratio) and subdivs as shading rates (rather than absolute numbers)


Additional Info: 

Unpack the rar file into a temp folder, and RUN (it's not an i-drop package. use "maxscript->run script") main_installer.ms.
Check/uncheck what scripts you want installed, choose to deep-delete old files if you're on max 9 (useless in max 8), and press the install button.
You'll then find them into the "Customize->CustomizeUI->Lele's
VRay Tools" category, and will be able to assign them to a menu, a
button, a quadmenu or a keyboard shortcut.

Remember to save the UI configuration after you've done so, so to preserve the assignments on the next max run.

The scripts are released as donationware: if you like them, and/or use them for a commercial production, make sure you get the "i'm feeling generous" mood going, and drop a symbolic donation at the provided email address on paypal.

Version Requirement: 
3D studio max 8 - 11 (32 or 64 bits), VRay RCx, Final, SP1 and SP2 (32/64 bits)
leles_script_pack_1.5_sp2_max_2014.rar142.78 KB


Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
patrick dyer's picture

Vray Camera converter

Hey Lele, any chance of updating this script so it works with max 2017 and V-ray 3.3 please?

stmalk's picture

not working in 2016

Vray Camera convert doesn't work in 2016 with 3.40 Vray. It gives you an error "not creatable"
and this line is highlighted in the editor:

"VRcam = VRayPhysicalCamera whiteBalance_preset:4 whiteBalance:white name:(VRcamName) isSelected:on"

3dwannab's picture


Silly me. I got carried away. The lights were set as sky portals therefore greying out the intensity.

Help says:
Skylight portal - when this option is on, the Color and Multiplier parameters are ignored; instead the light will take its intensity from the environment behind it.

Sorry to bother you.

MaximuM's picture

Not greyed out for me

I can't replicate that problem here with VRay Light Lister - v4.0 on Max design 2015.
Maybe a fresh new install would solve your problem ?

3dwannab's picture

Locking light intensity

When run on multiple/selected lights it greys out the light intensity of each one. Does it make them references or something?

greyed_out.jpg 75.72 KB
not_greyed_out.jpg 83.86 KB
MaximuM's picture

I have found a workaround

Thank you.
I have found a workaround: I manualy run the VRayLightMonkey.mse file located in the usermacro directory and it works.

Lele's picture

eh, I noticed, and can

eh, I noticed, and can replicate it.
Will look into it, for what's possible with the code i have left un-encrypted.


MaximuM's picture

UI configuration not saved

Thank you for the LightMonkey script, very usefull although it would be nice to have it work for regular 3dsmax lights too.
I have a problem: even though I saved the UI using the "Save custom UI scheme" option, I have to run the installer each time I run 3dsmax otherwise I can no longer use your scripts (I created a toolbar for LightMonkey and it is greyed out).
Any idea for what I have to do ?
Thank you in advance,

segar's picture


Thanks a lot Lele, You did a very good job :)

Lele's picture

oh damn, if i noticed! I

oh damn, if i noticed!
I didn't open this page for YEARS, and only now realised you did my work for me! :P
Well, it was a three minutes job, so no worries, and thanks anyways!



Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.