[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