Компонент pThumb. Настройки и параметры phpThumb
Настройки и параметры встроенной в MODx библиотеки phpThumb
Оглавление
Настройки и параметры встроенной в MODx библиотеки phpThumb.
phpThumb использует библиотеку GD для создания миниатюр из изображений на лету. Размер вывода миниатюры настраиваться с помощью параметров, которые вы указывает для обработки изображений.
Параметры phpThumb:
brit
Название | Описание | Пример |
src | Имя файла исходного изображения. | |
new | Создать новую картинку, не миниатюру из существующего изображения. Требует набор параметров «w» и «h». | &new=FF0000|75 — красный background, 75% opacity. Для фона устанавливаются цвета в формате hex. Параметр Opacity опциональный, по умолчанию 100%. |
w | Максимальная ширина выходной миниатюры в пикселях. | |
h | Максимальная высота выходной миниатюры в пикселях. | |
wp | Максимальная ширина для портретных изображений. | |
hp | Максимальная высота для портретных изображений. | |
hl | Максимальная высота для пейзажных изображений. | |
ws | Максимальная ширина для квадратных изображений. | |
hs | Vаксимальная высота для квадратных изображений. | |
f | формат изображения после обработки («webp», «jpeg», «png», или «gif»). | |
q | Компрессия JPEG (качество). |
|
sx | Левая сторона исходного прямоугольника (по умолчанию = 0) (значения 0 < sx < 1). | |
sy | Верхняя сторона исходного прямоугольника (по умолчанию = 0) (значения 0 < sy < 1). | |
sw | Ширина исходного прямоугольника (по умолчанию = fullwidth) (значения 0 < sw < 1) | |
sh | Высота исходного прямоугольника (по умолчанию = fullheight) (значения 0 < sh < 1) | |
zc | Масштабирование при обрезке (zoom-crop). С авто кропом, изображение будет обрезаться по большему размеру, чтобы заполнять меньший размер (требует указания обоих параметров «w» и «h», переопределяет «iar», «far»). Необходим ImageMagick для значений отличных от «C» или «1». |
|
bg | Цвет фона (по умолчанию = FFFFFF). | |
bc | Цвет границы (по умолчанию = 000000). | |
fltr | Фильтр. Вызывается в виде массива с параметрами: | |
brit | яркость — fltr[]=brit|<value> — где <value> значение в диапазоне от -255 до 255. | |
cont | контрастность — fltr[]=cont|<value> — где <value> значение в диапазоне от -255 до 255. | |
gam | гамма-коррекция — fltr[]=gam|<value> — где <value> число от 0.01 до 10 (по умолчанию 1.0). | |
sat | насыщенность — fltr[]=sat|<value> — где <value> число в диапазоне от 0 (без изменений) до -100 (полное обесцвечивание = оттенки серого), или это может быть любое положительное число для повышенной насыщенности. | |
ds | обесцвечивание — fltr[]=ds|<value> — аналогично «sat», но положительные значения обесцвечивают, отрицательные — насыщают цветом. | |
gray | оттенки серого — fltr[]=gray — убрать цветность. | |
th | порог — fltr[]=th|<value> — переводит изображение в оттенки серого, затем все пиксели ярче <value> (диапазон 0-255) делает белыми, все пиксили темнее <value> делает черными. | |
rcd | уменьшить глубину цвета — fltr[]=rcd|<c>|<d> — где <c> количество цветов (2-256) в выходном изображении, а <d> равное «1» сгладить (по умолчанию) или «0» не сглаживать. | |
clr | раскрасить — fltr[]=clr|<value>|<color> — где <value> число между 0 и 100 для количества расцвечивания, <color> — цвет для расцвечивания. | |
sep | сепия — fltr[]=sep|<value>|<color> — где <value> число между 0 и 100 для количества расцвечивания (по умолчанию=50), и <color> цвет, чтобы раскрасить (по умолчанию=A28065). | |
usm | нерезкое маскирование — fltr[]=usm|<a>|<r>|<t> | |
blur | размытие — fltr[]=blur|<radius> — где (0 < <radius> < 25) (по умолчанию = 1). | |
gblr | гауссово размытие — fltr[]=gblr . | |
sblr | избирательное размытие — fltr[]=gblr . | |
smth | smooth — fltr[]=smth|<value> | |
lvl | уровни — fltr[]=lvl|<channel>|<method>|<threshold — где <channel> может быть одним из «r», «g», «b», «a» (для Red, Green, Blue, Alpha соответственно), или ‘*’ для всех RGB каналов (по умолчанию) основанных на шкале серого среднего. | |
wb | баланс белого — «wb» в настройках по умолчанию уже дает эффект, аналогичный «lvl», обычно нет необходимости использовать «lvl», если уже используется «wb». | |
hist | гистограмма —
| |
over | overlay / underlay накладывает изображение на миниатюру или накладывает миниатюру на другое изображение (например, для создания рамки рисунка) —
| |
wmi | водяной знак в виде изображения —
| |
wmt | текстовый водяной знак —
<x> — работает только со шрифтами TTF, но не со встроенными. | |
flip | сдвиг изображения по оси X или Y — fltr[]=flip|x или fltr[]=flip|y . | |
ric | скруглить углы изображения (для вывода прозрачных изображений PNG) —
| |
elip | похоже на скругление углов, но более эксримальное — fltr[]=elip . | |
mask | fltr[]=mask|filename.png|<i> — значения маски в оттенках серого. Применяется в качестве альфа-канала к основному изображению. Белый непрозрачный, черный прозрачный, если параметр <i> (инвертировать) не установлен в 1, в этом случае черный непрозрачный, а белый прозрачный. | |
bvl | BeVeL — fltr[]=bvl|<w>|<c1>|<c2> — где:
| |
bord | граница —
| |
fram | рамка наподобие «bord», но более настраиваемая —
| |
drop | тень —
| |
crop | обрезка изображения —
| |
rot | поворот —
| |
size | изменение размера —
Не используйте этот фильтр без необходимости. Только в случаях, когда к другим фильтрам необходимо применить абсолютное позиционирование на основе исходного изображения и полученное изображение должно быть изменено после применения других фильтров. Этот фильтр является менее эффективным, чем стандартные процедуры изменения размера. | |
md5s | MD5-хэш исходного изображения |
Благодарность автору
Если по какой-либо причине вы хотите поблагодарить автора данного ресурса, вы можете это сделать одним из удобных для вас способов ниже.
- ЮMoney (Яндекс.Деньги)
Один из самых популярных способов поблагодарить автора, воспользоваться сервисом Яндекс.Деньги.
Время работы: 0,1488 s
Время запросов: 0,1488 s
Количество запросов: 27
Источник: cache
Авторская документация по web-разработке Web in Mind | © 2019 – 2023
[MODX] pThumb — ресайз изображений.
Примеры использования.Главная / [MODX] pThumb — ресайз изображений. Примеры использования.
14 Августа 2018
После того как однажды перейти с phpThumbOf на rezImgCrop я в целом был доволен жизнью, но все таки последний сниппет хоть и был хорош, но в нем тожде были косяки.
Варианты вызова сниппета
[[*image:pthumb=`w=245&h=170&zc=1`]]
[[!pthumb? &input=`img/photo.jpg` &options=`w=245&h=170&zc=1`]]
{$_pls['tv.image'] | pthumb : 'w=245&h=170&zc=1'}
Тут можно найти варианты использования pThumb, а также тестирование степени сжатия, чтобы определить требования Google PageSpeed к компрессии изображений.
Примеры использования pThumb
Горизонтальные
Размер: 483.22 КБ
Ширина: 1280px
Высота: 783px
Вертикальные
Размер: 533.33 КБ
Ширина: 736px
Высота: 1100px
PNG с прозрачным фоном
Размер: 200. 24 КБ
Ширина: 404px
Высота: 693px
Оригинал
Горизонтальные
Размер: 282.69 КБ
Ширина: 1280px
Высота: 783px
Вертикальные
Размер: 209.32 КБ
Ширина: 736px
Высота: 1100px
PNG с прозрачным фоном
Размер: 194.77 КБ
Ширина: 404px
Высота: 693px
[[*image:pthumb]]
Горизонтальные
Размер: 15.33 КБ
Ширина: 250px
Высота: 153px
Вертикальные
Размер: 25.88 КБ
Ширина: 250px
Высота: 374px
PNG с прозрачным фоном
Размер: 70.95 КБ
Ширина: 250px
Высота: 429px
[[*image:pthumb=`w=250`]]
Горизонтальные
Размер: 36.99 КБ
Ширина: 409px
Высота: 250px
Вертикальные
Размер: 12.41 КБ
Ширина: 167px
Высота: 250px
PNG с прозрачным фоном
Размер: 25 КБ
Ширина: 146px
Высота: 250px
[[*image:pthumb=`h=250`]]
Горизонтальные
Размер: 15. 33 КБ
Ширина: 250px
Высота: 153px
Вертикальные
Размер: 12.41 КБ
Ширина: 167px
Высота: 250px
PNG с прозрачным фоном
Размер: 25 КБ
Ширина: 146px
Высота: 250px
[[*image:pthumb=`w=250&h=250`]]
Горизонтальные
Размер: 16.41 КБ
Ширина: 180px
Высота: 250px
Вертикальные
Размер: 13.62 КБ
Ширина: 180px
Высота: 250px
PNG с прозрачным фоном
Размер: 29.92 КБ
Ширина: 180px
Высота: 250px
[[*image:pthumb=`w=180&h=250&zc=1`]]
Горизонтальные
Размер: 22.99 КБ
Ширина: 250px
Высота: 250px
Вертикальные
Размер: 19.46 КБ
Ширина: 250px
Высота: 250px
PNG с прозрачным фоном
Размер: 39.04 КБ
Ширина: 250px
Высота: 250px
[[*image:pthumb=`w=250&zc=1`]]
Горизонтальные
Размер: 14. 51 КБ
Ширина: 245px
Высота: 150px
Вертикальные
Размер: 10.06 КБ
Ширина: 150px
Высота: 224px
PNG с прозрачным фоном
Размер: 25 КБ
Ширина: 146px
Высота: 250px
[[*image:pthumb=`wp=150&hp=250&wl=250&hl=150`]]
Горизонтальные
Размер: 23.77 КБ
Ширина: 250px
Высота: 250px
Вертикальные
Размер: 17.89 КБ
Ширина: 250px
Высота: 250px
PNG с прозрачным фоном
Размер: 41.74 КБ
Ширина: 250px
Высота: 250px
[[*image:pthumb=`w=250&h=250&iar=1`]]
Горизонтальные
Размер: 32.04 КБ
Ширина: 409px
Высота: 250px
Вертикальные
Размер: 10.68 КБ
Ширина: 167px
Высота: 249px
PNG с прозрачным фоном
Размер: 28.34 КБ
Ширина: 146px
Высота: 250px
[[*image:pthumb=`h=250&fltr[]=wmt|webstool.ru|14|*|ffffff|/fonts/arial. ttf|40|5|33|50`]]
Тестирование степени сжатия изображения
Размер: 127.8 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835`]]
(По-умолчанию идет q=75
)
Тестирование степени сжатия изображения
Размер: 283.39 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=95`]]
Размер: 169.84 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=85`]]
Размер: 127.8 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=75`]]
Размер: 105.73 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=65`]]
(Оптимальная компрессия по мнению подслеповатого Google PageSpeed)
Размер: 90.72 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=55`]]
Размер: 79. 55 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=45`]]
Размер: 67.66 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=35`]]
Размер: 53.76 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=25`]]
Размер: 37.55 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=15`]]
Размер: 16.48 КБ
Ширина: 835px
Высота: 511px
[[*image:pthumb=`w=835&q=5`]]
pThumb Resizer и MODx 3 — Дополнения
Pixelstuff
1
Совместим ли модуль изменения размера pThumb с MODx 3? Я получаю такие сообщения об ошибках при каждой попытке изменения размера.
---------------------- [2023-02-02 18:38:46] (ОШИБКА @ /ROOT/core/components/phpthumbof/model/phpthumbof.class.php: 156) [pThumb] Ресурс: 83 || Изображение: assets/images/page-icons/2015-hd-icon.jpg Не удалось кэшировать эскиз в файл по адресу: /ROOT/assets/images-cache/page-icons/2015-hd-icon.da0d3d48.jpg Вывод отладки изменения размера: [0] => Изменение размера v1.0.1 [1] => Использование GD [2] => Входной файл: assets/images/page-icons/2015-hd-icon.jpg [3] => Варианты ввода: 'ш' => '130', 'ч' => '130', 'ф' => 'jpeg' [4] => *** Ошибка *** Невозможно открыть изображения/images/page-icons/2015-hd-icon.jpg ----------------------
полутренированный Гарри
2
pThumb должен работать на MODX 3. Я не знаю о Resizer .
Возможно, попробуйте изменить системную настройку phpthumbof.use_resizer
на No
и посмотреть, будет ли она работать.
пикселейматериал
3
Отключение изменения размера перестало вызывать предыдущие ошибки, хотя теперь оно кажется заметно медленнее на новой странице с десятками миниатюр. Раньше ресайзеру требовалось 2-3 секунды для создания страницы, теперь для ее загрузки требуется около 15 секунд, если ранее не был создан кеш изображений.
И теперь я снова и снова вижу эти ошибки.
(ОШИБКА @ /ROOT/core/cache/includes/elements/modx/revolution/modsnippet/142.include.cache.php: 209) Предупреждение PHP: неопределенная переменная $showLog (ОШИБКА @/ROOT/core/vendor/james-heinrich/phpthumb/phpthumb. class.php: 1587) Предупреждение PHP: file_get_contents(/ROOT/assets/images-cache/2022//phpThumbCacheIMversion.txt): не удалось открыть поток : Данный файл или каталог отсутствует (ОШИБКА @/ROOT/core/vendor/james-heinrich/phpthumb/phpthumb.class.php: 1514) Предупреждение PHP: file_get_contents(/ROOT/assets/images-cache/2022//phpThumbCacheIMcommandlineBase.txt): не удалось открыть поток : Данный файл или каталог отсутствует (ОШИБКА @/ROOT/core/vendor/james-heinrich/phpthumb/phpthumb.class.php: 1492) Предупреждение PHP: file_get_contents(/ROOT/assets/images-cache/2022//phpThumbCacheIMthatConvert.txt): не удалось открыть поток: нет такого файла или каталога
Крисанди
4
Какую версию PHP вы используете? Некоторое время назад я отметил для себя, что Resizer не работает с PHP 8 — ну, по крайней мере, с MODX 3
markh
5
Эти ошибки кажутся мне скорее неправильными путями, чем проблемой совместимости. Убедитесь, что они существуют там, где их пытается найти pthumb, и посмотрите, сможете ли вы отследить источник этой двойной косой черты.
пикселейматериал
6
Крисанди:
Какую версию PHP вы используете? Некоторое время назад я отметил для себя, что Resizer не работает с PHP 8 — ну, по крайней мере, с MODX 3 9.0005
Это PHP 8.0. Вероятно, это проблема с Resizer, поскольку сайт MODx 2.8.4 был на PHP 7.4.
марка:
Эти ошибки кажутся мне скорее неправильными путями, чем проблемой совместимости. Убедитесь, что они существуют там, где их пытается найти pthumb, и посмотрите, сможете ли вы отследить источник этой двойной косой черты.
Двойная косая черта мне тоже показалась подозрительной, но я понятия не имею, что их генерирует. Текстовые файлы не существуют.
Похоже, что миниатюры в кэше присутствуют и правильно связаны на странице. (Примечание: когда Resizer был включен, генерация миниатюр не удалась, и полноразмерное изображение было связано).
Вызовы pthumb такие же, как и раньше, внутри шаблона getResources:
[[!pthumb? &input=`[[+tv.img_1920x1080]]` &options=`&w=150&q=90`]]
В глобальных настройках у меня включен параллельный кеш. Таким образом, базовый каталог изображений составляет активов/изображений 9.0026, а кеш pThumb —
assets/images-cache
Раньше у меня был установлен phpThumb перед его удалением и установкой pThumb.
pThumb 2.3.3-pl | Дополнения для MODX
pT
Назад к Дополнениям
О pThumb
Форк phpThumbOf. pThumb является заменой phpThumbOf и устраняет многие его проблемы, добавляет несколько новых функций и повышает производительность.
Информация
Выпущено
14 июня 2014 г.
Поддерживаемая база данных
MySQL, SQL Server
Лицензия
GPLv2
Поддерживаемые версии
2.2 - текущие
Загрузки
60 336
Инструкции
pThumb использует то же пространство имен, настройки и имя сниппета, что и phpThumbOf, поэтому после его установки любой код, использующий phpThumbOf, будет автоматически использовать новую версию.
Удалите phpThumbOf перед установкой pThumb.
(У вас нет для удаления phpThumbOf в первую очередь, но это делает вещи менее запутанными. Если вы удалите phpThumbOf позже, вам придется переустанавливать pThumb.)
Новое в версии 2.3.3-pl
2.3.3-pl [14.06.2014]
- [#23] Исправить очистку кеша для удаления файлов png и gif из кеша phpthumbof (подсказка Иэна Бриндли) 90 139
2. 3.2-pl [26.05.2014]
- [#20] Исправить ошибку PHP при работе в контексте mgr (внешняя подсказка) )
- Сделать очистку кэша pThumb более выборочной
- Обновить Resizer до 1.0.1-pl
2.3.1-pl [23.03.2014]
- [#18] Улучшена поддержка настроек контекста (http_host и base_url)
- Добавлены параметры для возврата размеров изображения (свойство toPlaceholder и опция dims)
- Обновить Изменение размера до версии 0.5.1-pl
- Несколько небольших исправлений и улучшений
2.3.0-pl [18.01.2014]
- [#3] Добавлена поддержка Amazon S3
- Улучшение структура именования и кэша для удаленных файлы
- [#17] Исправлены пути к файлам при использовании phpThumb в Windows
- Добавлена небольшая оптимизация для phpThumb
2.2.2-pl2 [12.06.2013]
- [#13] Исправьте любые неточные пути, вызванные настройки контекста
- [#14] Исправлена обработка параметра phpThumb fltr
- [#16] Исправлена обработка путей при запуске MODX из подкаталога
2. 2.1-pl [13.11.2013]
- [ #10] Исправьте несовместимость с менеджером кеша и PHP < 5.3
2.2.0-pl [11.10.2013]
Примечание: v2.2 имеет новый алгоритм генерации хэшей для имен файлов кэша. После обновления изображения кэша будут создаваться повторно при доступе.
- Улучшен плагин менеджера кеша; добавить системную настройку Clean Level
- Заменить настройку jpeg_quality на более гибкую глобальную настройку параметров по умолчанию
- Добавить несколько небольших оптимизаций для phpThumb
- Улучшить проверку имени входного файла, обработку угловых случаев с удаленными изображениями
- Обновите Resizer до версии 0.4.1-pl
- [#4] Постарайтесь предотвратить проблемы, когда $_SERVER['DOCUMENT_ROOT'] != MODX_BASE_PATH
- [#5] Соблюдайте соответствующие системные настройки MODX phpThumb
- [#7] Изменить Генерация хэшей, чтобы миниатюры были специфичны для phpThumb или Resizer и переключение между ними возвращает миниатюру, созданную этой библиотекой, без предварительной очистки существующей версии из кеша.
- [#8] Добавьте параметр phpthumbof.cache_url обратно
- [#9] Улучшено сообщение об отладке, когда миниатюра уже кэширована 2.1.0-pl
- Добавить опция «pThumb Cache». Если эта функция включена, кешированные изображения не объединяются в один плоский каталог, а помещаются в кеш в подкаталогах, которые отражают часть пути к исходному изображению. Хэш, добавляемый к именам файлов, также намного короче. Конечный результат: более чистые, более семантические и оптимизированные для SEO URL-адреса изображений. Дополнительные сведения о настройке и включении см. в документации.
- Несколько оптимизаций производительности, в том числе одна при использовании phpThumb.
- Добавить фрагмент pthumb. Это то же самое, что и phpthumbof, только короче 🙂
2.0.0-pl
- Улучшена обработка путей, URL-адресов и удаленных изображений
- [#2] Исправлена настройка new_file_permissions 90 138 Обновить Resizer до v0 . 3.1-pl
- Несколько мелких исправлений ошибок
2.0.0-rc3
- Обновление Resizer до v0.2.0-rc1, теперь это отдельный транспортный пакет.
- [#1] Исправить относительные URL-адреса для удаленных изображений
- Исправление свойств &useResizer и &debug
- Несколько незначительных улучшений скорости и эффективности
2.0.0-rc2
- 901 38 Добавить Resizer v0.1, легкий -весомая современная альтернатива phpThumb. Resizer создан на основе Imagine, поддерживает расширения Gmagick, Imagick и GD и значительно быстрее, чем phpThumb, для операций масштабирования/обрезки. Кроме того, все параметры ZC теперь работают с GD. Включите в настройках системы. Требуется PHP 5.3 или выше.
- Исправлено предупреждение PHP, которое выдавал плагин phpThumbOfCacheManager.
2.0.0-rc1
- Серьезный рефакторинг для повышения эффективности, особенно при многократном использовании на странице или когда изображение уже кэшировано.
- Удаление поддержки Amazon S3. Я не использую и не знаю много об этом, и вместо того, чтобы выпускать полностью непроверенный и, возможно, сломанный код, я удалил его. Если вы хотите, чтобы он был добавлен обратно, и заинтересованы в помощи, пожалуйста, свяжитесь с нами.
- Улучшение удаленной обработки изображений. Оригиналы теперь загружаются в кэш, чтобы значительно ускорить доступ в будущем.
- Улучшение вывода отладки, включая легкий доступ к сообщениям отладки phpThumb, создаваемым при создании эскиза (новое свойство &debug для phpThumbOf).
1.0.0-beta2
- Добавить идентификатор ресурса # в сообщение журнала ошибок, чтобы упростить поиск проблемных образов
1.0.0-beta1
90 008 Первоначальная версия. pThumb решает следующие открытые проблемы phpThumbOf:- [#37] Добавить глобальную настройку качества JPEG по умолчанию phpthumbof.jpeg_quality
- [#46] добавить параметр phpthumbof.