[html5] r1195 - /
whatwg at whatwg.org
whatwg at whatwg.org
Sat Feb 2 12:56:13 PST 2008
Author: ianh
Date: 2008-02-02 12:56:07 -0800 (Sat, 02 Feb 2008)
New Revision: 1195
Modified:
index
source
Log:
[e] (1) canvas editorial edits -- inf -> infin, infinite line -> half infinite line
Modified: index
===================================================================
--- index 2008-02-02 00:29:30 UTC (rev 1194)
+++ index 2008-02-02 20:56:07 UTC (rev 1195)
@@ -16670,10 +16670,12 @@
<p>The <dfn id=createlineargradient
title=dom-context-2d-createLinearGradient><code>createLinearGradient(<var
title="">x0</var>, <var title="">y0</var>, <var title="">x1</var>, <var
- title="">y1</var>)</code></dfn> method takes four arguments, representing
- the start point (<var title="">x0</var>, <var title="">y0</var>) and end
- point (<var title="">x1</var>, <var title="">y1</var>) of the gradient, in
- coordinate space units. If any of the arguments to <code
+ title="">y1</var>)</code></dfn> method takes four arguments that, after
+ being subjected to the <a href="#transformations0"
+ title=dom-context-2d-transformation>current transformation matrix</a>,
+ represent the start point (<var title="">x0</var>, <var title="">y0</var>)
+ and end point (<var title="">x1</var>, <var title="">y1</var>) of the
+ gradient. If any of the arguments to <code
title=dom-context-2d-createLinearGradient><a
href="#createlineargradient">createLinearGradient()</a></code> are
infinite or NaN, the method must raise an <code>INDEX_SIZE_ERR</code>
@@ -16710,7 +16712,9 @@
NaN, an <code>INDEX_SIZE_ERR</code> exception must be raised. Otherwise,
the method must return a radial <code><a
href="#canvasgradient0">CanvasGradient</a></code> initialised with the two
- specified circles.
+ specified circles, after transforming them according to the <a
+ href="#transformations0" title=dom-context-2d-transformation>current
+ transformation matrix</a>.
<p>Radial gradients must be rendered by following these steps:
@@ -17161,11 +17165,10 @@
<p>Initially, the context's path must have zero subpaths.
- <p>The coordinates given in the arguments to these methods must be
+ <p>The points and lines added to the path by these methods must be
transformed according to the <a href="#transformations0"
- title=dom-context-2d-transformation>current transformation matrix</a>
- before applying the calculations described below and before adding any
- points to the path.
+ title=dom-context-2d-transformation>current transformation matrix</a> as
+ they are added.
<p>The <dfn id=beginpath
title=dom-context-2d-beginPath><code>beginPath()</code></dfn> method must
@@ -17258,27 +17261,27 @@
title="">y0</var>) to (<var title="">x1</var>, <var title="">y1</var>) is
the opposite of the direction from (<var title="">x1</var>, <var
title="">y1</var>) to (<var title="">x2</var>, <var title="">y2</var>),
- and the method must add a point (<var title="">x<sub>&inf;</sub></var>,
- <var title="">y<sub>&inf;</sub></var>) to the subpath, and connect that
+ and the method must add a point (<var title="">x<sub>∞</sub></var>,
+ <var title="">y<sub>∞</sub></var>) to the subpath, and connect that
point to the previous point (<var title="">x0</var>, <var
title="">y0</var>) by a straight line, where (<var
- title="">x<sub>&inf;</sub></var>, <var title="">y<sub>&inf;</sub></var>)
- is the point that is infinitely far away from (<var title="">x1</var>,
- <var title="">y1</var>), that lies on the same line as (<var
- title="">x0</var>, <var title="">y0</var>), (<var title="">x1</var>, <var
- title="">y1</var>), and (<var title="">x2</var>, <var title="">y2</var>),
- and that is on the same side of (<var title="">x1</var>, <var
- title="">y1</var>) on that line as (<var title="">x2</var>, <var
- title="">y2</var>).
+ title="">x<sub>∞</sub></var>, <var
+ title="">y<sub>∞</sub></var>) is the point that is infinitely far
+ away from (<var title="">x1</var>, <var title="">y1</var>), that lies on
+ the same line as (<var title="">x0</var>, <var title="">y0</var>), (<var
+ title="">x1</var>, <var title="">y1</var>), and (<var title="">x2</var>,
+ <var title="">y2</var>), and that is on the same side of (<var
+ title="">x1</var>, <var title="">y1</var>) on that line as (<var
+ title="">x2</var>, <var title="">y2</var>).
<p>Otherwise, let <var title="">The Arc</var> be the shortest arc given by
circumference of the circle that has radius <var title="">radius</var>,
- and that has one point tangent to the infinite line that crosses the point
- (<var title="">x0</var>, <var title="">y0</var>) and ends at the point
- (<var title="">x1</var>, <var title="">y1</var>), and that has a different
- point tangent to the infinite line that ends at the point (<var
- title="">x1</var>, <var title="">y1</var>) and crosses the point (<var
- title="">x2</var>, <var title="">y2</var>). The points at which this
+ and that has one point tangent to the half-infinite line that crosses the
+ point (<var title="">x0</var>, <var title="">y0</var>) and ends at the
+ point (<var title="">x1</var>, <var title="">y1</var>), and that has a
+ different point tangent to the half-infinite line that ends at the point
+ (<var title="">x1</var>, <var title="">y1</var>) and crosses the point
+ (<var title="">x2</var>, <var title="">y2</var>). The points at which this
circle touches these two lines are called the start and end tangent points
respectively.
@@ -17354,13 +17357,16 @@
what was painted.
<p>Paths, when filled or stroked, must be painted without affecting the
- current path, and must be subject to <span>transformations</span>, <a
- href="#shadows0" title=shadows>shadow effects</a>, <a href="#globalalpha"
+ current path, and must be subject to <a href="#shadows0"
+ title=shadows>shadow effects</a>, <a href="#globalalpha"
title=dom-context-2d-globalAlpha>global alpha</a>, the <a href="#clipping"
title="clipping region">clipping region</a>, and <a
href="#globalcompositeoperation"
title=dom-context-2d-globalCompositeOperation>global composition
- operators</a>.
+ operators</a>. (Transformations affect the path when the path is created,
+ not when it is painted, though the stroke <em><a
+ href="#style">style</a></em> is still affected by the transformation
+ during painting.)
<p>Zero-length line segments must be pruned before stroking a path. Empty
subpaths must be ignored.
Modified: source
===================================================================
--- source 2008-02-02 00:29:30 UTC (rev 1194)
+++ source 2008-02-02 20:56:07 UTC (rev 1195)
@@ -14214,11 +14214,12 @@
<p>The <dfn
title="dom-context-2d-createLinearGradient"><code>createLinearGradient(<var
title="">x0</var>, <var title="">y0</var>, <var title="">x1</var>,
- <var title="">y1</var>)</code></dfn> method takes four arguments,
- representing the start point (<var title="">x0</var>, <var
- title="">y0</var>) and end point (<var title="">x1</var>, <var
- title="">y1</var>) of the gradient, in coordinate space units. If
- any of the arguments to <code
+ <var title="">y1</var>)</code></dfn> method takes four arguments
+ that, after being subjected to the <span
+ title="dom-context-2d-transformation">current transformation
+ matrix</span>, represent the start point (<var title="">x0</var>,
+ <var title="">y0</var>) and end point (<var title="">x1</var>, <var
+ title="">y1</var>) of the gradient. If any of the arguments to <code
title="dom-context-2d-createLinearGradient">createLinearGradient()</code>
are infinite or NaN, the method must raise an
<code>INDEX_SIZE_ERR</code> exception. Otherwise, the method must
@@ -14254,7 +14255,9 @@
are negative, or if any of the arguments are infinite or NaN, an
<code>INDEX_SIZE_ERR</code> exception must be raised. Otherwise, the
method must return a radial <code>CanvasGradient</code> initialised
- with the two specified circles.</p>
+ with the two specified circles, after transforming them according to
+ the <span title="dom-context-2d-transformation">current
+ transformation matrix</span>.</p>
<p>Radial gradients must be rendered by following these steps:</p>
@@ -14723,11 +14726,10 @@
<p>Initially, the context's path must have zero subpaths.</p>
- <p>The coordinates given in the arguments to these methods must be
+ <p>The points and lines added to the path by these methods must be
transformed according to the <span
title="dom-context-2d-transformation">current transformation
- matrix</span> before applying the calculations described below and
- before adding any points to the path.</p>
+ matrix</span> as they are added.</p>
<p>The <dfn
@@ -14836,12 +14838,12 @@
title="">y1</var>) is the opposite of the direction from (<var
title="">x1</var>, <var title="">y1</var>) to (<var
title="">x2</var>, <var title="">y2</var>), and the method must add
- a point (<var title="">x<sub>&inf;</sub></var>, <var
- title="">y<sub>&inf;</sub></var>) to the subpath, and connect that
+ a point (<var title="">x<sub>∞</sub></var>, <var
+ title="">y<sub>∞</sub></var>) to the subpath, and connect that
point to the previous point (<var title="">x0</var>, <var
title="">y0</var>) by a straight line, where (<var
- title="">x<sub>&inf;</sub></var>, <var
- title="">y<sub>&inf;</sub></var>) is the point that is infinitely
+ title="">x<sub>∞</sub></var>, <var
+ title="">y<sub>∞</sub></var>) is the point that is infinitely
far away from (<var title="">x1</var>, <var title="">y1</var>), that
lies on the same line as (<var title="">x0</var>, <var
title="">y0</var>), (<var title="">x1</var>, <var
@@ -14853,14 +14855,14 @@
<p>Otherwise, let <var title="">The Arc</var> be the shortest arc
given by circumference of the circle that has radius <var
title="">radius</var>, and that has one point tangent to the
- infinite line that crosses the point (<var title="">x0</var>, <var
- title="">y0</var>) and ends at the point (<var title="">x1</var>,
- <var title="">y1</var>), and that has a different point tangent to
- the infinite line that ends at the point (<var title="">x1</var>,
- <var title="">y1</var>) and crosses the point (<var
- title="">x2</var>, <var title="">y2</var>). The points at which this
- circle touches these two lines are called the start and end tangent
- points respectively.</p>
+ half-infinite line that crosses the point (<var title="">x0</var>,
+ <var title="">y0</var>) and ends at the point (<var
+ title="">x1</var>, <var title="">y1</var>), and that has a different
+ point tangent to the half-infinite line that ends at the point (<var
+ title="">x1</var>, <var title="">y1</var>) and crosses the point
+ (<var title="">x2</var>, <var title="">y2</var>). The points at
+ which this circle touches these two lines are called the start and
+ end tangent points respectively.</p>
<p>The method must connect the point (<var title="">x0</var>, <var
title="">y0</var>) to the start tangent point by a straight line,
@@ -14941,13 +14943,14 @@
as if their union was what was painted.</p>
<p>Paths, when filled or stroked, must be painted without affecting
- the current path, and must be subject to
- <span>transformations</span>, <span title="shadows">shadow
- effects</span>, <span title="dom-context-2d-globalAlpha">global
- alpha</span>, the <span title="clipping region">clipping
- region</span>, and <span
+ the current path, and must be subject to <span
+ title="shadows">shadow effects</span>, <span
+ title="dom-context-2d-globalAlpha">global alpha</span>, the <span
+ title="clipping region">clipping region</span>, and <span
title="dom-context-2d-globalCompositeOperation">global composition
- operators</span>.</p>
+ operators</span>. (Transformations affect the path when the path is
+ created, not when it is painted, though the stroke <em>style</em> is
+ still affected by the transformation during painting.)</p>
<p>Zero-length line segments must be pruned before stroking a
path. Empty subpaths must be ignored.</p>
More information about the Commit-Watchers
mailing list