RevealTrans Filter (A, ABBR, ACRONYM, ...)

RevealTrans Filter

Reveals new content of the object using one of 24 predefined Transition effects.

Syntax

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

HTML	<ELEMENT `STYLE= "filter:DXImageTransform.Microsoft.RevealTrans(sProperties)"` ... >	Internet Explorer 4.0 or later
Scripting	object`.style.filter = "DXImageTransform.Microsoft.RevealTrans(sProperties)"`	Internet Explorer 4.0 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 RevealTrans object.
Attributes/Properties

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.
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.
transition Transition Sets or retrieves the type of transition.

Methods

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

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.
	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.
transition	Transition	Sets or retrieves the type of 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

For a list of the predefined transitions that can be used with the RevealTrans filter, see the Transition property. You can create these effects more efficiently with optimized transition filters. In addition to performance benefits, optimized transition filters offer more options for enhancing the effects. The following table shows the applicable optimized transition for the Transition property values.
Transition number Optimized filter
13,14,15,16 Barn
8,9 Blinds
10,11 CheckerBoard
0,1,2, 3 Iris
21,22 RandomBars
12 RandomDissolve
4,5,6,7 Slide
17,18,19,20 Strips
The object that the filter is applied to must have layout before the filter effect will display. 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.

Transition number	Optimized filter
13,14,15,16	Barn
8,9	Blinds
10,11	CheckerBoard
0,1,2, 3	Iris
21,22	RandomBars
12	RandomDissolve
4,5,6,7	Slide
17,18,19,20	Strips

Example

This example uses the RevealTrans filter to reveal and conceal objects using two different transitions.

<SCRIPT>
function go() {
    oSpan.filters[0].Apply();

if (oSpan.style.visibility == "visible") {
        oSpan.style.visibility = "hidden";
	oSpan.filters.revealTrans.transition=2;
    }
    else {
        oSpan.style.visibility = "visible";
	oSpan.filters[0].transition=3;
    }
    oSpan.filters[0].Play();
}
</SCRIPT>
<INPUT TYPE="BUTTON" VALUE="Play Transistion"  />
<SPAN ID=oSpan STYLE="position:absolute; Visibility:visible;
        Filter:revealTrans(duration=2, transition=3);
        width:300; height:300; background-color: lightgreen;">
    <CENTER style="background-color=red; height=100; width:100;
            position:relative; top:100">
    </CENTER>
</SPAN>

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