Light Filter EffectLight Filter Effect*
*Contents  *Index  *Topic Contents
*Previous Topic: Invert Filter Effect
*Next Topic: Mask Filter

Light Filter Effect

Description

Simulates the projection of a light source onto the selected visual object.

Syntax

{FILTER: Light}

Remarks

Once you have defined your Light Filter effect collection for your object, you call its methods to set or change its properties.
Light Filter methodDescription
AddAmbient MethodAdds ambient light source.
AddCone MethodAdds cone light source.
AddPoint MethodAdds point light source.
ChangeColor MethodChanges light color.
ChangeStrength MethodChanges light strength.
Clear MethodClears all lights.
MoveLight MethodMoves light source.

You can control the virtual position of the light source, the x and y coordinates of the focus of the light, the type of light (point or cone) and whether the light has hard or diffuse edges, the color of the light, and its intensity. The maximum number of lights available to each Visual Filter control is 10, so to add more than 10 lights to your page, you will need multiple Visual Filter controls.

When a light effect is created, it has a default ambient light associated with it. The first light you add to the object replaces this default ambient light.

You can associate only one object per light effect. To light several different separate objects (for example, a text phrase and a bitmap image), you need a separate instance of the Lights Filter effect for each object. However, if you combine several objects into a single object by using a DIV tag, you can use one light object to light the combined object.


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