SimpleImageダウンロード - SimpleImageソースコードのダウンロード

SimpleImage

その他のカテゴリー

4.2.1

ダウンロード

シンプルイメージ

画像の操作をできるだけ簡単にする PHP クラス。

Cory LaViska によって開発および保守されています。

このプロジェクトで PHP 画像操作をもう一度気に入っていただけましたら、開発をサポートするために私をスポンサーすることをご検討ください。

概要

 <?php
try {
  // Create a new SimpleImage object
  $ image = new  claviska  SimpleImage ();

  // Magic ! 
  $ image
    -> fromFile ( ' image.jpg ' )                     // load image . jpg
    -> autoOrient ()                              // adjust orientation based on exif data
    -> resize ( 320 , 200 )                          // resize to 320 x200 pixels
    -> flip ( ' x ' )                                 // flip horizontally
    -> colorize ( ' DarkBlue ' )                      // tint dark blue
    -> border ( ' black ' , 10 )                       // add a 10 pixel black border
    -> overlay ( ' watermark.png ' , ' bottom right ' )  // add a watermark image
    -> toFile ( ' new-image.png ' , ' image/png ' )      // convert to PNG and save a copy to new-image . png
    -> toScreen ();                               // output to the screen

  // And much more ! 
} catch ( Exception $ err ) {
  // Handle errors
  echo $ err -> getMessage ();
}

要件

PHP8.0以上
GD拡張

特徴

GIF、JPEG、PNG、WEBP、BMP、AVIF 形式の読み取り、書き込み、変換をサポートします。
ファイル、データ URI、画像文字列の読み取りと書き込みを行います。
操作: トリミング、サイズ変更、オーバーレイ/透かし、TTF テキストの追加
描画: 円弧、境界線、点、楕円、線、多角形、長方形、角丸長方形
フィルタ: ぼかし、明るくする、色付け、コントラスト、暗くする、彩度を下げる、エッジ検出、エンボス、反転、不透明度、ピクセル化、セピア、シャープ、スケッチ
ユーティリティ: 色調整、色を暗く/明るくする、色の抽出
プロパティ: exif データ、高さ/幅、MIME タイプ、向き
カラー引数は、任意の CSS カラー (例: LightBlue )、16 進カラー、または RGB(A) 配列として渡すことができます。
アルファ透過のサポート (GIF、PNG、WEBP、AVIF)
連鎖可能なメソッド
例外を使用する
Composer を使用してロードするか、手動でロードします (1 つのファイルのみ)
セマンティックバージョニング

インストール

Composer を使用してインストールします。

 composer require claviska/simpleimage

または、ライブラリを手動で含めます。

 <?php
require ' src/claviska/SimpleImage.php ' ;

について

SimpleImage は Cory LaViska によって開発および保守されています。著作権 A Beautiful Site, LLC.

特に商用アプリケーションで SimpleImage の使用を楽しんでいる場合は、その開発をサポートするために私をスポンサーすることを検討してください。

ありがとう！

ライセンス

MITライセンスに基づいてライセンスされています。

API

凄さの順番：

画像をロードする
画像を操作する
画像の保存・出力

API のヒント:

アスタリスクは必須の引数を示します。
SimpleImage オブジェクトを返すメソッドはチェーン可能です。
ファイルまたはデータ URI をコンストラクターに渡すと、 fromFileまたはfromDataUri呼び出しを回避できます。
静的メソッドは$image::methodName()またはclaviskaSimpleImage::methodName()を使用して呼び出すことができます。
色には、CSS カラー (例: white )、16 進文字列 (例: '#ffffff')、または RGBA 配列を指定できます。
CSS カラーまたは 16 進文字列を渡すときに、透明度をnormalizeColorにパイプできます: white|0.25

ローダー

`fromDataUri($uri)`

データ URI から画像をロードします。

$uri * (文字列) - データ URI。

SimpleImage オブジェクトを返します。

`fromFile($file)`

ファイルから画像を読み込みます。

$file * (文字列) - ロードする画像ファイル。

SimpleImage オブジェクトを返します。

`fromNew($width, $height, $color)`

新しいイメージを作成します。

$width * (int) - 画像の幅。
$height * (int) - 画像の高さ。
$color (string|array) - 新しい画像のオプションの塗りつぶし色 (デフォルトは「透明」)。

SimpleImage オブジェクトを返します。

`fromString($string)`

