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

PECL imagick 2, PECL imagick 3 · imagick

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

Нужно разместить одну карточку в разных местах отчёта, сохранив её внутренние координаты и расстояния между элементами.

Translate сдвигает систему координат следующих команд. На новом Draw после translate(80,60) локальная точка (0,0) оказывается в (80,60) холста, а (100,60) — в (180,120). Не нужно вручную прибавлять 80 и 60 к каждой вершине, полоске и значку шаблона.

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

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

Возвращаемый тип сигнатуры — bool; текущий PHP wrapper после записи преобразования возвращает true. Текст Return Values сохранённого Manual противоречиво говорит об отсутствии результата. Ни bool, ни сам Draw не являются готовой картинкой: drawImage наносит команды на пиксели, writeImage сохраняет файл. Нативный запуск PHP в этом пакете отложен, поэтому не выдаём проверку синтаксиса за подтверждение конкретной связки Imagick/ImageMagick.

Официальная доступность: PECL imagick 2, PECL imagick 3. В snapshot не объявлены отдельные изменения версии, удаление или deprecated-маркер данного метода. PHP-примеры используют синтаксис PHP 8.2+ и расширение imagick. Отсутствие changelog не доказывает тождественность всех версий рендерера.

Ошибки отдельно не перечислены в официальном snapshot. Неподходящий PHP-тип может вызвать TypeError; неверные/неполные коэффициенты — ImagickDrawException. Проверяйте конечность и прикладной диапазон заранее: возврат true не гарантирует, что фигура осталась в холсте. Растеризация и запись PNG могут дать ImagickException либо false; пример отдельно проверяет запись. Вырожденная матрица и слишком большой масштаб — геометрические проблемы, а не обязательно отвергаемые API значения.

{
  "id": "imagickdraw.translate",
  "name": "ImagickDraw::translate",
  "purpose_en": "Applies a translation to the current coordinate system",
  "description_en": "Applies a translation to the current coordinate system which moves the coordinate system origin to the specified coordinate.",
  "signature": "ImagickDraw::translate(float $x, float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "horizontal translation"
    },
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "vertical translation"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [
    {
      "title": "ImagickDraw::translate example",
      "language": "php",
      "code_sha256": "c9291e8bb1e22d1c12a1a5bf4b5fbc8a2222174a4df46d17149b6aedb75e6ddb"
    }
  ],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.translate.php",
  "official_page_sha256": "74eb5e58a847312364e84874c66fab591619a730b1f44686f4cfbdfe4203ba07",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/translate.xml",
  "xml_sha256": "5410055b0466a1ecf12d0e773114e53e58a7dea0a8c48f1fef6b5a6449387563",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_style.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 220, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->translate(80, 60);
$draw->rectangle(0, 0, 100, 60);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/translate-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'translate-basic.png', "\n";
$image->clear();

Практическая задача: Разложить четыре одинаковые карточки отчёта

Шаблон карточки содержит рамку и две строки. Меняем только положение; новый Draw на каждом шаге не наследует предыдущий перенос.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(380, 260, 'white');
$image->setImageFormat('png');
foreach ([[40, 40], [200, 40], [40, 140], [200, 140]] as [$x, $y]) {
    $card = new ImagickDraw();
    $card->setStrokeColor('#146c74');
    $card->setStrokeWidth(3);
    $card->setFillColor('#bdebe2');
    $card->translate($x, $y);
    $card->rectangle(0, 0, 100, 60);
    $card->line(15, 20, 85, 20);
    $card->line(15, 40, 60, 40);
    $image->drawImage($card);
    $card->clear();
}
$path = __DIR__ . '/report-cards.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'report-cards.png', "\n";
$image->clear();

Ошибки, альтернативы и стоимость

Translate не означает установить абсолютное место фигуры независимо от истории. Два последовательных переноса на новом Draw накапливаются: (80,60), затем (20,0) дают (100,60). После rotate или scale изменятся и оси переноса. Настройка после уже записанного rectangle не переносит его задним числом.

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

