PHP: полный мануал с примерами, функциями и ООП

PECL imagick 2, PECL imagick 3 · imagick

Imagick::swirlImage(float $degrees): bool

Закрутить фон либо только выбранный орнамент, сохранив служебные надписи.

Координаты (x,y) отсчитываются от верхнего левого угла: x вправо, y вниз; пиксель (0,0) — первый. Width/height — ширина/высота в пикселях, а центр whole-image операций здесь (200,160). Degrees — градусы swirl; amplitude A и length L — пиксели wave; amount implode — безразмерный коэффициент. R и r в модели обозначают нормализованный радиус/расстояние, а не PHP-аргумент implode с именем radius. Билинейная интерполяция смешивает ближайшие четыре отсчёта вокруг дробной координаты чтения; она может создать промежуточные цвета и ослабить тонкую линию. RGB0..255 — уровни сохранённого PNG8; Q означал бы внутренний максимум QuantumRange, здесь Q16=65535, но этим трём вызовам Q не нужен.

Для каждой выходной точки внутри центрального эллипса Core вычисляет координату чтения из исходника. Угол зависит от расстояния до центра: degrees×(1−r/R)², где r — нормализованное расстояние, R — нормализованный радиус эллипса. Вне эллипса каналы копируются. Это обратная выборка, не единый поворот всех точек.

Самая маленькая запись

В $image уже находится загруженная копия. 90 — градусы, не поворот всего файла. Стрелка -> вызывает метод объекта; скобки содержат аргументы, запятая их отделяет, ; завершает команду.

$image->swirlImage(90);

$image = clone $source; создаёт независимый объект; простое присваивание его не копирует. Метод изменяет текущую картинку и возвращает bool. Не присваивайте результат метода обратно в $image: вместо изображения получите true. В полной программе if с ! проверяет false, throw new RuntimeException останавливает отказавшую цепочку, clear освобождает native-ресурсы после сохранения. Подготовка: объекты и методы, clone, исключения.

Сигнатура и все параметры

Imagick::swirlImage(float $degrees): bool

Для каждой выходной точки внутри центрального эллипса Core вычисляет координату чтения из исходника. Угол зависит от расстояния до центра: degrees×(1−r/R)², где r — нормализованное расстояние, R — нормализованный радиус эллипса. Вне эллипса каналы копируются. Это обратная выборка, не единый поворот всех точек.

Все аргументы обязательны, default-значений нет. Channel и interpolation в этих сигнатурах отсутствуют. Возврат true при успехе, текущая картинка заменяется результатом внутри объекта. Пустой объект и native-отказ вызывают ImagickException; это расшифровка исходного [imagick.imagick.throws]. Доступность: PECL imagick 2, PECL imagick 3. Исходный XML не содержит дополнительных записей changelog.

Для внешнего ввода ограничивайте конечность параметров, площадь и будущую высоту; length>0 — наша политика разумного периода. Для implode допустим умеренный отрицательный amount: это направление деформации, а не отрицательный пиксельный радиус ядра. Не обещаем пригодность неограниченных чисел или обратимость после интерполяции.

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="imagick.swirlimage">
 <refnamediv>
  <refname>Imagick::swirlImage</refname>
  <refpurpose>Swirls the pixels about the center of the image</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>

   <type>bool</type><methodname>Imagick::swirlImage</methodname>
   <methodparam><type>float</type><parameter>degrees</parameter></methodparam>
  </methodsynopsis>
  <para>
   Swirls the pixels about the center of the image, where degrees indicates
   the sweep of the arc through which each pixel is moved. You get a more
   dramatic effect as the degrees move from 1 to 360.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>degrees</parameter></term>
     <listitem>
      <para>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &imagick.return.success;
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   &imagick.imagick.throws;
  </para>
 </refsect1>



 <refsect1 role="examples">
  &reftitle.examples;
  <para>
    <example>
      <title> <function>Imagick::swirlImage</function></title>
      <programlisting role="php">
      <![CDATA[
<?php
function swirlImage($imagePath, $swirl) {
    $imagick = new \Imagick(realpath($imagePath));
    $imagick->swirlImage($swirl);
    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();
}

?>
]]>
      </programlisting>
    </example>
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

