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

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $fonts = Imagick::queryFonts('DejaVu*');
    if ($fonts === []) { $fonts = Imagick::queryFonts('*'); }
    if ($fonts === []) { throw new RuntimeException('На сервере не найден доступный шрифт'); }
    $draw = new ImagickDraw();
    $draw->setFont($fonts[0]);
    $draw->setFontSize(6.0);
    $draw->setFillColor(new ImagickPixel('#102a43'));
    $draw->setTextAntialias(true);
    $image->clear();
    $image->newImage(40, 14, new ImagickPixel('#f7fafc'));
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->annotateImage($draw, 1.0, 6.0, 0.0, 'A');
    $checks = ['return_contract' => $result === true];
    $afterGeometry = $image->getImageGeometry();
    $afterPage = $image->getImagePage();
    $afterCorner = $image->getImagePixelColor(0, 0)->getColor(false);
    $afterSignature = $image->getImageSignature();
    $effect = ['before' => $before, 'after' => ['geometry' => $afterGeometry, 'page' => $afterPage, 'corner' => $afterCorner, 'signature' => $afterSignature]];
    $checks['non_empty_raster'] = $image->getImageWidth() > 0 && $image->getImageHeight() > 0;
    $checks['observable_change'] = $afterSignature !== $before['signature'] || $afterGeometry !== $before['geometry'];
    $artifact = __DIR__ . '/out/' . 'annotateimage-minimal.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::annotateImage',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $fonts = Imagick::queryFonts('DejaVu*');
    if ($fonts === []) { $fonts = Imagick::queryFonts('*'); }
    if ($fonts === []) { throw new RuntimeException('На сервере не найден доступный шрифт'); }
    $draw = new ImagickDraw();
    $draw->setFont($fonts[0]);
    $draw->setFontSize(7.0);
    $draw->setFillColor(new ImagickPixel('#102a43'));
    $draw->setTextAntialias(true);
    $image->clear();
    $image->newImage(96, 24, new ImagickPixel('#f7fafc'));
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->annotateImage($draw, 1.0, 7.0, 0.0, 'SKU 42');
    $checks = ['return_contract' => $result === true];
    $afterGeometry = $image->getImageGeometry();
    $afterPage = $image->getImagePage();
    $afterCorner = $image->getImagePixelColor(0, 0)->getColor(false);
    $afterSignature = $image->getImageSignature();
    $effect = ['before' => $before, 'after' => ['geometry' => $afterGeometry, 'page' => $afterPage, 'corner' => $afterCorner, 'signature' => $afterSignature]];
    $checks['non_empty_raster'] = $image->getImageWidth() > 0 && $image->getImageHeight() > 0;
    $checks['observable_change'] = $afterSignature !== $before['signature'] || $afterGeometry !== $before['geometry'];
    $artifact = __DIR__ . '/out/' . 'annotateimage-workflow.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::annotateImage',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $draw = new ImagickDraw();
    $draw->setFillColor(new ImagickPixel('#ffcc33'));
    $draw->setStrokeColor(new ImagickPixel('#102a43'));
    $draw->setStrokeWidth(1.0);
    $draw->rectangle(2.0, 2.0, 8.0, 6.0);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->drawImage($draw);
    $checks = ['return_contract' => $result === true];
    $afterGeometry = $image->getImageGeometry();
    $afterPage = $image->getImagePage();
    $afterCorner = $image->getImagePixelColor(0, 0)->getColor(false);
    $afterSignature = $image->getImageSignature();
    $effect = ['before' => $before, 'after' => ['geometry' => $afterGeometry, 'page' => $afterPage, 'corner' => $afterCorner, 'signature' => $afterSignature]];
    $checks['non_empty_raster'] = $image->getImageWidth() > 0 && $image->getImageHeight() > 0;
    $checks['observable_change'] = $afterSignature !== $before['signature'] || $afterGeometry !== $before['geometry'];
    $artifact = __DIR__ . '/out/' . 'drawimage-minimal.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::drawImage',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $draw = new ImagickDraw();
    $draw->setFillColor(new ImagickPixel('#38b2ac'));
    $draw->setStrokeColor(new ImagickPixel('#102a43'));
    $draw->setStrokeWidth(1.0);
    $draw->rectangle(2.0, 2.0, 10.0, 7.0);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->drawImage($draw);
    $checks = ['return_contract' => $result === true];
    $afterGeometry = $image->getImageGeometry();
    $afterPage = $image->getImagePage();
    $afterCorner = $image->getImagePixelColor(0, 0)->getColor(false);
    $afterSignature = $image->getImageSignature();
    $effect = ['before' => $before, 'after' => ['geometry' => $afterGeometry, 'page' => $afterPage, 'corner' => $afterCorner, 'signature' => $afterSignature]];
    $checks['non_empty_raster'] = $image->getImageWidth() > 0 && $image->getImageHeight() > 0;
    $checks['observable_change'] = $afterSignature !== $before['signature'] || $afterGeometry !== $before['geometry'];
    $artifact = __DIR__ . '/out/' . 'drawimage-workflow.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::drawImage',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->exportImagePixels(0, 0, 2, 2, 'RGB', Imagick::PIXEL_CHAR);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['values' => count($result), 'first' => array_slice($result, 0, 12)];
    $checks['element_count'] = count($result) === 12;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::exportImagePixels',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->exportImagePixels(1, 1, 4, 2, 'RGBA', Imagick::PIXEL_CHAR);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['values' => count($result), 'first' => array_slice($result, 0, 12)];
    $checks['element_count'] = count($result) === 32;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::exportImagePixels',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelDepth(Imagick::CHANNEL_RED);
    $checks = ['return_contract' => is_int($result)];
    $effect = ['value' => $result];
    $checks['non_negative'] = $result >= 0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelDepth',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelDepth(Imagick::CHANNEL_GREEN);
    $checks = ['return_contract' => is_int($result)];
    $effect = ['value' => $result];
    $checks['non_negative'] = $result >= 0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelDepth',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $reference = clone $image;
    $reference->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [0, 0, 0]);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelDistortion($reference, Imagick::CHANNEL_RED, Imagick::METRIC_ABSOLUTEERROR);
    $checks = ['return_contract' => is_float($result)];
    $effect = ['metric_value' => $result, 'metric_is_finite' => is_finite($result)];
    $checks['finite_metric'] = is_finite($result) && $result >= 0.0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelDistortion',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $reference = clone $image;
    $reference->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 255, 255]);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelDistortion($reference, Imagick::CHANNEL_BLUE, Imagick::METRIC_ROOTMEANSQUAREDERROR);
    $checks = ['return_contract' => is_float($result)];
    $effect = ['metric_value' => $result, 'metric_is_finite' => is_finite($result)];
    $checks['finite_metric'] = is_finite($result) && $result >= 0.0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelDistortion',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $reference = clone $image;
    $reference->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [0, 0, 0]);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelDistortions($reference, Imagick::METRIC_ABSOLUTEERROR, Imagick::CHANNEL_ALL);
    $checks = ['return_contract' => is_float($result)];
    $effect = ['metric_value' => $result, 'metric_is_finite' => is_finite($result)];
    $checks['finite_metric'] = is_finite($result) && $result >= 0.0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelDistortions',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $reference = clone $image;
    $reference->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 255, 255]);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelDistortions($reference, Imagick::METRIC_ROOTMEANSQUAREDERROR, Imagick::CHANNEL_ALL);
    $checks = ['return_contract' => is_float($result)];
    $effect = ['metric_value' => $result, 'metric_is_finite' => is_finite($result)];
    $checks['finite_metric'] = is_finite($result) && $result >= 0.0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelDistortions',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelExtrema(Imagick::CHANNEL_RED);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['range' => aenBound($result)];
    $checks['range_pair'] = count($result) >= 2;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelExtrema',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelExtrema(Imagick::CHANNEL_BLUE);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['range' => aenBound($result)];
    $checks['range_pair'] = count($result) >= 2;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelExtrema',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelKurtosis(Imagick::CHANNEL_RED);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['kurtosis' => $result['kurtosis'] ?? null, 'skewness' => $result['skewness'] ?? null];
    $checks['named_fields'] = array_key_exists('kurtosis', $result) && array_key_exists('skewness', $result);
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelKurtosis',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelKurtosis(Imagick::CHANNEL_GRAY);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['kurtosis' => $result['kurtosis'] ?? null, 'skewness' => $result['skewness'] ?? null];
    $checks['named_fields'] = array_key_exists('kurtosis', $result) && array_key_exists('skewness', $result);
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelKurtosis',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelMean(Imagick::CHANNEL_RED);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['mean' => $result['mean'] ?? null, 'standardDeviation' => $result['standardDeviation'] ?? null];
    $checks['named_fields'] = isset($result['mean'], $result['standardDeviation']);
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelMean',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelMean(Imagick::CHANNEL_GREEN);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['mean' => $result['mean'] ?? null, 'standardDeviation' => $result['standardDeviation'] ?? null];
    $checks['named_fields'] = isset($result['mean'], $result['standardDeviation']);
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelMean',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelRange(Imagick::CHANNEL_RED);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['range' => aenBound($result)];
    $checks['range_pair'] = count($result) >= 2;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelRange',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelRange(Imagick::CHANNEL_BLUE);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['range' => aenBound($result)];
    $checks['range_pair'] = count($result) >= 2;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelRange',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelStatistics();
    $checks = ['return_contract' => is_array($result)];
    $channels = [];
    foreach ($result as $channel => $stats) { $channels[(string) $channel] = ['mean' => $stats['mean'] ?? null, 'standardDeviation' => $stats['standardDeviation'] ?? null]; }
    $effect = ['channels' => $channels];
    $checks['has_channel'] = $channels !== [];
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelStatistics',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageChannelStatistics();
    $checks = ['return_contract' => is_array($result)];
    $channels = [];
    foreach ($result as $channel => $stats) { $channels[(string) $channel] = ['mean' => $stats['mean'] ?? null, 'standardDeviation' => $stats['standardDeviation'] ?? null]; }
    $effect = ['channels' => $channels];
    $checks['has_channel'] = $channels !== [];
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageChannelStatistics',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $image->quantizeImage(4, Imagick::COLORSPACE_RGB, 0, false, false);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageColormapColor(0);
    $checks = ['return_contract' => $result instanceof ImagickPixel];
    $effect = ['color' => $result->getColor(false)];
    $checks['color_object'] = $result instanceof ImagickPixel;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageColormapColor',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $image->quantizeImage(4, Imagick::COLORSPACE_RGB, 0, false, false);
    if ($image->getImageColors() < 2) { throw new LogicException('Нужны минимум две записи палитры'); }
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageColormapColor(1);
    $checks = ['return_contract' => $result instanceof ImagickPixel];
    $effect = ['color' => $result->getColor(false)];
    $checks['color_object'] = $result instanceof ImagickPixel;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageColormapColor',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $image->quantizeImage(8, Imagick::COLORSPACE_RGB, 0, false, false);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageColors();
    $checks = ['return_contract' => is_int($result)];
    $effect = ['value' => $result];
    $checks['non_negative'] = $result >= 0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageColors',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $image->quantizeImage(16, Imagick::COLORSPACE_RGB, 0, false, false);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageColors();
    $checks = ['return_contract' => is_int($result)];
    $effect = ['value' => $result];
    $checks['non_negative'] = $result >= 0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageColors',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageColorspace();
    $checks = ['return_contract' => is_int($result)];
    $effect = ['value' => $result];
    $checks['non_negative'] = $result >= 0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageColorspace',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageColorspace();
    $checks = ['return_contract' => is_int($result)];
    $effect = ['value' => $result];
    $checks['non_negative'] = $result >= 0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageColorspace',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageExtrema();
    $checks = ['return_contract' => is_array($result)];
    $effect = ['range' => aenBound($result)];
    $checks['range_pair'] = count($result) >= 2;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageExtrema',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageExtrema();
    $checks = ['return_contract' => is_array($result)];
    $effect = ['range' => aenBound($result)];
    $checks['range_pair'] = count($result) >= 2;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageExtrema',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $image->quantizeImage(8, Imagick::COLORSPACE_RGB, 0, false, false);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageHistogram();
    $checks = ['return_contract' => is_array($result)];
    $histogram = [];
    foreach (array_slice($result, 0, 5) as $pixel) { $histogram[] = ['color' => $pixel->getColor(false), 'count' => $pixel->getColorCount()]; }
    $effect = ['entries' => count($result), 'sample' => $histogram];
    $checks['has_colors'] = count($result) > 0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageHistogram',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $image->quantizeImage(16, Imagick::COLORSPACE_RGB, 0, false, false);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImageHistogram();
    $checks = ['return_contract' => is_array($result)];
    $histogram = [];
    foreach (array_slice($result, 0, 5) as $pixel) { $histogram[] = ['color' => $pixel->getColor(false), 'count' => $pixel->getColorCount()]; }
    $effect = ['entries' => count($result), 'sample' => $histogram];
    $checks['has_colors'] = count($result) > 0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImageHistogram',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImagePixelColor(0, 0);
    $checks = ['return_contract' => $result instanceof ImagickPixel];
    $effect = ['color' => $result->getColor(false)];
    $checks['color_object'] = $result instanceof ImagickPixel;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImagePixelColor',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getImagePixelColor(11, 7);
    $checks = ['return_contract' => $result instanceof ImagickPixel];
    $effect = ['color' => $result->getColor(false)];
    $checks['color_object'] = $result instanceof ImagickPixel;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getImagePixelColor',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getPixelIterator();
    $checks = ['return_contract' => $result instanceof ImagickPixelIterator];
    $iterator = $result;
    $rowsVisited = 0; $pixelsVisited = 0;
    foreach ($iterator as $row) { ++$rowsVisited; $pixelsVisited += count($row); }
    $effect = ['rows' => $rowsVisited, 'pixels' => $pixelsVisited];
    $checks['all_pixels_seen'] = $pixelsVisited === $image->getImageWidth() * $image->getImageHeight();
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getPixelIterator',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getPixelIterator();
    $checks = ['return_contract' => $result instanceof ImagickPixelIterator];
    $iterator = $result;
    $rowsVisited = 0; $pixelsVisited = 0;
    foreach ($iterator as $row) { ++$rowsVisited; $pixelsVisited += count($row); }
    $effect = ['rows' => $rowsVisited, 'pixels' => $pixelsVisited];
    $checks['all_pixels_seen'] = $pixelsVisited === $image->getImageWidth() * $image->getImageHeight();
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getPixelIterator',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getPixelRegionIterator(1, 1, 3, 2);
    $checks = ['return_contract' => $result instanceof ImagickPixelIterator];
    $iterator = $result;
    $changed = 0;
    foreach ($iterator as $row) { foreach ($row as $pixel) { $pixel->setColor('#e63946'); ++$changed; } $iterator->syncIterator(); }
    $effect = ['changed_pixels' => $changed, 'signature_before' => $before['signature'], 'signature_after' => $image->getImageSignature()];
    $checks['region_size'] = $changed === 6;
    $checks['pixels_changed'] = $image->getImageSignature() !== $before['signature'];
    $artifact = __DIR__ . '/out/' . 'getpixelregioniterator-minimal.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getPixelRegionIterator',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->getPixelRegionIterator(4, 2, 4, 3);
    $checks = ['return_contract' => $result instanceof ImagickPixelIterator];
    $iterator = $result;
    $changed = 0;
    foreach ($iterator as $row) { foreach ($row as $pixel) { $pixel->setColor('#4361ee'); ++$changed; } $iterator->syncIterator(); }
    $effect = ['changed_pixels' => $changed, 'signature_before' => $before['signature'], 'signature_after' => $image->getImageSignature()];
    $checks['region_size'] = $changed === 12;
    $checks['pixels_changed'] = $image->getImageSignature() !== $before['signature'];
    $artifact = __DIR__ . '/out/' . 'getpixelregioniterator-workflow.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::getPixelRegionIterator',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $image->clear();
    $image->newImage(12, 8, new ImagickPixel('transparent'));
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->importImagePixels(0, 0, 2, 2, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0, 0, 255, 0, 0, 0, 255, 255, 255, 255]);
    $checks = ['return_contract' => $result === true];
    $roundTrip = $image->exportImagePixels(0, 0, 2, 2, 'RGB', Imagick::PIXEL_CHAR);
    $effect = ['round_trip_values' => count($roundTrip), 'first' => array_slice($roundTrip, 0, 12)];
    $checks['round_trip_size'] = count($roundTrip) === 12;
    $artifact = __DIR__ . '/out/' . 'importimagepixels-minimal.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::importImagePixels',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $image->clear();
    $image->newImage(12, 8, new ImagickPixel('transparent'));
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->importImagePixels(2, 2, 3, 2, 'RGBA', Imagick::PIXEL_CHAR, [255, 128, 0, 255, 0, 128, 255, 255, 128, 0, 255, 255, 255, 255, 255, 192, 32, 32, 32, 255, 0, 0, 0, 255]);
    $checks = ['return_contract' => $result === true];
    $roundTrip = $image->exportImagePixels(2, 2, 3, 2, 'RGBA', Imagick::PIXEL_CHAR);
    $effect = ['round_trip_values' => count($roundTrip), 'first' => array_slice($roundTrip, 0, 12)];
    $checks['round_trip_size'] = count($roundTrip) === 24;
    $artifact = __DIR__ . '/out/' . 'importimagepixels-workflow.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::importImagePixels',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $fonts = Imagick::queryFonts('DejaVu*');
    if ($fonts === []) { $fonts = Imagick::queryFonts('*'); }
    if ($fonts === []) { throw new RuntimeException('На сервере не найден доступный шрифт'); }
    $draw = new ImagickDraw();
    $draw->setFont($fonts[0]);
    $draw->setFontSize(6.0);
    $draw->setFillColor(new ImagickPixel('#102a43'));
    $draw->setTextAntialias(true);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->queryFontMetrics($draw, 'PHP', false);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['textWidth' => $result['textWidth'] ?? null, 'textHeight' => $result['textHeight'] ?? null, 'ascender' => $result['ascender'] ?? null, 'descender' => $result['descender'] ?? null];
    $checks['positive_box'] = ($result['textWidth'] ?? 0) > 0 && ($result['textHeight'] ?? 0) > 0;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::queryFontMetrics',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $fonts = Imagick::queryFonts('DejaVu*');
    if ($fonts === []) { $fonts = Imagick::queryFonts('*'); }
    if ($fonts === []) { throw new RuntimeException('На сервере не найден доступный шрифт'); }
    $draw = new ImagickDraw();
    $draw->setFont($fonts[0]);
    $draw->setFontSize(7.0);
    $draw->setFillColor(new ImagickPixel('#102a43'));
    $draw->setTextAntialias(true);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->queryFontMetrics($draw, "Order\n42", true);
    $checks = ['return_contract' => is_array($result)];
    $effect = ['textWidth' => $result['textWidth'] ?? null, 'textHeight' => $result['textHeight'] ?? null, 'ascender' => $result['ascender'] ?? null, 'descender' => $result['descender'] ?? null];
    $checks['positive_box'] = ($result['textWidth'] ?? 0) > 0 && ($result['textHeight'] ?? 0) > 0;
    $textCanvas = new Imagick();
    $canvasWidth = (int) ceil(($result['textWidth'] ?? 0) + 8);
    $canvasHeight = (int) ceil(($result['textHeight'] ?? 0) + 8);
    $textCanvas->newImage($canvasWidth, $canvasHeight, new ImagickPixel('transparent'));
    $textCanvas->setImageFormat('png');
    $textCanvas->annotateImage($draw, 4.0, 4.0 + (float) ($result['ascender'] ?? 0), 0.0, "Order\n42");
    $artifact = __DIR__ . '/out/queryfontmetrics-workflow.png';
    $textCanvas->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::queryFontMetrics',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $draw = new ImagickDraw();
    $draw->setFillColor(new ImagickPixel('#ffcc33'));
    $draw->setStrokeColor(new ImagickPixel('#102a43'));
    $draw->setStrokeWidth(1.0);
    $draw->rectangle(2.0, 2.0, 8.0, 6.0);
    $image->drawImage($draw);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->render();
    $checks = ['return_contract' => $result === true];
    $afterGeometry = $image->getImageGeometry();
    $afterPage = $image->getImagePage();
    $afterCorner = $image->getImagePixelColor(0, 0)->getColor(false);
    $afterSignature = $image->getImageSignature();
    $effect = ['before' => $before, 'after' => ['geometry' => $afterGeometry, 'page' => $afterPage, 'corner' => $afterCorner, 'signature' => $afterSignature]];
    $checks['non_empty_raster'] = $image->getImageWidth() > 0 && $image->getImageHeight() > 0;
    $artifact = __DIR__ . '/out/' . 'render-minimal.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::render',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $draw = new ImagickDraw();
    $draw->setFillColor(new ImagickPixel('#38b2ac'));
    $draw->setStrokeColor(new ImagickPixel('#102a43'));
    $draw->setStrokeWidth(1.0);
    $draw->rectangle(2.0, 2.0, 10.0, 7.0);
    $image->drawImage($draw);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->render();
    $checks = ['return_contract' => $result === true];
    $afterGeometry = $image->getImageGeometry();
    $afterPage = $image->getImagePage();
    $afterCorner = $image->getImagePixelColor(0, 0)->getColor(false);
    $afterSignature = $image->getImageSignature();
    $effect = ['before' => $before, 'after' => ['geometry' => $afterGeometry, 'page' => $afterPage, 'corner' => $afterCorner, 'signature' => $afterSignature]];
    $checks['non_empty_raster'] = $image->getImageWidth() > 0 && $image->getImageHeight() > 0;
    $artifact = __DIR__ . '/out/' . 'render-workflow.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::render',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->separateImageChannel(Imagick::CHANNEL_RED);
    $checks = ['return_contract' => $result === true];
    $afterGeometry = $image->getImageGeometry();
    $afterPage = $image->getImagePage();
    $afterCorner = $image->getImagePixelColor(0, 0)->getColor(false);
    $afterSignature = $image->getImageSignature();
    $effect = ['before' => $before, 'after' => ['geometry' => $afterGeometry, 'page' => $afterPage, 'corner' => $afterCorner, 'signature' => $afterSignature]];
    $checks['non_empty_raster'] = $image->getImageWidth() > 0 && $image->getImageHeight() > 0;
    $checks['observable_change'] = $afterSignature !== $before['signature'] || $afterGeometry !== $before['geometry'];
    $artifact = __DIR__ . '/out/' . 'separateimagechannel-minimal.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::separateImageChannel',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->separateImageChannel(Imagick::CHANNEL_BLUE);
    $checks = ['return_contract' => $result === true];
    $afterGeometry = $image->getImageGeometry();
    $afterPage = $image->getImagePage();
    $afterCorner = $image->getImagePixelColor(0, 0)->getColor(false);
    $afterSignature = $image->getImageSignature();
    $effect = ['before' => $before, 'after' => ['geometry' => $afterGeometry, 'page' => $afterPage, 'corner' => $afterCorner, 'signature' => $afterSignature]];
    $checks['non_empty_raster'] = $image->getImageWidth() > 0 && $image->getImageHeight() > 0;
    $checks['observable_change'] = $afterSignature !== $before['signature'] || $afterGeometry !== $before['geometry'];
    $artifact = __DIR__ . '/out/' . 'separateimagechannel-workflow.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::separateImageChannel',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $image->quantizeImage(4, Imagick::COLORSPACE_RGB, 0, false, false);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->setImageColormapColor(0, new ImagickPixel('#00ff66'));
    $checks = ['return_contract' => $result === true];
    $palettePixel = $image->getImageColormapColor(0);
    $paletteColor = $palettePixel->getColor(false);
    $effect = ['palette_index' => 0, 'color' => $paletteColor, 'signature_before' => $before['signature'], 'signature_after' => $image->getImageSignature()];
    $checks['palette_readback'] = [($paletteColor['r'] ?? -1), ($paletteColor['g'] ?? -1), ($paletteColor['b'] ?? -1)] === [0, 255, 102];
    $checks['pixels_changed'] = $image->getImageSignature() !== $before['signature'];
    $artifact = __DIR__ . '/out/' . 'setimagecolormapcolor-minimal.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::setImageColormapColor',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $image->quantizeImage(4, Imagick::COLORSPACE_RGB, 0, false, false);
    if ($image->getImageColors() < 2) { throw new LogicException('Нужны минимум две записи палитры'); }
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->setImageColormapColor(1, new ImagickPixel('#6633ff'));
    $checks = ['return_contract' => $result === true];
    $palettePixel = $image->getImageColormapColor(1);
    $paletteColor = $palettePixel->getColor(false);
    $effect = ['palette_index' => 1, 'color' => $paletteColor, 'signature_before' => $before['signature'], 'signature_after' => $image->getImageSignature()];
    $checks['palette_readback'] = [($paletteColor['r'] ?? -1), ($paletteColor['g'] ?? -1), ($paletteColor['b'] ?? -1)] === [102, 51, 255];
    $checks['pixels_changed'] = $image->getImageSignature() !== $before['signature'];
    $artifact = __DIR__ . '/out/' . 'setimagecolormapcolor-workflow.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::setImageColormapColor',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick();
    $image->newPseudoImage(12, 8, 'gradient:#112233-#f0c674');
    $image->importImagePixels(0, 0, 1, 1, 'RGB', Imagick::PIXEL_CHAR, [255, 0, 0]);
    $image->setImageFormat('png');
    $image->quantizeImage(8, Imagick::COLORSPACE_RGB, 0, false, false);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->uniqueImageColors();
    $checks = ['return_contract' => $result === true];
    $effect = ['palette_width' => $image->getImageWidth(), 'palette_height' => $image->getImageHeight()];
    $checks['palette_strip'] = $image->getImageHeight() === 1 && $image->getImageWidth() > 0;
    $artifact = __DIR__ . '/out/' . 'uniqueimagecolors-minimal.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::uniqueImageColors',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Пример сам создаёт маленький несимметричный градиент, вызывает один изучаемый метод, проверяет return и печатает bounded JSON. Если операция меняет пиксели, создаётся отдельный PNG в ./out. Выполнение Imagick пока не заявляется.

