Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: links fixed

...

Overview

...

Section
Column
width40%

The VRayLensEffects is a render effect plugin used to simulate bloom and glare lens effects by filtering the rendered image with a filter kernel. It uses V-Ray Lens Effects simulate real-world camera lens effects such as bloom and glare. This plug-in uses a fast multi-threaded technique to compute the result . The options can be accessed through the V-Ray Frame Buffer with the Open lens effects settings button.

Column
width5%

 

Column
width45%

Image Removed

 

and provide immediate update in the VFB. V-Ray Lens Effects are applied in the effectsResult channel together with other post effects executed over the RGB-rendered image.

The Lens Effects layer is accessible from the Layers panel in the VFB and can be activated when the Enable Lens Effects checkbox is selected. Lens Effects can be blended with the rest of the layers in the VFB.

The Lens Effects layer can be disabled from the visibility icon (Image Added)

The Lens Effects layer can be masked using the masking icon (Image Added). See the Masks page for more information.

...


UI Path: ||V-Ray Frame Buffer

...

|| >

...

Image Removed

Bloom Effect

 

Image Removed

 

On – Enables the bloom lens effect.

Fill Edges – Enabling this option will add pixel data outside the edges of the original image. This will remove the darkening around the edges.

Mode – Determines if the bloom will be applied to the RGB image, stored in a separate render element, or both. 

Weight – Specifies the strength of the interpolation between the filtered image and the original image. 

Size – Specifies the size of the filter as percentage of the image's width. 

Shape – Specifies the fall off of the filter.

Bloom Mask

The controls in this group control where the bloom effect will be applied to the image.

Image Removed

Intensity – When enabled, the bloom effect will be applied only around pixels that have a value larger than the number specified.

Object ID – When enabled, the bloom effect will be applied only to objects with the specified ID.

Material ID – When enabled, the bloom effect will be applied only to materials with the specified ID.

Note

The Object ID and Material ID parameters are currently disabled.

Glare Effect 

Image Removed

On – Enables the Glare Lens effect.

Fill Edges – Enabling this option will add pixel data outside the edges of the original image. This will remove the darkening around the edges.

Type – Specifies how the glare is computed. The possible values are:

From image – Takes the image specified in Glare Image as filter kernel.
From render camera – Takes the necessary parameters from the camera used to perform the rendering and automatically generates the filter kernel.
Glare type from camera params – Takes the camera parameters specified in the VRayLensEffects render effect itself and automatically generates the filter kernel.

Mode – Determines if the glare effect will be applied to the final image, stored into a separate render element, or both.

Weight – Specifies the strength of the interpolation between the filtered image and the original image.

Size – Specifies the size of the filter as percentage of the image's width.

Glare Image – Path to the filter kernel. Available if From Image option is selected. You can create filters using the Filter generator tool which comes with the V-Ray for Maya installation.

Turn On Diffraction – Enables the diffraction, producing colored patterns in the glare.

Use Obstacle Image – Enable the use of the obstacle image the path to which is specified in the field below. The obstacle image allows you to draw the aperture shape as wall as any dirt or scratches on the lens which will affect the glare

Camera Parameters

These parameters are used if the glare Type is set to From camera parameters. They enable physical camera settings that are different from the ones used to render the image and thus control the glare separately.

 

Image Removed

 

 

F-Number – The f-number used to calculate the glare. Larger values produce smaller camera aperture and stronger glare effects.

Blades – Controls whether the camera aperture has any blades and if so how many they are. This effect directly controls the number of "rays" of the glare.

Bl. Rot – Controls the rotation of the camera aperture blades.

 

Glare Mask

 The controls in this group control where the glare effect will be applied to the image.

Image Removed

Intensity – When enabled, the glare effect will be applied only around pixels that have a value larger than the number specified.

Object ID – When enabled, the glare effect will be applied only to objects with the specified ID

Material ID – when enabled, the glare effect will be applied only to materials with the specified ID

Update Control

 The options in this group control how changes to the bloom and glare effects are updated.

