Edit Report a Bug

    Imagick::compositeImage

    (PECL imagick 2, PECL imagick 3)

    Imagick::compositeImage — 把一张图合并到一张图

    说明

    public Imagick::compositeImage(
        Imagick $composite_object,
        int $composite,
        int $x,
        int $y,
        int $channel = Imagick::CHANNEL_DEFAULT
    ): bool

    以指定的偏移量（offset）将一幅图像合成到另一幅图像上。组合算法所需的任何额外参数都应传递给 setImageArtifact，其中“compose:args”作为第一个参数，数据作为第二个参数。

    参数

    composite_object

    用于合并的图片的Imagick对象

    composite

    合并操作，定义操作常量。 具体请查看 合并操作常量列表

    x

    相对图像顶点左上位置（0,0）的横坐标

    y

    相对图像顶点左上位置（0,0）的纵坐标

    channel

    通过传入一个通道常量，来开启通道模式。为了支持多个通道，可以通过二进制运算的操作来合并多个通道常量。（Provide any channel constant that is valid for your channel mode. To apply to more than one channel, combine channeltype constants using bitwise operators）可以参考这个列表 通道常量列表.

    返回值

    成功时返回 true。

    示例

    示例 #1 使用 Imagick::compositeImage():

    使用“mathematics”组合方法合成两个图像

    <?php

    // 等同于运行命令
    // convert src1.png src2.png -compose mathematics -define compose:args="1,0,-0.5,0.5" -composite output.png

    $src1 = new \Imagick("./src1.png");
    $src2 = new \Imagick("./src2.png");

    $src1->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_TRANSPARENT);
    $src1->setImageArtifact('compose:args', "1,0,-0.5,0.5");
    $src1->compositeImage($src2, Imagick::COMPOSITE_MATHEMATICS, 0, 0);
    $src1->writeImage("./output.png");

    ?>

    参见

    add a note add a note

    User Contributed Notes 4 notes

    up
    6
    m dot roszka at textend dot net
    16 years ago
    Here is an example on how to compose two images into a single one. The Imagick class utilises the exception handling model introduced in PHP5 and thus we will do that as well. Let's presume, that we have a directory in our filesystem, which contains our program and the two images we want to operate on.

    <?php
    try
    {
            // Let's check whether we can perform the magick.
            if (TRUE !== extension_loaded('imagick'))
        {
            throw new     Exception('Imagick extension is not loaded.');
        }

            // This check is an alternative to the previous one.
        // Use the one that suits you better.
            if (TRUE !== class_exists('Imagick'))
        {
            throw new     Exception('Imagick class does not exist.');
        }

            // Let's find out where we are.
            $dir = dirname(__FILE__);

            // Let's read the images.
            $glasses = new Imagick();
        if (    FALSE === $glasses->readImage($dir . '/glasses.png'))
        {
            throw new     Exception();
        }

            $face = new Imagick();
        if (    FALSE === $face->readImage($dir . '/face.jpg'))
        {
            throw new     Exception();
        }

            // Let's put the glasses on (10 pixels from left, 20 pixels from top of face).
            $face->compositeImage($glasses, Imagick::COMPOSITE_DEFAULT, 10, 20);

            // Let's merge all layers (it is not mandatory).
            $face->flattenImages();

            // We do not want to overwrite face.jpg.
            $face->setImageFileName($dir . '/face_and_glasses.jpg');

            // Let's write the image.
            if  (FALSE == $face->writeImage())
        {
            throw new     Exception();
        }
    }

    catch (    Exception $e)
    {
        echo     'Caught exception: ' . $e->getMessage() . "\n";
    }

    exit(    0);
    ?>
    Also a couple more words on the Imagick::COMPOSITE_DEFAULT argument. The images we are composing together are separate layers. Not only can we put them in specific order, but we can also choose the way we want them to interfere with each other. And here comes the second argument of the compositeImage method. It can be given either as a constant or as the integer value of that constant. You can use the reflection API of PHP5 to get the list of them.

    <?php
    Reflection    ::export(new ReflectionClass('Imagick'));
    ?>

    Just look for COMPOSITE_* constants in the "Constants" section.
    up
    2
    elizapinchley at google dot com
    3 years ago
    There has been changes to Imagick constants in new version. Please read new list of constants like this.

    <?php

    $img     = new \Imagick();
    $reflection_class = new ReflectionClass($img);

    die(    var_dump($reflection_class->getConstants()));

    ?>
    up
    0
    Iddles
    13 years ago
    To copy the alpha channel from one image to another, you can do the following:

    <?php

    $img1     = new Imagick( "image1.png" );
    $img2 = new Imagick( "image2.png" );

    $img1->compositeImage( $img2, imagick::COMPOSITE_COPYOPACITY, 0, 0 );

    header('Content-type: image/png');
    echo     $img1;

    ?>
    up
    0
    giso at connectholland dot nl
    14 years ago
    You might need to set the colorspace the same when composing two images over each other

    <?php
    //Creating two Imagick object
    $first = new Imagick('first.jpg');
    $second = new Imagick('second.jpg');

    // Set the colorspace to the same value
    $first->setImageColorspace($second->getImageColorspace() );

    //Second image is put on top of the first
    $first->compositeImage($second, $second->getImageCompose(), 5, 5);

    //new image is saved as final.jpg
    $first->writeImage('final.jpg');
    ?>
    add a note add a note
    To Top