Skip to content

Commit 7b031c9

Browse files
dbaronsvgeesus
authored andcommitted
Change 'auto' value of 'mask-mode' to 'match-source' as resolved in CSS/SVG meeting about 25 minutes ago.
This addresses the issue raised in: https://lists.w3.org/Archives/Public/public-fx/2015OctDec/0021.html
1 parent 0f9deec commit 7b031c9

2 files changed

Lines changed: 18 additions & 18 deletions

File tree

css-masking-1/Overview.html

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -529,7 +529,7 @@ <h3 class="heading settled" data-level="7.2" id="the-mask-mode"><span class="sec
529529
<td class="prod"><a class="production css" data-link-type="type" href="#typedef-masking-mode">&lt;masking-mode></a><a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#mult-comma">#</a>
530530
<tr>
531531
<th>Initial:
532-
<td>auto
532+
<td>match-source
533533
<tr>
534534
<th>Applies to:
535535
<td>All elements. In SVG, it applies to <a href="https://www.w3.org/TR/2011/REC-SVG11-20110816/intro.html#TermContainerElement">container elements</a> excluding the <a href="https://www.w3.org/TR/2011/REC-SVG11-20110816/struct.html#DefsElement"><code class="element-name">&lt;defs></code></a> element and all <a href="https://www.w3.org/TR/2011/REC-SVG11-20110816/intro.html#TermGraphicsElement">graphics elements</a>
@@ -550,14 +550,14 @@ <h3 class="heading settled" data-level="7.2" id="the-mask-mode"><span class="sec
550550
<td>no
551551
</table>
552552
<p>The <a class="property" data-link-type="propdesc" href="#propdef-mask-mode">mask-mode</a> property indicates whether the <a class="production css" data-link-type="type" href="#typedef-mask-reference">&lt;mask-reference></a> is treated as luminance mask or alpha mask. (See <a href="#MaskValues">Mask processing</a>.)</p>
553-
<pre class="prod"><dfn data-dfn-type="type" data-export="" id="typedef-masking-mode">&lt;masking-mode><a class="self-link" href="#typedef-masking-mode"></a></dfn> = alpha <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#comb-one">|</a> luminance <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#comb-one">|</a> auto</pre>
553+
<pre class="prod"><dfn data-dfn-type="type" data-export="" id="typedef-masking-mode">&lt;masking-mode><a class="self-link" href="#typedef-masking-mode"></a></dfn> = alpha <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#comb-one">|</a> luminance <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#comb-one">|</a> match-source</pre>
554554
<p>Values have the following meanings:</p>
555555
<dl>
556556
<dt><dfn class="css" data-dfn-for="mask-mode" data-dfn-type="value" data-export="" id="valdef-mask-mode-alpha">alpha<a class="self-link" href="#valdef-mask-mode-alpha"></a></dfn>
557557
<dd> A value of <a class="css" data-link-type="value" href="#valdef-mask-mode-alpha">alpha</a> indicates that the alpha values of the <a data-link-type="dfn" href="#mask-layer-image">mask layer image</a> should be used as the mask values. See <a href="#MaskValues">Calculating mask values</a>.
558558
<dt><dfn class="css" data-dfn-for="mask-mode" data-dfn-type="value" data-export="" id="valdef-mask-mode-luminance">luminance<a class="self-link" href="#valdef-mask-mode-luminance"></a></dfn>
559559
<dd> A value of <a class="css" data-link-type="value" href="#valdef-mask-mode-luminance">luminance</a> indicates that the luminance values of the <a data-link-type="dfn" href="#mask-layer-image">mask layer image</a> should be used as the mask values. See <a href="#MaskValues">Calculating mask values</a>.
560-
<dt><dfn class="css" data-dfn-for="mask-mode" data-dfn-type="value" data-export="" id="valdef-mask-mode-auto">auto<a class="self-link" href="#valdef-mask-mode-auto"></a></dfn>
560+
<dt><dfn class="css" data-dfn-for="mask-mode" data-dfn-type="value" data-export="" id="valdef-mask-mode-match-source">match-source<a class="self-link" href="#valdef-mask-mode-match-source"></a></dfn>
561561
<dd>
562562
<p>If the <a class="production css" data-link-type="type" href="#typedef-mask-reference">&lt;mask-reference></a> of the <a class="property" data-link-type="propdesc" href="#propdef-mask-image">mask-image</a> property is of type <a class="production css" data-link-type="type" href="#typedef-mask-source">&lt;mask-source></a> the luminance values of the <a data-link-type="dfn" href="#mask-layer-image">mask layer image</a> should be used as the mask values.</p>
563563
<p>If the <a class="production css" data-link-type="type" href="#typedef-mask-reference">&lt;mask-reference></a> of the <a class="property" data-link-type="propdesc" href="#propdef-mask-image">mask-image</a> property is of type <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-images-3/#typedef-image">&lt;image></a> the alpha values of the <a data-link-type="dfn" href="#mask-layer-image">mask layer image</a> should be used as the mask values.</p>
@@ -1417,10 +1417,10 @@ <h3 class="heading settled" data-level="9.2" id="the-mask-type"><span class="sec
14171417
<dt><dfn class="css" data-dfn-for="mask-type" data-dfn-type="value" data-export="" id="valdef-mask-type-alpha">alpha<a class="self-link" href="#valdef-mask-type-alpha"></a></dfn>
14181418
<dd> Indicates that the alpha values of the mask should be used.
14191419
</dl>
1420-
<p>The <a class="property" data-link-type="propdesc" href="#propdef-mask-type">mask-type</a> property allows the author of the <a data-link-type="element" href="#elementdef-mask">mask</a> element to specify the preferred masking mode. However, the author can override this preference by setting the <a class="property" data-link-type="propdesc" href="#propdef-mask-mode">mask-mode</a> value to something different than <a class="css" data-link-type="maybe" href="#valdef-mask-mode-auto">auto</a> on the masked content.</p>
1421-
<div class="example" id="example-c033a63a">
1422-
<a class="self-link" href="#example-c033a63a"></a>
1423-
<p>In the following example the computed value of <a class="property" data-link-type="propdesc" href="#propdef-mask-type">mask-type</a> is <a class="css" data-link-type="value" href="#valdef-mask-type-luminance">luminance</a> and the computed value of <a class="property" data-link-type="propdesc" href="#propdef-mask-mode">mask-mode</a> is <a class="css" data-link-type="maybe" href="#valdef-mask-mode-auto">auto</a>. The UA must follow the preferred masking mode defined on the <a data-link-type="element" href="#elementdef-mask">mask</a> element. </p>
1420+
<p>The <a class="property" data-link-type="propdesc" href="#propdef-mask-type">mask-type</a> property allows the author of the <a data-link-type="element" href="#elementdef-mask">mask</a> element to specify the preferred masking mode. However, the author can override this preference by setting the <a class="property" data-link-type="propdesc" href="#propdef-mask-mode">mask-mode</a> value to something different than <a class="css" data-link-type="maybe" href="#valdef-mask-mode-match-source">match-source</a> on the masked content.</p>
1421+
<div class="example" id="example-2f49b58e">
1422+
<a class="self-link" href="#example-2f49b58e"></a>
1423+
<p>In the following example the computed value of <a class="property" data-link-type="propdesc" href="#propdef-mask-type">mask-type</a> is <a class="css" data-link-type="value" href="#valdef-mask-type-luminance">luminance</a> and the computed value of <a class="property" data-link-type="propdesc" href="#propdef-mask-mode">mask-mode</a> is <a class="css" data-link-type="maybe" href="#valdef-mask-mode-match-source">match-source</a>. The UA must follow the preferred masking mode defined on the <a data-link-type="element" href="#elementdef-mask">mask</a> element. </p>
14241424
<pre><code class="html">&lt;svg>
14251425
&lt;mask style="mask-type: luminance;" id="mask">
14261426
...
@@ -1488,8 +1488,8 @@ <h2 class="no-num heading settled" id="clip-property"><span class="content">Appe
14881488
<dt><dfn class="css" data-dfn-type="function" data-export="" id="funcdef-rect">rect()<a class="self-link" href="#funcdef-rect"></a></dfn> = rect( <a class="production css" data-link-type="type" href="#typedef-top">&lt;top></a>, <a class="production css" data-link-type="type" href="#typedef-right">&lt;right></a>, <a class="production css" data-link-type="type" href="#typedef-bottom">&lt;bottom></a>, <a class="production css" data-link-type="type" href="#typedef-left">&lt;left></a> )
14891489
<dd>
14901490
<p><a class="production css" data-link-type="type" href="#typedef-top">&lt;top></a> and <a class="production css" data-link-type="type" href="#typedef-bottom">&lt;bottom></a> specify offsets from the top border edge of the box, and <a class="production css" data-link-type="type" href="#typedef-right">&lt;right></a>, and <a class="production css" data-link-type="type" href="#typedef-left">&lt;left></a> specify offsets from the left border edge of the box. Authors should separate offset values with commas. User agents must support separation with commas, but may also support separation without commas (but not a combination), because a previous revision of this specification was ambiguous in this respect.</p>
1491-
<p><dfn class="css" data-dfn-type="type" data-export="" id="typedef-top">&lt;top><a class="self-link" href="#typedef-top"></a></dfn>, <dfn class="css" data-dfn-type="type" data-export="" id="typedef-right">&lt;right><a class="self-link" href="#typedef-right"></a></dfn>, <dfn class="css" data-dfn-type="type" data-export="" id="typedef-bottom">&lt;bottom><a class="self-link" href="#typedef-bottom"></a></dfn>, and <dfn class="css" data-dfn-type="type" data-export="" id="typedef-left">&lt;left><a class="self-link" href="#typedef-left"></a></dfn> may either have a <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-3/#length-value">&lt;length></a> value or <a class="css" data-link-type="maybe" href="#valdef-mask-mode-auto">auto</a>. Negative lengths are permitted. The value <a class="css" data-link-type="maybe" href="#valdef-mask-mode-auto">auto</a> means that a given edge of the clipping region will be the same as the edge of the element’s generated border box (i.e., <a class="css" data-link-type="maybe" href="#valdef-mask-mode-auto">auto</a> means the same as <span class="css">0</span> for <a class="production css" data-link-type="type" href="#typedef-top">&lt;top></a> and <a class="production css" data-link-type="type" href="#typedef-left">&lt;left></a>, the same as the <a data-link-type="dfn" href="https://drafts.csswg.org/css-cascade-4/#used-value">used value</a> of the height plus the sum of vertical padding and border widths for <a class="production css" data-link-type="type" href="#typedef-bottom">&lt;bottom></a>, and the same as the used value of the width plus the sum of the horizontal padding and border widths for <a class="production css" data-link-type="type" href="#typedef-right">&lt;right></a>, such that four <a class="css" data-link-type="maybe" href="#valdef-mask-mode-auto">auto</a> values result in the clipping region being the same as the element’s border box).</p>
1492-
<p>When coordinates are rounded to pixel coordinates, care should be taken that no pixels remain visible when <a class="production css" data-link-type="type" href="#typedef-left">&lt;left></a> and <a class="production css" data-link-type="type" href="#typedef-right">&lt;right></a> have the same value (or <a class="production css" data-link-type="type" href="#typedef-top">&lt;top></a> and <a class="production css" data-link-type="type" href="#typedef-bottom">&lt;bottom></a> have the same value), and conversely that no pixels within the element’s border box remain hidden when these values are <a class="css" data-link-type="maybe" href="#valdef-mask-mode-auto">auto</a>.</p>
1491+
<p><dfn class="css" data-dfn-type="type" data-export="" id="typedef-top">&lt;top><a class="self-link" href="#typedef-top"></a></dfn>, <dfn class="css" data-dfn-type="type" data-export="" id="typedef-right">&lt;right><a class="self-link" href="#typedef-right"></a></dfn>, <dfn class="css" data-dfn-type="type" data-export="" id="typedef-bottom">&lt;bottom><a class="self-link" href="#typedef-bottom"></a></dfn>, and <dfn class="css" data-dfn-type="type" data-export="" id="typedef-left">&lt;left><a class="self-link" href="#typedef-left"></a></dfn> may either have a <a class="production css" data-link-type="type" href="https://drafts.csswg.org/css-values-3/#length-value">&lt;length></a> value or <span class="css">auto</span>. Negative lengths are permitted. The value <span class="css">auto</span> means that a given edge of the clipping region will be the same as the edge of the element’s generated border box (i.e., <span class="css">auto</span> means the same as <span class="css">0</span> for <a class="production css" data-link-type="type" href="#typedef-top">&lt;top></a> and <a class="production css" data-link-type="type" href="#typedef-left">&lt;left></a>, the same as the <a data-link-type="dfn" href="https://drafts.csswg.org/css-cascade-4/#used-value">used value</a> of the height plus the sum of vertical padding and border widths for <a class="production css" data-link-type="type" href="#typedef-bottom">&lt;bottom></a>, and the same as the used value of the width plus the sum of the horizontal padding and border widths for <a class="production css" data-link-type="type" href="#typedef-right">&lt;right></a>, such that four <span class="css">auto</span> values result in the clipping region being the same as the element’s border box).</p>
1492+
<p>When coordinates are rounded to pixel coordinates, care should be taken that no pixels remain visible when <a class="production css" data-link-type="type" href="#typedef-left">&lt;left></a> and <a class="production css" data-link-type="type" href="#typedef-right">&lt;right></a> have the same value (or <a class="production css" data-link-type="type" href="#typedef-top">&lt;top></a> and <a class="production css" data-link-type="type" href="#typedef-bottom">&lt;bottom></a> have the same value), and conversely that no pixels within the element’s border box remain hidden when these values are <span class="css">auto</span>.</p>
14931493
</dl>
14941494
<div class="example" id="example-1722a1b1">
14951495
<a class="self-link" href="#example-1722a1b1"></a>
@@ -1754,7 +1754,6 @@ <h3 class="no-num heading settled" id="index-defined-here"><span class="content"
17541754
<li><a href="#valdef-mask-border-mode-alpha">value for mask-border-mode</a><span>, in §8.2</span>
17551755
<li><a href="#valdef-mask-type-alpha">value for mask-type</a><span>, in §9.2</span>
17561756
</ul>
1757-
<li><a href="#valdef-mask-mode-auto">auto</a><span>, in §7.2</span>
17581757
<li>
17591758
border-box
17601759
<ul>
@@ -1849,6 +1848,7 @@ <h3 class="no-num heading settled" id="index-defined-here"><span class="content"
18491848
<li><a href="#typedef-mask-source">&lt;mask-source></a><span>, in §7.1</span>
18501849
<li><a href="#propdef-mask-type">mask-type</a><span>, in §9.2</span>
18511850
<li><a href="#element-attrdef-mask-maskunits">maskUnits</a><span>, in §9.1</span>
1851+
<li><a href="#valdef-mask-mode-match-source">match-source</a><span>, in §7.2</span>
18521852
<li><a href="#valdef-mask-clip-no-clip">no-clip</a><span>, in §7.5</span>
18531853
<li><a href="#valdef-clip-rule-nonzero">nonzero</a><span>, in §6.2</span>
18541854
<li>
@@ -2212,7 +2212,7 @@ <h2 class="no-num heading settled" id="property-index"><span class="content">Pro
22122212
<tr>
22132213
<th scope="row"><a class="css" data-link-type="property" href="#propdef-mask-mode">mask-mode</a>
22142214
<td>&lt;masking-mode>#
2215-
<td>auto
2215+
<td>match-source
22162216
<td>All elements. In SVG, it applies to container elements excluding the &lt;defs> element and all graphics elements
22172217
<td>no
22182218
<td>n/a

0 commit comments

Comments
 (0)