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

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathStart(): bool

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

pathStart открывает запись пути; move выбирает начальную позицию, line рисует участки, pathFinish завершает запись. Нельзя вызывать path-команды как независимые фигуры вне этой пары.

Сигнатура: ImagickDraw::pathStart(): bool

Параметров нет. Пустые скобки () всё равно нужны: они вызывают метод. Начало, текущая точка и список команд уже хранятся в объекте Draw; этот вызов меняет состояние списка, не принимает картинку отдельным аргументом.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathstart",
  "name": "ImagickDraw::pathStart",
  "purpose_en": "Declares the start of a path drawing list",
  "description_en": "Declares the start of a path drawing list which is terminated by a matching DrawPathFinish() command. All other DrawPath commands must be enclosed between a and a DrawPathFinish() command. This is because path drawing commands are subordinate commands and they do not function by themselves.",
  "signature": "ImagickDraw::pathStart(): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [
    {
      "title": "ImagickDraw::pathStart example",
      "language": "php",
      "code_sha256": "0bf05f1348dd3fbd23053b310718c31a92f717319b1885470d927625b01e8967"
    }
  ],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathstart.php",
  "official_page_sha256": "deb55b5f61456c5111ba07af094f5aed39725177c64bd430c9030b4a87cfce23",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathstart.xml",
  "xml_sha256": "3460aa4d38599eb74d9a05869f2d5a41804c530bcd2657539e7e73e722abf7fb",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(25, 120);
$draw->pathLineToAbsolute(100, 60);
$draw->pathLineToAbsolute(210, 100);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathstart-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathstart-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Два независимых оформления в одной картинке