Официальный веб-пример оформлен функцией: new Imagick(realpath(path)) читает файл, метод меняет объект, header задаёт Content-Type, getImageBlob возвращает двоичные данные для echo. Его выполняют как HTTP-ответ без постороннего вывода. Наши программы создают локальные PNG, а не проверяют сетевую выдачу. Полный исходный пример сохранён выше; функции и файлы объясняются отдельно.

<?php
declare(strict_types=1);

require __DIR__ . '/geom-fixture.php';
$source = loadGeomSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$source->setImageBackgroundColor('rgb(11,22,33)');
$image = clone $source;
if (!$image->swirlImage(90)) {
    throw new RuntimeException('Не удалось применить swirlImage');
}
saveGeomComparison([$source, $image], 'geom-swirl-basic.png');
$source->clear();
$image->clear();

geom-swirl-basic.png

Когда меняется требование

Для макета нужно изменить один орнамент со своим центром (128,200), не затрагивая ленту, заголовок и правую маркировку. Вырезка 192×192 переносит центр операции в середину орнамента, затем возвращается в исходное место.

CropImage(width,height,x,y) вырезает известную область; setImagePage(0,0,0,0) сбрасывает виртуальное смещение. После эффекта compositeImage(...,COMPOSITE_OVER,x,y) размещает слой на независимом исходнике. При непрозрачной вырезке меняется только её прямоугольник, при прозрачной часть исходного слоя видна сквозь alpha. Это не автоматическое распознавание объекта и не мягкая маска по его границе.

<?php
declare(strict_types=1);

require __DIR__ . '/geom-fixture.php';
$source = loadGeomSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$source->setImageBackgroundColor('rgb(11,22,33)');
$image = clone $source;
$region = clone $source;
$region->cropImage(192, 192, 32, 104);
$region->setImagePage(0, 0, 0, 0);
if (!$region->swirlImage(180)) {
    throw new RuntimeException('Не удалось применить swirlImage');
}
if (!$image->compositeImage($region, Imagick::COMPOSITE_OVER, 32, 104)) {
    throw new RuntimeException('Не удалось вернуть орнамент');
}
$region->clear();
saveGeomComparison([$source, $image], 'geom-swirl-protected.png');
$source->clear();
$image->clear();

geom-swirl-protected.png

Проверка и следующий выбор

Сохраняйте исходник и проверяйте маркировку в реальном размере. Интерполяция меняет значения и может ослабить текст/штрихкод; геометрический эффект не восстанавливает деталь. Если нужно сохранить надпись, задайте область до обработки или наложите текст после неё. Цвет, alpha и размеры файла проверяются отдельно. Для художественной фактуры есть уголь/скетч/масляный эффект, для тональной коррекции — растяжение диапазона.

Связанные варианты: waveImage · implodeImage.

• Imagick::swirlImage
• Imagick3.8.1wrapper
• ImageMagick7.1.1-46visual-effects.c

PECL imagick 2, PECL imagick 3 · imagick

Imagick::waveImage(float $amplitude, float $length): bool

Сохранить полный волнистый PNG и отдельную прозрачную ленту для компоновки.

Координаты (x,y) отсчитываются от верхнего левого угла: x вправо, y вниз; пиксель (0,0) — первый. Width/height — ширина/высота в пикселях, а центр whole-image операций здесь (200,160). Degrees — градусы swirl; amplitude A и length L — пиксели wave; amount implode — безразмерный коэффициент. R и r в модели обозначают нормализованный радиус/расстояние, а не PHP-аргумент implode с именем radius. Билинейная интерполяция смешивает ближайшие четыре отсчёта вокруг дробной координаты чтения; она может создать промежуточные цвета и ослабить тонкую линию. RGB0..255 — уровни сохранённого PNG8; Q означал бы внутренний максимум QuantumRange, здесь Q16=65535, но этим трём вызовам Q не нужен.

