WebKitCSSMatrix compat: change rotate()/rotateSelf()

Change the arguments from (angle, originX, originY) to (rotX, rotY,
rotZ), all optional.

Part of whatwg/compat#19

Author: zcorpan

geometry/Overview.bs

@@ -454,9 +454,9 @@ interface DOMMatrixReadOnly {
                               optional unrestricted double originX = 0,
                               optional unrestricted double originY = 0,
                               optional unrestricted double originZ = 0);
-    DOMMatrix rotate(unrestricted double angle,
-                     optional unrestricted double originX = 0,
-                     optional unrestricted double originY = 0);
+    DOMMatrix rotate(optional unrestricted double rotX = 0,
+                     optional unrestricted double rotY,
+                     optional unrestricted double rotZ);
     DOMMatrix rotateFromVector(unrestricted double x,
                                unrestricted double y);
     DOMMatrix rotateAxisAngle(unrestricted double x,
@@ -529,9 +529,9 @@ interface DOMMatrix : DOMMatrixReadOnly {
                            optional unrestricted double originX = 0,
                            optional unrestricted double originY = 0,
                            optional unrestricted double originZ = 0);
-    DOMMatrix rotateSelf(unrestricted double angle,
-                  optional unrestricted double originX = 0,
-                  optional unrestricted double originY = 0);
+    DOMMatrix rotateSelf(optional unrestricted double rotX = 0,
+                         optional unrestricted double rotY,
+                         optional unrestricted double rotZ);
     DOMMatrix rotateFromVectorSelf(unrestricted double x,
                             unrestricted double y);
     DOMMatrix rotateAxisAngleSelf(unrestricted double x,
@@ -846,11 +846,11 @@ The following methods do not modify the current matrix and return a new <a inter
     </ol>
     <p>The current matrix is not modified.</p>
   </dd>
-  <dt><dfn>rotate(<var>angle</var>, <var>originX</var>, <var>originY</var>)</dfn></dt>
+  <dt><dfn>rotate(<var>rotX</var>, <var>rotY</var>, <var>rotZ</var>)</dfn></dt>
   <dd>
     <ol>
       <li>Let <em>result</em> be the resulting matrix initialized to the values of the current matrix.</li>
-      <li>Perform a <a method>rotateSelf()</a> transformation on <em>result</em> with the arguments <var>angle</var>, <var>originX</var>, <var>originY</var>.</li>
+      <li>Perform a <a method>rotateSelf()</a> transformation on <em>result</em> with the arguments <var>rotX</var>, <var>rotY</var>, <var>rotZ</var>.</li>
       <li>Return <em>result</em>.</li>
     </ol>
     <p>The current matrix is not modified.</p>
@@ -1053,12 +1053,23 @@ Note: Authors who use chained method calls are recommended to use mutable transf
       <li>Return the current matrix.</li>
     </ol>
   </dd>
-  <dt><dfn>rotateSelf(<var>angle</var>, <var>originX</var>, <var>originY</var>)</dfn></dt>
+  <dt><dfn>rotateSelf(<var>rotX</var>, <var>rotY</var>, <var>rotZ</var>)</dfn></dt>
   <dd>
     <ol>
-      <li>Apply a <a method>translateSelf(<var>originX</var>, <var>originY</var>)</a> transformation to the current matrix.</li>
-      <li>Post-multiply a rotation transformation on the current matrix with the specified rotation <em>angle</em> in degrees. The 2D rotation matrix is <a href="http://www.w3.org/TR/2012/WD-css3-transforms-20120911/#RotateDefined">described</a> in CSS Transforms with <em>alpha</em> = <em>angle</em> in degrees. [[!CSS3-TRANSFORMS]].</li>
-      <li>Apply a <a method>translateSelf(-<var>originX</var>, -<var>originY</var>)</a> transformation to the current matrix.</li>
+      <li>If <var>rotY</var> and <var>rotZ</var> are both missing, set <var>rotZ</var> to the value
+      of <var>rotX</var> and set <var>rotX</var> and <var>rotY</var> to zero.</li>
+
+      <li>If <var>rotY</var> is still missing, set <var>rotY</var> to zero.</li>
+
+      <li>If <var>rotZ</var> is still missing, set <var>rotZ</var> to zero.</li>
+
+      <li>If <var>rotX</var> or <var>rotY</var> are non-zero, set <a>is2D</a> of the current matrix
+      to <code>false</code>.</li>
+
+      <li>Post-multiply the current matrix by each of its 3 rotation matrices about the major axes,
+      first Z using <var>rotZ</var>, then Y using <var>rotY</var>, then X using
+      <var>rotX</var>.</li>
+
       <li>Return the current matrix.</li>
     </ol>
   </dd>