phaser
Version:
A fast, free and fun HTML5 Game Framework for Desktop and Mobile web browsers from the team at Phaser Studio Inc.
84 lines (74 loc) • 2 kB
JavaScript
/**
* @author Richard Davey <rich@phaser.io>
* @copyright 2013-2025 Phaser Studio Inc.
* @license {@link https://opensource.org/licenses/MIT|MIT License}
*/
var RotateLeft = require('../RotateLeft');
var RotateRight = require('../RotateRight');
/**
* Translates the given Array Matrix by shifting each column and row the
* amount specified.
*
* A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)
* have the same length. There must be at least two rows. This is an example matrix:
*
* ```
* [
* [ 1, 1, 1, 1, 1, 1 ],
* [ 2, 0, 0, 0, 0, 4 ],
* [ 2, 0, 1, 2, 0, 4 ],
* [ 2, 0, 3, 4, 0, 4 ],
* [ 2, 0, 0, 0, 0, 4 ],
* [ 3, 3, 3, 3, 3, 3 ]
* ]
* ```
*
* @function Phaser.Utils.Array.Matrix.Translate
* @since 3.50.0
*
* @generic T
* @genericUse {T[][]} - [matrix,$return]
*
* @param {T[][]} [matrix] - The array matrix to translate.
* @param {number} [x=0] - The amount to horizontally translate the matrix by.
* @param {number} [y=0] - The amount to vertically translate the matrix by.
*
* @return {T[][]} The translated matrix.
*/
var TranslateMatrix = function (matrix, x, y)
{
if (x === undefined) { x = 0; }
if (y === undefined) { y = 0; }
// Vertical translation
if (y !== 0)
{
if (y < 0)
{
// Shift Up
RotateLeft(matrix, Math.abs(y));
}
else
{
// Shift Down
RotateRight(matrix, y);
}
}
// Horizontal translation
if (x !== 0)
{
for (var i = 0; i < matrix.length; i++)
{
var row = matrix[i];
if (x < 0)
{
RotateLeft(row, Math.abs(x));
}
else
{
RotateRight(row, x);
}
}
}
return matrix;
};
module.exports = TranslateMatrix;