AddCone MethodAddCone Method*
*



Contents  *



Index  *Topic Contents
*Previous Topic: AddAmbient Method
*Next Topic: AddPoint Method

AddCone Method

Description

Adds a cone light to the Lights Filter Effect object to cast a directional light on the page.

Syntax

call object.filters.Light.addCone(x1,y1,z1,x2,y2,R,G,B,strength,spread)

ParameterDescription
object Name of the object to which the Light filter is applied.
x1, y1, z1 Source light's coordinates.
x2, y2 Target focus coordinates. Note: z2=0 is implied.
R Red value, integer from 0 to 255. 0 is lowest saturation, 255 is highest.
G Green value, integer from 0 to 255. 0 is lowest saturation, 255 is highest.
B Blue value, integer from 0 to 255. 0 is lowest saturation, 255 is highest.
strength Intensity setting. Integer value. Note: strength specified pertains to the target coordinates. When the light is later moved, the strength is re-scaled to still pertain to the new target.
spread Angle of light spread in the relationship between the vertical position of the light source and the surface of the visual object. 0 to 90 degrees. Low spread (such as low integer values) produces a smaller shaped cone of light. High angle of spread produces an oblique oval or circle of light.

Remarks

The cone light fades with distance from the target x,y position. It displays a hard edge at the near edge of the cone light's focus and fades gradually as it reaches the cone light's distance threshold.

Applies To

Light Filter


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.