Открытый маршрут курьера и закрашенная площадка имеют разные стили. Записываем их отдельными путями, каждый со своей парой Start/Finish.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(340, 170, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(20, 130);
$draw->pathLineToAbsolute(100, 45);
$draw->pathLineToAbsolute(180, 90);
$draw->pathFinish();
$draw->setFillColor('#bdebe2');
$draw->setStrokeColor('#c25732');
$draw->pathStart();
$draw->pathMoveToAbsolute(225, 45);
$draw->pathLineToHorizontalAbsolute(300);
$draw->pathLineToVerticalAbsolute(130);
$draw->pathLineToHorizontalAbsolute(225);
$draw->pathClose();
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/route-and-area.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'route-and-area.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Вложенный pathStart без завершения предыдущего пути — ошибка построения списка. Новый путь нужен, например, при смене оформления; move внутри одного пути создаёт только новый подконтур.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathFinish, ImagickDraw::pathMoveToAbsolute, ImagickDraw::pathClose. Ошибки получения файла: файлы и права.

• ImagickDraw::pathStart
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathFinish(): bool

Для открытого маршрута нужно завершить список команд и затем применить его к изображению. Соединять конец с началом нельзя: это добавило бы несуществующий участок.

pathFinish заканчивает определение пути. В нашем примере после двух отрезков остаётся угол: диагональ из (200,125) в (40,35) не появляется. Для её добавления служит отдельный pathClose.

Сигнатура: ImagickDraw::pathFinish(): bool

Параметров нет. Пустые скобки () всё равно нужны: они вызывают метод. Начало, текущая точка и список команд уже хранятся в объекте Draw; этот вызов меняет состояние списка, не принимает картинку отдельным аргументом.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathfinish",
  "name": "ImagickDraw::pathFinish",
  "purpose_en": "Terminates the current path",
  "description_en": "Terminates the current path.",
  "signature": "ImagickDraw::pathFinish(): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathfinish.php",
  "official_page_sha256": "bd4d4691443c6249f09006fe16a4f13c6cf31c99433ff237557bd68aa536e616",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathfinish.xml",
  "xml_sha256": "c857c9f925cbe0391b005d55c1d002ef9e5a457a956850362e2b2723c9904c5a",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(40, 35);
$draw->pathLineToAbsolute(200, 35);
$draw->pathLineToAbsolute(200, 125);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathfinish-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathfinish-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: После пути добавить обычный круглый маркер

Нужно показать маршрут и крупную отметку последней остановки. Путь закончился; затем вызываем уже знакомый circle как самостоятельную фигуру, не как path-команду.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(300, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(30, 125);
$draw->pathLineToHorizontalAbsolute(130);
$draw->pathLineToAbsolute(250, 55);
$draw->pathFinish();
$draw->setFillColor('#c25732');
$draw->setStrokeColor('#c25732');
$draw->circle(250, 55, 262, 55);
$image->drawImage($draw);
$path = __DIR__ . '/route-end-marker.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'route-end-marker.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Не заменяйте pathClose на pathFinish и наоборот. Finish не сохраняет PNG и не вызывает drawImage. Не оставляйте путь незавершённым в надежде, что writeImage исправит его.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathStart, ImagickDraw::pathClose. Ошибки получения файла: файлы и права.

• ImagickDraw::pathFinish
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathClose(): bool

На отчёте нужна закрашенная треугольная область с обводкой со всех сторон. Две стороны заданы явно, третью нужно провести к началу.

pathClose добавляет прямой участок из текущей точки (200,125) к началу текущего подконтура (40,35). Затем текущей снова становится (40,35), а pathFinish завершает весь путь.

Сигнатура: ImagickDraw::pathClose(): bool

Параметров нет. Пустые скобки () всё равно нужны: они вызывают метод. Начало, текущая точка и список команд уже хранятся в объекте Draw; этот вызов меняет состояние списка, не принимает картинку отдельным аргументом.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathclose",
  "name": "ImagickDraw::pathClose",
  "purpose_en": "Adds a path element to the current path",
  "description_en": "Adds a path element to the current path which closes the current subpath by drawing a straight line from the current point to the current subpath's most recent starting point (usually, the most recent moveto point).",
  "signature": "ImagickDraw::pathClose(): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathclose.php",
  "official_page_sha256": "6b986b322b726d38fec797049a3dcdcc2e241a98d5aac3b9273d1c224edd5270",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathclose.xml",
  "xml_sha256": "7c9516af0154eb6da759cbcdf94dad5fb0b9e35f81422a631a27cce530f282aa",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('#bdebe2');
$draw->pathStart();
$draw->pathMoveToAbsolute(40, 35);
$draw->pathLineToAbsolute(200, 35);
$draw->pathLineToAbsolute(200, 125);
$draw->pathClose();
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathclose-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathclose-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Замкнутая деталь и выносная линия из её начального угла

На техническом эскизе сначала нужна цельная граница детали, затем короткий вынос вверх-влево именно из начального угла. Возврат текущей точки после Close убирает ручной пересчёт.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(40, 40);
$draw->pathLineToHorizontalAbsolute(180);
$draw->pathLineToVerticalAbsolute(120);
$draw->pathLineToHorizontalAbsolute(40);
$draw->pathClose();
$draw->pathLineToRelative(-20, -20);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/detail-with-callout.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'detail-with-callout.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Закрывается последний подконтур, а не все фигуры в pathStart. Close даёт замкнутый стык обводки; обычный LineTo назад к первой точке может оставить два окончания linecap вместо одного linejoin. При последующей Relative отсчёт идёт от начала закрытого подконтура.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathFinish, ImagickDraw::pathMoveToAbsolute, ImagickDraw::pathLineToRelative. Ошибки получения файла: файлы и права.

• ImagickDraw::pathClose
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathMoveToAbsolute(float $x, float $y): bool

На технической схеме два раздельных соединения; диагональ между ними была бы ложной связью.

MoveToAbsolute задаёт новую абсолютную позицию и начало подконтура. Переход от (100,45) к (140,115) не рисуется. Только следующий LineTo снова оставляет след.

Сигнатура: ImagickDraw::pathMoveToAbsolute(float $x, float $y): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathmovetoabsolute",
  "name": "ImagickDraw::pathMoveToAbsolute",
  "purpose_en": "Starts a new sub-path",
  "description_en": "Starts a new sub-path at the given coordinate using absolute coordinates. The current point then becomes the specified coordinate.",
  "signature": "ImagickDraw::pathMoveToAbsolute(float $x, float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "x coordinate of the starting point"
    },
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "y coordinate of the starting point"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathmovetoabsolute.php",
  "official_page_sha256": "857384db5a5d5101cea7426fa0567d877a43c8a5761d9fcf47adabca62d9b855",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathmovetoabsolute.xml",
  "xml_sha256": "316f8becbb2468ac886c6b5a653c4d16d21e56fd500acf0722e338a66bc2a46d",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(20, 45);
$draw->pathLineToAbsolute(100, 45);
$draw->pathMoveToAbsolute(140, 115);
$draw->pathLineToAbsolute(220, 115);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathmovetoabsolute-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathmovetoabsolute-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Три раздельные парковочные ячейки

Рисуем повторяющиеся открытые сверху ячейки по известным абсолютным позициям. Между соседними ячейками не должно быть диагональных соединений.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
foreach ([30, 120, 210] as $x) {
    $draw->pathMoveToAbsolute($x, 35);
    $draw->pathLineToVerticalAbsolute(125);
    $draw->pathLineToHorizontalAbsolute($x + 55);
    $draw->pathLineToVerticalAbsolute(35);
}
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/parking-slots.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'parking-slots.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Слово move означает смену позиции, а не отрезок. Каждый новый move меняет точку, к которой вернётся pathClose. Не используйте move, если нужно сохранить непрерывное соединение.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathMoveToRelative, ImagickDraw::pathLineToAbsolute, ImagickDraw::pathClose. Ошибки получения файла: файлы и права.

• ImagickDraw::pathMoveToAbsolute
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathMoveToRelative(float $x, float $y): bool

Повторяющийся символ нужно поставить после предыдущего с заданным промежутком. Пересчитывать абсолютные координаты каждого фрагмента неудобно.

До вызова текущая точка (100,45). Смещение (40,70) даёт новое начало (140,115), без линии между ними. Следующий относительный отрезок (80,0) оканчивается в (220,115).

Сигнатура: ImagickDraw::pathMoveToRelative(float $x, float $y): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathmovetorelative",
  "name": "ImagickDraw::pathMoveToRelative",
  "purpose_en": "Starts a new sub-path",
  "description_en": "Starts a new sub-path at the given coordinate using relative coordinates. The current point then becomes the specified coordinate.",
  "signature": "ImagickDraw::pathMoveToRelative(float $x, float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "target x coordinate"
    },
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "target y coordinate"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathmovetorelative.php",
  "official_page_sha256": "5958230d7319b4b004e92b3ce75e4459693210e3205479714205b2a9fc2ce2ab",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathmovetorelative.xml",
  "xml_sha256": "e28e50165883664511369c204b520444b15c25a7a5624107c10b79681755090d",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(20, 45);
