Adds an ambient light to the Light filter.

Syntax

object.filters.item(
    "DXImageTransform.Microsoft.Light").addAmbient(iRed, iGreen, iBlue, iStrength)

Parameters

iRed	Required. Integer that specifies the red value. The value can range from 0 (lowest saturation) to 255 (highest saturation).
iGreen	Required. Integer that specifies the green value. The value can range from 0 (lowest saturation) to 255 (highest saturation).
iBlue	Required. Integer that specifies the blue value. The value can range from 0 (lowest saturation) to 255 (highest saturation).
iStrength	Required. Integer that specifies the intensity of the light filter. The value can range from 0 (lowest intensity) to 100 (highest intensity). The intensity specified pertains to the target coordinates.

Return Value

No return value.

Remarks

Ambient light is nondirectional and sheds parallel beams perpendicular to the surface of the page. Ambient light has color and strength values that add more color to the object; it is often used with other lights.

Applies To

	Light