Intervention/image · error · ModifierException

Failed to apply Intervention\Image\Drivers\Imagick\Modifiers

Error message

Failed to apply Intervention\Image\Drivers\Imagick\Modifiers\FillModifier, unable to build ImagickDraw object

What it means

This ModifierException is thrown when a full-canvas fill ($image->fill($color) without a position) fails while drawing the cover rectangle. The Imagick driver builds an ImagickDraw, sets your color as fill, draws rectangle(0,0,width,height) and calls drawImage(); any ImagickException, ImagickDrawException or ImagickPixelException from that sequence is wrapped as 'unable to build ImagickDraw object'.

Source

Thrown at src/Drivers/Imagick/Modifiers/FillModifier.php:96

            throw new ModifierException(
                'Failed to apply ' . self::class . ', unable to flood fill image',
                previous: $e,
            );
        }
    }

    /**
     * @throws ModifierException
     */
    private function fillAllWithColor(Imagick $frame, ImagickPixel $pixel): void
    {
        try {
            $draw = new ImagickDraw();
            $draw->setFillColor($pixel);
            $draw->rectangle(0, 0, $frame->getImageWidth(), $frame->getImageHeight());
            $frame->drawImage($draw);
        } catch (ImagickException | ImagickDrawException | ImagickPixelException $e) {
            throw new ModifierException(
                'Failed to apply ' . self::class . ', unable to build ImagickDraw object',
                previous: $e,
            );
        }

        try {
            // deactive alpha channel when image was filled with opaque color
            if ($pixel->getColorValue(Imagick::COLOR_ALPHA) === 1.0) {
                $result = $frame->setImageAlphaChannel(Imagick::ALPHACHANNEL_DEACTIVATE);
                if ($result === false) {
                    throw new ModifierException(
                        'Failed to apply ' . self::class . ', unable to adjust alpha channel',
                    );
                }
            }
        } catch (ImagickException | ImagickPixelException $e) {
            throw new ModifierException(
                'Failed to apply ' . self::class . ', unable to adjust alpha channel',

View on GitHub (pinned to 5598b9e397)

Solutions

Inspect $e->getPrevious() to get the underlying Imagick/ImagickDraw/ImagickPixel error
Downscale oversized images before filling, or raise the width/height/area limits in policy.xml
Verify the color argument is a valid color string or ColorInterface (test with a simple hex like 'ff0000')
Re-encode or re-save corrupt sources before processing
Increase PHP memory_limit if allocation failures appear in the previous exception

Example fix

// before
$image = $manager->read('poster.tif');
$image->fill('4a90d9');

// after (guard oversized input)
$image = $manager->read('poster.tif');
$maxPixels = 40_000_000;
if ($image->width() * $image->height() > $maxPixels) {
    $image->scaleDown(width: 6000);
}
$image->fill('4a90d9');

Defensive patterns

Strategy: try-catch

Validate before calling

$pixelCount = $image->width() * $image->height();
if ($pixelCount > 40_000_000) {
    $image->scaleDown(width: 6000);
}
$image->fill($color);

Type guard

function isFillColorValid(string|\Intervention\Image\Interfaces\ColorInterface $color): bool
{
    if ($color instanceof \Intervention\Image\Interfaces\ColorInterface) {
        return true;
    }
    return (bool) preg_match('/^([0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8}|rgba?\([^)]*\))$/i', trim($color, "# \t\n\r"));
}

Try / catch

use Intervention\Image\Exceptions\ModifierException;

try {
    $image->fill($color);
} catch (ModifierException $e) {
    Log::error('Full fill failed: ' . optional($e->getPrevious())->getMessage());
    throw $e;
}

Prevention

Validate color strings before passing them to fill()
Downscale oversized images or raise policy.xml limits before fills
Re-encode corrupted uploads (validate with a re-decode round-trip)
Test fills with a simple hex color to separate color problems from image problems

When it happens

Trigger: Calling $image->fill($color) on images whose dimensions exceed ImageMagick's policy-limited width/height/area; filling with a color object that produced a broken ImagickPixel; drawing on a corrupted frame whose pixel cache cannot be locked for writing; extremely constrained memory environments.

Common situations: Filling large uploaded images on shared hosting where policy.xml caps image area far below the uploaded size; filling images decoded from truncated files; hosts with very low memory_limit where allocating the draw wand fails; color values passed as unusual formats that decode to pixels the installed ImageMagick rejects.

Related errors

AI-assisted analysis of Intervention/image@5598b9e397 (2026-08-23). Data as JSON: /api/errors/1d28e0bfd3d285a0. Report an issue: GitHub.