- Главная
- Документация
- phpthumb
- 106792
- Август 2014
phpthumb Создание эскизов изображений
Формат: путь к изображению
Значение по умолчанию: assets/snippets/phpthumb/noimage.png
Примечание:
Пример:
Значение по умолчанию: assets/snippets/phpthumb/noimage.png
Примечание:
Пример:
&input=``
Формат:
Значение по умолчанию: f=jpg,q=96
Примечание:
Пример:
Значение по умолчанию: 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 "♪" 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