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.
sam75's picture

Hi, i don't really


i don't really understand how the exposimeter works, is there a tutorial somewhere telling how to use it properly ?


Lele's picture

I thought i fixed that a

I thought i fixed that a while back, but it's evident something slipped.
Thanks ever so much for the pointer, will look into it ASAP (atm i have no Pc to do script dev on, it will take me a week or so to get sorted).



zeronove's picture

Hi Lele, I am testing your

Hi Lele,

I am testing your exposimeter with max design 2009 (64)+VRay SP2 (64)+xp64. Everything seems to work fine with the exclusion of the "exposure-only GI settings"; when "QMC based" is selected the script returns this error:
Unknown property: "qmcgi_subdivs" in V_Ray_Adv_1_50_SP2:V_Ray_Adv_1_50_SP2

I suppose someway related with QMC vs. DMC inside maxscript

just to notify it


adytc's picture

Now it works. Thank you

Now it works.
Thank you again for your support.

Best regards,


P.S.: I'm looking forward to see your tutorial about interior rendering :)

Lele's picture
adytc's picture

Hi Lele. I've downloaded

Hi Lele.
I've downloaded your video tutorial about VRay Sun, Sky and Physical Camera and I must say that I was very happy seeing that your concept works.:) Thank you so much for sharing it with us.
Now, what I wanted to ask you is where can I get your latest script VRay_Physical_Mats_Converter (I've tried the link posted on ChaosGroup forum, but it looks dead).
Thank you again for your support.
Best regards,

Lele's picture

Make sure you used the

Make sure you used the main_install.ms script to install the pack, or nothing will work as expected.
Check that VRay is the current renderer.
Most tools check that before even starting.
Once this is all done, simply drag the commands from the Customize UI interface onto toolbars and such.

Should this not fix it, try and mail me the contents of the maxscript listener after you try and run the script.



Animaleante's picture

Hey Lele, this tools are

Hey Lele, this tools are amazing, but I'm havin problems with the maxcam 2 PhysCam. I've made the button and so...but when I click..it doesn do anything. I'm using max9and vray 1.5rc3.
Help plz
And keep up the good work!^^

Lele's picture

Just fixed the silly mistake

Just fixed the silly mistake with the matrix exposimeter's presets.
They now load properly.

Also, i gave up on the maxscript interface for the VRimg2EXR.
Way too much work, and it will be soon replaced by the Chaos' own made one, i reckon. 



cecofuli's picture

Thak's Lele, now it's much

Thak's Lele, now it's much more clean. Wink

Comment viewing options

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