Каждый столбец смещается вертикально по синусоиде. При амплитуде A и периоде L источник читается в (x,y−dy), где dy=abs(A)+A×sin(2πx/L). Abs — модуль, sin — синус, π — математическая константа. Ширина прежняя; высота size_t(H+2×abs(A)), то есть дробная часть при положительном размере отбрасывается. Core принудительно использует background за рамкой.

Самая маленькая запись

В $image уже находится загруженная копия. 12 — амплитуда, 100 — горизонтальный период, оба в пикселях; итоговая высота увеличится. Стрелка -> вызывает метод объекта; скобки содержат аргументы, запятая их отделяет, ; завершает команду.

$image->waveImage(12, 100);

$image = clone $source; создаёт независимый объект; простое присваивание его не копирует. Метод изменяет текущую картинку и возвращает bool. Не присваивайте результат метода обратно в $image: вместо изображения получите true. В полной программе if с ! проверяет false, throw new RuntimeException останавливает отказавшую цепочку, clear освобождает native-ресурсы после сохранения. Подготовка: объекты и методы, clone, исключения.

Сигнатура и все параметры

Imagick::waveImage(float $amplitude, float $length): bool

Каждый столбец смещается вертикально по синусоиде. При амплитуде A и периоде L источник читается в (x,y−dy), где dy=abs(A)+A×sin(2πx/L). Abs — модуль, sin — синус, π — математическая константа. Ширина прежняя; высота size_t(H+2×abs(A)), то есть дробная часть при положительном размере отбрасывается. Core принудительно использует background за рамкой.

Все аргументы обязательны, default-значений нет. Channel и interpolation в этих сигнатурах отсутствуют. Возврат true при успехе, текущая картинка заменяется результатом внутри объекта. Пустой объект и native-отказ вызывают ImagickException; это расшифровка исходного [imagick.imagick.throws]. Доступность: PECL imagick 2, PECL imagick 3. Исходный XML не содержит дополнительных записей changelog.

Условие исходного XML [imagick.method.available.0x629] означает ImageMagick 6.2.9 или новее. В официальном примере также предупреждение: wave может работать довольно медленно; наше время относительно других методов не измерялось. В исходном See also сохранены solarizeImage, oilpaintImage, embossImage, addNoiseImage и swirlImage: это соседние эффекты, а не обязательные шаги wave.

Для внешнего ввода ограничивайте конечность параметров, площадь и будущую высоту; length>0 — наша политика разумного периода. Для implode допустим умеренный отрицательный amount: это направление деформации, а не отрицательный пиксельный радиус ядра. Не обещаем пригодность неограниченных чисел или обратимость после интерполяции.

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="imagick.waveimage">
 <refnamediv>
  <refname>Imagick::waveImage</refname>
  <refpurpose>Applies wave filter to the image</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <modifier>public</modifier> <type>bool</type><methodname>Imagick::waveImage</methodname>
   <methodparam><type>float</type><parameter>amplitude</parameter></methodparam>
   <methodparam><type>float</type><parameter>length</parameter></methodparam>
  </methodsynopsis>

  <para>
   Applies a wave filter to the image. 
   &imagick.method.available.0x629;
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>amplitude</parameter></term>
     <listitem>
      <para>
       The amplitude of the wave.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>length</parameter></term>
     <listitem>
      <para>
       The length of the wave.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &imagick.return.success;
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   &imagick.imagick.throws;
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
    <example>
      <title>WaveImage can be quite slow <function>Imagick::waveImage</function></title>
      <programlisting role="php">
      <![CDATA[
<?php
function waveImage($imagePath, $amplitude, $length) {
    $imagick = new \Imagick(realpath($imagePath));
    $imagick->waveImage($amplitude, $length);
    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();
}

?>
]]>
      </programlisting>
    </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>Imagick::solarizeImage</function></member>
    <member><function>Imagick::oilpaintImage</function></member>
    <member><function>Imagick::embossImage</function></member>
    <member><function>Imagick::addNoiseImage</function></member>
    <member><function>Imagick::swirlImage</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

