# Gmagick

# はじめに

警告

この拡張モジュールは、 実験的 なものです。この拡張モジュールの動作・ 関数名・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。 このモジュールは自己責任で使用してください。

Gmagick は、GraphicsMagick API を用いて画像の作成や編集を行ったり画像のメタ情報を取得したりするための拡張モジュールです。

GraphicsMagick は、自らを「画像処理におけるスイスアーミーナイフ」と称しています。 88 の主要なフォーマットに対応しており、よく使われる DPX、GIF、JPEG、JPEG-2000、 PNG、PDF、PNM そして TIFF もそれに含まれます。

Gmagick は、メインとなる Gmagick クラスのほかに描画のエフェクトを担当する GmagickDraw クラスと画像の各ピクセル (色、透明度) をあらわす GmagickPixel クラスで構成されています。

- インストール/設定
  - 要件
  - インストール手順
- 定義済み定数
- 例
- Gmagick — Gmagick クラス
  - Gmagick::addimage — 新しい画像を Gmagick オブジェクトの画像リストに追加する
  - Gmagick::addnoiseimage — ランダムなノイズを画像に追加する
  - Gmagick::annotateimage — 画像にテキストによる注記を加える
  - Gmagick::blurimage — blur (にじみ) フィルタを画像に追加する
  - Gmagick::borderimage — 画像の周りを枠線で囲む
  - Gmagick::charcoalimage — 木炭画をシミュレートする
  - Gmagick::chopimage — 画像の一部を取り除き、切り詰める
  - Gmagick::clear — Gmagick オブジェクトに関連付けられたすべてのリソースをクリアする
  - Gmagick::commentimage — コメントを画像に追加する
  - Gmagick::compositeimage — ある画像を別の画像に合成する
  - Gmagick::__construct — Gmagick のコンストラクタ
  - Gmagick::cropimage — 画像の一部を抽出する
  - Gmagick::cropthumbnailimage — 切り取ってサムネイルを作成する
  - Gmagick::current — 現在の Gmagick オブジェクトへの参照を返す
  - Gmagick::cyclecolormapimage — 画像のカラーマップを移動する
  - Gmagick::deconstructimages — 画像間の特定のピクセルの差を返す
  - Gmagick::despeckleimage — 画像内のスペックルノイズを軽減する
  - Gmagick::destroy — Gmagick オブジェクトを破棄する
  - Gmagick::drawimage — 現在の画像上の GmagickDraw オブジェクトをレンダリングする
  - Gmagick::edgeimage — 画像の輪郭を強調する
  - Gmagick::embossimage — グレースケール画像に三次元効果を施して返す
  - Gmagick::enhanceimage — ノイジーな画像の品質を向上させる
  - Gmagick::equalizeimage — 画像ヒストグラムを均等化する
  - Gmagick::flipimage — 垂直方向に反転した画像を作成する
  - Gmagick::flopimage — 水平方向に反転した画像を作成する
  - Gmagick::frameimage — 三次元の枠線をシミュレートする
  - Gmagick::gammaimage — 画像をガンマ補正する
  - Gmagick::getcopyright — GraphicsMagick API の著作権情報を文字列で返す
  - Gmagick::getfilename — 画像シーケンスに関連付けられたファイル名を取得する
  - Gmagick::getimagebackgroundcolor — 画像の背景色を返す
  - Gmagick::getimageblueprimary — 青が一番強い点を返す
  - Gmagick::getimagebordercolor — 画像の前景色を返す
  - Gmagick::getimagechanneldepth — 特定の画像チャネルの深度を返す
  - Gmagick::getimagecolors — 指定した色マップインデックスの色を返す
  - Gmagick::getimagecolorspace — 画像の色空間を取得する
  - Gmagick::getimagecompose — 画像の合成演算子を返す
  - Gmagick::getimagedelay — 画像の遅延を取得する
  - Gmagick::getimagedepth — 画像の深度を取得する
  - Gmagick::getimagedispose — 画像の配置方法を取得する
  - Gmagick::getimageextrema — 画像の極値を取得する
  - Gmagick::getimagefilename — シーケンス内の特定の画像のファイル名を返す
  - Gmagick::getimageformat — シーケンス内の特定の画像のフォーマットを返す
  - Gmagick::getimagegamma — 画像のガンマを取得する
  - Gmagick::getimagegreenprimary — 緑が一番強い点を返す
  - Gmagick::getimageheight — 画像の高さを返す
  - Gmagick::getimagehistogram — 画像のヒストグラムを取得する
  - Gmagick::getimageindex — 現在アクティブな画像のインデックスを取得する
  - Gmagick::getimageinterlacescheme — 画像のインターレース手法を取得する
  - Gmagick::getimageiterations — 画像の反復を取得する
  - Gmagick::getimagematte — 画像がマットチャネルを持っているかどうかを調べる
  - Gmagick::getimagemattecolor — 画像のマット色を返す
  - Gmagick::getimageprofile — 指定した名前の画像プロファイルを返す
  - Gmagick::getimageredprimary — 赤が一番強い点を返す
  - Gmagick::getimagerenderingintent — 画像のレンダリング方向を取得する
  - Gmagick::getimageresolution — 画像の X 方向と Y 方向の解像度を取得する
  - Gmagick::getimagescene — 画像のシーンを取得する
  - Gmagick::getimagesignature — SHA-256 メッセージダイジェストを生成する
  - Gmagick::getimagetype — 画像の型を取得する
  - Gmagick::getimageunits — 画像の解像度の単位を取得する
  - Gmagick::getimagewhitepoint — 色度が白い点を返す
  - Gmagick::getimagewidth — 画像の幅を返す
  - Gmagick::getpackagename — GraphicsMagick パッケージ名を返す
  - Gmagick::getquantumdepth — Gmagick quantum depth を返す
  - Gmagick::getreleasedate — GraphicsMagick のリリース日を返す
  - Gmagick::getsamplingfactors — 水平方向および垂直方向のサンプリング係数を取得する
  - Gmagick::getsize — Gmagick オブジェクトのサイズを取得する
  - Gmagick::getversion — GraphicsMagick API のバージョンを返す
  - Gmagick::hasnextimage — オブジェクトが次の画像を保持しているかどうかを調べる
  - Gmagick::haspreviousimage — オブジェクトが前の画像を保持しているかどうかを調べる
  - Gmagick::implodeimage — 新しい画像をコピーとして作成する
  - Gmagick::labelimage — ラベルを画像に追加する
  - Gmagick::levelimage — 画像のレベルを調節する
  - Gmagick::magnifyimage — 画像を二倍に比例拡大する
  - Gmagick::mapimage — 画像の色を、参照画像の中の最も近い色に置き換える
  - Gmagick::medianfilterimage — デジタルフィルタを適用する
  - Gmagick::minifyimage — 画像をその半分のサイズに比例縮小する
  - Gmagick::modulateimage — 明度、彩度、色相を制御する
  - Gmagick::motionblurimage — モーションブラーをシミュレートする
  - Gmagick::newimage — 新しい画像を作成する
  - Gmagick::nextimage — 次の画像に移動する
  - Gmagick::normalizeimage — カラー画像のコントラストを強調する
  - Gmagick::oilpaintimage — 油絵をシミュレートする
  - Gmagick::previousimage — オブジェクト内の前の画像に移動する
  - Gmagick::profileimage — 画像のプロファイルを追加あるいは削除する
  - Gmagick::quantizeimage — 参照画像内の色を解析する
  - Gmagick::quantizeimages — 画像シーケンス内の色を解析する
  - Gmagick::queryfontmetrics — フォントメトリクスを表す配列を返す
  - Gmagick::queryfonts — 設定したフォントを返す
  - Gmagick::queryformats — Gmagick がサポートするフォーマットを返す
  - Gmagick::radialblurimage — 画像にラジアルブラーを施す
  - Gmagick::raiseimage — 三次元のボタン風の効果をシミュレートする
  - Gmagick::read — ファイルから画像を読み込む
  - Gmagick::readimage — ファイルから画像を読み込む
  - Gmagick::readimageblob — バイナリ文字列から画像を読み込む
  - Gmagick::readimagefile — オープンしているファイルハンドルから画像を読み込む
  - Gmagick::reducenoiseimage — 画像の輪郭をなめらかにする
  - Gmagick::removeimage — 画像リストから画像を削除する
  - Gmagick::removeimageprofile — 指定した名前の画像プロファイルを削除して返す
  - Gmagick::resampleimage — 画像を指定した解像度にリサンプリングする
  - Gmagick::resizeimage — 画像のサイズを変更する
  - Gmagick::rollimage — 画像を補正する
  - Gmagick::rotateimage — 画像を回転する
  - Gmagick::scaleimage — 画像のサイズを変更する
  - Gmagick::separateimagechannel — 画像からチャネルを分離する
  - Gmagick::setCompressionQuality — オブジェクトのデフォルトの圧縮クオリティを設定する
  - Gmagick::setfilename — 画像を読み書きする前にファイル名を設定する
  - Gmagick::setimagebackgroundcolor — 画像の背景色を設定する
  - Gmagick::setimageblueprimary — 青が一番強い点を設定する
  - Gmagick::setimagebordercolor — 画像の枠線の色を設定する
  - Gmagick::setimagechanneldepth — 特定の画像チャネルの深度を設定する
  - Gmagick::setimagecolorspace — 画像の色空間を設定する
  - Gmagick::setimagecompose — 画像の合成演算子を設定する
  - Gmagick::setimagedelay — 画像の遅延を設定する
  - Gmagick::setimagedepth — 画像の深度を設定する
  - Gmagick::setimagedispose — 画像の配置方法を設定する
  - Gmagick::setimagefilename — シーケンス内の特定の画像のファイル名を設定する
  - Gmagick::setimageformat — 特定の画像のフォーマットを設定する
  - Gmagick::setimagegamma — 画像のガンマを設定する
  - Gmagick::setimagegreenprimary — 緑が一番強い点を設定する
  - Gmagick::setimageindex — 画像リスト内でのイテレータの位置を、index パラメータで指定した場所に設定する
  - Gmagick::setimageinterlacescheme — 画像のインターレース手法を設定する
  - Gmagick::setimageiterations — 画像の反復を設定する
  - Gmagick::setimageprofile — 指定した名前の画像プロファイルを Gmagick オブジェクトに追加する
  - Gmagick::setimageredprimary — 赤が一番強い点を設定する
  - Gmagick::setimagerenderingintent — 画像のレンダリング方向を設定する
  - Gmagick::setimageresolution — 画像の解像度を設定する
  - Gmagick::setimagescene — 画像のシーンを設定する
  - Gmagick::setimagetype — 画像の型を設定する
  - Gmagick::setimageunits — 画像の解像度の単位を設定する
  - Gmagick::setimagewhitepoint — 画像の色度が白い点を設定する
  - Gmagick::setsamplingfactors — 画像のサンプリング係数を設定する
  - Gmagick::setsize — Gmagick オブジェクトのサイズを設定する
  - Gmagick::shearimage — 平行四辺形を作成する
  - Gmagick::solarizeimage — 画像にソラリゼーション効果を適用する
  - Gmagick::spreadimage — ブロック内の各ピクセルをランダムに移動する
  - Gmagick::stripimage — 画像からすべてのプロパティやコメントを除去する
  - Gmagick::swirlimage — 画像の中心から、ピクセルを渦巻状にする
  - Gmagick::thumbnailimage — 画像のサイズを変更する
  - Gmagick::trimimage — 画像の輪郭を削除する
  - Gmagick::write — Gmagick::writeimage のエイリアス
  - Gmagick::writeimage — 画像を指定したファイル名で書き出す
