Загрузка SimpleImage - Загрузка исходного кода SimpleImage

SimpleImage

Другие категории

4.2.1

Скачать

Простое изображение

Класс PHP, который максимально упрощает работу с изображениями.

Разработан и поддерживается Кори ЛаВиска.

Если этот проект снова полюбит вас манипулировать изображениями PHP, рассмотрите возможность спонсировать меня для поддержки его разработки.

Обзор

 <?php
try {
  // Create a new SimpleImage object
  $ image = new  claviska  SimpleImage ();

  // Magic ! 
  $ image
    -> fromFile ( ' image.jpg ' )                     // load image . jpg
    -> autoOrient ()                              // adjust orientation based on exif data
    -> resize ( 320 , 200 )                          // resize to 320 x200 pixels
    -> flip ( ' x ' )                                 // flip horizontally
    -> colorize ( ' DarkBlue ' )                      // tint dark blue
    -> border ( ' black ' , 10 )                       // add a 10 pixel black border
    -> overlay ( ' watermark.png ' , ' bottom right ' )  // add a watermark image
    -> toFile ( ' new-image.png ' , ' image/png ' )      // convert to PNG and save a copy to new-image . png
    -> toScreen ();                               // output to the screen

  // And much more ! 
} catch ( Exception $ err ) {
  // Handle errors
  echo $ err -> getMessage ();
}

Требования

PHP 8.0+
Расширение GD

Функции

Поддерживает чтение, запись и преобразование форматов GIF, JPEG, PNG, WEBP, BMP, AVIF.
Читает и записывает файлы, URI данных и строки изображений.
Манипуляции: обрезка, изменение размера, наложение/водяной знак, добавление текста TTF.
Рисование: дуга, граница, точка, эллипс, линия, многоугольник, прямоугольник, прямоугольник с закругленными углами.
Фильтры: размытие, осветление, раскрашивание, контрастность, затемнение, обесцвечивание, обнаружение краев, тиснение, инвертирование, непрозрачность, пикселизация, сепия, резкость, эскиз.
Утилиты: настройка цвета, затемнение/осветление цвета, извлечение цветов.
Свойства: данные exif, высота/ширина, тип mime, ориентация.
Аргументы цвета могут передаваться как любой цвет CSS (например, LightBlue ), шестнадцатеричный цвет или массив RGB(A).
Поддержка альфа-прозрачности (GIF, PNG, WEBP, AVIF)
Цепные методы
Использует исключения
Загрузка с помощью Composer или вручную (только один файл)
Семантическое управление версиями

Установка

Установить с помощью Composer:

 composer require claviska/simpleimage

Или подключите библиотеку вручную:

 <?php
require ' src/claviska/SimpleImage.php ' ;

О

SimpleImage разработан и поддерживается Кори ЛаВиской. Авторские права Beautiful Site, LLC.

Если вам нравится использовать SimpleImage, особенно в коммерческих приложениях, рассмотрите возможность спонсировать меня для поддержки его разработки.

Спасибо!

Лицензия

Лицензировано по лицензии MIT.

API

Порядок великолепия:

Загрузите изображение
Манипулируйте изображением
Сохранить/вывести изображение

Советы по API:

