/
PxrGoboLightFilter

PxrGoboLightFilter

PxrGoboLightFilter projects a painted texture in front of the light.

This light filter is a simple version of PxrCookieLightFilter.

 


 

Parameters

 

Map

Filename of the projected texture. If you want to control the blur for the projected edge, include the mask into the alpha channel of this map. Otherwise, it will use a white opaque alpha installed on $RMANTREE/lib/textures/white.tex for blurring when blur is > 0.

gobo_map1.jpg
gobo_map2.jpg
gobo_map3.jpg

Fill Color

If the texture's tile mode is not repeating, this specifies the color for the region outside of and behind the projected rectangle. When we specify a blur below, the edge of the projected rectangle will be blended with the fill color.

gobo_fillColorBlackLightColorGreen.jpg
gobo_fillColorWhiteLightColorGreen.jpg
gobo_fillColorWhiteLightColorWhite.jpg

Width

Width of the rect which the light is shining through.

gobo_width1.jpg
gobo_width3.jpg
gobo_width30.jpg

Height

Height of the rect which the light is shining through.

gobo_height1.jpg
gobo_height3.jpg
gobo_height30.jpg

 

Multiplier

Density

Controls the strength of the projected effect.

gobo_density05.jpg
gobo_density085.jpg
gobo_density1.jpg

Invert

Specify whether to invert the projected texture before it is applied.

gobo_invertOff.jpg
gobo_invertOn.jpg

Intensity

Global Multiplier for both the diffuse and specular contribution below.

gobo_intensity08.jpg
gobo_intensity1.jpg
gobo_intensity3.jpg

Diffuse

Multiplier of this light filter result for the diffuse contribution.

gobo_diffuse05.jpg
gobo_diffuse1.jpg
gobo_diffuse15.jpg

Specular

Multiplier of this light filter result for the specular contribution.

gobo_specular05.jpg
gobo_specular1.jpg
gobo_specular15.jpg

 

Texture Mapping

Tile Mode

Specifies how the texture repeats.

  • No Repeat (0)

  • Edge Extent (1)

  • Tile (2)

gobo_tileModeEdgeExtend.jpg
gobo_tileModeNoRepeat.jpg
gobo_tileModeTile.jpg

Scale U

Scale of the projected texture in the U direction.

gobo_scaleU1.jpg
gobo_scaleU3.jpg
gobo_scaleUNeg1.jpg

Scale V

Scale of the projected texture in the V direction.

gobo_scaleV1.jpg
gobo_scaleV3.jpg
gobo_scaleVNeg1.jpg

Offset U

Offset of the projected texture in the U direction. This simply moves the image in the U direction.

 

Offset V

Offset of the the projected texture in the V direction. This simply moves the image in the V direction.



Premultiplied Alpha

If using a texture with unpremultiplied Alpha, set this to 0 of off for correct behavior.

 

Combine Mode

mult: The results of all the filters are multiplied together

max: The maximum result from all filters is used.This works best for grey scale light filters.

min: The minimum result from all filters is used.This works best for grey scale light filters.

screen: Similar to the max operation, but it combines gradients in a smoother way. This works best for grey scale light.

Light filters on a light are grouped by their combine mode. Light filters in the same group are executed together and combined by the combine mode.The groups are executed in this order (max, min, screen, and then mult) and are multiplied together, which means a filter that turns things black in the mult group will zero out all other filters.

Related content