GodRays

Averages together many samples of the image between its initial position and the translate and center indicators in the Viewer to produce lighting and blur effects.

The translate indicator controls the direction of the rays created.

The center indicator controls the center point for rotate, scale, and skew functions to produce motion blur.

Add color and gamma changes, or use a mask input to control the output.

Note:  Currently translate and skew do not correctly merge with other controls, such as scale - they must be done individually.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The image sequence to which you want to apply godrays.

Control (UI)

Knob (Scripting)

Default Value

Function

Godrays Tab

channels

channels

none

The effect is only applied to these channels.

If you set this to something other than all or none, you can use the checkboxes on the right to select individual channels.

translate xy

translate

0,0

Sets the position of the translate widget in the Viewer which controls the direction of the rays or blur.

Straight-line motion blur can be simulated by positioning the translate widget along the direction of motion.

rotate

rotate

0

Controls the direction of rotational rays or blur in relation to the center widget. Negative values produce clockwise rotation and vice versa.

You can also use this in conjunction with the scale control to create spirals.

scale

scale

1

Controls the direction of zoom in relation to the center widget. Values less than one zoom out and vice versa.

You can also use this in conjunction with the rotate control to create spirals.

skew

skew

0

Controls the direction of skew in relation to the center widget

center

center

1024, 778

Sets the coordinates for the center widget in the Viewer. This is the center for rotation, scale, and skew.

from color

from_color

1

Sets the color by which the initial image is multiplied.

to color

to_color

1

Sets the color by which the final image is multiplied.

gamma

gamma

1

Sets the gamma space in which colors are interpolated.

steps

steps

5

Sets the number of steps used to create the rays. The more steps you use and the shorter, and therefore smoother, the rays appear.

max

max

disabled

When enabled, only the brightest result of each image is output rather than the average.

mask

N/A

disabled

Enables the associated mask channel to the right. Disabling this checkbox is the same as setting the channel to none.

maskChannelInput

none

The channel to use as a mask. By default, the effect is limited to the non-black areas of this channel.

inject

inject

disabled

Copies the mask input to the predefined mask.a channel. Injecting the mask allows you to use the same mask further downstream.

invert

invert_mask

disabled

Inverts the use of the mask channel, so that the effect is limited to the non-white areas of the mask.

fringe

fringe

disabled

When enabled, only apply the effect to the edge of the mask.

When disabled, the effect is applied to the entire mask.

mix

mix

1

Dissolves between the original image at 0 and the full effect at 1.