BasicImage Filter

Internet Development Index

Adjusts the color processing, image rotation, or opacity of the content of the object.

Syntax

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

Possible Values

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

Members Table

AttributePropertyDescription
enabledEnabled Sets or retrieves a value that indicates whether the filter is enabled.
grayScaleGrayScale Sets or retrieves the value that indicates whether content is displayed as the average of the RGB component values.
Invert Sets or retrieves the value that indicates whether the content is displayed as the complement of the RGB component values.
Mask Sets or retrieves whether transparent content of an object is changed to the MaskColor value.
MaskColor Sets or retrieves the color used to mask transparent content of an object.
mirrorMirror Sets or retrieves the value that indicates whether the content display is reversed.
opacityOpacity Sets or retrieves the opacity level that is applied to the content of an object.
Rotation Sets or retrieves the value that indicates whether the content is rotated in ninety-degree increments.
XRayXRay Sets or retrieves the value that indicates whether the content is displayed as a grayscale defined by the complement of the average red and green component values.

Remarks

This filter consolidates filter effects 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.

Examples

The following example shows the effects of this filter when its properties are modified.

This feature requires Microsoft® Internet Explorer 5.5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

This example provides a set of buttons to apply different BasicImage properties. Each button resets the filter string dynamically with script.

<STYLE>
button {width:250px;}
</STYLE>
<!-- This DIV is the target container for the image.  -->
<DIV ID="oDiv" STYLE="position:absolute; left:270px;" >
An Image - >
<IMG SRC='../common/earglobe.gif' />
</DIV>
<BUTTON onclick="oDiv.style.filter=
'progid:DXImageTransform.Microsoft.BasicImage(mirror=1)'">
Mirror</BUTTON><BR/>
<BUTTON onclick="oDiv.style.filter=
'progid:DXImageTransform.Microsoft.BasicImage(invert=1)'">
Invert</BUTTON><BR/>
<BUTTON onclick="oDiv.style.filter=
'progid:DXImageTransform.Microsoft.BasicImage(grayScale=1)'">
GrayScale</BUTTON><BR/>
<BUTTON onclick="oDiv.style.filter=
'progid:DXImageTransform.Microsoft.BasicImage(xray=1)'">
X-Ray</BUTTON><BR/>
<BUTTON onclick="oDiv.style.filter=
'progid:DXImageTransform.Microsoft.BasicImage(mask=1, maskColor=255)'">
Blue MaskColor</BUTTON><BR/>
<BUTTON onclick="oDiv.style.filter=''">Clear Filter</BUTTON><BR/>
This feature requires Microsoft® Internet Explorer 5.5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Applies To

A, 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