phpthumb
Web Site
Перейти
phpthumb
Readme
Перейти
phpthumb
Demo
Перейти

Параметры

Формат: путь к изображению
Значение по умолчанию: assets/snippets/phpthumb/noimage.png
Примечание:
Пример:
&input=``
Формат:
Значение по умолчанию: f=jpg,q=96
Примечание:
Пример:
&options=`w=150,h=76,far=C,bg=FFFFFF`

Опции

ОпцияОписание
w максимальная ширина миниатюры
h максимальная высота миниатюры
wp максимальная ширина миниатюры для вертикальных изображений
hp максимальная высота миниатюры для вертикальных изображений
wl максимальная ширина миниатюры для горизонтальных изображений
hl максимальная высота миниатюры для горизонтальных изображений
ws максимальная ширина миниатюры для квадратных изображений
hs максимальная высота миниатюры для квадратных изображений
f выходной Формат изображения ("jpeg", "png", "gif")
q степень сжатия (1=худшее, 95=лучшее)
sx левая сторона исходного прямоугольника (по умолчанию = 0) (значения 0 < sx < 1)
sy верхняя сторона исходного прямоугольника (по умолчанию = 0)(значения 0 < sy < 1)
sw ширина исходного прямоугольника (по умолчанию = fullwidth)(значения 0 < sw < 1)
sh высота исходного прямоугольника (по умолчанию = fullheight)(значения 0 < sh < 1)
zc автоматически обрезать лишнее по большей стороне так чтобы изображение заполнило заданные размеры (требует "w" и "h", отменяется опциями "iar", "far"). Значение "1" или "C" - обрезать от центра, значения "T", "B", "L", "R", "TL", "TR", "BL", "BR" - сверху/снизу/слева/справа и т.д.
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> где <a> это сумма (по умолчанию = 80, диапазон 0-255), <r> это радиус (по умолчанию = 0.5, диапазон 0.0-10.0), <t> это порог (по умолчанию = 3, диапазон 0-50)

blur

размытие fltr[]=blur|<radius> где (0 < <radius> < 25) (по умолчанию = 1)

gblr

гауссово размытие fltr[]=gblr

sblr

избирательное размытие fltr[]=gblr

smth

Smooth fltr[]=smth|<value> где <value> is the weighting value for the matrix (диапазон -10 до 10, по умолчанию 6)

lvl

уровни fltr[]=lvl|<channel>|<method>|<threshold где <channel> может быть одним из 'r', 'g', 'b', 'a' (для Red, Green, Blue, Alpha соответственно), или '*' для всех RGB каналов (по умолчанию) основанных на шкале серого среднего

wb

баланс белого fltr[]=wb|<c> where <c> is the target hex color to white balance on, this color is what "should be" white, or light gray. The filter attempts to maintain brightness so any gray color can theoretically be used. If <c> is omitted the filter guesses based on brightest pixels in each of RGB OR <c> can be the percent of white clipping used to calculate auto-white-balance (default = 0.1%).
NOTE: "wb" in default settings already gives an effect similar to "lvl", there is usually no need to use "lvl" if "wb" is already used.

hist

гистограмма fltr[]=hist|<b>|<c>|<w>|<h>|<a>|<o>|<x>|<y> Where
        <b> is the color band(s) to display, from back to front (one or more of "rgba*" for Red Green Blue Alpha and Grayscale respectively);
        <c> is a semicolon-seperated list of hex colors to use for each graph band (defaults to FF0000, 00FF00, 0000FF, 999999, FFFFFF respectively);
        <w> and <h> are the width and height of the overlaid histogram in pixels, or if <= 1 then percentage of source image width/height;
        <a> is the alignment (same as for "wmi" and "wmt");
        <o> is opacity from 0 (transparent) to 100 (opaque) (requires PHP v4.3.2, otherwise 100% opaque);
        <x> and <y> are the edge margin in pixels (or percent if 0 < (x|y) < 1)

over

OVERlay/underlay image overlays an image on the thumbnail, or overlays the thumbnail on another image (to create a picture frame for example) fltr[]=over|<i>|<u>|<m>|<o> where
        <i> is the image filename;
        <u> is "0" (default) for overlay the image on top of the thumbnail or "1" for overlay the thumbnail on top of the image;
        <m> is the margin - can be absolute pixels, or if < 1 is a percentage of the thumbnail size [must be < 0.5] (default is 0 for overlay and 10% for underlay);
        <o> is opacity (0 = transparent, 100 = opaque) (requires PHP v4.3.2, otherwise 100% opaque);

wmi

