Improve / streamline Matrix documentation a bit.

This commit is contained in:
Jürg Lehni 2014-10-20 16:47:41 +02:00
parent 616e848376
commit 62e5f3b3ac

View file

@ -344,7 +344,7 @@ var Matrix = Base.extend(/** @lends Matrix# */{
}, },
/** /**
* Concatenates an affine transform to this transform. * Concatenates the given affine transform to this transform.
* *
* @param {Matrix} mx the transform to concatenate * @param {Matrix} mx the transform to concatenate
* @return {Matrix} this affine transform * @return {Matrix} this affine transform
@ -371,7 +371,7 @@ var Matrix = Base.extend(/** @lends Matrix# */{
}, },
/** /**
* Pre-concatenates an affine transform to this transform. * Pre-concatenates the given affine transform to this transform.
* *
* @param {Matrix} mx the transform to preconcatenate * @param {Matrix} mx the transform to preconcatenate
* @return {Matrix} this affine transform * @return {Matrix} this affine transform
@ -399,6 +399,13 @@ var Matrix = Base.extend(/** @lends Matrix# */{
return this; return this;
}, },
/**
* Returns a new instance of the result of the concatenation of the given
* affine transform with this transform.
*
* @param {Matrix} mx the transform to concatenate
* @return {Matrix} the newly created affine transform
*/
chain: function(mx) { chain: function(mx) {
var a1 = this._a, var a1 = this._a,
b1 = this._b, b1 = this._b,
@ -717,9 +724,9 @@ var Matrix = Base.extend(/** @lends Matrix# */{
}, },
/** /**
* Inverts the transformation of the matrix. If the matrix is not invertible * Creates the inversion of the transformation of the matrix and returns it
* (in which case {@link #isSingular()} returns true), {@code null } is * as a new insteance. If the matrix is not invertible (in which case
* returned. * {@link #isSingular()} returns true), {@code null } is returned.
* *
* @return {Matrix} the inverted matrix, or {@code null }, if the matrix is * @return {Matrix} the inverted matrix, or {@code null }, if the matrix is
* singular * singular