文字列から新しい画像を作成します。

$string * (string) - 文字列としての生の画像データ。例：
```
 $string = file_get_contents('image.jpg');
```

SimpleImage オブジェクトを返します。

節約者

`toDataUri($mimeType, $options)`

データ URI を生成します。

$mimeType (文字列) - MIME タイプとして出力する画像形式 (デフォルトは元の MIME タイプ)。
$options (array|int) - オプションの配列またはパーセントで表した画質 (デフォルトは 100)。

データ URI を含む文字列を返します。

`toDownload($filename, $mimeType, $options)`

イメージをクライアントマシンに強制的にダウンロードします。出力が画面に送信される前に呼び出す必要があります。

$filename * (文字列) - クライアントに送信するファイル名 (パスなし) (例: 'image.jpeg')。
$mimeType (文字列) - MIME タイプとして出力する画像形式 (デフォルトは元の MIME タイプ)。
$options (array|int) - オプションの配列またはパーセントで表した画質 (デフォルトは 100)。

SimpleImage オブジェクトを返します。

`toFile($file, $mimeType, $options)`

画像をファイルに書き込みます。

$mimeType (文字列) - MIME タイプとして出力する画像形式 (デフォルトは元の MIME タイプ)。
$options (array|int) - オプションの配列またはパーセントで表した画質 (デフォルトは 100)。

SimpleImage オブジェクトを返します。

`toScreen($mimeType, $options)`

画像を画面に出力します。出力が画面に送信される前に呼び出す必要があります。

$mimeType (文字列) - MIME タイプとして出力する画像形式 (デフォルトは元の MIME タイプ)。
$options (array|int) - オプションの配列またはパーセントで表した画質 (デフォルトは 100)。

SimpleImage オブジェクトを返します。

`toString($mimeType, $options)`

画像文字列を生成します。

$mimeType (文字列) - MIME タイプとして出力する画像形式 (デフォルトは元の MIME タイプ)。
$options (array|int) - オプションの配列またはパーセントで表した画質 (デフォルトは 100)。

SimpleImage オブジェクトを返します。

`generate($mimeType, $options)`

画像を生成します。

$mimeType (文字列) - MIME タイプとして出力する画像形式 (デフォルトは元の MIME タイプ)。
$options (array|int) - オプションの配列またはパーセントで表した画質 (デフォルトは 100)。

配列を返します: [mimeType, data]

オプション配列

最後の関数パラメーターとして品質を整数として指定する代わりに、連想配列を使用して対象の Mime タイプに応じてさまざまなオプションを設定することもできます。

 $ image -> toFile ( $ file , ' image/avif ' , [
    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,

    // AVIF ( default - 1 which is 6 )
    // range of slow and small file 0 to 10 fast but big file
    ' speed ' => - 1 ,
]);

 $ image -> toFile ( $ file , ' image/bmp ' , [
    // BMP : boolean ( default true )
    ' compression ' => true ,

    // BMP , JPG ( default null , keep the same )
    ' interlace ' => null ,
]);

 $ image -> toFile ( $ file , ' image/gif ' , [
    // GIF , PNG ( default true )
    ' alpha ' => true ,
]);

 $ image -> toFile ( $ file , ' image/jpeg ' , [
    // BMP , JPG ( default null , keep the same )
    ' interlace ' => null ,

    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,
]);

 $ image -> toFile ( $ file , ' image/png ' , [
    // GIF , PNG ( default true )
    ' alpha ' => true ,

    // PNG : 0 - 10 , defaults to zlib ( default 6 )
    ' compression ' => - 1 ,

    // PNG ( default - 1 )
    ' filters ' => - 1 ,

    // has no effect on PNG images , since the format is lossless
    // ' quality' = > 100 ,
]);

 $ image -> toFile ( $ file , ' image/webp ' , [
    // JPG , WEBP , AVIF ( default 100 )
    ' quality ' => 100 ,
]);

公共事業

`getAspectRatio()`

画像の現在のアスペクト比を取得します。

アスペクト比を浮動小数点として返します。

`getExif()`

画像のexifデータを取得します。

exif データの配列を返すか、データが利用できない場合は null を返します。

`getHeight()`

画像の現在の高さを取得します。

高さを整数として返します。

`getMimeType()`

ロードされた画像の MIME タイプを取得します。

MIME タイプの文字列を返します。

`getOrientation()`