водяной знак в виде изображения fltr[]=wmi|<f>|<a>|<o>|<x>|<y>|<r> где
        <f> накладываемое изображение;
        <a> выравнивание (один из BR, BL, TR, TL, C, R, L, T, B, *) где B=низ, T=верх, L=слева, R=справа, C=сентер, *=плитка)
             *или*
             абсолютная позиция в пикселях (от верхнего левого угла холста к верхнему левому углу наложения) в формате {xoffset}x{yoffset} (например: "10x20")
             примечание: это центральное положение изображения, если <x> и <y> установлены
        <o> прозрачность от 0 (прозрачный) до 100 (непрозрачный);
        <x> и <y> отступ от края (и между плиткой) в пикселях (или процентах если 0 < (x|y) < 1)
             *или*
             если <a> в формате абсолютного позиционирования, то <x> и <y> представляют максимальную ширину и высоту водяного знака и изображение масштабируется, чтобы поместиться внутри
        <r> угол поворота водяного знака

wmt

текстовый водяной знак fltr[]=wmt|<t>|<s>|<a>|<c>|<f>|<o>|<m>|<n>|<b>|<O>|<x> где:
        <t> текст используемый в качестве водяного знака;
             URLencoded Unicode HTMLentities must be used for characters beyond chr(127). For example, the "eighth note" character (U+266A) is represented as "&#9834;" and then urlencoded to "%26%239834%3B"
             Any instance of metacharacters will be replacedwith their calculated value. В данный момент поддерживаются:
               ^Fb = исходное изображение файла в байтах
               ^Fk = исходное изображение файла в килобайтах
               ^Fm = исходное изображение файла в мегабайтах
               ^X  = ширина изображения в пикселях
               ^Y  = высота изображения в пикселях
               ^x  = ширина пиктограммы в пикселях
               ^y  = высота пиктограммы в пикселях
               ^^  = the character ^
        <s> размер шрифта (1-5 for built-in font, or point size for TrueType fonts);
        <a> выравнивание (один из BR, BL, TR, TL, C, R, L, T, B, * где B=внизу, T=вверху, L=слева, R=справа, C=центр, *=плитка);
             примечание: * не работает для встроенных шрифтов "wmt"
             *или*
             абсолютное положение в пикселях (от верхнего левого угла холста к верхнему левому углу наложения) в формате {xoffset}x{yoffset} (например: "10x20")
        <c> цвет текста;
        <f> имя файла TTF (опционально, если опустить встроенный шрифт будет использоваться);
        <o> прозрачность от 0 (прозрачный) до 100 (непрозрачный);
        <m> отступ от края (и между плиткой) в процентах;
        <n> угол
        <b> цвет фона;
        <O> прозрачность фона от 0 (прозрачный) до 100 (непрозрачный);
        <x> направление распространения фона (либо 'x' либо 'y' (или оба, но так будет закрыто все изображение))
            Note: works with TTF fonts only, not built-in

flip

сдвиг изображения по оси X или Y fltr[]=flip|x или fltr[]=flip|y

ric

скруглить углы изображения  (для вывода прозрачных изображений PNG) fltr[]=ric|<x>|<y> где <x> горизонтальный радиус кривой а <y> вертикальный радиус

elip

похоже на скругление углов, но более эксримальное fltr[]=elip

mask

fltr[]=mask|filename.png|<i> greyscale values of mask are applied as the alpha channel to the main image. White is opaque, black is transparent, unless the <i> (invert) parameter is set to 1 in which case black is opaque and white is transparent

bvl

BeVeL fltr[]=bvl|<w>|<c1>|<c2> where <w> is the bevel width, <c1> is the hex color for the top and left shading, <c2> is the hex color for the bottom and right shading

bord

бордюр fltr[]=bord|<w>|<rx>|<ry>|<c> где <w> ширина в пикселях, <rx> и <ry> горизонтальные и вертикальные радиусы для закругленных углов, и <c> цвет бордюра

fram

рамка наподобие "bord" но более настраиваемая fltr[]=fram|<w1>|<w2>|<c1>|<c2>|<c3> where <w1> is the width of the main border, <w2> is the width of each side of the bevel part, <c1> is the hex color of the main border, <c2> is the highlight bevel color, <c3> is the shadow bevel color

drop

тень fltr[]=drop|<d>|<w>|<clr>|<a>|<o> where <d> is distance from image to shadow, <w> is width of shadow fade (not yet implemented), <clr> is the hex color of the shadow, <a> is the angle of the shadow (default=225), <o> is opacity (0=transparent, 100=opaque, default=100) (not yet implemented)

crop

обрезка изображения fltr[]=crop|<l>|<r>|<t>|<b> where
        <l> is the number of pixels to crop from the left side of the resized image;
        <r>, <t>, <b> are for right, top and bottom respectively. Where (0 < x < 1) the value will be used as a percentage of width/height. Left and top crops take precedence over right and bottom values. Cropping will be limited such that at least 1 pixel of width and height always remains.

rot

