diff --git a/docs/api/math/Euler.html b/docs/api/math/Euler.html
index 27d8118d1d3d06f010ebdc9be0cfd82a247c42c9..cd48e70b4593fcd0f26a794adf744155d536646d 100644
--- a/docs/api/math/Euler.html
+++ b/docs/api/math/Euler.html
@@ -10,11 +10,12 @@
[name]
- A class representing [link:http://en.wikipedia.org/wiki/Euler_angles Euler Angles].
+
+ A class representing [link:http://en.wikipedia.org/wiki/Euler_angles Euler Angles].
- Euler angles describe a rotational transformation by rotating an object on its various
- axes in specified amounts per axis, and a specified axis order.
-
+ Euler angles describe a rotational transformation by rotating an object on its various
+ axes in specified amounts per axis, and a specified axis order.
+
Example
@@ -51,9 +52,23 @@
The order in which to apply rotations. Default is 'XYZ', which means that the object will first be
rotated around its X axis, then its Y axis and finally its Z axis. Other possibilities are:
- 'YZX', 'ZXY', 'XZY', 'YXZ' and 'ZYX'. Note that these must be in upper case.
+ 'YZX', 'ZXY', 'XZY', 'YXZ' and 'ZYX'. These must be in upper case.
- If this is changed, [page:.onChangeCallback onChangeCallback] will be called.
+ Three.js uses intrinsic (Tait-Bryan) ordering, also known as yaw, pitch
+ and roll. This means that rotations are performed with respect to the local
+ coordinate system. That is, for order 'XYZ', the rotation is first around world-X, then around
+ local-Y (which may now be different from the world Y-axis), then local-Z (which may be different
+ from the world Z-axis).
+
+ Some implementations may use extrinsic (proper) ordering, in which case rotations are performed
+ with respect to the world coordinate system, so that for order 'XYZ', the rotations
+ are around world-X, world-Y, and world-Z.
+
+ Converting between the two types is relatively straightforward, you just need to reverse the order
+ and the rotation, so that an intrinsic (three.js) Euler rotation of angles a, b, c about XYZ
+ will be equivalent to to an extrinsic Euler rotation of angles c, b, a about ZYX.
+
+ If the order is changed, [page:.onChangeCallback onChangeCallback] will be called.
[property:Float x]