<?php
declare(strict_types=1);

function aenBound(mixed $value): mixed
{
    if ($value instanceof ImagickPixel) { return $value->getColor(false); }
    if ($value instanceof ImagickPixelIterator) { return ['type' => 'ImagickPixelIterator']; }
    if ($value instanceof Imagick) { return ['type' => 'Imagick', 'geometry' => $value->getImageGeometry()]; }
    if (is_array($value)) { return array_slice($value, 0, 12, true); }
    return $value;
}

$image = null; $reference = null; $draw = null; $iterator = null; $transformed = null; $textCanvas = null;
try {
    $outputDir = __DIR__ . '/out';
    if (!is_dir($outputDir) && !mkdir($outputDir, 0775, true) && !is_dir($outputDir)) {
        throw new RuntimeException('Не удалось создать каталог результата');
    }
    $image = new Imagick(__DIR__ . '/fixtures/geometry.ppm');
    $image->setImageFormat('png');
    $image->quantizeImage(16, Imagick::COLORSPACE_RGB, 0, false, false);
    $before = [
        'geometry' => $image->getImageGeometry(),
        'page' => $image->getImagePage(),
        'object_page' => $image->getPage(),
        'corner' => $image->getImagePixelColor(0, 0)->getColor(false),
        'signature' => $image->getImageSignature(),
        'colorspace' => $image->getImageColorspace(),
    ];
    $result = $image->uniqueImageColors();
    $checks = ['return_contract' => $result === true];
    $effect = ['palette_width' => $image->getImageWidth(), 'palette_height' => $image->getImageHeight()];
    $checks['palette_strip'] = $image->getImageHeight() === 1 && $image->getImageWidth() > 0;
    $artifact = __DIR__ . '/out/' . 'uniqueimagecolors-workflow.png';
    $image->setImageFormat('png');
    $image->writeImage($artifact);
    $effect['artifact'] = basename($artifact);
    $effect['bytes'] = filesize($artifact);
    $checks['artifact_written'] = is_file($artifact) && filesize($artifact) > 8;
    foreach ($checks as $check => $passed) {
        if (!$passed) { throw new LogicException('Не прошла проверка результата: ' . $check); }
    }
    $observation = [
        'method' => 'Imagick::uniqueImageColors',
        'input' => $before,
        'return' => aenBound($result),
        'effect' => $effect,
        'checks' => $checks,
    ];
    echo json_encode($observation, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
} catch (ImagickException $exception) {
    fwrite(STDERR, 'Imagick отказал: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} catch (Throwable $exception) {
    fwrite(STDERR, 'Проверка примера не пройдена: ' . $exception->getMessage() . PHP_EOL);
    exit(1);
} finally {
    if ($iterator instanceof ImagickPixelIterator) { $iterator->clear(); }
    if ($draw instanceof ImagickDraw) { $draw->clear(); }
    if ($reference instanceof Imagick) { $reference->clear(); }
    if ($transformed instanceof Imagick) { $transformed->clear(); }
    if ($textCanvas instanceof Imagick) { $textCanvas->clear(); }
    if ($image instanceof Imagick) { $image->clear(); }
}

Этот сценарий читает объявленный 12×8 PPM, использует другие параметры и принимает проверяемое решение по result/effect. Это самостоятельный workflow, а не копия с заменённым числом; runtime и visual pass отложены до окружения с Imagick.