В расширенных программах foreach обходит конфигурации/точки, if проверяет условие, throw сообщает о невозможном вводе. Новый Draw изолирует координаты одного компонента. См. массивы, условия и циклы, исключения.

Соседние инструменты: ImagickDraw::rotate · ImagickDraw::scale · ImagickDraw::skewX · ImagickDraw::skewY · ImagickDraw::affine. Основы: геометрия, толщина/цвет края.

• ImagickDraw::translate
• PHP Draw binding
• MVG parser and transform accumulation

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::rotate(float $degrees): bool

Значок или указатель нужно направить по маршруту. Поворот должен происходить вокруг понятного центра, а не отправлять фигуру за край картинки.

Rotate принимает градусы и поворачивает текущие оси вокруг их начала (0,0). На обычном холсте x вправо/y вниз положительный угол выглядит как поворот по часовой стрелке. Сначала переносим локальное начало в (140,100), затем поворачиваем оси на 30°, а фигуру задаём симметрично вокруг локального нуля.

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

ImagickDraw::rotate(float $degrees): bool

Возвращаемый тип сигнатуры — bool; текущий PHP wrapper после записи преобразования возвращает true. Текст Return Values сохранённого Manual противоречиво говорит об отсутствии результата. Ни bool, ни сам Draw не являются готовой картинкой: drawImage наносит команды на пиксели, writeImage сохраняет файл. Нативный запуск PHP в этом пакете отложен, поэтому не выдаём проверку синтаксиса за подтверждение конкретной связки Imagick/ImageMagick.

Официальная доступность: PECL imagick 2, PECL imagick 3. В snapshot не объявлены отдельные изменения версии, удаление или deprecated-маркер данного метода. PHP-примеры используют синтаксис PHP 8.2+ и расширение imagick. Отсутствие changelog не доказывает тождественность всех версий рендерера.

Ошибки отдельно не перечислены в официальном snapshot. Неподходящий PHP-тип может вызвать TypeError; неверные/неполные коэффициенты — ImagickDrawException. Проверяйте конечность и прикладной диапазон заранее: возврат true не гарантирует, что фигура осталась в холсте. Растеризация и запись PNG могут дать ImagickException либо false; пример отдельно проверяет запись. Вырожденная матрица и слишком большой масштаб — геометрические проблемы, а не обязательно отвергаемые API значения.

