Skip to content

Commit c390fbe

Browse files
SebastianZsvgeesus
authored andcommitted
Added Yehonatan and myself as editors and moved the others to former editors
1 parent b092d45 commit c390fbe

File tree

1 file changed

+74
-69
lines changed

1 file changed

+74
-69
lines changed

filter-effects-1/Overview.bs

Lines changed: 74 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -25,67 +25,71 @@ Ignored Vars: Va, 5s, 10s
2525
</pre>
2626
<pre class=link-defaults>
2727
spec:compositing-1; type:value;
28-
text:screen
29-
text:normal
28+
text:screen
29+
text:normal
3030
text:color
3131
text:saturation
3232
spec:css21;
33-
type:type; text:<margin-width>
33+
type:type; text:<margin-width>
3434
spec:css-text-decor-3; type:value; text:currentcolor
35+
spec:css-backgrounds-3; type:property;
36+
text:border
37+
text:box-shadow
38+
text:border-image
3539
spec:css-color-4; type:property; text:color
3640
spec:css-color-4; type:value
37-
text:srgb
38-
text:srgb-linear
41+
text:srgb
42+
text:srgb-linear
3943
spec:css-fonts-3; type:property
40-
text:font-family
41-
text:font-stretch
42-
text:font-style
43-
text:font-variant
44-
text:font-weight
44+
text:font-family
45+
text:font-stretch
46+
text:font-style
47+
text:font-variant
48+
text:font-weight
4549
spec:css-masking-1; type:property
46-
text:clip-path
47-
text:clip
48-
text:clip-rule
49-
text:mask
50+
text:clip-path
51+
text:clip
52+
text:clip-rule
53+
text:mask
5054
spec:css-overflow-3;
51-
type:dfn; text:ink overflow area
52-
type:dfn; text:ink overflow rectangle
55+
type:dfn; text:ink overflow area
56+
type:dfn; text:ink overflow rectangle
5357
spec:css-transforms-1;
54-
type:property; text:transform
55-
type:type; text:<transform-function>
58+
type:property; text:transform
59+
type:type; text:<transform-function>
5660
type:dfn; text:local coordinate system
5761
spec:selectors-4;
58-
type:selector; text::visited
59-
type:type; text:<compound-selector>
62+
type:selector; text::visited
63+
type:type; text:<compound-selector>
6064
spec:svg2; type:property
61-
text:color-interpolation
62-
text:fill
63-
text:fill-opacity
64-
text:fill-rule
65-
text:stroke
66-
text:glyph-orientation-horizontal
67-
text:glyph-orientation-vertical
68-
text:marker-start
69-
text:marker-end
70-
text:marker-mid
71-
text:stop-color
72-
text:stop-opacity
73-
text:stroke-dasharray
74-
text:stroke-dashoffset
75-
text:stroke-linecap
76-
text:stroke-linejoin
77-
text:stroke-miterlimit
78-
text:stroke-opacity
79-
text:stroke-width
80-
text:text-anchor
81-
text:alignment-baseline
82-
text:baseline-shift
83-
text:dominant-baseline
65+
text:color-interpolation
66+
text:fill
67+
text:fill-opacity
68+
text:fill-rule
69+
text:stroke
70+
text:glyph-orientation-horizontal
71+
text:glyph-orientation-vertical
72+
text:marker-start
73+
text:marker-end
74+
text:marker-mid
75+
text:stop-color
76+
text:stop-opacity
77+
text:stroke-dasharray
78+
text:stroke-dashoffset
79+
text:stroke-linecap
80+
text:stroke-linejoin
81+
text:stroke-miterlimit
82+
text:stroke-opacity
83+
text:stroke-width
84+
text:text-anchor
85+
text:alignment-baseline
86+
text:baseline-shift
87+
text:dominant-baseline
8488
spec:svg2; type:element
85-
text:script
89+
text:script
8690
text:title
8791
spec:web-animations-1;
88-
type:dfn; text: composite operation replace;
92+
type:dfn; text: composite operation replace;
8993
spec:html; type:dfn; for:/; text:browsing context
9094
https://html.spec.whatwg.org/multipage/browsers.html#browsing-context
9195
spec:css-display-3; type:property; text:display
@@ -846,7 +850,7 @@ This filter blends two objects together using commonly used imaging software ble
846850