$draw->pathLineToAbsolute(100, 45);
$draw->pathMoveToRelative(40, 70);
$draw->pathLineToRelative(80, 0);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathmovetorelative-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathmovetorelative-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Повторить отдельный шеврон с промежутком

Нужен ряд одинаковых уголков на инструкции упаковки. Рисуем каждый двумя локальными шагами, затем поднимаем перо и пропускаем промежуток 20.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 150, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(25, 95);
foreach ([1, 2, 3] as $symbol) {
    $draw->pathLineToRelative(40, -45);
    $draw->pathLineToRelative(40, 45);
    $draw->pathMoveToRelative(20, 0);
}
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/packing-chevrons.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'packing-chevrons.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Смещение считается от текущего конца, а не от последнего MoveTo. Не путайте его с переносом всего существующего рисунка: уже записанные команды не сдвигаются. Первый явный MoveToAbsolute делает начальную опорную точку понятной.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathMoveToAbsolute, ImagickDraw::pathLineToRelative. Ошибки получения файла: файлы и права.

• ImagickDraw::pathMoveToRelative
• W3C: модель path/current point

PECL imagick 2 · imagick

ImagickDraw::pathLineToAbsolute(float $x, float $y): bool

Измерения уже пересчитаны в точки отчётного изображения. Нужно соединить соседние точки в заданном порядке.

Начало берётся из текущей точки. Аргументы задают только конец: сначала (100,60), затем (210,100). После каждого вызова этот конец становится новым текущим положением.

Сигнатура: ImagickDraw::pathLineToAbsolute(float $x, float $y): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathlinetoabsolute",
  "name": "ImagickDraw::pathLineToAbsolute",
  "purpose_en": "Draws a line path",
  "description_en": "Draws a line path from the current point to the given coordinate using absolute coordinates. The coordinate then becomes the new current point.",
  "signature": "ImagickDraw::pathLineToAbsolute(float $x, float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "starting x coordinate"
    },
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "ending x coordinate"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathlinetoabsolute.php",
  "official_page_sha256": "0015f54aedad3063270f37a127bb517f37d7c5a34c9b3512ce5258de18730271",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathlinetoabsolute.xml",
  "xml_sha256": "ae23c7808be039541690ee391bf9fba214d775a33ab3886dadd41b667c12c64a",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(25, 120);
