Edit

VML Gain Attribute

  • Article

This topic describes VML, a feature that is deprecated as of Windows Internet Explorer 9. Webpages and applications that rely on VML should be migrated to SVG or other widely supported standards.

Note

As of December 2011, this topic has been archived. As a result, it is no longer actively maintained. For more information, see Archived Content. For information, recommendations, and guidance regarding the current version of Windows Internet Explorer, see Internet Explorer Developer Center.

 

Defines the intensity of all colors in an image. Read/write. VgNumber.

Applies To

ImageData

Tag Syntax

<v: element gain=" expression ">

Script Syntax

element .gain="expression"

expression=element.gain

Remarks

This attribute defines how bright the color white is, affecting all other colors. Values range from 0 to infinity. The default value is 1.0. A value of 0 displays no image. Values greater than 1 lighten the picture and values less than 1 make the picture seem grayer.

This attribute can be used to create interesting effects.

VML Standard Attribute

Example

The image will be displayed with all the colors tending toward gray.

   <v:shape id="rect01"
   coordorigin="0 0" coordsize="200 200"
   strokecolor="red"
   style="top:1;left:1;width:300;height:200"
   path="m 1,1 l 1,200, 200,200, 200,1 x e">
   <v:imagedata gain=".5" src="kids.jpg"/>
   </v:shape>