поворот fltr[]=rot|<a>|<b> где
        <a> угол поворота в градусах;
        <b> цвет фона. Подобно "ra" но применяется после обработки других фильтров, поэтому вы можете вращать другие фильтры.

size

изменение размера fltr[]=size|<x>|<y>|<s> где
        <x> горизонтальный размер в пикселях,
        <y> вертикальный размер в пикселях,
        <s> растянуть (если = 1) или изменить размер пропорционально (0, по умолчанию) <x> и <y> будут интерпретироваться как процент от текущего размера изображения если (0 < X < 1)
         Примечание: не используйте этот фильтр без необходимости. Именно и только в случаях, когда к другим фильтры необходимо применить абсолютное позиционирование на основе исходного изображения и полученное изображение должно быть изменено после применения других фильтров. Этот фильтр является менее эффективным, чем стандартные процедуры изменения размера.

stc

Source Transparent Color fltr[]=stc|<c>|<n>|<x> where
        <c> is the hex color of the target color to be made transparent;
        <n> is the minimum threshold in percent (all pixels within <n>% of the target color will be 100% transparent, default <n>=5);
        <x> is the maximum threshold in percent (all pixels more than <x>% from the target color will be 100% opaque, default <x>=10); pixels between the two thresholds will be partially transparent.
md5s MD5-хэш исходного изображения
xto EXIF Thumbnail Only - set to only extract EXIF thumbnail and not do any additional processing
ra Поворот на угол: угол поворота в градусах положительный = против часовой стрелки, отрицательный = по часовой стрелке
ar Auto Rotate: set to "x" to use EXIF orientation stored by camera. Can also be set to "l" or "L" for landscape, or "p" or "P" for portrait. "l" and "P" rotate the image clockwise, "L" and "p" rotate the image counter-clockwise.
sfn Source Frame Number - use this frame/page number for multi-frame/multi-page source images (GIF, TIFF, etc)
aoe Output Allow Enlarging - override the setting for $CONFIG['output_allow_enlarging'] (1=on, 0=off) ("far" and "iar" both override this and allow output larger than input)
iar отключить пропорциональное изменение изображения и растянуть его до "h" и "w" (которые должны быть заданы).  (1=включить, 0=выключить)  (отменяет "far")
far пропорциональное изменение изображения - изображение будет пропорционально изменено до указанных в "w" и "h" размеров, которые должны быть установлены. Выравнивание: L=слева,R=справа,T=верх,B=низ,C=по центру, а также BL,BR,TL,TR
dpi Dots Per Inch - input DPI setting when importing from vector image format such as PDF, WMF, etc
sia Save Image As - default filename to save generated image as. Specify the base filename, the extension (eg: ".png") will be automatically added
maxb MAXimum Byte size - output quality is auto-set to fit thumbnail into "maxb" bytes  (compression quality is adjusted for JPEG, bit depth is adjusted for PNG and GIF)
down filename to save image to. If this is set the browser will prompt to save to this filename rather than display the image

Примеры

Изменение размера

Исходное изображение в 600х800 пикселей изменяем в 200х200 пикселей с помощью опций zc, far и iar

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200`]]">    
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,far=C,bg=e2e2e2`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,iar=1`]]">

Прозрачность

Исходное изображение в 600х800 пикселей, где вместо неба прозрачный фон, формат изображения png. Преобразуем в миниатюру в 200х200 пикселей с сохранением прозрачности

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb4.png` &options=`w=200,h=200,f=png`]]">    

Степень сжатия

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,far=C,bg=e2e2e2,q=1`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,far=C,bg=e2e2e2,q=50`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,far=C,bg=e2e2e2,q=95`]]">

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

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,ra=45`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,ra=-45`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,ra=90`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,ra=180`]]">

Изменение яркости

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=brit|-255`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=brit|-25`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=brit|25`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=brit|255`]]">

Изменение контрастности

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=cont|-255`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=cont|-25`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=cont|25`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=cont|255`]]">

Гамма-коррекция

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=gam|0.01`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=gam|1.0`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=gam|5.0`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=gam|10`]]">

Насыщенность

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=sat|0`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=sat|-10`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=sat|-50`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=sat|-100`]]">

Водяные знаки

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=wmi|assets/img/water.png|BR|50|5|5`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=wmi|assets/img/water.png|C|50`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=wmi|assets/img/water.png|*|50|5|5`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=wmi|assets/img/water.png|C|50|||45`]]">

Скругление углов

<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=ric|15|15`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=ric|50|50`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=ric|100|100`]]">
<img alt="" src="[[phpthumb? &input=`assets/img/phpthumb1.jpg` &options=`w=200,h=200,zc=C,fltr[]=ric|50|15`]]">

Поделитесь ссылкой

Статистика

Яндекс цитирования
© 2011 - 2023 Школа MODX
Напишите нам в Telegram