PHP | imagickdraw pushPattern()函数

简介

php中，imagickdraw类中有一个名为pushPattern()的函数，该函数用于将当前绘图状态压入模式堆栈，并开始进行模式定义。

语法

public ImagickDraw::pushPattern ( string $pattern_id , float $x , float $y , float $width , float $height ) : bool

参数

• $pattern_id： 模式标识符。
• $x： 模式的左上角x坐标位置。
• $y： 模式的左上角y坐标位置。
• $width： 图案的宽度。
• $height： 图案的高度。

返回值

成功时返回TRUE。

实例

下面是一个示例，展示使用pushPattern()方法在imagickdraw类中创建图案的基本语法。

<?php
//Create an instance of ImagickDraw
$draw = new \ImagickDraw();

//Create a new pattern
$pattern = new \Imagick();
$pattern->newPseudoImage(100, 100, "gradient:blue-red");
$pattern->scaleImage(0.25 * $pattern->getImageWidth(), 0.25 * $pattern->getImageHeight());

//Add the pattern to the drawing
$pattern_id = 'MyCustomPattern';
$draw->pushPattern($pattern_id, 0, 0, $pattern->getImageWidth(), $pattern->getImageHeight());
$draw->rectangle(0, 0, $pattern->getImageWidth(), $pattern->getImageHeight());
$draw->composite(\Imagick::COMPOSITE_OVER, 0, 0, $pattern->getImageWidth(), $pattern->getImageHeight(), $pattern);
$draw->popPattern();

//Draw a rectangle with the pattern
$draw->rectangle(0, 0, $pattern->getImageWidth() * 4, $pattern->getImageHeight() * 4);

//Create a new image and add the drawing
$image = new \Imagick();
$image->newImage(800, 600, 'white');
$image->drawImage($draw);
$image->setImageFormat('png');

//Output the image
header('Content-Type: image/png');
echo $image;
?>

创建了一个imagickdraw对象, 并使用newPseudoImage()方法创建了一个100x100的图案, 使用scaleImage()方法将图案缩小了25%, 并使用pushPattern()方法将图案添加到图形绘制过程中, 然后使用popPattern()方法将其从绘制过程中删除, 最后使用imagemagick的COMPOSITE_OVER组合算法将图案合并到矩形中。

注意事项

• 模式堆栈可以让您在定义一个图案时使用其他图案。如果您从模式堆栈添加图案，则您需要在新的图案定义之前将该图案弹出，同时保留其他定义。
• pushPattern()方法不会创建图案，而只是在堆栈中定义当前的绘图状态。
• pushPattern()方法只支持平移和缩放修饰符。
• 模式必须在popPattern()方法之前完全定义。
• 在使用特定图案之前，请务必对图案进行定义，否则将无法对其进行引用。

参考文献

1. PHP ImagickDraw pushPattern() Function