$draw->pathLineToAbsolute(100, 60);
$draw->pathLineToAbsolute(210, 100);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathlinetoabsolute-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathlinetoabsolute-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Линия заявок из четырёх числовых наблюдений

В массиве четыре количества заявок: 20,90,45,110. Превращаем индекс в x, значение — в y и соединяем соседние периоды.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$values = [20, 90, 45, 110];
$draw->pathStart();
foreach ($values as $index => $value) {
    $x = 30 + $index * 80;
    $y = 150 - $value;
    if ($index === 0) {
        $draw->pathMoveToAbsolute($x, $y);
    } else {
        $draw->pathLineToAbsolute($x, $y);
    }
}
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/requests-path.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'requests-path.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

В сигнатуре нет аргументов начала: перед первым отрезком задайте MoveTo. Неточности коротких подписей параметров в PHP Manual не меняют семантику: x и y здесь координаты конца. Для готового массива вершин без смешанных команд проще polyline.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathMoveToAbsolute, ImagickDraw::pathLineToRelative, ImagickDraw::pathLineToHorizontalAbsolute. Ошибки получения файла: файлы и права.

• ImagickDraw::pathLineToAbsolute
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathLineToRelative(float $x, float $y): bool

Известны длины и направления шагов: вправо-вверх, затем вправо-вниз. Их нужно последовательно откладывать от предыдущего конца.

Из (25,120) смещение (75,-60) приводит в (100,60). Следующая команда (110,40) отсчитывается уже от (100,60) и заканчивается в (210,100). Минус у y ведёт вверх.

Сигнатура: ImagickDraw::pathLineToRelative(float $x, float $y): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathlinetorelative",
  "name": "ImagickDraw::pathLineToRelative",
  "purpose_en": "Draws a line path",
  "description_en": "Draws a line path from the current point to the given coordinate using relative coordinates. The coordinate then becomes the new current point.",
  "signature": "ImagickDraw::pathLineToRelative(float $x, float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "starting x coordinate"
    },
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "starting y coordinate"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathlinetorelative.php",
  "official_page_sha256": "915c4c983f052c620d804d995ab762583b3d5d29d771cdc5e002b71caa01e830",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathlinetorelative.xml",
  "xml_sha256": "6a23be44223b890e88164c283533a49ee83c0adbde01bb156fb4d4fa21fa2bc0",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(25, 120);
$draw->pathLineToRelative(75, -60);
$draw->pathLineToRelative(110, 40);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathlinetorelative-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathlinetorelative-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Контур упаковки из списка смещений

