圖片處理擴充套件 Grafika 的簡單使用

Grafika是一個PHP影像處理庫，是基於Imagick和GD，可以用於改變圖片大小，剪裁，比較，新增水印等等功能。還有感知雜湊，高階影像過濾，繪製貝塞爾曲線等功能，功能非常強大。優點：縮圖的速度非常快，質量非常高、支援智慧剪裁、很好的支援GIF圖片、5種縮圖模式、影像對比功能、影像高階過濾功能、影像混合、其他影像處理庫支援的API基本都支援

一、 環境需求

• PHP >= 5.3，當然官方推薦php7
• GD庫 >= 2.0版本
• Imagick最好（不強求）>=3.3.0 ， ImageMagick >= 6.5.3

二、 安裝及配置

composer require kosinix/grafika:dev-master --prefer-dist

三、常用 API 及用法

建立編輯器

• Create Editor 編輯器用於處理影像，官方建議使用 Grafika::createEditor() 建立 ，Grafika 會自動選擇可用的最佳編輯器（將檢查Imagick是否可用，如果沒有就會使用GD）

 // 匯入擴充套件包
use Grafika\Grafika;

// 建立最佳可用編輯器
$editor = Grafika::createEditor(); 

• Imagick Editor() 當然也可直接使用 Imagick 類庫

use Grafika\Imagick\Editor;

// 建立 Imagick 編輯器
$editor = new Editor(); 

注意：在使用 Imagick 編輯器時因為某些PHP安裝預設情況下沒有Imagick編輯器，需要新增一些安全檢查：

use Grafika\Imagick\Editor;

$editor = new Editor(); 

// 安全檢查
if( $editor->isAvailable() ) {
     //  ……
}

• GD Editor 也可直接使用GD庫，也有些情況可能不支援，注意檢查

use Grafika\Gd\Editor;
//  ……
// 建立 GD 編輯器
$editor = new Editor();

// 安全檢查
if( $editor->isAvailable() ) {
   //  ……
}

建立影像，Grafika允許使用4種方式建立一個待處理的影像

• 編輯器開啟

use Grafika\Grafika;
 //  ……
$editor = Grafika::createEditor();
$editor->open( $image, 'images/foo.jpg');

• 使用靜態方法開啟圖片

use Grafika\Grafika;
//  ……
$editor = Grafika::createEditor();
$image = Grafika::createImage('images/foo.jpg'); 

• 建立一個空白的畫布

use Grafika\Grafika;
 //  ……
$image = Grafika::createBlankImage(100,100);

• 從已有圖片複製一個副本

$copy = clone $image;

縮放

• resizeFit() 等比例縮放，調整影像大小以適應給定的寬度和高度，重新調整大小的影像不會超過給定的尺寸，如果要保留寬高比，則此選項非常有用

resizeFit ( ImageInterface &$image, int $newWidth, int $newHeight ): EditorInterface 

use Grafika\Grafika;
//  ……
// 開啟影像
$editor->open( $image, "images/foo.jpg" );
// 將影像調整大小
$editor->resizeFit( $image, 200, 200 ); 
// 儲存
$editor->save( $image, "images/testResizeFit.jpg"); 

• resizeExact() 固定尺寸縮放，調整影像大小以精確尺寸，會忽略寬高比。

resizeExact ( ImageInterface &$image, int $newWidth, int $newHeight ): EditorInterface 

use Grafika\Grafika;
//  ……
$editor->open( $image, "images/foo.jpg" );
$editor->resizeExact( $image, 200, 200 );
$editor->save( $image, "images/testResizeExact.jpg");

resizeExactWidth() 等寬縮放，高度自動計算
resizeExactHeight() 等高縮放，寬度自動計算

• resizeFill() 縮放裁剪，調整影像大小以填充給定維度中的所有空間，多餘的部分被裁切。

resizeFill ( ImageInterface &$image, int $newWidth, int $newHeight ): EditorInterface

use Grafika\Grafika;
//  ……
$editor->open( $image, "images/foo.jpg" );
$editor->resizeFill( $image, 200, 200 );
$editor->save( $image, "images/testResizeFill.jpg");

$editor = Grafika::createEditor();
$editor->open( $image, "images/foo.png" );
$editor->resizeFit($image, 200, 200);  // 等比縮放
//$editor->resizeExact($image, 200, 200);  // 固定尺寸縮放
//$editor->resizeFill($image, 200, 200);  // 縮放裁剪
header('Content-type: image/png');
$image->blob('PNG');

• compare() 圖片相似度對比，返回值越接近於0表示圖片越相似，如果數字在0-10範圍內那麼圖片都可能相似，果數字大於10那麼可能就完全不同。

compare(string|ImageInterface $image1, string|ImageInterface $image2): int 