Image Removed

Interactive – Bloom and glare effects will be automatically recalculated and applied to the image each time an option is changed.

...

 Layers > Lens Effect

Column
width5%


Column
width45%

Image Added


Lens FX controls

...

Section
Column
width57%

Enable Lens EffectsEnables the V-Ray Lens Effects.

Size – Specifies the size of the filter as percentage of the image's diagonal. See the Size example.

Intensity – Multiplier for the bloom/glare source bright pixels. Increasing the value can boost the effect by simulating up to 20 times brighter source pixels. Values lower than 1 can be used to produce subtle bloom/glare from overbright sources. See the Intensity example.

Bloom – Controls the blend between bloom and glare. A value of 1 forces bloom to be applied to its full extent, without any glare. A value of 0 removes the bloom completely and applies only glare. Values in-between blend the two effects proportionally. See the Bloom/Glare example.

Threshold – Sets a minimum value for the rendered pixels to be considered as lens effects sources. The Lens Effects are generated only in regards to pixels with larger value than the specified threshold.

Rotation – Rotates the final result effect, regardless of whether this is a filtered image or a procedurally created one. 

Saturation – When the value is set to 0, the effects use the original hue of the bright pixels to create bloom and glare. Larger values intensify the hue set with the Cold/Warm option. See the Cold/Warm & Saturation examples.

Hardware Accelerated – Enable this option to calculate lens effects on the GPU. When multiple devices are present, V-Ray prioritizes the best one available.

Cold/Warm – When enabled, the Lens Effects are toned to cold hues. When disabled, the effects receive warm hue. The hue shift requires Saturation values larger than 0. See the Cold/Warm & Saturation examples.

Interactive – When enabled, the lens effects are automatically recalculated and applied after any V-Ray lens effects parameter change.

Update – Manually forces the recalculation of the lens effects.

Save Glare channel – When enabled, it writes the glare channel to a file when writing all channels.

Bake intensityWhen enabled, the intensity is baked in the Glare channel. Otherwise, a default intensity of 1.0 is saved, so that it can be adjusted via post-processing.

Create effectsResult channel – When enabled, it generates an effectsResult channel without needing the Denoiser render channel to be active. Otherwise, the lens effects are applied to the RGB channel instead.

Column
width5%


Column
width38%

Image Added


Anchor
size
size

...

Example: Size

Section
bordertrue
Column
width25%

Column
width50%
Image slider
minLabel1
maxLabel100
Panel
borderStylenone

Image Added

Size = 1
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 10
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 20
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 30
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 40
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 50
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 60
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 70
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 80
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 90
Intensity (constant) = 1.00

Panel
borderStylenone

Image Added

Size = 100
Intensity (constant) = 1.00

Column
width25%



Anchor
bloomglare
bloomglare

...

Example: Bloom / Glare


The Streak blur option is located under the Aperture shape rollout. It can be edited only when the Blades checkbox is enabled.

Section
bordertrue
Column
width25%

Column
width50%
Image slider
minLabel0.0
startIndex0.0
maxLabel1.0
Panel
borderStylenone

Image Added

Bloom = 0.0
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 0.1
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 0.2
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 0.3
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 0.4
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 0.5
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 0.6
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 0.7
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 0.8
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 0.9
Streak blur (constant) = 0.20

Panel
borderStylenone

Image Added

Bloom = 1.0
Streak blur (constant) = 0.20

Column
width25%



Anchor
intensity
intensity

...


Example: Intensity

Section
bordertrue
Column
width25%

Column
width50%
Image slider
minLabel0
maxLabel10
Panel
borderStylenone

Image Added

Intensity = 0
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 1
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 2
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 3
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 4
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 5
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 6
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 7
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 8
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 9
Size (constant) = 50

Panel
borderStylenone

Image Added

Intensity = 10
Size (constant) = 50

Column
width25%



Anchor
coldwarm
coldwarm

...


Example: Cold/Warm & Saturation

Section
bordertrue
Column
width25%

