[html5] r5279 - [e] (0) Try to reduce confusion over the transformation API's arguments
whatwg at whatwg.org
whatwg at whatwg.org
Wed Aug 11 11:25:08 PDT 2010
Author: ianh
Date: 2010-08-11 11:25:06 -0700 (Wed, 11 Aug 2010)
New Revision: 5279
Modified:
complete.html
index
source
Log:
[e] (0) Try to reduce confusion over the transformation API's arguments
Modified: complete.html
===================================================================
--- complete.html 2010-08-11 03:49:52 UTC (rev 5278)
+++ complete.html 2010-08-11 18:25:06 UTC (rev 5279)
@@ -29825,8 +29825,8 @@
void <a href=#dom-context-2d-scale title=dom-context-2d-scale>scale</a>(in float x, in float y);
void <a href=#dom-context-2d-rotate title=dom-context-2d-rotate>rotate</a>(in float angle);
void <a href=#dom-context-2d-translate title=dom-context-2d-translate>translate</a>(in float x, in float y);
- void <a href=#dom-context-2d-transform title=dom-context-2d-transform>transform</a>(in float m11, in float m12, in float m21, in float m22, in float dx, in float dy);
- void <a href=#dom-context-2d-settransform title=dom-context-2d-setTransform>setTransform</a>(in float m11, in float m12, in float m21, in float m22, in float dx, in float dy);
+ void <a href=#dom-context-2d-transform title=dom-context-2d-transform>transform</a>(in float a, in float b, in float c, in float d, in float e, in float f);
+ void <a href=#dom-context-2d-settransform title=dom-context-2d-setTransform>setTransform</a>(in float a, in float b, in float c, in float d, in float e, in float f);
<!--
// v5 we've also received requests for:
void skew(...);
@@ -30090,7 +30090,7 @@
</dd>
- <dt><var title="">context</var> . <code title=dom-context-2d-transform><a href=#dom-context-2d-transform>transform</a></code>(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>, <var title="">dy</var>)</dt>
+ <dt><var title="">context</var> . <code title=dom-context-2d-transform><a href=#dom-context-2d-transform>transform</a></code>(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, <var title="">f</var>)</dt>
<dd>
@@ -30098,7 +30098,7 @@
</dd>
- <dt><var title="">context</var> . <code title=dom-context-2d-setTransform><a href=#dom-context-2d-settransform>setTransform</a></code>(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>, <var title="">dy</var>)</dt>
+ <dt><var title="">context</var> . <code title=dom-context-2d-setTransform><a href=#dom-context-2d-settransform>setTransform</a></code>(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, <var title="">f</var>)</dt>
<dd>
@@ -30125,28 +30125,34 @@
the translation distance in the horizontal direction and the <var title="">y</var> argument represents the translation distance in the
vertical direction. The arguments are in coordinate space units.</p>
- <p>The <dfn id=dom-context-2d-transform title=dom-context-2d-transform><code>transform(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
- <var title="">dy</var>)</code></dfn> method must multiply the
+ <p>The <dfn id=dom-context-2d-transform title=dom-context-2d-transform><code>transform(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>,
+ <var title="">f</var>)</code></dfn> method must multiply the
current transformation matrix with the matrix described by:</p>
</div>
- <table class=matrix><tr><td><var title="">m11</var></td>
- <td><var title="">m21</var></td>
- <td><var title="">dx</var></td>
- <tr><td><var title="">m12</var></td>
- <td><var title="">m22</var></td>
- <td><var title="">dy</var></td>
+ <table class=matrix><tr><td><var title="">a</var></td>
+ <td><var title="">c</var></td>
+ <td><var title="">e</var></td>
+ <tr><td><var title="">b</var></td>
+ <td><var title="">d</var></td>
+ <td><var title="">f</var></td>
<tr><td>0</td>
<td>0</td>
<td>1</td>
- </table><div class=impl>
+ </table><p class=note>The arguments <var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, and <var title="">f</var> are sometimes called
+ <var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
+ and <var title="">dy</var> or <var title="">m11</var>, <var title="">m21</var>, <var title="">m12</var>, <var title="">m22</var>, <var title="">dx</var>, and <var title="">dy</var>. Care should be taken in particular with the order
+ of the second and third arguments (<var title="">b</var> and <var title="">c</var>) as their order varies from API to API and APIs
+ sometimes use the notation <var title="">m12</var>/<var title="">m21</var> and sometimes <var title="">m21</var>/<var title="">m12</var> for those positions.</p>
- <p>The <dfn id=dom-context-2d-settransform title=dom-context-2d-setTransform><code>setTransform(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
- <var title="">dy</var>)</code></dfn> method must reset the current
- transform to the identity matrix, and then invoke the <code><a href=#dom-context-2d-transform title=dom-context-2d-transform>transform</a>(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
- <var title="">dy</var>)</code> method with the same arguments.</p>
+ <div class=impl>
+ <p>The <dfn id=dom-context-2d-settransform title=dom-context-2d-setTransform><code>setTransform(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>,
+ <var title="">f</var>)</code></dfn> method must reset the current
+ transform to the identity matrix, and then invoke the <code><a href=#dom-context-2d-transform title=dom-context-2d-transform>transform</a>(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>,
+ <var title="">f</var>)</code> method with the same arguments.</p>
+
</div>
Modified: index
===================================================================
--- index 2010-08-11 03:49:52 UTC (rev 5278)
+++ index 2010-08-11 18:25:06 UTC (rev 5279)
@@ -29752,8 +29752,8 @@
void <a href=#dom-context-2d-scale title=dom-context-2d-scale>scale</a>(in float x, in float y);
void <a href=#dom-context-2d-rotate title=dom-context-2d-rotate>rotate</a>(in float angle);
void <a href=#dom-context-2d-translate title=dom-context-2d-translate>translate</a>(in float x, in float y);
- void <a href=#dom-context-2d-transform title=dom-context-2d-transform>transform</a>(in float m11, in float m12, in float m21, in float m22, in float dx, in float dy);
- void <a href=#dom-context-2d-settransform title=dom-context-2d-setTransform>setTransform</a>(in float m11, in float m12, in float m21, in float m22, in float dx, in float dy);
+ void <a href=#dom-context-2d-transform title=dom-context-2d-transform>transform</a>(in float a, in float b, in float c, in float d, in float e, in float f);
+ void <a href=#dom-context-2d-settransform title=dom-context-2d-setTransform>setTransform</a>(in float a, in float b, in float c, in float d, in float e, in float f);
<!--
// v5 we've also received requests for:
void skew(...);
@@ -30017,7 +30017,7 @@
</dd>
- <dt><var title="">context</var> . <code title=dom-context-2d-transform><a href=#dom-context-2d-transform>transform</a></code>(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>, <var title="">dy</var>)</dt>
+ <dt><var title="">context</var> . <code title=dom-context-2d-transform><a href=#dom-context-2d-transform>transform</a></code>(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, <var title="">f</var>)</dt>
<dd>
@@ -30025,7 +30025,7 @@
</dd>
- <dt><var title="">context</var> . <code title=dom-context-2d-setTransform><a href=#dom-context-2d-settransform>setTransform</a></code>(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>, <var title="">dy</var>)</dt>
+ <dt><var title="">context</var> . <code title=dom-context-2d-setTransform><a href=#dom-context-2d-settransform>setTransform</a></code>(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, <var title="">f</var>)</dt>
<dd>
@@ -30052,28 +30052,34 @@
the translation distance in the horizontal direction and the <var title="">y</var> argument represents the translation distance in the
vertical direction. The arguments are in coordinate space units.</p>
- <p>The <dfn id=dom-context-2d-transform title=dom-context-2d-transform><code>transform(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
- <var title="">dy</var>)</code></dfn> method must multiply the
+ <p>The <dfn id=dom-context-2d-transform title=dom-context-2d-transform><code>transform(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>,
+ <var title="">f</var>)</code></dfn> method must multiply the
current transformation matrix with the matrix described by:</p>
</div>
- <table class=matrix><tr><td><var title="">m11</var></td>
- <td><var title="">m21</var></td>
- <td><var title="">dx</var></td>
- <tr><td><var title="">m12</var></td>
- <td><var title="">m22</var></td>
- <td><var title="">dy</var></td>
+ <table class=matrix><tr><td><var title="">a</var></td>
+ <td><var title="">c</var></td>
+ <td><var title="">e</var></td>
+ <tr><td><var title="">b</var></td>
+ <td><var title="">d</var></td>
+ <td><var title="">f</var></td>
<tr><td>0</td>
<td>0</td>
<td>1</td>
- </table><div class=impl>
+ </table><p class=note>The arguments <var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, and <var title="">f</var> are sometimes called
+ <var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
+ and <var title="">dy</var> or <var title="">m11</var>, <var title="">m21</var>, <var title="">m12</var>, <var title="">m22</var>, <var title="">dx</var>, and <var title="">dy</var>. Care should be taken in particular with the order
+ of the second and third arguments (<var title="">b</var> and <var title="">c</var>) as their order varies from API to API and APIs
+ sometimes use the notation <var title="">m12</var>/<var title="">m21</var> and sometimes <var title="">m21</var>/<var title="">m12</var> for those positions.</p>
- <p>The <dfn id=dom-context-2d-settransform title=dom-context-2d-setTransform><code>setTransform(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
- <var title="">dy</var>)</code></dfn> method must reset the current
- transform to the identity matrix, and then invoke the <code><a href=#dom-context-2d-transform title=dom-context-2d-transform>transform</a>(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
- <var title="">dy</var>)</code> method with the same arguments.</p>
+ <div class=impl>
+ <p>The <dfn id=dom-context-2d-settransform title=dom-context-2d-setTransform><code>setTransform(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>,
+ <var title="">f</var>)</code></dfn> method must reset the current
+ transform to the identity matrix, and then invoke the <code><a href=#dom-context-2d-transform title=dom-context-2d-transform>transform</a>(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>,
+ <var title="">f</var>)</code> method with the same arguments.</p>
+
</div>
Modified: source
===================================================================
--- source 2010-08-11 03:49:52 UTC (rev 5278)
+++ source 2010-08-11 18:25:06 UTC (rev 5279)
@@ -32636,8 +32636,8 @@
void <span title="dom-context-2d-scale">scale</span>(in float x, in float y);
void <span title="dom-context-2d-rotate">rotate</span>(in float angle);
void <span title="dom-context-2d-translate">translate</span>(in float x, in float y);
- void <span title="dom-context-2d-transform">transform</span>(in float m11, in float m12, in float m21, in float m22, in float dx, in float dy);
- void <span title="dom-context-2d-setTransform">setTransform</span>(in float m11, in float m12, in float m21, in float m22, in float dx, in float dy);
+ void <span title="dom-context-2d-transform">transform</span>(in float a, in float b, in float c, in float d, in float e, in float f);
+ void <span title="dom-context-2d-setTransform">setTransform</span>(in float a, in float b, in float c, in float d, in float e, in float f);
<!--
// v5 we've also received requests for:
void skew(...);
@@ -32933,7 +32933,7 @@
</dd>
- <dt><var title="">context</var> . <code title="dom-context-2d-transform">transform</code>(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>, <var title="">dy</var>)</dt>
+ <dt><var title="">context</var> . <code title="dom-context-2d-transform">transform</code>(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, <var title="">f</var>)</dt>
<dd>
@@ -32941,7 +32941,7 @@
</dd>
- <dt><var title="">context</var> . <code title="dom-context-2d-setTransform">setTransform</code>(<var title="">m11</var>, <var title="">m12</var>, <var title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>, <var title="">dy</var>)</dt>
+ <dt><var title="">context</var> . <code title="dom-context-2d-setTransform">setTransform</code>(<var title="">a</var>, <var title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var title="">e</var>, <var title="">f</var>)</dt>
<dd>
@@ -32976,23 +32976,23 @@
vertical direction. The arguments are in coordinate space units.</p>
<p>The <dfn title="dom-context-2d-transform"><code>transform(<var
- title="">m11</var>, <var title="">m12</var>, <var
- title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
- <var title="">dy</var>)</code></dfn> method must multiply the
+ title="">a</var>, <var title="">b</var>, <var
+ title="">c</var>, <var title="">d</var>, <var title="">e</var>,
+ <var title="">f</var>)</code></dfn> method must multiply the
current transformation matrix with the matrix described by:</p>
</div>
<table class="matrix">
<tr>
- <td><var title="">m11</var></td>
- <td><var title="">m21</var></td>
- <td><var title="">dx</var></td>
+ <td><var title="">a</var></td>
+ <td><var title="">c</var></td>
+ <td><var title="">e</var></td>
</tr>
<tr>
- <td><var title="">m12</var></td>
- <td><var title="">m22</var></td>
- <td><var title="">dy</var></td>
+ <td><var title="">b</var></td>
+ <td><var title="">d</var></td>
+ <td><var title="">f</var></td>
</tr>
<tr>
<td>0</td>
@@ -33001,18 +33001,33 @@
</tr>
</table>
+ <p class="note">The arguments <var title="">a</var>, <var
+ title="">b</var>, <var title="">c</var>, <var title="">d</var>, <var
+ title="">e</var>, and <var title="">f</var> are sometimes called
+ <var title="">m11</var>, <var title="">m12</var>, <var
+ title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
+ and <var title="">dy</var> or <var title="">m11</var>, <var
+ title="">m21</var>, <var title="">m12</var>, <var
+ title="">m22</var>, <var title="">dx</var>, and <var
+ title="">dy</var>. Care should be taken in particular with the order
+ of the second and third arguments (<var title="">b</var> and <var
+ title="">c</var>) as their order varies from API to API and APIs
+ sometimes use the notation <var title="">m12</var>/<var
+ title="">m21</var> and sometimes <var title="">m21</var>/<var
+ title="">m12</var> for those positions.</p>
+
<div class="impl">
<p>The <dfn
title="dom-context-2d-setTransform"><code>setTransform(<var
- title="">m11</var>, <var title="">m12</var>, <var
- title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
- <var title="">dy</var>)</code></dfn> method must reset the current
+ title="">a</var>, <var title="">b</var>, <var
+ title="">c</var>, <var title="">d</var>, <var title="">e</var>,
+ <var title="">f</var>)</code></dfn> method must reset the current
transform to the identity matrix, and then invoke the <code><span
title="dom-context-2d-transform">transform</span>(<var
- title="">m11</var>, <var title="">m12</var>, <var
- title="">m21</var>, <var title="">m22</var>, <var title="">dx</var>,
- <var title="">dy</var>)</code> method with the same arguments.</p>
+ title="">a</var>, <var title="">b</var>, <var
+ title="">c</var>, <var title="">d</var>, <var title="">e</var>,
+ <var title="">f</var>)</code> method with the same arguments.</p>
</div>
More information about the Commit-Watchers
mailing list