- GmagickDraw — GmagickDraw クラス
  - GmagickDraw::annotate — 画像の上にテキストを描画する
  - GmagickDraw::arc — 弧を描く
  - GmagickDraw::bezier — ベジエ曲線を描く
  - GmagickDraw::ellipse — 楕円を画像上に描く
  - GmagickDraw::getfillcolor — 塗りつぶし色を返す
  - GmagickDraw::getfillopacity — 描画に使う不透明度を返す
  - GmagickDraw::getfont — フォントを返す
  - GmagickDraw::getfontsize — フォントのポイント数を返す
  - GmagickDraw::getfontstyle — フォントスタイルを返す
  - GmagickDraw::getfontweight — フォントのウェイトを返す
  - GmagickDraw::getstrokecolor — オブジェクトの輪郭の描画に使う色を返す
  - GmagickDraw::getstrokeopacity — オブジェクトの輪郭の不透明度を返す
  - GmagickDraw::getstrokewidth — オブジェクトの輪郭の描画に使う線の幅を返す
  - GmagickDraw::gettextdecoration — テキストのデコレーションを返す
  - GmagickDraw::gettextencoding — テキストのアノテーションで使うコードセットを返す
  - GmagickDraw::line — 直線を描く
  - GmagickDraw::point — 点を描く
  - GmagickDraw::polygon — 多角形を描く
  - GmagickDraw::polyline — ポリラインを描く
  - GmagickDraw::rectangle — 矩形を描く
  - GmagickDraw::rotate — 指定した回転角を現在の座標空間に適用する
  - GmagickDraw::roundrectangle — 角が丸い矩形を描く
  - GmagickDraw::scale — 倍率を調整する
  - GmagickDraw::setfillcolor — オブジェクトの塗りつぶしに使う色を設定する
  - GmagickDraw::setfillopacity — 不透明度を設定する
  - GmagickDraw::setfont — テキストのアノテーションで使うフォントの完全な名前を設定する
  - GmagickDraw::setfontsize — テキストのアノテーションで使うフォントのポイント数を設定する
  - GmagickDraw::setfontstyle — テキストのアノテーションで使うフォントのスタイルを設定する
  - GmagickDraw::setfontweight — フォントのウェイトを設定する
  - GmagickDraw::setstrokecolor — オブジェクトの輪郭の描画に使う色を設定する
  - GmagickDraw::setstrokeopacity — オブジェクトの輪郭の不透明度を設定する
  - GmagickDraw::setstrokewidth — オブジェクトの輪郭の描画に使う線の幅を設定する
  - GmagickDraw::settextdecoration — デコレーションを設定する
  - GmagickDraw::settextencoding — テキストのコードセットを設定する
- GmagickPixel — GmagickPixel クラス
  - GmagickPixel::__construct — GmagickPixel のコンストラクタ
  - GmagickPixel::getcolor — 色を返す
  - GmagickPixel::getcolorcount — この色の色カウントを返す
  - GmagickPixel::getcolorvalue — 指定した色チャネルの正規化した値を取得する
  - GmagickPixel::setcolor — 色を設定する
  - GmagickPixel::setcolorvalue — 色チャネルの正規化した値を設定する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open