Define path/polygon/polyline with no data set (empty or zero valid commands) to not render.
authorNikos Andronikos <nikos.andronikos@cisra.canon.com.au>
Tue, 29 Apr 2014 09:25:01 +1000
changeset 668 33dcba7ebbde
parent 649 f2678313d917
child 669 98f1838134cd
Define path/polygon/polyline with no data set (empty or zero valid commands) to not render.
Define bounding box for element with no position to be at (0,0).
ACTION-3599
master/coords.html
master/paths.html
master/shapes.html
--- a/master/coords.html	Thu Apr 03 17:56:16 2014 +1100
+++ b/master/coords.html	Tue Apr 29 09:25:01 2014 +1000
@@ -1145,14 +1145,19 @@
 in time at which the bounding box is requested, whether through a script call
 or as part of a declarative or linking syntax.</p>
 
-<p>Note that an element which has zero width, zero height, or both (such as a
+<p>An element which has zero width, zero height, or both (such as a
 vertical or horizontal line, or a <a>'rect'</a> element with an unspecified
 <a>'rect/width'</a> or <a>'rect/height'</a>) still has a bounding box, with a
 positive value for the positive dimension, or with <span class='attr-value'>'0'</span>
 for both the width and height if no positive dimension is specified. Similarly,
 subpaths segments of a <a>'path'</a> element with zero width and height must be
-included in that element's geometry for the sake of the bounding box. Note also
-that elements whose DOM object does not derive from <a>SVGGraphicsElement</a>
+included in that element's geometry for the sake of the bounding box.</p>
+
+<p class="ready-for-wg-review">An element with no position specified (such as a
+<a>'path'</a> element with a value of (none) for the <a>'d'</a> attribute) is positioned at the
+point (0,0) for the purposes of calculating a bounding box.</p>
+
+<p>Note that elements whose DOM object does not derive from <a>SVGGraphicsElement</a>
 (such as gradient elements) do not have a bounding box, and thus have no
 interface to request a bounding box.</p>
 
--- a/master/paths.html	Thu Apr 03 17:56:16 2014 +1100
+++ b/master/paths.html	Tue Apr 29 09:25:01 2014 +1000
@@ -51,7 +51,7 @@
 paths can be found in <a
 href="implnote.html#PathElementImplementationNotes"><span
 class="element-name">'path'</span> element implementation
-notes</a> and <a
+Notes</a> and <a
 href="implnote.html#ArcImplementationNotes">Elliptical arc
 implementation notes</a>.</p>
 
@@ -96,6 +96,8 @@
     given animation element. Flags and booleans are
     interpolated as fractions between zero and one, with any
     non-zero value considered to be a value of one/true.</p>
+    <p class="ready-for-wg-review">The lacuna value, (none) indicates
+    that the path element is valid but does not render.</p>
     <p class="issue">The Value in the table above should be a link to a datatype for path data.</p>
   </dd>
   <dt>
@@ -181,6 +183,7 @@
 <em>moveto</em>, <em>bearing</em>, <em>lineto</em>, <em>curveto</em> (both cubic and
 quadratic B├ęziers), <em>arc</em> and <em>closepath</em>
 instructions.</p>
+
 <p><span class="example-ref">Example triangle01</span>
 specifies a path in the shape of a triangle. (The
 <strong>M</strong> indicates a <em>moveto</em>, the
@@ -1022,6 +1025,11 @@
 <p>Note that the BNF allows the path <a>'d'</a> attribute to be empty. This is not
 an error, instead it disables rendering of the path.</p>
 
+<p class="ready-for-wg-review">
+If path data not matching the grammar is encountered, then the path data is in error
+(see <a href="implnote.html#ErrorProcessing">Error Processing</a>).
+</p>
+
 <h2 id="DistanceAlongAPath">Distance along a path</h2>
 
 <p>Various operations, including <a
--- a/master/shapes.html	Thu Apr 03 17:56:16 2014 +1100
+++ b/master/shapes.html	Tue Apr 29 09:25:01 2014 +1000
@@ -532,6 +532,8 @@
     <p>If an odd number of coordinates is provided, then the element is in
     error, with the same user agent behavior as occurs with an incorrectly
     specified <a>'path'</a> element.</p>
+    <p class="ready-for-wg-review">The lacuna value, (none), indicates that the polyline element
+    is valid but does not render.</p>
   </dd>
 </dl>
 
@@ -589,6 +591,8 @@
     <p>If an odd number of coordinates is provided, then the element is in
     error, with the same user agent behavior as occurs with an incorrectly
     specified <a>'path'</a> element.</p>
+    <p class="ready-for-wg-review">The lacuna value, (none), indicates that the polygon element
+    is valid, but does not render.</p>
   </dd>
 </dl>
 
@@ -675,6 +679,11 @@
     (#x20 | #x9 | #xD | #xA)+
 </pre>
 
+<p class="ready-for-wg-review">
+If data not matching the grammar is encountered, then the points specification is in error
+(see <a href="implnote.html#ErrorProcessing">Error Processing</a>).
+</p>
+
 <h2 id="DOMInterfaces">DOM interfaces</h2>
 
 <h3 id="InterfaceSVGRectElement">Interface SVGRectElement</h3>