Звездочка обозначает обязательный аргумент.
Методы, возвращающие объект SimpleImage, можно объединять в цепочки.
Вы можете передать URI файла или данных в конструктор, чтобы избежать вызова fromFile или fromDataUri .
Статические методы можно вызывать с помощью $image::methodName() или claviskaSimpleImage::methodName() .
Цветами могут быть цвета CSS (например, white ), шестнадцатеричная строка (например, «#ffffff») или массив RGBA.
Вы можете передать прозрачность в normalizeColor , когда передаете цвет CSS или шестнадцатеричную строку: white|0.25

Погрузчики

`fromDataUri($uri)`

Загружает изображение из URI данных.

$uri * (строка) — URI данных.

Возвращает объект SimpleImage.

`fromFile($file)`

Загружает изображение из файла.

$file * (строка) — файл изображения для загрузки.

Возвращает объект SimpleImage.

`fromNew($width, $height, $color)`

Создает новое изображение.

$width * (int) — Ширина изображения.
$height * (int) — Высота изображения.
$color (string|array) — необязательный цвет заливки для нового изображения (по умолчанию «прозрачный»).

Возвращает объект SimpleImage.

`fromString($string)`

Создает новое изображение из строки.

$string * (строка) — необработанные данные изображения в виде строки. Пример:
```
 $string = file_get_contents('image.jpg');
```

Возвращает объект SimpleImage.

вкладчики

`toDataUri($mimeType, $options)`

Создает URI данных.

$mimeType (строка) — формат изображения для вывода в виде типа mime (по умолчанию исходный тип mime).
$options (array|int) — Массив параметров или качество изображения в процентах (по умолчанию 100).

Возвращает строку, содержащую URI данных.

`toDownload($filename, $mimeType, $options)`

Принудительно загружает образ на клиентский компьютер. Должен быть вызван перед отправкой любого вывода на экран.

$filename * (строка) — имя файла (без пути), который необходимо отправить клиенту (например, «image.jpeg»).
$mimeType (строка) — формат изображения для вывода в виде типа mime (по умолчанию исходный тип mime).
$options (array|int) — Массив параметров или качество изображения в процентах (по умолчанию 100).

Возвращает объект SimpleImage.

`toFile($file, $mimeType, $options)`

Записывает изображение в файл.

$mimeType (строка) — формат изображения для вывода в виде типа mime (по умолчанию исходный тип mime).
$options (array|int) — Массив параметров или качество изображения в процентах (по умолчанию 100).

Возвращает объект SimpleImage.

`toScreen($mimeType, $options)`

Выводит изображение на экран. Должен быть вызван перед отправкой любого вывода на экран.

$mimeType (строка) — формат изображения для вывода в виде типа mime (по умолчанию исходный тип mime).
$options (array|int) — Массив параметров или качество изображения в процентах (по умолчанию 100).

Возвращает объект SimpleImage.

`toString($mimeType, $options)`

Генерирует строку изображения.

$mimeType (строка) — формат изображения для вывода в виде типа mime (по умолчанию исходный тип mime).
$options (array|int) — Массив параметров или качество изображения в процентах (по умолчанию 100).

Возвращает объект SimpleImage.

`generate($mimeType, $options)`

Генерирует изображение.

$mimeType (строка) — формат изображения для вывода в виде типа mime (по умолчанию исходный тип mime).
$options (array|int) — Массив параметров или качество изображения в процентах (по умолчанию 100).

Возвращает массив: [mimeType, data]

Массив опций

Вместо предоставления качества в виде целого числа в качестве последнего параметра функции вы также можете установить различные параметры в зависимости от целевого типа Mime, используя ассоциативный массив.

 $ image -> toFile ( $ file , ' image/avif ' , [
    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,

    // AVIF ( default - 1 which is 6 )
    // range of slow and small file 0 to 10 fast but big file
    ' speed ' => - 1 ,
]);

 $ image -> toFile ( $ file , ' image/bmp ' , [
    // BMP : boolean ( default true )
    ' compression ' => true ,

    // BMP , JPG ( default null , keep the same )
    ' interlace ' => null ,
]);

 $ image -> toFile ( $ file , ' image/gif ' , [
    // GIF , PNG ( default true )
    ' alpha ' => true ,
]);

 $ image -> toFile ( $ file , ' image/jpeg ' , [
    // BMP , JPG ( default null , keep the same )
    ' interlace ' => null ,

    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,
]);

 $ image -> toFile ( $ file , ' image/png ' , [
    // GIF , PNG ( default true )
    ' alpha ' => true ,

    // PNG : 0 - 10 , defaults to zlib ( default 6 )
    ' compression ' => - 1 ,

    // PNG ( default - 1 )
    ' filters ' => - 1 ,

    // has no effect on PNG images , since the format is lossless
    // ' quality' = > 100 ,
]);

 $ image -> toFile ( $ file , ' image/webp ' , [
    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,
]);

Утилиты

`getAspectRatio()`

Получает текущее соотношение сторон изображения.

Возвращает соотношение сторон в виде числа с плавающей запятой.

`getExif()`

Получает данные exif изображения.

Возвращает массив данных exif или значение NULL, если данные недоступны.

`getHeight()`

Получает текущую высоту изображения.

Возвращает высоту как целое число.

`getMimeType()`

Получает MIME-тип загруженного изображения.

Возвращает строку типа mime.

`getOrientation()`

Получает текущую ориентацию изображения.

Возвращает строку: «пейзаж», «портрет» или «квадрат».

`getResolution()`

Получает текущее разрешение изображения в DPI.

Возвращает массив целых чисел: [0 => 96, 1 => 96]

`getWidth()`

Получает текущую ширину изображения.

Возвращает ширину как целое число.

`hasImage()`

Проверяет, загрузил ли объект SimpleImage изображение.

Возвращает логическое значение.

`reset()`

Уничтожает ресурс изображения.

Возвращает объект SimpleImage.

Манипуляция

`autoOrient()`

Поворачивает изображение, чтобы ориентация была правильной на основе его данных exif. Этот метод можно безопасно вызывать для изображений, у которых нет данных exif (никакие изменения не будут внесены). Возвращает объект SimpleImage.

`bestFit($maxWidth, $maxHeight)`

Пропорционально измените размер изображения, чтобы оно соответствовало определенной ширине и высоте.

$maxWidth * (int) — максимальная ширина изображения.
$maxHeight * (int) — максимальная высота изображения.

Возвращает объект SimpleImage.

`crop($x1, $y1, $x2, $y2)`

Обрезать изображение.

$x1 — верхняя левая координата x.
$y1 — верхняя левая координата y.
$x2 — нижняя правая координата x.
$y2 — нижняя правая координата x.

Возвращает объект SimpleImage.

`fitToHeight($height)` (УСТАРЕЛО)

Пропорционально измените размер изображения до определенной высоты.

Этот метод устарел в версии 3.2.2 и будет удален в версии 4.0. Вместо этого используйте resize(null, $height) .

$height * (int) — Высота, до которой можно изменить размер изображения.

Возвращает объект SimpleImage.

`fitToWidth($width)` (УСТАРЕЛО)

Пропорционально измените размер изображения до определенной ширины.

Этот метод устарел в версии 3.2.2 и будет удален в версии 4.0. Вместо этого используйте resize($width, null) .

$width * (int) — Ширина, до которой можно изменить размер изображения.

Возвращает объект SimpleImage.

`flip($direction)`

Переверните изображение по горизонтали или по вертикали.

$direction * (строка) — Направление переворота: x|y|both

Возвращает объект SimpleImage.

`maxColors($max, $dither)`

Уменьшает изображение до максимального количества цветов.

$max * (int) — Максимальное количество используемых цветов.
$dither (bool) — использовать или нет эффект размывания (по умолчанию true).

Возвращает объект SimpleImage.

`overlay($overlay, $anchor, $opacity, $xOffset, $yOffset)`

Поместите изображение поверх текущего изображения.

$overlay * (string|SimpleImage) — изображение для наложения. Это может быть имя файла, URI данных или объект SimpleImage.
$anchor (строка) — точка привязки: «центр», «сверху», «снизу», «слева», «справа», «слева вверху», «сверху справа», «слева снизу», «справа снизу» ( по умолчанию «центр»)
$opacity (float) — уровень непрозрачности наложения 0–1 (по умолчанию 1).
$xOffset (int) — Горизонтальное смещение в пикселях (по умолчанию 0).
$yOffset (целое) — вертикальное смещение в пикселях (по умолчанию 0).
$calculateOffsetFromEdge (bool) — рассчитать смещение относительно краев изображения. $xOffset и $yOffset не влияют на центральную привязку. (по умолчанию ложь).

Возвращает объект SimpleImage.

`resize($width, $height)`

Измените размер изображения до указанных размеров. Если указан только один размер, размер изображения будет изменен пропорционально.

$width * (int) — ширина нового изображения.
$height * (int) — Высота нового изображения.

Возвращает объект SimpleImage.

`resolution($res_x, $res_y)`

Изменяет разрешение (DPI) изображения.

$res_x * (int) — горизонтальное разрешение в DPI.
$res_y (int) — вертикальное разрешение в DPI.

Возвращает объект SimpleImage.

`rotate($angle, $backgroundColor)`

Поворачивает изображение.

$angle * (int) — Угол поворота (-360 — 360).
$backgroundColor (string|array) — цвет фона, который будет использоваться для непокрытой области зоны после вращения (по умолчанию «прозрачный»).

Возвращает объект SimpleImage.

`text($text, $options, &$boundary)`

Добавляет текст к изображению.

$text* (строка) — Желаемый текст.
$options (массив) — Массив опций.
- fontFile * (строка) — используемый файл шрифта TrueType (или совместимый).
- size (int) — Размер шрифта в пикселях (по умолчанию 12).
- color (строка|массив) — цвет текста (по умолчанию черный).
- anchor (строка) — точка привязки: «центр», «сверху», «снизу», «слева», «справа», «слева сверху», «сверху справа», «слева снизу», «справа снизу» (по умолчанию 'центр').
- xOffset (int) — горизонтальное смещение в пикселях (по умолчанию 0).
- yOffset (int) — вертикальное смещение в пикселях (по умолчанию 0).
- shadow (массив) — параметры тени текста.
  - x * (int) — Смещение по горизонтали в пикселях.
  - y *(int) — Вертикальное смещение в пикселях.
  - color * (строка|массив) — цвет тени текста.
- calculateOffsetFromEdge (bool) — вычисляет смещение относительно краев изображения (по умолчанию false).
- baselineAlign (bool) — выравнивает шрифт текста по базовой линии. (по умолчанию правда).
$boundary (массив) — если она передана, эта переменная будет содержать массив с координатами, окружающими текст: [x1, y1, x2, y2, ширина, высота]. Это можно использовать для расчета положения текста после его добавления к изображению.

Возвращает объект SimpleImage.

`thumbnail($width, $height, $anchor)`

Создает миниатюру изображения. Эта функция пытается максимально приблизить изображение к заданным размерам, а затем обрезает оставшееся избыточное изображение, чтобы добиться желаемого размера. Полезно для создания миниатюр изображений.

$width * (int) — Ширина миниатюры.
$height * (int) — Высота миниатюры.
$anchor (строка) — точка привязки: «центр», «сверху», «снизу», «слева», «справа», «слева вверху», «сверху справа», «слева снизу», «справа снизу» ( по умолчанию «центр»).

Возвращает объект SimpleImage.

Рисунок

`arc($x, $y, $width, $height, $start, $end, $color, $thickness)`

Рисует дугу.

$x * (int) — координата x центра дуги.
$y * (int) — координата y центра дуги.
$width * (int) — Ширина дуги.
$height * (int) — Высота дуги.
$start * (int) — Начало дуги в градусах.
$end * (int) — Конец дуги в градусах.
$color * (строка|массив) — Цвет дуги.
$thickness (int|string) — Толщина линии в пикселях или «заполненная» (по умолчанию 1).

Возвращает объект SimpleImage.

`border($color, $thickness)`

Рисует рамку вокруг изображения.

$color * (строка|массив) — Цвет границы.
$thickness (int) — Толщина границы (по умолчанию 1).

Возвращает объект SimpleImage.

`dot($x, $y, $color)`

Рисует точку в один пиксель.

$x * (int) — координата x точки.
$y * (int) — координата y точки.
$color * (строка|массив) — Цвет точки.

Возвращает объект SimpleImage.

`ellipse($x, $y, $width, $height, $color, $thickness)`

Рисует эллипс.

$x * (int) — координата x центра.
$y * (int) — координата y центра.
$width * (int) — Ширина эллипса.
$height * (int) — Высота эллипса.
$color * (строка|массив) — Цвет эллипса.
$thickness (int|string) — Толщина линии в пикселях или «заполненная» (по умолчанию 1).

Возвращает объект SimpleImage.

`fill($color)`

Заполняет изображение сплошным цветом.

$color (строка|массив) — Цвет заливки.

Возвращает объект SimpleImage.

`line($x1, $y1, $x2, $y2, $color, $thickness)`

Рисует линию.

$x1 * (int) — координата x первой точки.
$y1 * (int) — координата y первой точки.
$x2 * (int) — координата x второй точки.
$y2 * (int) — координата y второй точки.
$color (строка|массив) — Цвет линии.
$thickness (int) — Толщина линии (по умолчанию 1).

Возвращает объект SimpleImage.

`polygon($vertices, $color, $thickness)`

Рисует многоугольник.

$vertices * (массив) — вершины многоугольника в массиве массивов x/y. Пример:
```
 [
  ['x' => x1, 'y' => y1],
  ['x' => x2, 'y' => y2],
  ['x' => xN, 'y' => yN]
]
```
$color * (строка|массив) — Цвет многоугольника.
$thickness (int|string) — Толщина линии в пикселях или «заполненная» (по умолчанию 1).

Возвращает объект SimpleImage.

`rectangle($x1, $y1, $x2, $y2, $color, $thickness)`

Рисует прямоугольник.

$x1 * (int) — верхняя левая координата x.
$y1 * (int) — верхняя левая координата y.
$x2 * (int) — нижняя правая координата x.
$y2 * (int) — нижняя правая координата y.
$color * (строка|массив) — Цвет прямоугольника.
$thickness (int|string) — Толщина линии в пикселях или «заполненная» (по умолчанию 1).

Возвращает объект SimpleImage.

`roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $thickness)`

Рисует закругленный прямоугольник.

$x1 * (int) — верхняя левая координата x.
$y1 * (int) — верхняя левая координата y.
$x2 * (int) — нижняя правая координата x.
$y2 * (int) — нижняя правая координата y.
$radius * (int) — Радиус границы в пикселях.
$color * (строка|массив) — Цвет прямоугольника.
$thickness (int|string) — Толщина линии в пикселях или «заполненная» (по умолчанию 1).

Возвращает объект SimpleImage.

Фильтры

`blur($type, $passes)`

Применяет фильтр размытия.

$type (строка) — используемый алгоритм размытия: «выборочное», «гауссово» (по умолчанию «гауссово»).
$passes (int) — количество раз применения фильтра, усиливающего эффект (по умолчанию 1).

Возвращает объект SimpleImage.

`brighten($percentage)`

Применяет фильтр яркости, чтобы сделать изображение ярче.

$percentage * (int) — Процент осветления изображения (0 — 100).

Возвращает объект SimpleImage.

`colorize($color)`

Применяет фильтр раскрашивания.

$color * (строка|массив) — Цвет фильтра.

Возвращает объект SimpleImage.

`contrast($percentage)`

Применяет контрастный фильтр.

$percentage * (int) — процент для корректировки (-100 — 100).

Возвращает объект SimpleImage.

`darken($percentage)`

Применяет фильтр яркости, чтобы затемнить изображение.

$percentage * (int) — Процент затемнения изображения (0–100).

Возвращает объект SimpleImage.

`desaturate()`

Применяет фильтр обесцвечивания (градации серого).

Возвращает объект SimpleImage.

`duotone($lightColor, $darkColor)`

Применяет к изображению двухцветный фильтр.

$lightColor * (строка|массив) — Самый светлый цвет в дуэте.
$darkColor * (строка|массив) — самый темный цвет в дуэте.

Возвращает объект SimpleImage.

`edgeDetect()`

Применяет фильтр обнаружения границ.

Возвращает объект SimpleImage.

`emboss()`

Применяет фильтр тиснения.

Возвращает объект SimpleImage.

`invert()`

Инвертирует цвета изображения.

Возвращает объект SimpleImage.

`opacity()`

Изменяет уровень непрозрачности изображения.

$opacity * (float) — Желаемый уровень непрозрачности (0 — 1).

Возвращает объект SimpleImage.

`pixelate($size)`

Применяет пиксельный фильтр.

$size (int) — Размер блоков в пикселях (по умолчанию 10).

Возвращает объект SimpleImage.

`sepia()`

Имитирует эффект сепии, обесцвечивая изображение и применяя тон сепии.

Возвращает объект SimpleImage.

`sharpen($amount)`

Улучшает резкость изображения.

$amount (int) — Величина повышения резкости (1–100, по умолчанию 50)

Возвращает объект SimpleImage.

`sketch()`

Применяет фильтр удаления среднего значения для создания эффекта эскиза.

Возвращает объект SimpleImage.

Утилиты цвета

`(static) adjustColor($color, $red, $green, $blue, $alpha)`

Регулирует цвет путем независимого увеличения/уменьшения значений красного/зеленого/синего/альфа.

$color * (строка|массив) — цвет для настройки.
$red * (int) — регулировка красного цвета (-255 — 255).
$green * (int) — Регулировка зеленого (-255 — 255).
$blue * (int) — регулировка синего цвета (-255 — 255).
$alpha * (float) — корректировка альфа (-1 — 1).

Возвращает массив цветов RGBA.

`(static) darkenColor($color, $amount)`

Затемняет цвет.

$color * (строка|массив) — цвет затемнения.
$amount * (int) — величина затемнения (0–255).

Возвращает массив цветов RGBA.

`extractColors($count = 10, $backgroundColor = null)`

Извлекает цвета из изображения так, как это сделал бы человек.™ Для этого метода требуется сторонняя библиотека LeagueColorExtractor. Если вы используете Composer, он будет установлен автоматически.

$count (int) — максимальное количество извлекаемых цветов (по умолчанию 5).
$backgroundColor (string|array) — по умолчанию любой пиксель со значением альфа больше нуля будет отброшен. Это связано с тем, что прозрачные цвета не воспринимаются такими, какие они есть. Например, полностью прозрачный черный цвет на белом фоне будет выглядеть белым. Поэтому, если вы хотите принять во внимание прозрачность, вам необходимо указать цвет фона по умолчанию.

Возвращает массив массивов цветов RGBA.

`getColorAt($x, $y)`

Получает значение RGBA одного пикселя.

$x * (int) — Горизонтальное положение пикселя.
$y * (int) — Вертикальное положение пикселя.

Возвращает массив цветов RGBA или false, если позиция x/y находится за пределами холста.

`(static) lightenColor($color, $amount)`

Осветляет цвет.

$color * (строка|массив) — цвет, который нужно осветлить.
$amount * (int) — величина затемнения (0–255).

Возвращает массив цветов RGBA.

`(static) normalizeColor($color)`

Нормализует шестнадцатеричное значение цвета или значение цвета массива в правильно отформатированный массив RGBA.

$color * (строка|массив) — имя цвета CSS, шестнадцатеричная строка или массив [красный, зеленый, синий, альфа].

Вы можете передать альфа-прозрачность через шестнадцатеричные строки и названия цветов. Например:

#fff|0.50 <-- 50% белый красный|0.25 <-- 25% красный

Возвращает массив: [красный, зеленый, синий, альфа]

Исключения

SimpleImage генерирует стандартные исключения, когда что-то идет не так. Вы всегда должны использовать блок try/catch в своем коде, чтобы правильно их обрабатывать.

 <?php
try {
  $ image = new  claviska SimpleImage( ' image.jpeg ' )
  // ...
} catch ( Exception $ err ) {
  echo $ err -> getMessage ();
}

Чтобы проверить наличие конкретных ошибок, сравните $err->getCode() с определенными константами ошибок.

 <?php
try {
  $ image = new  claviska SimpleImage( ' image.jpeg ' )
  // ...
} catch ( Exception $ err ) {
  if ( $ err -> getCode () === $ image :: ERR_FILE_NOT_FOUND ) {
    echo ' File not found! ' ;
  } else {
    echo $ err -> getMessage ();
  }
}

Рекомендуется всегда использовать определенные константы вместо их целочисленных значений. Значения, скорее всего, изменятся в будущих версиях и НЕ БУДУТ считаться критическими изменениями.

ERR_FILE_NOT_FOUND — указанный файл по какой-то причине не удалось найти или загрузить.
ERR_FONT_FILE — указанный файл шрифта не удалось загрузить.
ERR_FREETYPE_NOT_ENABLED — поддержка Freetype не включена в вашей версии PHP.
ERR_GD_NOT_ENABLED — расширение GD не включено в вашей версии PHP.
ERR_LIB_NOT_LOADED — необходимая библиотека не загружена.
ERR_INVALID_COLOR — в качестве аргумента было передано недопустимое значение цвета.
ERR_INVALID_DATA_URI — указанный URI данных недействителен.
ERR_INVALID_IMAGE — указанное изображение недействительно.
ERR_UNSUPPORTED_FORMAT — указан недопустимый формат изображения.
ERR_WEBP_NOT_ENABLED — поддержка WEBP не включена в вашей версии PHP.
ERR_WRITE — Невозможно выполнить запись в файловую систему.
ERR_INVALID_FLAG — указанный ключ флага не существует.

Полезные вещи, которые нужно знать

Аргументами цвета могут быть имя цвета CSS (например, LightBlue ), шестнадцатеричная строка цвета (например, #0099dd ) или массив RGB(A) (например, ['red' => 255, 'green' => 0, 'blue' => 0, 'alpha' => 1] ).
Когда $thickness > 1, GD рисует линии желаемой толщины из центрального начала. Например, прямоугольник, нарисованный на [10, 10, 20, 20] толщиной 3, фактически будет нарисован на [9, 9, 21, 21]. Это справедливо для всех фигур и не является ошибкой в библиотеке SimpleImage.

Флаги экземпляров

Настройте поведение экземпляра SimpleImage, установив значения флагов экземпляра с помощью метода setFlag($key, $value) .

 $ image = new  claviska  SimpleImage ( ' image.jpeg ' )-> setFlag ( " foo " , " bar " );

Вы также можете передать ассоциативный массив конструктору SimpleImage для установки флагов экземпляра.

 $ image = new  claviska  SimpleImage ( ' image.jpeg ' , [ ' foo ' => ' bar ' ]);
// . . or without an $ image
$ image = new  claviska  SimpleImage (flags: [ ' foo ' => ' bar ' ]);

Примечание. setFlag() выдает исключение ERR_INVALID_FLAG , если ключ не существует (нет значения по умолчанию).

`sslVerify`

Если для sslVerify установлено значение false (по умолчанию true ), все изображения, загружаемые через HTTPS, не будут проходить проверку однорангового сертификата. Это особенно полезно для самозаверяющих сертификатов.

 $ image = new  claviska  SimpleImage ( ' https://localhost/image.jpeg ' , [ ' sslVerify ' => false ]);
// Would normally throw an OpenSSL exception , but is ignored with the sslVerify flag set to false .

Отличия от SimpleImage 2.x

Нормализованные аргументы цвета (цвета могут быть именем цвета CSS, шестнадцатеричным цветом или массивом RGB(A)).
Нормализованные аргументы альфа (непрозрачности): 0 (прозрачный) – 1 (непрозрачный)
Добавлена тень текста в text метод.
Добавлен метод fromString() для загрузки изображений из строк.
Добавлен метод toString() для генерации строк изображений.
Добавлен метод arc для рисования дуг.
Добавлен метод border для рисования границ.
Добавлен dot метод для рисования отдельных пикселей.
Добавлен метод ellipse для рисования эллипсов и кругов.
Добавлен метод line для рисования линий.
Добавлен метод polygon для рисования многоугольников.
Добавлен метод rectangle для рисования прямоугольников.
Добавлен метод roundedRectangle для рисования прямоугольников со скругленными углами.
Добавлен метод adjustColor для изменения цветовых каналов RGBA для создания относительных вариаций цвета.
Добавлен метод darkenColor для затемнения цвета.
Добавлен метод extractColors для получения наиболее распространенных цветов из изображения.
Добавлен метод getColorAt для получения значений RGBA определенного пикселя.
Добавлен метод lightenColor для осветления цвета.
Добавлен метод toDownload , позволяющий принудительно загрузить изображение на клиентский компьютер.
Добавлен duotone фильтр для создания двухтоновых изображений.
Добавлен метод sharpen для повышения резкости изображения.
Пространство имен изменено с abeautifulsite на claviska .
Изменен метод create на fromNew .
Изменен метод load на fromFile .
Изменен метод load_base64 на fromDataUri .
Изменен метод output на toScreen .x.
Изменен метод output_base64 на toDataUri .
Изменен метод save на toFile .
Изменен text метод, чтобы он принимал массив опций вместо множества аргументов.
Из text метода удалена обводка текста, поскольку она давала неверные результаты и не поддерживала прозрачность.
Удален метод smooth , поскольку его аргументы в руководстве по PHP плохо документированы.
Удален устаревший метод adaptive_resize (вместо него используйте thumbnail ).
Удален get_meta_data (вместо этого используйте getExif , getHeight , getMime , getOrientation и getWidth ).
Добавлен файл .editorconfig. Прежде чем отправлять материалы, убедитесь, что ваш редактор поддерживает эти настройки.
Для отступов изменено с четырех пробелов на два (извините, PHP-фиг!).
Переключен с underscore_methods на CamelCaseMethods.
Организованные методы в группы по функциям.
Удалены комментарии PHPDoc. В настоящее время я не хочу включать их в библиотеку.

Расширять

Дополнительная информация

Версия 4.2.1
Тип Другие категории
Время обновления 2024-12-27
размер 28.96KB
От Github

Связанные приложения

termwind

2024-12-14
wp functions

2024-12-20
slugify

2024-12-14
laravel firebase

2024-12-14
grumphp

2024-12-17
crm application

2024-12-14

SimpleImage

Простое изображение

Обзор

Требования

Функции

Установка

О

Лицензия

API

Погрузчики

fromDataUri($uri)

fromFile($file)

fromNew($width, $height, $color)

fromString($string)

вкладчики

toDataUri($mimeType, $options)

toDownload($filename, $mimeType, $options)

toFile($file, $mimeType, $options)

toScreen($mimeType, $options)

toString($mimeType, $options)

generate($mimeType, $options)

Массив опций

Утилиты

getAspectRatio()

getExif()

getHeight()

getMimeType()

getOrientation()

getResolution()

getWidth()

hasImage()

reset()

Манипуляция

autoOrient()

bestFit($maxWidth, $maxHeight)

crop($x1, $y1, $x2, $y2)

fitToHeight($height) (УСТАРЕЛО)

fitToWidth($width) (УСТАРЕЛО)

flip($direction)

maxColors($max, $dither)

overlay($overlay, $anchor, $opacity, $xOffset, $yOffset)

resize($width, $height)

resolution($res_x, $res_y)

rotate($angle, $backgroundColor)

text($text, $options, &$boundary)

thumbnail($width, $height, $anchor)

Рисунок

arc($x, $y, $width, $height, $start, $end, $color, $thickness)

border($color, $thickness)

dot($x, $y, $color)

ellipse($x, $y, $width, $height, $color, $thickness)

fill($color)

line($x1, $y1, $x2, $y2, $color, $thickness)

polygon($vertices, $color, $thickness)

rectangle($x1, $y1, $x2, $y2, $color, $thickness)

roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $thickness)

Фильтры

blur($type, $passes)

brighten($percentage)

colorize($color)

contrast($percentage)

darken($percentage)

desaturate()

duotone($lightColor, $darkColor)

edgeDetect()

emboss()

invert()

opacity()

pixelate($size)

sepia()

sharpen($amount)

sketch()

Утилиты цвета

(static) adjustColor($color, $red, $green, $blue, $alpha)

(static) darkenColor($color, $amount)

extractColors($count = 10, $backgroundColor = null)

getColorAt($x, $y)

(static) lightenColor($color, $amount)

(static) normalizeColor($color)

Исключения

`fromDataUri($uri)`

`fromFile($file)`

`fromNew($width, $height, $color)`

`fromString($string)`

`toDataUri($mimeType, $options)`

`toDownload($filename, $mimeType, $options)`

`toFile($file, $mimeType, $options)`

`toScreen($mimeType, $options)`

`toString($mimeType, $options)`

`generate($mimeType, $options)`

`getAspectRatio()`

`getExif()`

`getHeight()`

`getMimeType()`

`getOrientation()`

`getResolution()`

`getWidth()`

`hasImage()`

`reset()`

`autoOrient()`

`bestFit($maxWidth, $maxHeight)`

`crop($x1, $y1, $x2, $y2)`

`fitToHeight($height)` (УСТАРЕЛО)

`fitToWidth($width)` (УСТАРЕЛО)

`flip($direction)`

`maxColors($max, $dither)`

`overlay($overlay, $anchor, $opacity, $xOffset, $yOffset)`

`resize($width, $height)`

`resolution($res_x, $res_y)`

`rotate($angle, $backgroundColor)`

`text($text, $options, &$boundary)`

`thumbnail($width, $height, $anchor)`

`arc($x, $y, $width, $height, $start, $end, $color, $thickness)`

`border($color, $thickness)`

`dot($x, $y, $color)`

`ellipse($x, $y, $width, $height, $color, $thickness)`

`fill($color)`

`line($x1, $y1, $x2, $y2, $color, $thickness)`

`polygon($vertices, $color, $thickness)`

`rectangle($x1, $y1, $x2, $y2, $color, $thickness)`

`roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $thickness)`

`blur($type, $passes)`

`brighten($percentage)`

`colorize($color)`

`contrast($percentage)`

`darken($percentage)`

`desaturate()`

`duotone($lightColor, $darkColor)`

`edgeDetect()`

`emboss()`

`invert()`

`opacity()`

`pixelate($size)`

`sepia()`

`sharpen($amount)`

`sketch()`

`(static) adjustColor($color, $red, $green, $blue, $alpha)`

`(static) darkenColor($color, $amount)`

`extractColors($count = 10, $backgroundColor = null)`

`getColorAt($x, $y)`

`(static) lightenColor($color, $amount)`

`(static) normalizeColor($color)`

`sslVerify`