Выкройка задана последовательностью векторов относительно предыдущего узла. Список можно хранить как шаблон и устанавливать в другом начальном положении.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(300, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('#bdebe2');
$steps = [
    ['dx' => 60, 'dy' => -25], ['dx' => 60, 'dy' => 25],
    ['dx' => 0, 'dy' => 70], ['dx' => -60, 'dy' => 25],
    ['dx' => -60, 'dy' => -25], ['dx' => 0, 'dy' => -70],
];
$draw->pathStart();
$draw->pathMoveToAbsolute(80, 50);
foreach ($steps as $step) {
    $draw->pathLineToRelative($step['dx'], $step['dy']);
}
$draw->pathClose();
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/package-outline.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'package-outline.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

После каждого line текущая точка меняется; сложите смещения, чтобы найти итог. Отрицательные значения допустимы как движение влево/вверх, но могут вывести рисунок за холст. Relative не означает проценты или долю ширины.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathLineToAbsolute, ImagickDraw::pathMoveToRelative, ImagickDraw::pathLineToVerticalRelative. Ошибки получения файла: файлы и права.

• ImagickDraw::pathLineToRelative
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathLineToHorizontalAbsolute(float $x): bool

Несколько разделителей таблицы должны заканчиваться на одной правой границе, независимо от начальной позиции.

Меняется только x, y сохраняется. Из (30,45) команда H200 приводит в (200,45); после V110 команда H80 приводит в (80,110), то есть влево.

Сигнатура: ImagickDraw::pathLineToHorizontalAbsolute(float $x): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathlinetohorizontalabsolute",
  "name": "ImagickDraw::pathLineToHorizontalAbsolute",
  "purpose_en": "Draws a horizontal line path",
  "description_en": "Draws a horizontal line path from the current point to the target point using absolute coordinates. The target point then becomes the new current point.",
  "signature": "ImagickDraw::pathLineToHorizontalAbsolute(float $x): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "x coordinate"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathlinetohorizontalabsolute.php",
  "official_page_sha256": "7d88d42b0f7b713b464a4f63fb59c7449b6ffdd5d59a556a8d5bc87c6e4bf7c9",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathlinetohorizontalabsolute.xml",
  "xml_sha256": "957a041272f9b1fb994afecb3f72f04189e6273d8ffdf153ac0b2d2c2adeac53",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(30, 45);
$draw->pathLineToHorizontalAbsolute(200);
$draw->pathLineToVerticalAbsolute(110);
$draw->pathLineToHorizontalAbsolute(80);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathlinetohorizontalabsolute-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathlinetohorizontalabsolute-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Разделители строк с общей правой границей

В PNG-таблице есть строки на разной высоте. Все линии должны закончиться на x=280, а начаться на x=30.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 170, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
foreach ([40, 85, 130] as $y) {
    $draw->pathMoveToAbsolute(30, $y);
    $draw->pathLineToHorizontalAbsolute(280);
}
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/table-rules.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'table-rules.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Аргумент — конечная x-координата, не длина. Если x меньше текущего, линия идёт влево. Нужна диагональ — выбирайте LineToAbsolute, меняющий сразу обе координаты.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathLineToHorizontalRelative, ImagickDraw::pathLineToVerticalAbsolute, ImagickDraw::pathLineToAbsolute. Ошибки получения файла: файлы и права.

• ImagickDraw::pathLineToHorizontalAbsolute
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathLineToHorizontalRelative(float $x): bool

Маршрут состоит из участков известной протяжённости; удобно наращивать их, не считая заранее каждый абсолютный конец.

Из (30,45) h170 даёт (200,45). После спуска v65 текущая (200,110); h-120 заканчивается в (80,110). Отрицательный сдвиг ведёт влево.

Сигнатура: ImagickDraw::pathLineToHorizontalRelative(float $x): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathlinetohorizontalrelative",
  "name": "ImagickDraw::pathLineToHorizontalRelative",
  "purpose_en": "Draws a horizontal line",
  "description_en": "Draws a horizontal line path from the current point to the target point using relative coordinates. The target point then becomes the new current point.",
  "signature": "ImagickDraw::pathLineToHorizontalRelative(float $x): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "x coordinate"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathlinetohorizontalrelative.php",
  "official_page_sha256": "72fc75a566ba3ab64b9515cd303ae57de94dde69cfbc8a09e92542313a0506ae",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathlinetohorizontalrelative.xml",
  "xml_sha256": "3285dabeec734ade354c19b5e488e6470bf4eaa77e5f4eb6cdaff8c4ea1f55d8",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(30, 45);
$draw->pathLineToHorizontalRelative(170);
$draw->pathLineToVerticalRelative(65);
$draw->pathLineToHorizontalRelative(-120);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathlinetohorizontalrelative-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathlinetohorizontalrelative-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Ступенчатый маршрут по длинам участков

Для схемы монтажных переходов известны три горизонтальных участка 60,120,80 и одинаковый спуск 25 после каждого. Суммирование концов берёт на себя текущая точка пути.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 140, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$lengths = [60, 120, 80];
$draw->pathStart();
$draw->pathMoveToAbsolute(20, 30);
foreach ($lengths as $length) {
    $draw->pathLineToHorizontalRelative($length);
    $draw->pathLineToVerticalRelative(25);
}
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/installation-steps.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'installation-steps.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Не передавайте абсолютный правый край вместо смещения: от x=30 аргумент 200 даст x=230. h0 не рисует протяжённый участок. Величина сдвига измеряется в единицах холста.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathLineToHorizontalAbsolute, ImagickDraw::pathLineToVerticalRelative. Ошибки получения файла: файлы и права.

• ImagickDraw::pathLineToHorizontalRelative
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathLineToVerticalAbsolute(float $y): bool

В диаграмме столбики разной высоты должны доходить до одной общей нижней линии.

Меняется только y, x сохраняется. Из (50,25) V130 приходит в (50,130); после H190 команда V60 идёт вверх к (190,60).

Сигнатура: ImagickDraw::pathLineToVerticalAbsolute(float $y): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathlinetoverticalabsolute",
  "name": "ImagickDraw::pathLineToVerticalAbsolute",
  "purpose_en": "Draws a vertical line",
  "description_en": "Draws a vertical line path from the current point to the target point using absolute coordinates. The target point then becomes the new current point.",
  "signature": "ImagickDraw::pathLineToVerticalAbsolute(float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "y coordinate"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathlinetoverticalabsolute.php",
  "official_page_sha256": "c9f18d027255a131f8984d11af1541df5734891154e6db7e3fee19e971dde37b",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathlinetoverticalabsolute.xml",
  "xml_sha256": "5784046af7b3c2ed0ca9d7db65d66ff65dcf9f6ffb7cc791af6b2831ffe0264c",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(50, 25);
$draw->pathLineToVerticalAbsolute(130);
$draw->pathLineToHorizontalAbsolute(190);
$draw->pathLineToVerticalAbsolute(60);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathlinetoverticalabsolute-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathlinetoverticalabsolute-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Столбики до общей нижней отметки

Есть три верхних положения столбиков диаграммы, а низ у них общий: y=150. Толстая вертикальная обводка позволяет показать простую столбчатую диаграмму без отдельных прямоугольников.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$bars = [
    ['x' => 60, 'top' => 105],
    ['x' => 150, 'top' => 45],
    ['x' => 240, 'top' => 80],
];
$draw->setStrokeWidth(24);
$draw->pathStart();
foreach ($bars as $bar) {
    $draw->pathMoveToAbsolute($bar['x'], $bar['top']);
    $draw->pathLineToVerticalAbsolute(150);
}
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/common-baseline.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'common-baseline.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Аргумент — конечная y-координата. Меньшее значение рисует вверх, ведь экранная ось y направлена вниз. Для математической диаграммы сначала пересчитайте значения в экранные координаты.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathLineToVerticalRelative, ImagickDraw::pathLineToHorizontalAbsolute. Ошибки получения файла: файлы и права.

• ImagickDraw::pathLineToVerticalAbsolute
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathLineToVerticalRelative(float $y): bool

Известна высота индикатора, а его опорная точка задаётся отдельно. Нужно поднимать линию от базовой отметки, не вычисляя каждый конец вручную.

Из (50,25) v105 ведёт в (50,130). После h140 позиция (190,130); v-70 приводит в (190,60). Минус двигает вверх, плюс — вниз.

Сигнатура: ImagickDraw::pathLineToVerticalRelative(float $y): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathlinetoverticalrelative",
  "name": "ImagickDraw::pathLineToVerticalRelative",
  "purpose_en": "Draws a vertical line path",
  "description_en": "Draws a vertical line path from the current point to the target point using relative coordinates. The target point then becomes the new current point.",
  "signature": "ImagickDraw::pathLineToVerticalRelative(float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "y coordinate"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathlinetoverticalrelative.php",
  "official_page_sha256": "b045bbef21db1431de3c6cbbaef37a828330251fdadbc48ca534a3fe64d03593",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathlinetoverticalrelative.xml",
  "xml_sha256": "976ffb8bacb9d92cad132f01f5810c00c660971176fd2d09626b283e681def03",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(50, 25);
$draw->pathLineToVerticalRelative(105);
$draw->pathLineToHorizontalRelative(140);
$draw->pathLineToVerticalRelative(-70);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathlinetoverticalrelative-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathlinetoverticalrelative-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Показать процент как подъём от нижней базы

Панель отчёта показывает готовность 25%,70%,95%. Нижняя точка задана y=145, а максимальная высота 120: положительный процент превращаем в отрицательное движение вверх.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 180, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$percentages = [25, 70, 95];
$draw->setStrokeWidth(24);
$draw->pathStart();
foreach ($percentages as $index => $percent) {
    $height = 120 * $percent / 100;
    $draw->pathMoveToAbsolute(60 + $index * 90, 145);
    $draw->pathLineToVerticalRelative(-$height);
}
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/completion-columns.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'completion-columns.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Высота -70 не является абсолютной координатой y=-70. Чтобы столбец рос вверх от y=145, передайте отрицательное смещение. Проверяйте допустимый диапазон измерений перед пересчётом масштаба.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathLineToVerticalAbsolute, ImagickDraw::pathLineToHorizontalRelative. Ошибки получения файла: файлы и права.

• ImagickDraw::pathLineToVerticalRelative
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathCurveToAbsolute(float $x1, float $y1, float $x2, float $y2, float $x, float $y): bool

На схеме систем нужна плавная связь с обходом центрального блока; прямые отрезки выглядят угловато.

Начало уже задано MoveTo в (20,130). Пары (65,15) и (175,15) — две управляющие точки, (220,130) — конец. Кривая обычно не проходит через управляющие точки; они задают направление и изгиб.

Сигнатура: ImagickDraw::pathCurveToAbsolute(float $x1, float $y1, float $x2, float $y2, float $x, float $y): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

В короткой официальной подписи y2 ошибочно упомянута первая управляющая точка; по описанию команды и SVG-модели это y второй управляющей точки. Снимок ниже сохраняет исходную неточность, русская таблица исправляет её смысл.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathcurvetoabsolute",
  "name": "ImagickDraw::pathCurveToAbsolute",
  "purpose_en": "Draws a cubic Bezier curve",
  "description_en": "Draws a cubic Bezier curve from the current point to (x,y) using (x1,y1) as the control point at the beginning of the curve and (x2,y2) as the control point at the end of the curve using absolute coordinates. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.",
  "signature": "ImagickDraw::pathCurveToAbsolute(float $x1, float $y1, float $x2, float $y2, float $x, float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x1",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "x coordinate of the first control point"
    },
    {
      "name": "y1",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "y coordinate of the first control point"
    },
    {
      "name": "x2",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "x coordinate of the second control point"
    },
    {
      "name": "y2",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "y coordinate of the first control point"
    },
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "x coordinate of the curve end"
    },
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "y coordinate of the curve end"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathcurvetoabsolute.php",
  "official_page_sha256": "b6c28f18941efca7ec5e807e8328ec90d950ff61ee429a0cab262ebf497566da",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathcurvetoabsolute.xml",
  "xml_sha256": "0fa658de7087e8bbf90d1239cb24a8a6609d18cc1b7d0448084993b5e4ba8855",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(20, 130);
