phpunit assert gdダウンロード - phpunit assert gdソースコードのダウンロード

phpunit assert gd

パイソン

v4.1.0

ダウンロード

PHPUnit の AssertGD

PHPUnit を使用してイメージをアサートしようとしていますか?このプロジェクトは、制約と、それを可能にする必要なアサーションを提供します。

ディスク上のファイルとメモリ内の画像リソースの比較をサポートします。

インストール

このパッケージを Composer の開発依存関係に追加します。

 composer require --dev meyfa/phpunit-assert-gd

互換性表

AssertGD バージョン	サポートされている PHP バージョン	サポートされているPHPUnitのバージョン
4.*	>= 8.1	10.1
3.*	>= 7.3	9
2.*	>= 7.2	8
1.*	5.3.3 - 8.0	4.8.36 - 6.5.0

例

アサーションは特性として利用できるため、テストケースクラスで簡単にuseできます。

 <?php
use AssertGD  GDAssertTrait ;

class ExampleTest extends PHPUnit  Framework TestCase
{
    // this trait adds the assert methods to your test case
    use GDAssertTrait;

    public function testSomething ()
    {
        $ this -> assertSimilarGD ( ' ./tests/expected.png ' , ' ./tests/actual.png ' );
    }
}

単純な比較

2 つのイメージが完全に等しいと予想される場合は、 assertSimilarGDを使用します。違いがあることが予想される場合は、 assertNotSimilarGD使用してください。

 $ this -> assertSimilarGD ( ' ./tests/img.png ' , ' ./tests/same.png ' );
$ this -> assertNotSimilarGD ( ' ./tests/img.png ' , ' ./tests/other.png ' );

しきい値

0 ～ 1 の数値を入力してエラーしきい値を設定します。たとえば、値 0.2 では最大 20% の差が許容されます。

 $ this -> assertSimilarGD ( ' ./tests/img.png ' , ' ./tests/similar.png ' , '' , 0.2 );

パラメータの種類

ファイルパスの代わりに、GD イメージリソースを渡すことができます。これにより、比較前にディスクに何かを書き込む必要がなくなります。

 $ img = imagecreatetruecolor ( 10 , 10 );
$ this -> assertSimilarGD ( ' ./tests/empty-10x10.png ' , $ img );
imagedestroy ( $ img );

手動制約

モックオブジェクトを構成する必要がある場合、またはその他のより複雑なマッチング呼び出しを実行する必要がある場合は、 isSimilarGD使用して制約オブジェクト ( equalTo 、 isTrueなどによって返されるものと同様) を取得します。

 $ this -> assertThat (
    ' ./tests/actual.png ' ,
    $ this -> isSimilarGD ( ' ./tests/expected.png ' )
);

差分計算

デフォルトでは、このライブラリは、ソースイメージとテストイメージの各ピクセル座標における RGBA カラーチャネル情報を比較し、各ピクセル間の差を平均して差スコアを計算することにより、2 つのイメージ間の差を計算します。

これはほとんどの場合に機能しますが、透明度を多く含む画像など、特定の状況では誤ったスコアが与えられる可能性があります。

別の計算方法は、アルファ透明度に基づいて RGB カラーチャネルをスケーリングします。つまり、透明ピクセルが増えると、画像自体の目に見えにくい違いを相殺するために難易度スコアへの影響が少なくなります。新しいScaledRgbChannelsインスタンスを 5 番目に追加することで有効にできます。 assertSimilarGDメソッドまたはassertNotSimilarGDメソッドのパラメータ。

 use AssertGD  DiffCalculator  ScaledRgbChannels ;

public function testImage ()
{
    $ this -> assertSimilarGD (
        ' expected.png ' ,
        ' actual.png ' ,
        '' ,
        0 ,
        new ScaledRgbChannels ()
    );
}