[Bf-python] CVS commit: blender/source/blender/python/api2_2x/doc Mathutils.py

[Michael Reimpell]

> the matrix class should indicate if the matrix are row or line major for
> the order of the multiplication.

There seem to be little consistency in Mathutils. Here are some examples:

TranslationMatrix(Vector([dx, dy, dz])) results in a matrix suitable for 
"left-multiplication" but RotationMatrix(90, 3, "z") results in a matrix 
suitable for normal matrix multiplication.
(remark: Object.getMatrix() returns a matrix suitable for 
"left-multiplication", although it's not mentioned in the API docs.)

Vector([x, y, z, w]) in contrast to Matrix( row0, row1, row2 , row3) and 
Quaternion([w, x, y, z])

Also there is some confusion about the use of homogenous coordinates, i.e. (x, 
y, z, w) = (a*x', a*y', a*z', a). With Mathutils, the value of a seems to be 
normalized to a=1, i.e. Vector.x is x', not a*x', but Vector.w has some 
(random?) value.

> that's not big points but they can save a lot of time (and hair) for
> script's writers.

Michael