847851
Note: This attribute is an addition to the <a element>feBlend</a> element defintion in SVG 1.1. <a element-attr>no-composite</a>, when specified, is meant to avoid "double-compositing" effects when blending an input source with the backdrop of the filtered object (E.g. using the <a attr-value>BackgroundImage</a> filter primitive). For the majority of use cases authors will not need to specify the <a element-attr>no-composite</a> attribute.
848852

849-
Animatable: no.</p>
853+
Animatable: no.
850854
: <dfn>in2</dfn> = "<em>(see <a element-attr>in</a> attribute)</em>"
851855
::
852856
The second input image to the blending operation.
@@ -947,7 +951,7 @@ The calculations are performed on non-premultiplied color values.
947951
Animatable: yes.
948952
: <dfn>values</dfn> = "<em>list of <<number>>s</em>"
949953
::
950-
The contents of <a element-attr for=feColorMatrix>values</a> depends on the value of attribute <a element-attr for=feColorMatrix>type</a></a>:
954+
The contents of <a element-attr for=feColorMatrix>values</a> depends on the value of attribute <a element-attr for=feColorMatrix>type</a>:
951955
* For <code>type="matrix"</code>, <a element-attr for=feColorMatrix>values</a> is a list of 20 matrix values (a00 a01 a02 a03 a04 a10 a11 ... a34), separated by whitespace and/or a comma. For example, the identity matrix could be expressed as:
952956
<pre>
953957
type="matrix"
@@ -1185,14 +1189,14 @@ The attributes below are the <dfn id="transfer-function-element-attributes">tran
11851189

11861190
If the attribute is not specified, then the effect is as if an empty list were provided.
11871191

1188-
Animatable: yes.</p>
1192+
Animatable: yes.
11891193
: <dfn>slope</dfn> = "<em><<number>></em>"
11901194
::
11911195
When <code>type="linear"</code>, the slope of the linear function.
11921196

11931197
The <a for=svg>initial value</a> for <a element-attr>slope</a> is ''1''.
11941198

1195-
Animatable: yes.</p>
1199+
Animatable: yes.
11961200
: <dfn>intercept</dfn> = "<em><<number>></em>"
11971201
::
11981202
When <code>type="linear"</code>, the intercept of the linear function.
@@ -1372,7 +1376,7 @@ For this filter primitive, the extent of the resulting image might grow as descr
13721376

13731377
The <a for=svg>initial value</a> for <a element-attr for=feComposite>operator</a> is <a attr-value>over</a>.
13741378

1375-
Animatable: yes.</p>
1379+
Animatable: yes.
13761380
: <dfn>k1</dfn> = "<<number>>"
13771381
::
13781382
Only applicable if <code>operator="arithmetic"</code>.
@@ -1386,7 +1390,7 @@ For this filter primitive, the extent of the resulting image might grow as descr
13861390

13871391
The <a for=svg>initial value</a> for <a element-attr>k2</a> is ''0''.
13881392

1389-
Animatable: yes.</p>
1393+
Animatable: yes.
13901394
: <dfn>k3</dfn> = "<<number>>"
13911395
::
13921396
Only applicable if <code>operator="arithmetic"</code>.
@@ -1604,9 +1608,9 @@ feConvolveMatrix applies a matrix convolution filter effect. A convolution combi
16041608

16051609
A matrix convolution is based on an n-by-m matrix (the convolution kernel) which describes how a given pixel value in the input image is combined with its neighboring pixel values to produce a resulting pixel value. Each result pixel is determined by applying the kernel matrix to the corresponding source pixel and its neighboring pixels. The basic convolution formula which is applied to each color value for a given pixel is:
16061610

1607-
<p id="feConvolveMatrixElementFormula">
1611+
<div id="feConvolveMatrixElementFormula">
16081612
<pre class=include>path: mathml/feConvolveMatrix00.mml</pre>
1609-
</p>
1613+
</div>
16101614

16111615
where "orderX" and "orderY" represent the X and Y values for the <a element-attr>order</a> attribute, "targetX" represents the value of the <a element-attr>targetX</a> attribute, "targetY" represents the value of the <a element-attr>targetY</a> attribute, "kernelMatrix" represents the value of the <a element-attr>kernelMatrix</a> attribute, "divisor" represents the value of the <a element-attr>divisor</a> attribute, and "bias" represents the value of the <a element-attr>bias</a> attribute.
16121616