Column
width50%
Image slider
minLabel1.5
startIndex1.5
maxLabel1.5
Panel
borderStylenone

Image Added

Saturation = 1.5
Cold/Warm =
On
Lights shaded with pure white color

Panel
borderStylenone

Image Added

Saturation = 1.0
Cold/Warm
=On
Lights shaded with pure white color

Panel
borderStylenone

Image Added

Saturation = 0.5
Cold/Warm
= On
Lights shaded with pure white color

Panel
borderStylenone

Image Added

Saturation = 0.0
Cold/Warm
= On
Lights shaded with pure white color

Panel
borderStylenone

Image Added

Saturation = 0.5
Cold/Warm
= Off
Lights shaded with pure white color

Panel
borderStylenone

Image Added

Saturation = 1.0
Cold/Warm
= Off
Lights shaded with pure white color

Panel
borderStylenone

Image Added

Saturation = 1.5
Cold/Warm
= Off
Lights shaded with pure white color

Column
width25%



Aperture Shape

...

Section
Column
width57%

Clicking the Image Added button displays a short menu that resets all the parameters for a lens effect to their default values.

Blades – Enables the Blades effect.

Sides – Sets custom camera aperture blades number to be considered for the lens effects. This parameter directly controls the number of "rays" of the glare.

Blades rotation  Controls the rotation of the camera aperture and blades.

Streak blur – Determines the width of the angle at which glare rays spread. The larger the value, the wider the spread. If set to 0, rays are directional; if set to 1, glare rays spread out and completely blend together. Observe in the Streak blur example how values in-between change the glare rays appearance.

Peripheral grating – Enables grating along the sides of the aperture shape. 

Density – Controls the density of the grating effect in percent, where 100 is fully black.

Length – Controls the length of the grate lines.

Zoom – Controls the size of the halo around the lights.

Slope – Controls the direction of the lines.

Strength – Controls the strength of the blades effects.

Occlusion – When enabled, it controls the aperture shape by occluding part of it.

Symmetric – Enables symmetric occlusion of the shape. When disabled, the occlusion appears only on one side of the shape.

Percent – Controls how much of the shape is occluded.

Rotation – Determines the position of the occlusion over the shape by rotation.

Arc – Controls the arc of the occlusion. A value of 0 sets a straight line, while a value of 100 makes an arc.

Column
width5%


Column
width38%

Image Added



...

Anchor
steakblur
steakblur


Example: Streak blur


Section
bordertrue
Column
width25%

Column
width50%
Image slider
minLabel0.0
startIndex0.0
maxLabel1.0
Panel
borderStylenone

Image Added

Streak blur = 0.0
Bloom (constant) = 0

Panel
borderStylenone

Image Added

Streak blur = 0.1
Bloom (constant)= 0

Panel
borderStylenone

Image Added

Streak blur = 0.2
Bloom (constant) = 0

Panel
borderStylenone

Image Added

Streak blur = 0.3
Bloom (constant) = 0

Panel
borderStylenone

Image Added

Streak blur = 0.4
Bloom (constant) = 0

Panel
borderStylenone

Image Added

Streak blur = 0.5
Bloom (constant) = 0

Panel
borderStylenone

Image Added

Streak blur = 0.6
Bloom (constant) = 0

Panel
borderStylenone

Image Added

Streak blur = 0.7
Bloom (constant) = 0

Panel
borderStylenone

Image Added

Streak blur = 0.8
Bloom (constant) = 0

Panel
borderStylenone

Image Added

Streak blur = 0.9
Bloom (constant) = 0

Panel
borderStylenone

Image Added

Streak blur = 1.0
Bloom (constant) = 0

Column
width25%



Lens Scratches

...

Section
Column
width57%

Lens scratches – Enables the lens scratches effect.

Pattern – Specifies RandomStripesSquare, or Hexagonal type of pattern for the scratches.

Symmetric – When enabled, creates a symmetric pattern of the scratches. This option is available only when Pattern is set to Random.

