- From: Sam Ruby via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 09 Oct 2012 03:13:37 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/2dcontext
In directory hutz:/tmp/cvs-serv23269
Modified Files:
Overview.html
Log Message:
commit 62111a43a68fd103477791c55888ff90ffa786da
Author: Jay Munro <jaymunro@microsoft.com>
Date: Mon Oct 8 20:03:58 2012 -0700
removed features for issue-201
Removed the remaining features per Frank Olivier.
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/2dcontext/Overview.html,v
retrieving revision 1.178
retrieving revision 1.179
diff -u -d -r1.178 -r1.179
--- Overview.html 2 Oct 2012 21:45:18 -0000 1.178
+++ Overview.html 9 Oct 2012 03:13:35 -0000 1.179
@@ -324,7 +324,7 @@
<h1>HTML Canvas 2D Context</h1>
<h2 class="no-num no-toc" id=generatedID></h2>
- <h2 class="no-num no-toc" id="editor's-draft-date-1-january-1970">Editor's Draft 2 October 2012</h2>
+ <h2 class="no-num no-toc" id="editor's-draft-date-1-january-1970">Editor's Draft 9 October 2012</h2>
<dl><dt>Latest Published Version:</dt>
<dd><a href=http://www.w3.org/TR/2dcontext/>http://www.w3.org/TR/2dcontext/</a></dd>
<dt>Latest Editor's Draft:</dt>
@@ -441,7 +441,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 2 October 2012 Editor's Draft.
+ This specification is the 9 October 2012 Editor's Draft.
</p>
@@ -635,11 +635,12 @@
attribute DOMString <a href=#dom-context-2d-linecap title=dom-context-2d-lineCap>lineCap</a>; // "butt", "round", "square" (default "butt")
attribute DOMString <a href=#dom-context-2d-linejoin title=dom-context-2d-lineJoin>lineJoin</a>; // "round", "bevel", "miter" (default "miter")
attribute unrestricted double <a href=#dom-context-2d-miterlimit title=dom-context-2d-miterLimit>miterLimit</a>; // (default 10)
-
+<!-- per Frank Oliver, issue 201 --> <!--
// dashed lines
- void <a href=#dom-context-2d-setlinedash title=dom-context-2d-setLineDash>setLineDash</a>(sequence<unrestricted double> segments); // default empty
- sequence<unrestricted double> <a href=#dom-context-2d-getlinedash title=dom-context-2d-getLineDash>getLineDash</a>();
- attribute unrestricted double <a href=#dom-context-2d-linedashoffset title=dom-context-2d-lineDashOffset>lineDashOffset</a>;
+ void <span title="dom-context-2d-setLineDash">setLineDash</span>(sequence<unrestricted double> segments); // default empty
+ sequence<unrestricted double> <span title="dom-context-2d-getLineDash">getLineDash</span>();
+ attribute unrestricted double <span title="dom-context-2d-lineDashOffset">lineDashOffset</span>;
+-->
// text
attribute DOMString <a href=#dom-context-2d-font title=dom-context-2d-font>font</a>; // (default 10px sans-serif)
@@ -678,8 +679,8 @@
<!-- <span>SVGMatrix</span>? <span title="dom-HitRegionOptions-transform">transform</span> = null;
--> <span>DOMString</span> <span title=dom-HitRegionOptions-id>id</span> = "";
<span>DOMString</span>? <span title=dom-HitRegionOptions-parentID>parentID</span> = null;
- <span>DOMString</span> <span title=dom-HitRegionOptions-cursor>cursor</span> = "inherit";
- // for control-backed regions:
+<!-- per Frank Oliver, issue 201 --> <!-- <span>DOMString</span> <span title="dom-HitRegionOptions-cursor">cursor</span> = "inherit";
+--> // for control-backed regions:
<span>Element</span>? <span title=dom-HitRegionOptions-control>control</span> = null;
// for unbacked regions:
<span>DOMString</span>? <span title=dom-HitRegionOptions-label>label</span> = null;
@@ -699,11 +700,12 @@
[<a href=#dom-path title=dom-Path>Constructor</a>]
interface <dfn id=path>Path</dfn> {
void <a href=#dom-path-addpath title=dom-path-addPath>addPath</a>(<a href=#path>Path</a> path, <span>SVGMatrix</span>? transformation);
- void <a href=#dom-path-addpathbystrokingpath title=dom-path-addPathByStrokingPath>addPathByStrokingPath</a>(<a href=#path>Path</a> path, <a href=#canvasdrawingstyles>CanvasDrawingStyles</a> styles, <span>SVGMatrix</span>? transformation);
- void <a href=#dom-path-addtext title=dom-path-addText>addText</a>(DOMString text, <a href=#canvasdrawingstyles>CanvasDrawingStyles</a> styles, <span>SVGMatrix</span>? transformation, unrestricted double x, unrestricted double y, optional unrestricted double maxWidth);
- void <a href=#dom-path-addpathbystrokingtext title=dom-path-addPathByStrokingText>addPathByStrokingText</a>(DOMString text, <a href=#canvasdrawingstyles>CanvasDrawingStyles</a> styles, <span>SVGMatrix</span>? transformation, unrestricted double x, unrestricted double y, optional unrestricted double maxWidth);
- void <a href=#dom-path-addtext title=dom-path-addText>addText</a>(DOMString text, <a href=#canvasdrawingstyles>CanvasDrawingStyles</a> styles, <span>SVGMatrix</span>? transformation, <a href=#path>Path</a> path, optional unrestricted double maxWidth);
- void <a href=#dom-path-addpathbystrokingtext title=dom-path-addPathByStrokingText>addPathByStrokingText</a>(DOMString text, <a href=#canvasdrawingstyles>CanvasDrawingStyles</a> styles, <span>SVGMatrix</span>? transformation, <a href=#path>Path</a> path, optional unrestricted double maxWidth);
+<!-- per Frank Oliver, issue 201 --> <!-- void <span title="dom-path-addPathByStrokingPath">addPathByStrokingPath</span>(<span>Path</span> path, <span>CanvasDrawingStyles</span> styles, <span>SVGMatrix</span>? transformation);
+ void <span title="dom-path-addText">addText</span>(DOMString text, <span>CanvasDrawingStyles</span> styles, <span>SVGMatrix</span>? transformation, unrestricted double x, unrestricted double y, optional unrestricted double maxWidth);
+ void <span title="dom-path-addPathByStrokingText">addPathByStrokingText</span>(DOMString text, <span>CanvasDrawingStyles</span> styles, <span>SVGMatrix</span>? transformation, unrestricted double x, unrestricted double y, optional unrestricted double maxWidth);
+ void <span title="dom-path-addText">addText</span>(DOMString text, <span>CanvasDrawingStyles</span> styles, <span>SVGMatrix</span>? transformation, <span>Path</span> path, optional unrestricted double maxWidth);
+ void <span title="dom-path-addPathByStrokingText">addPathByStrokingText</span>(DOMString text, <span>CanvasDrawingStyles</span> styles, <span>SVGMatrix</span>? transformation, <span>Path</span> path, optional unrestricted double maxWidth);
+-->
};
<a href=#path>Path</a> implements <a href=#canvaspathmethods>CanvasPathMethods</a>;</pre>
@@ -931,10 +933,10 @@
</dd>
-
- <dt><var title="">context</var> . <code title=dom-context-2d-setLineDash><a href=#dom-context-2d-setlinedash>setLineDash</a></code>(<var title="">segments</var>)</dt>
- <dt><var title="">styles</var> . <code title=dom-context-2d-setLineDash><a href=#dom-context-2d-setlinedash>setLineDash</a></code>(<var title="">segments</var>)</dt>
-
+<!-- per Frank Oliver, issue 201 --><!--
+ <dt><var title="">context</var> . <code title="dom-context-2d-setLineDash">setLineDash</code>(<var title="">segments</var>)</dt>
+ <dt><var title="">styles</var> . <code title="dom-context-2d-setLineDash">setLineDash</code>(<var title="">segments</var>)</dt>
+
<dd>
<p>Sets the current line dash pattern (as used when stroking). The
@@ -944,8 +946,8 @@
</dd>
- <dt><var title="">segments</var> = <var title="">context</var> . <code title=dom-context-2d-getLineDash><a href=#dom-context-2d-getlinedash>getLineDash</a></code>()</dt>
- <dt><var title="">segments</var> = <var title="">styles</var> . <code title=dom-context-2d-getLineDash><a href=#dom-context-2d-getlinedash>getLineDash</a></code>()</dt>
+ <dt><var title="">segments</var> = <var title="">context</var> . <code title="dom-context-2d-getLineDash">getLineDash</code>()</dt>
+ <dt><var title="">segments</var> = <var title="">styles</var> . <code title="dom-context-2d-getLineDash">getLineDash</code>()</dt>
<dd>
@@ -956,8 +958,8 @@
</dd>
- <dt><var title="">context</var> . <code title=dom-context-2d-lineDashOffset><a href=#dom-context-2d-linedashoffset>lineDashOffset</a></code></dt>
- <dt><var title="">styles</var> . <code title=dom-context-2d-lineDashOffset><a href=#dom-context-2d-linedashoffset>lineDashOffset</a></code></dt>
+ <dt><var title="">context</var> . <code title="dom-context-2d-lineDashOffset">lineDashOffset</code></dt>
+ <dt><var title="">styles</var> . <code title="dom-context-2d-lineDashOffset">lineDashOffset</code></dt>
<dd>
@@ -967,7 +969,7 @@
finite values are ignored.</p>
</dd>
-
+-->
</dl><div class=impl>
<p>Objects that implement the <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code>
@@ -1030,15 +1032,19 @@
interface is created, the <code title=dom-context-2d-miterLimit><a href=#dom-context-2d-miterlimit>miterLimit</a></code> attribute must
initially have the value <code>10.0</code>.</p>
- <hr><hr><p>Each <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code> object has a <dfn id=dash-list>dash
+ <hr><!-- per Frank Oliver, issue 201 --><!--
+ <hr><p>Each <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code> object has a <dfn id=dash-list>dash
list</dfn>, which is either empty or consists of an even number of
positive non-zero numbers. Initially, the <a href=#dash-list>dash list</a>
must be empty.</p>
- <p>When the <dfn id=dom-context-2d-setlinedash title=dom-context-2d-setLineDash><code>setLineDash()</code></dfn>
+ <p>When the <dfn
+ title="dom-context-2d-setLineDash"><code>setLineDash()</code></dfn>
method is invoked, it must run the following steps:</p>
- <ol><li><p>Let <var title="">a</var> be a copy of the array provided as
+ <ol>
+
+ <li><p>Let <var title="">a</var> be a copy of the array provided as
the argument.</p></li>
<li><p>If any value in the array is not finite (e.g. an Infinity or
@@ -1051,38 +1057,49 @@
then let <var title="">a</var> be the concatentation of two copies
of <var title="">a</var>.</p></li>
- <li><p>Let the object's <a href=#dash-list>dash list</a> be <var title="">a</var>.</p></li>
+ <li><p>Let the object's <span>dash list</span> be <var
+ title="">a</var>.</p></li>
- </ol><p>When the <dfn id=dom-context-2d-getlinedash title=dom-context-2d-getLineDash><code>getLineDash()</code></dfn>
+ </ol>
+
+ <p>When the <dfn
+ title="dom-context-2d-getLineDash"><code>getLineDash()</code></dfn>
method is invoked, it must return a newly created array whose values
- are the values of the object's <a href=#dash-list>dash list</a>, in the same
+ are the values of the object's <span>dash list</span>, in the same
order.</p>
<p>It is sometimes useful to change the "phase" of the dash pattern,
e.g. to achieve a "marching ants" effect. The phase can be set using
- the <dfn id=dom-context-2d-linedashoffset title=dom-context-2d-lineDashOffset><code>lineDashOffset</code></dfn>
+ the <dfn
+ title="dom-context-2d-lineDashOffset"><code>lineDashOffset</code></dfn>
attribute. On getting, it must return the current value. On setting,
infinite and NaN values must be ignored, leaving the value
unchanged; other values must change the current value to the new
value.</p>
- <p>When the object implementing the <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code>
- interface is created, the <code title=dom-context-2d-lineDashOffset><a href=#dom-context-2d-linedashoffset>lineDashOffset</a></code>
+ <p>When the object implementing the <code>CanvasDrawingStyles</code>
+ interface is created, the <code
+ title="dom-context-2d-lineDashOffset">lineDashOffset</code>
attribute must initially have the value <code>0.0</code>.</p>
- <hr><p>When a user agent is to <dfn id=trace-a-path>trace a <span>path</span></dfn>,
+ <hr>
+
+ <p>When a user agent is to <dfn>trace a <span>path</span></dfn>,
given an object <var title="">style</var> that implements the
- <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code> interface, it must run the following
- algorithm. This algorithm returns a new <a href=#path>path</a>.</p>
+ <code>CanvasDrawingStyles</code> interface, it must run the following
+ algorithm. This algorithm returns a new <span>path</span>.</p>
- <ol><li><p>Let <var title="">path</var> be a copy of the path being
+ <ol>
+
+ <li><p>Let <var title="">path</var> be a copy of the path being
traced.</p></li>
<li><p>Remove from <var title="">path</var> any subpaths containing
no lines (i.e. empty subpaths with zero points, and subpaths with
just one point).</p></li>
- <li><p>Replace each point in each subpath of <var title="">path</var> other than the first point and the last point
+ <li><p>Replace each point in each subpath of <var
+ title="">path</var> other than the first point and the last point
of each subpath by a <i>join</i> that joins the line leading to
that point to the line leading out of that point, such that the
subpaths all consist of two points (a starting point with a line
@@ -1092,40 +1109,50 @@
together such that each subpath is a series of one or more lines
with a join between each one and a point on each end.</p></li>
- <li><p>Add a straight closing line to each closed subpath in <var title="">path</var> connecting the last point and the first point
+ <li><p>Add a straight closing line to each closed subpath in <var
+ title="">path</var> connecting the last point and the first point
of that subpath; change the last point to a join (from the
previously last line to the newly added closing line), and change
the first point to a join (from the newly added closing line to the
first line).</p>
-
- </li><li><p>If the <var title="">styles</var> <a href=#dash-list>dash list</a> is
+<!-- per Frank Oliver, issue 201 --><!--
+ <li><p>If the <var title="">styles</var> <span>dash list</span> is
empty, jump to the step labeled <i>joins</i>.</p></li>
<li><p>Let <var title="">width</var> be the aggregate length of all
the lines of all the subpaths in <var title="">path</var>, in
coordinate space units.</p></li>
- <li><p>Let <var title="">offset</var> be the value of the <var title="">styles</var> <code title=dom-context-2d-lineDashOffset><a href=#dom-context-2d-linedashoffset>lineDashOffset</a></code>, in
+ <li><p>Let <var title="">offset</var> be the value of the <var
+ title="">styles</var> <code
+ title="dom-context-2d-lineDashOffset">lineDashOffset</code>, in
coordinate space units.</p></li>
<li>
- <p>While <var title="">offset</var> is greater than <var title="">width</var>, decrement it by <var title="">width</var>.</p>
+ <p>While <var title="">offset</var> is greater than <var
+ title="">width</var>, decrement it by <var
+ title="">width</var>.</p>
- <p>While <var title="">offset</var> is less than <var title="">width</var>, increment it by <var title="">width</var>.</p>
+ <p>While <var title="">offset</var> is less than <var
+ title="">width</var>, increment it by <var
+ title="">width</var>.</p>
</li>
<li><p><i>Offset subpath</i>: If <var title="">offset</var> is
- non-zero, add a new subpath at the start of <var title="">path</var> consisting of two points connected by a line
+ non-zero, add a new subpath at the start of <var
+ title="">path</var> consisting of two points connected by a line
whose length is <var title="">offset</var> coordinate space units.
(This path is temporary and will be removed in the <i>joins</i>
step below. Its purpose is to offset the dash pattern.)</p>
- </li><li><p>Define <var title="">L</var> to be a linear coordinate line
- defined along all lines in all the subpaths in <var title="">path</var>, such that the start of the first line in the
+ <li><p>Define <var title="">L</var> to be a linear coordinate line
+ defined along all lines in all the subpaths in <var
+ title="">path</var>, such that the start of the first line in the
first subpath is defined as coordinate 0, and the end of the last
- line in the last subpath is defined as coordinate <var title="">width</var>.</p></li>
+ line in the last subpath is defined as coordinate <var
+ title="">width</var>.</p></li>
<li><p>Let <var title="">position</var> be 0.</p></li>
@@ -1135,35 +1162,44 @@
other states being <i>on</i> and <i>zero-on</i>).</p></li>
<li><p><i>Dash On</i>: Let <var title="">segment length</var> be
- the value of the <var title="">styles</var> <a href=#dash-list>dash
- list</a>'s <var title="">index</var>th entry.</p></li>
+ the value of the <var title="">styles</var> <span>dash
+ list</span>'s <var title="">index</var>th entry.</p></li>
- <li><p>Increment <var title="">position</var> by <var title="">segment length</var>.</p></li>
+ <li><p>Increment <var title="">position</var> by <var
+ title="">segment length</var>.</p></li>
- <li><p>If <var title="">position</var> is greater than <var title="">width</var>, then jump to the step labeled
+ <li><p>If <var title="">position</var> is greater than <var
+ title="">width</var>, then jump to the step labeled
<i>joins</i>.</p></li>
- <li><p>If <var title="">segment length</var> is non-zero, let <var title="">current state</var> be <i>on</i>.</p></li>
+ <li><p>If <var title="">segment length</var> is non-zero, let <var
+ title="">current state</var> be <i>on</i>.</p></li>
<li><p>Increment <var title="">index</var> by one.</p></li>
<li><p><i>Dash Off</i>: Let <var title="">segment length</var> be
- the value of the <var title="">styles</var> <a href=#dash-list>dash
- list</a>'s <var title="">index</var>th entry.</p></li>
+ the value of the <var title="">styles</var> <span>dash
+ list</span>'s <var title="">index</var>th entry.</p></li>
- <li><p>Let <var title="">start</var> be the offset <var title="">position</var> on <var title="">L</var>.</p></li>
+ <li><p>Let <var title="">start</var> be the offset <var
+ title="">position</var> on <var title="">L</var>.</p></li>
- <li><p>Increment <var title="">position</var> by <var title="">segment length</var>.</p></li>
+ <li><p>Increment <var title="">position</var> by <var
+ title="">segment length</var>.</p></li>
- <li><p>If <var title="">position</var> is greater than <var title="">width</var>, then let <var title="">end</var> be the
+ <li><p>If <var title="">position</var> is greater than <var
+ title="">width</var>, then let <var title="">end</var> be the
offset <var title="">width</var> on <var title="">L</var>.
- Otherwise, let <var title="">end</var> be the offset <var title="">position</var> on <var title="">L</var>.</p></li>
+ Otherwise, let <var title="">end</var> be the offset <var
+ title="">position</var> on <var title="">L</var>.</p></li>
<li>
<p>Jump to the first appropriate step:</p>
- <dl class=switch><dt>If <var title="">segment length</var> is zero and <var title="">current state</var> is <i>off</i></dt>
+ <dl class="switch">
+
+ <dt>If <var title="">segment length</var> is zero and <var title="">current state</var> is <i>off</i></dt>
<dd>
@@ -1179,7 +1215,8 @@
<p>Cut the line on which <var title="">end</var> finds itself
short at <var title="">end</var> and place a point there,
cutting the subpath that it was in in two; remove all line
- segments, joins, points, and subpaths that are between <var title="">start</var> and <var title="">end</var>; and finally
+ segments, joins, points, and subpaths that are between <var
+ title="">start</var> and <var title="">end</var>; and finally
place a single point at <var title="">start</var> with no lines
connecting to it.</p>
@@ -1198,9 +1235,11 @@
<p>Cut the line on which <var title="">start</var> finds itself
into two at <var title="">start</var> and place a point there,
cutting the subpath that it was in in two, and similarly cut the
- line on which <var title="">end</var> finds itself short at <var title="">end</var> and place a point there, cutting the subpath
+ line on which <var title="">end</var> finds itself short at <var
+ title="">end</var> and place a point there, cutting the subpath
that <em>it</em> was in in two, and then remove all line segments,
- joins, points, and subpaths that are between <var title="">start</var> and <var title="">end</var>.</p>
+ joins, points, and subpaths that are between <var
+ title="">start</var> and <var title="">end</var>.</p>
<p>If <var title="">start</var> and <var title="">end</var> are
the same point, then this results in just the line being cut in
@@ -1210,9 +1249,12 @@
</dd>
- </dl></li>
+ </dl>
- <li><p>If <var title="">position</var> is greater than <var title="">width</var>, then jump to the step labeled
+ </li>
+
+ <li><p>If <var title="">position</var> is greater than <var
+ title="">width</var>, then jump to the step labeled
<i>joins</i>.</p></li>
<li><p>If <var title="">segment length</var> is greater than zero,
@@ -1220,12 +1262,11 @@
<li><p>Increment <var title="">index</var> by one. If it is equal
to the number of entries in the <var title="">styles</var>
- <a href=#dash-list>dash list</a>, then let <var title="">index</var> be
+ <span>dash list</span>, then let <var title="">index</var> be
0.</p></li>
<li><p>Return to the step labeled <i>dash on</i>.</p></li>
-
- <li><p><i>Joins</i>: Remove from <var title="">path</var> any
+--><!-- per Frank Oliver, issue 201 --><li><p><i>Joins</i>: Remove from <var title="">path</var> any
subpath that originally formed part of the subpath added in the
<i>offset subpath</i> step above.</p></li>
@@ -1356,8 +1397,12 @@
<li><p>Return the newly created path.</p></li>
- </ol><!--v6: Another request has been for hairline width lines, that remain
-hairline width with transform. ack Shaun Morris. --></div>
+
+
+<!--v6: Another request has been for hairline width lines, that remain
+hairline width with transform. ack Shaun Morris. -->
+
+ </div>
<h6 id=text-styles><span class=secno>1.4 </span>Text styles</h6>
@@ -2099,8 +2144,8 @@
</dd>
<dt><var title="">path</var> . <code title=dom-path-addPath><a href=#dom-path-addpath>addPath</a></code>(<var title="">path</var>, <var title="">transform</var>)</dt>
- <dt><var title="">path</var> . <code title=dom-path-addPathByStrokingPath><a href=#dom-path-addpathbystrokingpath>addPathByStrokingPath</a></code>(<var title="">path</var>, <var title="">styles</var>, <var title="">transform</var>)</dt>
-
+<!-- per Frank Oliver, issue 201 --> <!-- <dt><var title="">path</var> . <code title="dom-path-addPathByStrokingPath">addPathByStrokingPath</code>(<var title="">path</var>, <var title="">styles</var>, <var title="">transform</var>)</dt>
+-->
<dd>
<p>Adds to the path the path given by the argument.</p>
@@ -2108,12 +2153,12 @@
<p>In the case of the stroking variants, the line styles are taken from the <var title="">styles</var> argument, which can be either a <code><a href=#drawingstyle>DrawingStyle</a></code> object or a <code><a href=#canvasrenderingcontext2d>CanvasRenderingContext2D</a></code> object.</p>
</dd>
-
- <dt><var title="">path</var> . <code title=dom-path-addText><a href=#dom-path-addtext>addText</a></code>(<var title="">text</var>, <var title="">styles</var>, <var title="">transform</var>, <var title="">x</var>, <var title="">y</var> [, <var title="">maxWidth</var> ])</dt>
- <dt><var title="">path</var> . <code title=dom-path-addText><a href=#dom-path-addtext>addText</a></code>(<var title="">text</var>, <var title="">styles</var>, <var title="">transform</var>, <var title="">path</var> [, <var title="">maxWidth</var> ])</dt>
- <dt><var title="">path</var> . <code title=dom-path-addPathByStrokingText><a href=#dom-path-addpathbystrokingtext>addPathByStrokingText</a></code>(<var title="">text</var>, <var title="">styles</var>, <var title="">transform</var>, <var title="">x</var>, <var title="">y</var> [, <var title="">maxWidth</var> ])</dt>
- <dt><var title="">path</var> . <code title=dom-path-addPathByStrokingText><a href=#dom-path-addpathbystrokingtext>addPathByStrokingText</a></code>(<var title="">text</var>, <var title="">styles</var>, <var title="">transform</var>, <var title="">path</var> [, <var title="">maxWidth</var> ])</dt>
-
+<!-- per Frank Oliver, issue 201 --><!--
+ <dt><var title="">path</var> . <code title="dom-path-addText">addText</code>(<var title="">text</var>, <var title="">styles</var>, <var title="">transform</var>, <var title="">x</var>, <var title="">y</var> [, <var title="">maxWidth</var> ])</dt>
+ <dt><var title="">path</var> . <code title="dom-path-addText">addText</code>(<var title="">text</var>, <var title="">styles</var>, <var title="">transform</var>, <var title="">path</var> [, <var title="">maxWidth</var> ])</dt>
+ <dt><var title="">path</var> . <code title="dom-path-addPathByStrokingText">addPathByStrokingText</code>(<var title="">text</var>, <var title="">styles</var>, <var title="">transform</var>, <var title="">x</var>, <var title="">y</var> [, <var title="">maxWidth</var> ])</dt>
+ <dt><var title="">path</var> . <code title="dom-path-addPathByStrokingText">addPathByStrokingText</code>(<var title="">text</var>, <var title="">styles</var>, <var title="">transform</var>, <var title="">path</var> [, <var title="">maxWidth</var> ])</dt>
+-->
<dd>
<p>Adds to the path a series of subpaths corresponding to the given text. If the arguments give a coordinate, the text is drawn horizontally at the given coordinates. If the arguments give a path, the text is drawn along the path. If a maximum width is provided, the text will be scaled to fit that width if necessary.</p>
@@ -2147,94 +2192,130 @@
<li><p>Create a new subpath in <var title="">a</var> with (<var title="">x</var>, <var title="">y</var>) as the only point in the
subpath.</p></li>
- </ol><hr><p>The <dfn id=dom-path-addpathbystrokingpath title=dom-path-addPathByStrokingPath><code>addPathByStrokingPath(<var title="">b</var>, <var title="">styles</var>, <var title="">transform</var>)</code></dfn> method, when invoked on a
- <code><a href=#path>Path</a></code> object <var title="">a</var>, must run the
+ </ol><hr><!-- per Frank Oliver, issue 201 --><!--
+ <p>The <dfn
+ title="dom-path-addPathByStrokingPath"><code>addPathByStrokingPath(<var
+ title="">b</var>, <var title="">styles</var>, <var
+ title="">transform</var>)</code></dfn> method, when invoked on a
+ <code>Path</code> object <var title="">a</var>, must run the
following steps:</p>
- <ol><li><p>If the <code><a href=#path>Path</a></code> object <var title="">b</var> has
+ <ol>
+
+ <li><p>If the <code>Path</code> object <var title="">b</var> has
no subpaths, abort these steps.</p></li>
<li><p>Create a copy of all the subpaths in <var title="">b</var>.
Let this copy be known as <var title="">c</var>.</p></li>
- <li><p>Transform all the coordinates and lines in <var title="">c</var> by transformation matrix <var title="">transform</var>, if it is not null.</p></li>
+ <li><p>Transform all the coordinates and lines in <var
+ title="">c</var> by transformation matrix <var
+ title="">transform</var>, if it is not null.</p></li>
<li><p>Let a new list of subpaths <var title="">d</var> be the
- result of <a href=#trace-a-path title="trace a path">tracing</a> <var title="">c</var>, using the <var title="">styles</var> argument for
+ result of <span title="trace a path">tracing</span> <var
+ title="">c</var>, using the <var title="">styles</var> argument for
the line styles.</p>
- </li><li><p>Let (<var title="">x</var>, <var title="">y</var>) be the
+ <li><p>Let (<var title="">x</var>, <var title="">y</var>) be the
last point in the last subpath of <var title="">d</var>.</p></li>
- <li><p>Add all the subpaths in <var title="">d</var> to <var title="">a</var>.</p></li>
+ <li><p>Add all the subpaths in <var title="">d</var> to <var
+ title="">a</var>.</p></li>
- <li><p>Create a new subpath in <var title="">a</var> with (<var title="">x</var>, <var title="">y</var>) as the only point in the
+ <li><p>Create a new subpath in <var title="">a</var> with (<var
+ title="">x</var>, <var title="">y</var>) as the only point in the
subpath.</p></li>
- </ol><hr><p>The <dfn id=dom-path-addtext title=dom-path-addText><code>addText()</code></dfn>
- and <dfn id=dom-path-addpathbystrokingtext title=dom-path-addPathByStrokingText><code>addPathByStrokingText()</code></dfn>
+ </ol>
+
+ <hr>
+
+ <p>The <dfn title="dom-path-addText"><code>addText()</code></dfn>
+ and <dfn
+ title="dom-path-addPathByStrokingText"><code>addPathByStrokingText()</code></dfn>
methods each come in two variants: one rendering text at a given
coordinate, and one rendering text along a given path. In both
- cases, the methods take a <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code> object
+ cases, the methods take a <code>CanvasDrawingStyles</code> object
argument for the text and (if appropriate) line styles to use, an
<code>SVGMatrix</code> object <var title="">transform</var> (which
can be null), and a maximum width can optionally be provided.</p>
- <p>When one of the <code title=dom-path-addText><a href=#dom-path-addtext>addText()</a></code> and <code title=dom-path-addPathByStrokingText><a href=#dom-path-addpathbystrokingtext>addPathByStrokingText()</a></code> variants
- that take as argument an (<var title="">x</var>, <var title="">y</var>) coordinate is invoked, the method must run the
+ <p>When one of the <code
+ title="dom-path-addText">addText()</code> and <code
+ title="dom-path-addPathByStrokingText">addPathByStrokingText()</code> variants
+ that take as argument an (<var title="">x</var>, <var
+ title="">y</var>) coordinate is invoked, the method must run the
following algorithm:</p>
- <ol><li><p>Run the <a href=#text-preparation-algorithm>text preparation algorithm</a>, passing it
- <var title="">text</var>, the <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code>
+ <ol>
+
+ <li><p>Run the <span>text preparation algorithm</span>, passing it
+ <var title="">text</var>, the <code>CanvasDrawingStyles</code>
object argument, and, if the <var title="">maxWidth</var> argument
was provided, that argument. Let <var title="">glyphs</var> be the
result.</p>
- </li><li><p>Move all the shapes in <var title="">glyphs</var> to the
- right by <var title="">x</var> CSS pixels and down by <var title="">y</var> CSS pixels.</p></li>
+ <li><p>Move all the shapes in <var title="">glyphs</var> to the
+ right by <var title="">x</var> CSS pixels and down by <var
+ title="">y</var> CSS pixels.</p></li>
<li><p>Let <var title="">glyph subpaths</var> be a
- <a href=#path>path</a> describing the shapes given in <var title="">glyphs</var>, with each CSS pixel in the coordinate space
+ <span>path</span> describing the shapes given in <var
+ title="">glyphs</var>, with each CSS pixel in the coordinate space
of <var title="">glyphs</var> mapped to one coordinate space unit
- in <var title="">glyph subpaths</var>. Subpaths in <var title="">glyph subpaths</var> must wind clockwise, regardless of
+ in <var title="">glyph subpaths</var>. Subpaths in <var
+ title="">glyph subpaths</var> must wind clockwise, regardless of
how the user agent's font subsystem renders fonts and regardless of
how the fonts themselves are defined.</p>
- </li><li><p>If the method is <code title=dom-path-addPathByStrokingText><a href=#dom-path-addpathbystrokingtext>addPathByStrokingText()</a></code>,
- replace <var title="">glyph subpaths</var> by the result of <a href=#trace-a-path title="trace a path">tracing</a> <var title="">glyph
- subpaths</var>, using the <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code> object
+ <li><p>If the method is <code
+ title="dom-path-addPathByStrokingText">addPathByStrokingText()</code>,
+ replace <var title="">glyph subpaths</var> by the result of <span
+ title="trace a path">tracing</span> <var title="">glyph
+ subpaths</var>, using the <code>CanvasDrawingStyles</code> object
argument for the line styles.</p>
- </li><li><p>Transform all the coordinates and lines in <var title="">glyph subpaths</var> by the transformation matrix <var title="">transform</var>, if it is not null.</p></li>
+ <li><p>Transform all the coordinates and lines in <var
+ title="">glyph subpaths</var> by the transformation matrix <var
+ title="">transform</var>, if it is not null.</p></li>
- <li><p>Let (<var title="">x<sub title="">final</sub></var>, <var title="">y<sub title="">final</sub></var>) be the last point in the
+ <li><p>Let (<var title="">x<sub title="">final</sub></var>, <var
+ title="">y<sub title="">final</sub></var>) be the last point in the
last subpath of <var title="">glyph subpaths</var>.</p></li>
<li><p>Add all the subpaths in <var title="">glyph
- subpaths</var> to the <code><a href=#path>Path</a></code> object.</p></li>
+ subpaths</var> to the <code>Path</code> object.</p></li>
- <li><p>Create a new subpath in the <code><a href=#path>Path</a></code> object with
- (<var title="">x<sub title="">final</sub></var>, <var title="">y<sub title="">final</sub></var>) as the only point in the
+ <li><p>Create a new subpath in the <code>Path</code> object with
+ (<var title="">x<sub title="">final</sub></var>, <var
+ title="">y<sub title="">final</sub></var>) as the only point in the
subpath.</p></li>
- </ol><p>When one of the <code title=dom-path-addText><a href=#dom-path-addtext>addText()</a></code> and <code title=dom-path-addPathByStrokingText><a href=#dom-path-addpathbystrokingtext>addPathByStrokingText()</a></code>
- variants that take as argument a <code><a href=#path>Path</a></code> object is
+ </ol>
+
+ <p>When one of the <code
+ title="dom-path-addText">addText()</code> and <code
+ title="dom-path-addPathByStrokingText">addPathByStrokingText()</code>
+ variants that take as argument a <code>Path</code> object is
invoked, the method must run the following algorithm:</p>
- <ol><li><p>Let <var title="">target</var> be the <code><a href=#path>Path</a></code>
+ <ol>
+
+ <li><p>Let <var title="">target</var> be the <code>Path</code>
object on which the method was invoked.</p></li>
- <li><p>Let <var title="">path</var> be the <code><a href=#path>Path</a></code> object
+ <li><p>Let <var title="">path</var> be the <code>Path</code> object
that was provided in the method's arguments.</p></li>
- <li><p>Run the <a href=#text-preparation-algorithm>text preparation algorithm</a>, passing it
- <var title="">text</var>, the <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code>
+ <li><p>Run the <span>text preparation algorithm</span>, passing it
+ <var title="">text</var>, the <code>CanvasDrawingStyles</code>
object argument, and, if the <var title="">maxWidth</var> argument
was provided, that argument. Let <var title="">glyphs</var> be the
resulting array, and <var title="">physical alignment</var> be the
resulting alignment value.</p>
- </li><li><p>Let <var title="">width</var> be the aggregate length of all
+ <li><p>Let <var title="">width</var> be the aggregate length of all
the subpaths in <var title="">path</var>, including the distances
from the last point of each closed subpath to the first point of
that subpath.</p></li>
@@ -2253,7 +2334,9 @@
<p>Let <var title="">offset</var> be determined according to the
appropriate step below:</p>
- <dl class=switch><dt>If <var title="">physical alignment</var> is <i>left</i></dt>
+ <dl class="switch">
+
+ <dt>If <var title="">physical alignment</var> is <i>left</i></dt>
<dd>Let <var title="">offset</var> be zero.</dd>
<dt>If <var title="">physical alignment</var> is <i>right</i></dt>
@@ -2262,28 +2345,34 @@
<dt>If <var title="">physical alignment</var> is <i title="">center</i></dt>
<dd>Let <var title="">offset</var> be half of <var title="">width</var>.</dd>
- </dl></li>
+ </dl>
+
+ </li>
<li><p>Move all the shapes in <var title="">glyphs</var> to the
right by <var title="">offset</var> CSS pixels.</p></li>
<li>
- <p>For each glyph <var title="">glyph</var> in the <var title="">glyphs</var> array, run these substeps:</p>
+ <p>For each glyph <var title="">glyph</var> in the <var
+ title="">glyphs</var> array, run these substeps:</p>
- <ol><li><p>Let <var title="">dx</var> be the <var title="">x</var>-coordinate of the horizontal center of the
- bounding box of the shape described by <var title="">glyph</var>, in CSS pixels.</p></li>
+ <ol>
- <li><p>If <var title="">dx</var> is negative or greater than <var title="">width</var>, skip the remainder of these substeps for
+ <li><p>Let <var title="">dx</var> be the <var
+ title="">x</var>-coordinate of the horizontal center of the
+ bounding box of the shape described by <var
+ title="">glyph</var>, in CSS pixels.</p></li>
+
+ <li><p>If <var title="">dx</var> is negative or greater than <var
+ title="">width</var>, skip the remainder of these substeps for
this glyph.</p></li>
<li><p>Recast <var title="">dx</var> to coordinate spaces units
in <var title="">path</var>. (This just changes the
dimensionality of <var title="">dx</var>, not its numeric
value.)</p> <!-- hide this step if people get confused by the
- pedancy -->
-
- </li><li><p>Find the point <var title="">p</var> on <var title="">path</var> (or implied closing lines in <var title="">path</var>) that corresponds to the position <var title="">dx</var> on the coordinate line <var title="">L</var>.</p>
+ pedancy --><li><p>Find the point <var title="">p</var> on <var title="">path</var> (or implied closing lines in <var title="">path</var>) that corresponds to the position <var title="">dx</var> on the coordinate line <var title="">L</var>.</p>
</li><li><p>Let <var title="">θ</var> be the clockwise angle
from the positive x-axis to the side of the line that is
@@ -2308,8 +2397,8 @@
agent's font subsystem renders fonts and regardless of how the
fonts themselves are defined.</p>
- </li><li><p>If the method is <code title=dom-path-addPathByStrokingText><a href=#dom-path-addpathbystrokingtext>addPathByStrokingText()</a></code>,
- replace <var title="">glyph subpaths</var> by the result of <a href=#trace-a-path title="trace a path">tracing</a> <var title="">glyph
+ </li><li><p>If the method is <code title=dom-path-addPathByStrokingText>addPathByStrokingText()</code>,
+ replace <var title="">glyph subpaths</var> by the result of <span title="trace a path">tracing</span> <var title="">glyph
subpaths</var>, using the <code><a href=#canvasdrawingstyles>CanvasDrawingStyles</a></code> object
argument for the line styles.</p>
@@ -2323,13 +2412,17 @@
<li><p>Add all the subpaths in <var title="">glyph subpaths</var>
to <var title="">target</var>.</p></li>
- </ol></li>
+
+
+
<li><p>Create a new subpath in the <code><a href=#path>Path</a></code> object with
(<var title="">x<sub title="">final</sub></var>, <var title="">y<sub title="">final</sub></var>) as the only point in the
subpath.</p></li>
- </ol></div>
+
+--><!-- per Frank Oliver, issue 201 -->
+ </div>
@@ -2911,13 +3004,13 @@
rectangular area using the <code title=dom-context-2d-fillStyle><a href=#dom-context-2d-fillstyle>fillStyle</a></code>. If either height
or width are zero, this method has no effect.</p>
- <p>The <dfn id=dom-context-2d-strokerect title=dom-context-2d-strokeRect><code>strokeRect(<var title="">x</var>, <var title="">y</var>, <var title="">w</var>, <var title="">h</var>)</code></dfn> method must take the result of <a href=#trace-a-path title="trace a path">tracing the path</a> described below, using
+ <p>The <dfn id=dom-context-2d-strokerect title=dom-context-2d-strokeRect><code>strokeRect(<var title="">x</var>, <var title="">y</var>, <var title="">w</var>, <var title="">h</var>)</code></dfn> method must take the result of <span title="trace a path">tracing the path</span> described below, using
the <code><a href=#canvasrenderingcontext2d>CanvasRenderingContext2D</a></code> object's line styles, and
fill it with the <code title=dom-context-2d-strokeStyle><a href=#dom-context-2d-strokestyle>strokeStyle</a></code>.</p>
<p>If both <var title="">w</var> and <var title="">h</var> are zero,
the path has a single subpath with just one point (<var title="">x</var>, <var title="">y</var>), and no lines, and this
- method thus has no effect (the <a href=#trace-a-path>trace a path</a> algorithm
+ method thus has no effect (the <span>trace a path</span> algorithm
returns an empty path in that case).</p>
<p>If just one of either <var title="">w</var> or <var title="">h</var> is zero, then the path has a single subpath
@@ -2996,8 +3089,8 @@
applied to the shapes and <code title=dom-context-2d-strokeStyle><a href=#dom-context-2d-strokestyle>strokeStyle</a></code> must be
ignored. For <code title=dom-context-2d-strokeText><a href=#dom-context-2d-stroketext>strokeText()</a></code>, the reverse
holds: <code title=dom-context-2d-strokeStyle><a href=#dom-context-2d-strokestyle>strokeStyle</a></code>
- must be applied to the result of <a href=#trace-a-path title="trace a
- path">tracing</a> the shapes using the
+ must be applied to the result of <span title="trace a
+ path">tracing</span> the shapes using the
<code><a href=#canvasrenderingcontext2d>CanvasRenderingContext2D</a></code> object for the line styles,
and <code title=dom-context-2d-fillStyle><a href=#dom-context-2d-fillstyle>fillStyle</a></code> must
be ignored.</p>
@@ -3345,12 +3438,12 @@
once.</p>
<p>The <dfn id=dom-context-2d-stroke title=dom-context-2d-stroke><code>stroke()</code></dfn> method
- must <a href=#trace-a-path title="trace a path">trace</a> the intended path,
+ must <span title="trace a path">trace</span> the intended path,
using the <code><a href=#canvasrenderingcontext2d>CanvasRenderingContext2D</a></code> object for the line
styles, and then fill the combined stroke area using the <code title=dom-context-2d-strokeStyle><a href=#dom-context-2d-strokestyle>strokeStyle</a></code> attribute.</p>
- <p class=note>As a result of how the algorithm to <a href=#trace-a-path>trace a
- path</a> is defined, overlapping parts of the paths in one stroke
+ <p class=note>As a result of how the algorithm to <span>trace a
+ path</span> is defined, overlapping parts of the paths in one stroke
operation are treated as if their union was what was painted.</p>
<p class=note>The stroke <em>style</em> is affected by the
@@ -3768,14 +3861,14 @@
<li><p>A count of regions that have this one as their <a href="#hit-region's-parent" title="hit region's parent">parent</a>, known as the <dfn id="hit-region's-child-count">hit
region's child count</dfn>.</p></li>
-
- <li><p>A <dfn id="hit-region's-cursor-specification" title="hit region's cursor specification">cursor
+<!-- per Frank Oliver, issue 201 --> <!--
+ <li><p>A <dfn title="hit region's cursor specification">cursor
specification</dfn>, in the form of either a CSS cursor value, or
the string "<code title="">inherit</code>" meaning that the cursor
- of the <a href="#hit-region's-parent">hit region's parent</a>, if any, or of the
+ of the <span>hit region's parent</span>, if any, or of the
<code>canvas</code> element, if not, is to be used
instead.</p></li>
-
+-->
<li>
<p>Optionally, either a <a href="#hit-region's-control" title="hit region's
@@ -3832,15 +3925,16 @@
</dt><dd>The ID of the parent region, for purposes of navigation by
accessibility tools and for cursor fallback.</dd>
+<!-- per Frank Oliver, issue 201 --> <!--
+ <dt><code title="dom-HitRegionOptions-cursor">cursor</code> (default "<code title="">inherit</code>")
- <dt><code title=dom-HitRegionOptions-cursor>cursor</code> (default "<code title="">inherit</code>")
-
- </dt><dd>The cursor to use when the mouse is over this region. The
+ <dd>The cursor to use when the mouse is over this region. The
value "<code title="">inherit</code>" means to use the cursor for
- the parent region (as specified by the <code title=dom-HitRegionOptions-parentID>parentID</code> member), if
+ the parent region (as specified by the <code
+ title="dom-HitRegionOptions-parentID">parentID</code> member), if
any, or to use the <code>canvas</code> element's cursor if the
region has no parent.</dd>
-
+-->
<dt><code title=dom-HitRegionOptions-control>control</code> (default null)
</dt><dd>An element (that is a descendant of the <code>canvas</code>)
@@ -3871,10 +3965,11 @@
<li>With a label, they can make it easier for users to explore a
canvas without seeing it, e.g. by touch on a mobile device.</li>
+<!-- per Frank Oliver, issue 201 --> <!--
<li>With a cursor, they can make it easier for different regions
of the canvas to have different cursors, with the user agent
automatically switching between them.</li>
-
+-->
</ul></dd>
<dt><var title="">context</var> . <code title=dom-context-2d-removeHitRegion><a href=#dom-context-2d-removehitregion>removeHitRegion</a></code>(<var title="">options</var>)</dt>
@@ -3952,22 +4047,31 @@
<li><p>Otherwise, return <var title="">control</var>.</p></li>
- </ol><p><dfn id=the-cursor-for-a-hit-region>The cursor for a hit region</dfn> <var title="">region</var> of a <code>canvas</code> element <var title="">ancestor</var> is the value returned by the following
+ </ol><!-- per Frank Oliver, issue 201 --><!--
+ <p><dfn>The cursor for a hit region</dfn> <var
+ title="">region</var> of a <code>canvas</code> element <var
+ title="">ancestor</var> is the value returned by the following
algorithm:</p>
- <ol><li><p><i>Loop</i>: If <var title="">region</var> has a <a href="#hit-region's-cursor-specification" title="hit region's cursor specification">cursor
- specification</a> other than "<code title="">inherit</code>",
- then return that <a href="#hit-region's-cursor-specification">hit region's cursor specification</a>
+ <ol>
+
+ <li><p><i>Loop</i>: If <var title="">region</var> has a <span
+ title="hit region's cursor specification">cursor
+ specification</span> other than "<code title="">inherit</code>",
+ then return that <span>hit region's cursor specification</span>
and abort these steps.</p></li>
- <li><p>If <var title="">region</var> has a <a href="#hit-region's-parent" title="hit
- region's parent">parent</a>, then let <var title="">region</var> be that <a href="#hit-region's-parent">hit region's parent</a>,
+ <li><p>If <var title="">region</var> has a <span title="hit
+ region's parent">parent</span>, then let <var
+ title="">region</var> be that <span>hit region's parent</span>,
and return to the step labeled <i>loop</i>.</p></li>
<li><p>Otherwise, return the used value of the 'cursor' property
- for the <code>canvas</code> element. <a href=#refsCSSUI>[CSSUI]</a></p></li>
+ for the <code>canvas</code> element. <a
+ href="#refsCSSUI">[CSSUI]</a></p></li>
- </ol><p><dfn id=the-region-for-a-pixel>The region for a pixel</dfn> <var title="">pixel</var> on a
+ </ol>
+--><p><dfn id=the-region-for-a-pixel>The region for a pixel</dfn> <var title="">pixel</var> on a
<code>canvas</code> element <var title="">ancestor</var> is the
value returned by the following algorithm (which can return a
<a href=#hit-region>hit region</a> or nothing):</p>
@@ -4126,12 +4230,13 @@
<code>SyntaxError</code> exception and abort these
steps.</p>
- <ul class=brief><li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-cursor>cursor</code> member is not
+ <ul class=brief><!-- per Frank Oliver, issue 201 --><!--
+ <li>The <var title="">arguments</var> object's <code
+ title="dom-HitRegionOptions-cursor">cursor</code> member is not
null but is neither an <span>ASCII case-insensitive</span> match
for the string "<code title="">inherit</code>", nor a valid CSS
- 'cursor' property value. <a href=#refsCSSUI>[CSSUI]</a></li>
-
- <li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-role>role</code> member is not null
+ 'cursor' property value. <a href="#refsCSSUI">[CSSUI]</a></li>
+--><li>The <var title="">arguments</var> object's <code title=dom-HitRegionOptions-role>role</code> member is not null
but its value is not an <span>ordered set of unique
space-separated tokens</span> whose tokens are all
<span>case-sensitive</span> matches for names of non-abstract
@@ -4175,7 +4280,7 @@
</dt><dd><p>Initially zero.
- </p></dd><dt><a href="#hit-region's-cursor-specification">Hit region's cursor specification</a>
+ </p></dd><dt><span>Hit region's cursor specification</span>
</dt><dd><p>If <var title="">parent region</var> is not null: <var title="">parent region</var>. Otherwise, <var title="">region</var> has no <a href="#hit-region's-parent" title="hit region's
parent">parent</a>.
@@ -4207,21 +4312,23 @@
</p></dd></dl></li>
-
+<!-- per Frank Oliver, issue 201 --> <!--
<li>
- <p>If the <var title="">arguments</var> object's <code title=dom-HitRegionOptions-cursor>cursor</code> member is not
+ <p>If the <var title="">arguments</var> object's <code
+ title="dom-HitRegionOptions-cursor">cursor</code> member is not
null, then act as if a CSS rule for the <code>canvas</code>
element setting its 'cursor' property had been seen, whose value
- was the <a href="#hit-region's-cursor-specification">hit region's cursor specification</a>.</p>
+ was the <span>hit region's cursor specification</span>.</p>
- <p class=note>For example, if the user agent prefetches cursor
+ <p class="note">For example, if the user agent prefetches cursor
values, this would cause that to happen in response to an
- appropriately-formed <code title=dom-context-2d-addHitRegion><a href=#dom-context-2d-addhitregion>addHitRegion()</a></code>
+ appropriately-formed <code
+ title="dom-context-2d-addHitRegion">addHitRegion()</code>
call.</p>
</li>
-
+-->
<li><p>If the <var title="">arguments</var> object's <code title=dom-HitRegionOptions-control>control</code> member is not
null, then let <var title="">previous region for the control</var>
be <a href=#the-region-representing-the-control>the region representing the control</a> given by the
@@ -4375,14 +4482,16 @@
<li><p>Continue dispatching the event, but with the updated event
object and target as given in the above steps.</p></li>
- </ol><hr><p>When a user's pointing device cursor is positioned over a
+ </ol><hr><!-- per Frank Oliver, issue 201 --><!--
+ <p>When a user's pointing device cursor is positioned over a
<code>canvas</code> element, user agents should render the pointing
device cursor according to the cursor specification described by
- <a href=#the-cursor-for-a-hit-region title="the cursor for a hit region">the cursor for the hit
- region</a> that is <a href=#the-region-for-a-pixel title="the region for a pixel">the
- region for the pixel</a> that the pointing device designates.</p>
+ <span title="the cursor for a hit region">the cursor for the hit
+ region</span> that is <span title="the region for a pixel">the
+ region for the pixel</span> that the pointing device designates.</p>
- <hr><p>User agents are encouraged to make use of the information present
+ <hr>
+--><p>User agents are encouraged to make use of the information present
in a <code>canvas</code> element's <a href=#hit-region-list>hit region list</a> to
improve the accessibility of <code>canvas</code> elements.</p>
Received on Tuesday, 9 October 2012 03:13:41 UTC