ICMFilter

HTML (DHTML)

ICMFilter Filter

Internet Development Index

Converts the color content of the object based on an Image Color Management (ICM) profile. This enables improved display of specific content, or simulated display for hardware devices, such as printers or monitors.

Syntax

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

Possible Values

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

Members Table

The following table lists the members exposed by the ICMFilter object. Click a tab on the left to choose the type of member you want to view.

Attributes/Properties

AttributePropertyDescription
colorSpaceColorSpace Sets or retrieves the name and path for a particular .icm color mapping profile. With a profile assigned, the filtered output simulates the graphical output of devices that use the assigned profile.
intentIntent Sets or retreives the intended purpose for the color content of the object. The filter adjusts the color output to improve the display of content with the selected purpose.

Remarks

You can improve the quality of displayed or printed content by matching the Intent property to the general type of content to display. For example, when you print, you can set the Intent to Graphic to ensure that the color contrast is maintained. Higher contrast makes the printed content more legible.

To simulate the color output of a hardware device, you must locate the .icm profile file of a hardware device, if provided by the manufacturer. Assign the name and path of the .icm profile file to the ICMFilter.ColorSpace property and apply the filter to the content that the hardware device will use. If you only specify the name of the .icm file and not the path, the ICMFilter filter searches the ICM system folder on the local computer. It is only when you do not have the .icm file in the system folder that you need to specify a fully qualified path. The .icm profile file defines for your monitor how the content's colors differ from the standard. Thus, the display of the filter simulates the hardware device's color output.

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.

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