{
  "id": "imagickdraw.rotate",
  "name": "ImagickDraw::rotate",
  "purpose_en": "Applies the specified rotation to the current coordinate space",
  "description_en": "Applies the specified rotation to the current coordinate space.",
  "signature": "ImagickDraw::rotate(float $degrees): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "degrees",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "degrees to rotate."
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [
    {
      "title": "ImagickDraw::rotate example",
      "language": "php",
      "code_sha256": "59aa0bef5f5eab2705da10b18edbbf0d782d99768ba9ee497476549bdb0fe7bf"
    }
  ],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.rotate.php",
  "official_page_sha256": "c5bd14d9674c969e6d853bcebf5ab95b4e7a6b37191b016b83b686b08d94f51a",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/rotate.xml",
  "xml_sha256": "e56d7227564d98d140c6d6a63566a4e79cfbbffbd246aba5c240c3e716291525",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_style.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 220, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->translate(140, 100);
$draw->rotate(30);
$draw->rectangle(-50, -30, 50, 30);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/rotate-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'rotate-basic.png', "\n";
$image->clear();

Практическая задача: Направить стрелку из пункта A в пункт B

На схеме доставки известны две точки. Вычислим направление через atan2, повернём локальную стрелку вдоль него и получим наконечник точно в конечной точке.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 220, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(3);
$draw->setFillColor('#bdebe2');
$ax = 70; $ay = 160;
$bx = 250; $by = 60;
$dx = $bx - $ax; $dy = $by - $ay;
$length = hypot($dx, $dy);
if ($length < 30) {
    throw new InvalidArgumentException('Для этой стрелки нужен маршрут не короче 30');
}
$angle = rad2deg(atan2($dy, $dx));
$draw->translate($ax, $ay);
$draw->rotate($angle);
$draw->polygon([
    ['x' => 0, 'y' => -7], ['x' => $length - 25, 'y' => -7],
    ['x' => $length - 25, 'y' => -16], ['x' => $length, 'y' => 0],
    ['x' => $length - 25, 'y' => 16], ['x' => $length - 25, 'y' => 7],
    ['x' => 0, 'y' => 7],
]);
echo 'angle=', number_format($angle, 2, '.', ''), '; length=',
    number_format($length, 2, '.', ''), "\n";
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/route-arrow.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'route-arrow.png', "\n";
$image->clear();

Ошибки, альтернативы и стоимость

Один rotate(30) не выбирает центр картинки автоматически. Для готовых координат с центром (cx,cy) последовательность T(cx,cy)→R(angle)→T(-cx,-cy) задаёт нужный pivot; для нового локального шаблона удобнее сразу хранить центр около (0,0). ImagickDraw::rotate меняет координаты рисования, а не поворачивает уже готовые пиксели как Imagick::rotateImage.

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

В расширенных программах foreach обходит конфигурации/точки, if проверяет условие, throw сообщает о невозможном вводе. Новый Draw изолирует координаты одного компонента. См. массивы, условия и циклы, исключения.

Соседние инструменты: ImagickDraw::translate · ImagickDraw::scale · ImagickDraw::skewX · ImagickDraw::skewY · ImagickDraw::affine. Основы: геометрия, толщина/цвет края.

• ImagickDraw::rotate
• PHP Draw binding
• MVG parser and transform accumulation

PECL imagick 2, PECL imagick 3 · imagick

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

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

Scale задаёт множители по локальным осям. 1 сохраняет размер, 2 удваивает, 0.5 уменьшает вдвое. В примере локальные 100×60 превращаются в геометрические 160×54; перенос (40,50) остаётся местом начала, потому что он вызван перед scale. Разные множители изменяют пропорции.

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

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

Возвращаемый тип сигнатуры — bool; текущий PHP wrapper после записи преобразования возвращает true. Текст Return Values сохранённого Manual противоречиво говорит об отсутствии результата. Ни bool, ни сам Draw не являются готовой картинкой: drawImage наносит команды на пиксели, writeImage сохраняет файл. Нативный запуск PHP в этом пакете отложен, поэтому не выдаём проверку синтаксиса за подтверждение конкретной связки Imagick/ImageMagick.

Официальная доступность: PECL imagick 2, PECL imagick 3. В snapshot не объявлены отдельные изменения версии, удаление или deprecated-маркер данного метода. PHP-примеры используют синтаксис PHP 8.2+ и расширение imagick. Отсутствие changelog не доказывает тождественность всех версий рендерера.

Ошибки отдельно не перечислены в официальном snapshot. Неподходящий PHP-тип может вызвать TypeError; неверные/неполные коэффициенты — ImagickDrawException. Проверяйте конечность и прикладной диапазон заранее: возврат true не гарантирует, что фигура осталась в холсте. Растеризация и запись PNG могут дать ImagickException либо false; пример отдельно проверяет запись. Вырожденная матрица и слишком большой масштаб — геометрические проблемы, а не обязательно отвергаемые API значения.

{
  "id": "imagickdraw.scale",
  "name": "ImagickDraw::scale",
  "purpose_en": "Adjusts the scaling factor",
  "description_en": "Adjusts the scaling factor to apply in the horizontal and vertical directions to the current coordinate space.",
  "signature": "ImagickDraw::scale(float $x, float $y): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "x",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "horizontal factor"
    },
    {
      "name": "y",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "vertical factor"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [
    {
      "title": "ImagickDraw::scale example",
      "language": "php",
      "code_sha256": "68dc963fd39e6752c008c580415bfe7a7fed2eb4b804e97f251f27a76eeabe24"
    }
  ],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.scale.php",
  "official_page_sha256": "6e355313241062b754ad59028a6ee2ee598fd97512358c243b022e07319b670b",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/scale.xml",
  "xml_sha256": "8c3980d764a8807c300ff543cbe9d767f56f3d2ee22dd9b0fc36aabc2c2fac68",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_style.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 220, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->translate(40, 50);
$draw->scale(1.6, 0.9);
$draw->rectangle(0, 0, 100, 60);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/scale-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'scale-basic.png', "\n";
$image->clear();

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

В интерфейсной схеме нужны противоположные направления. Отразим локальную горизонтальную ось второй стрелки; сам набор вершин останется общим.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 220, 'white');
$image->setImageFormat('png');
foreach ([[40, 100, 1], [280, 100, -1]] as [$x, $y, $sx]) {
    $arrow = new ImagickDraw();
    $arrow->setStrokeColor('#146c74');
    $arrow->setStrokeWidth(3);
    $arrow->setFillColor('#bdebe2');
    $arrow->translate($x, $y);
    $arrow->scale($sx, 1);
    $arrow->polygon([
        ['x' => 0, 'y' => 0], ['x' => 60, 'y' => 0], ['x' => 60, 'y' => -15],
        ['x' => 100, 'y' => 15], ['x' => 60, 'y' => 45],
        ['x' => 60, 'y' => 30], ['x' => 0, 'y' => 30],
    ]);
    $image->drawImage($arrow);
    $arrow->clear();
}
$path = __DIR__ . '/mirrored-directions.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'mirrored-directions.png', "\n";
$image->clear();

Ошибки, альтернативы и стоимость

Это преобразование координат, не процент JPEG/PNG и не resize готового изображения. Масштаб участвует и в растеризации обводки; при неравных множителях нельзя обещать одну точную толщину stroke для всех направлений/версий. Ноль схлопывает фигуру; отрицательный множитель отражает также направление обхода и может вынести её за холст.

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

В расширенных программах foreach обходит конфигурации/точки, if проверяет условие, throw сообщает о невозможном вводе. Новый Draw изолирует координаты одного компонента. См. массивы, условия и циклы, исключения.

Соседние инструменты: ImagickDraw::translate · ImagickDraw::rotate · ImagickDraw::skewX · ImagickDraw::skewY · ImagickDraw::affine. Основы: геометрия, толщина/цвет края.

• ImagickDraw::scale
• PHP Draw binding
• MVG parser and transform accumulation

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::skewX(float $degrees): bool

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

SkewX принимает градусный параметр горизонтального наклона текущих осей. Это не поворот: горизонтальные рёбра исходного прямоугольника остаются горизонтальными, а нижняя часть смещается по x относительно верхней. Вся последующая геометрия того же Draw получает этот наклон.

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

ImagickDraw::skewX(float $degrees): bool

Возвращаемый тип сигнатуры — bool; текущий PHP wrapper после записи преобразования возвращает true. Текст Return Values сохранённого Manual противоречиво говорит об отсутствии результата. Ни bool, ни сам Draw не являются готовой картинкой: drawImage наносит команды на пиксели, writeImage сохраняет файл. Нативный запуск PHP в этом пакете отложен, поэтому не выдаём проверку синтаксиса за подтверждение конкретной связки Imagick/ImageMagick.

Официальная доступность: PECL imagick 2, PECL imagick 3. В snapshot не объявлены отдельные изменения версии, удаление или deprecated-маркер данного метода. PHP-примеры используют синтаксис PHP 8.2+ и расширение imagick. Отсутствие changelog не доказывает тождественность всех версий рендерера.

Ошибки отдельно не перечислены в официальном snapshot. Неподходящий PHP-тип может вызвать TypeError; неверные/неполные коэффициенты — ImagickDrawException. Проверяйте конечность и прикладной диапазон заранее: возврат true не гарантирует, что фигура осталась в холсте. Растеризация и запись PNG могут дать ImagickException либо false; пример отдельно проверяет запись. Вырожденная матрица и слишком большой масштаб — геометрические проблемы, а не обязательно отвергаемые API значения.

{
  "id": "imagickdraw.skewx",
  "name": "ImagickDraw::skewX",
  "purpose_en": "Skews the current coordinate system in the horizontal direction",
  "description_en": "Skews the current coordinate system in the horizontal direction.",
  "signature": "ImagickDraw::skewX(float $degrees): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "degrees",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "degrees to skew"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [
    {
      "title": "ImagickDraw::skewX example",
      "language": "php",
      "code_sha256": "5ad4b9eec4976e904d083b465d266e7df6ee017691304db1f3229b328ec9d451"
    }
  ],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.skewx.php",
  "official_page_sha256": "63352f30ff77a82599d154721ee9f89d93baf640405f76b8c3bcbf2e0a687635",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/skewx.xml",
  "xml_sha256": "1d138288840f1e116db5c257f45fee7fe1e75bb3683186a94f3dadd4466af49f",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_style.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 220, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->translate(60, 60);
$draw->skewX(25);
$draw->rectangle(0, 0, 100, 60);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/skewx-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'skewx-basic.png', "\n";
$image->clear();

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

Декоративный статусный бейдж должен иметь косые боковины. Наклоняем только цветную плашку; информационные полосы рисуем другим Draw без этого преобразования.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(360, 220, 'white');
$image->setImageFormat('png');
$back = new ImagickDraw();
$back->setStrokeColor('#146c74');
$back->setStrokeWidth(4);
$back->setFillColor('#bdebe2');
$back->translate(60, 70);
$back->skewX(-20);
$back->rectangle(0, 0, 220, 70);
$image->drawImage($back);
$back->clear();
$content = new ImagickDraw();
$content->setStrokeColor('#146c74');
$content->setStrokeWidth(5);
$content->setFillColor('none');
$content->line(85, 95, 235, 95);
$content->line(85, 120, 195, 120);
$image->drawImage($content);
$content->clear();
$path = __DIR__ . '/skewed-badge.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'skewed-badge.png', "\n";
$image->clear();

Ошибки, альтернативы и стоимость

Нельзя без проверки подменять этот метод формулой SVG x'=x+tan(angle)·y. В прочитанном текущем MagickCore parser skewX использует sin(angle); конкретный путь PHP→MVG и версия рендерера важны. Здесь угол передаётся API, а для требуемого точного shear ниже объяснён affine. Не строим обещание native PHP по одной CLI-картинке.

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

В расширенных программах foreach обходит конфигурации/точки, if проверяет условие, throw сообщает о невозможном вводе. Новый Draw изолирует координаты одного компонента. См. массивы, условия и циклы, исключения.

Соседние инструменты: ImagickDraw::translate · ImagickDraw::rotate · ImagickDraw::scale · ImagickDraw::skewY · ImagickDraw::affine. Основы: геометрия, толщина/цвет края.

• ImagickDraw::skewX
• PHP Draw binding
• MVG parser and transform accumulation

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::skewY(float $degrees): bool

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

SkewY задаёт градусный параметр вертикального наклона. Вертикальные стороны прямоугольника остаются вертикальными, а их высотное положение зависит от x; это отличается от rotate, где меняется направление обеих осей. Отдельный Draw ограничивает наклон только нужной гранью.

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

ImagickDraw::skewY(float $degrees): bool

Возвращаемый тип сигнатуры — bool; текущий PHP wrapper после записи преобразования возвращает true. Текст Return Values сохранённого Manual противоречиво говорит об отсутствии результата. Ни bool, ни сам Draw не являются готовой картинкой: drawImage наносит команды на пиксели, writeImage сохраняет файл. Нативный запуск PHP в этом пакете отложен, поэтому не выдаём проверку синтаксиса за подтверждение конкретной связки Imagick/ImageMagick.

Официальная доступность: PECL imagick 2, PECL imagick 3. В snapshot не объявлены отдельные изменения версии, удаление или deprecated-маркер данного метода. PHP-примеры используют синтаксис PHP 8.2+ и расширение imagick. Отсутствие changelog не доказывает тождественность всех версий рендерера.

Ошибки отдельно не перечислены в официальном snapshot. Неподходящий PHP-тип может вызвать TypeError; неверные/неполные коэффициенты — ImagickDrawException. Проверяйте конечность и прикладной диапазон заранее: возврат true не гарантирует, что фигура осталась в холсте. Растеризация и запись PNG могут дать ImagickException либо false; пример отдельно проверяет запись. Вырожденная матрица и слишком большой масштаб — геометрические проблемы, а не обязательно отвергаемые API значения.

{
  "id": "imagickdraw.skewy",
  "name": "ImagickDraw::skewY",
  "purpose_en": "Skews the current coordinate system in the vertical direction",
  "description_en": "Skews the current coordinate system in the vertical direction.",
  "signature": "ImagickDraw::skewY(float $degrees): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "degrees",
      "type": "float",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "degrees to skew"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [
    {
      "title": "ImagickDraw::skewY example",
      "language": "php",
      "code_sha256": "25e15d423d888cd4b3a91734a5b8cf919fdf2f621b9308c0b76404e0994e8943"
    }
  ],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.skewy.php",
  "official_page_sha256": "ad23a632cb884ce89634709e0067fe26edd6f32c924f9e11f9bc9dcdac6762c5",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/skewy.xml",
  "xml_sha256": "957491ef07d9ad36a75aa6d43602c9af0ca1746929e1b38cde806f432dae2459",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_style.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 220, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->translate(60, 40);
$draw->skewY(20);
$draw->rectangle(0, 0, 100, 60);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/skewy-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'skewy-basic.png', "\n";
$image->clear();

Практическая задача: Собрать фасад и наклонную боковую грань устройства

В условной схеме оборудование имеет прямой фасад и боковую панель. Вертикальный наклон применим только к боковой панели, сохранив общую границу.

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 240, 'white');
$image->setImageFormat('png');
$front = new ImagickDraw();
$front->setStrokeColor('#146c74');
$front->setStrokeWidth(3);
$front->setFillColor('#bdebe2');
$front->rectangle(40, 80, 160, 200);
$image->drawImage($front);
$front->clear();
$side = new ImagickDraw();
$side->setStrokeColor('#146c74');
$side->setStrokeWidth(3);
$side->setFillColor('#f1c6b7');
$side->translate(160, 80);
$side->skewY(-25);
$side->rectangle(0, 0, 90, 120);
$image->drawImage($side);
$side->clear();
$path = __DIR__ . '/device-side.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'device-side.png', "\n";
$image->clear();

Ошибки, альтернативы и стоимость

Не обещайте симметричную пару формул tan для skewX и skewY. Прочитанный текущий parser skewY использует -tan(angle/2); это не та же формула, что SVG shear. Особенно опасны углы около особенностей тангенса и неподконтрольный внешний ввод. Для точного коэффициента rx и нужного знака предпочтителен явный affine.

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

В расширенных программах foreach обходит конфигурации/точки, if проверяет условие, throw сообщает о невозможном вводе. Новый Draw изолирует координаты одного компонента. См. массивы, условия и циклы, исключения.

Соседние инструменты: ImagickDraw::translate · ImagickDraw::rotate · ImagickDraw::scale · ImagickDraw::skewX · ImagickDraw::affine. Основы: геометрия, толщина/цвет края.

• ImagickDraw::skewY
• PHP Draw binding
• MVG parser and transform accumulation

PECL imagick 2, PECL imagick 3 · imagick

ImagickDraw::affine(array $affine): bool

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

Affine добавляет указанную матрицу к текущему преобразованию; он не сбрасывает историю Draw. На новом Draw действуют формулы x'=sx·x+ry·y+tx и y'=rx·x+sy·y+ty. Ключ ry отвечает за вклад y в x, ключ rx — за вклад x в y; это особенно легко перепутать при переносе позиционного массива из другой библиотеки.

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

ImagickDraw::affine(array $affine): bool

Возвращаемый тип сигнатуры — bool; текущий PHP wrapper после записи преобразования возвращает true. Текст Return Values сохранённого Manual противоречиво говорит об отсутствии результата. Ни bool, ни сам Draw не являются готовой картинкой: drawImage наносит команды на пиксели, writeImage сохраняет файл. Нативный запуск PHP в этом пакете отложен, поэтому не выдаём проверку синтаксиса за подтверждение конкретной связки Imagick/ImageMagick.

Официальная доступность: PECL imagick 2, PECL imagick 3. В snapshot не объявлены отдельные изменения версии, удаление или deprecated-маркер данного метода. PHP-примеры используют синтаксис PHP 8.2+ и расширение imagick. Отсутствие changelog не доказывает тождественность всех версий рендерера.

Ошибки отдельно не перечислены в официальном snapshot. Неподходящий PHP-тип может вызвать TypeError; неверные/неполные коэффициенты — ImagickDrawException. Проверяйте конечность и прикладной диапазон заранее: возврат true не гарантирует, что фигура осталась в холсте. Растеризация и запись PNG могут дать ImagickException либо false; пример отдельно проверяет запись. Вырожденная матрица и слишком большой масштаб — геометрические проблемы, а не обязательно отвергаемые API значения.

{
  "id": "imagickdraw.affine",
  "name": "ImagickDraw::affine",
  "purpose_en": "Adjusts the current affine transformation matrix",
  "description_en": "Adjusts the current affine transformation matrix with the specified affine transformation matrix.",
  "signature": "ImagickDraw::affine(array $affine): bool",
  "modifiers": [
    "public"
  ],
  "return_type": "bool",
  "parameters": [
    {
      "name": "affine",
      "type": "array",
      "by_reference": false,
      "optional": false,
      "default": null,
      "description_en": "Affine matrix parameters"
    }
  ],
  "return_en": "Nothing is returned.",
  "errors_en": "",
  "changelog_en": "",
  "examples": [
    {
      "title": "ImagickDraw::affine example",
      "language": "php",
      "code_sha256": "172c01d89032cc8dd11c48d604bb1d54c62ab999a19a85886fe87612a2841a4d"
    }
  ],
  "see_also": [],
  "availability": {
    "from": "PECL imagick 2, PECL imagick 3",
    "deprecated": null,
    "removed": null
  },
  "official_url": "https://www.php.net/manual/en/imagickdraw.affine.php",
  "official_page_sha256": "c8422c263b7356fb2095f9ee7d18a051d49a51afd8fbcc2c87311e5161d40032",
  "xml_path": "evidence/imagick-sources/doc-en/reference/imagick/imagickdraw/affine.xml",
  "xml_sha256": "6cbfe9e822c00f87d2113e9bf2c6f7bf7bf7ae285496d715c71930731b06fff7",
  "official_undocumented_marker": true,
  "owner": "imagick_reference_draw_style.py"
}

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(280, 220, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$draw->affine(['sx' => 1.2, 'rx' => 0.25, 'ry' => 0.35, 'sy' => 1, 'tx' => 50, 'ty' => 40]);
$draw->rectangle(0, 0, 100, 60);
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/affine-basic.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'affine-basic.png', "\n";
$image->clear();

Практическая задача: Проверить матрицу экспортёра и границы фигуры

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

<?php
declare(strict_types=1);

$image = new Imagick();
$image->newImage(320, 220, 'white');
$image->setImageFormat('png');
$draw = new ImagickDraw();
$draw->setStrokeColor('#146c74');
$draw->setStrokeWidth(4);
$draw->setFillColor('#bdebe2');
$m = ['sx' => 0.8, 'rx' => -0.2, 'ry' => 0.3, 'sy' => 1, 'tx' => 70, 'ty' => 70];
$keys = ['sx', 'rx', 'ry', 'sy', 'tx', 'ty'];
if (count($m) !== 6) {
    throw new InvalidArgumentException('Нужно ровно шесть коэффициентов');
}
foreach ($keys as $key) {
    if (!array_key_exists($key, $m) || (!is_int($m[$key]) && !is_float($m[$key])) || !is_finite((float) $m[$key])) {
        throw new InvalidArgumentException('Неверный коэффициент ' . $key);
    }
}
$det = $m['sx'] * $m['sy'] - $m['rx'] * $m['ry'];
if (abs($det) < 0.000001) {
    throw new InvalidArgumentException('Экспортёр не принимает схлопнутые фигуры');
}
$xs = []; $ys = [];
foreach ([[0, 0], [160, 0], [160, 100], [0, 100]] as [$x, $y]) {
    $xs[] = $m['sx'] * $x + $m['ry'] * $y + $m['tx'];
    $ys[] = $m['rx'] * $x + $m['sy'] * $y + $m['ty'];
}
if (min($xs) < 8 || min($ys) < 8 || max($xs) > 312 || max($ys) > 212) {
    throw new InvalidArgumentException('Фигура выходит за выбранное поле');
}
$draw->affine($m);
$draw->rectangle(0, 0, 160, 100);
echo 'bbox=', number_format(min($xs), 0, '.', ''), ',', number_format(min($ys), 0, '.', ''),
    '..', number_format(max($xs), 0, '.', ''), ',', number_format(max($ys), 0, '.', ''), "\n";
$image->drawImage($draw);
$draw->clear();
$path = __DIR__ . '/validated-affine.png';
if (!$image->writeImage($path)) {
    throw new RuntimeException('Не удалось сохранить PNG');
}
echo 'validated-affine.png', "\n";
$image->clear();

Явный горизонтальный shear с коэффициентом k задаётся sx=1, sy=1, ry=k, rx=0, tx=ty=0; вертикальный — rx=k, ry=0. Если задача определена именно стандартным углом SVG shear, коэффициент вычисляют tan(deg2rad(angle)) и затем передают в нужное поле affine. Не путайте этот контролируемый расчёт с описанной реализацией методов skewX/skewY. Поле tx/ty можно сразу включить в ту же матрицу.

Ошибки, альтернативы и стоимость

Именованные PHP keys и позиционная запись MVG имеют разный порядок двух перекрёстных полей. Текущий DrawAffine сериализует sx,ry,rx,sy,tx,ty; PHP binding присваивает одноимённые поля напрямую, parser читает соответствующий порядок. Поэтому ориентируйтесь на формулы, а не слепую копию шести позиций из SVG/CSS/CLI. Affine сохраняет прямые и параллельность: произвольная перспективная трапеция не задаётся такими шестью числами.

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

В расширенных программах foreach обходит конфигурации/точки, if проверяет условие, throw сообщает о невозможном вводе. Новый Draw изолирует координаты одного компонента. См. массивы, условия и циклы, исключения.

Соседние инструменты: ImagickDraw::translate · ImagickDraw::rotate · ImagickDraw::scale · ImagickDraw::skewX · ImagickDraw::skewY. Основы: геометрия, толщина/цвет края.

• ImagickDraw::affine
• PHP Draw binding
• MVG parser and transform accumulation