Streaks – Specifies the number of streaks that are clustered together. If Symmetric is enabled, the streaks stem from one point with equal angles. If Symmetric is disabled, the streaks are scattered from random angles.

Density – Controls the density of the scratches effect in percent, where 100 is fully black.

Length – Controls the length of the scratches.

Slope variance – Randomizes the direction of the scratches.

Width variance – Randomizes the width of the scratches.

Seed – Specifies a seed parameter to introduce variance in the randomization.

Zoom – Controls the size of the pattern.

Rotation – Determines the position of the scratches by rotation.

Strength – Controls the strength of the effect.

Column
width5%


Column
width38%

Image Added

Lens Dust

...

Section
Column
width57%

Lens dust – Enables the lens dust effect.

Pattern – Specifies the RandomSquare, or Hexagonal type of pattern for the dust.

Density – Controls the density of the dust effect in percent, where 100 is fully black.

Radius variance – Specifies a variance in the radii of the dust dots. A value of 0 makes the dust dots uniform.

Jitter – Controls randomization of the position of the dots.

Zoom –  Controls the size of the dust dots.

Rotation – Determines the position of the dust dots by rotation.

Strength – Controls the strength of the effect.

Column
width5%


Column
width38%

Image Added

Obstacle Image

...

Section
Column
width57%

Obstacle image – When enabled, an obstacle image can be specified. You can use it to simulate various effects on the camera lens. See how this changes the lens effects in the Obstacle Image example below.

Path – Loads an obstacle image.

Zoom – Controls the size of the obstacle image. 

Rotation – Rotates the obstacle image. 

Strength – Controls the strength of the effect.

Column
width5%


Column
width38%

Image Added



...

Anchor
obstacle
obstacle

Example: Obstacle Images


Section
Column
width10%

Column
width60%


Column
width20%

Obstacle images used

Column
width10%



Section
Column
width10%


Column
width60%

Image Added


Column
width20%

Image Added

Column
width10%



Section
Column
width10%


Column
width60%

Image Added

Column
width20%

Image Added

Column
width10%



Section
Column
width10%


Column
width60%

Image Added

Column
width20%

Image Added

Column
width10%


Size (constant) = 50
Bloom (constant) = 0.5


Filter Image

...

Section
Column
width57%

Enabling this rollout disables the controls for the generated filter:

Filter image – Enables a filter image from the Filter generator tool to be used.

Path – Specifies the path to a filter kernel.

Column
width5%


Column
width38%

Image Added

Chromatic Aberration

...

Section
Column
width57%

Chromatic aberration – Applies a chromatic aberration effect to the scene.

Strength Specifies the amount of chromatic distortion from the center to the edges of the viewport. See the Strength example.

Column
width5%


Column
width38%

Image Added

Anchor
chromaticAberration
chromaticAberration



...


Example: Chromatic Aberration Strength

Depending on the Strength of the chromatic aberration, you can create different looks in your scene. You can imitate the effect of a real camera with subtle aberration, or, if you wish to achieve an artistic effect, consider increasing the Strength parameter, as in the example.

Section
Column
width10%


Column
width80%
Image slider
Panel
borderStylenone

Image Added

Strength = Off

Panel
borderStylenone

Image Added

Strength = 0.25

Panel
borderStylenone

Image Added

Strength = 0.5

Column
width10%


Aperture Preview

...

Section
Column
width57%

The Aperture Preview panel is loaded by default but can be minimized like the other Aperture groups. The aperture shape shows the result of the applied lens effects.

Column
width5%

Column
width38%

Image Added

File Names of Saved Channels

...

Channels keep their names displayed in the VFB when saving them to a single .vrimg or .exr file (using the Save all image channels to single file VFB button). The same channel names are appended to the files, when you use the VFB button Save all image channels to separate files.


Notes

...

Fancy Bullets
typecircle
  • When using Deadline for network rendering in combination with V-Ray Lens Effects, make sure to disable the Local Rendering option when submitting to Deadline. Otherwise, Deadline cannot save your V-Ray lens effects.