$draw->pathCurveToAbsolute(65, 15, 175, 15, 220, 130);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathcurvetoabsolute-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathcurvetoabsolute-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Две плавно соединённые части S-образной связи

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

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(340, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(25, 100);
$draw->pathCurveToAbsolute(70, 20, 130, 20, 170, 100);
$draw->pathCurveToAbsolute(210, 180, 270, 180, 315, 100);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/s-connection.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 's-connection.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Шесть аргументов — три пары координат, а не три точки, через которые обязательно пройдёт линия. После вызова текущая точка равна концу (220,130), а не второй управляющей точке. Для соединения измерений без изменения их траектории используйте линии.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathCurveToRelative, ImagickDraw::pathLineToAbsolute, ImagickDraw::pathMoveToAbsolute. Ошибки получения файла: файлы и права.

• ImagickDraw::pathCurveToAbsolute
• W3C: модель path/current point

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::pathCurveToRelative(float $x1, float $y1, float $x2, float $y2, float $x, float $y): bool

Изгиб символа хочется повторять в разных местах без пересчёта обеих управляющих точек.

Все три пары отсчитываются от одной текущей точки ДО команды — (20,130): (45,-115) даёт (65,15), (155,-115) даёт (175,15), (200,0) даёт конец (220,130). Внутри одной команды база не перескакивает между управляющими точками.

Сигнатура: ImagickDraw::pathCurveToRelative(float $x1, float $y1, float $x2, float $y2, float $x, float $y): bool

Все параметры обязательные, без значений по умолчанию, передаются по значению. Числа задают единицы холста; при отсутствии преобразований одна единица соответствует пикселю. Допустимы дробные координаты, влияющие на сглаживание. Имена x/y у Relative в сигнатуре не делают их абсолютными: это смещения.

Возвращаемое значение. Официальная сигнатура объявляет bool; текст return в снимке Manual говорит «Nothing is returned». Это пробел документации: актуальная реализация Imagick возвращает true после добавления команды. Bool не содержит изображение. Из этих вызовов не строят цепочку через ->; сохранение происходит только после drawImage и writeImage.

Доступность и отказы. PECL imagick 2, PECL imagick 3; в нашем снимке не указаны deprecated/removed. Страница отмечена как не полностью документированная, а разделы errors/changelog пусты. Это не гарантия отсутствия ошибок. Неверные типы дают TypeError, неверная последовательность/параметры могут привести к ImagickDrawException или ошибке применения пути. Запись файла может вернуть false или вызвать ImagickException. Сначала соберите завершённый путь, затем примените и сохраните его; в примерах отказ записи проверен. Ловите исключения на границе задания сайта, не подменяйте ошибку пустым успешным PNG.

{
  "id": "imagickdraw.pathcurvetorelative",
  "name": "ImagickDraw::pathCurveToRelative",
  "purpose_en": "Draws a cubic Bezier curve",
  "description_en": "Draws a cubic Bezier curve from the current point to (x,y) using (x1,y1) as the control point at the beginning of the curve and (x2,y2) as the control point at the end of the curve using relative coordinates. At the end of the command, the new current point becomes the final (x,y) coordinate pair used in the polybezier.",
  "signature": "ImagickDraw::pathCurveToRelative(float $x1, float $y1, float $x2, float $y2, float $x, float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x1",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "x coordinate of starting control point"
    },
    {
      "name": "y1",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "y coordinate of starting control point"
    },
    {
      "name": "x2",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "x coordinate of ending control point"
    },
    {
      "name": "y2",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "y coordinate of ending control point"
    },
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "ending x coordinate"
    },
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "ending y coordinate"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.pathcurvetorelative.php",
  "official_page_sha256": "9e31c9b1a711d84fed8c2d0fcbf46aea33b5a29886a80ca53b6ee53dc761caca",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/pathcurvetorelative.xml",
  "xml_sha256": "c48e6ffe01a9fa8994793e3e7381bdde0fb46508b403a78fe2e19229ee7ddd72",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_paths.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(240, 160, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(20, 130);
$draw->pathCurveToRelative(45, -115, 155, -115, 200, 0);
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/pathcurvetorelative-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'pathcurvetorelative-basic.png', "\n";
$draw->clear();
$image->clear();

Практическая задача: Повторяемая волна из локального шаблона

Внизу отчётного изображения нужна повторяемая плавная волна. Один период состоит из верхней и нижней дуги одинакового размера, а следующий начинается в конце предыдущего.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(540, 200, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('none');
$draw->pathStart();
$draw->pathMoveToAbsolute(20, 100);
foreach ([1, 2, 3] as $period) {
    $draw->pathCurveToRelative(20, -60, 60, -60, 80, 0);
    $draw->pathCurveToRelative(20, 60, 60, 60, 80, 0);
}
$draw->pathFinish();
$image->drawImage($draw);
$path = __DIR__ . '/repeated-wave.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'repeated-wave.png', "\n";
$draw->clear();
$image->clear();

Проблемы, границы и стоимость

Нельзя вторую пару прибавлять к первой управляющей точке, а конец — ко второй: это даст другую кривую. После всей команды база обновится до конечной точки; следующая Relative будет считаться уже от неё. Относительные координаты удобны для повторяемого узора, а не автоматически вычисленной интерполяции данных.

Запись path-команды и получение PNG — разные этапы. Растеризация выполняется при drawImage; сложный длинный путь может отнять заметно больше времени, чем добавление команд. Ограничивайте размеры холста и число команд, измеряйте полную операцию и переиспользуйте статичный PNG. Память зависит от площади, числа каналов и внутренних буферов; число пикселей само по себе не равно числу байтов. Для простого контура достаточно готовых геометрических методов, для интерактивной схемы в браузере часто уместен SVG/canvas, для редактируемого контура нужно отдельно хранить его данные.

Продолжить: ImagickDraw::pathCurveToAbsolute, ImagickDraw::pathLineToRelative, ImagickDraw::pathMoveToRelative. Ошибки получения файла: файлы и права.

• ImagickDraw::pathCurveToRelative
• W3C: модель path/current point