Официальный веб-пример оформлен функцией: new Imagick(realpath(path)) читает файл, метод меняет объект, header задаёт Content-Type, getImageBlob возвращает двоичные данные для echo. Его выполняют как HTTP-ответ без постороннего вывода. Наши программы создают локальные PNG, а не проверяют сетевую выдачу. Полный исходный пример сохранён выше; функции и файлы объясняются отдельно.

<?php
declare(strict_types=1);

require __DIR__ . '/geom-fixture.php';
$source = loadGeomSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$source->setImageBackgroundColor('rgb(11,22,33)');
$image = clone $source;
if (!$image->waveImage(12, 100)) {
    throw new RuntimeException('Не удалось применить waveImage');
}
$image->setImageFormat('png');
$image->setImageDepth(8);
$image->setOption('png:color-type', '2');
if (!$image->writeImage(__DIR__ . '/wave-full.png')) {
    throw new RuntimeException('Не удалось сохранить полный PNG');
}
saveGeomComparison([$source, $image], 'geom-wave-full.png');
$source->clear();
$image->clear();

geom-wave-full.png

Когда меняется требование

Нужна самостоятельная лента для последующей компоновки. Вырезаем цветную полосу 336×48, задаём transparent для новых областей, применяем wave(8,80) и сохраняем полный RGBA PNG 336×64. Затем COMPOSITE_OVER размещает её поверх исходного макета в (32,32).

CropImage(width,height,x,y) вырезает известную область; setImagePage(0,0,0,0) сбрасывает виртуальное смещение. После эффекта compositeImage(...,COMPOSITE_OVER,x,y) размещает слой на независимом исходнике. При непрозрачной вырезке меняется только её прямоугольник, при прозрачной часть исходного слоя видна сквозь alpha. Это не автоматическое распознавание объекта и не мягкая маска по его границе.

Transparent — полностью прозрачный цвет фона новых отсчётов, а не удаление похожего цвета существующей ленты. SetImageFormat(png), depth8 и png:color-type6 сохраняют RGBA PNG8 с alpha. RGB comparison использует color-type2 и белую подложку; самостоятельный wave-ribbon.png сохраняет прозрачность. Заголовок выше y=32 остаётся точным; прежняя прямая полоса под прозрачными краями специально не удаляется.

<?php
declare(strict_types=1);

require __DIR__ . '/geom-fixture.php';
$source = loadGeomSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$source->setImageBackgroundColor('rgb(11,22,33)');
$image = clone $source;
$ribbon = clone $source;
$ribbon->cropImage(336, 48, 32, 40);
$ribbon->setImagePage(0, 0, 0, 0);
$ribbon->setImageBackgroundColor('transparent');
if (!$ribbon->waveImage(8, 80)) {
    throw new RuntimeException('Не удалось применить waveImage');
}
$ribbon->setImageFormat('png');
$ribbon->setImageDepth(8);
$ribbon->setOption('png:color-type', '6');
if (!$ribbon->writeImage(__DIR__ . '/wave-ribbon.png')) {
    throw new RuntimeException('Не удалось сохранить полный PNG');
}
$ribbon->clear();
$ribbon = new Imagick(__DIR__ . '/wave-ribbon.png');
if (!$image->compositeImage($ribbon, Imagick::COMPOSITE_OVER, 32, 32)) {
    throw new RuntimeException('Не удалось разместить ленту');
}
$ribbon->clear();
saveGeomComparison([$source, $image], 'geom-wave-ribbon.png');
$source->clear();
$image->clear();

geom-wave-ribbon.png

Проверка и следующий выбор

Сохраняйте исходник и проверяйте маркировку в реальном размере. Интерполяция меняет значения и может ослабить текст/штрихкод; геометрический эффект не восстанавливает деталь. Если нужно сохранить надпись, задайте область до обработки или наложите текст после неё. Цвет, alpha и размеры файла проверяются отдельно. Для художественной фактуры есть уголь/скетч/масляный эффект, для тональной коррекции — растяжение диапазона.

