Current File : /home/vacivi36/intranet.vacivitta.com.br/protected/vendor/imagine/imagine/src/Utils/Matrix.php
<?php
/*
* This file is part of the Imagine package.
*
* (c) Bulat Shakirzyanov <mallluhuct@gmail.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Imagine\Utils;
use Imagine\Exception\InvalidArgumentException;
use Imagine\Exception\OutOfBoundsException;
class Matrix
{
/**
* The array of elements.
*
* @var int[]|float[]
*/
protected $elements = array();
/**
* The matrix width.
*
* @var int
*/
protected $width;
/**
* The matrix height.
*
* @var int
*/
protected $height;
/**
* The given $elements get arranged as follows: The elements will be set from left to right in a row until the
* row is full. Then, the next line begins alike and so on.
*
* @param int $width the matrix width
* @param int $height he matrix height
* @param int[]|float[] $elements the matrix elements
*
* @throws \Imagine\Exception\InvalidArgumentException
*/
public function __construct($width, $height, $elements = array())
{
$this->width = (int) round($width);
if ($this->width < 1) {
throw new InvalidArgumentException('width has to be > 0');
}
$this->height = (int) round($height);
if ($this->height < 1) {
throw new InvalidArgumentException('height has to be > 0');
}
$expectedElements = $width * $height;
$providedElements = count($elements);
if ($providedElements > $expectedElements) {
throw new InvalidArgumentException('there are more provided elements than space in the matrix');
}
$this->elements = array_values($elements);
if ($providedElements < $expectedElements) {
$this->elements = array_merge(
$this->elements,
array_fill($providedElements, $expectedElements - $providedElements, 0)
);
}
}
/**
* Get the matrix width.
*
* @return int
*/
public function getWidth()
{
return $this->width;
}
/**
* Get the matrix height.
*
* @return int
*/
public function getHeight()
{
return $this->height;
}
/**
* Set the value of a cell.
*
* @param int $x
* @param int $y
* @param int|float $value
*/
public function setElementAt($x, $y, $value)
{
$this->elements[$this->calculatePosition($x, $y)] = $value;
}
/**
* Get the value of a cell.
*
* @param int $x
* @param int $y
*
* @return int|float
*/
public function getElementAt($x, $y)
{
return $this->elements[$this->calculatePosition($x, $y)];
}
/**
* Return all the matrix values, as a monodimensional array.
*
* @return int[]|float[]
*/
public function getValueList()
{
return $this->elements;
}
/**
* Return all the matrix values, as a bidimensional array (every array item contains the values of a row).
*
* @return int[]|float[]
*/
public function getMatrix()
{
return array_chunk($this->elements, $this->getWidth());
}
/**
* Returns a new Matrix instance, representing the normalized value of this matrix.
*
* @return static
*/
public function normalize()
{
$values = $this->getValueList();
$divisor = array_sum($values);
if ($divisor == 0 || $divisor == 1) {
return clone $this;
}
$normalizedElements = array();
foreach ($values as $value) {
$normalizedElements[] = $value / $divisor;
}
return new static($this->getWidth(), $this->getHeight(), $normalizedElements);
}
/**
* Calculate the offset position of a cell.
*
* @param int $x
* @param int $y
*
* @throws \Imagine\Exception\OutOfBoundsException
*
* @return int
*/
protected function calculatePosition($x, $y)
{
if ($x < 0 || $y < 0 || $this->width <= $x || $this->height <= $y) {
throw new OutOfBoundsException(sprintf('There is no position (%s, %s) in this matrix', $x, $y));
}
return $y * $this->height + $x;
}
}
Mini Shell