<?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;
use Imagine\Factory\ClassFactoryAwareInterface;
use Imagine\Image\Metadata\MetadataReaderInterface;
use Imagine\Image\Palette\Color\ColorInterface;
/**
* The imagine interface.
*/
interface ImagineInterface extends ClassFactoryAwareInterface
{
const VERSION = '1.3.4';
/**
* Creates a new empty image with an optional background color.
*
* @param \Imagine\Image\BoxInterface $size
* @param \Imagine\Image\Palette\Color\ColorInterface $color
*
* @throws \Imagine\Exception\InvalidArgumentException
* @throws \Imagine\Exception\RuntimeException
*
* @return \Imagine\Image\ImageInterface
*/
public function create(BoxInterface $size, ColorInterface $color = null);
/**
* Opens an existing image from $path.
*
* @param string|\Imagine\File\LoaderInterface|mixed $path the file path, a LoaderInterface instance, or an object whose string representation is the image path
*
* @throws \Imagine\Exception\RuntimeException
*
* @return \Imagine\Image\ImageInterface
*/
public function open($path);
/**
* Loads an image from a binary $string.
*
* @param string $string
*
* @throws \Imagine\Exception\RuntimeException
*
* @return \Imagine\Image\ImageInterface
*/
public function load($string);
/**
* Loads an image from a resource $resource.
*
* @param resource $resource
*
* @throws \Imagine\Exception\RuntimeException
*
* @return \Imagine\Image\ImageInterface
*/
public function read($resource);
/**
* Constructs a font with specified $file, $size and $color.
*
* The font size is to be specified in points (e.g. 10pt means 10)
*
* @param string $file
* @param int $size
* @param \Imagine\Image\Palette\Color\ColorInterface $color
*
* @return \Imagine\Image\FontInterface
*/
public function font($file, $size, ColorInterface $color);
/**
* Set the object to be used to read image metadata.
*
* @param \Imagine\Image\Metadata\MetadataReaderInterface $metadataReader
*
* @return $this
*/
public function setMetadataReader(MetadataReaderInterface $metadataReader);
/**
* Get the object to be used to read image metadata.
*
* @return \Imagine\Image\Metadata\MetadataReaderInterface
*/
public function getMetadataReader();
}