Tweaks to multiple paints on fill and stroke.
--- a/master/painting.html Mon Jun 24 11:31:20 2013 +0200
+++ b/master/painting.html Mon Jun 24 15:51:38 2013 +0200
@@ -102,36 +102,23 @@
</table>
</div>
-<p>Properties <a>'fill'</a> and <a>'stroke'</a> take on a comma separated list of values of type <a><paint></a> with
-the last value optionally taking a space separated solid color fallback.</p>
-
+<p>Properties <a>'fill'</a> and <a>'stroke'</a> take on a comma separated list of values of type <a><paint></a>. Each paint is applied to an element in reverse order. Note, only a <a href="pservers.html">paint server</a> in the last position may take an optional fallback color.</p>
+
+<p class="note">The ability to apply more than one paint to an element is new in SVG 2.</p>
<p class="annotation">The paint order follows that of CSS backgrounds.</p>
<div class="example">
-<pre><![CDATA[
+ <pre><![CDATA[
<rect width="100" height="100" fill="url(#MyHatch1, #MyHatch2, powderblue)">
-]]></pre>
-<div class="figure">
- <img
- alt="An example of applying three paints to a rectangle."
- src="images/painting/multiple_paints.svg"/>
- <p class="caption">The rightmost rectangle is filled by stacking the paints shown in the other rectangles.</p>
-</div>
+ ]]></pre>
+ <div class="figure">
+ <img
+ alt="An example of applying three paints to a rectangle."
+ src="images/painting/multiple_paints.svg"/>
+ <p class="caption">The rightmost rectangle is filled by stacking the paints shown in the other rectangles.</p>
+ </div>
</div>
-<div class="example">
-<pre><![CDATA[
-<rect width="100" height="100" fill="url(#MyHatch1, #MyHatch2 powderblue)">
-]]></pre>
-<div class="figure">
- <img
- alt="An example with a fallback solid paint fill."
- src="images/painting/multiple_paints2.svg"/>
- <p class="caption">The left rectangle shows the expected fill if both MyHatch1 and MyHatch2 are defined. The right rectangle shows the expected fill if MyHatch1 is defined but MyHatch2 is missing.</p>
-</div>
-</div>
-
-
<p>The type <a><paint></a> is defined as:</p>
@@ -189,11 +176,12 @@
descriptions</a>.</dd>
<dt>[ <a><funciri></a> | child | <a><child-selector></a> ] [ none | <a><color></a> | [ <a><color></a>? <a><icccolor></a> ] ]?</dt>
- <dd>A reference to a <a href="pservers.html">paint server</a> element with an
+ <dd>A reference to a <a href="pservers.html">paint server</a> element with, if
+ the paint server is the last paint specified, an
optional fallback color or <span class="prop-value">none</span>.
The <a><funciri></a>, <span class="prop-value">child</span> keyword,
or <a><child-selector></a> is used to identify a <a>'solidColor'</a>
- element, <a>gradient element</a> or <a>'pattern'</a> element,
+ element, <a>gradient element</a>, <a>'pattern'</a> element, or <a>'hatch'</a> element,
which defines the paint to use.
The <span class="prop-value">child</span> keyword in this instance matches the
last child <a>paint server element</a> of the element where the paint value
@@ -204,6 +192,21 @@
is in error (see <a href="implnote.html#ErrorProcessing">Error
processing</a>).</dd>
+ <div class="example">
+ <pre><![CDATA[
+<rect width="100" height="100" fill="url(#MyHatch1, #MyHatch2 powderblue)">
+ ]]></pre>
+ <div class="figure">
+ <img
+ alt="An example with a fallback solid paint fill."
+ src="images/painting/multiple_paints2.svg"/>
+ <p class="caption">The left rectangle shows the expected fill if both MyHatch1 and MyHatch2 are defined. The right rectangle shows the expected fill if MyHatch1 is defined but MyHatch2 is missing.</p>
+ </div>
+ </div>
+
+ <p class="issue">Should the document be in error if a non-final paint-server reference is invalid? (Only the last paint-server has a fallback.)</p>
+ <p class="issue">How should 'child' behave with allowing multiple paints?</p>
+
<dt>context-fill</dt>
<dt>context-stroke</dt>
<dd>The same paint as the computed value of the <a>'fill'</a> or <a>'stroke'</a>