Share via

in1 property

  • Article

Identifies input for the given filter primitive.

This property is read-only.

 

Syntax

HRESULT get_in1(
  [out] SVGAnimatedString **value
);

Property values

Type: SVGAnimatedString

Can be one of the following values:

Value Condition
SourceGraphic SourceGraphic

Represents the graphics elements that were the original input into the filter element. For raster effects filter primitives, the graphics elements will be rasterized into an initially clear RGBA raster in image space. Pixels left untouched by the original graphic will be left clear. The image is specified to be rendered in linear RGBA pixels. The alpha channel of this image captures any anti-aliasing specified by SVG. (Since the raster is linear, the alpha channel of this image will represent the exact percent coverage of each pixel.)
SourceAlpha SourceAlpha

Represents the graphics elements that were the original input into the filter element. SourceAlpha has all of the same rules as SourceGraphic except that only the alpha channel is used. The input image is an RGBA image consisting of implicitly black color values for the RGB channels, but whose alpha channel is the same as SourceGraphic. If this option is used, then some implementations might need to rasterize the graphics elements in order to extract the alpha channel.
BackgroundImage BackgroundImage

Represents an image snapshot of the canvas under the filter region at the time that the filter element was invoked.
BackgroundAlpha BackgroundAlpha

Same as BackgroundImage except only the alpha channel is used.
FillPaint FillPaint

Represents the value of the IHTMLCSSStyleDeclaration::fill property on the target element for the filter effect. The FillPaint image has conceptually infinite extent. Frequently this image is opaque everywhere, but it might not be if the "paint" itself has alpha, as in the case of a gradient or pattern which itself includes transparent or semi-transparent parts.
StrokePaint StrokePaint

Represents the value of the IHTMLCSSStyleDeclaration::stroke property on the target element for the filter effect. The StrokePaint image has conceptually infinite extent. Frequently this image is opaque everywhere, but it might not be if the "paint" itself has alpha, as in the case of a gradient or pattern which itself includes transparent or semi-transparent parts.
<filter-primitive-reference> <filter-primitive-reference>

If applicable, this filter primitive will use the result from the previous filter primitive as its input.

 

Standards information

Remarks

Identifies input for the given filter primitive. The value can be either one of six keywords (see above) or can be a string which matches a previous result attribute value within the same filter element. If no value is provided and this is the first filter primitive, then this filter primitive will use SourceGraphic as its input. If no value is provided and this is a subsequent filter primitive, then this filter primitive will use the result from the previous filter primitive as its input.

If the value for result appears multiple times within a given filter element, then a reference to that result will use the closest preceding filter primitive with the given value for attribute result. Forward references to results are an error.