@@ -1671,10 +1675,10 @@ When the image must be resampled to match the coordinate system defined by <a el
16711675
Animatable: yes.
16721676
: <dfn>targetY</dfn> = "<<integer>>"
16731677
::
1674-
Determines the positioning in Y of the convolution matrix relative to a given target pixel in the input image. The topmost row of the matrix is row number zero. The value must be such that: 0 &lt;= targetY &lt; orderY. By default, the convolution matrix is centered in Y over each pixel of the input image (i.e., targetY = floor ( orderY / 2 )).</p>
1678+
Determines the positioning in Y of the convolution matrix relative to a given target pixel in the input image. The topmost row of the matrix is row number zero. The value must be such that: 0 &lt;= targetY &lt; orderY. By default, the convolution matrix is centered in Y over each pixel of the input image (i.e., targetY = floor ( orderY / 2 )).
16751679

16761680
Animatable: yes.
1677-
: <dfn>edgeMode</dfn> = "<a attr-value>duplicate</a> | <a attr-value>wrap</a> | <a attr-value>mirror</a> | none</span>"
1681+
: <dfn>edgeMode</dfn> = "<span dfn-type=attr-value dfn-for=feConvolveMatrix/operator><a attr-value>duplicate</a> | <a attr-value>wrap</a> | <a attr-value>mirror</a> | none</span>"
16781682
::
16791683
Determines how to extend the input image as necessary with color values so that the matrix operations can be applied when the kernel is positioned at or near the edge of the input image.
16801684

@@ -2127,16 +2131,16 @@ The 'color-interpolation-filters' property only applies to the <a element-attr f
21272131
::
21282132
Indicates which channel from <a element-attr for=feDisplacementMap>in2</a> to use to displace the pixels in <a element-attr>in</a> along the x-axis.
21292133

2130-
The <a for=svg>initial value</a> for <a element-attr>xChannelSelector</a> is ''A''.
2134+
The <a for=svg>initial value</a> for <a element-attr>xChannelSelector</a> is ''xChannelSelector/A''.
21312135

21322136
Animatable: yes.
21332137
: <dfn>yChannelSelector</dfn> = "<em>R | G | B | A</em>"
21342138
::
21352139
Indicates which channel from <a element-attr for=feDisplacementMap>in2</a> to use to displace the pixels in <a element-attr>in</a> along the y-axis.
21362140

2137-
The <a for=svg>initial value</a> for <a element-attr>yChannelSelector</a> is ''A''.
2141+
The <a for=svg>initial value</a> for <a element-attr>yChannelSelector</a> is ''yChannelSelector/A''.
21382142

