phpthumb: Опции

1356

phpthumb: Опции

ОпцияОписание
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> где <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> где
<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> где
<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> где <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> где <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> где <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> где
<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. где (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> где
<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