Связанные варианты: swirlImage · implodeImage.

• Imagick::waveImage
• Imagick3.8.1wrapper
• ImageMagick7.1.1-46visual-effects.c

PECL imagick 2, PECL imagick 3 · imagick

Imagick::implodeImage(float $radius): bool

Подобрать радиальное втягивание/раздувание декоративного медальона.

Координаты (x,y) отсчитываются от верхнего левого угла: x вправо, y вниз; пиксель (0,0) — первый. Width/height — ширина/высота в пикселях, а центр whole-image операций здесь (200,160). Degrees — градусы swirl; amplitude A и length L — пиксели wave; amount implode — безразмерный коэффициент. R и r в модели обозначают нормализованный радиус/расстояние, а не PHP-аргумент implode с именем radius. Билинейная интерполяция смешивает ближайшие четыре отсчёта вокруг дробной координаты чтения; она может создать промежуточные цвета и ослабить тонкую линию. RGB0..255 — уровни сохранённого PNG8; Q означал бы внутренний максимум QuantumRange, здесь Q16=65535, но этим трём вызовам Q не нужен.

PHP-аргумент с именем radius поступает в Core как amount. Для каждой выходной точки внутри центрального эллипса вычисляется factor=sin(πr/(2R))^(−amount), затем исходная координата center+factor×delta. Factor — безразмерный множитель расстояния; delta — смещение от центра. При положительном amount выходная точка читает дальше от центра, и видимый рисунок втягивается; при отрицательном — раздувается. Это не физическая линза и не исправление её аберраций.

Самая маленькая запись

В $image уже находится загруженная копия. 0.5 — безразмерный amount, хотя PHP-параметр называется radius. Стрелка -> вызывает метод объекта; скобки содержат аргументы, запятая их отделяет, ; завершает команду.

$image->implodeImage(0.5);

$image = clone $source; создаёт независимый объект; простое присваивание его не копирует. Метод изменяет текущую картинку и возвращает bool. Не присваивайте результат метода обратно в $image: вместо изображения получите true. В полной программе if с ! проверяет false, throw new RuntimeException останавливает отказавшую цепочку, clear освобождает native-ресурсы после сохранения. Подготовка: объекты и методы, clone, исключения.

Сигнатура и все параметры

Imagick::implodeImage(float $radius): bool

PHP-аргумент с именем radius поступает в Core как amount. Для каждой выходной точки внутри центрального эллипса вычисляется factor=sin(πr/(2R))^(−amount), затем исходная координата center+factor×delta. Factor — безразмерный множитель расстояния; delta — смещение от центра. При положительном amount выходная точка читает дальше от центра, и видимый рисунок втягивается; при отрицательном — раздувается. Это не физическая линза и не исправление её аберраций.

Все аргументы обязательны, default-значений нет. Channel и interpolation в этих сигнатурах отсутствуют. Возврат true при успехе, текущая картинка заменяется результатом внутри объекта. Пустой объект и native-отказ вызывают ImagickException; это расшифровка исходного [imagick.imagick.throws]. Доступность: PECL imagick 2, PECL imagick 3. Исходный XML не содержит дополнительных записей changelog.

Для внешнего ввода ограничивайте конечность параметров, площадь и будущую высоту; length>0 — наша политика разумного периода. Для implode допустим умеренный отрицательный amount: это направление деформации, а не отрицательный пиксельный радиус ядра. Не обещаем пригодность неограниченных чисел или обратимость после интерполяции.

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="imagick.implodeimage">
 <refnamediv>
  <refname>Imagick::implodeImage</refname>
  <refpurpose>Creates a new image as a copy</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <modifier>public</modifier> <type>bool</type><methodname>Imagick::implodeImage</methodname>
   <methodparam><type>float</type><parameter>radius</parameter></methodparam>
  </methodsynopsis>
  <para>
   Creates a new image that is a copy of an existing one with the image pixels
   "imploded" by the specified percentage.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>radius</parameter></term>
     <listitem>
      <para>
      The radius of the implode
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &imagick.return.success;
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   &imagick.imagick.throws;
  </para>
 </refsect1>



 <refsect1 role="examples">
  &reftitle.examples;
  <para>
    <example>
      <title> <function>Imagick::implodeImage</function></title>
      <programlisting role="php">
      <![CDATA[
<?php
function implodeImage($imagePath) {
    $imagick = new \Imagick(realpath($imagePath));
    $imagick->implodeImage(0.0001);
    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();

}

?>
]]>
      </programlisting>
    </example>
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

