imageantialias

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

imageantialiasアンチエイリアス機能を使用すべきかどうかを判断する

説明

imageantialias(GdImage $image, bool $enable): bool

直線や多角形を高速に描画するためのアンチエイリアス機能を有効にします。 アルファコンポーネントはサポートしていません。ダイレクトブレンド操作を 使用します。truecolor 画像に対してのみ動作します。

thickness および styled はサポートしていません。

背景色が透明な場合にアンチエイリアス機能を使用すると、予期せぬ結果に 終わることがあります。ブレンドメソッドでは、背景色が使用されます。 アルファコンポーネントをサポートしていないため、アルファコンポーネントに 基づいたアンチエイリアス手法は使用できません。

パラメータ

image

imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

enable

アンチエイリアスを有効にするかどうか。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン 説明
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource が期待されていました。
7.2.0 imageantialias() が常に使えるようになりました。 これまでのバージョンでは、PHP にバンドルされている GD ライブラリでコンパイルした場合にしか使えませんでした。

例1 2 本の直線のうち一方にアンチエイリアスを有効にする

<?php
// アンチエイリアス画像と通常の画像を用意します
$aa imagecreatetruecolor(400100);
$normal imagecreatetruecolor(200100);

// アンチエイリアスを有効にします
imageantialias($aatrue);

// 色を割り当てます
$red imagecolorallocate($normal25500);
$red_aa imagecolorallocate($aa25500);

// 一方はアンチエイリアスを有効にした状態で 2 本の直線を描画します
imageline($normal00200100$red);
imageline($aa00200100$red_aa);

// ふたつの画像を横に並べて出力します (アンチエイリアス: 左、通常: 右)
imagecopymerge($aa$normal200000200100100);

// 画像を出力します
header('Content-type: image/png');

imagepng($aa);
imagedestroy($aa);
imagedestroy($normal);
?>

上の例の出力は、 たとえば以下のようになります。

出力例 : 2 本の直線のうち一方にアンチエイリアスを有効にする

参考

関連キーワード:  機能, 判断, 使用, imageantialias, バージョン, サポート, アルファ, コンポーネント, GdImage, 直線