This page provides information on the Light Meter.


Page Contents



The VRayLightMeter helper is an aid for evaluating how a scene is illuminated. It is intended to simulate the use of a real-life light meter used in photography and film production.

The VRayLightMeter helper is a grid placed in the scene to gather information about the lighting in the grid's location. After creating and positioning the grid and setting parameters, click Calculate to calculate the lighting. The lighting information can be displayed in the viewport as colors and text on the grid representing different levels of light, and can be also saved in text form to a CSV file.

The information presented by VRayLightMeter does not change or otherwise affect the lighting in the scene; it only reports on it. This helper is intended to provide information so you can make adjustments to the scene's lighting at your own discretion.



 UI Paths:

 ||Create menu|| > Helpers > V-Ray > V-Ray Light Meter > Click and drag in viewport

 ||Create panel|| > Helpers > VRay category > VRayLightMeter button > Click and drag in viewport







Active – Enables or disables the VRayLightMeter helper.



The options in this group allow us to specify the dimensions of the light meter tool and its resolution - the number of points at which the illumination will be measured.  

Width – Width of the VRayLightMeter.  

Length – Length of the  VRayLightMeter.  

Width segs – Resolution of the VRayLightMeter in the X direction.

Length segs – Resolution of the VRayLightMeter in the Y direction.  



The settings in this group control the way the illumination information is represented in the viewport.  

Orientation – Enables or disables the preview of the direction from which the light is coming.

Viewport text – Enables or disables the preview of the actual values of the illumination for each point.

Pseudo Colors – When enabled, the VRayLightMeter will display a gradient to illustrate the variation in the illumination.  

Logarithmic  – Changes the illumination scale to Logarithmic for the purposes of displaying it in the viewport . This is useful when there is a great variation in the illumination.
 – Specifies the minimum illumination displayed in the viewport in lux.
 – Specifies the maximum illumination displayed in the viewport in lux.  

Measured values – Specifies which part of the illumination in the scene will be measured:  

Total illuminance – The total illuminance will be measured, which includes direct light, GI, and light coming from the environment.
Direct illuminance
– Calculates only the illumination from direct lighting.
Indirect illuminance
– Calculates only the effect of the indirect illumination.
Day light factor
 – Calculates the illumination coming from the sky.  

Calculate – Press this button to calculate the measured values at light meter helper's grid points.  

Save to CSV file – Saves the result in a .csv file.


MaxScript Methods

The following methods of the  VRayLightMeter  object are accessible from MaxScript.


VRayLightMeter MethodDescription


Calculates the values along the light meter grid.
saveCSV<filename>Saves the values from the grid into the specified text file, in CSV (comma separated values) format.



  • The VRayLightMeter helper is based on the texture baking and render elements functionality of the V-Ray renderer.
  • The VRayLightMeter helper uses brute force GI with 100 subdivs and 100 bounces to calculate the measured values regardless of the GI engine selected, and regardless of whether GI is enabled in the scene.