Официальный веб-пример оформлен функцией: new Imagick(realpath(path)) читает файл, метод меняет объект, header задаёт Content-Type, getImageBlob возвращает двоичные данные для echo. Его выполняют как HTTP-ответ без постороннего вывода. Наши программы создают локальные PNG, а не проверяют сетевую выдачу. Полный исходный пример сохранён выше; функции и файлы объясняются отдельно.

<?php
declare(strict_types=1);

require __DIR__ . '/geom-fixture.php';
$source = loadGeomSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$source->setImageBackgroundColor('rgb(11,22,33)');
$image = clone $source;
if (!$image->implodeImage(0.5)) {
    throw new RuntimeException('Не удалось применить implodeImage');
}
saveGeomComparison([$source, $image], 'geom-implode-basic.png');
$source->clear();
$image->clear();

geom-implode-basic.png

Когда меняется требование

Нужно сравнить две формы декоративного медальона в его собственном центре. На независимых копиях одной вырезки применим amount 0.5 и -0.5, вставим в одинаковые места и проверим защищённую внешнюю область.

CropImage(width,height,x,y) вырезает известную область; setImagePage(0,0,0,0) сбрасывает виртуальное смещение. После эффекта compositeImage(...,COMPOSITE_OVER,x,y) размещает слой на независимом исходнике. При непрозрачной вырезке меняется только её прямоугольник, при прозрачной часть исходного слоя видна сквозь alpha. Это не автоматическое распознавание объекта и не мягкая маска по его границе.

У второй копии amount=-0.5 задаёт противоположную радиальную подачу. Это знак безразмерного коэффициента, а не отрицательный радиус свёртки. Обе картинки получены из одного исходника; второй эффект не применяется поверх первого. || означает «или»: отказ любой вставки прекращает цепочку.

<?php
declare(strict_types=1);

require __DIR__ . '/geom-fixture.php';
$source = loadGeomSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$source->setImageBackgroundColor('rgb(11,22,33)');
$image = clone $source;
$region = clone $source;
$region->cropImage(192, 192, 32, 104);
$region->setImagePage(0, 0, 0, 0);
$outward = clone $region;
if (!$region->implodeImage(0.5)) {
    throw new RuntimeException('Не удалось применить implodeImage');
}
if (!$outward->implodeImage(-0.5)) {
    throw new RuntimeException('Не удалось применить implodeImage');
}
$expanded = clone $source;
if (!$image->compositeImage($region, Imagick::COMPOSITE_OVER, 32, 104) || !$expanded->compositeImage($outward, Imagick::COMPOSITE_OVER, 32, 104)) {
    throw new RuntimeException('Не удалось вернуть вариант медальона');
}
$region->clear();
$outward->clear();
saveGeomComparison([$source, $image, $expanded], 'geom-implode-medallion.png');
$source->clear();
$image->clear();
$expanded->clear();

geom-implode-medallion.png

Проверка и следующий выбор

Сохраняйте исходник и проверяйте маркировку в реальном размере. Интерполяция меняет значения и может ослабить текст/штрихкод; геометрический эффект не восстанавливает деталь. Если нужно сохранить надпись, задайте область до обработки или наложите текст после неё. Цвет, alpha и размеры файла проверяются отдельно. Для художественной фактуры есть уголь/скетч/масляный эффект, для тональной коррекции — растяжение диапазона.

Связанные варианты: swirlImage · waveImage.

• Imagick::implodeImage
• Imagick3.8.1wrapper
• ImageMagick7.1.1-46visual-effects.c