画像の現在の方向を取得します。

文字列を返します: 'landscape'、'portrait'、または 'square'

`getResolution()`

画像の現在の解像度を DPI で取得します。

整数の配列を返します: [0 => 96, 1 => 96]

`getWidth()`

画像の現在の幅を取得します。

幅を整数として返します。

`hasImage()`

SimpleImage オブジェクトが画像をロードしたかどうかを確認します。

ブール値を返します。

`reset()`

画像リソースを破棄します。

SimpleImage オブジェクトを返します。

操作

`autoOrient()`

exif データに基づいて向きが正しくなるように画像を回転します。 exif データを持たない画像に対してこのメソッドを呼び出しても安全です (変更は行われません)。 SimpleImage オブジェクトを返します。

`bestFit($maxWidth, $maxHeight)`

特定の幅と高さに収まるように画像を比例的にサイズ変更します。

$maxWidth * (int) - 画像の最大幅。
$maxHeight * (int) - 画像の最大高さ。

SimpleImage オブジェクトを返します。

`crop($x1, $y1, $x2, $y2)`

画像をトリミングします。

$x1 - 左上の x 座標。
$y1 - 左上の y 座標。
$x2 - 右下の x 座標。
$y2 - 右下の x 座標。

SimpleImage オブジェクトを返します。

`fitToHeight($height)` (非推奨)

画像を特定の高さに比例してサイズ変更します。

このメソッドはバージョン 3.2.2 で非推奨となり、バージョン 4.0 で削除される予定です。代わりに、 resize(null, $height)使用してください。

$height * (int) - 画像のサイズを変更する高さ。

SimpleImage オブジェクトを返します。

`fitToWidth($width)` (非推奨)

画像を特定の幅に比例してサイズ変更します。

このメソッドはバージョン 3.2.2 で非推奨となり、バージョン 4.0 で削除される予定です。代わりに、 resize($width, null)を使用してください。

$width * (int) - 画像のサイズを変更する幅。

SimpleImage オブジェクトを返します。

`flip($direction)`

画像を水平または垂直に反転します。

$direction * (文字列) - 反転する方向: x|y|both

SimpleImage オブジェクトを返します。

`maxColors($max, $dither)`

画像を最大色数まで減色します。

$max * (int) - 使用する色の最大数。
$dither (bool) - ディザリング効果を使用するかどうか (デフォルトは true)。

SimpleImage オブジェクトを返します。

`overlay($overlay, $anchor, $opacity, $xOffset, $yOffset)`

現在の画像の上に画像を配置します。

$overlay * (string|SimpleImage) - オーバーレイする画像。これは、ファイル名、データ URI、または SimpleImage オブジェクトです。
$anchor (文字列) - アンカーポイント: 'center'、'top'、'bottom'、'left'、'right'、'top left'、'top right'、'bottom left'、'bottom right' (デフォルトは「中央」)
$opacity (float) - オーバーレイの不透明度レベル 0 ～ 1 (デフォルトは 1)。
$xOffset (int) - ピクセル単位の水平オフセット (デフォルトは 0)。
$yOffset (int) - ピクセル単位の垂直オフセット (デフォルトは 0)。
$calculateOffsetFromEdge (bool) - 画像のエッジを参照してオフセットを計算します。 $xOffset と $yOffset は、センターアンカーには影響しません。 (デフォルトは false)。

SimpleImage オブジェクトを返します。

`resize($width, $height)`

画像のサイズを指定した寸法に変更します。寸法が 1 つだけ指定されている場合、画像は比例してサイズ変更されます。

$width * (int) - 新しい画像の幅。
$height * (int) - 新しい画像の高さ。

SimpleImage オブジェクトを返します。

`resolution($res_x, $res_y)`

画像の解像度（DPI）を変更します。

$res_x * (int) - DPI 単位の水平解像度。
$res_y (int) - DPI 単位の垂直解像度。

SimpleImage オブジェクトを返します。

`rotate($angle, $backgroundColor)`

画像を回転します。

$angle * (int) - 回転角度 (-360 ～ 360)。
$backgroundColor (string|array) - 回転後にカバーされていないゾーン領域に使用する背景色 (デフォルトは「透明」)。

SimpleImage オブジェクトを返します。

`text($text, $options, &$boundary)`

画像にテキストを追加します。

