Light Filter

This topic documents a feature of Visual Filters and Transitions, which is deprecated as of Windows Internet Explorer 9.

Creates the effect of a light shining on the content of the object.

Syntax

HTML	<ELEMENT STYLE="filter:progid:DXImageTransform.Microsoft.Light(sProperties)" ... >	Internet Explorer 5.5 or later
Scripting	object.style.filter ="progid:DXImageTransform.Microsoft.Light(sProperties)"	Internet Explorer 5.5 or later

Possible Values

sProperties

String that specifies one or more properties exposed by the filter.

Members Table

The following table lists the members exposed by the Light object.

Attribute	Property	Description
enabled	Enabled	Sets or retrieves a value that indicates whether the filter is enabled.

Method	Description
addAmbient	Adds an ambient light to the Light filter.
addCone	Adds a cone light to the Light filter effect object to cast a directional light on the page.
addPoint	Adds a light source to the Light filter.The light source originates at a single point and radiates in all directions.
changeColor	Changes the color of a Light filter's light.
changeStrength	Changes the intensity of a light applied with the Light filter.
clear	Deletes all lights associated with the Light filter.
moveLight	Moves the focus for cone lights or the origin for point lights that are applied with the Light filter.

Remarks

By setting the properties of the Light filter, you can control the virtual position of the light source. You also can control the x- and y-coordinates of the light's focus, as well as the light's type (point or cone), color, and intensity. A maximum of 10 lights is available to each filter. To add more than 10 lights to your page, you must use multiple filters.

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

This effect is supported in Microsoft Internet Explorer 4.0. For more information about Internet Explorer 4.0 filter behavior, see Downlevel Support and Internet Explorer 4.0 Filters.

The object that the filter is applied to must have layout before the filter effect displays. You can give the object layout by setting the height or width property, setting the position property to absolute, setting the writingMode property to tb-rl, or setting the contentEditable property to true.

You can assign multiple filters or transitions to an object by declaring each in the filter property of the object. The following div declaration assigns two filters and a Wheel transition to a div element.

<DIV STYLE="width:100%; filter:
    progid:DXImageTransform.Microsoft.MotionBlur(strength=13, direction=310)
    progid:DXImageTransform.Microsoft.Blur(pixelradius=2)
    progid:DXImageTransform.Microsoft.Wheel(duration=3);">
        Blurry text with smudge of gray.</div>     

When multiple filters are applied to an object, each filter is processed in source order, with the exception of procedural surfaces, which are computed first. To emphasize a filter's effect, place it last in source order or on the object's parent. Always place transitions last in source order.

Note  As of Internet Explorer 9, the visual effect of this filter is only applied when content is displayed on a screen; the effect is not applied when content is printed.

Example

This example uses the Light filter and the addCone method to apply a red cone filter to a div element.

<STYLE>
   .aFilter {background-color: #FFFFFF; 
            filter:light();
             color: cyan;
             width: 150px;}
</STYLE>
<SCRIPT>
window.onload=fnInit;
function fnInit(){
   var iX2=oDiv.offsetWidth;
   var iY2=oDiv.offsetHeight;
   oDiv.filters[0].addCone(0,0,1,iX2,iY2,255,0,0,20,180);
}
</SCRIPT>     
<DIV CLASS="aFilter" ID="oDiv">
This text is highlighted by a red cone of light.
</DIV>

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/filter/shortSamples/lightEX1.htm

Applies To

A, ABBR, ACRONYM, ADDRESS, B, BDO, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, CUSTOM, DD, DEL, DFN, DIR, DIV, DL, DT, EM, FIELDSET, FONT, FORM, FRAME, hn, I, IFRAME, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, KBD, LABEL, LEGEND, LI, MARQUEE, MENU, NOBR, OL, OBJECT, P, PLAINTEXT, PRE, Q, RT, RUBY, runtimeStyle, S, SAMP, SMALL, SPAN, STRIKE, STRONG, style, SUB, SUP, TABLE, TD, TEXTAREA, TH, TT, U, UL, VAR, XMP

See Also

Scripting Filters, Filter Design Considerations