You are here: Reference Guide > Filter Nodes > GodRays

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.
mask	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	Blurs the edges of the mask.
mix	mix	1	Dissolves between the original image at 0 and the full effect at 1.