JUImage
v5.19
Juimage-庫的庫,用於用支持WebP和AVIF的拇指。
為Joomla創建大拇指!擴展或獨立使用。
composer require joomla-ua/juimage
然後,您可以稍後使用Composer更新:
composer update
安裝後,您需要需要作曲家的自動加載器:
require_once ( ' vendor/autoload.php ' );
$ config [ ' root_path ' ] = __DIR__ ;
$ config [ ' img_blank ' ] = ' images/logos ' ;
$ juImg = new JUImage Image ( $ config );
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 77 ' ,
' cache ' => ' img '
]);
echo ' <img src=" ' . $ thumb . ' " alt="Apple" width="300" height="100"> ' ;| 全局選項 | 描述 |
|---|---|
$root_path | 您的網站的根路徑。默認定義JPATH_BASE |
$img_blank | 通往默認圖像的路徑。例如,如果找不到圖像,請顯示默認圖像noimage.png 。如果找不到圖像或破壞圖像,請還使用option error_image (轉到選項) |
使用Joomla安裝擴展庫(lib_juimage_v3.xzzip)!擴展管理器。
用於擴展的代碼。
JLoader:: register ( ' JUImage ' , JPATH_LIBRARIES . ' /juimage/JUImage.php ' );
$ juImg = new JUImage ();
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 77 ' ,
' cache ' => ' img '
]);
echo ' <img src=" ' . $ thumb . ' " alt="Apple" width="300"> ' ;或者
require_once ( JPATH_SITE . ' /libraries/juimage/vendor/autoload.php ' );
$ juImg = new JUImage Image ();
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 77 ' ,
' cache ' => ' img '
]);
echo ' <img src=" ' . $ thumb . ' " alt="Apple" width="300"> ' ; <?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 95 ' ,
' webp ' => true
]);
?>
<picture>
<source srcset=" <?php echo $ thumb -> webp ; ?> " type="image/webp">
<img src=" <?php echo $ thumb -> img ; ?> " alt="Apple" width="300" height="100">
</picture>使用GD2 lib進行WebP拇指:
<?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 95 ' ,
' webp ' => true ,
' imagemagick ' => false
]);
?>| WebP命令 | 類型 | 預設 | 描述 |
|---|---|---|---|
| WebP | 布爾 | 錯誤的 | 如果true添加支持WebP映像。對於此選項,請使用標籤<picture> ,請參見示例。 |
AVIF圖像格式(需要PHP 8.1.0)
<?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 95 ' ,
' avif ' => true
]);
?>
<picture>
<source srcset=" <?php echo $ thumb -> avif ; ?> " type="image/avif">
<img src=" <?php echo $ thumb -> img ; ?> " alt="Apple" width="300" height="100">
</picture>| WebP命令 | 類型 | 預設 | 描述 |
|---|---|---|---|
| 阿維夫 | 布爾 | 錯誤的 | 如果true添加支持WebP映像。對於此選項,請使用標籤<picture> 。 AVIF圖像格式(需要PHP 8.1.0) |
<?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 95 ' ,
' avif ' => true ,
' webp ' => true
]);
?>
<picture>
<source srcset=" <?php echo $ thumb -> avif ; ?> " type="image/avif">
<source srcset=" <?php echo $ thumb -> webp ; ?> " type="image/webp">
<img src=" <?php echo $ thumb -> img ; ?> " alt="Apple" width="300" height="100">
</picture>Youtube:
$ thumb = $ juImg -> render ( ' https://www.youtube.com/watch?v=xxxxxxxxxxx ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 '
]);Vimeo:
$ thumb = $ juImg -> render ( ' https://vimeo.com/xxxxxxxxx ' , [
' w ' => ' 300 ' ,
' h ' => ' 100 '
]); <?php
$ thumb = $ juImg -> render ( ' images/sampledata/fruitshop/apple.jpg ' , [
' w ' => ' 300 '
]);
// Image size for thumb
$ size = $ juImg -> size ( $ thumb );
echo ' <img src=" ' . $ thumb . ' " alt="Apple" width=" ' . $ size -> width . ' " height=" ' . $ size -> height . ' "> ' ; 將選項添加到此數組:
[
' w ' => ' 300 ' ,
' h ' => ' 100 ' ,
' q ' => ' 77 ' ,
' cache ' => ' img '
]| 命令 | 描述 |
|---|---|
| 快取 | 縮略圖的文件夾 |
| error_image | 默認圖像的路徑如果未找到或破壞圖像 |
| w | 像素的最大輸出縮略圖寬度 |
| h | 像素的最大輸出縮略圖高度 |
| WP | 肖像圖像的最大寬度 |
| 惠普 | 肖像圖像的最大高度 |
| WL | 景觀圖像的最大寬度 |
| HL | 景觀圖像的最大高度 |
| WS | 正方形圖像的最大寬度 |
| HS | 平方圖像的最大高度 |
| f | 輸出圖像格式(“ jpeg”,“ png”,“ gif”,“ webp”或“ avif”) |
| 問 | JPEG壓縮(1 =最差,95 =最佳,75 =默認值) |
| 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”)。將“ 1”或“ C”設置為“縮放”到中心,或設置為“ t”,“ b”,“ l”,“ r”,“ tl”,“ tl”,“ tr”,“ tr”,“ bl”,“ br”,“ br”,傾斜到頂/左/底部/右圖(Reques fulsemagick for imagemagick for其他值以外的值或“ 1”)或“ 1”)) |
| BG | 背景六角形(默認FFFFFF) |
| 公元前 | 邊界六角形(默認000000) |
| XTO | 僅EXIF縮略圖 - 設置僅提取EXIF縮略圖而不進行任何其他處理 |
| RA | 按角度旋轉:以逆時針為正的旋轉角度,負,順時針方向 |
| ar | 自動旋轉:設置為“ X”以使用相機存儲的EXIF方向。也可以將景觀的“ L”或“ L”設置為“ L”或“ P”或“ P”。 “ L”和“ P”順時針旋轉圖像,“ L”和“ P”逆時針旋轉圖像。 |
| SFN | 源框架編號 - 使用此幀/頁碼進行多幀/多頁源圖像(GIF,TIFF等) |
| aoe | 輸出允許放大-1 = ON,0 = OFF。 “ FAR”和“ IAR”都覆蓋了這一點,並且允許輸出大於輸入) |
| IAR | 忽略縱橫比 - 禁用比例調整大小和拉伸圖像以適合“ H”和“ W”(必須設置兩者)。 (1 = on,0 = off)(覆蓋“遠”) |
| 遠的 | 力縱橫比 - 將以“ W”和“ H”指定的大小創建圖像(必須設置這兩個圖像)。對齊:l =左,r =右,t = top,b =底部,c =中心。如果圖像是景觀或肖像,則BL,BR,TL,TR使用適當的方向。 |
| DPI | 每英寸點 - 輸入DPI設置從矢量圖像格式導入時,例如PDF,WMF等 |
| SIA | 將圖像另存為 - 默認文件名以將生成的圖像保存為。指定基本文件名,將自動添加擴展名(例如:“ .png”) |
| 麥克斯 | 最大字節尺寸 - 輸出質量是自動設置的,可以將縮略圖擬合到“ maxb”字節中(針對JPEG調整了壓縮質量,對PNG和GIF調整了位深度) |
GNU通用公共許可證版本3或更高版本;請參閱許可證
Juimage基於Phpthumb()類(James Heinrich)和快速圖書館圖書館(Marc Alexander)。
感謝JetBrains在其免費的開源許可計劃中讚助一些所有產品包來支持該項目。