Pixelate Filter

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

Displays the content of the object as squares that take on the average color value of the pixels they replace. This filtered display can be used as a transition.

Syntax

HTML	<ELEMENT STYLE="filter:progid:DXImageTransform.Microsoft.Pixelate(sProperties)" ... >	Internet Explorer 5.5 or later
Scripting	object.style.filter ="progid:DXImageTransform.Microsoft.Pixelate(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 Pixelate object.

Attribute	Property	Description
duration	Duration	Sets or retrieves the length of time the transition takes to complete.
enabled	Enabled	Sets or retrieves a value that indicates whether the filter is enabled.
maxSquare	MaxSquare	Sets or retrieves the maximum width in pixels of a pixelated square.
	Percent	Sets or retrieves the point in a transition at which to capture the display for a static filter output.
	status	Retrieves the state of the transition.

Method	Description
apply	Captures the initial display of an object's content for a transition.
play	Plays the transition.
stop	Stops the transition playback.

Remarks

The Pixelate transition is a complex visual effect. In the first half of the transition, the content is displayed as expanding pixelated squares. The width of the pixelated squares increases from one pixel to MaxSquare pixels at the halfway point of the transition. The final half of the transition reduces the pixelated squares back to individual pixels, revealing the new content. During this transition, the original content fades into the new content. The fade effect is produced by reducing the opacity of the original content to zero while the opacity of the new content is raised to 100 percent at the same time.

Set the Enabled property to false when using the Pixelate transition. This disables the static filter and prevents the content of the object from displaying as pixelated before the transition is applied.

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.

Examples

The following example shows how to change the effects of this transition by modifying its properties.

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

The following example reveals a div object with text using the Pixelate transition.

<SCRIPT>
var bToggle = 0;
function fnToggle() {
    oDiv.filters[0].Apply();                   
// After setting Apply, changes to the oDiv object 
//  are not displayed until Play is called.

    if (bToggle) {                                                        
        bToggle = 0;
        oDiv.style.visibility="visible";  }  
    else {
        bToggle = 1;
        oDiv.style.visibility="hidden"; }
    oDiv.filters[0].Play();
}
</SCRIPT>

<BUTTON onclick="fnToggle()">Toggle Transition</BUTTON><BR/><BR/>
<FONT SIZE="+4">
    <DIV ID="oDiv" STYLE="width:100px; background-color: lightblue;
                filter:progid:DXImageTransform.Microsoft.Pixelate(
                duration=3, enabled='false');">
<!-- Static filter is disabled. -->
         Text<BR/>Text<BR/>Text<BR/>
    </DIV>
</FONT>

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/filter/shortSamples/pixelateEX1.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, IFRAME, FRAMESET, I, INS, 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, KBD, LABEL, LEGEND, LI, MARQUEE, MENU, NOBR, OL, OBJECT, P, PLAINTEXT, PRE, Q, RT, RUBY, S, SAMP, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TEXTAREA, TH, TD, TT, U, UL, VAR, XMP

See Also

Scripting Filters, Filter Design Considerations, Transitions, Transition Design Considerations