- From: Sam Ruby via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 10 Oct 2012 15:13:40 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/2dcontext
In directory hutz:/tmp/cvs-serv25145
Modified Files:
Overview.html
Log Message:
commit 416e1052b72fac535f12e08635c16d9da81b6328
Author: Robin Berjon <robin@berjon.com>
Date: Wed Oct 10 17:04:02 2012 +0200
remove nested comment
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/2dcontext/Overview.html,v
retrieving revision 1.179
retrieving revision 1.180
diff -u -d -r1.179 -r1.180
--- Overview.html 9 Oct 2012 03:13:35 -0000 1.179
+++ Overview.html 10 Oct 2012 15:13:38 -0000 1.180
@@ -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 9 October 2012</h2>
+ <h2 class="no-num no-toc" id="editor's-draft-date-1-january-1970">Editor's Draft 10 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 9 October 2012 Editor's Draft.
+ This specification is the 10 October 2012 Editor's Draft.
</p>
@@ -1083,23 +1083,19 @@
attribute must initially have the value <code>0.0</code>.</p>
<hr>
-
- <p>When a user agent is to <dfn>trace a <span>path</span></dfn>,
+ --><p>When a user agent is to <dfn id=trace-a-path>trace a <span>path</span></dfn>,
given an object <var title="">style</var> that implements the
- <code>CanvasDrawingStyles</code> interface, it must run the following
- algorithm. This algorithm returns a new <span>path</span>.</p>
-
- <ol>
+ <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>
- <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
@@ -1109,8 +1105,7 @@
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
@@ -1266,7 +1261,8 @@
0.</p></li>
<li><p>Return to the step labeled <i>dash on</i>.</p></li>
---><!-- per Frank Oliver, issue 201 --><li><p><i>Joins</i>: Remove from <var title="">path</var> any
+--> <!-- per Frank Oliver, issue 201 -->
+ </li><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>
@@ -1397,12 +1393,8 @@
<li><p>Return the newly created path.</p></li>
-
-
-<!--v6: Another request has been for hairline width lines, that remain
-hairline width with transform. ack Shaun Morris. -->
-
- </div>
+ </ol><!--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>
@@ -2371,16 +2363,22 @@
<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><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>
+ value.)</p>
- </li><li><p>Let <var title="">θ</var> be the clockwise angle
+ <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><p>Let <var title="">θ</var> be the clockwise angle
from the positive x-axis to the side of the line that is
- tangential to <var title="">path</var> at the point <var title="">p</var> that is going in the same direction as the line
+ tangential to <var title="">path</var> at the point <var
+ title="">p</var> that is going in the same direction as the line
at point <var title="">p</var>.</p></li>
<li><p>Rotate the shape described by <var title="">glyph</var>
- clockwise by <var title="">θ</var> about the point that is
+ clockwise by <var title="">θ</var> about the point that is
at the <var title="">dx</var> coordinate horizontally and the
zero coordinate vertically.</p></li>
@@ -2388,23 +2386,31 @@
coordinate of the point <var title="">p</var>.</p></li>
<li><p>Move the shape described by <var title="">glyph</var> to
- the right by <var title="">x</var> and down by <var title="">y</var>.</p></li>
+ the right by <var title="">x</var> and down by <var
+ title="">y</var>.</p></li>
<li><p>Let <var title="">glyph subpaths</var> be a list of
subpaths describing the shape given in <var title="">glyph</var>,
- with each CSS pixel in the coordinate space of <var title="">glyph</var> mapped to one coordinate space unit in <var title="">glyph subpaths</var>. Subpaths in <var title="">glyph
+ with each CSS pixel in the coordinate space of <var
+ title="">glyph</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 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>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
+ <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
+ <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>. (This
coordinate is only used if this is the last glyph
processed.)</p></li>
@@ -2412,17 +2418,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
+ <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>
-
---><!-- per Frank Oliver, issue 201 -->
- </div>
+ </ol>
+--><!-- per Frank Oliver, issue 201 --></div>
@@ -3004,13 +3010,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 <span title="trace a path">tracing the path</span> 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 <a href=#trace-a-path title="trace a path">tracing the path</a> 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 <span>trace a path</span> algorithm
+ method thus has no effect (the <a href=#trace-a-path>trace a path</a> 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
@@ -3089,8 +3095,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 <span title="trace a
- path">tracing</span> the shapes using the
+ must be applied to the result of <a href=#trace-a-path title="trace a
+ path">tracing</a> 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>
@@ -3438,12 +3444,12 @@
once.</p>
<p>The <dfn id=dom-context-2d-stroke title=dom-context-2d-stroke><code>stroke()</code></dfn> method
- must <span title="trace a path">trace</span> the intended path,
+ must <a href=#trace-a-path title="trace a path">trace</a> 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 <span>trace a
- path</span> is defined, overlapping parts of the paths in one stroke
+ <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
operation are treated as if their union was what was painted.</p>
<p class=note>The stroke <em>style</em> is affected by the
Received on Wednesday, 10 October 2012 15:13:46 UTC