$text* (文字列) - 必要なテキスト。
$options (配列) - オプションの配列。
- fontFile * (文字列) - 使用する TrueType (または互換性のある) フォントファイル。
- size (int) - ピクセル単位のフォントのサイズ (デフォルトは 12)。
- color (文字列|配列) - テキストの色 (デフォルトは黒)。
- anchor (文字列) - アンカーポイント: 'center'、'top'、'bottom'、'left'、'right'、'top left'、'top right'、'bottom left'、'bottom right' (デフォルト) '中心'）。
- xOffset (int) - ピクセル単位の水平オフセット (デフォルトは 0)。
- yOffset (int) - ピクセル単位の垂直オフセット (デフォルトは 0)。
- shadow (配列) - テキストシャドウパラメータ。
  - x * (int) - ピクセル単位の水平オフセット。
  - y * (int) - ピクセル単位の垂直オフセット。
  - color * (string|array) - テキストの影の色。
- calculateOffsetFromEdge (bool) - 画像のエッジを参照してオフセットを計算します (デフォルトは false)。
- baselineAlign (bool) - テキストフォントをベースラインに合わせて配置します。 (デフォルトは true)。
$boundary (配列) - 渡された場合、この変数にはテキストを囲む座標を含む配列が含まれます: [x1, y1, x2, y2, width, height]。これは、テキストが画像に追加された後にテキストの位置を計算するために使用できます。

SimpleImage オブジェクトを返します。

`thumbnail($width, $height, $anchor)`

サムネイル画像を作成します。この関数は、指定されたサイズにできる限り画像を近づけようとし、残りのオーバーフローを切り取って希望のサイズにします。サムネイル画像を生成するのに便利です。

