<?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\Image\Fill\Gradient;

use Imagine\Image\Fill\FillInterface;
use Imagine\Image\Palette\Color\ColorInterface;
use Imagine\Image\PointInterface;

/**
 * Linear gradient fill.
 */
abstract class Linear implements FillInterface
{
    /**
     * @var int
     */
    private $length;

    /**
     * @var \Imagine\Image\Palette\Color\ColorInterface
     */
    private $start;

    /**
     * @var \Imagine\Image\Palette\Color\ColorInterface
     */
    private $end;

    /**
     * Constructs a linear gradient with overall gradient length, and start and
     * end shades, which default to 0 and 255 accordingly.
     *
     * @param int $length
     * @param \Imagine\Image\Palette\Color\ColorInterface $start
     * @param \Imagine\Image\Palette\Color\ColorInterface $end
     */
    final public function __construct($length, ColorInterface $start, ColorInterface $end)
    {
        $this->length = $length;
        $this->start = $start;
        $this->end = $end;
    }

    /**
     * {@inheritdoc}
     *
     * @see \Imagine\Image\Fill\FillInterface::getColor()
     */
    final public function getColor(PointInterface $position)
    {
        $l = $this->getDistance($position);

        if ($l >= $this->length) {
            return $this->end;
        }

        if ($l < 0) {
            return $this->start;
        }

        return $this->start->getPalette()->blend($this->start, $this->end, $l / $this->length);
    }

    /**
     * @return \Imagine\Image\Palette\Color\ColorInterface
     */
    final public function getStart()
    {
        return $this->start;
    }

    /**
     * @return \Imagine\Image\Palette\Color\ColorInterface
     */
    final public function getEnd()
    {
        return $this->end;
    }

    /**
     * Get the distance of the position relative to the beginning of the gradient.
     *
     * @param \Imagine\Image\PointInterface $position
     *
     * @return int
     */
    abstract protected function getDistance(PointInterface $position);
}