use Grafika\Grafika;
//  ……
$editor = Grafika::createEditor();
$result = $editor->compare('images/foo-gray.png' , 'images/foo.png');

• blend()圖片合併，將兩張影像合併，第一張影像作為基礎，第二張影像位於基礎之上，支援多種混合模式。

blend(ImageInterface &$image1, ImageInterface $image2, string $type = 'normal', float $opacity = 1, string $position = 'top-left', int $offsetX = 0, int $offsetY = 0): EditorInterface 

use Grafika\Grafika;
//  ……
$editor = Grafika::createEditor();
$editor->open($image1 , 'images/foo-h.jpg');
$editor->open($image2 , 'images/foo.jpg');
$editor->blend ( $image1, $image2 , 'normal', 0.9, 'center');
$editor->save($image1,'images/foo-blend.jpg');

• rotate()影像旋轉

rotate(ImageInterface &$image, int $angle, Color|null $color = null): EditorInterface 

use Grafika\Grafika;
use Grafika\Color;
 //  ……
$editor = Grafika::createEditor();
$editor->open($image , 'images/foo.png');
$editor->rotate($image ,'45',new Color('#ff0000'));
header('Content-type: image/png');
$image->blob('PNG');

• text() 圖片寫文字

text (ImageInterface &$image, string $text, int $size = 12, int $x = 0, int $y = 12, Color $color = null, string $font = '', int $angle = 0): EditorInterface 

use Grafika\Grafika;
use Grafika\Color;
//  ……
$editor = Grafika::createEditor();
$editor->open($image , 'images/foo.jpg');
$editor->text($image ,'foo',30,200,100,new Color("#000000"),'',45);
$editor->save($image,'images/foo-text.jpg');

$editor = Grafika::createEditor();
$editor->open($image , 'images/foo.png');
$editor->text($image, '測試文字', 24, 50, 50, new Color("#000000"), 'images/Alibaba-PuHuiTi-Light.ttf',90);
header('Content-type: image/png');
$image->blob('PNG');

*getWidth() 獲取圖片寬度

getWidth (): int 

use Grafika\Grafika;
//  ……
$editor = Grafika::createEditor();
$editor->open( $image, 'images/foo.jpg' );
$image->getWidth();

getHeight() 獲取高度 、getImageFile() 獲取名稱 getType()獲取型別isAnimated是否是動圖

• 繪製直線

$editor = Grafika::createEditor();
$editor->open($image , 'images/foo.jpg');
// 建立繪製物件，同時檢測可用的編輯器
$drawingObject = Grafika::createDrawingObject('Line', [0, 0], [200, 200], 1, new Color('#FF0000'));
// 在影像上繪製上面建立的繪製物件
$editor->draw( $image, $drawingObject ); 
header('Content-type: image/png');
$image->blob('PNG');

• 繪製橢圓

// ……
$drawingObject = Grafika::createDrawingObject('Ellipse', 100, 50, [50, 75], 1, new Color('#000000'), new Color('#FF0000'));
$editor->draw( $image, $drawingObject ); 

• 繪製矩形

// 沒有邊框的85x50綠色矩形
// ……
$drawingObject = Grafika::createDrawingObject('Rectangle', 85, 50,[105, 70], 0, null, new Color('#00FF00'));
$editor->draw( $image,drawingObject );

$editor = Grafika::createEditor();
$editor->open($image , 'images/foo.png');
// 繪製直線
$drawingObject = Grafika::createDrawingObject('Line', [5, 145], [190, 145], 1, new Color('#FF0000'));
// 繪製橢圓
//$drawingObject = Grafika::createDrawingObject('Ellipse', 180, 70, [10, 10], 1, new Color('#000000'), new Color('#FF0000'));
// 繪製矩形
//$drawingObject = Grafika::createDrawingObject('Rectangle', 180, 70,[10, 10], 0, null, new Color('#FF0000'));
$editor->draw($image, $drawingObject);
header('Content-type: image/png');
$image->blob('PNG');

• 繪製多邊形

$drawingObject = Grafika::createDrawingObject('Polygon', [[100, 0], [140, 50], [100, 100], [60, 50]], 1, NULL, new Color('#FF0000'))
$editor->draw( $image,drawingObject );

• blob() 影像二進位制輸出

blob(string|ImageType $type): void 

use Grafika\Grafika;
//  ……
$editor = Grafika::createEditor();
$editor->open( $image, 'images/foo.jpg' ); 
header('Content-type: image/png'); // 設定瀏覽器輸出的型別是圖片
$image->blob('PNG'); 

• save() 儲存

save(ImageInterface $image, string $file, null|string $type = null, null|string $quality = null, bool $interlace = false, int $permission = 0755): EditorInterface 

$editor->open($image, 'images/foo.png');
$editor->save($image, 'images/output.png', null, null, false, 0777);

本作品採用《CC 協議》，轉載必須註明作者和本文連結