$width * (int) - サムネイルの幅。
$height * (int) - サムネイルの高さ。
$anchor (文字列) - アンカーポイント: 'center'、'top'、'bottom'、'left'、'right'、'top left'、'top right'、'bottom left'、'bottom right' (デフォルトは「中央」です）。

SimpleImage オブジェクトを返します。

描画

`arc($x, $y, $width, $height, $start, $end, $color, $thickness)`

弧を描きます。

$x * (int) - 円弧の中心の x 座標。
$y * (int) - 円弧の中心の y 座標。
$width * (int) - 円弧の幅。
$height * (int) - 円弧の高さ。
$start * (int) - 角度単位の円弧の開始点。
$end * (int) - 角度単位の円弧の終点。
$color * (string|array) - 円弧の色。
$thickness (int|string) - ピクセル単位の線の太さ、または「塗りつぶし」(デフォルトは 1)。

SimpleImage オブジェクトを返します。

`border($color, $thickness)`

画像の周囲に境界線を描きます。

$color * (string|array) - 境界線の色。
$thickness (int) - 境界線の太さ (デフォルトは 1)。

SimpleImage オブジェクトを返します。

`dot($x, $y, $color)`

単一ピクセルのドットを描画します。

$x * (int) - ドットの x 座標。
$y * (int) - ドットの y 座標。
$color * (string|array) - ドットの色。

SimpleImage オブジェクトを返します。

`ellipse($x, $y, $width, $height, $color, $thickness)`

楕円を描きます。

$x * (int) - 中心の x 座標。
$y * (int) - 中心の y 座標。
$width * (int) - 楕円の幅。
$height * (int) - 楕円の高さ。
$color * (string|array) - 楕円の色。
$thickness (int|string) - ピクセル単位の線の太さ、または「塗りつぶし」(デフォルトは 1)。

SimpleImage オブジェクトを返します。

`fill($color)`

画像を単色で塗りつぶします。

$color (string|array) - 塗りつぶしの色。

SimpleImage オブジェクトを返します。

`line($x1, $y1, $x2, $y2, $color, $thickness)`

線を描きます。

$x1 * (int) - 最初の点の x 座標。
$y1 * (int) - 最初の点の y 座標。
$x2 * (int) - 2 番目の点の x 座標。
$y2 * (int) - 2 番目の点の y 座標。
$color (string|array) - 線の色。
$thickness (int) - 線の太さ (デフォルトは 1)。

SimpleImage オブジェクトを返します。

`polygon($vertices, $color, $thickness)`

多角形を描画します。

$vertices * (array) - x/y 配列の配列内のポリゴンの頂点。例：

 [
  ['x' => x1, 'y' => y1],
  ['x' => x2, 'y' => y2],
  ['x' => xN, 'y' => yN]
]

$color * (string|array) - ポリゴンの色。
$thickness (int|string) - ピクセル単位の線の太さ、または「塗りつぶし」(デフォルトは 1)。

SimpleImage オブジェクトを返します。

`rectangle($x1, $y1, $x2, $y2, $color, $thickness)`

長方形を描画します。

$x1 * (int) - 左上の x 座標。
$y1 * (int) - 左上の y 座標。
$x2 * (int) - 右下の x 座標。
$y2 * (int) - 右下の y 座標。
$color * (string|array) - 四角形の色。
$thickness (int|string) - ピクセル単位の線の太さ、または「塗りつぶし」(デフォルトは 1)。

SimpleImage オブジェクトを返します。

`roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $thickness)`

角丸長方形を描画します。

$x1 * (int) - 左上の x 座標。
$y1 * (int) - 左上の y 座標。
$x2 * (int) - 右下の x 座標。
$y2 * (int) - 右下の y 座標。
$radius * (int) - 境界線の半径 (ピクセル単位)。
$color * (string|array) - 四角形の色。
$thickness (int|string) - ピクセル単位の線の太さ、または「塗りつぶし」(デフォルトは 1)。

SimpleImage オブジェクトを返します。

フィルター

`blur($type, $passes)`

ぼかしフィルターを適用します。

$type (string) - 使用するぼかしアルゴリズム: 'selective'、'gaussian' (デフォルトは 'gaussian')。
$passes (int) - フィルターを適用して効果を強化する回数 (デフォルトは 1)。

SimpleImage オブジェクトを返します。

`brighten($percentage)`

明るさフィルターを適用して画像を明るくします。

$percentage * (int) - 画像を明るくするパーセンテージ (0 ～ 100)。

SimpleImage オブジェクトを返します。

`colorize($color)`

カラー化フィルターを適用します。

$color * (string|array) - フィルターの色。

SimpleImage オブジェクトを返します。

`contrast($percentage)`

コントラストフィルターを適用します。

$percentage * (int) - 調整するパーセンテージ (-100 - 100)。

SimpleImage オブジェクトを返します。

`darken($percentage)`

明るさフィルターを適用して画像を暗くします。

$percentage * (int) - 画像を暗くするパーセンテージ (0 ～ 100)。

SimpleImage オブジェクトを返します。

`desaturate()`

彩度を下げる (グレースケール) フィルターを適用します。

SimpleImage オブジェクトを返します。

`duotone($lightColor, $darkColor)`

画像にダブルトーンフィルターを適用します。

$lightColor * (string|array) - ダブルトーンの最も明るい色。
$darkColor * (string|array) - ダブルトーンの最も暗い色。

SimpleImage オブジェクトを返します。

`edgeDetect()`

エッジ検出フィルターを適用します。

SimpleImage オブジェクトを返します。

`emboss()`

エンボスフィルターを適用します。

SimpleImage オブジェクトを返します。

`invert()`

画像の色を反転します。

SimpleImage オブジェクトを返します。

`opacity()`

画像の不透明度レベルを変更します。

$opacity * (float) - 必要な不透明度レベル (0 ～ 1)。

SimpleImage オブジェクトを返します。

`pixelate($size)`

ピクセル化フィルターを適用します。

$size (int) - ピクセル単位のブロックのサイズ (デフォルトは 10)。

SimpleImage オブジェクトを返します。

`sepia()`

画像の彩度を下げ、セピアトーンを適用することで、セピア効果をシミュレートします。

SimpleImage オブジェクトを返します。

`sharpen($amount)`

画像を鮮明にします。

$amount (int) - シャープ化量 (1 ～ 100、デフォルトは 50)

SimpleImage オブジェクトを返します。

`sketch()`

平均除去フィルタを適用して、スケッチ効果を生成します。

SimpleImage オブジェクトを返します。

カラーユーティリティ

`(static) adjustColor($color, $red, $green, $blue, $alpha)`

赤/緑/青/アルファ値を個別に増減して色を調整します。

$color * (string|array) - 調整する色。
$red * (int) - 赤の調整 (-255 ～ 255)。
$green * (int) - 緑の調整 (-255 ～ 255)。
$blue * (int) - 青の調整 (-255 ～ 255)。
$alpha * (float) - アルファ調整 (-1 - 1)。

RGBAカラー配列を返します。

`(static) darkenColor($color, $amount)`

色を暗くします。

$color * (string|array) - 暗くする色。
$amount * (int) - 暗くする量 (0 ～ 255)。

RGBAカラー配列を返します。

`extractColors($count = 10, $backgroundColor = null)`

人間が行うのと同じように、画像から色を抽出します。™ この方法には、サードパーティのライブラリ LeagueColorExtractor が必要です。 Composer を使用している場合は、自動的にインストールされます。

$count (int) - 抽出する色の最大数 (デフォルトは 5)。
$backgroundColor (string|array) - デフォルトでは、アルファ値が 0 より大きいピクセルはすべて破棄されます。透明色はそのままでは認識されないからです。たとえば、完全に透明な黒は、白い背景では白く見えます。したがって、透明度を考慮したい場合は、デフォルトの背景色を指定する必要があります。

RGBA カラー配列の配列を返します。

`getColorAt($x, $y)`

単一ピクセルの RGBA 値を取得します。

$x * (int) - ピクセルの水平位置。
$y * (int) - ピクセルの垂直位置。

RGBA カラー配列を返すか、x/y 位置がキャンバスから外れている場合は false を返します。

`(static) lightenColor($color, $amount)`

色を明るくします。

$color * (string|array) - 明るくする色。
$amount * (int) - 暗くする量 (0 ～ 255)。

RGBAカラー配列を返します。

`(static) normalizeColor($color)`

16 進数または配列のカラー値を適切にフォーマットされた RGBA 配列に正規化します。

$color * (string|array) - CSS カラー名、16 進文字列、または配列 [赤、緑、青、アルファ]。

16 進文字列と色の名前を介してアルファ透明度をパイプできます。例えば：

#fff|0.50 <-- 50% 白赤|0.25 <-- 25% 赤

配列を返します: [赤、緑、青、アルファ]

例外

SimpleImage は、問題が発生した場合に標準例外をスローします。これらを適切に処理するには、常にコードの周囲に try/catch ブロックを使用する必要があります。

 <?php
try {
  $ image = new  claviska SimpleImage( ' image.jpeg ' )
  // ...
} catch ( Exception $ err ) {
  echo $ err -> getMessage ();
}

特定のエラーを確認するには、 $err->getCode()定義されたエラー定数と比較します。

 <?php
try {
  $ image = new  claviska SimpleImage( ' image.jpeg ' )
  // ...
} catch ( Exception $ err ) {
  if ( $ err -> getCode () === $ image :: ERR_FILE_NOT_FOUND ) {
    echo ' File not found! ' ;
  } else {
    echo $ err -> getMessage ();
  }
}

ベストプラクティスとして、常に整数値の代わりに定義された定数を使用します。値は将来のバージョンで変更される可能性があり、重大な変更とはみなされません。

ERR_FILE_NOT_FOUND - 指定されたファイルが見つからないか、何らかの理由でロードできませんでした。
ERR_FONT_FILE - 指定されたフォントファイルをロードできませんでした。
ERR_FREETYPE_NOT_ENABLED - お使いのバージョンの PHP ではフリータイプのサポートが有効になっていません。
ERR_GD_NOT_ENABLED - GD 拡張機能は、お使いのバージョンの PHP では有効になっていません。
ERR_LIB_NOT_LOADED - 必要なライブラリがロードされていません。
ERR_INVALID_COLOR - 無効な色の値が引数として渡されました。
ERR_INVALID_DATA_URI - 指定されたデータ URI が無効です。
ERR_INVALID_IMAGE - 指定された画像は無効です。
ERR_UNSUPPORTED_FORMAT - 指定された画像形式が無効です。
ERR_WEBP_NOT_ENABLED - お使いのバージョンの PHP では WEBP サポートが有効になっていません。
ERR_WRITE - ファイルシステムに書き込めません。
ERR_INVALID_FLAG - 指定されたフラグキーが存在しません。

知っておくと便利なこと

カラー引数には、CSS カラー名 (例: LightBlue )、16 進数のカラー文字列 (例: #0099dd )、または RGB(A) 配列 (例: ['red' => 255, 'green' => 0, 'blue' => 0, 'alpha' => 1] )。
$thickness > 1 の場合、GD は中心の原点から希望の太さの線を描画します。たとえば、厚さ 3 で [10, 10, 20, 20] に描画された長方形は、実際には [9, 9, 21, 21] に描画されます。これはすべての図形に当てはまり、SimpleImage ライブラリのバグではありません。

インスタンスフラグ

setFlag($key, $value)メソッドでインスタンスフラグ値を設定することにより、SimpleImage インスタンスの動作を調整します。

 $ image = new  claviska  SimpleImage ( ' image.jpeg ' )-> setFlag ( " foo " , " bar " );

連想配列を SimpleImage コンストラクターに渡して、インスタンスフラグを設定することもできます。

 $ image = new  claviska  SimpleImage ( ' image.jpeg ' , [ ' foo ' => ' bar ' ]);
// . . or without an $ image
$ image = new  claviska  SimpleImage (flags: [ ' foo ' => ' bar ' ]);

注: キーが存在しない (デフォルト値がない) 場合、 setFlag() ERR_INVALID_FLAG例外をスローします。

`sslVerify`

sslVerifyをfalse (デフォルトはtrue ) に設定すると、HTTPS 経由でロードされたすべてのイメージで証明書ピアの検証が行われなくなります。これは、自己署名証明書の場合に特に便利です。

 $ image = new  claviska  SimpleImage ( ' https://localhost/image.jpeg ' , [ ' sslVerify ' => false ]);
// Would normally throw an OpenSSL exception , but is ignored with the sslVerify flag set to false .

SimpleImage 2.x との違い

正規化された色の引数 (色は CSS カラー名、16 進カラー、または RGB(A) 配列にすることができます)。
正規化されたアルファ (不透明) 引数: 0 (透明) - 1 (不透明)
textメソッドにテキストシャドウを追加しました。
文字列から画像を読み込むfromString()メソッドを追加しました。
画像文字列を生成するためのtoString()メソッドを追加しました。
円弧を描画するためのarcメソッドを追加しました。
境界線を描画するためのborderメソッドを追加しました。
個々のピクセルを描画するためのdotメソッドを追加しました。
楕円と円を描画するためのellipseメソッドを追加しました。
線を描画するためのlineメソッドを追加しました。
多角形を描画するためのpolygonメソッドを追加しました。
長方形を描画するためのrectangleメソッドを追加しました。
角丸長方形を描画するためのroundedRectangleメソッドを追加しました。
RGBA カラーチャネルを変更して相対的な色のバリエーションを作成するためのadjustColorメソッドを追加しました。
色を暗くするdarkenColorメソッドを追加しました。
画像から最も一般的な色を取得するためのextractColorsメソッドを追加しました。
特定のピクセルの RGBA 値を取得するgetColorAtメソッドを追加しました。
色を明るくするlightenColorメソッドを追加しました。
イメージをクライアントのマシンに強制的にダウンロードするためのtoDownloadメソッドが追加されました。
ダブルトーン画像を作成するためのduotoneフィルターを追加しました。
画像を鮮明にするsharpenメソッドを追加しました。
名前空間をabeautifulsiteからclaviskaに変更しました。
createメソッドをfromNewに変更しました。
loadメソッドをfromFileに変更しました。
load_base64メソッドをfromDataUriに変更しました。
output方法をtoScreen .xに変更しました。
output_base64メソッドをtoDataUriに変更しました。
save方法をtoFileに変更しました。
大量の引数ではなくオプションの配列を受け入れるようにtextメソッドを変更しました。
テキストストロークは汚い結果を生成し、透明度をサポートしていないため、 textメソッドからテキストストロークを削除しました。
PHP マニュアルの引数が十分に文書化されていないため、 smoothメソッドを削除しました。
非推奨のメソッドadaptive_resize削除しました(代わりにthumbnailを使用してください)。
get_meta_data削除しました (代わりにgetExif 、 getHeight 、 getMime 、 getOrientation 、およびgetWidthを使用してください)。
.editorconfig ファイルを追加しました。投稿を送信する前に、編集者がこれらの設定をサポートしていることを確認してください。
インデントを 4 つのスペースから 2 つのスペースに切り替えました (PHP-FIG ごめんなさい!)。
underscore_methods から CamelCaseMethods に切り替えました。
機能に基づいてメソッドをグループに整理
PHPDoc コメントを削除しました。現時点では、それらをライブラリに組み込むつもりはありません。

拡大する

追加情報

バージョン 4.2.1
タイプその他のカテゴリー
更新時間 2024-12-27
サイズ 28.96KB
から Github

SimpleImage

シンプルイメージ

概要

要件

特徴

インストール

について

ライセンス

API

ローダー

fromDataUri($uri)

fromFile($file)

fromNew($width, $height, $color)

fromString($string)

節約者

toDataUri($mimeType, $options)

toDownload($filename, $mimeType, $options)

toFile($file, $mimeType, $options)

toScreen($mimeType, $options)

toString($mimeType, $options)

generate($mimeType, $options)

オプション配列

公共事業

getAspectRatio()

getExif()

getHeight()

getMimeType()

getOrientation()

getResolution()

getWidth()

hasImage()

reset()

操作

autoOrient()

bestFit($maxWidth, $maxHeight)

crop($x1, $y1, $x2, $y2)

fitToHeight($height) (非推奨)

fitToWidth($width) (非推奨)

flip($direction)

maxColors($max, $dither)

overlay($overlay, $anchor, $opacity, $xOffset, $yOffset)

resize($width, $height)

resolution($res_x, $res_y)

rotate($angle, $backgroundColor)

text($text, $options, &$boundary)

thumbnail($width, $height, $anchor)

描画

arc($x, $y, $width, $height, $start, $end, $color, $thickness)

border($color, $thickness)

dot($x, $y, $color)

ellipse($x, $y, $width, $height, $color, $thickness)

fill($color)

line($x1, $y1, $x2, $y2, $color, $thickness)

polygon($vertices, $color, $thickness)

rectangle($x1, $y1, $x2, $y2, $color, $thickness)

roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $thickness)

フィルター

blur($type, $passes)

brighten($percentage)

colorize($color)

contrast($percentage)

darken($percentage)

desaturate()

duotone($lightColor, $darkColor)

edgeDetect()

emboss()

invert()

opacity()

pixelate($size)

sepia()

sharpen($amount)

sketch()

カラーユーティリティ

(static) adjustColor($color, $red, $green, $blue, $alpha)

(static) darkenColor($color, $amount)

extractColors($count = 10, $backgroundColor = null)

getColorAt($x, $y)

(static) lightenColor($color, $amount)

(static) normalizeColor($color)

例外

`fromDataUri($uri)`

`fromFile($file)`

`fromNew($width, $height, $color)`

`fromString($string)`

`toDataUri($mimeType, $options)`

`toDownload($filename, $mimeType, $options)`

`toFile($file, $mimeType, $options)`

`toScreen($mimeType, $options)`

`toString($mimeType, $options)`

`generate($mimeType, $options)`

`getAspectRatio()`

`getExif()`

`getHeight()`

`getMimeType()`

`getOrientation()`

`getResolution()`

`getWidth()`

`hasImage()`

`reset()`

`autoOrient()`

`bestFit($maxWidth, $maxHeight)`

`crop($x1, $y1, $x2, $y2)`

`fitToHeight($height)` (非推奨)

`fitToWidth($width)` (非推奨)

`flip($direction)`

`maxColors($max, $dither)`

`overlay($overlay, $anchor, $opacity, $xOffset, $yOffset)`

`resize($width, $height)`

`resolution($res_x, $res_y)`

`rotate($angle, $backgroundColor)`

`text($text, $options, &$boundary)`

`thumbnail($width, $height, $anchor)`

`arc($x, $y, $width, $height, $start, $end, $color, $thickness)`

`border($color, $thickness)`

`dot($x, $y, $color)`

`ellipse($x, $y, $width, $height, $color, $thickness)`

`fill($color)`

`line($x1, $y1, $x2, $y2, $color, $thickness)`

`polygon($vertices, $color, $thickness)`

`rectangle($x1, $y1, $x2, $y2, $color, $thickness)`

`roundedRectangle($x1, $y1, $x2, $y2, $radius, $color, $thickness)`

`blur($type, $passes)`

`brighten($percentage)`

`colorize($color)`

`contrast($percentage)`

`darken($percentage)`

`desaturate()`

`duotone($lightColor, $darkColor)`

`edgeDetect()`

`emboss()`

`invert()`

`opacity()`

`pixelate($size)`

`sepia()`

`sharpen($amount)`

`sketch()`

`(static) adjustColor($color, $red, $green, $blue, $alpha)`

`(static) darkenColor($color, $amount)`

`extractColors($count = 10, $backgroundColor = null)`

`getColorAt($x, $y)`

`(static) lightenColor($color, $amount)`

`(static) normalizeColor($color)`

`sslVerify`