2139-
Animatable: yes.</p>
2143+
Animatable: yes.
21402144
: <dfn>in2</dfn> = "<em>(see <a element-attr>in</a> attribute)</em>"
21412145
::
21422146
The second input image, which is used to displace the pixels in the image from attribute <a element-attr>in</a>. See defintion for <a element-attr>in</a> attribute.
@@ -2409,7 +2413,8 @@ A <a element-attr for=feImage>href</a> reference that is an empty image (zero wi
24092413
</dl>
24102414

24112415
<div class=example>
2412-
The following example illustrates how images are placed relative to an object. From left to right:</p>
2416+
The following example illustrates how images are placed relative to an object. From left to right:
2417+
24132418
* The default placement of an image. Note that the image is centered in the <a>filter region</a> and has the maximum size that will fit in the region consistent with preserving the aspect ratio.
24142419
* The image stretched to fit the bounding box of an object.
24152420
* The image placed using user coordinates. Note that the image is first centered in a box the size of the <a>filter region</a> and has the maximum size that will fit in the box consistent with preserving the aspect ratio. This box is then shifted by the given <a element-attr for=filter-primitive>x</a> and <a element-attr for=filter-primitive>y</a> values relative to the viewport the object is in.
@@ -2667,21 +2672,21 @@ The <a element>feDiffuseLighting</a> and <a element>feSpecularLighting</a> filte
26672672
<dl dfn-type=element-attr dfn-for=feSpecularLighting>
26682673
: <dfn>surfaceScale</dfn> = "<em><<number>></em>"
26692674
::
2670-
height of surface when A<sub>in</sub> = 1.</p>
2675+
height of surface when A<sub>in</sub> = 1.
26712676

26722677
The <a for=svg>initial value</a> for <a element-attr for=feSpecularLighting>surfaceScale</a> is ''1''.
26732678

26742679
Animatable: yes.
26752680
: <dfn>specularConstant</dfn> = "<em><<number>></em>"
26762681
::
2677-
ks in Phong lighting model. In SVG, this can be any non-negative number.</p>
2682+
ks in Phong lighting model. In SVG, this can be any non-negative number.
26782683

26792684
The <a for=svg>initial value</a> for <a element-attr>specularConstant</a> is ''1''.
26802685

26812686
Animatable: yes.
26822687
: <dfn>specularExponent</dfn> = "<em><<number>></em>"
26832688
::
2684-
Exponent for specular term, larger is more "shiny".</p>
2689+
Exponent for specular term, larger is more "shiny".
26852690

26862691
The <a for=svg>initial value</a> for <a element-attr for=feSpecularLighting>specularExponent</a> is ''1''.
26872692

@@ -2694,7 +2699,7 @@ The <a element>feDiffuseLighting</a> and <a element>feSpecularLighting</a> filte
26942699

26952700
If <a element-attr for=feSpecularLighting>kernelUnitLength</a> is not specified, the <code>dx</code> and <code>dy</code> values should represent very small deltas relative to a given <code>(x,y)</code> position, which might be implemented in some cases as one pixel in the intermediate image offscreen bitmap, which is a pixel-based coordinate system, and thus potentially not scalable. For some level of consistency across display media and user agents, it is necessary that a value be provided for <a element-attr for=feSpecularLighting>kernelUnitLength</a>.
26962701

2697-
Animatable: yes.</p>
2702+
Animatable: yes.
26982703
</dl>
26992704

27002705
The light source is defined by one of the child elements <a element>feDistantLight</a>, <a element>fePointLight</a> or <a element>feSpotLight</a>. The light color is specified by property 'lighting-color'.
@@ -2966,7 +2971,7 @@ double turbulence(int nColorChannel, double *point, double fBaseFreqX, double fB
29662971
::
29672972
If <code>stitchTiles="noStitch"</code>, no attempt is made to achieve smooth transitions at the border of tiles which contain a turbulence function. Sometimes the result will show clear discontinuities at the tile borders.
29682973

2969-
If <code>stitchTiles="stitch"</code>, then the user agent will automatically adjust baseFrequency-x and baseFrequency-y values such that the <a element>feTurbulence</a> node's width and height (i.e., the width and height of the current subregion) contains an integral number of the Perlin tile width and height for the first octave. The baseFrequency will be adjusted up or down depending on which way has the smallest relative (not absolute) change as follows: Given the frequency, calculate <code>lowFreq=floor(width*frequency)/width</code> and <code>hiFreq=ceil(width*frequency)/width</code>. If frequency/lowFreq &lt; hiFreq/frequency then use lowFreq, else use hiFreq. While generating turbulence values, generate lattice vectors as normal for Perlin Noise, except for those lattice points that lie on the right or bottom edges of the active area (the size of the resulting tile). In those cases, copy the lattice vector from the opposite edge of the active area.</p>
2974+
If <code>stitchTiles="stitch"</code>, then the user agent will automatically adjust baseFrequency-x and baseFrequency-y values such that the <a element>feTurbulence</a> node's width and height (i.e., the width and height of the current subregion) contains an integral number of the Perlin tile width and height for the first octave. The baseFrequency will be adjusted up or down depending on which way has the smallest relative (not absolute) change as follows: Given the frequency, calculate <code>lowFreq=floor(width*frequency)/width</code> and <code>hiFreq=ceil(width*frequency)/width</code>. If frequency/lowFreq &lt; hiFreq/frequency then use lowFreq, else use hiFreq. While generating turbulence values, generate lattice vectors as normal for Perlin Noise, except for those lattice points that lie on the right or bottom edges of the active area (the size of the resulting tile). In those cases, copy the lattice vector from the opposite edge of the active area.
29702975

29712976
The <a for=svg>initial value</a> for <a element-attr>stitchTiles</a> is ''noStitch''.
29722977

@@ -3091,7 +3096,7 @@ Note: The 'color-interpolation-filters' property just has an affect on filter op
30913096

30923097
Note: The 'color-interpolation-filters' has a different initial value than 'color-interpolation'. 'color-interpolation-filters' has an initial value of ''linearRGB'', where as 'color-interpolation' has an initial value of ''sRGB''. Thus, in the default case, filter effects operations occur in the linearRGB color space, whereas all other color interpolations occur by default in the sRGB color space.
30933098

3094-
Note: The 'color-interpolation-filters' property has no affect on <span>Filter Functions</span>, which operate in the sRGB color space.
3099+
Note: The 'color-interpolation-filters' property has no affect on <span>Filter Functions, which operate in the sRGB color space.
30953100

30963101
The 'color-interpolation-filters' property is a <a href="https://www.w3.org/TR/2011/REC-SVG11-20110816/intro.html#TermPresentationAttribute">presentation attribute</a> for SVG elements.
30973102

@@ -3237,7 +3242,7 @@ macros:
32373242

32383243
The <a for=svg>initial value</a> for <a element-attr for=feSpotLight>specularExponent</a> is ''1''.
32393244

3240-
See section <a href="#feDiffuseLightingElement">Filter primitive &lt;feDiffuseLighting></a> for how to use <a element-attr for=feSpotLight>specularExponent</a>.</p>
3245+
See section <a href="#feDiffuseLightingElement">Filter primitive &lt;feDiffuseLighting></a> for how to use <a element-attr for=feSpotLight>specularExponent</a>.
32413246

32423247
Note: <a element-attr for=feSpotLight>specularExponent</a> for <a element>feSpotLight</a> serves a different use case than <a element-attr for=feSpecularLighting>specularExponent</a> for <a element>feSpecularLighting</a>.
32433248

@@ -3533,11 +3538,11 @@ If any of the above rules are not followed, an attacker could infer information
35333538
A timing attack is a method of obtaining information about content that is otherwise protected, based on studying the amount of time it takes for an operation to occur. If, for example, red pixels took longer to draw than green pixels, one might be able to reconstruct a rough image of the element being rendered, without ever having access to the content of the element. Security studies show that timing differences on arithmetic operations can be caused by the hardware architecture or compiler [[ArTD]].
35343539

35353540

3536-
<h2 id="AccessBackgroundImage" class="no-num">Appendix A: The deprecated 'enable-background' property</h2>
3541+
<h2 id="AccessBackgroundImage" class="no-num">Appendix A: The deprecated <css>enable-background</css> property</h2>
35373542

3538-
SVG 1.1 introduced the 'enable-background' property [[SVG11]]. The property defined the back drop under the <a>filter region</a> at the time that the <a element>filter</a> element was invoked. The concept defined by this property was identified to be incompatible with the model of stacking context in CSS at the time writing this specification. UAs can choose to implement the 'enable-background' property as defined in SVG 1.1 but will not be compatible to this specification or to CSS Compositing and Blending [[!COMPOSITING-1]].
3543+
SVG 1.1 introduced the <a href="https://www.w3.org/TR/SVG11/filters.html#EnableBackgroundProperty">enable-background</a> property [[SVG11]]. The property defined the back drop under the <a>filter region</a> at the time that the <a element>filter</a> element was invoked. The concept defined by this property was identified to be incompatible with the model of stacking context in CSS at the time writing this specification. UAs can choose to implement the <a href="https://www.w3.org/TR/SVG11/filters.html#EnableBackgroundProperty">enable-background</a> property as defined in SVG 1.1 but will not be compatible to this specification or to CSS Compositing and Blending [[!COMPOSITING-1]].
35393544

3540-
This specification does not support the 'enable-background' property. UAs must support the 'isolation' property instead [[!COMPOSITING-1]].
3545+
This specification does not support the <a href="https://www.w3.org/TR/SVG11/filters.html#EnableBackgroundProperty">enable-background</a> property. UAs must support the 'isolation' property instead [[!COMPOSITING-1]].
35413546

35423547

35433548
<h2 id="DOMInterfaces" class="no-num">Appendix B: DOM interfaces</h2>

0 commit comments

Comments
 (0)